Struct PerKeyRateLimiter 

pub struct PerKeyRateLimiter { /* private fields */ }

Per-API-key token-bucket rate limiter.

A separate TokenBucket is lazily created for each distinct API key on first use. Keys that have an entry in overrides get a bucket with the specified (capacity, rate) pair; all others share default_capacity and default_rate.

Concurrency model:

• The outer RwLock guards the HashMap of buckets. Read-lock is taken for lookups; write-lock is acquired only on the first hit for a new key.
• Each bucket is wrapped in a Mutex so multiple concurrent requests for the same key do not race on the bucket’s mutable refill state.

Implementations

impl PerKeyRateLimiter

pub fn new(default_capacity: f64, default_rate: f64) -> Self

Create a limiter with the given default capacity and refill rate.

pub fn with_overrides(self, overrides: HashMap<String, (f64, f64)>) -> Self

Attach per-key overrides: key → (capacity, rate).

Returns self for builder-pattern chaining.

pub fn check_key(&self, key: &str) -> bool

Check if a request for key should be allowed.

Returns true if a token was successfully consumed, false if the bucket is exhausted (caller should respond 429).

On the first call for a given key the bucket is lazy-inserted under the write lock; subsequent calls use a read lock for O(1) lookup.

Trait Implementations

impl Debug for PerKeyRateLimiter

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.