GitHunt
FL

flowerinthenight/backoff-rs

Jittered backoff implementation in Rust.

main
crates.io
docs-rs

Overview

This crate implements jittered backoff. Useful when retrying operations that can potentially fail (i.e. network calls). The implementation is based on this article from the AWS Architecture Blog.

Usage

You can use it like so:

use exp_backoff::*;
use std::error::Error;
use std::{thread, time::Duration};

fn func_that_can_fail() -> Result<(), Box<dyn Error>> {
    if true {
        return Err("some error")?;
    }

    Ok(())
}

fn main() -> Result<(), Box<dyn Error>> {
    let mut bo = BackoffBuilder::new().build();
    for _ in 0..5 {
        match func_that_can_fail() {
            Err(e) => {
                println!("failed: {:?}, retry...", e);
                thread::sleep(Duration::from_nanos(bo.pause()));
            }
            _ => println!("we're okay"),
        }
    }

    Ok(())
}

Languages

Rust100.0%

Contributors

MIT License
Created March 13, 2025
Updated September 9, 2025
flowerinthenight/backoff-rs | GitHunt