Enum RetryPolicy 

pub enum RetryPolicy {
    Count {
        attempts: u32,
        should_retry: Option<ShouldRetryFn>,
    },
    Linear {
        attempts: u32,
        delay: Duration,
        should_retry: Option<ShouldRetryFn>,
        jitter: bool,
    },
    Exponential {
        attempts: u32,
        base_delay: Duration,
        max_delay: Duration,
        should_retry: Option<ShouldRetryFn>,
        jitter: bool,
    },
}

Retry policy configuration.

The attempts value is the maximum number of retries after the initial request. For example, RetryPolicy::count(2) performs up to three HTTP calls (one initial + two retries).

Examples

use better_fetch::RetryPolicy;

// Up to 3 HTTP calls total (1 initial + 2 retries), 1s between attempts
let policy = RetryPolicy::count(2);
assert_eq!(policy.max_attempts(), 2);

Variants

Count

Shorthand for linear retry with attempts retries and a 1 second delay between attempts.

Fields

attempts: u32

Maximum retries after the first request.

should_retry: Option<ShouldRetryFn>

Optional custom retry predicate.

Linear

Fixed delay between retries.

Fields

attempts: u32

Maximum retries after the first request.

delay: Duration

Delay between attempts.

should_retry: Option<ShouldRetryFn>

jitter: bool

When true, randomizes delay (see Self::with_jitter).

Exponential

Exponential backoff capped at max_delay.

Fields

attempts: u32

Maximum retries after the first request.

base_delay: Duration

Initial backoff duration.

max_delay: Duration

Upper bound on backoff.

should_retry: Option<ShouldRetryFn>

jitter: bool

Implementations

impl RetryPolicy

pub fn count(attempts: u32) -> Self

Shorthand: attempts retries with a fixed 1 second delay and default status codes.

Count does not apply jitter. For randomized backoff use Self::exponential (jitter on by default) or Self::linear with Self::with_jitter(true).

pub fn linear(attempts: u32, delay: Duration) -> Self

Linear backoff with a fixed delay between retries.

pub fn exponential( attempts: u32, base_delay: Duration, max_delay: Duration, ) -> Self

Exponential backoff from base_delay up to max_delay (jitter enabled by default).

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

Enables randomized backoff jitter on linear or exponential policies.

No effect on RetryPolicy::Count — use Self::exponential for jittered delays.

pub fn with_should_retry(self, f: ShouldRetryFn) -> Self

Overrides the default retry predicate (408, 429, 502, 503, 504).

pub fn max_attempts(&self) -> u32

Returns the maximum number of retries after the initial request.

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.