docslight-lite 0.1.0__tar.gz

docslight_lite-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ComPDF AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

docslight_lite-0.1.0/PKG-INFO

@@ -0,0 +1,277 @@
+Metadata-Version: 2.4
+Name: docslight-lite
+Version: 0.1.0
+Summary: Lightweight ComPDF document parsing and extraction SDK
+Author-email: ComPDF AI <support@compdf.com>
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: typing-extensions>=4.8.0; python_version < "3.11"
+Requires-Dist: tomli>=2.0.1; python_version < "3.11"
+Requires-Dist: flask>=3.1.3
+Requires-Dist: werkzeug>=3.1.8
+Provides-Extra: local
+Requires-Dist: Pillow>=10.0.0; extra == "local"
+Requires-Dist: PyMuPDF>=1.23.0; extra == "local"
+Requires-Dist: numpy>=1.24.0; extra == "local"
+Requires-Dist: paddlepaddle>=3.3.0; extra == "local"
+Requires-Dist: paddleocr[doc-parser]>=3.3.0; extra == "local"
+Requires-Dist: python-docx>=1.1.0; extra == "local"
+Requires-Dist: python-pptx>=0.6.23; extra == "local"
+Requires-Dist: openpyxl>=3.1.0; extra == "local"
+Provides-Extra: local-llm
+Requires-Dist: openai>=1.0.0; extra == "local-llm"
+Provides-Extra: web
+Requires-Dist: Flask>=3.0.0; extra == "web"
+Requires-Dist: Werkzeug>=3.0.0; extra == "web"
+Provides-Extra: web-test
+Requires-Dist: playwright>=1.40.0; extra == "web-test"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.7.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: Pillow>=10.0.0; extra == "dev"
+Requires-Dist: PyMuPDF>=1.23.0; extra == "dev"
+Requires-Dist: numpy>=1.24.0; extra == "dev"
+Requires-Dist: python-docx>=1.1.0; extra == "dev"
+Requires-Dist: python-pptx>=0.6.23; extra == "dev"
+Requires-Dist: openpyxl>=3.1.0; extra == "dev"
+Requires-Dist: Flask>=3.0.0; extra == "dev"
+Requires-Dist: Werkzeug>=3.0.0; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <h1 align="center">DocSlight Lite</h1>
+  <p align="center">Lightweight Python SDK & CLI for document parsing and structured extraction</p>
+  <p align="center">
+    <a href="https://pypi.org/project/docslight-lite/"><img src="https://img.shields.io/pypi/v/docslight-lite" alt="PyPI"></a>
+    <a href="https://pypi.org/project/docslight-lite/"><img src="https://img.shields.io/pypi/pyversions/docslight-lite" alt="Python versions"></a>
+    <a href="LICENSE"><img src="https://img.shields.io/github/license/kdanmobile/docslight-lite" alt="License"></a>
+  </p>
+</p>
+
+## What is DocSlight Lite?
+
+A lightweight Python library that turns PDFs, images, and Office documents into clean Markdown or structured JSON — with one line of code. Works with ComPDF Cloud (recommended) or fully offline with local parsers.
+
+```python
+from docslight import DocSlight
+
+client = DocSlight(api_key="your-api-key")
+result = client.parse("invoice.pdf")
+print(result.to_markdown())
+```
+
+## Quick Start
+
+```bash
+pip install docslight-lite
+```
+
+Parse any document:
+
+```bash
+docslight parse invoice.pdf --output invoice.md
+```
+
+Extract specific fields:
+
+```bash
+docslight extract invoice.pdf --fields invoice_number,total_amount
+```
+
+Launch the local Web UI workbench:
+
+```bash
+pip install "docslight-lite[web]"
+docslight web
+# Open http://127.0.0.1:8000
+
+# Or run the same Web UI directly as a module
+python -m docslight.web_app --host 0.0.0.0 --port 8000 --debug
+```
+
+## Features
+
+- **Dual mode** — ComPDF Cloud for production-grade results, or local CPU parsing for offline evaluation
+- **Parse → Markdown** — Convert PDF, DOCX, PPTX, XLSX, and images (PNG, JPG, TIFF, BMP, WebP) to clean Markdown
+- **Extract → JSON** — Pull structured data by field list, JSON Schema, or structured template (key-value + table extraction)
+- **CLI first** — Full-featured command-line interface, script-friendly
+- **Web UI** — Local Flask workbench with drag-and-drop, live preview with bbox highlights, and a Fields Builder UI
+- **Batch processing** — `parse_batch()` / `extract_batch()` for multiple files
+- **Local LLM extraction** — Ollama or any OpenAI-compatible provider for offline extraction
+- **Document types** — Classify and route documents by type for cloud extraction
+- **Error-safe** — Typed result objects, structured error hierarchy, no credential leaks
+
+## Install
+
+| Scenario | Command |
+|----------|---------|
+| Core SDK & CLI | `pip install docslight-lite` |
+| + Local parsing (OCR, Office) | `pip install "docslight-lite[local]"` |
+| + Local LLM extraction | `pip install "docslight-lite[local,local-llm]"` |
+| + Web UI workbench | `pip install "docslight-lite[web]"` |
+
+> Local CPU parsing is experimental. Validate accuracy and latency on your own documents before production use.
+
+## SDK Usage
+
+### Cloud — Parse
+
+```python
+from docslight import DocSlight
+
+client = DocSlight(mode="cloud", api_key="your-api-key")
+
+result = client.parse("invoice.pdf")
+print(result.to_markdown())   # Clean markdown
+print(result.to_json())       # Full result with pages + metadata
+```
+
+### Cloud — Extract
+
+```python
+result = client.extract(
+    "invoice.pdf",
+    fields=["invoice_number", "invoice_date", "total_amount"],
+)
+print(result.to_json())
+```
+
+With a JSON Schema:
+
+```python
+schema = {
+    "type": "object",
+    "properties": {
+        "invoice_number": {"type": "string"},
+        "total_amount": {"type": "number"},
+    },
+    "required": ["invoice_number"],
+}
+result = client.extract("invoice.pdf", schema=schema)
+```
+
+With document type classification:
+
+```python
+result = client.extract(
+    "invoice.pdf",
+    fields=["invoice_number"],
+    document_types=["invoice"],
+)
+```
+
+### Local — Parse (Offline)
+
+```python
+client = DocSlight(mode="local")
+result = client.parse("invoice.pdf")
+print(result.to_markdown())
+```
+
+### Local — Extract with Ollama
+
+```python
+client = DocSlight(
+    mode="local",
+    local_llm={"provider": "ollama", "model": "llama3.1"},
+)
+result = client.extract(
+    "invoice.pdf",
+    fields=["invoice_number", "invoice_date"],
+)
+```
+
+### Local — Extract with OpenAI-Compatible API
+
+```python
+client = DocSlight(
+    mode="local",
+    local_llm={
+        "provider": "openai-compatible",
+        "base_url": "https://your-endpoint/v1",
+        "model": "your-model",
+        "api_key": "your-api-key",
+        "extra_body": {"enable_thinking": False},  # e.g., DashScope qwen3
+    },
+)
+```
+
+### Batch Processing
+
+```python
+results = client.parse_batch(["doc1.pdf", "doc2.pdf", "doc3.pdf"])
+for r in results:
+    print(r.to_markdown()[:200])
+```
+
+## CLI Usage
+
+```bash
+# Parse
+docslight parse invoice.pdf --mode cloud -o invoice.md
+docslight parse invoice.pdf --mode local -o invoice.md
+
+# Extract
+docslight extract invoice.pdf --mode cloud --fields invoice_number,total_amount
+docslight extract invoice.pdf --mode local --fields invoice_number --local-llm-provider ollama --local-llm-model llama3.1
+
+# Extract with schema
+docslight extract invoice.pdf --schema schema.json
+
+# Web UI
+docslight web --host 127.0.0.1 --port 8000
+```
+
+## Web UI Workbench
+
+DocSlight Workbench is a local Flask app for visual document processing.
+
+```bash
+pip install "docslight-lite[web]"
+docslight web
+python -m docslight.web_app
+```
+
+- **Parse & Extract tabs** — Switch between parsing and extraction workflows
+- **Drag-and-drop upload** — PDF, images, DOCX, PPTX, XLSX
+- **Live preview** — PDF page rendering with bbox highlight overlays
+- **Fields Builder** — Structured UI for building key-value and table extraction templates
+- **Download results** — One-click download of Markdown or JSON output
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `DOCSLIGHT_API_KEY` | API key for cloud mode |
+| `DOCSLIGHT_MODE` | Processing mode: `cloud` or `local` (default: `cloud`) |
+
+## Supported Inputs
+
+| Mode | Formats |
+|------|---------|
+| Cloud | PDF, images (PNG/JPG/TIFF/BMP/WebP), DOCX, PPTX, XLSX, and more via ComPDF Cloud API |
+| Local | PDF, images (PNG/JPG/TIFF/BMP/WebP), DOCX, PPTX, XLSX |
+
+> Legacy Office formats (`.doc`, `.ppt`, `.xls`) must be converted to DOCX/PPTX/XLSX for local processing.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+ruff check .
+mypy docslight
+pytest
+python -m build
+```
+
+## License
+
+MIT License. See `LICENSE`.

docslight_lite-0.1.0/README.md

@@ -0,0 +1,229 @@
+<p align="center">
+  <h1 align="center">DocSlight Lite</h1>
+  <p align="center">Lightweight Python SDK & CLI for document parsing and structured extraction</p>
+  <p align="center">
+    <a href="https://pypi.org/project/docslight-lite/"><img src="https://img.shields.io/pypi/v/docslight-lite" alt="PyPI"></a>
+    <a href="https://pypi.org/project/docslight-lite/"><img src="https://img.shields.io/pypi/pyversions/docslight-lite" alt="Python versions"></a>
+    <a href="LICENSE"><img src="https://img.shields.io/github/license/kdanmobile/docslight-lite" alt="License"></a>
+  </p>
+</p>
+
+## What is DocSlight Lite?
+
+A lightweight Python library that turns PDFs, images, and Office documents into clean Markdown or structured JSON — with one line of code. Works with ComPDF Cloud (recommended) or fully offline with local parsers.
+
+```python
+from docslight import DocSlight
+
+client = DocSlight(api_key="your-api-key")
+result = client.parse("invoice.pdf")
+print(result.to_markdown())
+```
+
+## Quick Start
+
+```bash
+pip install docslight-lite
+```
+
+Parse any document:
+
+```bash
+docslight parse invoice.pdf --output invoice.md
+```
+
+Extract specific fields:
+
+```bash
+docslight extract invoice.pdf --fields invoice_number,total_amount
+```
+
+Launch the local Web UI workbench:
+
+```bash
+pip install "docslight-lite[web]"
+docslight web
+# Open http://127.0.0.1:8000
+
+# Or run the same Web UI directly as a module
+python -m docslight.web_app --host 0.0.0.0 --port 8000 --debug
+```
+
+## Features
+
+- **Dual mode** — ComPDF Cloud for production-grade results, or local CPU parsing for offline evaluation
+- **Parse → Markdown** — Convert PDF, DOCX, PPTX, XLSX, and images (PNG, JPG, TIFF, BMP, WebP) to clean Markdown
+- **Extract → JSON** — Pull structured data by field list, JSON Schema, or structured template (key-value + table extraction)
+- **CLI first** — Full-featured command-line interface, script-friendly
+- **Web UI** — Local Flask workbench with drag-and-drop, live preview with bbox highlights, and a Fields Builder UI
+- **Batch processing** — `parse_batch()` / `extract_batch()` for multiple files
+- **Local LLM extraction** — Ollama or any OpenAI-compatible provider for offline extraction
+- **Document types** — Classify and route documents by type for cloud extraction
+- **Error-safe** — Typed result objects, structured error hierarchy, no credential leaks
+
+## Install
+
+| Scenario | Command |
+|----------|---------|
+| Core SDK & CLI | `pip install docslight-lite` |
+| + Local parsing (OCR, Office) | `pip install "docslight-lite[local]"` |
+| + Local LLM extraction | `pip install "docslight-lite[local,local-llm]"` |
+| + Web UI workbench | `pip install "docslight-lite[web]"` |
+
+> Local CPU parsing is experimental. Validate accuracy and latency on your own documents before production use.
+
+## SDK Usage
+
+### Cloud — Parse
+
+```python
+from docslight import DocSlight
+
+client = DocSlight(mode="cloud", api_key="your-api-key")
+
+result = client.parse("invoice.pdf")
+print(result.to_markdown())   # Clean markdown
+print(result.to_json())       # Full result with pages + metadata
+```
+
+### Cloud — Extract
+
+```python
+result = client.extract(
+    "invoice.pdf",
+    fields=["invoice_number", "invoice_date", "total_amount"],
+)
+print(result.to_json())
+```
+
+With a JSON Schema:
+
+```python
+schema = {
+    "type": "object",
+    "properties": {
+        "invoice_number": {"type": "string"},
+        "total_amount": {"type": "number"},
+    },
+    "required": ["invoice_number"],
+}
+result = client.extract("invoice.pdf", schema=schema)
+```
+
+With document type classification:
+
+```python
+result = client.extract(
+    "invoice.pdf",
+    fields=["invoice_number"],
+    document_types=["invoice"],
+)
+```
+
+### Local — Parse (Offline)
+
+```python
+client = DocSlight(mode="local")
+result = client.parse("invoice.pdf")
+print(result.to_markdown())
+```
+
+### Local — Extract with Ollama
+
+```python
+client = DocSlight(
+    mode="local",
+    local_llm={"provider": "ollama", "model": "llama3.1"},
+)
+result = client.extract(
+    "invoice.pdf",
+    fields=["invoice_number", "invoice_date"],
+)
+```
+
+### Local — Extract with OpenAI-Compatible API
+
+```python
+client = DocSlight(
+    mode="local",
+    local_llm={
+        "provider": "openai-compatible",
+        "base_url": "https://your-endpoint/v1",
+        "model": "your-model",
+        "api_key": "your-api-key",
+        "extra_body": {"enable_thinking": False},  # e.g., DashScope qwen3
+    },
+)
+```
+
+### Batch Processing
+
+```python
+results = client.parse_batch(["doc1.pdf", "doc2.pdf", "doc3.pdf"])
+for r in results:
+    print(r.to_markdown()[:200])
+```
+
+## CLI Usage
+
+```bash
+# Parse
+docslight parse invoice.pdf --mode cloud -o invoice.md
+docslight parse invoice.pdf --mode local -o invoice.md
+
+# Extract
+docslight extract invoice.pdf --mode cloud --fields invoice_number,total_amount
+docslight extract invoice.pdf --mode local --fields invoice_number --local-llm-provider ollama --local-llm-model llama3.1
+
+# Extract with schema
+docslight extract invoice.pdf --schema schema.json
+
+# Web UI
+docslight web --host 127.0.0.1 --port 8000
+```
+
+## Web UI Workbench
+
+DocSlight Workbench is a local Flask app for visual document processing.
+
+```bash
+pip install "docslight-lite[web]"
+docslight web
+python -m docslight.web_app
+```
+
+- **Parse & Extract tabs** — Switch between parsing and extraction workflows
+- **Drag-and-drop upload** — PDF, images, DOCX, PPTX, XLSX
+- **Live preview** — PDF page rendering with bbox highlight overlays
+- **Fields Builder** — Structured UI for building key-value and table extraction templates
+- **Download results** — One-click download of Markdown or JSON output
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `DOCSLIGHT_API_KEY` | API key for cloud mode |
+| `DOCSLIGHT_MODE` | Processing mode: `cloud` or `local` (default: `cloud`) |
+
+## Supported Inputs
+
+| Mode | Formats |
+|------|---------|
+| Cloud | PDF, images (PNG/JPG/TIFF/BMP/WebP), DOCX, PPTX, XLSX, and more via ComPDF Cloud API |
+| Local | PDF, images (PNG/JPG/TIFF/BMP/WebP), DOCX, PPTX, XLSX |
+
+> Legacy Office formats (`.doc`, `.ppt`, `.xls`) must be converted to DOCX/PPTX/XLSX for local processing.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+ruff check .
+mypy docslight
+pytest
+python -m build
+```
+
+## License
+
+MIT License. See `LICENSE`.

docslight_lite-0.1.0/docslight/__init__.py

@@ -0,0 +1,41 @@
+"""Lightweight ComPDF document parsing and extraction SDK."""
+
+from docslight.client import DocSlight
+from docslight.config import (
+    DEFAULT_BASE_URL,
+    DEFAULT_CONFIG_PATH,
+    VALID_MODES,
+    DocSlightConfig,
+)
+from docslight.exceptions import (
+    AuthenticationError,
+    CloudAPIError,
+    ConfigurationError,
+    DependencyMissingError,
+    DocSlightError,
+    LocalProcessingError,
+    RateLimitError,
+    UnsupportedFormatError,
+)
+from docslight.result import ExtractResult, ParseResult
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "AuthenticationError",
+    "CloudAPIError",
+    "ConfigurationError",
+    "DEFAULT_BASE_URL",
+    "DEFAULT_CONFIG_PATH",
+    "DependencyMissingError",
+    "DocSlight",
+    "DocSlightConfig",
+    "DocSlightError",
+    "ExtractResult",
+    "LocalProcessingError",
+    "ParseResult",
+    "RateLimitError",
+    "UnsupportedFormatError",
+    "VALID_MODES",
+    "__version__",
+]