Struct RetryPolicy 

#[non_exhaustive]
pub struct RetryPolicy {
    pub attempts: u32,
    pub base_backoff: Duration,
    pub max_backoff: Duration,
    pub jitter: bool,
}

A bounded retry strategy: how many attempts, the (exponential) backoff between them, and whether to add full jitter. Used by ManagedClient to retry is_lock_contention failures. The Default is none (no retry) — retry is opt-in.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

attempts: u32

Total attempts including the first; 1 means no retry.

base_backoff: Duration

Delay before the first retry; doubles each subsequent retry (capped by max_backoff). ZERO means retry immediately.

max_backoff: Duration

Upper bound on the (pre-jitter) backoff delay. ZERO means uncapped.

jitter: bool

Apply full jitter — the actual delay is uniform in [0, computed] — to avoid a thundering herd when many workers retry against one repository.

Implementations

impl RetryPolicy

pub const fn none() -> Self

No retry: a single attempt. The default.

pub const fn lock_contention() -> Self

A sensible default for repository lock contention: a handful of attempts with short, jittered, exponential backoff (25 ms → 500 ms).

pub fn attempts(self, attempts: u32) -> Self

Set the total number of attempts (clamped to at least 1).

pub fn base_backoff(self, backoff: Duration) -> Self

Set the base backoff (the delay before the first retry).

pub fn max_backoff(self, max: Duration) -> Self

Cap the (pre-jitter) backoff delay; ZERO leaves it uncapped.

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

Toggle full jitter on the backoff delay.

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 Copy for RetryPolicy

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

No retry — retry is opt-in.

impl Eq for RetryPolicy

impl PartialEq for RetryPolicy

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RetryPolicy