Enum DownloadEvent 

pub enum DownloadEvent {
    Start {
        total_files: usize,
        total_bytes: u64,
    },
    Progress {
        files: Vec<FileProgress>,
    },
    AggregateProgress {
        bytes_completed: u64,
        total_bytes: u64,
        bytes_per_sec: Option<f64>,
    },
    Complete,
}

Lifecycle events for a single download operation. See the module-level docs for ordering, the two-channel Progress vs AggregateProgress model, and cache-hit fast paths.

Variants

Start

Download operation has begun; totals are known. Fires after the HEAD round-trip (or HEAD fan-out for snapshot_download).

Fields

total_files: usize

Number of files to download.

total_bytes: u64

Sum of remote file sizes in bytes, as reported by HEAD responses.

Progress

Per-file progress delta — files contains only files whose status or byte count changed since the previous Progress event. Consumers wanting a running view of every file must accumulate state by filename.

Fields

files: Vec<FileProgress>

Files whose state changed since the previous Progress event.

AggregateProgress

Aggregate byte-level progress for the in-flight xet batch (~10Hz). Reports cumulative bytes for the entire batch with no per-file breakdown — xet reports aggregate stats only.

Fields

bytes_completed: u64

Bytes downloaded so far across the in-flight xet batch.

total_bytes: u64

Total bytes for the in-flight xet batch.

bytes_per_sec: Option<f64>

Download rate in bytes/sec. None until enough samples accumulate.

Complete

Terminal event on success. Not emitted on failure — check the returned Result.

Trait Implementations

impl Clone for DownloadEvent

fn clone(&self) -> DownloadEvent

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DownloadEvent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<DownloadEvent> for ProgressEvent

fn from(event: DownloadEvent) -> Self

Converts to this type from the input type.