Struct RateLimitInfo 

pub struct RateLimitInfo { /* private fields */ }

Rate limit information for explicit control

Governing Principle Compliance

This struct follows the “Thin Client, Rich API” principle by:

• Information vs Action: Provides rate limit data without making automatic decisions
• Zero Automatic Behavior: No hidden rate limiting or magic throttling thresholds
• Explicit Control: Developers can use this information to make their own timing decisions
• Transparent Operations: All rate limit metrics are visible and accessible

Implementations

impl RateLimitInfo

pub fn new() -> Self

Create new rate limit info (currently returns placeholder data)

Note

This is a placeholder implementation. In a real implementation, this would track actual rate limit headers from API responses. For now, it provides the interface for explicit rate limit information access without automatic behavior.

pub fn remaining_requests(&self) -> u32

Get remaining requests in current window

pub fn total_limit(&self) -> u32

Get total rate limit for current window

pub fn reset_time(&self) -> Option<SystemTime>

Get time when rate limit window resets

pub fn window_duration(&self) -> Duration

Get duration of rate limit window

impl RateLimitInfo

pub fn usage_percentage(&self) -> f64

Calculate usage percentage (0.0 to 1.0)

pub fn is_approaching_limit_with_threshold( &self, threshold_percentage: f64, ) -> bool

Check if rate limit is approaching based on explicit criteria

Arguments

• threshold_percentage - Percentage threshold (0.0 to 1.0) for considering rate limit approaching

Returns

Returns true if usage percentage exceeds the specified threshold (explicit developer-defined threshold)

pub fn suggested_delay_for_rate( &self, desired_requests_per_minute: u32, ) -> Duration

Calculate suggested delay for manual rate control

Arguments

• desired_requests_per_minute - Target request rate for manual pacing

Returns

Returns suggested delay duration for achieving the desired rate (developer-controlled pacing)

Trait Implementations

impl Clone for RateLimitInfo

fn clone(&self) -> RateLimitInfo

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RateLimitInfo

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

Formats the value using the given formatter.

impl Default for RateLimitInfo

fn default() -> Self

Returns the “default value” for a type.