docslight 0.1.1__tar.gz → 0.1.2__tar.gz

{docslight-0.1.1 → docslight-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docslight
-Version: 0.1.1
+Version: 0.1.2
 Summary: Lightweight ComPDF document parsing and extraction SDK
 Author-email: ComPDF AI <support@compdf.com>
 License-Expression: MIT
@@ -78,6 +78,7 @@ Parse any document:
 
 ```bash
 docslight parse invoice.pdf --output invoice.md
+docslight parse invoice.pdf --format zip --output invoice.zip
 ```
 
 Extract specific fields:
@@ -208,7 +209,7 @@ client = DocSlight(
 
 ```python
 results = client.parse_batch(["doc1.pdf", "doc2.pdf", "doc3.pdf"])
-for r in results:
+for r in results:[release.ps1](scripts/release.ps1)
     print(r.to_markdown()[:200])
 ```
 
@@ -216,12 +217,14 @@ for r in results:
 
 ```bash
 # Parse
-docslight parse invoice.pdf --mode cloud -o invoice.md
-docslight parse invoice.pdf --mode local -o invoice.md
+docslight parse invoice.pdf --mode cloud -o invoice.zip
+docslight parse invoice.pdf --mode cloud --format zip -o invoice.zip
+docslight parse invoice.pdf --mode local -o invoice.zip
 
 # 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
+docslight extract "D:\pdf\invoice\1.pdf" --mode local --fields invoice_number --local-llm-provider ollama
 
 # Extract with schema
 docslight extract invoice.pdf --schema schema.json

{docslight-0.1.1 → docslight-0.1.2}/README.md

@@ -1,14 +1,14 @@
 <p align="center">
-  <h1 align="center">DocSlight</h1>
+  <h1 align="center">DocSlight</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/"><img src="https://img.shields.io/pypi/v/docslight" alt="PyPI"></a>
-    <a href="https://pypi.org/project/docslight/"><img src="https://img.shields.io/pypi/pyversions/docslight" alt="Python versions"></a>
-    <a href="LICENSE"><img src="https://img.shields.io/github/license/kdanmobile/docslight" alt="License"></a>
+    <a href="https://pypi.org/project/docslight/"><img src="https://img.shields.io/pypi/v/docslight" alt="PyPI"></a>
+    <a href="https://pypi.org/project/docslight/"><img src="https://img.shields.io/pypi/pyversions/docslight" alt="Python versions"></a>
+    <a href="LICENSE"><img src="https://img.shields.io/github/license/kdanmobile/docslight" alt="License"></a>
   </p>
 </p>
 
-## What is DocSlight?
+## What is DocSlight?
 
 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.
 
@@ -23,13 +23,14 @@ print(result.to_markdown())
 ## Quick Start
 
 ```bash
-pip install docslight
+pip install docslight
 ```
 
 Parse any document:
 
 ```bash
 docslight parse invoice.pdf --output invoice.md
+docslight parse invoice.pdf --format zip --output invoice.zip
 ```
 
 Extract specific fields:
@@ -41,7 +42,7 @@ docslight extract invoice.pdf --fields invoice_number,total_amount
 Launch the local Web UI workbench:
 
 ```bash
-pip install "docslight[web]"
+pip install "docslight[web]"
 docslight web
 # Open http://127.0.0.1:8000
 
@@ -65,10 +66,10 @@ python -m docslight.web_app --host 0.0.0.0 --port 8000 --debug
 
 | Scenario | Command |
 |----------|---------|
-| Core SDK & CLI | `pip install docslight` |
-| + Local parsing (OCR, Office) | `pip install "docslight[local]"` |
-| + Local LLM extraction | `pip install "docslight[local,local-llm]"` |
-| + Web UI workbench | `pip install "docslight[web]"` |
+| Core SDK & CLI | `pip install docslight` |
+| + Local parsing (OCR, Office) | `pip install "docslight[local]"` |
+| + Local LLM extraction | `pip install "docslight[local,local-llm]"` |
+| + Web UI workbench | `pip install "docslight[web]"` |
 
 > Local CPU parsing is experimental. Validate accuracy and latency on your own documents before production use.
 
@@ -160,7 +161,7 @@ client = DocSlight(
 
 ```python
 results = client.parse_batch(["doc1.pdf", "doc2.pdf", "doc3.pdf"])
-for r in results:
+for r in results:[release.ps1](scripts/release.ps1)
     print(r.to_markdown()[:200])
 ```
 
@@ -168,12 +169,14 @@ for r in results:
 
 ```bash
 # Parse
-docslight parse invoice.pdf --mode cloud -o invoice.md
-docslight parse invoice.pdf --mode local -o invoice.md
+docslight parse invoice.pdf --mode cloud -o invoice.zip
+docslight parse invoice.pdf --mode cloud --format zip -o invoice.zip
+docslight parse invoice.pdf --mode local -o invoice.zip
 
 # 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
+docslight extract "D:\pdf\invoice\1.pdf" --mode local --fields invoice_number --local-llm-provider ollama
 
 # Extract with schema
 docslight extract invoice.pdf --schema schema.json
@@ -187,7 +190,7 @@ docslight web --host 127.0.0.1 --port 8000
 DocSlight Workbench is a local Flask app for visual document processing.
 
 ```bash
-pip install "docslight[web]"
+pip install "docslight[web]"
 docslight web
 python -m docslight.web_app
 ```

{docslight-0.1.1 → docslight-0.1.2}/docslight/__init__.py

@@ -19,7 +19,7 @@ from docslight.exceptions import (
 )
 from docslight.result import ExtractResult, ParseResult
 
-__version__ = "0.1.1"
+__version__ = "0.1.2"
 
 __all__ = [
     "AuthenticationError",

{docslight-0.1.1 → docslight-0.1.2}/docslight/cli.py

@@ -81,13 +81,27 @@ def _client_from_args(args: argparse.Namespace) -> DocSlight:
     )
 
 
-def _write_output(content: str, output_path: str | None) -> None:
-    if output_path is None:
-        sys.stdout.write(content)
-        if not content.endswith("\n"):
-            sys.stdout.write("\n")
-        return
-    Path(output_path).write_text(content, encoding="utf-8")
+def _write_output(content: str, output_path: str | None) -> None:
+    if output_path is None:
+        sys.stdout.write(content)
+        if not content.endswith("\n"):
+            sys.stdout.write("\n")
+        return
+    path = Path(output_path)
+    path.write_text(content, encoding="utf-8")
+    sys.stderr.write(f"Wrote {path.resolve()}\n")
+
+
+def _write_binary_output(content: bytes, output_path: str | None) -> None:
+    if output_path is None:
+        output_buffer = getattr(sys.stdout, "buffer", None)
+        if output_buffer is None:
+            raise CLIUsageError("binary output requires --output")
+        output_buffer.write(content)
+        return
+    path = Path(output_path)
+    path.write_bytes(content)
+    sys.stderr.write(f"Wrote {path.resolve()}\n")
 
 
 def _to_pretty_json(data: Any) -> str:
@@ -125,11 +139,11 @@ def build_parser() -> argparse.ArgumentParser:
     parse_parser = subparsers.add_parser("parse", help="Parse a document")
     parse_parser.add_argument("input")
     parse_parser.add_argument("--output", "-o")
-    parse_parser.add_argument(
-        "--format",
-        choices=("markdown", "json", "standard-json"),
-        default="markdown",
-    )
+    parse_parser.add_argument(
+        "--format",
+        choices=("markdown", "json", "standard-json", "zip"),
+        default=None,
+    )
     _add_common_options(parse_parser)
     parse_parser.set_defaults(func=_run_parse)
 
@@ -159,17 +173,33 @@ def build_parser() -> argparse.ArgumentParser:
     return parser
 
 
-def _run_parse(args: argparse.Namespace) -> int:
-    parse_output = "json" if args.format == "standard-json" else args.format
-    result = _client_from_args(args).parse(args.input, output=parse_output)
-    if args.format == "json":
-        content = _to_pretty_json(result.to_json())
-    elif args.format == "standard-json":
-        content = _to_pretty_json(result.to_standard_json())
-    else:
-        content = result.to_markdown()
-    _write_output(content, args.output)
-    return 0
+def _run_parse(args: argparse.Namespace) -> int:
+    parse_format = _resolve_parse_format(args.format, args.output)
+    parse_output = "json" if parse_format == "standard-json" else "markdown"
+    result = _client_from_args(args).parse(args.input, output=parse_output)
+    if parse_format == "zip":
+        raw_archive = getattr(result, "raw_archive", None)
+        if not isinstance(raw_archive, bytes):
+            raise CLIUsageError("parse result did not include a ZIP archive")
+        _write_binary_output(raw_archive, args.output)
+    elif parse_format == "json":
+        content = _to_pretty_json(result.to_json())
+        _write_output(content, args.output)
+    elif parse_format == "standard-json":
+        content = _to_pretty_json(result.to_standard_json())
+        _write_output(content, args.output)
+    else:
+        content = result.to_markdown()
+        _write_output(content, args.output)
+    return 0
+
+
+def _resolve_parse_format(parse_format: str | None, output_path: str | None) -> str:
+    if parse_format is not None:
+        return parse_format
+    if output_path is not None and Path(output_path).suffix.lower() == ".zip":
+        return "zip"
+    return "markdown"
 
 
 def _run_convert_parse_json(args: argparse.Namespace) -> int:

{docslight-0.1.1 → docslight-0.1.2}/docslight/cloud/client.py

@@ -171,11 +171,11 @@ class CloudClient:
             return _read_downloaded_result_payload(content)
         return self._response_json(response), None
 
-    def _prepare_options(self, operation: str, options: dict[str, Any]) -> dict[str, Any]:
-        if operation != "extract" or not self._uses_custom_operation_urls():
-            return options
-
-        prepared = dict(options)
+    def _prepare_options(self, operation: str, options: dict[str, Any]) -> dict[str, Any]:
+        if operation != "extract":
+            return options
+
+        prepared = dict(options)
         if "extract_fields" in prepared:
             return prepared
 
@@ -219,7 +219,7 @@ class CloudClient:
         return compacted
 
     def _headers(self) -> dict[str, str]:
-        headers = {"User-Agent": "docslight/0.1.1"}
+        headers = {"User-Agent": "docslight/0.1.2"}
         if self.api_key:
             headers["Authorization"] = f"Bearer {self.api_key}"
             headers["x-api-key"] = self.api_key

{docslight-0.1.1 → docslight-0.1.2}/docslight.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docslight
-Version: 0.1.1
+Version: 0.1.2
 Summary: Lightweight ComPDF document parsing and extraction SDK
 Author-email: ComPDF AI <support@compdf.com>
 License-Expression: MIT
@@ -78,6 +78,7 @@ Parse any document:
 
 ```bash
 docslight parse invoice.pdf --output invoice.md
+docslight parse invoice.pdf --format zip --output invoice.zip
 ```
 
 Extract specific fields:
@@ -208,7 +209,7 @@ client = DocSlight(
 
 ```python
 results = client.parse_batch(["doc1.pdf", "doc2.pdf", "doc3.pdf"])
-for r in results:
+for r in results:[release.ps1](scripts/release.ps1)
     print(r.to_markdown()[:200])
 ```
 
@@ -216,12 +217,14 @@ for r in results:
 
 ```bash
 # Parse
-docslight parse invoice.pdf --mode cloud -o invoice.md
-docslight parse invoice.pdf --mode local -o invoice.md
+docslight parse invoice.pdf --mode cloud -o invoice.zip
+docslight parse invoice.pdf --mode cloud --format zip -o invoice.zip
+docslight parse invoice.pdf --mode local -o invoice.zip
 
 # 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
+docslight extract "D:\pdf\invoice\1.pdf" --mode local --fields invoice_number --local-llm-provider ollama
 
 # Extract with schema
 docslight extract invoice.pdf --schema schema.json

{docslight-0.1.1 → docslight-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "docslight"
-version = "0.1.1"
+version = "0.1.2"
 description = "Lightweight ComPDF document parsing and extraction SDK"
 readme = "README.md"
 requires-python = ">=3.10"