dforge-cli 1.0.1__py3-none-any.whl

dforge/workflows/searchable.py

@@ -0,0 +1,51 @@
+from pathlib import Path
+
+import questionary
+from rich.console import Console
+from dforge.loading import Loader
+from dforge.engine import make_searchable_pdf
+
+from dforge.workflows.common import (
+    select_single_pdf,
+    success_screen,
+    get_output_name,
+)
+
+console = Console()
+
+
+def searchable_workflow():
+    console.print(
+        "\n[bold cyan]Searchable PDF[/bold cyan]\n"
+    )
+
+    pdf = select_single_pdf()
+
+    if not pdf:
+        return
+
+    lang = questionary.text(
+        "OCR Language(s)",
+        default="eng",
+    ).ask()
+
+    output = get_output_name(
+        f"{pdf.stem}_searchable.pdf"
+    )
+
+    if not output:
+        return
+
+    output_path = Path(output)
+    with Loader("Creating searchable PDF..."):
+        make_searchable_pdf(
+            pdf,
+            output_path,
+            lang,
+            300,
+        )
+
+    success_screen(
+        "Searchable PDF Created",
+        output_file=output_path.name,
+    )

dforge/workflows/settings.py

@@ -0,0 +1,56 @@
+import questionary
+
+from dforge.config_manager import (
+    load_config,
+    save_config,
+)
+
+
+def settings_workflow():
+
+    config = load_config()
+
+    lang = questionary.select(
+        "Default OCR language",
+        choices=[
+            "eng",
+            "hin",
+            "tel",
+            "tam",
+            "jpn",
+        ],
+        default=config.get(
+            "ocr_language",
+            "eng",
+        ),
+    ).ask()
+
+    dpi = int(
+        questionary.text(
+            "DPI",
+            default=str(
+                config.get(
+                    "ocr_dpi",
+                    300,
+                )
+            ),
+        ).ask()
+    )
+
+    workers = int(
+        questionary.text(
+            "Workers",
+            default=str(
+                config.get(
+                    "ocr_workers",
+                    4,
+                )
+            ),
+        ).ask()
+    )
+
+    config["ocr_language"] = lang
+    config["ocr_dpi"] = dpi
+    config["ocr_workers"] = workers
+
+    save_config(config)

dforge/workflows/split.py

@@ -0,0 +1,32 @@
+from rich.console import Console
+
+from dforge.operations import split
+
+from dforge.workflows.common import (
+    select_single_pdf,
+    success_screen,
+)
+
+console = Console()
+
+
+def split_workflow():
+    console.print("\n[bold cyan]Split PDF[/bold cyan]\n")
+
+    pdf = select_single_pdf()
+
+    if not pdf:
+        return
+
+    console.print(
+        "\n[bold cyan]Splitting PDF...[/bold cyan]\n"
+    )
+
+    split(pdf)
+
+    success_screen(
+        "Split Complete",
+        extra_lines=[
+            f"Source : {pdf.name}",
+        ],
+    )

dforge/workflows/tables.py

@@ -0,0 +1,45 @@
+from pathlib import Path
+
+import questionary
+from rich.console import Console
+
+from dforge.extractor import extract_tables
+
+from dforge.workflows.common import (
+    select_single_pdf,
+    success_screen,
+)
+
+console = Console()
+
+
+def tables_workflow():
+    console.print("\n[bold cyan]Extract Tables[/bold cyan]\n")
+
+    pdf = select_single_pdf()
+
+    if not pdf:
+        return
+
+    fmt = questionary.select(
+        "Output format",
+        choices=[
+            "xlsx",
+            "csv",
+            "json",
+        ],
+    ).ask()
+
+    output = Path(
+        f"{pdf.stem}_tables.{fmt}"
+    )
+
+    extract_tables(
+        pdf,
+        output,
+    )
+
+    success_screen(
+        "Table Extraction Complete",
+        output_file=output.name,
+    )

dforge/workflows/watermark.py

@@ -0,0 +1,54 @@
+from pathlib import Path
+
+import questionary
+from rich.console import Console
+
+from dforge.operations import watermark
+
+from dforge.workflows.common import (
+    select_single_pdf,
+    success_screen,
+    get_output_name,
+)
+
+console = Console()
+
+
+def watermark_workflow():
+    console.print("\n[bold cyan]Watermark PDF[/bold cyan]\n")
+
+    pdf = select_single_pdf()
+
+    if not pdf:
+        return
+
+    watermark_file = questionary.path(
+        "Watermark file (PDF/Image):"
+    ).ask()
+
+    if not watermark_file:
+        return
+
+    output = get_output_name(
+        f"{pdf.stem}_watermarked.pdf"
+    )
+
+    if not output:
+        return
+
+    output_path = Path(output)
+
+    console.print(
+        "\n[bold cyan]Applying Watermark...[/bold cyan]\n"
+    )
+
+    watermark(
+        pdf,
+        Path(watermark_file),
+        output_path,
+    )
+
+    success_screen(
+        "Watermark Complete",
+        output_file=output_path.name,
+    )

