Enum Error 

pub enum Error {
    NoCacheDir,
    Io {
        path: PathBuf,
        source: Error,
    },
    Http {
        url: String,
        source: Error,
    },
    HttpStatus {
        url: String,
        status: u16,
    },
    SizeMismatch {
        path: PathBuf,
        expected: u64,
        actual: u64,
    },
    Cancelled,
    SampleRate {
        expected: u32,
        actual: u32,
    },
    Channels {
        actual: u16,
    },
    Capture {
        message: String,
    },
    WorkerSpawn {
        message: String,
    },
    ModelLoad {
        path: PathBuf,
        message: String,
    },
    Recognition {
        message: String,
    },
    EngineStopped,
    StalePartial {
        path: PathBuf,
        source: Error,
    },
    HashMismatch {
        path: PathBuf,
        expected: String,
        actual: String,
    },
    Catalogue {
        message: String,
    },
    Bench {
        message: String,
    },
}

Everything this crate can fail with.

Variants

NoCacheDir

No models directory was configured and the platform cache directory could not be resolved.

Io

A filesystem operation on path failed. A transfer that dies mid-body lands here too rather than in Error::Http: it surfaces while reading the response, and path labels the partial being written rather than naming what actually failed.

Fields

path: PathBuf

source: Error

Http

The request failed before any body arrived - connection, TLS, or a refused handshake.

Fields

url: String

source: Error

HttpStatus

The server answered, but not with the file.

Fields

url: String

status: u16

SizeMismatch

A file on disk is not the length the spec records. The usual cause is an interrupted download that was never resumed.

Fields

path: PathBuf

expected: u64

actual: u64

Cancelled

Work was stopped on request rather than by a fault: a progress callback returning Break during a fetch, or an abandoned crate::Ticket aborting an inference.

Whatever already finished is kept - a model that reached crate::Progress::Ready is installed - and any partial transfer is left where it is, so a later call resumes rather than starting over.

SampleRate

The source declares a rate the models cannot read. Rejected rather than resampled: a silent resample yields plausible text from the wrong signal, and nothing downstream can detect that.

Fields

expected: u32

actual: u32

Channels

The source declares more than one channel. Interleaved stereo read as mono is a plausible doubled-rate signal, not an error, so it is refused at the boundary.

Fields

actual: u16

Capture

Opening or running the input stream failed.

Fields

message: String

WorkerSpawn

The transcription worker could not be started.

Fields

message: String

ModelLoad

The weights could not be loaded.

Fields

path: PathBuf

message: String

Recognition

Recognition itself failed.

Fields

message: String

EngineStopped

The worker is gone, so nothing can be transcribed and no queued result will ever arrive.

StalePartial

A partial does not match its spec and could not be removed, so every later call fails identically until someone clears it. The usual cause is a models directory that is not writable.

Fields

path: PathBuf

source: Error

HashMismatch

A file on disk is the right length but the wrong bytes.

Fields

path: PathBuf

expected: String

actual: String

Catalogue

A catalogue document is not an entry this build reads.

Fields

message: String

Bench

A bench’s corpus could not be read: a wav that is not the shape this crate reads, or a fixture set that disagrees with itself.

Fields

message: String

Trait Implementations

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.