Struct RetryPolicy 

pub struct RetryPolicy { /* private fields */ }

Retry policy with exponential backoff for transient failures.

Created via RetryPolicy::new with the maximum number of retries. All other parameters have sensible defaults and can be customised with builder methods.

Defaults

Parameter	Default
max_retries	(required)
initial_backoff	200ms
max_backoff	30s
multiplier	2.0

Examples

use std::time::Duration;
use ironflow_core::retry::RetryPolicy;

let policy = RetryPolicy::new(3)
    .backoff(Duration::from_millis(100))
    .max_backoff(Duration::from_secs(10))
    .multiplier(3.0);

Implementations

impl RetryPolicy

pub fn new(max_retries: u32) -> Self

Create a new retry policy with the given maximum number of retries.

The initial attempt is not counted as a retry, so max_retries(3) means up to 4 total attempts (1 initial + 3 retries).

Panics

Panics if max_retries is 0.

Examples

use ironflow_core::retry::RetryPolicy;

let policy = RetryPolicy::new(3);
assert_eq!(policy.max_retries(), 3);

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

Set the initial backoff duration before the first retry.

Subsequent retries multiply this duration by the multiplier.

Panics

Panics if duration is zero.

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

Set the maximum backoff duration between retries.

Even after many retries with exponential growth, the delay will never exceed this value.

Panics

Panics if duration is zero.

pub fn multiplier(self, multiplier: f64) -> Self

Set the backoff multiplier applied after each retry.

For example, with multiplier(2.0) and backoff(200ms):

• Retry 1: 200ms
• Retry 2: 400ms
• Retry 3: 800ms

Panics

Panics if multiplier is less than 1.0, NaN, or infinity.

pub fn max_retries(&self) -> u32

Return the maximum number of retries.

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.