3 releases

0.1.2 May 31, 2020
0.1.1 May 30, 2020
0.1.0 May 12, 2020

#173 in WebAssembly

Download history 16186/week @ 2024-08-01 14386/week @ 2024-08-08 16228/week @ 2024-08-15 15931/week @ 2024-08-22 17354/week @ 2024-08-29 18222/week @ 2024-09-05 15071/week @ 2024-09-12 16730/week @ 2024-09-19 19305/week @ 2024-09-26 18960/week @ 2024-10-03 17365/week @ 2024-10-10 21123/week @ 2024-10-17 18523/week @ 2024-10-24 18211/week @ 2024-10-31 17202/week @ 2024-11-07 18100/week @ 2024-11-14

75,969 downloads per month
Used in 17 crates (7 directly)

MIT license

19KB
329 lines

again ♻️

wasm-compatible retry interfaces for fallible Rustlang std library Futures


A goal of any operation should be a successful outcome. This crate gives operations a better chance at achieving that.

📦 install

In your Cargo.toml file, add the following under the [dependencies] heading

again = "0.1"

🤸usage

For very simple cases you can use the module level retry function to retry a potentially fallible operation.

use std::error::Error;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    pretty_env_logger::init();
    again::retry(|| reqwest::get("https://api.you.com")).await?;
    Ok(())
}

You may not want to retry every kind of error. For preciseness you can be more explicit in which kinds of errors should be retried with the module level retry_if function.

use std::error::Error;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    pretty_env_logger::init();
    again::retry_if(
      || reqwest::get("https://api.you.com")
      reqwest::Error::is_status
    ).await?;
    Ok(())
}

You can also customize retry behavior to suit your applications needs with a configurable and reusable RetryPolicy.

use std::error::Error;
use std::time::Duration;
use again::RetryPolicy;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    pretty_env_logger::init();
    let policy = RetryPolicy::exponential(Duration::from_millis(200))
      .with_max_retries(10)
      .with_jitter(true);
    policy.retry(|| reqwest::get("https://api.you.com")).await?;
    Ok(())
}

See the docs for more examples.

Doug Tangren (softprops) 2020

Dependencies

~2.6–5.5MB
~99K SLoC