download()

audfactory.download(url, destination='.', *, chunk=4096, force_download=True, verbose=False)[source]

Download an artifact.

Parameters
  • url (str) – artifact URL

  • destination (str) – path to store the artifact, can be a folder or a file name

  • chunk (int) – amount of data read at once during the download

  • force_download (bool) – forces the artifact to be downloaded even if it exists locally already

  • verbose – show information on the download process

Return type

str

Returns

path to local artifact

Raises

RuntimeError – if artifact cannot be found, or you don’t have access rights to the artifact

Examples

>>> file = download(
...     (
...         'https://audeering.jfrog.io/artifactory/'
...         'data-public/emodb/db/1.1.0/db-1.1.0.yaml'
...     ),
... )
>>> os.path.basename(file)
'db-1.1.0.yaml'