Struct RateEstimator 

pub struct RateEstimator {
    accum_bytes: f64,
    accum_secs: f64,
    prev_bytes: Option<u64>,
    prev_at: Instant,
    smoothed_eta: Option<f64>,
}

Time-decayed estimate of download throughput and time remaining.

Feed it cumulative byte counts with record — on every tick, including ticks where the count has not changed, since those are what make a stalled transfer decay toward zero.

Fields

accum_bytes: f64

Decayed sum of bytes transferred.

accum_secs: f64

Decayed sum of elapsed time, in seconds.

prev_bytes: Option<u64>

Cumulative byte count at the previous sample; None before the first.

prev_at: Instant

Timestamp of the previous sample.

smoothed_eta: Option<f64>

Smoothed seconds remaining; None when unknown or complete.

Implementations

impl RateEstimator

pub const fn new(now: Instant) -> Self

Create an estimator with its baseline at now.

pub fn record(&mut self, downloaded: u64, total: u64, now: Instant)

Record a cumulative byte count.

downloaded and total are cumulative totals for the whole artifact, not per-tick deltas. total may be 0 when the size is not yet known, in which case no ETA is produced.

Call this on every tick of the progress bridge. Ticks where downloaded has not moved are meaningful samples: they are how a stall pulls the reported rate down.

pub fn rate_bps(&self) -> Option<f64>

Current throughput in bytes per second.

None until enough time has been observed for the average to mean anything — callers should render a placeholder rather than a zero.

pub const fn eta_seconds(&self) -> Option<f64>

Smoothed estimate of the seconds remaining.

None when the total size is unknown, the transfer is complete, or no rate has been established yet.

fn update_eta(&mut self, downloaded: u64, total: u64, dt: f64)

Fold the latest raw ETA into the smoothed one.

Trait Implementations

impl Clone for RateEstimator

fn clone(&self) -> RateEstimator

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RateEstimator

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

Formats the value using the given formatter.