Struct Budget 

pub struct Budget {
    pub attempts: u32,
    pub first: Duration,
    pub cap: Duration,
    pub unsent_only: bool,
}

How long the wire is given to stop hiccuping.

Fields

attempts: u32

Total attempts, the first one included. 1 = no retry at all.

first: Duration

The wait after the first failure; doubled each time, capped at cap.

cap: Duration

unsent_only: bool

Retry only failures that prove the request NEVER LEFT THIS BOX.

For a GET or a DELETE this is off: they are idempotent, and asking twice costs nothing. For a POST that CREATES something it is on, because a connection reset after the bytes went out is ambiguous — the server may have made the thing and lost the answer — and retrying that is how one order becomes two servers on the invoice. A refused connection and a name that did not resolve are not ambiguous: nothing was sent.

Implementations

impl Budget

pub const fn api() -> Budget

What an API read gets: four attempts over ~7 s of waiting. Long enough for a dropped connection and a re-dial, short enough that a cloud that is genuinely down is named within the minute rather than leaned on.

pub const fn write() -> Budget

What a WRITE gets: the same budget, but only for failures that prove the request never left this box. See unsent_only.

pub const fn once() -> Budget

One attempt: the boundary is still declared, and nothing is retried.

Trait Implementations

impl Clone for Budget

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Budget

impl Debug for Budget

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

Formats the value using the given formatter.