commonware-storage 2026.4.0

Persist and retrieve data from an abstract store.
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59

use super::utils::{get_modified_kvs, get_random_kvs, init};
use commonware_runtime::benchmarks::{context, tokio};
use criterion::{criterion_group, Criterion};
use std::time::{Duration, Instant};

fn bench_sync(c: &mut Criterion) {
    let runner = tokio::Runner::default();
    for &num_keys in &[100, 1_000, 10_000] {
        for &modified in &[0, 1, 5, 25, 50, 75, 100] {
            let label = format!("{}/keys={} modified={}", module_path!(), num_keys, modified);

            // Generate key-value pairs for the benchmark
            let initial_kvs = get_random_kvs(num_keys);
            let modified_kvs = get_modified_kvs(&initial_kvs, modified);

            // Run the benchmark
            c.bench_function(&label, |b| {
                b.to_async(&runner).iter_custom(|iters| {
                    let initial_kvs = initial_kvs.clone();
                    let modified_kvs = modified_kvs.clone();
                    async move {
                        let ctx = context::get::<commonware_runtime::tokio::Context>();
                        let mut total = Duration::ZERO;
                        for _ in 0..iters {
                            // Put initial state
                            let mut metadata = init(ctx.clone()).await;
                            for (k, v) in &initial_kvs {
                                metadata.put(k.clone(), v.clone());
                            }

                            // Sync twice to ensure both blobs populated
                            metadata.sync().await.unwrap();
                            metadata.sync().await.unwrap();

                            // Update some keys
                            for (k, v) in &modified_kvs {
                                metadata.put(k.clone(), v.clone());
                            }

                            // Sync new data
                            let start = Instant::now();
                            metadata.sync().await.unwrap();
                            total += start.elapsed();

                            metadata.destroy().await.unwrap();
                        }
                        total
                    }
                });
            });
        }
    }
}

criterion_group! {
    name = benches;
    config = Criterion::default().sample_size(10);
    targets = bench_sync
}