Struct RetryConfig 

#[non_exhaustive]
pub struct RetryConfig {
    pub max_attempts: u32,
    pub initial_backoff: Duration,
    pub max_backoff: Duration,
    pub attempt_timeout: Option<Duration>,
}

Retry policy for unary calls.

Start from RetryConfig::default and adjust with the fluent setters; #[non_exhaustive] so fields can be added without a breaking change.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

max_attempts: u32

Maximum number of attempts (including the first). 1 disables retrying.

initial_backoff: Duration

Backoff before the first retry.

max_backoff: Duration

Upper bound the backoff doubles towards.

attempt_timeout: Option<Duration>

Optional per-attempt timeout. When set, an attempt that exceeds it is cancelled and treated as a retriable timeout (bounding a hung call independently of the channel-level timeout).

Implementations

impl RetryConfig

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

Set the maximum number of attempts (including the first).

pub fn with_initial_backoff(self, initial_backoff: Duration) -> RetryConfig

Set the initial backoff before the first retry.

pub fn with_max_backoff(self, max_backoff: Duration) -> RetryConfig

Set the ceiling the backoff doubles towards.

pub fn with_attempt_timeout(self, attempt_timeout: Duration) -> RetryConfig

Set a per-attempt timeout: an attempt exceeding it is cancelled and retried (as a timeout) rather than blocking on the channel-level timeout.

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

Formats the value using the given formatter.

impl Default for RetryConfig

fn default() -> RetryConfig

Returns the “default value” for a type.