Struct TestMetrics 

pub struct TestMetrics {
    pub name: String,
    pub timings_ns: Vec<u64>,
    pub op_counts: HashMap<String, u64>,
    pub custom_metrics: HashMap<String, f64>,
    pub memory_samples: Vec<usize>,
    pub error_count: u64,
    pub warning_count: u64,
    /* private fields */
}

Granular performance metrics for test operations

Fields

name: String

Operation name for reporting

timings_ns: Vec<u64>

Individual timing samples (nanoseconds)

op_counts: HashMap<String, u64>

Operation counts by category

custom_metrics: HashMap<String, f64>

Custom numeric metrics

memory_samples: Vec<usize>

Memory snapshots (bytes)

error_count: u64

Error/warning counts

warning_count: u64

Implementations

impl TestMetrics

pub fn new(name: &str) -> Self

Create new metrics collector for named operation

Examples found in repository

examples/performance_metrics.rs (line 14)

fn main() {
    println!("=== Embeddenator TestKit - Performance Metrics ===\n");

    // Create test metrics
    let mut metrics = TestMetrics::new("example_operations");

    // Time a simple operation
    println!("1. Timing vector generation...");
    let mut rng = rand::rngs::StdRng::seed_from_u64(42);

    for _ in 0..10 {
        metrics.time_operation(|| {
            let _vec = random_sparse_vec(&mut rng, 10000, 200);
        });
    }

    println!("   Completed 10 operations");
    let stats = metrics.timing_stats();
    println!("   Mean: {:.2}µs", stats.mean_ns / 1000.0);
    println!("   Median: {:.2}µs", stats.p50_ns as f64 / 1000.0);
    println!("   P95: {:.2}µs", stats.p95_ns as f64 / 1000.0);

    // Record custom metrics
    println!("\n2. Recording custom metrics...");
    metrics.record_metric("accuracy", 0.95);
    metrics.record_metric("precision", 0.92);
    metrics.record_metric("recall", 0.89);
    metrics.inc_op("validation_checks");

    // Record memory usage
    println!("\n3. Recording memory snapshots...");
    for i in 1..=5 {
        metrics.record_memory(i * 1024 * 1024); // Simulate growing memory usage
    }

    // Display full summary
    println!("\n4. Full metrics summary:");
    println!("{}", metrics.summary());

    // Test timing with actual work
    println!("\n5. Timing with simulated work...");
    let mut work_metrics = TestMetrics::new("simulated_work");

    for sleep_ms in [1, 2, 5, 10, 20] {
        work_metrics.time_operation(|| {
            thread::sleep(Duration::from_millis(sleep_ms));
        });
    }

    let work_stats = work_metrics.timing_stats();
    println!("   Operations: {}", work_stats.count);
    println!(
        "   Total time: {:.2}ms",
        work_stats.total_ns as f64 / 1_000_000.0
    );
    println!("   Throughput: {:.2} ops/sec", work_stats.ops_per_sec());

    println!("\n✅ Performance metrics example complete!");
}

pub fn start_timing(&mut self)

Start timing measurement

pub fn stop_timing(&mut self)

Stop timing and record sample

pub fn time_operation<F, R>(&mut self, f: F) -> R

where F: FnOnce() -> R,

Record a timed operation with closure

Examples found in repository

examples/performance_metrics.rs (lines 21-23)

