starshard 2.3.0

A blazing-fast sharded concurrent HashMap using hashbrown and RwLock, with lazy shards, atomic length cache, async support, conditional operations, batch operations, TTL/metrics/transactions.
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

// Example: v1.2.0 Lifecycle Utilities (Per-shard load, memory stats, drain)
// Run with: cargo run --example v090_lifecycle --features "lifecycle"

#[cfg(feature = "lifecycle")]
use starshard::ShardedHashMap;

#[cfg(not(feature = "lifecycle"))]
fn main() {
    println!("This example requires the 'lifecycle' feature.");
    println!("Run with: cargo run --example v090_lifecycle --features \"lifecycle\"");
}

#[cfg(feature = "lifecycle")]
fn main() {
    println!("=== Starshard v1.2.0: Lifecycle Utilities ===\n");

    println!("1. Per-shard load");
    per_shard_load_example();

    println!("\n2. Memory stats");
    memory_stats_example();

    println!("\n3. Drain operation");
    drain_example();
}

#[cfg(feature = "lifecycle")]
fn per_shard_load_example() {
    let map: ShardedHashMap<String, i32> = ShardedHashMap::new(8);
    for i in 0..20 {
        map.insert(format!("user:{i}"), i);
    }

    let mut loads = map.per_shard_load();
    loads.sort_by_key(|x| x.shard_idx);

    println!("  Initialized shards: {}", loads.len());
    for load in loads.iter().take(3) {
        println!(
            "    shard={} entries={} capacity={}",
            load.shard_idx, load.entry_count, load.capacity
        );
    }
}

#[cfg(feature = "lifecycle")]
fn memory_stats_example() {
    let map: ShardedHashMap<String, i32> = ShardedHashMap::new(4);
    for i in 0..100 {
        map.insert(format!("k{}", i), i);
    }

    let stats = map.memory_stats();
    println!("  shards_allocated={}", stats.shards_allocated);
    println!("  total_capacity={}", stats.total_capacity);
    println!("  load_factor={:.3}", stats.load_factor);
}

#[cfg(feature = "lifecycle")]
fn drain_example() {
    let map: ShardedHashMap<String, i32> = ShardedHashMap::new(4);
    for i in 0..6 {
        map.insert(format!("job-{i}"), i);
    }

    println!("  Before drain: len={}", map.len());
    let drained: Vec<_> = map.drain().collect();
    println!("  Drained {} entries", drained.len());
    println!("  After drain: len={}", map.len());
}