Struct RetryConfig 

pub struct RetryConfig {
    pub max_retries: u32,
    pub base_delay: Duration,
    pub max_delay: Duration,
    pub jitter: bool,
    pub respect_retry_after: bool,
}

Automatic-retry policy for a Client, set via ClientBuilder::retry.

Retries are opt-in (a client built without one never retries) and deliberately conservative about which failures are safe to repeat:

• 429 Too Many Requests is retried for any method (the server rejected the request before acting on it; Retry-After is honored when present).
• 5xx responses and transport errors (timeout/connect/request) are retried only for idempotent methods (GET/PUT/DELETE/HEAD/ OPTIONS/TRACE) – never for a bare POST, which may have partially applied server-side.
• 4xx other than 429 is never retried.

Delay grows as base_delay * 2^attempt, capped at max_delay. With jitter on (the default) the actual sleep is a uniform random draw in [0, delay] (“full jitter”), spreading retries so a fleet of clients doesn’t stampede a recovering server in lockstep.

Fields

max_retries: u32

Maximum number of additional attempts after the first. 0 disables retrying entirely.

base_delay: Duration

First-retry delay; doubles each subsequent attempt.

max_delay: Duration

Upper bound on any single computed delay (also caps a large Retry-After).

jitter: bool

Apply full jitter to each delay.

respect_retry_after: bool

Honor a Retry-After response header (seconds form) in place of the computed backoff, still capped by max_delay.

Implementations

impl RetryConfig

pub fn disabled() -> Self

A policy that never retries – the Client default.

pub fn new(max_retries: u32) -> Self

The default backoff (500ms base, 30s cap, full jitter, honors Retry-After) with a custom retry count.

Trait Implementations

impl Clone for RetryConfig

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 RetryConfig

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

Formats the value using the given formatter.

impl Default for RetryConfig

fn default() -> Self

Returns the “default value” for a type.