Adding `exponential_backoff` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add exponential-backoff

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

exponential-backoff = "2.1.0"

The exponential_backoff library will be automatically available globally. Read the exponential_backoff library documentation.

Back to the crate overview.

Readme

exponential-backoff

An exponential backoff generator with jitter. Serves as a building block to implement custom retry functions.

Why?

When an network requests times out, often the best way to solve it is to try again. But trying again straight away might at best cause some network overhead, and at worst a full fledged DDOS. So we have to be responsible about it.

A good explanation of retry strategies can be found on the Stripe blog.

Usage

Here we try and read a file from disk, and try again if it fails. A more realistic scenario would probably to perform an HTTP request, but the approach should be similar.

use exponential_backoff::Backoff;
use std::{fs, thread, time::Duration};

let attempts = 3;
let min = Duration::from_millis(100);
let max = Duration::from_secs(10);

for duration in Backoff::new(attempts, min, max) {
    match fs::read_to_string("README.md") {
        Ok(string) => return Ok(string),
        Err(err) => match duration {
            Some(duration) => thread::sleep(duration),
            None => return Err(err),
        }
    }
}

Installation

$ cargo add exponential-backoff

License

MIT OR Apache-2.0

Adding exponential_backoff library as a dependency

Adding `exponential_backoff` library as a dependency