Struct Engine 

pub struct Engine { /* private fields */ }

Dispatches extract calls to the registered Extractor for the file’s extension. Construct with Engine::new for an empty engine, or Engine::with_defaults to populate the defaults that match enabled feature flags.

Implementations

impl Engine

pub fn new() -> Self

New engine with no extractors registered. Useful when you want full control over the backend set.

pub fn with_defaults() -> Self

New engine with the default backends for the enabled feature flags. Backends register themselves silently — if a backend can’t initialize (e.g. libpdfium isn’t on the system library path for the pdf feature), it’s skipped rather than failing the whole construction. Use with_defaults_diagnostic if you want to surface those failures to the user.

pub fn with_defaults_diagnostic() -> (Self, Vec<(&'static str, Error)>)

Like with_defaults but returns the list of backend-init errors alongside the engine, so callers can log “PDF support disabled: libpdfium not found” rather than silently shipping a degraded experience.

pub fn register(&mut self, extractor: Box<dyn Extractor>) -> &mut Self

Register a backend. Multiple backends can claim the same extension; the first registered wins on dispatch (so you can override defaults by registering your own extractor first).

pub fn len(&self) -> usize

Returns the number of registered extractors.

pub fn is_empty(&self) -> bool

Returns true when no extractors are registered.

pub fn extract(&self, path: &Path) -> Result<Document>

Extract path to markdown, dispatching by file extension. Returns Error::UnsupportedFormat if no registered extractor claims the extension.

pub fn extract_bytes(&self, bytes: &[u8], ext: &str) -> Result<Document>

Same as extract but takes bytes + an explicit extension. Backends that don’t implement Extractor::extract_bytes return Error::UnsupportedOperation.

Trait Implementations

impl Default for Engine

fn default() -> Self

Returns the “default value” for a type.