Enum Error 

#[non_exhaustive]
pub enum Error {
    Moq(Error),
    Mux(Error),
    ResourceRefused,
    InvalidFileUrl,
    ParsePlaylist(String),
    NoVariants,
    MissingMap,
    EmptySegmentUri,
    MissingByteRangeOffset {
        url: Url,
    },
    InvalidByteRange {
        url: Url,
        start: u64,
        length: u64,
    },
    ByteRangeLengthMismatch {
        url: Url,
        expected: u64,
        actual: usize,
    },
    ByteRangeResponseMismatch {
        url: Url,
        start: u64,
        end: u64,
    },
    SequenceOverflow {
        kind: SequenceKind,
        value: u64,
    },
    InvalidGeneration(String),
    UrlParse(ParseError),
    Reqwest(Arc<Error>),
    Io(Arc<Error>),
}

Errors produced by the HLS <-> MoQ gateway (import and export).

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.

Moq(Error)

Error from the underlying moq-net transport.

Mux(Error)

Error from the moq-mux CMAF import/export layer.

ResourceRefused

An import resource or redirect hop left the playlist’s origin, or the playlist uses an unsupported scheme.

InvalidFileUrl

A file:// URL could not be turned back into a filesystem path.

ParsePlaylist(String)

The fetched HLS playlist could not be parsed.

NoVariants

The master playlist contained no variant this gateway can import.

MissingMap

A media playlist had no EXT-X-MAP, so there is no CMAF init segment.

EmptySegmentUri

A media segment had an empty URI.

MissingByteRangeOffset

An implicit HLS byte range had no preceding range for the same resource.

Fields

url: Url

The resource whose range omitted an offset.

InvalidByteRange

An HLS byte range was empty or overflowed its integer representation.

Fields

url: Url

The ranged resource.

start: u64

The first requested byte.

length: u64

The requested byte count.

ByteRangeLengthMismatch

A ranged resource response had a different length than requested.

Fields

url: Url

The ranged resource.

expected: u64

The requested byte count.

actual: usize

The returned byte count.

ByteRangeResponseMismatch

A partial HTTP response identified a different byte range than requested.

Fields

url: Url

The ranged resource.

start: u64

The first requested byte.

end: u64

The last requested byte, inclusive.

SequenceOverflow

An HLS media or discontinuity sequence was too large to pack into a MoQ group sequence.

Fields

kind: SequenceKind

Which sequence overflowed.

value: u64

The offending sequence value.

InvalidGeneration(String)

An export generation had characters a URL path segment can’t carry verbatim.

UrlParse(ParseError)

A playlist or segment URI could not be resolved against its base.

Reqwest(Arc<Error>)

HTTP error while fetching a playlist or segment.

Io(Arc<Error>)

I/O error while reading a local playlist or segment.

Implementations

impl Error

pub fn status(&self) -> Option<u16>

The HTTP status the origin answered with, if it answered with one at all.

The import loop consults it: a 503 on a playlist fetch is worth another pass, a 404 is the origin’s settled answer. Nothing else here is classified; a failure with no status falls through to the backoff budget.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for Error

fn from(source: ParseError) -> Self

Converts to this type from the input type.