Enum EngineError 

pub enum EngineError {
    Network {
        kind: NetworkErrorKind,
        message: String,
        retryable: bool,
    },
    Storage {
        kind: StorageErrorKind,
        path: PathBuf,
        message: String,
    },
    Protocol {
        kind: ProtocolErrorKind,
        message: String,
    },
    InvalidInput {
        field: &'static str,
        message: String,
    },
    ResourceLimit {
        resource: &'static str,
        limit: usize,
    },
    NotFound(String),
    AlreadyExists(String),
    InvalidState {
        action: &'static str,
        current_state: String,
    },
    Shutdown,
    Database(String),
    Internal(String),
}

Main error type for the download engine

Variants

Network

Network-related errors (connection, timeout, DNS, etc.)

Fields

kind: NetworkErrorKind

message: String

retryable: bool

Storage

Storage/filesystem errors

Fields

kind: StorageErrorKind

path: PathBuf

message: String

Protocol

Protocol-level errors (HTTP, BitTorrent)

Fields

kind: ProtocolErrorKind

message: String

InvalidInput

Invalid input from user

Fields

field: &'static str

message: String

ResourceLimit

Resource limits exceeded

Fields

resource: &'static str

limit: usize

NotFound(String)

Download not found

AlreadyExists(String)

Download already exists

InvalidState

Invalid state transition

Fields

action: &'static str

current_state: String

Shutdown

Engine is shutting down

Database(String)

Database error

Internal(String)

Internal error (bug)

Implementations

impl EngineError

pub fn is_retryable(&self) -> bool

Check if this error is retryable

pub fn network(kind: NetworkErrorKind, message: impl Into<String>) -> Self

Create a network error

pub fn storage( kind: StorageErrorKind, path: impl Into<PathBuf>, message: impl Into<String>, ) -> Self

Create a storage error

pub fn protocol(kind: ProtocolErrorKind, message: impl Into<String>) -> Self

Create a protocol error

pub fn invalid_input(field: &'static str, message: impl Into<String>) -> Self

Create an invalid input error

Trait Implementations

impl Debug for EngineError

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

Formats the value using the given formatter.

impl Display for EngineError

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

Formats the value using the given formatter.

impl Error for EngineError

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<EngineError> for ProtocolError

fn from(e: EngineError) -> Self

Converts to this type from the input type.

impl From<Error> for EngineError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for EngineError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for EngineError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for EngineError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for EngineError

fn from(err: ParseError) -> Self

Converts to this type from the input type.

impl From<SendError<DownloadEvent>> for EngineError

fn from(_: SendError<DownloadEvent>) -> Self

Converts to this type from the input type.