datalad download-url - download content
datalad download-url [-h] [-d PATH]
[-O PATH] [-o] [--archive] [--nosave] [-m MESSAGE] url [url
...]
It allows for a uniform download interface to various supported
URL schemes, re-using or asking for authentication details maintained by
datalad.
Download files from an http and S3 URL::
% datalad download-url http://example.com/file.dat s3://bucket/file2.dat
Download a file to a path and provide a commit message::
% datalad download-url -m 'added a file' -O myfile.dat
s3://bucket/file2.dat
- 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. 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)
- -O PATH, --path
PATH
- target for download. If the path has a trailing separator, it is treated
as a directory, and each specified URL is downloaded under that directory
to a base name taken from the URL. Without a trailing separator, the value
specifies the name of the downloaded file (file name extensions inferred
from the URL may be added to it, if they are not yet present) and only a
single URL should be given. In both cases, leading directories will be
created if needed. This argument defaults to the current directory.
Constraints: value must be a string
- -o,
--overwrite
- flag to overwrite it if target file exists.
- --archive
- pass the downloaded files to datalad add-archive-content --delete.
- --nosave
- by default all modifications to a dataset are immediately saved. Giving
this option will disable this behavior.
- -m MESSAGE, --message
MESSAGE
- a description of the state or the changes made to a dataset. Constraints:
value must be a string
datalad is developed by The DataLad Team and Contributors
<team@datalad.org>.