postbag 0.4.3

Postbag is a high-performance serde codec for Rust that provides efficient data encoding with configurable levels of forward and backward compatibility.
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

use std::fmt::{Display, Formatter};

/// Error of Postbag operations.
#[derive(Debug)]
#[non_exhaustive]
pub enum Error {
    /// [`deserialize_any`](serde::de::Deserializer::deserialize_any) is unsupported
    DeserializeAnyUnsupported,
    /// End of block
    EndOfBlock,
    /// Found a varint that didn't terminate
    BadVarint,
    /// Found an invalid bool
    BadBool,
    /// Found an invalid UTF-8 char
    BadChar,
    /// Found an invalid UTF-8 string
    BadString,
    /// Found an invalid Option discriminant
    BadOption,
    /// Found an invalid enum discriminant
    BadEnum,
    /// Bad length of a sequence or map
    BadLen,
    /// Bad identifier
    BadIdentifier,
    /// Overflow of target usize
    UsizeOverflow,
    /// Serde custom error
    Custom(String),
    /// I/O error.
    Io(std::io::Error),
}

impl From<std::io::Error> for Error {
    fn from(err: std::io::Error) -> Self {
        Self::Io(err)
    }
}

impl From<Error> for std::io::Error {
    fn from(err: Error) -> Self {
        use std::io::ErrorKind;

        if let Error::Io(err) = err {
            return err;
        }

        let kind = match &err {
            Error::DeserializeAnyUnsupported => ErrorKind::Unsupported,
            Error::EndOfBlock => ErrorKind::UnexpectedEof,
            _ => ErrorKind::InvalidData,
        };

        std::io::Error::new(kind, err)
    }
}

impl Display for Error {
    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
        use Error::*;
        match self {
            DeserializeAnyUnsupported => write!(f, "deserialize_any is unsupported"),
            EndOfBlock => write!(f, "end of block"),
            BadVarint => write!(f, "invalid integer"),
            BadBool => write!(f, "invalid bool"),
            BadChar => write!(f, "invalid char"),
            BadString => write!(f, "invalid string"),
            BadOption => write!(f, "invalid option"),
            BadIdentifier => write!(f, "invalid identifier"),
            BadEnum => write!(f, "invalid enum discriminant"),
            BadLen => write!(f, "invalid length"),
            UsizeOverflow => write!(f, "usize overflow"),
            Custom(msg) => write!(f, "serde error: {msg}"),
            Io(err) => write!(f, "IO error: {err}"),
        }
    }
}

impl serde::ser::Error for Error {
    fn custom<T>(msg: T) -> Self
    where
        T: Display,
    {
        Error::Custom(msg.to_string())
    }
}

impl serde::de::Error for Error {
    fn custom<T>(msg: T) -> Self
    where
        T: Display,
    {
        Error::Custom(msg.to_string())
    }
}

impl std::error::Error for Error {}

/// Result of Postbag operations.
pub type Result<T> = std::result::Result<T, Error>;