Struct BucketSize 

pub struct BucketSize(/* private fields */);

Bucket coalescing interval stored in milliseconds.

Validated newtype controlling how aggressively increments are merged into buckets.

Increments occurring within this interval of each other are coalesced into the same bucket, reducing memory usage and improving performance at the cost of timing granularity.

Validation

• Must be >= 1
• Typical values: 10-100 milliseconds

Trade-offs

Larger values (50-100ms):

• Lower memory usage and overhead
• Coarser rejection metadata

Smaller values (1-20ms):

• More accurate timing and rejection metadata
• Higher memory usage

Examples

use trypema::BucketSize;

let coalescing = BucketSize::milliseconds(10).unwrap();
assert_eq!(coalescing.as_milliseconds(), 10);

let aggressive = BucketSize::milliseconds(100).unwrap();
let precise = BucketSize::milliseconds_or_panic(1);
let _ = (aggressive, precise);

// Invalid
assert!(BucketSize::milliseconds(0).is_err());

Implementations

impl BucketSize

pub fn as_milliseconds(self) -> u64

Return bucket-coalescing interval in milliseconds.

pub fn milliseconds(value: u64) -> Result<Self, TrypemaError>

Create a bucket size expressed in milliseconds.

pub fn milliseconds_or_panic(value: u64) -> Self

Create a bucket size expressed in milliseconds.

Panics

Panics when value is zero.

pub fn seconds(value: u64) -> Result<Self, TrypemaError>

Create a bucket size expressed in seconds.

pub fn seconds_or_panic(value: u64) -> Self

Create a bucket size expressed in seconds.

Panics

Panics when value is zero or conversion overflows.

pub fn minutes(value: u64) -> Result<Self, TrypemaError>

Create a bucket size expressed in minutes.

pub fn minutes_or_panic(value: u64) -> Self

Create a bucket size expressed in minutes.

Panics

Panics when value is zero or conversion overflows.

pub fn hours(value: u64) -> Result<Self, TrypemaError>

Create a bucket size expressed in hours.

pub fn hours_or_panic(value: u64) -> Self

Create a bucket size expressed in hours.

Panics

Panics when value is zero or conversion overflows.

pub fn days(value: u64) -> Result<Self, TrypemaError>

Create a bucket size expressed in days.

pub fn days_or_panic(value: u64) -> Self

Create a bucket size expressed in days.

Panics

Panics when value is zero or conversion overflows.

pub fn weeks(value: u64) -> Result<Self, TrypemaError>

Create a bucket size expressed in weeks.

pub fn weeks_or_panic(value: u64) -> Self

Create a bucket size expressed in weeks.

Panics

Panics when value is zero or conversion overflows.

pub fn months(value: u64) -> Result<Self, TrypemaError>

Create a bucket size expressed in 30-day months.

pub fn months_or_panic(value: u64) -> Self

Create a bucket size expressed in 30-day months.

Panics

Panics when value is zero or conversion overflows.

Trait Implementations

impl Clone for BucketSize

fn clone(&self) -> BucketSize

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BucketSize

impl Debug for BucketSize

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

Formats the value using the given formatter.

impl Default for BucketSize

fn default() -> Self

Returns a rate group size of 100 ms.

impl PartialEq for BucketSize

fn eq(&self, other: &BucketSize) -> bool

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for BucketSize

fn partial_cmp(&self, other: &BucketSize) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for BucketSize