better-bucket 0.7.0

A genuinely better token bucket for Rust: lock-free, allocation-free acquire path, cache-aligned, overflow-safe, with a one-line Tier-1 API and a mockable clock for deterministic tests.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

//! The Tier-1 common case: a per-second rate limiter.
//!
//! Run with `cargo run --example per_second`.

use better_bucket::Bucket;

fn main() {
    // Allow 5 requests per second, with a burst ceiling of 5.
    let limiter = Bucket::per_second(5);

    // Fire eight requests in a tight loop. The first five drain the bucket;
    // the rest are denied, because almost no time has passed to refill it.
    for request in 1..=8 {
        if limiter.try_acquire(1) {
            println!("request {request}: allowed");
        } else {
            println!("request {request}: denied (rate limited)");
        }
    }
}