hard_xml/
xml_error.rs

1use std::{error::Error, io::Error as IOError, str::Utf8Error, string::FromUtf8Error};
2use xmlparser::Error as ParserError;
3
4#[derive(Debug)]
5pub enum XmlError {
6    IO(IOError),
7    Parser(ParserError),
8    Utf8(Utf8Error),
9    UnexpectedEof,
10    UnexpectedToken { token: String },
11    TagMismatch { expected: String, found: String },
12    MissingField { name: String, field: String },
13    UnknownField { name: String, field: String },
14    UnterminatedEntity { entity: String },
15    UnrecognizedSymbol { symbol: String },
16    FromStr(Box<dyn Error + Send + Sync>),
17}
18
19impl From<IOError> for XmlError {
20    fn from(err: IOError) -> Self {
21        XmlError::IO(err)
22    }
23}
24
25impl From<Utf8Error> for XmlError {
26    fn from(err: Utf8Error) -> Self {
27        XmlError::Utf8(err)
28    }
29}
30
31impl From<FromUtf8Error> for XmlError {
32    fn from(err: FromUtf8Error) -> Self {
33        XmlError::Utf8(err.utf8_error())
34    }
35}
36
37impl From<ParserError> for XmlError {
38    fn from(err: ParserError) -> Self {
39        XmlError::Parser(err)
40    }
41}
42
43/// Specialized `Result` which the error value is `Error`.
44pub type XmlResult<T> = Result<T, XmlError>;
45
46impl Error for XmlError {
47    fn source(&self) -> Option<&(dyn Error + 'static)> {
48        use XmlError::*;
49        match self {
50            IO(e) => Some(e),
51            Parser(e) => Some(e),
52            Utf8(e) => Some(e),
53            FromStr(e) => Some(e.as_ref()),
54            _ => None,
55        }
56    }
57}
58
59impl std::fmt::Display for XmlError {
60    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
61        use XmlError::*;
62        match self {
63            IO(e) => write!(f, "I/O error: {}", e),
64            Parser(e) => write!(f, "XML parser error: {}", e),
65            Utf8(e) => write!(f, "invalid UTF-8: {}", e),
66            UnexpectedEof => f.write_str("unexpected end of file"),
67            UnexpectedToken { token } => write!(f, "unexpected token in XML: {:?}", token),
68            TagMismatch { expected, found } => write!(
69                f,
70                "mismatched XML tag; expected {:?}, found {:?}",
71                expected, found
72            ),
73            MissingField { name, field } => {
74                write!(f, "missing field in XML of {:?}: {:?}", name, field)
75            }
76            UnknownField { name, field } => {
77                write!(f, "unknown field {:?} in element {:?}", field, name)
78            }
79            UnterminatedEntity { entity } => write!(f, "unterminated XML entity: {}", entity),
80            UnrecognizedSymbol { symbol } => write!(f, "unrecognized XML symbol: {}", symbol),
81            FromStr(e) => write!(f, "error parsing XML value: {}", e),
82        }
83    }
84}
hard_xml/xml_error.rs

hard_xml/
xml_error.rs
