sageframe-pptx-builder 0.1.0__tar.gz

sageframe_pptx_builder-0.1.0/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Tyro Sageframe (Andrew T. Marcus)
+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.

sageframe_pptx_builder-0.1.0/PKG-INFO

@@ -0,0 +1,282 @@
+Metadata-Version: 2.4
+Name: sageframe-pptx-builder
+Version: 0.1.0
+Summary: A local-first CLI (and optional Web UI) for converting PDFs and image folders into clean, DPI-controlled PowerPoint slides
+Author-email: Andrew Marcus <andrew@sageframe.com>
+License: MIT
+Project-URL: Homepage, https://github.com/sageframe-no-kaji/pptx-builder
+Project-URL: Repository, https://github.com/sageframe-no-kaji/pptx-builder
+Project-URL: Issues, https://github.com/sageframe-no-kaji/pptx-builder/issues
+Keywords: powerpoint,pdf,converter,pptx,slides,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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 :: Multimedia :: Graphics :: Presentation
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-pptx>=0.6.21
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: PyMuPDF>=1.23.0
+Requires-Dist: pdf2image>=1.16.0
+Requires-Dist: pillow-heif>=0.13.0
+Requires-Dist: tqdm>=4.66.0
+Provides-Extra: web
+Requires-Dist: gradio>=4.0.0; extra == "web"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
+Dynamic: license-file
+
+# PPTX Builder
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![Tests](https://github.com/sageframe-no-kaji/pptx-builder/actions/workflows/test.yml/badge.svg)](https://github.com/sageframe-no-kaji/pptx-builder/actions/workflows/test.yml)
+
+A local-first CLI (and optional Web UI) for converting PDFs and image folders into clean, DPI-controlled PowerPoint slides — no PowerPoint required.
+
+---
+
+## Quick Start
+
+```bash
+pip install pptx-builder
+pptx-builder -i document.pdf
+```
+
+---
+
+## Why This Exists
+
+* **Privacy**: Process files locally without uploading to online converters.
+* **Predictable output**: A deterministic raster pipeline produces clean slides, avoiding fragile "editable" conversions that attempt unreliable text reconstruction.
+* **Power-tool behavior**: Full control over DPI, aspect ratio, and placement — no surprise auto-fit or re-layout.
+
+This tool deliberately favors consistent, high-quality raster output over attempts to reconstruct editable slide content.
+
+---
+
+## Installation
+
+### Via pip (Recommended)
+
+```bash
+pip install pptx-builder
+```
+
+**System dependencies:**
+
+* `poppler-utils` (required for PDF conversion)
+
+  * Debian/Ubuntu: `sudo apt install poppler-utils`
+  * macOS: `brew install poppler`
+
+---
+
+### With Web UI (Optional)
+
+```bash
+pip install "pptx-builder[web]"
+```
+
+Run the web interface:
+
+```bash
+python -m pptx_builder.web
+```
+
+---
+
+### Docker (Web UI)
+
+```bash
+git clone https://github.com/sageframe-no-kaji/pptx-builder.git
+cd pptx-builder
+docker compose up -d
+```
+
+Access the interface at: [http://localhost:7860](http://localhost:7860)
+
+See [DOCKER.md](DOCKER.md) for details.
+
+---
+
+## Usage
+
+### CLI (Primary Interface)
+
+**Interactive mode:**
+
+```bash
+pptx-builder
+```
+
+**CLI examples:**
+
+```bash
+# Convert a PDF
+pptx-builder -i document.pdf
+
+# Custom output name
+pptx-builder -i document.pdf -o slides.pptx
+
+# Higher DPI (slower, sharper)
+pptx-builder -i document.pdf --dpi 600
+
+# Process folder of images
+pptx-builder -i photos/
+
+# Batch process multiple files
+pptx-builder -i file1.pdf file2.pdf --quiet --force
+
+# Process folder recursively
+pptx-builder -i images/ --recursive
+
+# Enable verbose logging
+pptx-builder -i document.pdf --verbose
+```
+
+**Common options:**
+
+* `-i, --input PATH` — Input file(s) or folder
+* `-o, --output NAME` — Output filename (single input only)
+* `--dpi DPI` — PDF rendering quality (default: 300)
+* `-r, --recursive` — Process subfolders
+* `--quiet` — Suppress prompts and non-critical output
+* `--force` — Overwrite existing files
+* `--verbose` — Enable debug logging
+* `-h, --help` — Show all options
+
+---
+
+### Web UI (Secondary Interface)
+
+If installed with `[web]` extras or via Docker:
+
+```bash
+python -m pptx_builder.web
+```
+
+Or:
+
+```bash
+docker compose up -d
+# Open http://localhost:7860
+```
+
+Upload files, select options, download presentation.
+
+---
+
+## Features
+
+### Supported Formats
+
+* PDF (multi-page supported)
+* Images: PNG, JPG, JPEG, TIFF, WebP, BMP, GIF, ICO, HEIC, HEIF
+
+### Slide Sizes
+
+* 16:9 Widescreen (13.33" × 7.5") — default
+* 4:3 Standard (10" × 7.5")
+* Letter (11" × 8.5")
+* A4 (11.69" × 8.27")
+* Legal (14" × 8.5")
+* Tabloid (17" × 11")
+
+### Image Placement Modes
+
+* **Fit** — No cropping; entire image visible (default)
+* **Fill** — No whitespace; may crop edges
+
+### Output Behavior
+
+* One slide per image or PDF page
+* Images sorted alphabetically
+* Centered, never stretched
+* Compatible with PowerPoint, LibreOffice, and Google Slides
+
+---
+
+## Documentation
+
+* [DOCKER.md](DOCKER.md) — Docker deployment
+* [CONTRIBUTING.md](CONTRIBUTING.md) — Development guidelines
+* [docs/GRADIO_TUTORIAL.md](docs/GRADIO_TUTORIAL.md) — Web UI technical guide
+* [docs/MAN_PAGE_USAGE.md](docs/MAN_PAGE_USAGE.md) — Man page instructions
+
+---
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/sageframe-no-kaji/pptx-builder.git
+cd pptx-builder
+pip install -e .[dev]
+```
+
+### Run Tests
+
+```bash
+pytest
+pytest --cov=pptx_builder --cov-report=html
+```
+
+### Code Quality
+
+```bash
+black src/
+flake8 src/pptx_builder/
+mypy src/pptx_builder/
+```
+
+### Pre-commit Hooks
+
+```bash
+pre-commit install
+pre-commit run --all-files
+```
+
+---
+
+## Notes
+
+* 150–300 DPI recommended for most use cases (600 DPI is slower but sharper)
+* Large PDFs (30+ pages) at 300 DPI may take 30–60 seconds
+* Temporary files are cleaned up automatically; no persistent storage is used
+* HEIC/HEIF require `pillow-heif` (included)
+
+---
+
+## Author
+
+Created by Andrew T. Marcus
+GitHub: [https://github.com/sageframe-no-kaji](https://github.com/sageframe-no-kaji)
+
+---
+
+## License
+
+MIT License — see [LICENSE](LICENSE).
+
+---
+
+## Contributing
+
+Issues and pull requests welcome:
+
+[https://github.com/sageframe-no-kaji/pptx-builder](https://github.com/sageframe-no-kaji/pptx-builder)

sageframe_pptx_builder-0.1.0/README.md

@@ -0,0 +1,241 @@
+# PPTX Builder
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![Tests](https://github.com/sageframe-no-kaji/pptx-builder/actions/workflows/test.yml/badge.svg)](https://github.com/sageframe-no-kaji/pptx-builder/actions/workflows/test.yml)
+
+A local-first CLI (and optional Web UI) for converting PDFs and image folders into clean, DPI-controlled PowerPoint slides — no PowerPoint required.
+
+---
+
+## Quick Start
+
+```bash
+pip install pptx-builder
+pptx-builder -i document.pdf
+```
+
+---
+
+## Why This Exists
+
+* **Privacy**: Process files locally without uploading to online converters.
+* **Predictable output**: A deterministic raster pipeline produces clean slides, avoiding fragile "editable" conversions that attempt unreliable text reconstruction.
+* **Power-tool behavior**: Full control over DPI, aspect ratio, and placement — no surprise auto-fit or re-layout.
+
+This tool deliberately favors consistent, high-quality raster output over attempts to reconstruct editable slide content.
+
+---
+
+## Installation
+
+### Via pip (Recommended)
+
+```bash
+pip install pptx-builder
+```
+
+**System dependencies:**
+
+* `poppler-utils` (required for PDF conversion)
+
+  * Debian/Ubuntu: `sudo apt install poppler-utils`
+  * macOS: `brew install poppler`
+
+---
+
+### With Web UI (Optional)
+
+```bash
+pip install "pptx-builder[web]"
+```
+
+Run the web interface:
+
+```bash
+python -m pptx_builder.web
+```
+
+---
+
+### Docker (Web UI)
+
+```bash
+git clone https://github.com/sageframe-no-kaji/pptx-builder.git
+cd pptx-builder
+docker compose up -d
+```
+
+Access the interface at: [http://localhost:7860](http://localhost:7860)
+
+See [DOCKER.md](DOCKER.md) for details.
+
+---
+
+## Usage
+
+### CLI (Primary Interface)
+
+**Interactive mode:**
+
+```bash
+pptx-builder
+```
+
+**CLI examples:**
+
+```bash
+# Convert a PDF
+pptx-builder -i document.pdf
+
+# Custom output name
+pptx-builder -i document.pdf -o slides.pptx
+
+# Higher DPI (slower, sharper)
+pptx-builder -i document.pdf --dpi 600
+
+# Process folder of images
+pptx-builder -i photos/
+
+# Batch process multiple files
+pptx-builder -i file1.pdf file2.pdf --quiet --force
+
+# Process folder recursively
+pptx-builder -i images/ --recursive
+
+# Enable verbose logging
+pptx-builder -i document.pdf --verbose
+```
+
+**Common options:**
+
+* `-i, --input PATH` — Input file(s) or folder
+* `-o, --output NAME` — Output filename (single input only)
+* `--dpi DPI` — PDF rendering quality (default: 300)
+* `-r, --recursive` — Process subfolders
+* `--quiet` — Suppress prompts and non-critical output
+* `--force` — Overwrite existing files
+* `--verbose` — Enable debug logging
+* `-h, --help` — Show all options
+
+---
+
+### Web UI (Secondary Interface)
+
+If installed with `[web]` extras or via Docker:
+
+```bash
+python -m pptx_builder.web
+```
+
+Or:
+
+```bash
+docker compose up -d
+# Open http://localhost:7860
+```
+
+Upload files, select options, download presentation.
+
+---
+
+## Features
+
+### Supported Formats
+
+* PDF (multi-page supported)
+* Images: PNG, JPG, JPEG, TIFF, WebP, BMP, GIF, ICO, HEIC, HEIF
+
+### Slide Sizes
+
+* 16:9 Widescreen (13.33" × 7.5") — default
+* 4:3 Standard (10" × 7.5")
+* Letter (11" × 8.5")
+* A4 (11.69" × 8.27")
+* Legal (14" × 8.5")
+* Tabloid (17" × 11")
+
+### Image Placement Modes
+
+* **Fit** — No cropping; entire image visible (default)
+* **Fill** — No whitespace; may crop edges
+
+### Output Behavior
+
+* One slide per image or PDF page
+* Images sorted alphabetically
+* Centered, never stretched
+* Compatible with PowerPoint, LibreOffice, and Google Slides
+
+---
+
+## Documentation
+
+* [DOCKER.md](DOCKER.md) — Docker deployment
+* [CONTRIBUTING.md](CONTRIBUTING.md) — Development guidelines
+* [docs/GRADIO_TUTORIAL.md](docs/GRADIO_TUTORIAL.md) — Web UI technical guide
+* [docs/MAN_PAGE_USAGE.md](docs/MAN_PAGE_USAGE.md) — Man page instructions
+
+---
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/sageframe-no-kaji/pptx-builder.git
+cd pptx-builder
+pip install -e .[dev]
+```
+
+### Run Tests
+
+```bash
+pytest
+pytest --cov=pptx_builder --cov-report=html
+```
+
+### Code Quality
+
+```bash
+black src/
+flake8 src/pptx_builder/
+mypy src/pptx_builder/
+```
+
+### Pre-commit Hooks
+
+```bash
+pre-commit install
+pre-commit run --all-files
+```
+
+---
+
+## Notes
+
+* 150–300 DPI recommended for most use cases (600 DPI is slower but sharper)
+* Large PDFs (30+ pages) at 300 DPI may take 30–60 seconds
+* Temporary files are cleaned up automatically; no persistent storage is used
+* HEIC/HEIF require `pillow-heif` (included)
+
+---
+
+## Author
+
+Created by Andrew T. Marcus
+GitHub: [https://github.com/sageframe-no-kaji](https://github.com/sageframe-no-kaji)
+
+---
+
+## License
+
+MIT License — see [LICENSE](LICENSE).
+
+---
+
+## Contributing
+
+Issues and pull requests welcome:
+
+[https://github.com/sageframe-no-kaji/pptx-builder](https://github.com/sageframe-no-kaji/pptx-builder)

sageframe_pptx_builder-0.1.0/pyproject.toml

@@ -0,0 +1,84 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sageframe-pptx-builder"
+version = "0.1.0"
+description = "A local-first CLI (and optional Web UI) for converting PDFs and image folders into clean, DPI-controlled PowerPoint slides"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "Andrew Marcus", email = "andrew@sageframe.com"}
+]
+keywords = ["powerpoint", "pdf", "converter", "pptx", "slides", "cli"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business",
+    "Topic :: Multimedia :: Graphics :: Presentation",
+]
+
+dependencies = [
+    "python-pptx>=0.6.21",
+    "Pillow>=10.0.0",
+    "PyMuPDF>=1.23.0",
+    "pdf2image>=1.16.0",
+    "pillow-heif>=0.13.0",
+    "tqdm>=4.66.0",
+]
+
+[project.optional-dependencies]
+web = [
+    "gradio>=4.0.0",
+]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "flake8>=6.0.0",
+    "black>=23.0.0",
+    "mypy>=1.0.0",
+    "pre-commit>=3.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/sageframe-no-kaji/pptx-builder"
+Repository = "https://github.com/sageframe-no-kaji/pptx-builder"
+Issues = "https://github.com/sageframe-no-kaji/pptx-builder/issues"
+
+[project.scripts]
+pptx-builder = "pptx_builder.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.black]
+line-length = 100
+target-version = ["py38", "py39", "py310", "py311"]
+
+[tool.pytest.ini_options]
+testpaths = ["."]
+python_files = "test_*.py"
+python_classes = "Test*"
+python_functions = "test_*"
+markers = [
+    "integration: marks tests as integration tests (deselect with '-m \"not integration\"')",
+]
+addopts = "-v --strict-markers --tb=short"
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+ignore_missing_imports = true

sageframe_pptx_builder-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

sageframe_pptx_builder-0.1.0/src/pptx_builder/__init__.py

@@ -0,0 +1,9 @@
+"""
+pptx-builder - Convert PDFs and images to PowerPoint presentations
+"""
+
+__version__ = "0.1.0"
+
+from .core import build_presentation, convert_pdf_to_images, list_images
+
+__all__ = ["build_presentation", "convert_pdf_to_images", "list_images", "__version__"]

sageframe_pptx_builder-0.1.0/src/pptx_builder/cli.py

@@ -0,0 +1,9 @@
+#!/usr/bin/env python3
+"""
+CLI entrypoint for pptx-builder
+"""
+
+from .core import main
+
+if __name__ == "__main__":
+    main()