Struct RetryPolicy 

pub struct RetryPolicy {
    pub max_attempts: i32,
    pub backoff_strategy: BackoffStrategy,
    pub initial_delay: Duration,
    pub max_delay: Duration,
    pub jitter: bool,
    pub retry_conditions: Vec<RetryCondition>,
}

Comprehensive retry policy configuration for tasks.

This struct defines how a task should behave when it fails, including the number of retry attempts, backoff strategy, delays, and conditions under which retries should be attempted.

Fields

max_attempts: i32

Maximum number of retry attempts (not including the initial attempt)

backoff_strategy: BackoffStrategy

The backoff strategy to use for calculating delays between retries

initial_delay: Duration

Initial delay before the first retry attempt

max_delay: Duration

Maximum delay between retry attempts (caps exponential growth)

jitter: bool

Whether to add random jitter to delays to prevent thundering herd

retry_conditions: Vec<RetryCondition>

Conditions that determine whether a retry should be attempted

Implementations

impl RetryPolicy

pub fn builder() -> RetryPolicyBuilder

Creates a new RetryPolicyBuilder for fluent configuration.

pub fn calculate_delay(&self, attempt: i32) -> Duration

Calculates the delay before the next retry attempt.

Arguments

• attempt - The current attempt number (1-based)

Returns

The duration to wait before the next retry attempt.

pub fn should_retry(&self, error: &TaskError, attempt: i32) -> bool

Determines whether a retry should be attempted based on the error and retry conditions.

Arguments

• error - The error that caused the task to fail
• attempt - The current attempt number

Returns

true if the task should be retried, false otherwise.

pub fn calculate_retry_at( &self, attempt: i32, now: NaiveDateTime, ) -> NaiveDateTime

Calculates the absolute timestamp when the next retry should occur.

Arguments

• attempt - The current attempt number
• now - The current timestamp

Returns

A NaiveDateTime representing when the retry should be attempted.

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<(), Error>

Formats the value using the given formatter.

impl Default for RetryPolicy

fn default() -> RetryPolicy

Creates a default retry policy with reasonable production settings.

Default configuration:

• 3 retry attempts
• Exponential backoff (base 2.0, multiplier 1.0)
• 1 second initial delay
• 60 seconds maximum delay
• Jitter enabled
• Retry on all errors

impl<'de> Deserialize<'de> for RetryPolicy

fn deserialize<__D>( __deserializer: __D, ) -> Result<RetryPolicy, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

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 Serialize for RetryPolicy

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RetryPolicy