Enum Backoff 

pub enum Backoff {
    Fixed(Duration),
    Exponential {
        base: Duration,
        max: Duration,
    },
    None,
}

How long to wait between attempts.

Variants

Fixed(Duration)

The same wait every time.

Exponential

Doubling: 100ms, 200ms, 400ms, …

The default, and the right one for a dependency that is briefly unavailable — retrying at full speed is what turns a blip into an outage, because every caller does it at once.

Fields

base: Duration

The wait before the second attempt.

max: Duration

The longest it will ever wait.

None

No wait at all.

For a test, and for the rare case where the failure is known to be instantaneous and independent.

Implementations

impl Backoff

pub fn exponential() -> Backoff

Doubling from 100ms, capped at ten seconds.

pub fn fixed(wait: Duration) -> Backoff

The same wait every time.

pub fn wait_before(&self, attempt: u32) -> Duration

How long to wait before attempt attempt, counting the first as 1.

Zero before the first, because nothing has failed yet.

Trait Implementations

impl Clone for Backoff

fn clone(&self) -> Backoff

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Backoff

impl Debug for Backoff

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

Formats the value using the given formatter.

impl Default for Backoff

fn default() -> Backoff

Returns the “default value” for a type.

impl Eq for Backoff

impl PartialEq for Backoff

fn eq(&self, other: &Backoff) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Backoff