size-display 0.1.4

Display file sizes in human-readable form
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

//! Display human readable file sizes.
//!
//! # Limitation
//!
//! Displayed units go up to Exabyte (2^60).
//!
//! # Example
//!
//! ```
//! use size_display::Size;
//!
//! assert_eq!("24", format!("{}", Size(24)));
//! assert_eq!("4.2G", format!("{:.1}", Size(4509715660)));
//! ```

use std::fmt;

pub const KILO: u64 = 1024;
pub const MEGA: u64 = KILO * KILO;
pub const GIGA: u64 = MEGA * KILO;
pub const TERA: u64 = GIGA * KILO;
pub const PETA: u64 = TERA * KILO;
pub const EXA: u64 = PETA * KILO;

/// File size type with human-readable [`Display`].
///
/// [`Display`]: https://doc.rust-lang.org/std/fmt/trait.Display.html
pub struct Size(pub u64);

impl fmt::Debug for Size {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        <Self as fmt::Display>::fmt(self, f)
    }
}

impl fmt::Display for Size {
    #[inline]
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        let bytes = self.0;

        let (unit, char) = match bytes {
            e if e >= EXA => (EXA, "E"),
            p if p >= PETA => (PETA, "P"),
            t if t >= TERA => (TERA, "T"),
            g if g >= GIGA => (GIGA, "G"),
            m if m >= MEGA => (MEGA, "M"),
            k if k >= KILO => (KILO, "K"),
            _ => (1, ""),
        };

        match bytes % unit {
            0 => <u64 as fmt::Display>::fmt(&(bytes / unit), f),
            _ => <f64 as fmt::Display>::fmt(&(bytes as f64 / unit as f64), f),
        }?;

        if char != "" {
            write!(f, "{}", char)?;
        }

        Ok(())
    }
}