Struct RetryConfig 

pub struct RetryConfig {
    pub max_retries: u32,
    pub initial_backoff_ms: u64,
    pub retry_server_errors: bool,
    pub retry_predicate: RetryPredicate,
}

Configuration for retry behavior

Controls which errors should be retried and how retries are executed.

Examples

use odos_sdk::{RetryConfig, RetryPredicate};

// No retries - all errors return immediately
let config = RetryConfig::no_retries();

// Conservative retries - only network errors
let config = RetryConfig::conservative();

// Default retries - network errors and server errors
let config = RetryConfig::default();

// Replace the default policy with custom logic
let config = RetryConfig {
    max_retries: 2,
    retry_server_errors: false,
    retry_predicate: RetryPredicate::Replace(|err| {
        // Custom logic to determine if error should be retried
        err.is_retryable()
    }),
    ..Default::default()
};

// Keep the default policy but veto a specific error shape
let config = RetryConfig {
    retry_predicate: RetryPredicate::DefaultExcept(|err| err.is_rate_limit()),
    ..Default::default()
};

Fields

max_retries: u32

Maximum retry attempts for retryable errors

initial_backoff_ms: u64

Initial backoff duration in milliseconds

retry_server_errors: bool

Whether to retry server errors (5xx)

retry_predicate: RetryPredicate

How a caller-supplied predicate composes with the default decision tree. See RetryPredicate for the semantics of each variant.

Implementations

impl RetryConfig

pub fn no_retries() -> Self

No retries - return errors immediately

Use this when you want to handle all errors at the application level, or when implementing your own retry logic.

pub fn conservative() -> Self

Conservative retries - only network errors

This configuration retries only transient network failures (timeouts, connection errors) but not server errors (5xx). Use this when you want to be cautious about retry behavior.

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.