Struct Report 

pub struct Report { /* private fields */ }

A human- and machine-readable report about observed occurrences of events.

For human-readable output, use the Display trait implementation. This is intended for writing to a terminal and uses only the basic ASCII character set.

For machine-readable output, inspect report contents via the provided methods.

Implementations

impl Report

pub fn collect() -> Self

Generates a report by collecting all metrics for all events.

Example

use nm::{Event, Report};

thread_local! {
    static TEST_EVENT: Event = Event::builder()
        .name("test_event")
        .build();
}

// Observe some events first
TEST_EVENT.with(|e| e.observe_once());

let report = Report::collect();
println!("{}", report);

Panics

Panics if the same event is registered on different threads with a different configuration.

pub fn events(&self) -> impl Iterator<Item = &EventMetrics>

Iterates through all the events in the report, allowing access to their metrics.

Example

use nm::{Event, Report};

thread_local! {
    static TEST_EVENT: Event = Event::builder()
        .name("test_event")
        .build();
}

// Observe some events first
TEST_EVENT.with(|e| e.observe_once());

let report = Report::collect();

for event in report.events() {
    println!("Event: {}, Count: {}", event.name(), event.count());
}

pub fn fake(events: Vec<EventMetrics>) -> Self

Creates a Report instance with fake data for testing purposes.

This constructor is only available with the test-util feature and allows creating arbitrary test data without touching global state.

Trait Implementations

impl Debug for Report

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

Formats the value using the given formatter.

impl Display for Report

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

Formats the value using the given formatter.