6 releases (breaking)
0.5.1 | Aug 23, 2023 |
---|---|
0.5.0 | Sep 1, 2022 |
0.4.0 | Jun 22, 2021 |
0.3.0 | Jan 7, 2021 |
0.1.0 | Nov 23, 2020 |
#160 in Rust patterns
103,771 downloads per month
Used in 39 crates
(8 directly)
38KB
666 lines
💫 tryhard
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
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
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
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.
Dependencies
~2.8–9MB
~78K SLoC