rate-net 1.0.0

A powerful, lock-free rate limiter for Rust: multiple algorithms behind one trait, sharded per-key state, bounded-memory eviction, retry-after, and a one-line Tier-1 API. Built against hostile traffic.
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

//! Comparing the algorithms on the same quota and traffic.
//!
//! Requires the `algorithms` feature:
//!
//! ```text
//! cargo run --example algorithms --features algorithms
//! ```

use rate_net::{Algorithm, RateLimiter};
use std::time::Duration;

fn main() {
    let algorithms = [
        Algorithm::TokenBucket,
        Algorithm::LeakyBucket,
        Algorithm::FixedWindow,
        Algorithm::SlidingWindowLog,
        Algorithm::SlidingWindowCounter,
    ];

    // Five per second; fire ten requests at the same instant and see how many
    // each algorithm admits in the opening burst.
    for algorithm in algorithms {
        let limiter = RateLimiter::builder()
            .algorithm(algorithm)
            .quota(5, Duration::from_secs(1))
            .build();

        let admitted = (0..10).filter(|_| limiter.check("k").is_allow()).count();
        println!("{algorithm:?}: admitted {admitted}/10 at t=0 (limit 5/s)");
    }
}