Struct RateLimiter 

pub struct RateLimiter { /* private fields */ }

Per-provider token-bucket rate limiter.

Maintains a separate TokenBucket for each provider key. Providers not explicitly configured get a bucket with the default capacity and rate.

Example

use quantrs2_device::security::rate_limit::RateLimiter;

let mut limiter = RateLimiter::with_cloud_defaults();

// Fast path — tokens available
if limiter.try_consume("aws") {
    // submit request
} else {
    let delay = limiter.wait_time("aws");
    // sleep(delay), then retry
}

Implementations

impl RateLimiter

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

Create a rate limiter with the given defaults for unconfigured providers.

Arguments

• default_capacity — burst limit for unknown providers
• default_rate_per_second — sustained rate for unknown providers

pub fn with_provider( self, provider: impl Into<String>, capacity: f64, rate: f64, ) -> Self

Register a provider-specific bucket, overriding the defaults.

pub fn try_consume(&mut self, provider: &str) -> bool

Try to consume one token for the given provider key.

Creates a default bucket for the provider if it has not been seen before. Returns true if the request can proceed immediately.

pub fn wait_time(&mut self, provider: &str) -> Duration

Estimate the wait time before a token is available for the given provider.

Returns Duration::ZERO if a token is available immediately.

pub fn available_tokens(&mut self, provider: &str) -> f64

Return the number of available tokens for a provider (after refill).

Creates a default bucket if the provider has not been seen before.

pub fn with_cloud_defaults() -> Self

Pre-configured limiter with typical cloud provider limits:

Provider	Burst	Sustained
IBM	5	5 / 60s
AWS	10	10/s
Azure	10	10/s

Unknown providers get a 10-token bucket at 1 token/second.

pub fn tracked_providers(&self) -> Vec<&str>

Return the list of currently tracked provider keys

Trait Implementations

impl Debug for RateLimiter

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

Formats the value using the given formatter.