first commit

Author: chrispydizzle

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,33 @@
+---
+name: Bug report
+about: Report a reproducible OCR, layout, packaging, or CLI problem
+title: "[bug] "
+labels: bug
+---
+
+## Summary
+
+Describe the problem in one or two sentences.
+
+## Environment
+
+- OS:
+- Python version:
+- Tesseract version:
+- Command used:
+
+## Input
+
+Describe the input image style and attach a safe-to-share sample if possible.
+
+## Expected result
+
+What did you expect to happen?
+
+## Actual result
+
+What actually happened?
+
+## Notes
+
+Include screenshots, terminal output, or other context that will help reproduce the issue.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,22 @@
+---
+name: Feature request
+about: Suggest an improvement to OCR quality, PPTX output, developer experience, or packaging
+title: "[feature] "
+labels: enhancement
+---
+
+## Problem
+
+What is missing or frustrating today?
+
+## Proposed change
+
+What would you like `png2pptx` to do?
+
+## Why it matters
+
+How would this improve real use of the project?
+
+## Extra context
+
+Add mockups, examples, or references if they help explain the request.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,15 @@
+## Summary
+
+- 
+
+## Testing
+
+- [ ] `pytest -q`
+- [ ] smoke-tested the CLI if behavior changed
+
+## Checklist
+
+- [ ] docs updated when behavior or defaults changed
+- [ ] tests added or updated when behavior changed
+- [ ] no local/generated artifacts were committed by accident
+- [ ] limitations or tradeoffs are called out if relevant

.github/workflows/ci.yml

@@ -0,0 +1,53 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install Tesseract
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y tesseract-ocr
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest -q
+
+  package:
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Build distribution artifacts
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build

.gitignore

@@ -0,0 +1,52 @@
+# Current local/generated paths observed in this repo:
+# - .venv/
+# - .pytest_cache/
+# - build/
+# - png2pptx.egg-info/
+# - .artifacts/
+
+# Python caches
+__pycache__/
+*.py[cod]
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Test and tool caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Editors
+.vscode/
+.idea/
+
+# Packaging artifacts
+build/
+dist/
+*.egg-info/
+pip-wheel-metadata/
+
+# Local/session artifacts
+.artifacts/
+
+# Generated outputs and diagnostics
+output*.pptx
+sample_output.pptx
+examples/sample_output.pptx
+result*.pptx
+*_fast.pptx
+*_aggressive*.pptx
+*_tuned*.pptx
+*_quality*.pptx
+*_clean.png
+*_clean_preview.png
+debug_overlay.png
+
+# OS files
+.DS_Store
+Thumbs.db

CODE_OF_CONDUCT.md

@@ -0,0 +1,33 @@
+# Code of Conduct
+
+## Our standard
+
+This project aims to be welcoming, respectful, and constructive.
+
+Please:
+
+- be respectful in disagreement
+- assume good intent
+- give feedback on code and ideas, not people
+- avoid harassment, discrimination, or personal attacks
+
+## Unacceptable behavior
+
+Unacceptable behavior includes:
+
+- abusive or insulting language
+- harassment or intimidation
+- discriminatory remarks
+- doxxing or sharing private information without permission
+- repeated bad-faith disruption of discussions or review
+
+## Enforcement
+
+Project maintainers may remove comments, issues, or contributions that do not
+support a healthy working environment. Repeated or severe violations may lead
+to temporary or permanent bans from project spaces.
+
+## Reporting
+
+If something happens that should be reviewed by a maintainer, open a minimal
+issue requesting contact without reposting harmful content in public.

CONTRIBUTING.md

@@ -0,0 +1,50 @@
+# Contributing to png2pptx
+
+Thanks for taking an interest in `png2pptx`.
+
+## Scope
+
+The current public release is a **v0.1 beta**. Contributions that improve reliability, documentation, packaging, tests, and visually obvious OCR/PPTX issues are the best fit right now.
+
+If you want to propose a larger change, open an issue first so the direction is clear before you invest time in a big PR.
+
+## Development setup
+
+1. Install **Python 3.10+**
+2. Install **Tesseract OCR**
+3. Install the project in editable mode with development dependencies:
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Run the test suite
+
+```bash
+pytest -q
+```
+
+## Useful smoke test
+
+```bash
+png2pptx convert examples/sample_input.png -o sample_output.pptx
+```
+
+## Pull request checklist
+
+- keep changes scoped to the problem you are solving
+- update docs when behavior or defaults change
+- add or update tests when behavior changes
+- do not commit local environment files, build outputs, or one-off debug artifacts
+- call out any tradeoffs or limitations in the PR description
+
+## Reporting OCR quality issues
+
+When filing OCR/layout bugs, include:
+
+- operating system
+- Python version
+- Tesseract version
+- the command you ran
+- what you expected vs what actually happened
+- a safe-to-share input image or screenshot if possible

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 png2pptx contributors
+
+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.