Scroll to navigation

datalad download-url(1) datalad datalad download-url(1)

NAME

datalad download-url - download content

SYNOPSIS

datalad download-url [-h] [-d PATH] [-O PATH] [-o] [--archive] [--nosave] [-m MESSAGE] url [url ...]

DESCRIPTION

It allows for a uniform download interface to various supported URL schemes, re-using or asking for authentication details maintained by datalad.

Examples:

$ datalad download-url http://example.com/file.dat s3://bucket/file2.dat

OPTIONS

url
URL(s) to be downloaded. Constraints: value must be a string

-h, --help, --help-np
show this help message. --help-np forcefully disables the use of a pager for displaying the help message
-d PATH, --dataset 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]
-O PATH, --path PATH
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]
-o, --overwrite
flag to overwrite it if target file exists. [Default: False]
--archive
pass the downloaded files to datalad add-archive-content --delete. [Default: False]
--nosave
by default all modifications to a dataset are immediately saved. Giving this option will disable this behavior. [Default: True]
-m MESSAGE, --message MESSAGE
a description of the state or the changes made to a dataset. Constraints: value must be a string [Default: None]

AUTHORS

datalad is developed by The DataLad Team and Contributors <team@datalad.org>.
2019-02-08