Struct RetryPolicy 

pub struct RetryPolicy {
    pub max_attempts: u32,
    pub initial_delay: Duration,
    pub max_delay: Duration,
    pub multiplier: f64,
}

Configuration for exponential backoff retry behavior.

Controls how many times to retry a failed operation and how long to wait between attempts. Uses exponential backoff with a configurable multiplier and maximum delay cap.

Defaults

• max_attempts: 3
• initial_delay: 5 seconds
• max_delay: 60 seconds
• multiplier: 2.0

Example

use ddns_a::webhook::RetryPolicy;
use std::time::Duration;

// Create with defaults
let policy = RetryPolicy::default();

// Or customize via builder
let custom = RetryPolicy::new()
    .with_max_attempts(5)
    .with_initial_delay(Duration::from_secs(1))
    .with_max_delay(Duration::from_secs(30))
    .with_multiplier(1.5);

Fields

max_attempts: u32

Maximum number of attempts (including the initial attempt).

A value of 1 means no retries; only the initial attempt is made.

initial_delay: Duration

Delay before the first retry.

Subsequent delays are computed by multiplying by multiplier.

max_delay: Duration

Maximum delay between retries.

The computed delay is capped at this value to prevent excessively long waits.

multiplier: f64

Multiplier applied to the delay after each retry.

A value of 2.0 doubles the delay each time.

Implementations

impl RetryPolicy

pub const DEFAULT_MAX_ATTEMPTS: u32 = 3

Default maximum attempts.

pub const DEFAULT_INITIAL_DELAY: Duration

Default initial delay (5 seconds).

pub const DEFAULT_MAX_DELAY: Duration

Default maximum delay (60 seconds).

pub const DEFAULT_MULTIPLIER: f64 = 2.0

Default multiplier (2.0).

pub const MIN_MAX_ATTEMPTS: u32 = 1

Minimum value for max_attempts.

pub const fn new() -> Self

Creates a new retry policy with default values.

pub const fn with_max_attempts(self, max_attempts: u32) -> Self

Sets the maximum number of attempts.

Panics

Panics if max_attempts is less than 1.

pub const fn with_initial_delay(self, delay: Duration) -> Self

Sets the initial delay between retries.

Zero delay is supported (useful for testing with InstantSleeper) but not recommended for production as it creates a tight retry loop.

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

Sets the maximum delay between retries.

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

Sets the delay multiplier.

Panics

Panics if multiplier is not positive (must be > 0.0).

pub fn delay_for_retry(&self, retry: u32) -> Duration

Computes the delay for a given retry number (0-indexed).

Arguments

• retry - The retry number (0 = delay before first retry, 1 = delay before second retry, etc.)

Returns

The delay to wait before this retry, capped at max_delay.

pub const fn should_retry(&self, attempt: u32) -> bool

Returns true if the given attempt number should be retried.

Arguments

• attempt - The attempt number (1 = first attempt, 2 = first retry, etc.)

Returns

true if the attempt is within the allowed number of attempts.

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.

impl Default for RetryPolicy

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for RetryPolicy

fn eq(&self, other: &RetryPolicy) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RetryPolicy