Enum AttemptFailure 

pub enum AttemptFailure<E> {
    Error(E),
    Timeout,
    Panic(AttemptPanic),
    Executor(AttemptExecutorError),
}

Failure produced by a single operation attempt.

The generic parameter E is the caller’s operation error type. Timeout, panic, and executor failures do not contain E because they are generated by the retry runtime, not returned by the operation.

Variants

Error(E)

The operation returned an application error.

Timeout

The attempt exceeded the effective timeout.

This can be the configured per-attempt timeout, the remaining max-operation-elapsed budget, or the remaining max-total-elapsed budget used by async and worker-thread attempts.

Panic(AttemptPanic)

The attempt panicked inside an isolated execution boundary.

Executor(AttemptExecutorError)

The retry executor failed before the attempt could run normally.

Implementations

impl<E> AttemptFailure<E>

pub fn as_error(&self) -> Option<&E>

Returns the application error when this failure wraps one.

Parameters

This method has no parameters.

Returns

Some(&E) for AttemptFailure::Error, or None for runtime-generated failures.

Errors

This method does not return errors.

pub fn into_error(self) -> Option<E>

Consumes the failure and returns the application error when present.

Parameters

This method has no parameters.

Returns

Some(E) for AttemptFailure::Error, or None for runtime-generated failures.

Errors

This method does not return errors.

pub fn as_panic(&self) -> Option<&AttemptPanic>

Returns captured panic information when this failure wraps one.

Parameters

This method has no parameters.

Returns

Some(&AttemptPanic) for AttemptFailure::Panic, or None for other variants.

Errors

This method does not return errors.

pub fn as_executor_error(&self) -> Option<&AttemptExecutorError>

Returns executor failure information when this failure wraps one.

Parameters

This method has no parameters.

Returns

Some(&AttemptExecutorError) for AttemptFailure::Executor, or None for other variants.

Errors

This method does not return errors.

Trait Implementations

impl<E: Clone> Clone for AttemptFailure<E>

fn clone(&self) -> AttemptFailure<E>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<E: Debug> Debug for AttemptFailure<E>

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

Formats the value using the given formatter.

impl<'de, E> Deserialize<'de> for AttemptFailure<E>

where E: DeserializeOwned,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<E: Display> Display for AttemptFailure<E>

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

Formats the value using the given formatter.

impl<E: PartialEq> PartialEq for AttemptFailure<E>

fn eq(&self, other: &AttemptFailure<E>) -> 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<E> Serialize for AttemptFailure<E>

where E: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<E: Eq> Eq for AttemptFailure<E>

impl<E> StructuralPartialEq for AttemptFailure<E>