rdocx 0.16.0

High-level API for reading, writing, and converting DOCX documents
Documentation 
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

//! Error types for the rdocx high-level API.

use thiserror::Error;

#[derive(Debug, Error)]
pub enum Error {
    #[error("OPC package error: {0}")]
    Opc(#[from] oxml_opc::OpcError),

    #[error("OXML parsing error: {0}")]
    Oxml(#[from] rdocx_oxml::OxmlError),

    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),

    #[error("layout error: {0}")]
    Layout(#[from] oxml_layout::LayoutError),

    #[error("PDF conformance error: {0}")]
    Pdf(#[from] oxml_pdf::PdfError),

    #[error("raster export error: {0}")]
    Raster(#[from] oxml_pdf::RasterError),

    #[error("document has no main document part")]
    NoDocumentPart,

    #[error("image dimensions are unavailable for {filename}")]
    UnavailableImageDimensions { filename: String },

    #[error("RTF parse error at byte {offset}: {message}")]
    Rtf { offset: usize, message: String },

    #[error("HTML import error at {location}: {message}")]
    Html { location: String, message: String },

    #[error("MHTML error in {part:?} at byte {offset}: {message}")]
    Mhtml {
        part: Option<String>,
        offset: u64,
        message: String,
    },

    #[error("ODT import error in {part:?} at byte {offset}: {message}")]
    Odt {
        part: Option<String>,
        offset: u64,
        message: String,
    },

    #[error("{operation} failed: {message}")]
    InvalidEmbeddedMutation {
        operation: &'static str,
        message: String,
    },

    #[error("story location error: {0}")]
    Story(#[from] crate::document::StoryError),

    #[error("{0}")]
    Other(String),
}

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

#[cfg(test)]
mod tests {
    use super::Error;

    #[test]
    fn layout_error_wraps_the_shared_layout_error() {
        let shared = oxml_layout::LayoutError::Layout("shared failure".to_string());
        let error = Error::from(shared);
        assert!(matches!(
            error,
            Error::Layout(oxml_layout::LayoutError::Layout(message))
                if message == "shared failure"
        ));
    }
}