rate-net 0.9.5

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

//! Deterministic testing: drive refills with a `ManualClock`, no real sleeping.
//!
//! ```text
//! cargo run --example mock_clock
//! ```

use clock_lib::ManualClock;
use rate_net::RateLimiter;
use std::sync::Arc;
use std::time::Duration;

fn main() {
    // Share a manual clock with the limiter so the test drives time by hand.
    let clock = Arc::new(ManualClock::new());
    let limiter = RateLimiter::per_second(3).with_clock(Arc::clone(&clock));

    for i in 1..=3 {
        assert!(limiter.check("k").is_allow());
        println!("request {i}: allowed");
    }
    assert!(limiter.check("k").is_deny());
    println!("request 4: denied (allowance spent)");

    // Advance one second — instantly, with no thread::sleep.
    clock.advance(Duration::from_secs(1));
    println!("\n-- advanced clock by 1s (no real time elapsed) --\n");

    assert!(limiter.check("k").is_allow());
    println!("request 5: allowed (allowance refilled)");
}