txmap 1.1.0

A concurrent transactional hash map for Rust with fine-grained locking, internal mutability and composable 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

#[cfg(test)]
pub(crate) mod creators {
    use crate::{
        shard_count::ShardCount,
        tests::data::data::{ALICE, BOB, CHUCK, DAVE},
        tx_map::TxMap,
    };
    use rand::seq::SliceRandom;
    use std::hash::Hash;

    pub(crate) fn empty_typed_map<K, V>() -> TxMap<K, V>
    where
        K: Hash + Eq,
    {
        TxMap::new(ShardCount::_8)
    }

    pub(crate) fn empty_map() -> TxMap<String, u64> {
        TxMap::new(ShardCount::_8)
    }

    pub(crate) fn map_alice(alice: u64) -> TxMap<String, u64> {
        let map = empty_typed_map();
        map.insert(ALICE.into(), alice);
        map
    }

    pub(crate) fn map_alice_bob(alice: u64, bob: u64) -> TxMap<String, u64> {
        let map = empty_typed_map();
        map.insert(ALICE.into(), alice);
        map.insert(BOB.into(), bob);
        map
    }

    pub(crate) fn map_alice_bob_chuck(alice: u64, bob: u64, chuck: u64) -> TxMap<String, u64> {
        let map = empty_typed_map();
        map.insert(ALICE.into(), alice);
        map.insert(BOB.into(), bob);
        map.insert(CHUCK.into(), chuck);
        map
    }

    pub(crate) fn map_alice_bob_chuck_dave(
        alice: u64,
        bob: u64,
        chuck: u64,
        dave: u64,
    ) -> TxMap<String, u64> {
        let map = empty_typed_map();
        map.insert(ALICE.into(), alice);
        map.insert(BOB.into(), bob);
        map.insert(CHUCK.into(), chuck);
        map.insert(DAVE.into(), dave);
        map
    }

    pub(crate) fn random_names<const C: usize>() -> [String; C] {
        assert!(C <= 4);
        let rng = &mut rand::rng();
        let mut vec = vec![ALICE.into(), BOB.into(), CHUCK.into(), DAVE.into()];
        vec.shuffle(rng);
        vec.truncate(C);
        vec.try_into().unwrap()
    }
}