fn main() {
    println!("=== Embeddenator TestKit - Performance Metrics ===\n");

    // Create test metrics
    let mut metrics = TestMetrics::new("example_operations");

    // Time a simple operation
    println!("1. Timing vector generation...");
    let mut rng = rand::rngs::StdRng::seed_from_u64(42);

    for _ in 0..10 {
        metrics.time_operation(|| {
            let _vec = random_sparse_vec(&mut rng, 10000, 200);
        });
    }

    println!("   Completed 10 operations");
    let stats = metrics.timing_stats();
    println!("   Mean: {:.2}µs", stats.mean_ns / 1000.0);
    println!("   Median: {:.2}µs", stats.p50_ns as f64 / 1000.0);
    println!("   P95: {:.2}µs", stats.p95_ns as f64 / 1000.0);

    // Record custom metrics
    println!("\n2. Recording custom metrics...");
    metrics.record_metric("accuracy", 0.95);
    metrics.record_metric("precision", 0.92);
    metrics.record_metric("recall", 0.89);
    metrics.inc_op("validation_checks");

    // Record memory usage
    println!("\n3. Recording memory snapshots...");
    for i in 1..=5 {
        metrics.record_memory(i * 1024 * 1024); // Simulate growing memory usage
    }

    // Display full summary
    println!("\n4. Full metrics summary:");
    println!("{}", metrics.summary());

    // Test timing with actual work
    println!("\n5. Timing with simulated work...");
    let mut work_metrics = TestMetrics::new("simulated_work");

    for sleep_ms in [1, 2, 5, 10, 20] {
        work_metrics.time_operation(|| {
            thread::sleep(Duration::from_millis(sleep_ms));
        });
    }

    let work_stats = work_metrics.timing_stats();
    println!("   Operations: {}", work_stats.count);
    println!(
        "   Total time: {:.2}ms",
        work_stats.total_ns as f64 / 1_000_000.0
    );
    println!("   Throughput: {:.2} ops/sec", work_stats.ops_per_sec());

    println!("\n✅ Performance metrics example complete!");
}

pub fn inc_op(&mut self, category: &str)

Increment operation counter

Examples found in repository

examples/performance_metrics.rs (line 37)

fn main() {
    println!("=== Embeddenator TestKit - Performance Metrics ===\n");

    // Create test metrics
    let mut metrics = TestMetrics::new("example_operations");

    // Time a simple operation
    println!("1. Timing vector generation...");
    let mut rng = rand::rngs::StdRng::seed_from_u64(42);

    for _ in 0..10 {
        metrics.time_operation(|| {
            let _vec = random_sparse_vec(&mut rng, 10000, 200);
        });
    }

    println!("   Completed 10 operations");
    let stats = metrics.timing_stats();
    println!("   Mean: {:.2}µs", stats.mean_ns / 1000.0);
    println!("   Median: {:.2}µs", stats.p50_ns as f64 / 1000.0);
    println!("   P95: {:.2}µs", stats.p95_ns as f64 / 1000.0);

    // Record custom metrics
    println!("\n2. Recording custom metrics...");
    metrics.record_metric("accuracy", 0.95);
    metrics.record_metric("precision", 0.92);
    metrics.record_metric("recall", 0.89);
    metrics.inc_op("validation_checks");

    // Record memory usage
    println!("\n3. Recording memory snapshots...");
    for i in 1..=5 {
        metrics.record_memory(i * 1024 * 1024); // Simulate growing memory usage
    }

    // Display full summary
    println!("\n4. Full metrics summary:");
    println!("{}", metrics.summary());

    // Test timing with actual work
    println!("\n5. Timing with simulated work...");
    let mut work_metrics = TestMetrics::new("simulated_work");

    for sleep_ms in [1, 2, 5, 10, 20] {
        work_metrics.time_operation(|| {
            thread::sleep(Duration::from_millis(sleep_ms));
        });
    }

    let work_stats = work_metrics.timing_stats();
    println!("   Operations: {}", work_stats.count);
    println!(
        "   Total time: {:.2}ms",
        work_stats.total_ns as f64 / 1_000_000.0
    );
    println!("   Throughput: {:.2} ops/sec", work_stats.ops_per_sec());

    println!("\n✅ Performance metrics example complete!");
}

pub fn record_metric(&mut self, name: &str, value: f64)

Record custom metric

Examples found in repository

examples/performance_metrics.rs (line 34)

