docuparse 0.0.2

Document extraction and parsing — PDF text, rendering, and OCR
Documentation
use pdfium_render::prelude::PdfPageIndex;

use crate::{
    PdfDocument,
    error::{PdfError, TextError},
};

impl<'p> PdfDocument<'p> {
    /// Extract the native text layer from a page.
    ///
    /// Returns `Ok(None)` if the page exists but has no text layer (e.g. scanned image).
    /// Returns `Err` if the page index is out of range or pdfium fails.
    pub fn extract_text_layer(&self, page_index: u32) -> Result<Option<String>, PdfError> {
        let page = self
            .pages()
            .get(page_index as PdfPageIndex)
            .map_err(|source| TextError::ExtractionFailed {
                page: page_index,
                source,
            })?;

        let text_object = page.text().map_err(|source| TextError::ExtractionFailed {
            page: page_index,
            source,
        })?;

        let text = text_object.all();

        if text.trim().is_empty() {
            Ok(None)
        } else {
            Ok(Some(text))
        }
    }

    /// Returns a lazy iterator of `(page_index, Option<text>)` for every page.
    ///
    /// `Ok((i, Some(text)))` — page has a native text layer.
    /// `Ok((i, None))`       — page exists but has no text layer (scanned); needs OCR.
    /// `Err(_)`              — pdfium failed to access or extract from the page.
    pub fn extract_all_text_layers(
        &self,
    ) -> impl Iterator<Item = Result<(u32, Option<String>), PdfError>> {
        (0..self.page_count()).map(|i| self.extract_text_layer(i).map(|text| (i, text)))
    }
}