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

//! Tier-1: limit a key to N requests per second.
//!
//! ```text
//! cargo run --example per_second
//! ```

use rate_net::{Decision, RateLimiter};

fn main() {
    // Five requests per second, per key.
    let limiter = RateLimiter::per_second(5);

    let mut allowed = 0u32;
    let mut denied = 0u32;
    for i in 0..8 {
        match limiter.check("user:42") {
            Decision::Allow => {
                allowed += 1;
                println!("request {i}: allowed");
            }
            Decision::Deny { retry_after } => {
                denied += 1;
                println!("request {i}: denied (retry after {retry_after:?})");
            }
            _ => {}
        }
    }

    println!("\n{allowed} allowed, {denied} denied against a 5/s limit");
}