Struct RetryPolicy 

pub struct RetryPolicy {
    pub max_attempts: u32,
    pub initial_backoff: Duration,
    pub max_backoff: Duration,
}

Configuration for transparent retry of REST requests.

Construct via the derived RetryPolicy::builder for full control, use RetryPolicy::conservative / RetryPolicy::aggressive for typical presets, or keep RetryPolicy::new for the legacy positional form. Pass to RestClient::with_retry to enable.

Fields

max_attempts: u32

Maximum number of attempts (including the first). A value of 1 disables retry behaviour.

initial_backoff: Duration

Base delay before the second attempt. Subsequent attempts double the delay until max_backoff is hit.

max_backoff: Duration

Hard cap on the inter-attempt delay (jitter notwithstanding).

Implementations

impl RetryPolicy

pub fn builder() -> RetryPolicyBuilder

Create an instance of RetryPolicy using the builder syntax

impl RetryPolicy

pub fn new( max_attempts: u32, initial_backoff: Duration, max_backoff: Duration, ) -> RetryPolicy

Build a custom policy via positional arguments.

Equivalent to the derived RetryPolicy::builder().max_attempts(..).initial_backoff(..).max_backoff(..).build().

pub fn conservative() -> RetryPolicy

Conservative preset: 3 attempts, 100 ms initial backoff, 2 s ceiling. Safe default for monitoring or critical-path REST calls.

Stability

Stable public API. The name and tuning values may evolve in a major release (1.0+), but they will be preserved across all 0.x releases. FFI binding test harnesses depend on them.

pub fn aggressive() -> RetryPolicy

Aggressive preset: 5 attempts, 250 ms initial backoff, 10 s ceiling. Use when the upstream is known to be flaky and the caller can tolerate longer total latency.

Stability

Stable public API. Same guarantees as RetryPolicy::conservative — preserved across 0.x.

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<(), Error>

Formats the value using the given formatter.

impl Copy for RetryPolicy