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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

use {
    serde::de,
    std::{
        fmt,
        io,
        str::Utf8Error,
    },
};

pub type Result<T> = std::result::Result<T, Error>;

/// The types of errors which can happen in our code
/// during deserialization
#[derive(Debug, Clone, PartialEq)]
pub enum ErrorCode {
    Eof,
    ExpectedBoolean,
    ExpectedInteger,
    ExpectedI8,
    ExpectedI16,
    ExpectedI32,
    ExpectedI64,
    ExpectedU8,
    ExpectedU16,
    ExpectedU32,
    ExpectedU64,
    ExpectedF32,
    ExpectedF64,
    ExpectedPositiveInteger,
    ExpectedString,
    ExpectedNull,
    ExpectedArray,
    ExpectedArrayComma,
    ExpectedArrayEnd,
    ExpectedMap,
    ExpectedMapColon,
    ExpectedMapComma,
    ExpectedMapEnd,
    ExpectedEnum,
    ExpectedSingleChar,
    InvalidEscapeSequence,
    TrailingCharacters,
    UnexpectedChar,
}

#[derive(Debug)]
#[non_exhaustive]
pub enum Error {

    /// a Hjson syntax error raised in our code,
    /// with location
    Syntax {
        line: usize,
        col: usize, // in chars (tab is one char)
        code: ErrorCode,
        at: String, // next few chars
    },

    /// A Serde error, with approximate location
    Serde {
        line: usize,
        col: usize, // in chars (tab is one char)
        message: String,
    },

    /// a raw Serde error. We should try to
    /// convert them to Serde located errors as
    /// much as possible
    RawSerde(String),

    /// an UTF8 error, raised when using from_slice
    /// with an invalid UTF8 slice
    Utf8(Utf8Error),

    /// an IO error, raised when using from_reader
    Io(io::Error),
}

impl Error {
    pub fn is_eof(&self) -> bool {
        matches!(self, Error::Syntax { code: ErrorCode::Eof, .. })
    }
}

impl de::Error for Error {
    fn custom<T: fmt::Display>(msg: T) -> Self {
        Error::RawSerde(msg.to_string())
    }
}

impl From<Utf8Error> for Error {
    fn from(source: Utf8Error) -> Self {
        Self::Utf8(source)
    }
}

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

impl fmt::Display for Error {
    fn fmt(&self, formatter: &mut fmt::Formatter) -> fmt::Result {
        match self {
            Self::Syntax { line, col, code, at } => {
                write!(formatter, "{:?} at {}:{} at {:?}", code, line, col, at)
            }
            Self::Serde { line, col, message } => {
                write!(formatter, "{:?} near {}:{}", message, line, col)
            }
            Self::RawSerde(msg) => {
                write!(formatter, "error message: {:?}", msg)
            }
            Self::Utf8(source) => {
                source.fmt(formatter)
            }
            Self::Io(source) => {
                source.fmt(formatter)
            }
        }
    }
}

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