Struct ConstantBuilder 

pub struct ConstantBuilder { /* private fields */ }

ConstantBuilder is used to create a [ConstantBackoff], providing a steady delay with a fixed number of retries.

Default

• delay: 1s
• max_times: 3

Examples

use anyhow::Result;
use backon::ConstantBuilder;
use backon::Retryable;

async fn fetch() -> Result<String> {
    Ok(reqwest::get("https://www.rust-lang.org")
        .await?
        .text()
        .await?)
}

#[tokio::main(flavor = "current_thread")]
async fn main() -> Result<()> {
    let content = fetch.retry(ConstantBuilder::default()).await?;
    println!("fetch succeeded: {}", content);

    Ok(())
}

Implementations

impl ConstantBuilder

pub const fn new() -> ConstantBuilder

Create a new ConstantBuilder with default values.

pub const fn with_delay(self, delay: Duration) -> ConstantBuilder

Set the delay for the backoff.

pub const fn with_max_times(self, max_times: usize) -> ConstantBuilder

Set the maximum number of attempts to be made.

pub const fn with_jitter(self) -> ConstantBuilder

Enable jitter for the backoff.

Jitter is a random value added to the delay to prevent a thundering herd problem.

pub fn with_jitter_seed(self, seed: u64) -> ConstantBuilder

Set the seed value for the jitter random number generator. If no seed is given, a random seed is used in std and default seed is used in no_std.

pub const fn without_max_times(self) -> ConstantBuilder

Set no max times for the backoff.

The backoff will not stop by itself.

The backoff could stop reaching usize::MAX attempts but this is unrealistic.

Trait Implementations

impl BackoffBuilder for ConstantBuilder

type Backoff = ConstantBackoff

The associated backoff returned by this builder.

fn build(self) -> <ConstantBuilder as BackoffBuilder>::Backoff

Construct a new backoff using the builder.

impl BackoffBuilder for &ConstantBuilder

type Backoff = ConstantBackoff

The associated backoff returned by this builder.

fn build(self) -> <&ConstantBuilder as BackoffBuilder>::Backoff

Construct a new backoff using the builder.

impl Clone for ConstantBuilder

fn clone(&self) -> ConstantBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ConstantBuilder

impl Debug for ConstantBuilder

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

Formats the value using the given formatter.

impl Default for ConstantBuilder

fn default() -> ConstantBuilder

Returns the “default value” for a type.