Struct RetryPolicy 

pub struct RetryPolicy {
    pub max_retries: u32,
    pub initial_backoff: Duration,
    pub max_backoff: Duration,
    pub backoff_multiplier: f64,
}

Configuration for automatic retry with exponential backoff.

Defaults

Field	Default
max_retries	3
initial_backoff	500 ms
max_backoff	30 s
backoff_multiplier	2.0

What a call can cost, which is not the request timeout

ClientConfig::request_timeout is per attempt — its own doc says “per-request” — and a retrying call makes several. The wall-clock a caller should budget for is:

(max_retries + 1) × request_timeout   +   the backoffs between them

At the shipped defaults, with the default 30-second request_timeout: four attempts of 30s plus backoffs of 0.5s, 1s and 2s — about 124 seconds for one send_request on a client configured with “timeout: 30 seconds”. A server sending Retry-After can lengthen each gap up to max_backoff, so the same policy against a rate-limiting server is four attempts plus up to 90 seconds of waiting.

Nothing here is wrong — the two knobs mean what they say — but the product of them is what a caller actually waits for, and multiplying it out is not something anyone does while reading a builder. Wrap the call in tokio::time::timeout if you need a real ceiling; this type does not provide one.

(The push path states the same arithmetic through PushSender::max_delivery_duration, which exists because the server needed to budget against it. A client has no equivalent because nothing else in the process needs the number — only the person calling does.)

Fields

max_retries: u32

Maximum number of retry attempts (not counting the initial attempt).

initial_backoff: Duration

Initial backoff duration before the first retry.

max_backoff: Duration

Maximum backoff duration (caps exponential growth).

backoff_multiplier: f64

Multiplier applied to the backoff after each retry.

Implementations

impl RetryPolicy

pub const fn with_max_retries(self, max_retries: u32) -> RetryPolicy

Creates a retry policy with the given maximum number of retries.

pub const fn with_initial_backoff(self, backoff: Duration) -> RetryPolicy

Sets the initial backoff duration.

pub const fn with_max_backoff(self, max: Duration) -> RetryPolicy

Sets the maximum backoff duration.

pub const fn with_backoff_multiplier(self, multiplier: f64) -> RetryPolicy

Sets the backoff multiplier.

Trait Implementations

impl Clone for RetryPolicy

fn clone(&self) -> RetryPolicy

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<(), Error>

Formats the value using the given formatter.

impl Default for RetryPolicy

fn default() -> RetryPolicy

Returns the “default value” for a type.