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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

#![allow(deprecated)]

use crate::si::si_unit;

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

define_units! {
    // Base units
    (Time "s" "Time.")
    (Length "m" "Length.")
    (Mass "g" "Mass.")
    (ElectricCurrent "A" "Electric current.")
    (ThermodynamicTemperature "K" "Thermodynamic temperature.")
    (AmountOfSubstance "mol" "Amount of substance.")
    (LuminousIntensity "cd" "Luminous intensity.")
    // Derived units.
    (PlaneAngle "rad" "Plane angle.")
    (SolidAngle "sr" "Solid angle.")
    (Frequency "Hz" "Frequency.")
    (Force "N" "Force.")
    (Pressure "Pa" "Pressure.")
    (Energy "J" "Energy.")
    (Power "W" "Power.")
    (ElectricCharge "C" "Electric charge.")
    (Voltage "V" "Voltage.")
    (Capacitance "F" "Capacitance.")
    (ElectricConductance "S" "Electric conductance.")
    (MagneticFlux "Wb" "Magnetic flux.")
    (MagneticFluxDensity "T" "Magnetic flux density.")
    (Inductance "H" "Inductance.")
    (CelsiusTemperature "°C" "Celsius temperature.")
    (LuminousFlux "lm" "Luminous flux.")
    (Illuminance "lx" "Illuminance.")
    (Radioactivity "Bq" "Radioactivity.")
    (AbsorbedDose "Gy" "Absorbed dose.")
    (DoseEquivalent "Sy" "Dose equivalent.")
    (CatalyticActivity "kat" "Catalytic activity.")
}

#[cfg(feature = "unicode")]
define_units! {
    (ElectricResistance "Ω" "Electric resistance.")
}

#[cfg(not(feature = "unicode"))]
define_units! {
    (ElectricResistance "ohm" "Electric resistance.")
}

/// Data size.
#[si_unit(symbol = "B", min_prefix = "", max_prefix = "exa", internal)]
pub struct Size(pub u64);

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

    extern crate alloc;

    #[test]
    fn from_si_works() {
        let cpu_freq = Frequency::from_si(2_200_000_000);
        assert_eq!("2200 MHz", cpu_freq.to_string());
        assert_eq!("2.2 GHz", cpu_freq.format_si().to_string());
    }

    #[test]
    fn size_works() {
        let size = Size::from_si(1_536_000);
        assert_eq!("1536 kB", size.to_string());
        assert_eq!("1.5 MB", size.format_si().to_string());
    }
}