Struct Token 

pub struct Token<C: Clock = SystemClock> { /* private fields */ }

An in progress COGS measurement.

The measurement is recorded when the token is dropped.

Implementations

impl<C: Clock> Token<C>

pub fn noop() -> Self

where C: Default,

Creates a new no-op token, which records nothing.

This is primarily useful for testing.

pub fn cancel(&mut self)

Cancels the COGS measurement.

pub fn start_category( &mut self, category: impl Category, ) -> CategoryToken<'_, C>

Starts a categorized measurement.

The measurement is finalized when the returned CategoryToken is dropped.

Instead of manually starting a categorized measurement, the crate::with macro can be used.

pub fn update<T: Into<FeatureWeights>>(&mut self, features: T)

Updates the app features to which the active measurement is attributed to.

Example:

fn process(cogs: &Cogs, item: &Item) {
    let mut token = cogs.timed(ResourceId::Relay, AppFeature::Unattributed);

    // App feature is only known after some computations.
    if do_something(item) {
        token.update(AppFeature::Spans);
    } else {
        token.update(AppFeature::Transactions);
    }
}

Trait Implementations

impl Debug for Token

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

Formats the value using the given formatter.

impl<C: Clock> Drop for Token<C>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.