resource-meter 0.2.0

A lightweight resource usage measurement library for Rust, providing scoped measurement of wall-clock time, user CPU time, and system CPU time.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

# resource-meter

A lightweight resource usage measurement library for Rust, providing scoped measurement of wall-clock time, user CPU time, and system CPU time.

## Features

- Scoped measurement using a stack-based API
- Hierarchical (tree) and flat reporting
- Tracks wall time, user CPU time, and system CPU time
- Simple API for integration
- Platform support for Unix-like systems (uses `libc::getrusage`)

## Example

```rust
use resource_meter::ResourceMeterStack;
use std::thread::sleep;
use std::time::Duration;

fn main() {
    // Create a stack to manage resource measurement scopes
    let mut stack = ResourceMeterStack::new();

    // Start a measurement scope named "outer"
    stack.push("outer");
    sleep(Duration::from_millis(100));

    // Start a nested measurement scope named "outer/inner"
    stack.push("outer/inner");
    sleep(Duration::from_millis(200));
    stack.pop(); // End "outer/inner"

    sleep(Duration::from_millis(50));
    stack.pop(); // End "outer"

    // Generate and print a hierarchical report
    let report = stack.finish();
    println!("{}", report);
}