Enum RetryDirective 

#[non_exhaustive]
pub enum RetryDirective {
    Stop,
    Retry {
        backoff_ms: u64,
    },
    Escalate {
        reason: EscalationReason,
    },
}

What the dispatcher does next, returned by RetryPolicy::decide.

Examples

let stop = RetryDirective::Stop;
let retry = RetryDirective::Retry { backoff_ms: 1000 };
let escalate = RetryDirective::Escalate {
    reason: EscalationReason::SoftBlock,
};

match escalate {
    RetryDirective::Stop => println!("Stop"),
    RetryDirective::Retry { backoff_ms } => println!("Wait {}ms", backoff_ms),
    RetryDirective::Escalate { reason } => println!("Escalate: {:?}", reason),
    // `#[non_exhaustive]`: callers outside the crate must include a wildcard
    // so future variants do not break their match.
    _ => println!("other directive"),
}

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.

Stop

Stop. Surface the current result to the caller.

Retry

Retry the same tier after backoff_ms. Use for rate-limit / 5xx.

Fields

backoff_ms: u64

Milliseconds to wait before retrying.

Escalate

Escalate to the next tier per EscalationStrategy.

Fields

reason: EscalationReason

Reason for escalation, used for metrics and logging.

Trait Implementations

impl Clone for RetryDirective

fn clone(&self) -> RetryDirective

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RetryDirective

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

Formats the value using the given formatter.

impl PartialEq for RetryDirective

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