better-bucket 0.5.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
21
22
23
24
25
26
27
28
29
30

//! Tier-2 configuration with the builder: a large burst ceiling, a slow
//! sustained refill, and a custom initial fill.
//!
//! Run with `cargo run --example builder`.

use std::time::Duration;

use better_bucket::{Bucket, BucketError};

fn main() -> Result<(), BucketError> {
    // Hold up to 1000 tokens (burst), refill 50 per second, start empty.
    let bucket = Bucket::builder()
        .capacity(1000)
        .refill(50, Duration::from_secs(1))
        .initial(0)
        .build()?;

    println!("capacity (burst ceiling): {}", bucket.capacity());
    println!("available at start:       {}", bucket.available());
    println!(
        "refill amount:            {}",
        bucket.config().refill_amount()
    );

    // An unworkable configuration is rejected at build time.
    let rejected = Bucket::builder().capacity(0).build();
    println!("zero-capacity build:      {rejected:?}");

    Ok(())
}