tokio-based leaky-bucket rate limiter

Build Status

This project is a rate limiter based on the [leaky bucket] algorithm.

Usage

This library requires the user to add the following dependencies to use:

toml leaky-bucket = "0.5.0"

Examples

```rust use futures::prelude::*; use leaky_bucket::LeakyBuckets; use std::{error::Error, time::Duration};

[tokio::main]

async fn main() -> Result<(), Box> { let buckets = LeakyBuckets::new();

let rate_limiter = buckets
    .rate_limiter()
    .max(100)
    .refill_interval(Duration::from_secs(10))
    .refill_amount(100)
    .build()?;

let coordinator = buckets.coordinate().boxed();

// spawn the coordinate thread to refill the rate limiter.
tokio::spawn(async move { coordinator.await.expect("coordinate thread errored") });

println!("Waiting for permit...");
// should take about ten seconds to get a permit.
rate_limiter.acquire(100).await?;
println!("I made it!");

Ok(())

} ```