dforge_cli-1.0.1.dist-info/METADATA

@@ -0,0 +1,244 @@
+Metadata-Version: 2.4
+Name: dforge-cli
+Version: 1.0.1
+Summary: DForge — Unified Document Processing CLI. Forge your documents from your terminal.
+Author: Punith Naidu
+License: MIT
+Keywords: pdf,ocr,document,cli,conversion,tesseract,batch
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: typer[all]>=0.9.0
+Requires-Dist: pypdf>=3.0.0
+Requires-Dist: pikepdf>=8.0.0
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: opencv-python-headless>=4.8.0
+Requires-Dist: img2pdf>=0.4.4
+Requires-Dist: watchdog>=3.0.0
+Requires-Dist: tqdm>=4.66.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: prompt_toolkit>=3.0.0
+Requires-Dist: pyfiglet>=1.0.2
+Provides-Extra: ocr
+Requires-Dist: pytesseract>=0.3.10; extra == "ocr"
+Requires-Dist: pdf2image>=1.16.3; extra == "ocr"
+Provides-Extra: tables
+Requires-Dist: pdfplumber>=0.10.0; extra == "tables"
+Requires-Dist: pandas>=2.0.0; extra == "tables"
+Requires-Dist: openpyxl>=3.1.0; extra == "tables"
+Provides-Extra: full
+Requires-Dist: pytesseract>=0.3.10; extra == "full"
+Requires-Dist: pdf2image>=1.16.3; extra == "full"
+Requires-Dist: pdfplumber>=0.10.0; extra == "full"
+Requires-Dist: pandas>=2.0.0; extra == "full"
+Requires-Dist: openpyxl>=3.1.0; extra == "full"
+
+# DForge — Forge your documents from your terminal.
+
+A unified, offline-first Python CLI for all your document processing needs.
+
+---
+
+## Installation
+
+```bash
+pip install dforge
+```
+
+### External Dependencies
+
+| Tool | Purpose | Install |
+|------|---------|---------|
+| Tesseract OCR | OCR engine | [Install guide](https://tesseract-ocr.github.io/tessdoc/Installation.html) |
+| Ghostscript | PDF compression | [ghostscript.com](https://ghostscript.com/releases/gsdnld.html) |
+| Pandoc | Document conversion | [pandoc.org](https://pandoc.org/installing.html) |
+| Poppler | PDF → image (pdf2image) | `apt install poppler-utils` / `brew install poppler` |
+
+---
+
+## Quick Reference
+
+### PDF Operations
+
+```bash
+# Merge PDFs
+dforge merge a.pdf b.pdf c.pdf -o merged.pdf
+
+# Split into pages
+dforge split report.pdf
+
+# Compress (uses Ghostscript)
+dforge compress large.pdf --preset ebook
+
+# Rotate pages
+dforge rotate file.pdf 90
+
+# Extract page range
+dforge pages file.pdf 1-5
+
+# Watermark
+dforge watermark file.pdf logo.png
+
+# Encrypt / Decrypt
+dforge encrypt file.pdf
+dforge decrypt protected.pdf
+```
+
+### OCR
+
+```bash
+# OCR an image
+dforge ocr scan.png
+
+# OCR a PDF
+dforge ocr scan.pdf
+
+# Output as JSON or Markdown
+dforge ocr scan.pdf --fmt json
+dforge ocr scan.pdf --fmt md
+
+# Multi-language OCR
+dforge ocr scan.png --lang eng+hin
+
+# Make a scanned PDF searchable
+dforge searchable scan.pdf
+
+# Batch OCR an entire folder
+dforge batch-ocr invoices/
+```
+
+### Document Conversion
+
+```bash
+# Convert DOCX → PDF
+dforge convert report.docx pdf
+
+# Convert Markdown → HTML
+dforge convert notes.md html
+
+# Combine images into a PDF
+dforge img2pdf scans/
+
+# Export PDF pages as images
+dforge pdf2img report.pdf --dpi 300 --fmt png
+```
+
+### Content Extraction
+
+```bash
+# Extract text
+dforge text report.pdf
+
+# Extract embedded images
+dforge images report.pdf
+
+# Show / save metadata
+dforge metadata report.pdf
+dforge metadata report.pdf -o meta.json
+
+# Extract tables
+dforge tables invoice.pdf --fmt xlsx
+dforge tables invoice.pdf --fmt csv
+dforge tables invoice.pdf --fmt json
+```
+
+### Image Processing
+
+```bash
+# Enhance (contrast + sharpness)
+dforge enhance scan.png
+
+# Fix skewed scans
+dforge deskew scan.png
+
+# Remove noise
+dforge denoise scan.png
+
+# Resize
+dforge resize photo.png --width 800
+dforge resize photo.png --scale 0.5
+
+# Full OCR preprocessing pipeline
+dforge preprocess scan.png
+```
+
+### Batch Processing
+
+```bash
+# Batch OCR with 8 workers
+dforge batch ./documents --ocr --workers 8
+
+# Batch compress
+dforge batch ./pdfs --compress
+
+# Batch convert to markdown
+dforge batch ./docs --convert md
+```
+
+### Watch Mode
+
+```bash
+# Auto-OCR new files dropped into a folder
+dforge watch ./incoming --ocr
+
+# Auto-make-searchable
+dforge watch ./scans --searchable
+
+# Auto-compress
+dforge watch ./uploads --compress
+```
+
+---
+
+## Project Structure
+
+```
+dforge/
+├── cli.py           ← Typer CLI entry point
+├── config.py        ← Global configuration
+├── utils.py         ← Shared utilities
+├── pdf/
+│   └── operations.py  ← merge, split, compress, rotate, pages, watermark, encrypt, decrypt
+├── ocr/
+│   └── engine.py      ← ocr_image, ocr_pdf, make_searchable_pdf, batch_ocr
+├── convert/
+│   └── converter.py   ← convert, images_to_pdf, pdf_to_images
+├── extract/
+│   └── extractor.py   ← extract_text, extract_images, extract_metadata, extract_tables
+├── image/
+│   └── processor.py   ← enhance, deskew, denoise, resize, preprocess_for_ocr
+├── batch/
+│   └── processor.py   ← parallel batch processing
+└── watch/
+    └── watcher.py     ← watchdog-based directory monitor
+```
+
+---
+
+## Supported Formats
+
+| Category | Formats |
+|----------|---------|
+| Input documents | PDF, DOCX, ODT, MD, HTML, TXT, RST, EPUB |
+| Input images | PNG, JPG/JPEG, TIFF/TIF, BMP, WebP |
+| OCR output | TXT, JSON, Markdown |
+| Table export | CSV, XLSX, JSON |
+| Image export | PNG, JPEG, TIFF |
+
+---
+
+## License
+
+MIT License — DForge Contributors

dforge_cli-1.0.1.dist-info/RECORD

@@ -0,0 +1,44 @@
+dforge/__init__.py,sha256=Aj77VL1d5Mdku7sgCgKQmPuYavPpAHuZuJcy6bygQZE,21
+dforge/banner.py,sha256=r4fjn46oY2vYKN8Dr397cQN0nM-7Nu69FN78WvYdisI,533
+dforge/batch.py,sha256=d5ONPODryq-sMpIifGPNjuacLMXS_0F7v-Qj_o64V9U,4434
+dforge/cli.py,sha256=9VVrHcuyyLEaTIEHwWOLhulxnYQ90mP5o6dvcTywhL0,19766
+dforge/config.py,sha256=vGK-VuutSLfnDz3fPFuijH3P-p5y27nJEhaBe88oE9o,888
+dforge/config_manager.py,sha256=PlUJaCBznaEvuTQFS5xDzcEqJUZ12Xfu98MZ5Z6ENdA,643
+dforge/converter.py,sha256=XXUXr6paQRNLqqDJM4DeFxUMlg-nGMMLQNfRh4XA1As,5110
+dforge/dependencies.py,sha256=3cfV2xb1IoOXe-RxoujqvyEaputtsENmO_hph6iZ49E,1955
+dforge/engine.py,sha256=9oFbRoz7oNKEbp2iE6j25mdjCMqCq0kA5Q47idDLD3Q,7660
+dforge/extractor.py,sha256=BYkNcnaxJXy1jz5fhMFz2gv7v8GckOygqDSpBtJd4Sk,6978
+dforge/loading.py,sha256=u1-Svpvu4Dkooc8Oey8qcbBaxJ3ITTomYrqWa_tOYUA,396
+dforge/menu.py,sha256=CQHGLNd2kGcgaqEQ-r_ALttw1JWY2ObiNiGO2jqS6f8,2295
+dforge/operations.py,sha256=JbZCRFyZ1xfNk8ohxjIJBNrAjnyN9POFht5mH8f3FdM,10315
+dforge/processor.py,sha256=3O3cVkEvAgSGjYnVBdbAEXEPw96EeJ6B6afsgdHFfgo,8201
+dforge/setup.py,sha256=pV23z18-E25IG4tWULD4cZeAAQwYdNi9KqjNTzenfo4,2383
+dforge/theme.py,sha256=F-W0HhyMIeYXWUG7wgl6LJJcAWHjB3oGNY8alJaWbfE,247
+dforge/utils.py,sha256=KwZPQb59-B59nsI_V7M3rE3Kl_HufJe_dhf-qqQ5txc,4547
+dforge/watcher.py,sha256=CeKlGFM3Ku7e8-Gbn_RFrvBBnkzvUd7KbyTDSKGC-F4,4322
+dforge/workflows/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dforge/workflows/automation.py,sha256=3NH1D0XrG7tYiDUDBDbQofPwnJNstQRVf1UB77i0Ldk,398
+dforge/workflows/batch.py,sha256=YMiHgFh7U8seTUMB0jBwqAWCxqakGE9aAn9oBgzFLpI,327
+dforge/workflows/batch_ocr.py,sha256=0Jh9O_PyejF5-x61kzwBS2vEIgx4LgCS6r6hV2rc2tk,1118
+dforge/workflows/common.py,sha256=zRiwNEDlZHvn0KgW_P9Mj_j8c7mNMRKpqq5oF1iMCa8,2450
+dforge/workflows/compress.py,sha256=PyEh_2rpSvk0rgG-bXtH5OAPenqrYq-gU37i3Vrm1bE,1373
+dforge/workflows/convert.py,sha256=qd4YAdY6viTt8gnOlUwNoDWErIW_SZ7Ja5ArmVf7iU4,2481
+dforge/workflows/decrypt.py,sha256=VaRrxA2Ohq69VTGRs3hw3I7SE3eY9EqbC0Ny2vx88W8,806
+dforge/workflows/encrypt.py,sha256=ytVvSgmAH5MAFvLU2iIliIe9YGzwzsZAfc5d51P4MAY,806
+dforge/workflows/extract.py,sha256=guWdlQjSx74mvvmaxzfQA5YyLaAUh3qtFBKfhAqcXS4,339
+dforge/workflows/image.py,sha256=iQ8anZ9-IaF1TIeFAOvBX9ASazgk5v3phpAjTuLpRZc,390
+dforge/workflows/merge.py,sha256=aMdTOAXB4GGVdDOr0PCCN5oQfSIU6OqCHeOm7Vy1e18,2242
+dforge/workflows/ocr.py,sha256=FJRTpcQPcX9a89kLjjHNpEly_oFI3G6NjZZeeF6iing,1944
+dforge/workflows/ocr_folder.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dforge/workflows/pages.py,sha256=nXNc796ozKh1j7twAXBRokJpOGAwX1HvsfMCg4zrYMI,1001
+dforge/workflows/rotate.py,sha256=kKESL8aNh1_haMSs71uWFxsT-fu19DUIMnjhugE5b1c,898
+dforge/workflows/searchable.py,sha256=oPb81IHtNkZApEw4DPGYJN4xQEPlkOKgnEArPfQPP3w,947
+dforge/workflows/settings.py,sha256=9hiJu-Oo3IYNpndE53diFM5S_ulhFNY5o5PjWyQxciQ,1016
+dforge/workflows/split.py,sha256=BcZimQF9H4Daezu-1SlrwE-0I16WU6-Iz3_qCXYidiU,537
+dforge/workflows/tables.py,sha256=1_qfa9gQPY353JnUtWTpEB4Mto5OOmt33vgdv97R5qA,748
+dforge/workflows/watermark.py,sha256=bgQDMpKn2OnHQGNohaLBsEGuWUaLeVodY3oq6Kp7al4,938
+dforge_cli-1.0.1.dist-info/METADATA,sha256=uxKJ-quM1Dc9qwvo6aPMMJI9rQ8z2liou6FJHko0sik,5861
+dforge_cli-1.0.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+dforge_cli-1.0.1.dist-info/entry_points.txt,sha256=z9MCoKCrUNJzohLRdcdK2dq9NPoWBCts7voq5oInBVw,42
+dforge_cli-1.0.1.dist-info/top_level.txt,sha256=QWUw5aSnP6-6lDz_7_h8tyxuyHMhdIKpaX8cYzpjuts,7
+dforge_cli-1.0.1.dist-info/RECORD,,

dforge_cli-1.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

dforge_cli-1.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dforge = dforge.cli:app

dforge_cli-1.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+dforge