Home

Awesome

💫 tryhard

Embark Embark Crates.io Docs dependency status Build status

tryhard makes it easy to retry futures that might fail. You can control the number of retries, the backoff strategy, and the max duration.

Examples

First imagine you have some async function that can fail:

async fn read_file(path: &str) -> Result<String, std::io::Error> {
    // ...
}

Calling that function and retrying at most 10 times with no delay between attempts can be done like so:

tryhard::retry_fn(|| read_file("Cargo.toml"))
    .retries(10)
    .await?;

You can also retry with a fixed delay between attempts:

tryhard::retry_fn(|| read_file("Cargo.toml"))
    .retries(10)
    .fixed_backoff(Duration::from_millis(100))
    .await?;

Or exponential backoff, where the delay doubles each time, with a max delay of 1 second:

tryhard::retry_fn(|| read_file("Cargo.toml"))
    .retries(10)
    .exponential_backoff(Duration::from_millis(10))
    .max_delay(Duration::from_secs(1))
    .await?;

See the docs for more details.

Contributing

Contributor Covenant

We welcome community contributions to this project.

Please read our Contributor Guide for more information on how to get started.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.