Struct StatusSet 

pub struct StatusSet(/* private fields */);

A set of HTTP status codes, as a fixed bitmap: copying one costs 80 bytes and looking a status up costs a shift, with no allocation either way.

It holds 0 to 639, which covers every status HTTP defines (100 to 599). A status of 640 or more is never contained, and inserting one does nothing and returns false.

In a RetryPolicy the set is asked only about responses reported as ErrorKind::Api, so a success status in it has no effect; see RetryPolicy::http_statuses.

use typesafe_sdk::StatusSet;

let mut statuses = StatusSet::DEFAULT;
assert!(statuses.contains(503));
statuses.remove(503);
statuses.insert(409);
assert_eq!(format!("{statuses:?}"), "{408, 409, 429, 500..=502, 504..=599}");

let only = [429, 503].into_iter().collect::<StatusSet>();
assert_eq!(only.iter().collect::<Vec<_>>(), [429, 503]);

Implementations

impl StatusSet

pub const DEFAULT: Self

The statuses retried by default, as in the Python SDK: 408 (request timeout), 429 (too many requests) and every 5xx, 500 to 599.

pub const fn empty() -> Self

A set with no status in it.

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

Whether status is in the set; always false from 640 up.

pub const fn insert(&mut self, status: u16) -> bool

Adds status, and says whether it was not there before. A status of 640 or more cannot be held: nothing changes and the answer is false.

pub const fn remove(&mut self, status: u16) -> bool

Removes status, and says whether it was there.

pub const fn is_empty(&self) -> bool

Whether the set holds no status.

pub fn iter(&self) -> impl Iterator<Item = u16> + use<>

The statuses in the set, from the lowest up.

Trait Implementations

impl Clone for StatusSet

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 StatusSet

impl Debug for StatusSet

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

{408, 429, 500..=599}: a run of three or more statuses prints as a range.

impl Default for StatusSet

fn default() -> Self

StatusSet::DEFAULT, the statuses retried unless a policy says otherwise.

impl Eq for StatusSet

impl Extend<u16> for StatusSet

fn extend<I: IntoIterator<Item = u16>>(&mut self, statuses: I)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: T)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl FromIterator<u16> for StatusSet

fn from_iter<I: IntoIterator<Item = u16>>(statuses: I) -> Self

Exactly the statuses given; one of 640 or more is left out.

impl Hash for StatusSet

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for StatusSet

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for StatusSet