tnid 0.2.0

A UUID compatible ID with static type checking
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

use crate::NameStr;
use crate::name_encoding;
use crate::utils;

/// Mask for the 100 random bits in a V1 TNID.
pub const RANDOM_MASK: u128 = 0x00000fff_ffff_0fff_0fff_ffffffffffff;

/// Places the random bits into their specific scattered positions for a V1 TNID.
pub fn random_bits_mask(random: u128) -> u128 {
    random & RANDOM_MASK
}

/// Creates a 128-bit V1 ID from its component parts.
pub fn make_from_parts(name: NameStr, random: u128) -> u128 {
    let mut id = 0u128;

    id |= name_encoding::name_mask(name);
    id |= utils::uuid_and_variant_mask(1);
    id |= random_bits_mask(random);

    id
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn random_mask() {
        let mask = random_bits_mask(u128::MAX);

        assert_eq!(mask.count_ones(), 100);
        assert_eq!(mask.leading_zeros(), 20);
        assert_eq!(mask.trailing_ones(), 60);
    }
}