Struct Profiler 

pub struct Profiler { /* private fields */ }

Main inference profiler.

Maintains a stack of completed ProfileTraces and an optional in-progress trace. Use Self::begin_trace / Self::end_trace to bracket an inference pass, and Self::profile (or the begin_event/end_event pair) to record individual operations.

Implementations

impl Profiler

pub fn new() -> Self

Create an enabled profiler.

pub fn enabled(enabled: bool) -> Self

Create a profiler with an explicit enabled/disabled flag.

pub fn is_enabled(&self) -> bool

Whether the profiler is currently recording events.

pub fn begin_trace(&mut self)

Begin a new trace.

Any previous in-progress trace is discarded; call Self::end_trace first if you want to keep it.

pub fn end_trace(&mut self) -> Option<ProfileTrace>

Finalise the current trace, push it to the completed list, and return a clone.

Returns None if no trace is in progress.

pub fn begin_event(&mut self, _name: impl Into<String>) -> Instant

Record the start of an event and return the Instant.

Pair with Self::end_event.

pub fn end_event( &mut self, name: impl Into<String>, start_time: Instant, flops: u64, )

Complete an event started at start_time and record it in the active trace (if any).

pub fn profile<F, R>(&mut self, name: impl Into<String>, flops: u64, f: F) -> R

where F: FnOnce() -> R,

Time f, record the event as name with flops estimated FLOPs, and return whatever f returns.

When the profiler is disabled the closure is still executed; only recording is skipped.

pub fn scoped<'a>(&'a mut self, name: impl Into<String>) -> ProfileGuard<'a>

Return a scoped guard that records an event when dropped.

This allows recording events that span a ?-early-return path without an explicit end_event call.

pub fn traces(&self) -> &[ProfileTrace]

All completed traces (oldest first).

pub fn last_trace(&self) -> Option<&ProfileTrace>

The most recently completed trace, if any.

pub fn aggregate_stats(&self) -> AggregateStats

Aggregate statistics across all completed traces.

Trait Implementations

impl Default for Profiler

fn default() -> Self

Returns the “default value” for a type.