odox_core/
error.rs

1//! What can go wrong reading or writing a package.
2//
3// Author: David M. Anderson
4// Built with AI assistance (Claude, Anthropic)
5
6use std::fmt;
7
8/// A package that could not be read, or a document that could not be written.
9#[derive(Debug)]
10pub enum Error {
11    /// The bytes are not a zip archive, or an entry in one could not be read.
12    Package(String),
13    /// An entry the format requires is absent.
14    MissingPart(&'static str),
15    /// The XML in a named part is not well formed.
16    Xml {
17        /// Which entry of the package.
18        part: String,
19        /// What the parser said, with the position it said it at.
20        detail: String,
21    },
22    /// The package is a valid `OpenDocument` package of a kind this application
23    /// does not open. Carries the media type found, so the window can say which
24    /// of its siblings to reach for.
25    WrongFormat {
26        /// The media type the package declares.
27        found: String,
28        /// The media type this reader wanted.
29        wanted: &'static str,
30    },
31}
32
33impl fmt::Display for Error {
34    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
35        match self {
36            Self::Package(detail) => write!(f, "not a readable package: {detail}"),
37            Self::MissingPart(name) => write!(f, "the package has no {name}"),
38            Self::Xml { part, detail } => write!(f, "{part} is not well-formed XML: {detail}"),
39            Self::WrongFormat { found, wanted } => {
40                write!(f, "this is a {found} package, not a {wanted} one")
41            }
42        }
43    }
44}
45
46impl std::error::Error for Error {}
47
48impl From<zip::result::ZipError> for Error {
49    fn from(e: zip::result::ZipError) -> Self {
50        Self::Package(e.to_string())
51    }
52}
odox_core/error.rs

odox_core/
error.rs
