Enum NotReadyCause 

#[non_exhaustive]
pub enum NotReadyCause {
    WaitBudgetExhausted,
    WaitInterrupted,
    SourcePending,
}

Concrete cause for a PendingReason::NotReady.

Carried as the typed payload of NotReady so the io::Error that impl Read for Stream produces names the real stall site without requiring decoder-side instrumentation.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

WaitBudgetExhausted

wait_range returned WaitBudgetExceeded for MAX_WAIT_SPINS iterations — the source kept signalling “not yet” past the read budget. Typical when a fetch is slower than the read deadline.

WaitInterrupted

wait_range returned Interrupted without an active flush, also past the spin budget — the downloader woke us but range still wasn’t satisfied. Typical sign of a flapping ABR/eviction race.

SourcePending

wait_range reported ready but read_at then returned Pending with a non-Retry reason — surfaced verbatim from the source.

Trait Implementations

impl Clone for NotReadyCause

fn clone(&self) -> NotReadyCause

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NotReadyCause

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

Formats the value using the given formatter.

impl Display for NotReadyCause

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

Formats the value using the given formatter.

impl PartialEq for NotReadyCause

fn eq(&self, other: &NotReadyCause) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for NotReadyCause

impl Eq for NotReadyCause

impl StructuralPartialEq for NotReadyCause