Enum EventBusError 

pub enum EventBusError {
    NotStarted,
    StartFailed {
        message: String,
    },
    InvalidArgument {
        field: &'static str,
        message: String,
    },
    MissingField {
        field: &'static str,
    },
    HandlerFailed {
        message: String,
    },
    HandlerPanicked,
    InterceptorFailed {
        phase: &'static str,
        message: String,
    },
    ErrorHandlerFailed {
        phase: &'static str,
        message: String,
    },
    DeadLetterFailed {
        message: String,
    },
    ExecutionRejected {
        message: String,
    },
    ShutdownTimedOut {
        timeout: Duration,
    },
    LockPoisoned {
        resource: &'static str,
    },
    TypeMismatch {
        expected: &'static str,
        actual: &'static str,
    },
    UnsupportedOperation {
        operation: &'static str,
    },
}

Error returned by event bus configuration, publishing, or subscription work.

Variants

NotStarted

Operation requires a started event bus.

StartFailed

The event bus could not be started.

Fields

message: String

Human-readable startup failure reason.

InvalidArgument

An argument value is invalid.

Fields

field: &'static str

Argument name.

message: String

Human-readable validation message.

MissingField

A required builder field is missing.

Fields

field: &'static str

Missing field name.

HandlerFailed

Subscriber handler failed.

Fields

message: String

Human-readable failure message.

HandlerPanicked

Subscriber handler or interceptor panicked.

InterceptorFailed

A configured interceptor failed while processing an event.

Fields

phase: &'static str

Interceptor phase.

message: String

Human-readable failure message.

ErrorHandlerFailed

A configured error handler failed while processing another error.

Fields

phase: &'static str

Error handling phase.

message: String

Human-readable failure message.

DeadLetterFailed

Dead-letter routing failed after a terminal subscriber failure.

Fields

message: String

Human-readable routing failure message.

ExecutionRejected

Managed executor rejected event processing work.

Fields

message: String

Human-readable rejection reason.

ShutdownTimedOut

Graceful shutdown did not complete before the configured timeout.

Fields

timeout: Duration

Timeout used for the shutdown wait.

LockPoisoned

Shared state lock was poisoned.

Fields

resource: &'static str

Shared resource name.

TypeMismatch

A type-erased event or handler had an unexpected payload type.

Fields

expected: &'static str

Expected Rust type name.

actual: &'static str

Actual Rust type name.

UnsupportedOperation

Operation is not supported by this backend.

Fields

operation: &'static str

Operation name or feature category.

Implementations

impl EventBusError

pub const fn not_started() -> Self

Creates EventBusError::NotStarted.

Returns

Error indicating that the bus must be started first.

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

Creates EventBusError::StartFailed.

Parameters

• message: Startup failure details.

Returns

Startup error with context.

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

Creates EventBusError::InvalidArgument.

Parameters

• field: Argument name.
• message: Validation message.

Returns

Validation error with field context.

pub const fn missing_field(field: &'static str) -> Self

Creates EventBusError::MissingField.

Parameters

• field: Missing builder field.

Returns

Builder validation error.

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

Creates EventBusError::HandlerFailed.

Parameters

• message: Handler failure description.

Returns

Handler failure error.

pub const fn handler_panicked() -> Self

Creates EventBusError::HandlerPanicked.

Returns

Handler panic error used by subscriber failure handling.

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

Creates EventBusError::InterceptorFailed.

Parameters

• phase: Interceptor phase.
• message: Interceptor failure details.

Returns

Interceptor failure with context.

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

Creates EventBusError::ErrorHandlerFailed.

Parameters

• phase: Error handling phase.
• message: Handler failure details.

Returns

Error handler failure with context.

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

Creates EventBusError::DeadLetterFailed.

Parameters

• message: Dead-letter routing failure details.

Returns

Dead-letter failure with context.

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

Creates EventBusError::ExecutionRejected.

Parameters

• message: Executor rejection details.

Returns

Rejection error with executor context.

pub const fn shutdown_timed_out(timeout: Duration) -> Self

Creates EventBusError::ShutdownTimedOut.

Parameters

• timeout: Timeout that elapsed before shutdown completed.

Returns

Shutdown timeout error with the configured duration.

pub const fn lock_poisoned(resource: &'static str) -> Self

Creates EventBusError::LockPoisoned.

Parameters

• resource: Name of the poisoned shared state.

Returns

Lock-poisoning error.

pub const fn type_mismatch(expected: &'static str, actual: &'static str) -> Self

Creates EventBusError::TypeMismatch.

Parameters

• expected: Expected type name.
• actual: Actual type name.

Returns

Type-erasure mismatch error.

pub const fn unsupported_operation(operation: &'static str) -> Self

Creates EventBusError::UnsupportedOperation.

Parameters

• operation: Operation name or feature category.

Returns

Error indicating that the current backend does not support the operation.

pub const fn kind(&self) -> &'static str

Returns a stable symbolic error kind.

Returns

Static string useful for diagnostics and dead-letter metadata.

Trait Implementations

impl Clone for EventBusError

fn clone(&self) -> EventBusError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EventBusError

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

Formats the value using the given formatter.

impl Display for EventBusError

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

Formats the error for logs and assertions.

impl Error for EventBusError

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 PartialEq for EventBusError

fn eq(&self, other: &EventBusError) -> 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 EventBusError

impl StructuralPartialEq for EventBusError