Struct RetryPolicy 

pub struct RetryPolicy {
    pub max_retries: u32,
    pub backoff_initial: Duration,
    pub backoff_max: Duration,
    pub backoff_jitter: f64,
    pub http_statuses: BTreeSet<u16>,
    pub respect_retry_after: bool,
    pub max_retry_after: Duration,
    pub retry_connection_errors: bool,
    pub retry_timeouts: bool,
    pub total_budget: Option<Duration>,
}

Configuration for retry behavior.

All fields are public. The Default value matches the SPEC and both official SDKs.

use std::time::Duration;
use typesafe_system_one::{Client, RetryPolicy};

let client = Client::builder()
    .api_key("key")
    .retry_policy(RetryPolicy {
        max_retries: 3,
        total_budget: Some(Duration::from_secs(10)),
        ..Default::default()
    })
    .build()
    .unwrap();

Fields

max_retries: u32

Maximum retries after the initial attempt; 0 disables retries.

backoff_initial: Duration

First backoff delay, doubled each retry up to Self::backoff_max; zero disables backoff.

backoff_max: Duration

Maximum backoff delay; zero disables backoff.

backoff_jitter: f64

Fraction of each backoff delay randomly subtracted; between 0 and 1.

http_statuses: BTreeSet<u16>

HTTP status codes that are retried.

respect_retry_after: bool

Whether to honor retry-after-ms and Retry-After headers.

max_retry_after: Duration

Maximum honored server retry delay; a longer delay falls back to backoff.

retry_connection_errors: bool

Whether to retry connection errors (no HTTP response at all).

retry_timeouts: bool

Whether to retry attempts that exceeded the per-attempt timeout.

total_budget: Option<Duration>

Retry budget per call, measured from the first attempt; None or Some(Duration::ZERO) disables it.

A retry is not started when the elapsed time plus its delay would reach or exceed the budget; the call then returns the last real error rather than an artificial timeout, so the caller sees the actual 529. An attempt that has started runs to its own per-attempt timeout, so a call can overrun the budget by up to one timeout (the same semantics as the official Python SDK). For a hard bound, wrap the call in tokio::time::timeout.

Implementations

impl RetryPolicy

pub fn none() -> Self

A policy that never retries (max_retries = 0).

pub fn is_retryable_status(&self, status: u16) -> bool

Whether an HTTP status is retried under this policy.

pub fn backoff_delay(&self, retry_number: u32, random: f64) -> Duration

The pure backoff portion of the delay for retry retry_number (0-based), given a jitter random value in [0, 1).

Trait Implementations

impl Clone for RetryPolicy

fn clone(&self) -> Self

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: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RetryPolicy