.TH "datalad download-url" "1" "2019\-02\-08" ""datalad download-url 0.11.2""
.SH NAME
\fBdatalad download-url\fR \- download content
.SH SYNOPSIS
.nh
.HP
\fBdatalad download\-url\fR [-h] [-d\~PATH] [-O\~PATH] [-o] [--archive] [--nosave] [-m\~MESSAGE] url [url ...]


.hy
.SH DESCRIPTION

It allows for a uniform download interface to various supported URL
schemes, re\-using or asking for authentication details maintained by
datalad.
.PP
Examples:
.PP
$ datalad download\-url http://example.com/file.dat s3://bucket/file2.dat
.SH OPTIONS
.TP
url
URL(s) to be downloaded. Constraints: value must be a string

.TP
\fB-h\fR, \fB--help\fR, \fB--help-np\fR
show this help message. --help-np forcefully disables the use of a pager for displaying the help message
.TP
\fB-d\fR PATH, \fB--dataset\fR PATH
specify the dataset to add files to. If no dataset is given, an attempt is made to identify the dataset based on the current working directory and/or the PATH given. Use --nosave to prevent adding files to the dataset. Constraints: Value must be a Dataset or a valid identifier of a Dataset (e.g. a path) [Default: None]
.TP
\fB-O\fR \fI\s-1PATH\s0\fR, \fB--path\fR \fI\s-1PATH\s0\fR
path (filename or directory path) where to store downloaded file(s). In case of multiple URLs provided, must point to a directory. Otherwise current directory is used. Constraints: value must be a string [Default: None]
.TP
\fB-o\fR, \fB--overwrite\fR
flag to overwrite it if target file exists. [Default: False]
.TP
\fB--archive\fR
pass the downloaded files to datalad add-archive-content --delete. [Default: False]
.TP
\fB--nosave\fR
by default all modifications to a dataset are immediately saved. Giving this option will disable this behavior. [Default: True]
.TP
\fB-m\fR MESSAGE, \fB--message\fR MESSAGE
a description of the state or the changes made to a dataset. Constraints: value must be a string [Default: None]
.SH AUTHORS
 datalad is developed by The DataLad Team and Contributors <team@datalad.org>.