mulligan 0.6.0

A flexible retry library for Rust async operations with configurable backoff strategies and jitter.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

use std::time::Duration;

async fn this_errors(msg: &str) -> std::io::Result<()> {
    println!("{msg}");
    Err(std::io::Error::other("uh oh!"))
}

#[tokio::main()]
async fn main() {
    let hello = tokio::spawn(async {
        mulligan::until_ok()
            .stop_after(5)
            .max_delay(Duration::from_secs(3))
            .full_jitter()
            .exponential(Duration::from_secs(1))
            .execute(async || this_errors("hello").await)
            .await
    });
    let world = tokio::spawn(async {
        mulligan::until(|r| r.is_ok())
            .stop_after(10)
            .jitter(mulligan::jitter::Full)
            .fixed(Duration::from_secs(1))
            .execute(async || this_errors("world").await)
            .await
    });

    let retry = tokio::spawn(async {
        mulligan::until_ok()
            .stop_after(10)
            .full_jitter()
            .fixed(Duration::from_millis(200))
            .after_attempt(|res, attempt| println!("Attempt = {attempt}, result = {res:?}"))
            .execute(async || this_errors("Oh uh!!!").await)
            .await
    });

    let _ = hello.await;
    let _ = world.await;
    let _ = retry.await;

    let _ = tokio::spawn(async {
        mulligan::until_ok()
            .stop_after(3)
            .full_jitter()
            .fixed(Duration::from_millis(200))
            .after_attempt(|res, attempt| println!("Attempt = {attempt}, result = {res:?}"))
            .execute(async || this_errors("Uh oh!!!").await)
            .await
    })
    .await;
}