Robust Downloader

0.0.2 · active · verified Sun Apr 12

A minimal Python downloader designed for robustness, offering features like resumable downloads and automatic retries. It is currently in beta status (Development Status :: 4 - Beta) and provides both a Python interface and a command-line utility for simple file transfers.

Warnings

gotcha The library is currently in 'Beta' development status (Development Status :: 4 - Beta). This implies that APIs and core behaviors might still evolve and change in future versions without strict adherence to semantic versioning until a stable 1.0 release.
Fix: Be prepared for potential API adjustments and thoroughly test upgrades between minor or patch versions. Refer to the project's GitHub releases for specific changes.
gotcha While designed for robustness, the basic `download` function, as shown in minimal usage examples, does not explicitly include `try-except` blocks for error handling. For production-ready applications, it is essential to implement comprehensive exception handling for network issues, file system errors, or unexpected server responses.
Fix: Wrap `download()` calls in `try...except` blocks to handle potential exceptions such as `requests.exceptions.RequestException`, `IOError`, or other custom exceptions the library might raise.
gotcha Version 0.0.2 introduced an optional SHA256 integrity check. If downloading critical files where data integrity is paramount, it is highly recommended to provide the expected SHA256 hash to the `download` function to verify the file's authenticity and ensure it hasn't been corrupted during transfer. This check is not enabled by default.
Fix: Pass the `sha256` argument to the `download` function, e.g., `download(url, filename='my_file.zip', sha256='expected_sha256_hash')`.
gotcha The library describes itself as a 'minimal' downloader. While it supports resumable downloads and retries, users accustomed to more feature-rich download managers (e.g., those offering multi-part downloads, advanced proxy configurations, or sophisticated handling of dynamic/expiring URLs) might find certain advanced capabilities or extensive customization options to be limited.
Fix: Review the project's documentation and source code to confirm specific feature support if your use case requires complex download management scenarios.

Install

pip install robust-downloader Install latest version

Imports

download
```
from robust_downloader import download
```

Quickstart

Demonstrates how to download a file using the `download` function. The example includes basic error handling, which is crucial for robust applications, although not explicitly shown in the most minimal usage examples from the library's documentation.

from robust_downloader import download

# Download a file from a URL
# Replace with an actual URL to test
file_url = "https://raw.githubusercontent.com/fedebotu/robust-downloader/main/README.md"
try:
    download(file_url, filename="downloaded_readme.md")
    print(f"Successfully downloaded {file_url} to downloaded_readme.md")
except Exception as e:
    print(f"An error occurred during download: {e}")

view raw JSON →