Struct RunProfile 

#[non_exhaustive]
pub struct RunProfile {
    pub exit_code: Option<i32>,
    pub duration: Duration,
    pub cpu_time: Option<Duration>,
    pub peak_memory_bytes: Option<u64>,
    pub samples: usize,
}

Available on crate feature stats only.

Resource summary of one finished run — produced by RunningProcess::profile.

CPU and memory are sampled from the started child process (the same source as RunningProcess::cpu_time / peak_memory_bytes), so they are None where per-process metrics are unavailable (macOS/BSD) or when the run exited before the first sample landed.

Non-exhaustive: a read-only summary the crate produces — new metrics can be added without a breaking change.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

exit_code: Option<i32>

The exit code; None for a run killed by its timeout or a signal (matching RunningProcess::wait).

duration: Duration

Wall-clock time from process start until the run finished (exit reaped and output drained).

cpu_time: Option<Duration>

Cumulative CPU time (user + kernel) at the last successful sample.

peak_memory_bytes: Option<u64>

Peak resident memory observed across the samples, in bytes.

samples: usize

How many sampling ticks ran (including ones that found no data).

Implementations

impl RunProfile

pub fn avg_cpu(&self) -> Option<f64>

Average CPU utilisation over the run, in cores (0.5 = half a core busy on average; can exceed 1.0 for multi-threaded children). None when CPU time was never observed or the run had no duration.

Trait Implementations

impl Clone for RunProfile

fn clone(&self) -> RunProfile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RunProfile

impl Debug for RunProfile

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

Formats the value using the given formatter.

impl PartialEq for RunProfile

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RunProfile