Struct ExponentialBackoff 

pub struct ExponentialBackoff { /* private fields */ }

Exponential backoff calculator for retry logic.

Examples

use chie_shared::ExponentialBackoff;

let mut backoff = ExponentialBackoff::new();

// Simulate retry attempts
let delay1 = backoff.next_delay_ms();
assert!(delay1 >= 75 && delay1 <= 125); // ~100ms ± 25% jitter

let delay2 = backoff.next_delay_ms();
assert!(delay2 >= 150 && delay2 <= 250); // ~200ms ± 25% jitter

assert_eq!(backoff.attempt_count(), 2);
assert!(!backoff.is_exhausted());

// Custom backoff for more aggressive retries
let mut fast_backoff = ExponentialBackoff::custom(50, 5_000, 1.5, 5);
let first_delay = fast_backoff.next_delay_ms();
assert!(first_delay >= 37 && first_delay <= 63); // ~50ms ± 25%

Implementations

impl ExponentialBackoff

pub fn new() -> Self

Create a new exponential backoff with default settings. Base: 100ms, Max: 30s, Multiplier: 2.0, Max attempts: 10

pub fn custom( base_ms: u64, max_ms: u64, multiplier: f64, max_attempts: u32, ) -> Self

Create a custom exponential backoff.

pub fn next_delay_ms(&mut self) -> u64

Get the next delay in milliseconds with jitter.

pub fn reset(&mut self)

Reset the attempt counter.

pub fn is_exhausted(&self) -> bool

Check if max attempts have been reached.

pub fn attempt_count(&self) -> u32

Get current attempt number.

Trait Implementations

impl Clone for ExponentialBackoff

fn clone(&self) -> ExponentialBackoff

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExponentialBackoff

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

Formats the value using the given formatter.

impl Default for ExponentialBackoff

fn default() -> Self

Returns the “default value” for a type.