Enum RingEngineError 

#[non_exhaustive]
pub enum RingEngineError {
    NotInitialized,
    GenesisAlreadyComplete,
    ProcessorFailed {
        unit: UnitId,
        reason: String,
    },
    UnitDisabled {
        unit: UnitId,
    },
    GateRejected(GateRejection),
    Boundary(BoundaryError),
    Core(SomaError),
    CycleFailed {
        cycle_index: u64,
        reason: String,
    },
}

Errors produced by ring engine operations.

Marked #[non_exhaustive] so adding a variant in a future minor release is not a breaking change. Consumers must include a wildcard arm in any exhaustive match.

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.

NotInitialized

Genesis has not been run yet.

GenesisAlreadyComplete

Genesis has already been completed.

ProcessorFailed

A unit’s processor returned an error.

The reason is an opaque string because the engine does not know the concrete error type of registered crate::RingProcessor implementations.

Fields

unit: UnitId

reason: String

UnitDisabled

A unit has no registered processor.

Fields

unit: UnitId

GateRejected(GateRejection)

A BEFORE gate rejected the cycle.

Boundary(BoundaryError)

A boundary operation failed.

Core(SomaError)

A core structural operation failed.

CycleFailed

The ring cycle failed (aggregated reason).

Fields

cycle_index: u64

reason: String

Trait Implementations

impl Debug for RingEngineError

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

Formats the value using the given formatter.

impl Display for RingEngineError

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

Formats the value using the given formatter.

impl Error for RingEngineError

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<BoundaryError> for RingEngineError

fn from(source: BoundaryError) -> Self

Converts to this type from the input type.

impl From<GateRejection> for RingEngineError

fn from(source: GateRejection) -> Self

Converts to this type from the input type.

impl From<SomaError> for RingEngineError

fn from(source: SomaError) -> Self

Converts to this type from the input type.