Struct RetryPolicy 

pub struct RetryPolicy {
    pub max_attempts: u32,
    pub initial_backoff: Duration,
    pub max_backoff: Duration,
    pub backoff_multiplier: u32,
    pub jitter: bool,
    pub honour_retry_after: bool,
    pub max_retry_after: Duration,
}

How hard to try one candidate before moving on (spec §20.7).

Fields

max_attempts: u32

Attempts per candidate, including the first. 1 disables retries.

initial_backoff: Duration

Delay before the second attempt.

max_backoff: Duration

Ceiling on the computed delay.

backoff_multiplier: u32

Multiplier applied per additional attempt.

jitter: bool

Whether to spread delays. Off by default: a fixed schedule makes a replayed turn reproduce the same timing, and the jitter that is available is derived from the request id rather than from randomness, so it stays reproducible too.

honour_retry_after: bool

Whether a provider’s own Retry-After overrides the computed backoff.

max_retry_after: Duration

Ceiling on a honoured Retry-After, so a provider cannot park a turn.

Implementations

impl RetryPolicy

pub const DEFAULT: Self

Three attempts, 200 ms growing by four, capped at five seconds, no jitter, honouring Retry-After up to thirty seconds.

pub const NO_RETRY: Self

One attempt per candidate: fall back rather than retry.

pub fn backoff_for(&self, attempt: AttemptNumber) -> Duration

The delay before attempt number attempt of a candidate.

attempt is 1-based, so AttemptNumber::FIRST has no delay.

pub fn delay_for( &self, attempt: AttemptNumber, previous: &ProviderError, request_id: RequestId, ) -> Duration

The delay to wait before attempt, given what went wrong last time.

A RetryAfter failure that carried a delay wins over the computed backoff when honour_retry_after is set, capped by max_retry_after. Jitter, when enabled, is derived from request_id so the same turn replays with the same timing.

Trait Implementations

impl Clone for RetryPolicy

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RetryPolicy

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

Formats the value using the given formatter.

impl Default for RetryPolicy

fn default() -> Self

Returns the “default value” for a type.

impl Eq for RetryPolicy

impl PartialEq for RetryPolicy

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for RetryPolicy