Enum Retries 

pub enum Retries {
    UntilHalted,
    AtMost(u32),
}

The ceiling a person set on retrying one endpoint.

Exhaustive rather than a count with a sentinel: “keep trying until somebody stops this” and “try four times” are different intentions, and a number cannot spell the first one.

Variants

UntilHalted

No ceiling. What stops the run is Halt, the city’s one brake. This is what a person who settled nothing asked for.

AtMost(u32)

Give up once this many retries have been spent. Zero is a real answer and means “once, then report”.

Implementations

impl Retries

pub const fn without_a_brake(self) -> u32

How many retries a request gets where nothing can halt it.

A person watching a settings page is waiting on one request and holds no brake, so UntilHalted cannot be honoured literally there: a probe that retried forever would hang the page it was drawn for. It is honoured as one retry, which is what a dropped connection costs and what the probe already documented as its intent — written here so the reading is the setting’s own and not a second default at the call site.

pub const fn stated(self) -> Option<u32>

The figure a record carries, or nothing when no ceiling was set.

Absence on the wire and absence in the ledger are the same fact, so both are written by this one reading.

pub const fn of(stated: Option<u32>) -> Retries

What a stated figure, or the absence of one, means.

Trait Implementations

impl Clone for Retries

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 Retries

impl Debug for Retries

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

Formats the value using the given formatter.

impl Default for Retries

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Retries

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Retries

impl PartialEq for Retries

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Retries

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Retries