byte-unit 5.2.0

A library for interacting with units of bytes.
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

use core::{
    fmt::{self, Formatter},
    str::FromStr,
};

use serde::{
    self,
    de::{Error as DeError, Unexpected, Visitor},
    Deserialize, Deserializer, Serialize, Serializer,
};

use super::Byte;
#[cfg(feature = "u128")]
use super::RONNABYTE;

impl Serialize for Byte {
    #[inline]
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: Serializer, {
        if serializer.is_human_readable() {
            serializer.serialize_str(format!("{self:#}").as_str())
        } else {
            serializer.serialize_u128(self.as_u128())
        }
    }
}

impl<'de> Deserialize<'de> for Byte {
    #[inline]
    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
    where
        D: Deserializer<'de>, {
        struct MyVisitor;

        impl<'de> Visitor<'de> for MyVisitor {
            type Value = Byte;

            #[inline]
            fn expecting(&self, f: &mut Formatter<'_>) -> fmt::Result {
                f.write_str("a string such as \"123\", \"123KiB\", \"50.84 MB\", or ")?;

                #[cfg(feature = "u128")]
                {
                    f.write_fmt(format_args!("a positive integer smaller than {RONNABYTE}"))
                }

                #[cfg(not(feature = "u128"))]
                {
                    f.write_fmt(format_args!(
                        "a positive integer smaller than {}",
                        u64::MAX as u128 + 1
                    ))
                }
            }

            #[inline]
            fn visit_u128<E>(self, v: u128) -> Result<Self::Value, E>
            where
                E: DeError, {
                Byte::from_u128(v).ok_or_else(|| {
                    DeError::invalid_value(Unexpected::Other(format!("{v}").as_str()), &self)
                })
            }

            #[inline]
            fn visit_str<E>(self, v: &str) -> Result<Self::Value, E>
            where
                E: DeError, {
                Byte::from_str(v).map_err(DeError::custom)
            }
        }

        if deserializer.is_human_readable() {
            deserializer.deserialize_str(MyVisitor)
        } else {
            deserializer.deserialize_u128(MyVisitor)
        }
    }
}