Struct TransitionError 

pub struct TransitionError { /* private fields */ }

Message-only error produced by the return_recover! macro family

The macros convert this into the implementor’s error type via Into, so implementors with a TryTransitionable::Error other than TransitionError must provide a From<TransitionError> impl to use them:

use statecraft::{return_recover, Recovered, SelfTransitionable, State, Stateful, TransitionError, Transitionable, TryTransitionable};

#[derive(Debug)]
enum ServerError {
    Transition(TransitionError),
}

impl From<TransitionError> for ServerError {
    fn from(err: TransitionError) -> Self {
        ServerError::Transition(err)
    }
}

impl TryTransitionable<Running, Init> for Server<Init> {
    type SuccessStateful = Server<Running>;
    type FailureStateful = Server<Init>;
    type Error = ServerError;

    fn try_transition(
        self,
    ) -> Result<Self::SuccessStateful, Recovered<Self::FailureStateful, Self::Error>> {
        return_recover!(self, "We always fail :(")
    }
}

A TransitionError TryTransitionable::Error converts as-is, and a boxed error type like Box<dyn std::error::Error + Send + Sync> converts through the standard library’s blanket boxing impl.

Implementations

impl TransitionError

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

Trait Implementations

impl Debug for TransitionError

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

Formats the value using the given formatter.

impl Display for TransitionError

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

Formats the value using the given formatter.

impl Error for TransitionError

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.