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

use std;
use trackable::error::{ErrorKind as TrackableErrorKind, ErrorKindExt};
use trackable::error::{Failure, TrackableError};

/// This crate specific `Error` type.
#[derive(Debug, Clone)]
pub struct Error(TrackableError<ErrorKind>);
derive_traits_for_trackable_error_newtype!(Error, ErrorKind);
impl From<Failure> for Error {
    fn from(f: Failure) -> Self {
        ErrorKind::Other.takes_over(f).into()
    }
}
impl From<std::io::Error> for Error {
    fn from(f: std::io::Error) -> Self {
        let kind = if f.kind() == std::io::ErrorKind::UnexpectedEof {
            ErrorKind::UnexpectedEos
        } else {
            ErrorKind::Other
        };
        kind.cause(f).into()
    }
}

/// Possible error kinds.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum ErrorKind {
    /// Input is invalid.
    ///
    /// Usually it indicates there is a problem outside of the encoder/decoder.
    InvalidInput,

    /// Inconsistent state of the encoder/decoder.
    ///
    /// Usually it indicates there is a bug in the encoder/decoder.
    InconsistentState,

    /// Unexpected EOS.
    ///
    /// A target stream has reached EOS despite there are some items to be encoded/decoded.
    UnexpectedEos,

    /// Encoder is full.
    ///
    /// The encoder cannot accept more items because it has some items to be encoded currently.
    EncoderFull,

    /// Decoder has terminated.
    ///
    /// The decoder cannot decode any more items.
    DecoderTerminated,

    /// A decoding process terminated incompletely.
    IncompleteDecoding,

    /// Other errors.
    Other,
}
impl TrackableErrorKind for ErrorKind {}