Skip to content

Download

Resume-safe HTTPS downloads with integrity verification: a short read or a mid-stream break keeps the .part for resume, a changed object restarts cleanly, and the finished file is hashed against the object's ETag.

download_item

download_item(item, dest_dir='.', assets=None, **kwargs)

Download several assets of an item.

Defaults to every product asset present on the item.

download_asset

download_asset(item, asset, dest_dir='.', **kwargs)

Download a single named asset (e.g. "GEC") of an item.

download_url

download_url(url, dest, *, overwrite=False, resume=True, verify=True, session=None, progress=None)

Stream url to dest.

dest may be a directory (the server filename is used) or a full file path. Partial downloads are written to a .part sidecar and resumed via an HTTP Range request when resume is true.

When verify is true (the default) and the server exposes a single-part S3 ETag (the object's hex MD5), the finished file is hashed and compared against it, so on-the-wire corruption a correct byte count can't catch fails loudly. Multipart ETags ("<hash>-<n>") are not a plain MD5 and are skipped.