Enum Error 

#[non_exhaustive]
pub enum Error {
    Io(Error),
    UnsupportedFormat(String),
    UnsupportedOperation(String),
    ParseError(String),
    MissingDependency {
        name: String,
        details: String,
    },
    SidecarFailure {
        name: String,
        code: Option<i32>,
        stderr: String,
    },
    Other(String),
}

Errors that can arise during extraction.

The variants are intentionally coarse-grained — a ParseError from the Pandoc backend and a ParseError from pdfium-render look the same to the caller, distinguished only by the message string. If you need fine-grained failure routing, dispatch on Extractor::name when constructing the engine, or wrap a backend with your own error mapping.

Marked #[non_exhaustive] so future minor versions can add new variants (e.g. a dedicated EncryptedDocument for password- protected PDFs) without breaking downstream match blocks. Callers that pattern-match should always include a wildcard arm.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Io(Error)

Filesystem failure: file missing, permission denied, EOF, etc.

UnsupportedFormat(String)

The file extension has no registered extractor on this engine.

UnsupportedOperation(String)

A specific extractor doesn’t support the operation (typically extract_bytes on a backend that only handles file paths).

ParseError(String)

Backend-specific parse failure. The string is the backend’s error message verbatim.

MissingDependency

A required external dependency (Pandoc binary, Tesseract, ONNX model file) is missing or unusable. name is the dependency label; details is the underlying error.

Fields

name: String

Human-readable dependency name ("pandoc", "libpdfium.dylib").

details: String

Underlying error or the path that was checked.

SidecarFailure

A sidecar process exited with a non-zero status. code is the exit code if known.

Fields

name: String

Backend name (e.g. "pandoc").

code: Option<i32>

Exit code if the process exited normally; None if killed by signal.

stderr: String

Captured stderr, truncated to a sensible length by the caller before being attached.

Other(String)

Catch-all for backends that need to surface something the other variants don’t capture.

Implementations

impl Error

pub fn parse(msg: impl Into<String>) -> Self

Convenience constructor for Error::ParseError.

pub fn other(msg: impl Into<String>) -> Self

Convenience constructor for Error::Other.

Trait Implementations

impl Debug for Error

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Error

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.