xberg-libwpd 1.0.2

WordPerfect (.wpd) text extraction for Xberg via libwpd + librevenge, built from vendored source (MPL-2.0 arm)
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

use thiserror::Error;

/// Errors returned when extracting a WordPerfect document.
#[derive(Error, Debug)]
pub enum WpdError {
    /// The input buffer was empty or a null pointer reached the shim.
    #[error("invalid arguments passed to libwpd shim")]
    InvalidArgs,

    /// The buffer is not a WordPerfect document libwpd recognizes.
    #[error("not a supported WordPerfect document")]
    UnsupportedFormat,

    /// libwpd recognized the format but failed to parse the document.
    #[error("libwpd failed to parse the document")]
    ParseError,

    /// The shim could not allocate the output buffer.
    #[error("out of memory while extracting text")]
    OutOfMemory,

    /// A C++ exception was caught at the FFI boundary.
    #[error("libwpd raised an unexpected error")]
    Internal,

    /// The document is encrypted or password-protected; libwpd cannot parse
    /// it without a matching password, which this crate never supplies. This
    /// is distinct from `ParseError` so a caller can tell "needs a password"
    /// from "the file is corrupt".
    #[error("libwpd document is encrypted or password-protected")]
    Encrypted,

    /// The extracted text was not valid UTF-8.
    #[error("libwpd returned invalid UTF-8")]
    InvalidUtf8,

    /// WordPerfect extraction is not available on this platform.
    #[error("WordPerfect extraction is not supported on this platform")]
    UnsupportedPlatform,
}

#[cfg(any(target_os = "linux", target_os = "macos", target_os = "windows"))]
impl WpdError {
    /// Map a shim result code (see `shim.cpp`) to an error. Code 0 is success
    /// and has no error representation.
    pub(crate) fn from_code(code: i32) -> Self {
        match code {
            1 => WpdError::InvalidArgs,
            2 => WpdError::UnsupportedFormat,
            3 => WpdError::ParseError,
            4 => WpdError::OutOfMemory,
            6 => WpdError::Encrypted,
            _ => WpdError::Internal,
        }
    }
}