grumpydb 5.0.0

A disk-based object storage engine with B+Tree indexing and page-based storage
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

//! Criterion benchmarks for the GrumpyDB wire protocol.
//!
//! Measures parser throughput on common command shapes and serializer throughput
//! on representative responses. Run with
//! `cargo bench --bench protocol` (full mode) or
//! `cargo bench --bench protocol -- --quick` (smoke run).

use criterion::{Criterion, Throughput, black_box, criterion_group, criterion_main};
use grumpydb_protocol::{Response, parse_command};

fn bench_parse_simple_commands(c: &mut Criterion) {
    // Mix of small, frequently-used commands. The parser is line-oriented and
    // case-insensitive on the verb.
    let commands: Vec<&str> = vec![
        "PING",
        "GET users 550e8400-e29b-41d4-a716-446655440000",
        "INSERT users 550e8400-e29b-41d4-a716-446655440000 {\"name\":\"alice\"}",
        "GET tasks 550e8400-e29b-41d4-a716-446655440001",
        "PING",
        "GET tasks 550e8400-e29b-41d4-a716-446655440002",
        "DELETE tasks 550e8400-e29b-41d4-a716-446655440003",
        "COUNT tasks",
        "FLUSH",
        "PING",
    ];
    // Repeat to reach 1 000 commands per iteration.
    let mut batch: Vec<&str> = Vec::with_capacity(1_000);
    for _ in 0..(1_000 / commands.len()) {
        batch.extend_from_slice(&commands);
    }
    while batch.len() < 1_000 {
        batch.push("PING");
    }

    let mut group = c.benchmark_group("parse_simple_commands");
    group.throughput(Throughput::Elements(1_000));
    group.bench_function("1000_commands", |b| {
        b.iter(|| {
            for line in &batch {
                let cmd = parse_command(black_box(line)).expect("parse");
                black_box(cmd);
            }
        });
    });
    group.finish();
}

fn bench_parse_complex_command(c: &mut Criterion) {
    // INSERT with a ~1 KB JSON value.
    let payload = format!(
        "{{\"name\":\"alice\",\"bio\":\"{}\",\"age\":42,\"active\":true}}",
        "x".repeat(950)
    );
    let line = format!("INSERT users 550e8400-e29b-41d4-a716-446655440000 {payload}");
    assert!(line.len() >= 1_000, "expected ~1KB command line");

    let mut group = c.benchmark_group("parse_complex_command");
    group.throughput(Throughput::Bytes(line.len() as u64));
    group.bench_function("1kb_insert", |b| {
        b.iter(|| {
            let cmd = parse_command(black_box(&line)).expect("parse");
            black_box(cmd);
        });
    });
    group.finish();
}

fn bench_serialize_response(c: &mut Criterion) {
    // Response::Array containing 100 Bulk(Some(...)) entries — typical SCAN
    // result shape.
    let response = Response::Array(
        (0..100)
            .map(|i| Response::Bulk(Some(format!("doc_{i}_payload"))))
            .collect(),
    );

    let mut group = c.benchmark_group("serialize_response");
    group.throughput(Throughput::Elements(100));
    group.bench_function("array_100_bulks", |b| {
        b.iter(|| {
            let s = black_box(&response).serialize();
            black_box(s);
        });
    });
    group.finish();
}

criterion_group!(
    protocol_benches,
    bench_parse_simple_commands,
    bench_parse_complex_command,
    bench_serialize_response,
);
criterion_main!(protocol_benches);