cesr-rs 0.1.1

CESR + KERI primitives for Rust as a single feature-gated, no_std-capable crate
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

use crate::core::matter::code::NumberCode;

/// An unsigned integer with an automatically selected CESR number code.
pub struct Number {
    code: NumberCode,
    value: u128,
}

impl Number {
    /// Creates a `Number` choosing the smallest code that fits `value`.
    #[must_use]
    pub const fn new(value: u128) -> Self {
        let code = NumberCode::for_value(value);
        Self { code, value }
    }

    /// Creates a `Number` with an explicitly specified code.
    #[must_use]
    pub const fn with_code(code: NumberCode, value: u128) -> Self {
        Self { code, value }
    }

    /// Returns the CESR number code for this value.
    #[must_use]
    pub const fn code(&self) -> &NumberCode {
        &self.code
    }

    /// Returns the raw integer value.
    #[must_use]
    pub const fn value(&self) -> u128 {
        self.value
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::core::matter::code::NumberCode;

    #[test]
    fn number_picks_smallest_code() {
        let n_short = Number::new(255);
        assert_eq!(*n_short.code(), NumberCode::Short);
        assert_eq!(n_short.value(), 255);

        let n_long = Number::new(0xFFFF_FFFF);
        assert_eq!(*n_long.code(), NumberCode::Long);

        let n_big = Number::new(u128::from(u64::MAX));
        assert_eq!(*n_big.code(), NumberCode::Big);
    }

    #[test]
    fn number_zero() {
        let n = Number::new(0);
        assert_eq!(*n.code(), NumberCode::Short);
        assert_eq!(n.value(), 0);
    }
}