Struct UsageWindow 

pub struct UsageWindow {
    pub name: String,
    pub label: Option<String>,
    pub used_percent: Option<f64>,
    pub used: Option<f64>,
    pub limit: Option<f64>,
    pub resets_at: Option<String>,
    pub resets_at_unix: Option<i64>,
    pub window_seconds: Option<i64>,
}

A single rate-limit or quota window. Providers report usage either as a percentage (used_percent) or as absolute counts (used / limit); a window carries whichever the upstream gives. Reset time is kept verbatim as an ISO-8601 string (resets_at) and/or unix seconds (resets_at_unix).

Fields

name: String

Window id ("five_hour", "seven_day", "primary", a model id, …).

label: Option<String>

Human-readable upstream label when name is generated.

used_percent: Option<f64>

used: Option<f64>

limit: Option<f64>

resets_at: Option<String>

ISO-8601 reset timestamp, when the provider gives one.

resets_at_unix: Option<i64>

Unix-seconds reset timestamp, when the provider gives one.

window_seconds: Option<i64>

Window length in seconds, when known.

Implementations

impl UsageWindow

pub fn percent(name: impl Into<String>, used_percent: f64) -> Self

A percentage-based window (used_percent in [0, 100]).

pub fn amounts(name: impl Into<String>, used: f64, limit: f64) -> Self

An absolute-count window (used / limit).

pub fn resets_iso(self, iso: impl Into<String>) -> Self

Attach an ISO-8601 reset timestamp.

pub fn resets_unix(self, unix: i64) -> Self

Attach a unix-seconds reset timestamp.

pub fn window_secs(self, seconds: i64) -> Self

Attach the window length in seconds.

pub fn label(self, label: impl Into<String>) -> Self

Attach a display label for generated / scoped windows.

Trait Implementations

impl Clone for UsageWindow

fn clone(&self) -> UsageWindow

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UsageWindow

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

Formats the value using the given formatter.

impl Default for UsageWindow

fn default() -> UsageWindow

Returns the “default value” for a type.

impl Serialize for UsageWindow

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.