Enum Error 

pub enum Error {
    NotFound {
        loader: String,
        resource: String,
        item: String,
    },
    NoAccess {
        loader: String,
        resource: String,
        source: Box<dyn StdError + Send + Sync>,
    },
    Timeout {
        loader: String,
        resource: String,
        timeout_in_seconds: u64,
        source: Box<dyn StdError + Send + Sync>,
    },
    InvalidOption {
        loader: String,
        key: String,
        reason: String,
    },
    InvalidResource {
        loader: String,
        resource: String,
        reason: String,
    },
    Duplicate {
        loader: String,
        resource: String,
        name: String,
        format_1: String,
        format_2: String,
    },
    Load {
        loader: String,
        resource: String,
        description: String,
        source: Box<dyn StdError + Send + Sync>,
    },
    Other(Box<dyn StdError + Send + Sync>),
}

Errors a Load implementation can return.

Each variant carries a loader field (set to your Load::name) so messages identify the source. See Load’s “Choosing an error” section for guidance on which to pick.

Variants

NotFound

The requested resource or entry does not exist and was not configured to be ignored. item names what was missing (e.g. `file "app.json"`).

Fields

loader: String

resource: String

item: String

NoAccess

Access was denied (e.g. filesystem permissions, HTTP 401/403). source carries the underlying backend error.

Fields

loader: String

resource: String

source: Box<dyn StdError + Send + Sync>

Timeout

The operation exceeded its deadline. timeout_in_seconds is the limit that was hit; source carries the underlying backend error.

Fields

loader: String

resource: String

timeout_in_seconds: u64

source: Box<dyn StdError + Send + Sync>

InvalidOption

A known option has the wrong type or value. key is the option name; reason explains the problem (commonly built from OptionValue::type_name on a type mismatch). Loaders only validate options they read — unknown keys are ignored.

Fields

loader: String

key: String

reason: String

InvalidResource

The resource string is empty or malformed for this loader (e.g. a required path is missing). reason explains what was expected.

Fields

loader: String

resource: String

reason: String

Duplicate

Two entries resolve to the same name with differing formats (format_1 vs format_2), so the loader cannot pick one unambiguously.

Fields

loader: String

resource: String

name: String

format_1: String

format_2: String

Load

Catch-all backend failure that doesn’t fit the variants above. description completes the phrase “could not {description}” (e.g. "read contents of file"); source carries the underlying error.

Fields

loader: String

resource: String

description: String

source: Box<dyn StdError + Send + Sync>

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

Bridge for opaque errors via ?/From, when none of the structured variants apply.

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.

impl From<Box<dyn Error + Send + Sync>> for Error

fn from(source: Box<dyn StdError + Send + Sync>) -> Self

Converts to this type from the input type.