sizes 0.1.3

A crate to format byte sizes
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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

#![no_std]

use core::fmt;

pub const B: u64 = 1;
pub const KB: u64 = 1000 * B;
pub const MB: u64 = 1000 * KB;
pub const GB: u64 = 1000 * MB;
pub const TB: u64 = 1000 * GB;
pub const PB: u64 = 1000 * TB;
pub const EB: u64 = 1000 * PB;
pub const ZB: u128 = 1000 * EB as u128;
pub const YB: u128 = 1000 * ZB;

pub const KIB: u64 = 1024 * B;
pub const MIB: u64 = 1024 * KIB;
pub const GIB: u64 = 1024 * MIB;
pub const TIB: u64 = 1024 * GIB;
pub const PIB: u64 = 1024 * TIB;
pub const EIB: u64 = 1024 * PIB;
pub const ZIB: u128 = 1024 * EIB as u128;
pub const YIB: u128 = 1024 * ZIB;

/// Represents size in bytes as per IEC 80000-13
pub struct BinarySize(pub u128);
/// Represents size in bytes as per IEC 80000-13, rounded to the
/// given decimal places when displayed
pub struct RoundedBinarySize(pub u128, pub u8);

impl fmt::Display for BinarySize {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            s if s.0 as u128 >= YIB => write!(f, "{} YiB", s.0 as u128 / YIB),
            s if s.0 as u128 >= ZIB => write!(f, "{} ZiB", s.0 as u128 / ZIB),
            s if s.0 as u128 >= EIB as u128 => write!(f, "{} EiB", s.0 as u128 / EIB as u128),
            s if s.0 as u64 >= PIB => write!(f, "{} PiB", s.0 as u64 / PIB),
            s if s.0 as u64 >= TIB => write!(f, "{} TiB", s.0 as u64 / TIB),
            s if s.0 as u64 >= GIB => write!(f, "{} GiB", s.0 as u64 / GIB),
            s if s.0 as u64 >= MIB => write!(f, "{} MiB", s.0 as u64 / MIB),
            s if s.0 as u64 >= KIB => write!(f, "{} KiB", s.0 as u64 / KIB),
            _ => write!(f, "{} B", self.0)
        }
    }
}

impl BinarySize {
    /// Returns an instance of RoundedBinarySize that rounds to as many
    /// decimal places as specified in `decimal_places` upon display
    pub fn rounded_to(self, decimal_places: u8) -> RoundedBinarySize {
        RoundedBinarySize(self.0, decimal_places)
    }

    /// Returns an instance of RoundedBinarySize that rounds to 2 decimal
    /// places upon display.
    ///
    /// Example:
    ///
    /// ```rust
    /// BinarySize::from(1024_u64).rounded()
    /// ```
    pub fn rounded(self) -> RoundedBinarySize {
        self.rounded_to(2)
    }
}

impl From<u128> for BinarySize {
    fn from(value: u128) -> Self {
        Self(value)
    }
}

impl From<u64> for BinarySize {
    fn from(value: u64) -> Self {
        Self(value as u128)
    }
}

impl From<u32> for BinarySize {
    fn from(value: u32) -> Self {
        Self(value as u128)
    }
}

impl From<u16> for BinarySize {
    fn from(value: u16) -> Self {
        Self(value as u128)
    }
}

impl From<u8> for BinarySize {
    fn from(value: u8) -> Self {
        Self(value as u128)
    }
}

impl From<usize> for BinarySize {
    fn from(value: usize) -> Self {
        Self(value as u128)
    }
}

impl fmt::Display for RoundedBinarySize {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            s if s.0 as u64 >= PIB => write!(f, "{:.dp$}", s.0 as f64 / PIB as f64, dp=s.1 as usize),
            s if s.0 as u64 >= TIB => write!(f, "{:.dp$} TiB", s.0 as f64 / TIB as f64, dp=s.1 as usize),
            s if s.0 as u64 >= GIB => write!(f, "{:.dp$} GiB", s.0 as f64 / GIB as f64, dp=s.1 as usize),
            s if s.0 as u64 >= MIB => write!(f, "{:.dp$} MiB", s.0 as f64 / MIB as f64, dp=s.1 as usize),
            s if s.0 as u64 >= KIB => write!(f, "{:.dp$} KiB", s.0 as f64 / KIB as f64, dp=s.1 as usize),
            _ => write!(f, "{} B", self.0)
        }
    }
}