Enum SourceError 

#[non_exhaustive]
pub enum SourceError {
    Net(NetError),
    Storage(StorageError),
    InvalidPath(String),
    PlaylistParse(String),
    VariantNotFound(String),
    SegmentNotFound(String),
    KeyProcessing(String),
    InvalidUrl(String),
    Cancelled,
    Timeout(String),
    WaitBudgetExceeded,
    FormatChangeNotApplicable,
    Io(Error),
    Other(Box<dyn StdError + Send + Sync>),
}

Unified source error, surfaced by every Source impl.

Concrete adapters (file, HLS, mocks) flatten their crate-local error types into one of these variants at the Source impl boundary so that Source itself stays object-safe (no associated Error type).

Adapter-specific failures that don’t map to a generic variant flow through SourceError::Other, which boxes the original typed error for downcast access.

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.

Net(NetError)

Storage(StorageError)

InvalidPath(String)

PlaylistParse(String)

VariantNotFound(String)

SegmentNotFound(String)

KeyProcessing(String)

InvalidUrl(String)

Cancelled

Timeout(String)

WaitBudgetExceeded

Cooperative wait_range budget exceeded — caller passed Some(timeout) and the source did not become ready within it. Hot-path classifier for the audio worker’s retry loop; diagnostic detail is intentionally absent so emission allocates nothing.

FormatChangeNotApplicable

format_change_segment_range not applicable in the current state. Reasons (all expected steady states, not bugs):

• source has no init-bearing format-change concept (file source — default Source trait impl returns this);
• active HLS variant was activated by same-codec ABR with served_from > 0: init bytes live at natural [0..init_size) while virtual space starts at byte_shift, so init is unreachable via Stream reads. Same-codec post-switch playback continues through byte_shift; recovery via init probe is by design not applicable.

Callers must treat this as “no recovery possible at this site” (steady-state) — not an error to surface to the user.

Io(Error)

Other(Box<dyn StdError + Send + Sync>)

Implementations

impl SourceError

pub fn other<E>(err: E) -> Self

where E: StdError + Send + Sync + 'static,

Wrap an arbitrary error in Other.

Trait Implementations

impl Debug for SourceError

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

Formats the value using the given formatter.

impl Display for SourceError

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

Formats the value using the given formatter.

impl Error for SourceError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for SourceError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<NetError> for SourceError

fn from(source: NetError) -> Self

Converts to this type from the input type.

impl From<StorageError> for SourceError

fn from(source: StorageError) -> Self

Converts to this type from the input type.