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 au‐
       thentication 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. 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 in‐
              ferred 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

AUTHORS

        datalad is developed by The DataLad Team and Contributors <team@datalad.org>.

datalad download-url 0.12.4                        2020-04-06                            datalad download-url(1)