par_bench 0.2.39

Mechanisms for multithreaded benchmarking, designed for integration with Criterion or a similar benchmark framework
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
40
41
42
43
44
45

//! Basic benchmarks demonstrating the performance difference between single-threaded
//! and multi-threaded atomic operations using `par_bench`.

#![allow(
    missing_docs,
    reason = "No need for API documentation in benchmark code"
)]

use std::sync::atomic::{AtomicU64, Ordering};

use criterion::measurement::WallTime;
use criterion::{BenchmarkGroup, Criterion, criterion_group, criterion_main};
use many_cpus::SystemHardware;
use new_zealand::nz;
use par_bench::{Run, ThreadPool};

criterion_group!(benches, entrypoint);
criterion_main!(benches);

fn entrypoint(c: &mut Criterion) {
    let mut group = c.benchmark_group("atomic_increments");

    let mut single_thread_pool = ThreadPool::new(
        SystemHardware::current()
            .processors()
            .to_builder()
            .take(nz!(1))
            .unwrap(),
    );
    let mut multi_thread_pool = ThreadPool::new(SystemHardware::current().processors());

    atomic_increments(&mut single_thread_pool, &mut group, "single_thread");
    atomic_increments(&mut multi_thread_pool, &mut group, "multi_thread");

    group.finish();
}

/// Benchmarks the time taken to perform atomic increments.
fn atomic_increments(pool: &mut ThreadPool, group: &mut BenchmarkGroup<'_, WallTime>, name: &str) {
    let counter = AtomicU64::new(0);

    Run::new()
        .iter(|_| counter.fetch_add(1, Ordering::Relaxed))
        .execute_criterion_on(pool, group, name);
}