Struct RetryStrategy 

pub struct RetryStrategy { /* private fields */ }

Configurable exponential-backoff policy.

Defaults: 1-second base delay, 30-second maximum delay, 12 attempts. Builders (with_base_delay, with_max_delay, with_max_attempts) return the updated strategy.

Implementations

impl RetryStrategy

pub fn new() -> Self

Creates a strategy with 1-second base delay, 30-second max delay, and 12 attempts.

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

Sets the initial delay before the first retry.

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

Sets the upper bound for the doubling delay.

pub fn with_max_attempts(self, n: usize) -> Self

Sets how many total attempts are made before giving up.

pub async fn with_exponential_backoff<F, T, E>( &self, f: F, ) -> Result<T, RetryExhaustedError>

where F: FnMut() -> BoxFuture<'static, Result<T, E>> + Send, E: Display + Send + Sync + 'static, T: Send,

Runs a boxed-future operation with exponential backoff.

F is the closure producing each attempt’s boxed future, T the success value, and E the per-attempt error (converted to text on exhaustion). Returns the first success, or RetryExhaustedError after max_attempts.

pub async fn retry<F, Fut, T, E>(&self, op: F) -> Result<T, RetryExhaustedError>

where F: FnMut() -> Fut + Send, Fut: Future<Output = Result<T, E>> + Send, E: Display + Send + Sync + 'static,

Runs an operation returning a future with exponential backoff.

F is the closure producing each attempt, Fut its future, T the success value, and E the per-attempt error (converted to text on exhaustion). Returns the first success, or RetryExhaustedError after max_attempts.

Trait Implementations

impl Clone for RetryStrategy

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for RetryStrategy

fn default() -> Self

Returns the “default value” for a type.