Enum Error 

#[non_exhaustive]
pub enum Error {
    Io(Error),
    Json(Error),
    Storage {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Config(String),
    Internal(String),
    PersistQueueClosed,
}

Errors returned by Spectra storage, routing, serialization, and I/O paths.

Backend-specific failures that do not map to I/O or JSON are reported as Storage (with an optional Error::source chain) or Config for builder/wiring mistakes. Internal is reserved for invariant violations and parse bugs.

Examples

use spectra_core::Error;

let error = Error::config("metrics backend is required");
assert_eq!(error.to_string(), "config error: metrics backend is required");

match error {
    Error::Config(message) => assert!(message.contains("backend")),
    Error::Io(_)
    | Error::Json(_)
    | Error::Storage { .. }
    | Error::Internal(_)
    | Error::PersistQueueClosed
    | _ => {
        unreachable!()
    }
}

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.

Io(Error)

Underlying filesystem or stream I/O failure.

Json(Error)

JSON serialization or deserialization failure.

Storage

Storage backend failure (SQLite, remote engine, etc.).

Fields

message: String

Human-readable summary (stable for logs and hosts).

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

Optional underlying backend error for Error::source chains.

Config(String)

Builder, wiring, or configuration mistake.

Internal(String)

Catch-all for invariant violations and unexpected parse bugs.

PersistQueueClosed

Persist worker channel closed before a flush or enqueue ack completed.

Implementations

impl Error

pub fn storage(message: impl Into<String>) -> Error

Storage failure without an underlying source.

pub fn storage_source( message: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> Error

Storage failure wrapping an underlying error.

pub fn config(message: impl Into<String>) -> Error

Configuration / builder failure.

pub fn internal(message: impl Into<String>) -> Error

Invariant or unexpected internal failure.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

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) -> Error

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Error

Converts to this type from the input type.