fn main() {
    println!("=== Embeddenator TestKit - Performance Metrics ===\n");

    // Create test metrics
    let mut metrics = TestMetrics::new("example_operations");

    // Time a simple operation
    println!("1. Timing vector generation...");
    let mut rng = rand::rngs::StdRng::seed_from_u64(42);

    for _ in 0..10 {
        metrics.time_operation(|| {
            let _vec = random_sparse_vec(&mut rng, 10000, 200);
        });
    }

    println!("   Completed 10 operations");
    let stats = metrics.timing_stats();
    println!("   Mean: {:.2}µs", stats.mean_ns / 1000.0);
    println!("   Median: {:.2}µs", stats.p50_ns as f64 / 1000.0);
    println!("   P95: {:.2}µs", stats.p95_ns as f64 / 1000.0);

    // Record custom metrics
    println!("\n2. Recording custom metrics...");
    metrics.record_metric("accuracy", 0.95);
    metrics.record_metric("precision", 0.92);
    metrics.record_metric("recall", 0.89);
    metrics.inc_op("validation_checks");

    // Record memory usage
    println!("\n3. Recording memory snapshots...");
    for i in 1..=5 {
        metrics.record_memory(i * 1024 * 1024); // Simulate growing memory usage
    }

    // Display full summary
    println!("\n4. Full metrics summary:");
    println!("{}", metrics.summary());

    // Test timing with actual work
    println!("\n5. Timing with simulated work...");
    let mut work_metrics = TestMetrics::new("simulated_work");

    for sleep_ms in [1, 2, 5, 10, 20] {
        work_metrics.time_operation(|| {
            thread::sleep(Duration::from_millis(sleep_ms));
        });
    }

    let work_stats = work_metrics.timing_stats();
    println!("   Operations: {}", work_stats.count);
    println!(
        "   Total time: {:.2}ms",
        work_stats.total_ns as f64 / 1_000_000.0
    );
    println!("   Throughput: {:.2} ops/sec", work_stats.ops_per_sec());

    println!("\n✅ Performance metrics example complete!");
}

pub fn record_memory(&mut self, bytes: usize)

Record memory usage

Examples found in repository

examples/performance_metrics.rs (line 42)

fn main() {
    println!("=== Embeddenator TestKit - Performance Metrics ===\n");

    // Create test metrics
    let mut metrics = TestMetrics::new("example_operations");

    // Time a simple operation
    println!("1. Timing vector generation...");
    let mut rng = rand::rngs::StdRng::seed_from_u64(42);

    for _ in 0..10 {
        metrics.time_operation(|| {
            let _vec = random_sparse_vec(&mut rng, 10000, 200);
        });
    }

    println!("   Completed 10 operations");
    let stats = metrics.timing_stats();
    println!("   Mean: {:.2}µs", stats.mean_ns / 1000.0);
    println!("   Median: {:.2}µs", stats.p50_ns as f64 / 1000.0);
    println!("   P95: {:.2}µs", stats.p95_ns as f64 / 1000.0);

    // Record custom metrics
    println!("\n2. Recording custom metrics...");
    metrics.record_metric("accuracy", 0.95);
    metrics.record_metric("precision", 0.92);
    metrics.record_metric("recall", 0.89);
    metrics.inc_op("validation_checks");

    // Record memory usage
    println!("\n3. Recording memory snapshots...");
    for i in 1..=5 {
        metrics.record_memory(i * 1024 * 1024); // Simulate growing memory usage
    }

    // Display full summary
    println!("\n4. Full metrics summary:");
    println!("{}", metrics.summary());

    // Test timing with actual work
    println!("\n5. Timing with simulated work...");
    let mut work_metrics = TestMetrics::new("simulated_work");

    for sleep_ms in [1, 2, 5, 10, 20] {
        work_metrics.time_operation(|| {
            thread::sleep(Duration::from_millis(sleep_ms));
        });
    }

    let work_stats = work_metrics.timing_stats();
    println!("   Operations: {}", work_stats.count);
    println!(
        "   Total time: {:.2}ms",
        work_stats.total_ns as f64 / 1_000_000.0
    );
    println!("   Throughput: {:.2} ops/sec", work_stats.ops_per_sec());

    println!("\n✅ Performance metrics example complete!");
}

pub fn record_operation(&mut self, count: usize)

Record operation count

pub fn record_error(&mut self)

Record an error

pub fn record_warning(&mut self)

Record a warning

pub fn timing_stats(&self) -> TimingStats

Get timing statistics

Examples found in repository

examples/performance_metrics.rs (line 27)

