Struct RetryPolicy 

pub struct RetryPolicy {
    pub max_attempts: usize,
    pub initial_delay: Duration,
    pub max_delay: Duration,
    pub multiplier: f64,
    pub jitter: bool,
}

Configuration for retry behavior with exponential backoff.

Fields

max_attempts: usize

Maximum number of attempts (including the initial attempt).

initial_delay: Duration

Initial delay before the first retry.

max_delay: Duration

Maximum delay between retries (caps exponential growth).

multiplier: f64

Multiplier for exponential backoff (delay *= multiplier after each retry).

jitter: bool

Whether to add random jitter to delays to avoid thundering herd.

Implementations

impl RetryPolicy

pub fn new() -> Self

Creates a new retry policy with default settings.

pub fn with_max_attempts(self, attempts: usize) -> Self

Sets the maximum number of attempts.

pub fn with_initial_delay(self, delay: Duration) -> Self

Sets the initial delay before the first retry.

pub fn with_max_delay(self, delay: Duration) -> Self

Sets the maximum delay between retries.

pub fn with_multiplier(self, multiplier: f64) -> Self

Sets the multiplier for exponential backoff.

pub fn with_jitter(self, jitter: bool) -> Self

Enables or disables jitter.

pub fn no_retry() -> Self

Creates a policy that disables retries (single attempt only).

pub fn delay_for_attempt(&self, attempt: usize) -> Duration

Calculates the delay for a given attempt number (0-indexed).

The attempt number is internally capped to prevent integer overflow in the exponential calculation.

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

Formats the value using the given formatter.

impl Default for RetryPolicy

fn default() -> Self

Returns the “default value” for a type.