Struct RetryPolicy 

pub struct RetryPolicy {
    pub attempts: u32,
    pub base: Duration,
    pub factor: u32,
    pub cap: Duration,
    pub max_window: Duration,
    pub connect_timeout: Option<Duration>,
}

Caller-tunable retry knobs (PRD §5.8.7 FR-80, FR-81).

Use Default for the values PRD §5.8.7 specifies (attempts = 3, base = 250 ms, factor = 2, cap = 8 s, max_window = 30 s, connect_timeout = None). The builder-style setters return Self so a CLI dispatcher can chain overrides.

Fields

attempts: u32

Total number of attempts (initial + retries). Must be ≥ 1. 1 disables retry entirely; default 3.

base: Duration

Base delay before the first retry. Default 250 ms.

factor: u32

Multiplier on each successive retry. Default 2.

cap: Duration

Cap on a single backoff interval (excluding jitter). Default 8 s.

max_window: Duration

Hard ceiling on total elapsed wall-clock time across all attempts. Default 30 s. When the cap is reached the loop returns the most-recent error rather than starting another attempt.

connect_timeout: Option<Duration>

Per-attempt TCP connect timeout. None = no timeout (matches OpenSSH’s “no ConnectTimeout” semantics). Default None.

Implementations

impl RetryPolicy

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

Builder setter for Self::attempts.

pub fn base(self, d: Duration) -> Self

Builder setter for Self::base.

pub fn factor(self, f: u32) -> Self

Builder setter for Self::factor.

pub fn cap(self, d: Duration) -> Self

Builder setter for Self::cap.

pub fn max_window(self, d: Duration) -> Self

Builder setter for Self::max_window.

pub fn connect_timeout(self, d: Option<Duration>) -> Self

Builder setter for Self::connect_timeout.

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

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

Formats the value using the given formatter.

impl Default for RetryPolicy

fn default() -> Self

Returns the “default value” for a type.

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

impl StructuralPartialEq for RetryPolicy