fn main() {
    println!("=== Embeddenator TestKit - Performance Metrics ===\n");

    // Create test metrics
    let mut metrics = TestMetrics::new("example_operations");

    // Time a simple operation
    println!("1. Timing vector generation...");
    let mut rng = rand::rngs::StdRng::seed_from_u64(42);

    for _ in 0..10 {
        metrics.time_operation(|| {
            let _vec = random_sparse_vec(&mut rng, 10000, 200);
        });
    }

    println!("   Completed 10 operations");
    let stats = metrics.timing_stats();
    println!("   Mean: {:.2}µs", stats.mean_ns / 1000.0);
    println!("   Median: {:.2}µs", stats.p50_ns as f64 / 1000.0);
    println!("   P95: {:.2}µs", stats.p95_ns as f64 / 1000.0);

    // Record custom metrics
    println!("\n2. Recording custom metrics...");
    metrics.record_metric("accuracy", 0.95);
    metrics.record_metric("precision", 0.92);
    metrics.record_metric("recall", 0.89);
    metrics.inc_op("validation_checks");

    // Record memory usage
    println!("\n3. Recording memory snapshots...");
    for i in 1..=5 {
        metrics.record_memory(i * 1024 * 1024); // Simulate growing memory usage
    }

    // Display full summary
    println!("\n4. Full metrics summary:");
    println!("{}", metrics.summary());

    // Test timing with actual work
    println!("\n5. Timing with simulated work...");
    let mut work_metrics = TestMetrics::new("simulated_work");

    for sleep_ms in [1, 2, 5, 10, 20] {
        work_metrics.time_operation(|| {
            thread::sleep(Duration::from_millis(sleep_ms));
        });
    }

    let work_stats = work_metrics.timing_stats();
    println!("   Operations: {}", work_stats.count);
    println!(
        "   Total time: {:.2}ms",
        work_stats.total_ns as f64 / 1_000_000.0
    );
    println!("   Throughput: {:.2} ops/sec", work_stats.ops_per_sec());

    println!("\n✅ Performance metrics example complete!");
}

pub fn summary(&self) -> String

Generate summary report

Examples found in repository

examples/performance_metrics.rs (line 47)

fn main() {
    println!("=== Embeddenator TestKit - Performance Metrics ===\n");

    // Create test metrics
    let mut metrics = TestMetrics::new("example_operations");

    // Time a simple operation
    println!("1. Timing vector generation...");
    let mut rng = rand::rngs::StdRng::seed_from_u64(42);

    for _ in 0..10 {
        metrics.time_operation(|| {
            let _vec = random_sparse_vec(&mut rng, 10000, 200);
        });
    }

    println!("   Completed 10 operations");
    let stats = metrics.timing_stats();
    println!("   Mean: {:.2}µs", stats.mean_ns / 1000.0);
    println!("   Median: {:.2}µs", stats.p50_ns as f64 / 1000.0);
    println!("   P95: {:.2}µs", stats.p95_ns as f64 / 1000.0);

    // Record custom metrics
    println!("\n2. Recording custom metrics...");
    metrics.record_metric("accuracy", 0.95);
    metrics.record_metric("precision", 0.92);
    metrics.record_metric("recall", 0.89);
    metrics.inc_op("validation_checks");

    // Record memory usage
    println!("\n3. Recording memory snapshots...");
    for i in 1..=5 {
        metrics.record_memory(i * 1024 * 1024); // Simulate growing memory usage
    }

    // Display full summary
    println!("\n4. Full metrics summary:");
    println!("{}", metrics.summary());

    // Test timing with actual work
    println!("\n5. Timing with simulated work...");
    let mut work_metrics = TestMetrics::new("simulated_work");

    for sleep_ms in [1, 2, 5, 10, 20] {
        work_metrics.time_operation(|| {
            thread::sleep(Duration::from_millis(sleep_ms));
        });
    }

    let work_stats = work_metrics.timing_stats();
    println!("   Operations: {}", work_stats.count);
    println!(
        "   Total time: {:.2}ms",
        work_stats.total_ns as f64 / 1_000_000.0
    );
    println!("   Throughput: {:.2} ops/sec", work_stats.ops_per_sec());

    println!("\n✅ Performance metrics example complete!");
}

Trait Implementations

impl Clone for TestMetrics

fn clone(&self) -> TestMetrics

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TestMetrics

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

Formats the value using the given formatter.