size 0.5.0

A crate for expressing, formatting, and interacting with file 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

// Work around https://github.com/rust-lang/cargo/issues/9208
#[cfg(not(feature = "serde"))]
fn main() {
    panic!("Requisite feature is not enabled!")
}

#[cfg(feature = "serde")]
fn main() {
    use serde::{Deserialize, Serialize};
    use size::consts::*; // Import consts like KB, MiB, etc.
    use size::Size; // Core type for all size operations

    // Flexible construction options
    let s = Size::from_bytes(440 * KB) + Size::from_mib(12.9);
    println!("The pretty file size {s}"); // 13.3 MiB

    // Mathematical operations on sizes and scalar values
    let double = Size::from_kb(0.668) * 2 + Size::from_bytes(1);
    assert_eq!(double.bytes(), 1337);

    // Parse sizes from strings in almost any format
    let parsed = Size::from_str("43.008 KB").unwrap();
    assert_eq!(Size::from_kib(42.0), parsed);

    #[derive(Debug, Deserialize, Serialize)]
    struct File {
        name: String,
        size: Size,
        disk_size: Size,
    }

    // Serialize and and deserialize from byte values or strings
    let _: File = serde_json::from_str(
        r#"{
            "name": "Hello.txt",
            "size": "12.92 gigabytes",
            "disk_size": 12920000000
        }"#,
    )
    .unwrap();
}