Enum Error 

#[non_exhaustive]
pub enum Error {
    Path(PathError),
    NoRoute {
        path: Path,
    },
    Codec {
        kind: CodecErrorKind,
        operation: CodecOperation,
        format: Format,
        message: String,
    },
    UnsupportedFormat(Format),
    Ll(LLError),
    Io(Error),
    Store {
        store: &'static str,
        operation: &'static str,
        message: String,
    },
    NotFound {
        path: Path,
    },
    PermissionDenied {
        message: String,
    },
    Conflict {
        message: String,
    },
    Overloaded {
        message: String,
    },
    DeadlineExceeded {
        message: String,
    },
    ResourceLimit {
        message: String,
    },
    Cancelled {
        message: String,
    },
}

Errors at the Core layer.

These include semantic errors (invalid paths, codec failures) in addition to the transport errors from the LL layer.

The typed variants (NotFound, PermissionDenied, Conflict, Overloaded, DeadlineExceeded, ResourceLimit) exist so that stores and transports can map errors structurally instead of string-matching messages. Prefer them over Store when one fits.

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.

Path(PathError)

Path validation error.

NoRoute

No route found for path (in overlay/mount stores).

Fields

path: Path

Codec

Codec error during encode/decode.

Fields

kind: CodecErrorKind

operation: CodecOperation

format: Format

message: String

UnsupportedFormat(Format)

Format not supported by codec.

Ll(LLError)

Error from the LL layer.

Io(Error)

I/O error (filesystem, network).

Store

Store-specific error with context.

Fields

store: &'static str

operation: &'static str

message: String

NotFound

An operation referenced a path that does not exist.

Note: Reader::read signals a missing path with Ok(None); this variant is for operations that require the path to exist (writes to handles, deletes, remote calls).

Fields

path: Path

PermissionDenied

The caller is not allowed to perform this operation.

Fields

message: String

Conflict

The operation conflicts with concurrent or existing state (stale version, handle already exists, etc.).

Fields

message: String

Overloaded

The store is temporarily unable to accept the operation.

Fields

message: String

DeadlineExceeded

The operation did not complete within its deadline.

Fields

message: String

ResourceLimit

A resource limit was exceeded (size, depth, count, quota).

Fields

message: String

Cancelled

The operation was cancelled — typically a parked read whose handle was released or whose store is shutting down.

Fields

message: String

Implementations

impl Error

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

Create a store-specific error.

pub fn decode(format: Format, message: impl Into<String>) -> Self

Create a codec decode error.

pub fn encode(format: Format, message: impl Into<String>) -> Self

Create a codec encode error.

pub fn not_found(path: Path) -> Self

Create a not-found error for a path.

pub fn permission_denied(message: impl Into<String>) -> Self

Create a permission-denied error.

pub fn conflict(message: impl Into<String>) -> Self

Create a conflict error.

pub fn overloaded(message: impl Into<String>) -> Self

Create an overloaded error.

pub fn deadline_exceeded(message: impl Into<String>) -> Self

Create a deadline-exceeded error.

pub fn resource_limit(message: impl Into<String>) -> Self

Create a resource-limit error.

pub fn cancelled(message: impl Into<String>) -> Self

Create a cancelled error.

pub fn is_cancelled(&self) -> bool

Whether this error is a cancellation.

pub fn is_not_found(&self) -> bool

Whether this error is a not-found error.

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, f: &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<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<LLError> for Error

fn from(e: LLError) -> Self

Converts to this type from the input type.

impl From<PathError> for Error

fn from(e: PathError) -> Self

Converts to this type from the input type.