Struct Throttle 

pub struct Throttle { /* private fields */ }

A sliding-window counter keyed by an arbitrary string.

max attempts are permitted within any trailing window. This is a thin wrapper over the core RateLimiter primitive — it holds one and adapts its rich umbral::ratelimit::RateDecision down to the bool (allow / deny) the auth handlers need, plus the clock-injectable *_at variants the tests drive. All the per-key timestamp bookkeeping lives in RateLimiter; this type adds no sliding-window logic of its own.

Implementations

impl Throttle

pub fn new(max: usize, window: Duration) -> Self

Build a limiter allowing max attempts per trailing window.

max == 0 is treated as “deny everything” (a hard lock); any other max permits up to max attempts in the trailing window. (Core RateLimiter denies when count < num is false, so num == 0 denies the very first attempt — the same hard-lock semantics.)

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

Record an attempt for key and report whether it’s allowed.

Uses the real wall clock. Prunes anything older than window, denies (false) when >= max remain in-window, otherwise records now and allows (true).

pub fn clear(&self, key: &str)

Forget every recorded attempt for key. Called on a successful login so prior failures don’t count against a now-authenticated user.

pub fn check_at(&self, key: &str, now: Instant) -> bool

Clock-injectable core of check. A now of the caller’s choosing lets a test advance time without sleeping.

pub fn clear_at(&self, key: &str)

Clock-injectable core of clear. No now needed — clearing is unconditional — but named _at for symmetry with check_at.

Trait Implementations

impl Debug for Throttle

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

Formats the value using the given formatter.