convashun 0.1.0__tar.gz

convashun-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: Continuous Integration
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    name: Test on ${{ matrix.os }} (Python ${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          version: "latest"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install Dependencies
+        run: uv sync --all-extras --dev
+
+      - name: Run Test Suite
+        run: uv run pytest

convashun-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,34 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv sync --dev
+      - run: uv run pytest
+
+  publish:
+    needs: validate
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write  # Mandatory configuration rule for PyPI Trusted Publishers OIDC authentication
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build Package Distributions
+        run: uv build
+
+      - name: Upload Package Distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

convashun-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

convashun-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,17 @@
+repos:
+  # 1. Standard out-of-the-box file sanity checkers
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace      # Trims unnecessary trailing spaces
+      - id: end-of-file-fixer        # Ensures files end with a clean newline
+      - id: check-yaml               # Validates your GitHub Actions workflow syntax
+      - id: check-added-large-files  # Prevents accidentally committing giant data files
+
+  # 2. Ruff: The lightning-fast Python formatter and linter
+  - repo: https://github.com/astral-sh/ruff
+    rev: v0.4.4
+    hooks:
+      - id: ruff                     # Runs linting checks (catches unused imports, variables, bugs)
+        args: [ --fix ]              # Automatically auto-fixes safe lint issues
+      - id: ruff-format              # Auto-formats your code rules to match PEP 8 style standards

convashun-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

convashun-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,24 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+We, as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
+
+## Our Standards
+Examples of behavior that contributes to a positive environment include:
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes
+
+Examples of unacceptable behavior include:
+* The use of sexualized language or imagery, and unwelcome sexual attention or advances
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information without explicit permission
+
+## Enforcement Responsibilities
+Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
+
+[ Read the full framework text at https://contributor-covenant.org ]

convashun-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,27 @@
+# Contributing to convashun 🟢
+
+Thank you for checking out `convashun`! We welcome contributions from developers, technical writers, and the engineering community-including our peers at Aurora Robotics.
+
+Follow these guardrails to ensure your pull requests are reviewed and merged quickly.
+
+## Code Style Guide
+To keep our codebase clean and standardized across different operating systems, we enforce formatting using `ruff`:
+* Run `uv run ruff format .` to auto-format your Python code before committing.
+* Run `uv run ruff check .` to check for syntax improvements and linting alerts.
+
+## Strategic Workflow to Build Changes
+1. **Fork** the repository and create your development branch from `develop`.
+2. Add your features or bug fixes.
+3. **Write Tests:** Every command tweak or dependency addition must include an accompanying test inside the `tests/` directory.
+4. **Run Verification Locally:** Ensure everything functions perfectly by executing:
+   ```bash
+   uv run pytest
+   ```
+5. Commit your work using clean messages following **Conventional Commits**:
+   * `feat: add markdown-to-pdf pipeline support`
+   * `fix: prevent color depth degradation on cmyk paths`
+
+## Submitting Pull Requests
+* Open a PR targeting our `develop` branch.
+* Ensure all your pipeline test matrix grids turn **green** inside GitHub Actions.
+* A maintainer will review your logic within a few days. Thank you for making our file utility robust!

convashun-0.1.0/LICENSE

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

convashun-0.1.0/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: convashun
+Version: 0.1.0
+Summary: A Ultra-fast, zero-config, cross-platform file conversion utility optimized for developers, documentation teams, and automated robotics data pipelines.
+Author-email: Emmanuel Omoiya <emmanuelomoiya6@gmail.com>
+License: MIT
+License-File: LICENSE
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: <3.13,>=3.12
+Requires-Dist: click<8.2.0,>=8.1.7
+Requires-Dist: openpyxl>=3.1.5
+Requires-Dist: pandas>=3.0.3
+Requires-Dist: pillow<11.0.0
+Requires-Dist: pypdf>=6.12.1
+Requires-Dist: python-docx>=1.2.0
+Requires-Dist: reportlab>=4.5.1
+Requires-Dist: rich>=13.7.0
+Requires-Dist: ruff>=0.15.14
+Requires-Dist: typer<0.10.0,>=0.9.0
+Description-Content-Type: text/markdown
+
+# convashun 🟢
+
+[![Continuous Integration](https://github.com)](https://github.com)
+[![PyPI version](https://shields.io)](https://pypi.org)
+[![License: MIT](https://shields.io)](https://opensource.org)
+[![Supported Platforms](https://shields.io)](https://pypi.org)
+
+> ⚡ Ultra-fast, zero-config, cross-platform file conversion utility optimized for developers, documentation teams, and automated robotics data pipelines.
+
+Built entirely on top of modern Python type hints (`Typer`), blazingly fast package architecture (`uv`), and robust data utilities. Developed with love for open-source engineering workflows and engineered to seamlessly support the data tracking, documentation, and asset conversion pipelines of communities like **Aurora Robotics**.
+
+---
+
+## 📊 Conversion Matrix
+
+`convashun` maps target conversions dynamically using deep binary validation rather than flimsy extension strings.
+
+
+| Category | Input Formats | Targeted Output Command | Pure Python? | System Dependencies |
+| :--- | :--- | :--- | :--- | :--- |
+| **Images** | JPG, PNG, WEBP, BMP, GIF, TIFF | `convert image to-png` | Yes | None |
+| **Images** | JPG, PNG, WEBP, BMP, GIF, TIFF | `convert image to-webp` | Yes | None |
+| **Images** | JPG, PNG, WEBP, BMP, GIF, TIFF | `convert image to-jpg` | Yes | None |
+| **Spreadsheets** | CSV (Comma Separated Log files) | `convert document to-xlsx` | Yes | None |
+| **Spreadsheets** | XLSX (Multi-sheet spreadsheet layouts)| `convert document xlsx-to-csv` | Yes | None |
+| **Documentation** | PDF Documents | `convert document to-docx` | Yes | None |
+| **Documentation** | PDF Documents | `convert document to-markdown`| Yes | None |
+| **Documentation** | Markdown Markup File (`.md`) | `convert document markdown-to-pdf`| Yes | None |
+| **Office/Academics**| DOCX, DOC, ODT, PPTX | `convert document to-pdf` | No | LibreOffice |
+| **Office/Academics**| PowerPoint Presentations (`.pptx`) | `convert document pptx-to-pdf`| No | LibreOffice |
+| **Office/Academics**| LaTeX Documents (`.tex`) | `convert document tex-to-pdf` | Yes | None |
+
+---
+
+## 🚀 Quick Start & Installation
+
+`convashun` works identically across Windows, macOS, and Linux distributions. 
+
+### Method 1: Using `uv` (Highly Recommended)
+Install `convashun` instantly into an isolated, globally accessible environment managed entirely by `uv`:
+```bash
+uv tool install convashun
+```
+
+### Method 2: Standard Installation via PyPI
+```bash
+pip install convashun
+# Or use pipx to isolate system paths cleanly
+pipx install convashun
+```
+
+---
+
+## 🛠️ Usage Examples
+
+Once installed, use the global entry command `convert` directly in your terminal interface:
+
+### 🖼️ Image Operations
+```bash
+# Convert an image into WebP format with custom compression quality settings
+convert image to-webp input_graphic.png --quality 85
+
+# Flatten a complex transparent asset safely into a JPG with a solid white backing
+convert image to-jpg transparent_blueprint.png
+
+# Optimize a standard PNG file size automatically without changing resolution parameters
+convert image to-png photographic_capture.jpg --optimize
+```
+
+### 📄 Document Layouts & Spreadsheet Processing
+```bash
+# Compile a Markdown README specification file directly into a portable PDF manual
+convert document markdown-to-pdf ARCHITECTURE.md
+
+# Extract telemetry or configuration records from an Excel document directly down to a CSV log
+convert document xlsx-to-csv metrics_workbook.xlsx --sheet "TelemetryLogs"
+
+# Convert an uneditable PDF report layout back into a semantic Markdown string file
+convert document to-markdown datasheet_report.pdf
+```
+
+---
+
+## 📦 System Prerequisites (For Office Documents Only)
+
+Commands such as `to-pdf` (for `.docx` and `.pptx`) use automated background processes to render layout definitions precisely. If a command prompts you with a missing dependency, install LibreOffice on your path using your platform package engine:
+
+* **macOS:** `brew install libreoffice`
+* **Linux (Ubuntu/Debian):** `sudo apt install libreoffice`
+* **Windows (PowerShell WinGet):** `winget install LibreOffice.LibreOffice`
+
+---
+
+## 🟢 Open Source Contributions
+
+We value input from engineering collaborators and the robotics community! 
+
+To add optimization modules or extend format parsers:
+1. Review our structured guidelines inside [CONTRIBUTING.md](CONTRIBUTING.md).
+2. Set up your local sandboxed tracking workspace via `uv`:
+   ```bash
+   git clone https://github.com
+   cd convashun
+   uv sync --dev
+   ```
+3. Run the complete automated multi-OS testing validation matrix locally before pushing changes:
+   ```bash
+   uv run pytest
+   ```
+
+---
+
+## 📄 License
+
+Distributed safely under the terms of the open-source **MIT License**. Check out [LICENSE](LICENSE) for exact operational data guidelines.

convashun-0.1.0/README.md

@@ -0,0 +1,115 @@
+# convashun 🟢
+
+[![Continuous Integration](https://github.com)](https://github.com)
+[![PyPI version](https://shields.io)](https://pypi.org)
+[![License: MIT](https://shields.io)](https://opensource.org)
+[![Supported Platforms](https://shields.io)](https://pypi.org)
+
+> ⚡ Ultra-fast, zero-config, cross-platform file conversion utility optimized for developers, documentation teams, and automated robotics data pipelines.
+
+Built entirely on top of modern Python type hints (`Typer`), blazingly fast package architecture (`uv`), and robust data utilities. Developed with love for open-source engineering workflows and engineered to seamlessly support the data tracking, documentation, and asset conversion pipelines of communities like **Aurora Robotics**.
+
+---
+
+## 📊 Conversion Matrix
+
+`convashun` maps target conversions dynamically using deep binary validation rather than flimsy extension strings.
+
+
+| Category | Input Formats | Targeted Output Command | Pure Python? | System Dependencies |
+| :--- | :--- | :--- | :--- | :--- |
+| **Images** | JPG, PNG, WEBP, BMP, GIF, TIFF | `convert image to-png` | Yes | None |
+| **Images** | JPG, PNG, WEBP, BMP, GIF, TIFF | `convert image to-webp` | Yes | None |
+| **Images** | JPG, PNG, WEBP, BMP, GIF, TIFF | `convert image to-jpg` | Yes | None |
+| **Spreadsheets** | CSV (Comma Separated Log files) | `convert document to-xlsx` | Yes | None |
+| **Spreadsheets** | XLSX (Multi-sheet spreadsheet layouts)| `convert document xlsx-to-csv` | Yes | None |
+| **Documentation** | PDF Documents | `convert document to-docx` | Yes | None |
+| **Documentation** | PDF Documents | `convert document to-markdown`| Yes | None |
+| **Documentation** | Markdown Markup File (`.md`) | `convert document markdown-to-pdf`| Yes | None |
+| **Office/Academics**| DOCX, DOC, ODT, PPTX | `convert document to-pdf` | No | LibreOffice |
+| **Office/Academics**| PowerPoint Presentations (`.pptx`) | `convert document pptx-to-pdf`| No | LibreOffice |
+| **Office/Academics**| LaTeX Documents (`.tex`) | `convert document tex-to-pdf` | Yes | None |
+
+---
+
+## 🚀 Quick Start & Installation
+
+`convashun` works identically across Windows, macOS, and Linux distributions. 
+
+### Method 1: Using `uv` (Highly Recommended)
+Install `convashun` instantly into an isolated, globally accessible environment managed entirely by `uv`:
+```bash
+uv tool install convashun
+```
+
+### Method 2: Standard Installation via PyPI
+```bash
+pip install convashun
+# Or use pipx to isolate system paths cleanly
+pipx install convashun
+```
+
+---
+
+## 🛠️ Usage Examples
+
+Once installed, use the global entry command `convert` directly in your terminal interface:
+
+### 🖼️ Image Operations
+```bash
+# Convert an image into WebP format with custom compression quality settings
+convert image to-webp input_graphic.png --quality 85
+
+# Flatten a complex transparent asset safely into a JPG with a solid white backing
+convert image to-jpg transparent_blueprint.png
+
+# Optimize a standard PNG file size automatically without changing resolution parameters
+convert image to-png photographic_capture.jpg --optimize
+```
+
+### 📄 Document Layouts & Spreadsheet Processing
+```bash
+# Compile a Markdown README specification file directly into a portable PDF manual
+convert document markdown-to-pdf ARCHITECTURE.md
+
+# Extract telemetry or configuration records from an Excel document directly down to a CSV log
+convert document xlsx-to-csv metrics_workbook.xlsx --sheet "TelemetryLogs"
+
+# Convert an uneditable PDF report layout back into a semantic Markdown string file
+convert document to-markdown datasheet_report.pdf
+```
+
+---
+
+## 📦 System Prerequisites (For Office Documents Only)
+
+Commands such as `to-pdf` (for `.docx` and `.pptx`) use automated background processes to render layout definitions precisely. If a command prompts you with a missing dependency, install LibreOffice on your path using your platform package engine:
+
+* **macOS:** `brew install libreoffice`
+* **Linux (Ubuntu/Debian):** `sudo apt install libreoffice`
+* **Windows (PowerShell WinGet):** `winget install LibreOffice.LibreOffice`
+
+---
+
+## 🟢 Open Source Contributions
+
+We value input from engineering collaborators and the robotics community! 
+
+To add optimization modules or extend format parsers:
+1. Review our structured guidelines inside [CONTRIBUTING.md](CONTRIBUTING.md).
+2. Set up your local sandboxed tracking workspace via `uv`:
+   ```bash
+   git clone https://github.com
+   cd convashun
+   uv sync --dev
+   ```
+3. Run the complete automated multi-OS testing validation matrix locally before pushing changes:
+   ```bash
+   uv run pytest
+   ```
+
+---
+
+## 📄 License
+
+Distributed safely under the terms of the open-source **MIT License**. Check out [LICENSE](LICENSE) for exact operational data guidelines.

convashun-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[project]
+name = "convashun"
+version = "0.1.0"
+description = "A Ultra-fast, zero-config, cross-platform file conversion utility optimized for developers, documentation teams, and automated robotics data pipelines."
+readme = "README.md"
+# requires-python = ">=3.12"
+requires-python = ">=3.12,<3.13"
+license = { text = "MIT" }
+authors = [
+    { name = "Emmanuel Omoiya", email = "emmanuelomoiya6@gmail.com" }
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Environment :: Console",
+]
+dependencies = [
+    "ruff>=0.15.14",
+    "click>=8.1.7,<8.2.0",
+    # "typer>=0.12.0",
+    "typer>=0.9.0,<0.10.0",
+    "rich>=13.7.0",  # Added for beautiful cross-platform terminal formatting
+    "pillow<11.0.0",
+    "pandas>=3.0.3",
+    "openpyxl>=3.1.5",
+    "pypdf>=6.12.1",
+    "python-docx>=1.2.0",
+    "reportlab>=4.5.1",
+]
+
+[project.scripts]
+convert = "convashun.cli:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = [
+    "pre-commit>=4.6.0",
+    "pytest>=9.0.3",
+    "reportlab>=4.5.1",
+]

convashun-0.1.0/smoke_test.py

@@ -0,0 +1,86 @@
+import subprocess
+import sys
+from pathlib import Path
+
+def print_step(msg: str):
+    print(f"\n🟢 [SMOKE TEST] {msg}")
+
+def print_success(msg: str):
+    print(f"✅ SUCCESS: {msg}")
+
+def print_failure(msg: str):
+    print(f"❌ FAILURE: {msg}")
+    sys.exit(1)
+
+def main():
+    print_step("Initializing cross-platform CLI validation pipeline...")
+    
+    # 1. Verify the runtime can execute 'uv' and resolve project status
+    try:
+        subprocess.run(["uv", "--version"], check=True, stdout=subprocess.DEVNULL)
+        print_success("Verified local 'uv' package environment tool binary mapping.")
+    except Exception:
+        print_failure("'uv' is not installed or missing from system path variables.")
+
+    # 2. Rebuild local dependency hooks and clear legacy sync tracks
+    print_step("Syncing dependency configurations and updating editable build links...")
+    try:
+        subprocess.run(["uv", "sync"], check=True)
+        print_success("Package tracking indexes updated smoothly.")
+    except subprocess.CalledProcessError as e:
+        print_failure(f"Failed to sync isolated project state environment configurations: {e}")
+
+    # 3. Test basic CLI entry point invocation 
+    print_step("Testing global entry script invocation layout ('uv run convert --help')...")
+    try:
+        result = subprocess.run(
+            ["uv", "run", "convert", "--help"],
+            capture_output=True,
+            text=True,
+            check=True
+        )
+        # Check for your unique project headline to ensure it's executing YOUR tool
+        # if "Ultra-fast cross-platform file conversion utility" in result.stdout:
+        if "A Ultra-fast, zero-config, cross-platform file conversion utility optimized for developers, documentation teams, and automated robotics data pipelines." in result.stdout:
+            print_success("Main CLI command group entry point resolved and answered correctly!")
+        else:
+            print_failure(f"The 'convert' command answered, but returned an unexpected payload:\n{result.stdout}")
+    except subprocess.CalledProcessError as e:
+        print_failure(f"CLI invocation crashed or returned a non-zero exit status:\n{e.stderr}")
+
+    # 4. Test image subcommand navigation track
+    print_step("Testing image submodule command mapping ('uv run convert image --help')...")
+    try:
+        result = subprocess.run(
+            ["uv", "run", "convert", "image", "--help"],
+            capture_output=True,
+            text=True,
+            check=True
+        )
+        if "to-png" in result.stdout and "to-webp" in result.stdout:
+            print_success("Image format conversion subcommands registered correctly.")
+        else:
+            print_failure(f"Image commands routing appears corrupted or incomplete:\n{result.stdout}")
+    except subprocess.CalledProcessError as e:
+        print_failure(f"Image subcommand group navigation failed:\n{e.stderr}")
+
+    # 5. Test document subcommand navigation track
+    print_step("Testing document submodule command mapping ('uv run convert document --help')...")
+    try:
+        result = subprocess.run(
+            ["uv", "run", "convert", "document", "--help"],
+            capture_output=True,
+            text=True,
+            check=True
+        )
+        if "to-xlsx" in result.stdout and "to-markdown" in result.stdout:
+            print_success("Document and data layout conversion subcommands registered correctly.")
+        else:
+            print_failure(f"Document commands routing appears corrupted or incomplete:\n{result.stdout}")
+    except subprocess.CalledProcessError as e:
+        print_failure(f"Document subcommand group navigation failed:\n{e.stderr}")
+
+    print_step("All system entry routes verified successfully! Your application environment is healthy. 🎉")
+
+if __name__ == "__main__":
+    main()

convashun-0.1.0/src/convashun/cli.py

@@ -0,0 +1,28 @@
+import typer
+from rich.console import Console
+from convashun import image, document
+
+# Create the main Typer application
+app = typer.Typer(
+    name="Convashun",
+    help="⚡ Ultra-fast cross-platform file conversion utility ⚡",
+    add_completion=True,
+)
+
+# Initialize rich console for error and status printing
+console = Console()
+
+# Attach sub-modules as command groups
+app.add_typer(document.app, name="document", help="Convert document formats (DOCX, PDF, TXT, etc.)")
+app.add_typer(image.app, name="image", help="Convert image formats (PNG, JPG, WEBP, etc.)")
+
+@app.callback()
+def main():
+    """
+    Global settings or configurations can go here.
+    This executes before any subcommand.
+    """
+    pass
+
+if __name__ == "__main__":
+    app()