Struct RetryConfig 

pub struct RetryConfig {
    pub max_retries: u32,
    pub initial_delay: Duration,
    pub max_delay: Duration,
    pub backoff_multiplier: f64,
    pub jitter: bool,
}

Configuration for automatic retry with exponential backoff.

Applied to retryable errors (RateLimit, Timeout, Http).

Attach it to a client with ClientBuilder::retry_config or to a single request with RequestBuilder::retry_config.

Examples

use std::time::Duration;
use rai_sdk::RetryConfig;

// Default: 3 retries, 1s initial delay, 2x backoff, jitter enabled
let config = RetryConfig::default();

// Custom: 5 retries, 500ms initial delay, no jitter
let custom = RetryConfig::new()
    .with_max_retries(5)
    .with_initial_delay(Duration::from_millis(500))
    .with_jitter(false);

// Disable retries entirely
let none = RetryConfig::none();

Fields

max_retries: u32

Maximum number of retry attempts (0 = no retries).

initial_delay: Duration

Delay before the first retry.

max_delay: Duration

Maximum delay between retries (caps exponential growth).

backoff_multiplier: f64

Multiplier applied to the delay after each attempt.

jitter: bool

Add random jitter to avoid thundering herd.

Implementations

impl RetryConfig

pub fn new() -> Self

Create a default retry configuration (3 retries, 1s initial delay, 2x backoff).

pub fn none() -> Self

Create a configuration that disables retries entirely.

pub fn with_max_retries(self, n: u32) -> Self

Set the maximum number of retry attempts.

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

Set the initial delay before the first retry.

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

Set the maximum delay between retries.

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

Set the backoff multiplier.

pub fn with_jitter(self, jitter: bool) -> Self

Enable or disable jitter.

Trait Implementations

impl Clone for RetryConfig

fn clone(&self) -> RetryConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RetryConfig

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

Formats the value using the given formatter.

impl Default for RetryConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RetryConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RetryConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.