Struct Config 

pub struct Config<D> {
    pub attempts: usize,
    pub delay: D,
    pub on_retry: Option<Box<dyn FnMut(usize, Duration) + 'static>>,
}

Configuration for the retry function.

Example

use std::time::Duration;
use retry::Config;
use retry::delay::Fixed;

let config: Config<_> = Config::new(Fixed::new(Duration::from_secs(1)))
    .with_attempts(5)
    .with_on_retry(|attempt, delay| {
        eprintln!("Attempt {attempt} failed, retrying in {delay:?}");
    });

Fields

attempts: usize

Number of attempts. 0 means retry forever (until success). Includes the initial call. E.g. attempts: 5 = 1 initial + 4 retries.

delay: D

The delay strategy used between retries.

on_retry: Option<Box<dyn FnMut(usize, Duration) + 'static>>

Optional callback invoked before each retry. Receives the attempt number (1-based) and the delay duration.

Implementations

impl<D> Config<D>

pub const fn new(delay: D) -> Self

Creates a new config with infinite retries and the given delay strategy.

pub const fn with_attempts(self, attempts: usize) -> Self

Sets the maximum number of attempts.

0 means infinite retries. An attempt count of 5 means 1 initial call + up to 4 retries.

pub fn with_on_retry(self, f: impl FnMut(usize, Duration) + 'static) -> Self

Sets a callback that is invoked before each retry.

The callback receives the attempt number (1-based) and the delay that will be waited before retrying.