liteparse 1.0.1

Python wrapper for LiteParse - fast, lightweight PDF and document parsing

LiteParse Python

Python wrapper for LiteParse - fast, lightweight document parsing with optional OCR.

Installation

pip install liteparse

Prerequisites: The LiteParse Node.js CLI must be installed:

npm install -g liteparse
# or
npx liteparse --version

Quick Start

from liteparse import LiteParse

# Create parser
parser = LiteParse()

# Parse a document
result = parser.parse("document.pdf")
print(result.text)

# Access structured data
for page in result.pages:
    print(f"Page {page.pageNum}: {len(page.textItems)} text items")

Configuration

from liteparse import LiteParse

parser = LiteParse()

result = parser.parse(
    "document.pdf",
    ocr_enabled=False,
    max_pages=10,
    dpi=150,
    preserve_small_text=True,
)
print(result.text)

Batch Processing

For parsing multiple files, batch mode is significantly faster as it reuses the PDF engine:

from liteparse import LiteParse

parser = LiteParse(ocr_enabled=False)

# Parse all documents in a directory
result = parser.batch_parse(
    input_dir="./documents",
    output_dir="./output",
    recursive=True,              # Include subdirectories
    extension_filter=".pdf",     # Only PDF files
)

print(f"Parsed {result.success_count} files in {result.total_time_seconds}s")
print(f"Average: {result.avg_time_ms}ms per file")

Supported Formats

• PDF (.pdf)
• Microsoft Office (.docx, .xlsx, .pptx, etc.) - requires LibreOffice
• OpenDocument (.odt, .ods, .odp) - requires LibreOffice
• Images (.png, .jpg, .tiff, etc.) - requires ImageMagick
• And more!

Performance Tips

1. Disable OCR if your documents have selectable text:

   parser = LiteParse(ocr_enabled=False)
   

2. Use batch mode for multiple files to avoid cold-start overhead:

   parser.batch_parse("./input", "./output")
   

3. Limit pages if you only need specific pages:

   result = parser.parse("doc.pdf", target_pages="1-5")