Enum AsrError 

#[non_exhaustive]
pub enum AsrError {
    ModelNotFound(String),
    Unsupported(&'static str),
    InvalidInput(String),
    AudioIo {
        path: PathBuf,
        source: Error,
    },
    Inference(String),
    Config(String),
    Network {
        url: String,
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
}

All errors a voxora engine or model source may return.

#[non_exhaustive] so we can add variants in future minor releases without breaking downstream match arms.

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.

ModelNotFound(String)

The requested model could not be located by any known source.

Unsupported(&'static str)

The requested operation is not supported by this engine / source.

InvalidInput(String)

Caller-supplied input was rejected (bad audio format, unknown language code, out-of-range parameter, …).

AudioIo

Audio file I/O failed.

Fields

path: PathBuf

Path that failed to read or write.

source: Error

Underlying I/O error.

Inference(String)

The inference pass failed inside the engine (numerical error, shape mismatch, OOM, …).

Config(String)

The model or runtime configuration is invalid.

Network

Network failure while acquiring a model (DNS, TCP, TLS, HTTP transport, timeout, non-success status, or auth challenge).

The voxora-traits crate stays offline-pure (no reqwest, no tokio); this variant only carries a String URL, a String message, and an optional boxed std::error::Error. The actual network code lives in voxora-hf.

Fields

url: String

URL that failed, if known.

message: String

Human-readable description of the failure mode.

source: Option<Box<dyn Error + Send + Sync>>

Underlying error, when available.

Implementations

impl AsrError

pub fn audio_io(path: impl Into<PathBuf>, source: Error) -> Self

Construct an AsrError::AudioIo from an I/O error and a path.

pub fn network( url: impl Into<String>, message: impl Into<String>, source: Option<Box<dyn Error + Send + Sync>>, ) -> Self

Construct an AsrError::Network from a URL, a message, and an optional inner error.

Trait Implementations

impl Debug for AsrError

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

Formats the value using the given formatter.

impl Display for AsrError

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

Formats the value using the given formatter.

impl Error for AsrError

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.