Enum UploadEvent 

pub enum UploadEvent {
    Start {
        total_files: usize,
        total_bytes: u64,
    },
    Progress {
        bytes_completed: u64,
        total_bytes: u64,
        bytes_per_sec: Option<f64>,
        transfer_bytes_completed: u64,
        transfer_bytes: u64,
        transfer_bytes_per_sec: Option<f64>,
        files: Vec<FileProgress>,
    },
    Committing,
    Complete,
}

Lifecycle events for a single upload operation. See the module-level docs for the Start → Progress → Committing → Complete ordering and the silent-gap caveats.

Variants

Start

Upload has begun; totals are known.

Fields

total_files: usize

Number of files the operation will upload (excludes deletes and other non-add operations in a commit).

total_bytes: u64

Sum of source-content sizes in bytes, before xet deduplication.

Progress

Byte-level progress during the active upload phase, emitted at ~10Hz by the xet upload poll loop.

Two byte-count dimensions are reported because xet performs content-defined deduplication. The bytes_completed / total_bytes pair tracks logical content bytes (use for a “% processed” bar); the transfer_bytes_* triplet tracks post-dedup network bytes actually sent (use for a “network activity” bar). For deduplicated data, transfer_bytes ≪ total_bytes.

files is a snapshot of every xet-tracked file’s state at this event. May be empty for operations that don’t go through xet (small inline files skip Progress entirely).

Fields

bytes_completed: u64

Logical content bytes processed so far across all files.

total_bytes: u64

Total logical content bytes for the operation (matches Start.total_bytes).

bytes_per_sec: Option<f64>

Rate of logical content processing in bytes/sec. None during warm-up.

transfer_bytes_completed: u64

Post-dedup network bytes actually sent so far.

transfer_bytes: u64

Total post-dedup network bytes the operation is expected to send.

transfer_bytes_per_sec: Option<f64>

Rate of network transfer in bytes/sec. None during warm-up.

files: Vec<FileProgress>

Per-file snapshot of every xet-tracked file in the upload.

Committing

Emitted once, immediately before the commit API call. Signals that all byte transfer is done; the call itself is silent until Complete.

Complete

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

Trait Implementations

impl Clone for UploadEvent

fn clone(&self) -> UploadEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UploadEvent

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

Formats the value using the given formatter.

impl From<UploadEvent> for ProgressEvent

fn from(event: UploadEvent) -> Self

Converts to this type from the input type.