0xDL

A Rust library for fast, reliable asynchronous file downloading.

0xDL provides a clean, minimal abstraction for downloading large files over HTTP/S using asynchronous Rust.

Built on Tokio and reqwest, it offers:

• High‑performance async streaming
• Optional progress callbacks
• Optional SHA‑256 verification with guaranteed cleanup on failure
• Atomic final file placement

Installation

Install 0xDL using Cargo:

cargo add oxdl

Or add it manually to Cargo.toml:

[dependencies]
oxdl = "0.1.5"

Features

• Fully asynchronous file downloads
• Optional Fn(f32) progress callbacks
• Optional SHA‑256 integrity verification
• Automatic cleanup of failed downloads
• Atomic final file write

Screenshot

Usage

0xDL exposes two high‑level functions.

1. download(url, path, sha256) — simple download

use oxdl::download;

#[tokio::main]
async fn main() -> Result<(), oxdl::DownloadError> {
    let url = "https://example.com/file.iso";
    let path = "file.iso";

    download(url, path, None).await?;
    Ok(())
}

2. download_with_updates(url, path, progress_callback, sha256)

use oxdl::download_with_updates;

#[tokio::main]
async fn main() -> Result<(), oxdl::DownloadError> {
    let url = "https://example.com/file.iso";
    let path = "file.iso";

    let progress = |pct: f32| println!("Progress: {:.1}%", pct);

    download_with_updates(url, path, Some(Box::new(progress)), None).await?;

    Ok(())
}

API Summary

If SHA‑256 validation fails, 0xDL automatically deletes the temporary file.

Builder API

Advanced users may construct a downloader manually.

Example

use oxdl::Downloader;

let dl = Downloader::new("https://example.com/file.iso", "file.iso")?
    .on_update(|p| println!("{p:.1}%"))
    .with_sha256("deadbeef...")?;

dl.execute().await?;

Methods

Supported Platforms

• Rust stable
• Linux, macOS, Windows

Testing

0xDL organizes tests using features so expensive tests only run when requested.

Features

Running

cargo test --features tests

cargo test --features net-tests

cargo test --features all-tests

cargo test --features all-tests-w-iso-dl -- --nocapture

cargo test --features dl-iso-test -- --nocapture

License

MIT

Contributing

PRs welcome.

Contact

Created by Anthony Tropeano — https://github.com/iitoneloc