Struct RetryConfig 

pub struct RetryConfig {
    pub max_retry_count: Option<u32>,
    pub retry_delay_secs: Option<u64>,
}

Configuration for HTTP request retry behavior.

Retry is always finite: when a field is unset the finite defaults DEFAULT_MAX_RETRIES and DEFAULT_RETRY_DELAY_SECS apply. Unbounded retry was removed in PR #26 and must not be reintroduced.

Fields

max_retry_count: Option<u32>

Maximum number of retries on transient failures.

None means “use DEFAULT_MAX_RETRIES” — it is never interpreted as infinite retries.

retry_delay_secs: Option<u64>

Base delay in seconds between retries.

None means “use DEFAULT_RETRY_DELAY_SECS”. This value is the base for exponential backoff, not a fixed per-attempt delay.

Implementations

impl RetryConfig

pub fn new() -> Self

Creates a new retry configuration with the finite defaults.

Equivalent to RetryConfig::default: reads MAX_RETRY_COUNT / RETRY_DELAY_SECS from the environment when set, otherwise uses DEFAULT_MAX_RETRIES and DEFAULT_RETRY_DELAY_SECS.

pub fn infinite() -> Self

👎Deprecated:

unbounded retry is banned; use a finite RetryConfig

Deprecated: unbounded retry is banned (PR #26).

Previously this returned a config with infinite retries. It now clamps to DEPRECATED_INFINITE_RETRY_CAP — a large but finite cap — so callers keep compiling while never looping forever. Use RetryConfig::default or RetryConfig::with_max_retries instead.

Uses RETRY_DELAY_SECS when set, otherwise DEFAULT_RETRY_DELAY_SECS.

pub fn with_max_retries(max_retries: u32) -> Self

Creates a new retry configuration with a maximum number of retries.

Uses RETRY_DELAY_SECS when set, otherwise DEFAULT_RETRY_DELAY_SECS.

pub fn with_delay(delay_secs: u64) -> Self

👎Deprecated:

unbounded retry is banned; use a finite RetryConfig

Deprecated: this constructor left the retry count unbounded.

It now clamps the retry count to DEPRECATED_INFINITE_RETRY_CAP — a large but finite cap — while still applying the custom base delay. Use RetryConfig::with_max_retries_and_delay for an explicit finite cap.

pub fn with_max_retries_and_delay(max_retries: u32, delay_secs: u64) -> Self

Creates a new retry configuration with both max retries and custom delay.

pub fn max_retries(&self) -> u32

Gets the maximum retry count.

Always finite: returns DEFAULT_MAX_RETRIES when unconfigured. A value of 0 means “try once, never retry”; it is never treated as infinite.

pub fn delay_secs(&self) -> u64

Gets the base retry delay in seconds.

Returns DEFAULT_RETRY_DELAY_SECS when unconfigured.

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

Computes the backoff delay before the given 0-based retry attempt.

Exponential: base * 2^attempt seconds, where base is RetryConfig::delay_secs, saturating at MAX_RETRY_DELAY_SECS. The cap is the policy, so rounding down to it is intentional. A jitter of [0, 25%] of the delay is added to avoid thundering-herd retries; the jitter entropy comes from the current wall-clock subsecond nanoseconds (this is jitter, not cryptographic randomness).

Trait Implementations

impl Clone for RetryConfig

fn clone(&self) -> RetryConfig

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.

impl<'de> Deserialize<'de> for RetryConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for RetryConfig

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

Formats the value using the given formatter.

impl Serialize for RetryConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.