Enum RetryStrategy 

pub enum RetryStrategy {
    Fixed {
        delay: u64,
    },
    Linear {
        initial: u64,
        increment: u64,
        max_delay: Option<u64>,
    },
    Exponential {
        initial: u64,
        multiplier: f64,
        max_delay: Option<u64>,
    },
    Polynomial {
        initial: u64,
        power: f64,
        max_delay: Option<u64>,
    },
    Fibonacci {
        initial: u64,
        max_delay: Option<u64>,
    },
    DecorrelatedJitter {
        base: u64,
        max_delay: u64,
    },
    FullJitter {
        initial: u64,
        multiplier: f64,
        max_delay: Option<u64>,
    },
    EqualJitter {
        initial: u64,
        multiplier: f64,
        max_delay: Option<u64>,
    },
    Custom {
        delays: Vec<u64>,
        fallback: u64,
    },
    Immediate,
}

Retry strategy configuration

Variants

Fixed

Fixed delay between retries

Fields

delay: u64

Delay in seconds

Linear

Linear backoff (delay increases linearly)

Fields

initial: u64

Initial delay in seconds

increment: u64

Increment per retry in seconds

max_delay: Option<u64>

Maximum delay in seconds

Exponential

Exponential backoff (delay doubles each retry)

Fields

initial: u64

Initial delay in seconds

multiplier: f64

Multiplier (default 2.0)

max_delay: Option<u64>

Maximum delay in seconds

Polynomial

Polynomial backoff (delay = initial * retry^power)

Fields

initial: u64

Initial delay in seconds

power: f64

Power (exponent)

max_delay: Option<u64>

Maximum delay in seconds

Fibonacci

Fibonacci backoff (delays follow Fibonacci sequence)

Fields

initial: u64

Initial delay in seconds (F(1))

max_delay: Option<u64>

Maximum delay in seconds

DecorrelatedJitter

Decorrelated jitter (AWS recommended for distributed systems) delay = random(base, previous_delay * 3)

Fields

base: u64

Base delay in seconds

max_delay: u64

Maximum delay in seconds

FullJitter

Full jitter (random between 0 and exponential delay)

Fields

initial: u64

Initial delay in seconds

multiplier: f64

Multiplier (default 2.0)

max_delay: Option<u64>

Maximum delay in seconds

EqualJitter

Equal jitter (half fixed, half random)

Fields

initial: u64

Initial delay in seconds

multiplier: f64

Multiplier (default 2.0)

max_delay: Option<u64>

Maximum delay in seconds

Custom

Custom delays specified explicitly for each retry

Fields

delays: Vec<u64>

Delays for each retry attempt

fallback: u64

Delay to use after all custom delays exhausted

Immediate

No delay between retries

Implementations

impl RetryStrategy

pub fn fixed(delay: u64) -> Self

Create a fixed delay strategy

pub fn linear(initial: u64, increment: u64) -> Self

Create a linear backoff strategy

pub fn linear_with_max(initial: u64, increment: u64, max_delay: u64) -> Self

Create a linear backoff strategy with max delay

pub fn exponential(initial: u64, multiplier: f64) -> Self

Create an exponential backoff strategy

pub fn exponential_with_max( initial: u64, multiplier: f64, max_delay: u64, ) -> Self

Create an exponential backoff strategy with max delay

pub fn polynomial(initial: u64, power: f64) -> Self

Create a polynomial backoff strategy

pub fn fibonacci(initial: u64) -> Self

Create a Fibonacci backoff strategy

pub fn decorrelated_jitter(base: u64, max_delay: u64) -> Self

Create a decorrelated jitter strategy (AWS recommended)

pub fn full_jitter(initial: u64, multiplier: f64, max_delay: u64) -> Self

Create a full jitter strategy

pub fn equal_jitter(initial: u64, multiplier: f64, max_delay: u64) -> Self

Create an equal jitter strategy

pub fn custom(delays: Vec<u64>, fallback: u64) -> Self

Create a custom delays strategy

pub fn immediate() -> Self

Create an immediate retry strategy (no delay)

pub fn calculate_delay( &self, retry_count: u32, previous_delay: Option<u64>, ) -> u64

Calculate the delay for a given retry attempt

Arguments

• retry_count - Current retry attempt (0-based)
• previous_delay - Previous delay (used by decorrelated jitter)

Returns

Delay in seconds before the next retry

pub const fn name(&self) -> &'static str

Get the strategy name as a string

pub const fn is_jittered(&self) -> bool

Check if this strategy uses randomness

Trait Implementations

impl Clone for RetryStrategy

fn clone(&self) -> RetryStrategy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RetryStrategy

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

Formats the value using the given formatter.

impl Default for RetryStrategy

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RetryStrategy

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for RetryStrategy

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

Formats the value using the given formatter.

impl Serialize for RetryStrategy

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.