Enum PendingReason 

#[non_exhaustive]
pub enum PendingReason {
    Buffering,
    SeekInProgress,
    StreamBackpressure,
}

Reason a ReadOutcome::Pending / ChunkOutcome::Pending was returned — i.e. why the reader did not advance this call. Each variant maps to a distinct caller action; there is no overlap and no string-matching required.

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.

Buffering

Producer ringbuf is empty: the consumer has caught up to the producer’s most recent chunk and is waiting for the next one (mid-stream async pause, post-seek refill).

SeekInProgress

A seek was issued; the consumer is waiting for the producer to acknowledge the new epoch and deliver post-seek frames. Old pre-seek frames have been drained.

StreamBackpressure

Upstream stream-layer surfaced a pending status (network stall, retry, source-level backpressure). The reader will progress once the stream resumes.

Trait Implementations

impl Clone for PendingReason

fn clone(&self) -> PendingReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PendingReason

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

Formats the value using the given formatter.

impl PartialEq for PendingReason

fn eq(&self, other: &PendingReason) -> 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 PendingReason

impl Eq for PendingReason

impl StructuralPartialEq for PendingReason