arena-b 1.0.0

Production-grade bump allocator with lock-free, slab, and virtual-memory tooling for parsers, game engines, and request-scoped services
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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

use arena_b::Arena;

#[test]
fn alloc_basic() {
    let arena = Arena::new();
    let x = arena.alloc(42);
    assert_eq!(*x, 42);
    *x = 7;
    assert_eq!(*x, 7);
}

#[test]
fn alloc_slice_copy_basic() {
    let arena = Arena::new();
    let src = [1_u32, 2, 3];
    let dst = arena.alloc_slice_copy(&src);
    assert_eq!(dst, &src);
}

#[test]
fn alloc_str_basic() {
    let arena = Arena::new();
    let s = arena.alloc_str("hello");
    assert_eq!(s, "hello");
}

#[test]
fn reset_allows_reuse() {
    let mut arena = Arena::with_capacity(128);
    let first = arena.alloc(1_u32);
    assert_eq!(*first, 1);
    #[cfg(feature = "arena_module")]
    unsafe {
        arena.reset();
    }
    #[cfg(not(feature = "arena_module"))]
    arena.reset();
    let second = arena.alloc(2_u32);
    assert_eq!(*second, 2);
}

#[cfg(all(
    feature = "stats",
    not(any(feature = "thread_local", feature = "lockfree"))
))]
#[test]
fn stats_track_usage() {
    let arena = Arena::with_capacity(1024);
    let _ = arena.alloc(1_u64);
    let stats = arena.stats();
    assert_eq!(stats.bytes_allocated, 1024);
    assert!(stats.bytes_used > 0);
    assert!(stats.allocation_count >= 1);
    assert_eq!(stats.chunk_count, 1);
}

#[test]
fn alloc_slice_copy_zero_len() {
    let arena = Arena::new();
    let src: [u32; 0] = [];
    let dst = arena.alloc_slice_copy(&src);
    assert_eq!(dst.len(), 0);
}

#[test]
fn alloc_slice_uninit_zero_len() {
    let arena = Arena::new();
    let slice = arena.alloc_slice_uninit::<u32>(0);
    assert_eq!(slice.len(), 0);
}

#[cfg(feature = "stats")]
#[test]
fn zst_allocation_does_not_consume_space() {
    let arena = Arena::with_capacity(16);
    let stats_before = arena.stats();
    let _ = arena.alloc(());
    let stats_after = arena.stats();
    assert_eq!(stats_before.bytes_allocated, stats_after.bytes_allocated);
    assert_eq!(stats_before.bytes_used, stats_after.bytes_used);
    assert!(stats_after.allocation_count > stats_before.allocation_count);
}

#[cfg(not(any(feature = "thread_local", feature = "lockfree")))]
#[test]
fn multi_chunk_allocation_grows_arena() {
    // Create a small arena that will definitely require chunk growth
    let arena = Arena::with_capacity(32); // 32 bytes, rounded up to 64
    let _ = arena.alloc([0_u8; 32]); // Uses 32 bytes, leaves 32
    let stats_after_first = arena.stats();
    let _ = arena.alloc([0_u8; 40]); // Needs 40 bytes, only 32 left - should trigger new chunk
    let stats_after_second = arena.stats();
    assert!(stats_after_second.chunk_count >= 2);
    assert!(stats_after_second.bytes_allocated >= stats_after_first.bytes_allocated);
}

#[cfg(all(
    feature = "stats",
    not(any(feature = "thread_local", feature = "lockfree"))
))]
#[test]
fn scope_reclaims_allocations() {
    let arena = Arena::with_capacity(128);
    let before = arena.stats();

    arena.scope(|scope| {
        let _ = scope.alloc([0_u8; 32]);
        let _ = scope.alloc([0_u8; 32]);
        let during = arena.stats();
        assert!(during.bytes_used > before.bytes_used);
    });

    let after = arena.stats();
    assert_eq!(before.bytes_used, after.bytes_used);
    assert_eq!(before.allocation_count, after.allocation_count);
}