ps-uuid 0.1.0-0

An opinionated UUID implementation.
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

use rand::fill;

use crate::NodeId;

impl NodeId {
    /// Generates a random [`NodeId`] with the multicast bit set.
    #[must_use]
    pub fn random() -> Self {
        let mut bytes = [0u8; 6];

        fill(&mut bytes);

        // Set the multicast bit (least significant bit of the first byte)
        bytes[0] |= 0x01;

        Self { bytes }
    }
}

#[cfg(test)]
mod tests {
    use crate::NodeId;

    #[test]
    fn unique() {
        let list: Vec<NodeId> = (0..10).map(|_| NodeId::random()).collect();

        for (index, item) in list.iter().enumerate() {
            let loop_index = list.iter().position(|loop_item| loop_item == item);

            assert_eq!(Some(index), loop_index, "Each node_id should be unique!");
        }
    }

    #[test]
    fn multicast_bit_is_set() {
        for _ in 0..100 {
            let node = NodeId::random();
            assert_eq!(
                node.bytes[0] & 0x01,
                0x01,
                "Multicast bit (LSB of first byte) must be set"
            );
        }
    }
}