Struct Check 

pub struct Check<'a, P: RateLimitPolicy + ?Sized = FixedWindowPolicy> { /* private fields */ }

One proposed quota charge against a policy and opaque subject.

A newly constructed check has cost 1. Custom costs are validated against the referenced policy so a backend never receives a zero-cost or intrinsically impossible check.

Implementations

impl<'a, P: RateLimitPolicy + ?Sized> Check<'a, P>

pub const fn new(policy: &'a P, subject: SubjectKey) -> Self

Constructs a check with the default cost of 1.

pub fn with_cost( policy: &'a P, subject: SubjectKey, cost: u64, ) -> Result<Self, CheckError>

Validates and constructs a check with a custom cost.

Errors

Returns an error when cost is zero or exceeds the policy capacity.

pub fn try_with_cost(self, cost: u64) -> Result<Self, CheckError>

Returns this check with a validated custom cost.

Errors

Returns an error when cost is zero or exceeds the policy capacity.

pub const fn policy(&self) -> &'a P

Returns the policy evaluated by this check.

pub const fn subject(&self) -> SubjectKey

Returns the opaque subject key evaluated by this check.

pub fn counter_key(&self) -> CounterKey

Returns the complete logical identity of the stored counter.

pub const fn cost(&self) -> u64

Returns the nonzero quota cost.

Trait Implementations

impl<P: RateLimitPolicy + ?Sized> Clone for Check<'_, P>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P: RateLimitPolicy + ?Sized> Copy for Check<'_, P>

impl<'a, P: Debug + RateLimitPolicy + ?Sized> Debug for Check<'a, P>

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

Formats the value using the given formatter.

impl<'a, P: Eq + RateLimitPolicy + ?Sized> Eq for Check<'a, P>

impl<'a, P: PartialEq + RateLimitPolicy + ?Sized> PartialEq for Check<'a, P>

fn eq(&self, other: &Check<'a, P>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<'a, P: PartialEq + RateLimitPolicy + ?Sized> StructuralPartialEq for Check<'a, P>