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 std::{error::Error, io::Error as IOError, str::Utf8Error, string::FromUtf8Error};
use xmlparser::Error as ParserError;

#[derive(Debug)]
pub enum XmlError {
    IO(IOError),
    Parser(ParserError),
    Utf8(Utf8Error),
    UnexpectedEof,
    UnexpectedToken { token: String },
    TagMismatch { expected: String, found: String },
    MissingField { name: String, field: String },
    UnterminatedEntity { entity: String },
    UnrecognizedSymbol { symbol: String },
    FromStr(Box<dyn Error + Send + Sync>),
}

impl From<IOError> for XmlError {
    fn from(err: IOError) -> Self {
        XmlError::IO(err)
    }
}

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

impl From<FromUtf8Error> for XmlError {
    fn from(err: FromUtf8Error) -> Self {
        XmlError::Utf8(err.utf8_error())
    }
}

impl From<ParserError> for XmlError {
    fn from(err: ParserError) -> Self {
        XmlError::Parser(err)
    }
}

/// Specialized `Result` which the error value is `Error`.
pub type XmlResult<T> = Result<T, XmlError>;

impl Error for XmlError {
    fn source(&self) -> Option<&(dyn Error + 'static)> {
        use XmlError::*;
        match self {
            IO(e) => Some(e),
            Parser(e) => Some(e),
            Utf8(e) => Some(e),
            FromStr(e) => Some(e.as_ref()),
            _ => None,
        }
    }
}

impl std::fmt::Display for XmlError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        use XmlError::*;
        match self {
            IO(e) => write!(f, "I/O error: {}", e),
            Parser(e) => write!(f, "XML parser error: {}", e),
            Utf8(e) => write!(f, "invalid UTF-8: {}", e),
            UnexpectedEof => f.write_str("unexpected end of file"),
            UnexpectedToken { token } => write!(f, "unexpected token in XML: {:?}", token),
            TagMismatch { expected, found } => write!(
                f,
                "mismatched XML tag; expected {:?}, found {:?}",
                expected, found
            ),
            MissingField { name, field } => {
                write!(f, "missing field in XML of {:?}: {:?}", name, field)
            }
            UnterminatedEntity { entity } => write!(f, "unterminated XML entity: {}", entity),
            UnrecognizedSymbol { symbol } => write!(f, "unrecognized XML symbol: {}", symbol),
            FromStr(e) => write!(f, "error parsing XML value: {}", e),
        }
    }
}