Struct ByteBudget 

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

Child usage is included in every ancestor; creating children does not multiply the parent limit. Names are static component names, not tenant identifiers or unbounded metric labels. Dropping the last child handle and reservation releases its metadata without retaining a central registry.

Implementations

impl ByteBudget

pub fn new(name: &'static str, limit: usize) -> Result<Self, ResourceError>

Create a root budget labelled name with the given byte limit.

Errors

Returns ResourceError::Invalid if limit is zero.

pub fn child( &self, name: &'static str, limit: usize, ) -> Result<Self, ResourceError>

Create a child budget whose usage is also charged to this budget.

Errors

Returns ResourceError::Invalid if limit is zero or exceeds the parent limit, or if nesting would exceed 32 levels.

pub fn snapshot(&self) -> BudgetSnapshot

Snapshot this budget’s limit, current usage, and peak usage.

pub fn available(&self) -> usize

Available in this budget AND every parent at one accounting instant.

Panics

Panics if the ancestor chain is empty, which cannot happen because a budget always has at least itself.

pub fn try_reserve( &self, bytes: usize, ) -> Result<ByteReservation, ResourceError>

Immediate admission, before allocation. Queueing, deadlines and fair scheduling are deliberately separate work; this never blocks for bytes.

Errors

Returns ResourceError::Exhausted if this budget or any ancestor cannot admit bytes.

Trait Implementations

impl Clone for ByteBudget

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.