human-units 0.5.3

Units serialization and formatting library designed for configuration files and command line arguments
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

use crate::iec::iec_unit;

macro_rules! define_units {
    { $((
        $name: ident
        $symbol: literal
        $description: literal
    ))* } => {
        $(
            #[doc = $description]
            #[iec_unit(symbol = $symbol, internal)]
            pub struct $name(pub u64);
        )*
    };
}

define_units! {
    // Information.
    (Bit "bit" "The basic unit of information.")
    (Byte "B" "The unit of information.")
    (Octet "o" "The unit of information equal to 8 bits.")
    (Shannon "Sh" "The unit of information.")
    (Nat "Nat" "The natural unit of information.")
    (Hartley "Hart" "The logarithmic unit of information.")
    (Erlang "E" "Traffic intensity in percentage per hour.")
    (Baud "Bd" "Modulation rate in symbols per second.")
}

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

    extern crate alloc;

    #[allow(deprecated)]
    #[test]
    fn from_iec_works() {
        let size = Byte::from_iec(1536 * 1024);
        assert_eq!("1536 KiB", size.to_string());
        assert_eq!("1.5 MiB", size.format_iec().to_string());
    }
}