Struct NetworkRetryPolicy 

pub struct NetworkRetryPolicy {
    pub enabled: bool,
    pub max_attempts: u32,
    pub initial_delay: Duration,
    pub multiplier: f64,
    pub max_delay: Duration,
    pub jitter_factor: f64,
    pub max_attempts_absolute: Option<u32>,
}

Reconnection and backoff policy for networked components.

Used in component config structs as a reconnect field:

[default.components.redis.reconnect]
max_attempts = 10
initial_delay_ms = 100
max_delay_ms = 30000

Fields

enabled: bool

Whether reconnection is enabled at all.

max_attempts: u32

Maximum number of attempts before giving up. 0 means unlimited.

initial_delay: Duration

Base delay for the first retry.

multiplier: f64

Exponential backoff multiplier applied to each successive attempt.

max_delay: Duration

Maximum delay cap regardless of computed backoff.

jitter_factor: f64

Jitter factor in [0.0, 1.0]. Actual delay is base ± (base * jitter_factor / 2).

max_attempts_absolute: Option<u32>

Hard cap on total retry attempts regardless of max_attempts.

When Some(n), the policy stops retrying after n total attempts (including the initial call) even if max_attempts is 0 (unlimited). None (the default) preserves the max_attempts semantics unchanged.

Implementations

impl NetworkRetryPolicy

pub fn disabled() -> Self

Returns a disabled policy — no retries will be attempted.

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

Computes the sleep duration for a given zero-based attempt number.

Formula: clamp(initial * multiplier^attempt, 0, max_delay) with random jitter.

pub fn should_retry(&self, attempt: u32) -> bool

Returns true if another retry should be attempted.

attempt is zero-based: 0 = first attempt, 1 = first retry, etc.

When max_attempts_absolute is Some(n), the policy stops after n total attempts regardless of max_attempts. When None (the default), only max_attempts governs the limit (where 0 means unlimited).

Trait Implementations

impl Clone for NetworkRetryPolicy

fn clone(&self) -> NetworkRetryPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NetworkRetryPolicy

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

Formats the value using the given formatter.

impl Default for NetworkRetryPolicy

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for NetworkRetryPolicy

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for NetworkRetryPolicy

fn eq(&self, other: &NetworkRetryPolicy) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for NetworkRetryPolicy

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for NetworkRetryPolicy