Enum Error 

pub enum Error {
    TooLarge {
        max: usize,
        len: usize,
    },
    Core(Error),
    Envelope(Error),
    Codec(CodecError),
    UnsupportedCodec {
        codec_id: u8,
    },
    SchemaMismatch {
        expected: u64,
        found: u64,
    },
    TypeMismatch {
        expected: u32,
        found: u32,
    },
    VersionMismatch {
        expected: u16,
        found: u16,
    },
}

Typed-layer error.

This wraps and normalizes errors from:

• indexbus-core (queue and routing semantics)
• indexbus-msg (v1 envelope/header)
• indexbus-codec (payload encoding/decoding)

Recovery guidance

• Error::TooLarge is a producer-side sizing issue: the encoded payload does not fit in a single slot.
• Error::UnsupportedCodec / *Mismatch errors typically indicate a schema mismatch between producer and consumer (wrong expected type or version).
• Error::Envelope / Error::Codec are data validation failures. In receive paths, the underlying message is still consumed (see indexbus-core try_recv_with semantics).

Variants

TooLarge

Payload cannot fit into a single slot.

Fields

max: usize

Maximum supported payload size in bytes.

len: usize

Actual payload size in bytes.

Core(Error)

Error raised by the core region handles.

Envelope(Error)

Error raised while encoding/decoding the v1 header/envelope.

Codec(CodecError)

Error raised by the configured codec.

UnsupportedCodec

The received message uses a codec id that does not match C::CODEC_ID.

Fields

codec_id: u8

Codec id found in the message header.

SchemaMismatch

schema_id does not match the expected message identity.

Fields

expected: u64

Expected schema id.

found: u64

Schema id found in the header.

TypeMismatch

msg_type does not match the expected message identity.

Fields

expected: u32

Expected message type.

found: u32

Message type found in the header.

VersionMismatch

msg_version does not match the expected message identity.

Fields

expected: u16

Expected message version.

found: u16

Message version found in the header.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

Available on crate feature std only.

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

Formats the value using the given formatter.

impl Error for Error

Available on crate feature std only.

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<CodecError> for Error

fn from(value: CodecError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(value: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(value: Error) -> Self

Converts to this type from the input type.

impl<E> From<PublishWithError<E>> for Error

where E: Into<Error>,

fn from(value: PublishWithError<E>) -> Self

Converts to this type from the input type.

impl<E> From<RecvWithError<E>> for Error

where E: Into<Error>,

fn from(value: RecvWithError<E>) -> Self

Converts to this type from the input type.

impl PartialEq for Error

fn eq(&self, other: &Error) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Error

impl StructuralPartialEq for Error