Struct Failure 

pub struct Failure {
    pub code: String,
    pub retryable: bool,
    pub message: String,
}

A refused request: a stable code, whether retrying can help, and a message safe to hand back to the orchestrator.

retryable is the field an orchestrator actually branches on, so it is computed rather than guessed. Getting it wrong in the safe-looking direction is what hurts: a terminal failure marked retryable becomes a scheduler spinning on a request that can never succeed.

Fields

code: String

Stable machine-readable code.

retryable: bool

Whether an identical retry could succeed later.

message: String

Human-readable detail.

Implementations

impl Failure

pub fn terminal(code: &str, message: impl Into<String>) -> Self

A terminal failure: retrying the identical request cannot help.

pub fn transient(code: &str, message: impl Into<String>) -> Self

A transient failure: the same request may succeed later.

pub fn to_json(&self) -> Value

The wire form an adapter forwards to its orchestrator.

Trait Implementations

impl Clone for Failure

fn clone(&self) -> Failure

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Failure

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

Formats the value using the given formatter.

impl PartialEq for Failure

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

impl StructuralPartialEq for Failure