convashun 0.1.0__py3-none-any.whl

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()

convashun/document.py

@@ -0,0 +1,514 @@
+import typer
+import subprocess
+import sys
+import pandas as pd
+import shutil
+from pathlib import Path
+from rich.console import Console
+from pypdf import PdfReader
+from docx import document
+
+app = typer.Typer()
+console = Console()
+
+
+@app.command("to-pdf")
+def to_pdf(
+    input_path: Path = typer.Argument(
+        ..., 
+        exists=True, 
+        file_okay=True, 
+        dir_okay=False, 
+        readable=True,
+        help="Path to the source document file (e.g., .docx, .doc, .odt, .rtf)"
+    ),
+):
+    """
+    Convert an incoming document file (DOCX/DOC/ODT) to PDF format.
+    """
+    console.print(f"[yellow]Processing:[/yellow] {input_path.name}...")
+    
+    # Cross-platform safe path modification
+    output_path = input_path.with_suffix(".pdf")
+    
+    # 1. Locate LibreOffice on the user's system path dynamically
+    # Windows uses 'soffice', Linux/macOS usually map to 'libreoffice' or 'soffice'
+    cmd = shutil.which("libreoffice") or shutil.which("soffice")
+    
+    if not cmd:
+        console.print("[bold red]Missing Dependency Error:[/bold red]")
+        console.print("LibreOffice is required to convert office documents on your machine.")
+        console.print("\n[yellow]How to install it:[/yellow]")
+        console.print("• [bold]macOS:[/bold] `brew install libreoffice`")
+        console.print("• [bold]Linux (Ubuntu/Debian):[/bold] `sudo apt install libreoffice`")
+        console.print("• [bold]Windows:[/bold] Install via winget: `winget install LibreOffice.LibreOffice` or download manually.")
+        raise typer.Exit(code=1)
+        
+    try:
+        # 2. Run the cross-platform headless conversion command
+        # This reads the document, runs in the background, and generates a clean PDF
+        subprocess.run([
+            cmd, 
+            "--headless", 
+            "--convert-to", "pdf", 
+            str(input_path),
+            "--outdir", str(input_path.parent)
+        ], check=True, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+        
+        console.print(f"[bold green]Success![/bold green] Saved to {output_path}")
+    except subprocess.CalledProcessError as e:
+        console.print(f"[bold red]LibreOffice engine failed to process the file:[/bold red] {e}")
+        raise typer.Exit(code=1)
+    except Exception as e:
+        console.print(f"[bold red]Error converting file:[/bold red] {e}")
+        raise typer.Exit(code=1)
+
+
+@app.command("pptx-to-pdf")
+def pptx_to_pdf(
+    input_path: Path = typer.Argument(
+        ..., 
+        exists=True, 
+        file_okay=True, 
+        dir_okay=False, 
+        readable=True,
+        help="Path to the source PowerPoint (.pptx or .ppt) file"
+    ),
+):
+    """
+    Convert an incoming PowerPoint presentation (PPTX/PPT) to PDF format.
+    """
+    # Defensive check: Ensure they are actually passing a presentation file
+    if input_path.suffix.lower() not in (".pptx", ".ppt"):
+        console.print("[bold red]Format Error:[/bold red] This command only supports converting .pptx or .ppt files to .pdf.")
+        raise typer.Exit(code=1)
+
+    console.print(f"[yellow]Processing Presentation:[/yellow] {input_path.name}...")
+    
+    # Cross-platform safe path modification
+    output_path = input_path.with_suffix(".pdf")
+    
+    # 1. Locate LibreOffice dynamically on the user's system path
+    cmd = shutil.which("libreoffice") or shutil.which("soffice")
+    
+    if not cmd:
+        console.print("[bold red]Missing Dependency Error:[/bold red]")
+        console.print("LibreOffice is required to convert presentation files on your machine.")
+        console.print("\n[yellow]How to install it:[/yellow]")
+        console.print("• [bold]macOS:[/bold] `brew install libreoffice`")
+        console.print("• [bold]Linux (Ubuntu/Debian):[/bold] `sudo apt install libreoffice`")
+        console.print("• [bold]Windows:[/bold] Install via winget: `winget install LibreOffice.LibreOffice` or download manually.")
+        raise typer.Exit(code=1)
+        
+    try:
+        # 2. Run the cross-platform headless conversion command
+        # LibreOffice reads presentation slide structures natively and flattens them cleanly
+        subprocess.run([
+            cmd, 
+            "--headless", 
+            "--convert-to", "pdf", 
+            str(input_path),
+            "--outdir", str(input_path.parent)
+        ], check=True, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+        
+        console.print(f"[bold green]Success![/bold green] Saved presentation to {output_path}")
+    except subprocess.CalledProcessError as e:
+        console.print(f"[bold red]LibreOffice engine failed to process the presentation:[/bold red] {e}")
+        raise typer.Exit(code=1)
+    except Exception as e:
+        console.print(f"[bold red]Error converting presentation file:[/bold red] {e}")
+        raise typer.Exit(code=1)
+
+        import pandas as pd
+
+
+@app.command("csv-to-xlsx")
+def csv_to_xlsx(input_path: Path = typer.Argument(..., exists=True)):
+    """Convert a flat CSV log file into an Excel Spreadsheet (.xlsx)."""
+    if input_path.suffix.lower() != ".csv":
+        console.print("[bold red]Format Error:[/bold red] This command only supports converting .csv files.")
+        raise typer.Exit(code=1)
+    output_path = input_path.with_suffix(".xlsx")
+    try:
+        df = pd.read_csv(input_path)
+        df.to_excel(output_path, index=False, engine='openpyxl')
+        console.print(f"[bold green]Success![/bold green] Spreadsheet saved to {output_path}")
+    except Exception as e:
+        console.print(f"[bold red]Data processing failed:[/bold red] {e}")
+
+
+@app.command("xlsx-to-csv")
+def xlsx_to_csv(
+    input_path: Path = typer.Argument(
+        ..., 
+        exists=True, 
+        file_okay=True, 
+        dir_okay=False, 
+        readable=True,
+        help="Path to the source Excel (.xlsx) spreadsheet"
+    ),
+    sheet_name: str = typer.Option(
+        "0", 
+        "--sheet", "-s", 
+        help="Name or index of the spreadsheet tab to extract"
+    ),
+):
+    """
+    Flatten a structured Excel Spreadsheet (.xlsx) sheet into a raw data CSV file.
+    """
+    if input_path.suffix.lower() != ".xlsx":
+        console.print("[bold red]Format Error:[/bold red] This command only supports converting .xlsx files.")
+        raise typer.Exit(code=1)
+
+    console.print(f"[yellow]Flattening spreadsheet records:[/yellow] {input_path.name}...")
+    output_path = input_path.with_suffix(".csv")
+    
+    try:
+        # Convert numeric string token to raw integer index dynamically
+        parsed_sheet = int(sheet_name) if sheet_name.isdigit() else sheet_name
+        
+        # Pull data layout using openpyxl engine underneath pandas
+        df = pd.read_excel(input_path, sheet_name=parsed_sheet, engine="openpyxl")
+        
+        # Save output records with standard comma-separation formatting
+        df.to_csv(output_path, index=False)
+        
+        console.print(f"[bold green]Success![/bold green] Extracted data saved to {output_path}")
+    except Exception as e:
+        console.print(f"[bold red]Flattening procedure failed:[/bold red] {e}")
+        raise typer.Exit(code=1)
+
+
+@app.command("to-csv")
+def to_csv(
+    input_path: Path = typer.Argument(
+        ..., 
+        exists=True, 
+        file_okay=True, 
+        dir_okay=False, 
+        readable=True,
+        help="Path to the source Excel (.xlsx) file"
+    ),
+    sheet_name: str = typer.Option(
+        "0", 
+        "--sheet", "-s", 
+        help="Name or 0-based index of the Excel sheet to convert"
+    ),
+):
+    """
+    Convert an Excel Spreadsheet (.xlsx) sheet into a raw data CSV file.
+    """
+    if input_path.suffix.lower() != ".xlsx":
+        console.print("[bold red]Format Error:[/bold red] This command only supports converting .xlsx files.")
+        raise typer.Exit(code=1)
+
+    console.print(f"[yellow]Extracting spreadsheet data:[/yellow] {input_path.name}...")
+    output_path = input_path.with_suffix(".csv")
+    
+    try:
+        # Convert numeric string index to int if applicable
+        parsed_sheet = int(sheet_name) if sheet_name.isdigit() else sheet_name
+        
+        # Read the Excel file via openpyxl engine
+        df = pd.read_excel(input_path, sheet_name=parsed_sheet, engine="openpyxl")
+        
+        # Save to CSV without the arbitrary row index numbers
+        df.to_csv(output_path, index=False)
+        
+        console.print(f"[bold green]Success![/bold green] Extracted data saved to {output_path}")
+    except Exception as e:
+        console.print(f"[bold red]Data extraction failed:[/bold red] {e}")
+        raise typer.Exit(code=1)
+
+@app.command("to-xlsx")
+def to_xlsx(
+    input_path: Path = typer.Argument(
+        ..., 
+        exists=True, 
+        file_okay=True, 
+        dir_okay=False, 
+        readable=True,
+        help="Path to the source CSV file"
+    ),
+):
+    """
+    Convert flat CSV raw rows into a structured Excel Spreadsheet (.xlsx).
+    """
+    if input_path.suffix.lower() != ".csv":
+        console.print("[bold red]Format Error:[/bold red] This command only supports converting .csv files.")
+        raise typer.Exit(code=1)
+
+    console.print(f"[yellow]Structuring spreadsheet layout:[/yellow] {input_path.name}...")
+    output_path = input_path.with_suffix(".xlsx")
+    
+    try:
+        # Read raw tabular rows
+        df = pd.read_csv(input_path)
+        
+        # Stream down directly into openpyxl formatting engine
+        df.to_excel(output_path, index=False, engine="openpyxl")
+        
+        console.print(f"[bold green]Success![/bold green] Spreadsheet saved to {output_path}")
+    except Exception as e:
+        console.print(f"[bold red]Spreadsheet composition failed:[/bold red] {e}")
+        raise typer.Exit(code=1)
+
+
+def install_tex_engine_automatically():
+    """Triggers the operating system's native package manager to install a lightweight CLI TeX engine."""
+    console.print("\n[yellow]Attempting to bootstrap a lightweight TeX layout engine for you...[/yellow]")
+    
+    try:
+        if sys.platform == "win32":
+            console.print("[blue]Running Windows Package Manager (winget) for MiKTeX...[/blue]")
+            # Triggers a clean, silent install of the core minimal Windows TeX compilation engine
+            subprocess.run(["winget", "install", "MiKTeX.MiKTeX", "--silent"], check=True)
+            
+        elif sys.platform == "darwin":
+            console.print("[blue]Running macOS Homebrew for BasicTeX (Lightweight distribution)...[/blue]")
+            # Installs a minimal ~100MB CLI-only distribution instead of the multi-gigabyte full MacTeX package
+            subprocess.run(["brew", "install", "--cask", "basictex"], check=True)
+            
+        else:  # Linux (Ubuntu / Debian target check)
+            if shutil.which("apt-get"):
+                console.print("[blue]Running Linux Advanced Package Tool (apt) for lightweight texlive-base...[/blue]")
+                subprocess.run(["sudo", "apt-get", "update"], check=True)
+                subprocess.run(["sudo", "apt-get", "install", "-y", "texlive-latex-base"], check=True)
+            else:
+                raise RuntimeError("Unsupported Linux package distribution manager.")
+                
+        console.print("[bold green]Success![/bold green] TeX compilation engine installation complete.")
+        console.print("[yellow]Note: Please restart your terminal window for the system path variables to take effect.[/yellow]")
+        
+    except Exception as e:
+        console.print(f"[bold red]Auto-installation failed:[/bold red] {e}")
+        console.print("[yellow]Please configure a compiler (like MiKTeX or TeX Live) manually on your path.[/yellow]")
+
+
+@app.command("tex-to-pdf")
+def tex_to_pdf(
+    input_path: Path = typer.Argument(
+        ..., exists=True, file_okay=True, dir_okay=False, readable=True,
+        help="Path to the source LaTeX (.tex) typesetting file"
+    ),
+):
+    """
+    Compile a LaTeX (.tex) typesetting file into a high-fidelity PDF document.
+    """
+    if input_path.suffix.lower() != ".tex":
+        console.print("[bold red]Format Error:[/bold red] This command only supports .tex files.")
+        raise typer.Exit(code=1)
+
+    console.print(f"[yellow]Typesetting document layout:[/yellow] {input_path.name}...")
+    output_path = input_path.with_suffix(".pdf")
+    
+    # Locate native cross-platform latex binary mapping paths dynamically
+    cmd = shutil.which("pdflatex") or shutil.which("latexmk")
+    
+    if not cmd:
+        console.print("[bold red]Missing Dependency Error:[/bold red] A native TeX compiler layout engine was not found.")
+        
+        # Interactive Helper Selector
+        confirm = typer.confirm("Would you like convashun to automatically install a lightweight TeX engine via your system package manager?")
+        if confirm:
+            install_tex_engine_automatically()
+            raise typer.Exit(code=0)
+        else:
+            console.print("[red]Compilation aborted because system dependencies are missing.[/red]")
+            raise typer.Exit(code=1)
+        
+    try:
+        # Run the native compiler safely in non-interactive batch mode
+        # It suppresses hanging user confirmation alerts if errors exist in the raw document layout
+        subprocess.run([
+            cmd, 
+            "-interaction=nonstopmode", 
+            f"-output-directory={str(input_path.parent)}",
+            str(input_path)
+        ], check=True, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+        
+        # Clean up ancillary layout compilation log files generated by native TeX tools (.log, .aux)
+        for ext in (".aux", ".log", ".out"):
+            temp_file = input_path.with_suffix(ext)
+            if temp_file.exists():
+                temp_file.unlink()
+                
+        console.print(f"[bold green]Success![/bold green] PDF compiled cleanly to {output_path}")
+    except subprocess.CalledProcessError as e:
+        console.print(f"[bold red]LaTeX engine failed to process the document structures:[/bold red] {e}")
+        raise typer.Exit(code=1)
+    except Exception as e:
+        console.print(f"[bold red]Error converting file:[/bold red] {e}")
+        raise typer.Exit(code=1)
+
+@app.command("tex-to-pdf-native")
+def tex_to_pdf_native(input_path: Path = typer.Argument(..., exists=True)):
+    """Compile LaTeX to PDF using the local system engine."""
+    if input_path.suffix.lower() != ".tex":
+        console.print("[bold red]Format Error:[/bold red] Target must be a LaTex file.")
+        raise typer.Exit(code=1)
+    cmd = shutil.which("pdflatex")
+    
+    if not cmd:
+        console.print("[bold red]Missing Dependency Error:[/bold red]")
+        console.print("A native TeX compiler (`pdflatex`) is required for this command.")
+        console.print("\n[yellow]How to install it:[/yellow]")
+        console.print("• [bold]macOS:[/bold] `brew install --cask mactex-no-gui`")
+        console.print("• [bold]Linux (Ubuntu):[/bold] `sudo apt install texlive-latex-base`")
+        console.print("• [bold]Windows:[/bold] Install MikTeX from `miktex.org`")
+        raise typer.Exit(code=1)
+        
+    try:
+        # Execute the compiler tool inside the directory where the target file exists
+        subprocess.run([
+            cmd, 
+            "-interaction=nonstopmode", 
+            "-output-directory", str(input_path.parent),
+            str(input_path)
+        ], check=True, stdout=subprocess.DEVNULL)
+        console.print(f"[bold green]Success![/bold green] Compiled via system engine.")
+    except Exception as e:
+        console.print(f"[bold red]Compilation crashed:[/bold red] {e}")
+
+def install_libreoffice_automatically():
+    """Triggers the operating system's native package manager to install LibreOffice."""
+    console.print("\n[yellow]Attempting to bootstrap LibreOffice for you...[/yellow]")
+    
+    try:
+        if sys.platform == "win32":
+            console.print("[blue]Running Windows Package Manager (winget)...[/blue]")
+            # Executes Windows' official built-in app installer
+            subprocess.run(["winget", "install", "LibreOffice.LibreOffice", "--silent"], check=True)
+            
+        elif sys.platform == "darwin":
+            console.print("[blue]Running macOS Homebrew...[/blue]")
+            subprocess.run(["brew", "install", "--cask", "libreoffice"], check=True)
+            
+        else:  # Linux (Ubuntu / Debian target check)
+            if shutil.which("apt-get"):
+                console.print("[blue]Running Linux Advanced Package Tool (apt)...[/blue]")
+                subprocess.run(["sudo", "apt-get", "update"], check=True)
+                subprocess.run(["sudo", "apt-get", "install", "-y", "libreoffice"], check=True)
+            else:
+                raise RuntimeError("Unsupported Linux package distribution manager.")
+                
+        console.print("[bold green]Success![/bold green] LibreOffice installation completed.")
+        console.print("[yellow]Note: Please restart your terminal window for the system path changes to take effect.[/yellow]")
+        
+    except Exception as e:
+        console.print(f"[bold red]Auto-installation failed:[/bold red] {e}")
+        console.print("[yellow]Please download LibreOffice manually from https://libreoffice.org[/yellow]")
+
+
+
+@app.command("pptx-to-pdf")
+def pptx_to_pdf(
+    input_path: Path = typer.Argument(
+        ..., 
+        exists=True, 
+        file_okay=True, 
+        dir_okay=False, 
+        readable=True,
+        help="Path to the source PowerPoint (.pptx or .ppt) file"
+    ),
+):
+    """
+    Convert a PowerPoint presentation (PPTX/PPT) to PDF format cleanly.
+    """
+    if input_path.suffix.lower() not in (".pptx", ".ppt"):
+        console.print("[bold red]Format Error:[/bold red] This command only supports .pptx or .ppt files.")
+        raise typer.Exit(code=1)
+
+    console.print(f"[yellow]Processing Presentation:[/yellow] {input_path.name}...")
+    output_path = input_path.with_suffix(".pdf")
+    
+    # Locate LibreOffice dynamically on the user's system path
+    cmd = shutil.which("libreoffice") or shutil.which("soffice")
+    if not cmd:
+        console.print("[bold red]Missing Dependency Error:[/bold red] LibreOffice is required to handle Office file layouts.")
+        
+        # Interactive Prompt to make life easier for the user
+        confirm = typer.confirm("Would you like convashun to automatically install LibreOffice via your system package manager?")
+        if confirm:
+            install_libreoffice_automatically()
+            raise typer.Exit(code=0)
+        else:
+            console.print("[red]Conversion aborted because system dependencies are missing.[/red]")
+            raise typer.Exit(code=1)
+        
+    try:
+        subprocess.run([
+            cmd, "--headless", "--convert-to", "pdf", 
+            str(input_path), "--outdir", str(input_path.parent)
+        ], check=True, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+        console.print(f"[bold green]Success![/bold green] Saved presentation to {output_path}")
+    except Exception as e:
+        console.print(f"[bold red]Conversion failed:[/bold red] {e}")
+        raise typer.Exit(code=1)
+
+@app.command("to-markdown")
+def to_markdown(
+    input_path: Path = typer.Argument(..., exists=True, file_okay=True, dir_okay=False)
+):
+    """
+    Extract text contents from a PDF file into clean Markdown formatting (.md).
+    """
+    if input_path.suffix.lower() != ".pdf":
+        console.print("[bold red]Format Error:[/bold red] Target must be a PDF file.")
+        raise typer.Exit(code=1)
+
+    console.print(f"[yellow]Extracting text layouts:[/yellow] {input_path.name}...")
+    output_path = input_path.with_suffix(".md")
+    
+    try:
+        # pypdf is 100% pure Python, no C++ compilation or DLL required
+        reader = PdfReader(input_path)
+        markdown_lines = [f"# Document: {input_path.stem}\n"]
+        
+        for i, page in enumerate(reader.pages, 1):
+            text = page.extract_text()
+            if text.strip():
+                markdown_lines.append(f"## Page {i}\n{text}\n")
+                
+        output_path.write_text("\n".join(markdown_lines), encoding="utf-8")
+        console.print(f"[bold green]Success![/bold green] Extracted text layout to {output_path}")
+    except Exception as e:
+        console.print(f"[bold red]Markdown parsing failed:[/bold red] {e}")
+        raise typer.Exit(code=1)
+
+
+@app.command("to-docx")
+def to_docx(
+    input_path: Path = typer.Argument(..., exists=True, file_okay=True, dir_okay=False)
+):
+    """
+    Convert flat PDF text segments directly into an editable Word Document (.docx).
+    """
+    if input_path.suffix.lower() != ".pdf":
+        console.print("[bold red]Format Error:[/bold red] Target file must be a PDF.")
+        raise typer.Exit(code=1)
+
+    console.print(f"[yellow]Building document tables:[/yellow] {input_path.name}...")
+    output_path = input_path.with_suffix(".docx")
+    
+    try:
+        reader = PdfReader(input_path)
+        doc = Document()
+        doc.add_heading(input_path.stem, level=0)
+        
+        has_content = False
+        for page in reader.pages:
+            text = page.extract_text()
+            if text and text.strip():
+                doc.add_paragraph(text)
+                has_content = True
+            else:
+                # Safe fallback option: ensures python-docx always has a structural 
+                # paragraph element layer to bind to when saving the file data
+                doc.add_paragraph("[Empty Page or Unextractable Layout Text Element]")
+                
+        doc.save(output_path)
+        console.print(f"[bold green]Success![/bold green] Document compiled cleanly to {output_path}")
+    except Exception as e:
+        console.print(f"[bold red]DOCX composition failed:[/bold red] {e}")
+        raise typer.Exit(code=1)

convashun/image.py

@@ -0,0 +1,123 @@
+import typer
+import subprocess
+import shutil
+from PIL import Image
+from pathlib import Path
+from rich.console import Console
+
+app = typer.Typer()
+console = Console()
+
+@app.command("to-png")
+def to_png(
+    input_path: Path = typer.Argument(
+        ..., 
+        exists=True, 
+        file_okay=True, 
+        dir_okay=False, 
+        readable=True,
+        help="Path to the source image file"
+    ),
+    optimize: bool = typer.Option(
+        False, 
+        "--optimize", "-o", 
+        help="Optimize the PNG file size (takes slightly longer to save)"
+    ),
+):
+    """
+    Convert any incoming image file to PNG format.
+    """
+    console.print(f"[yellow]Processing:[/yellow] {input_path.name}...")
+    
+    # Cross-platform safe path modification
+    output_path = input_path.with_suffix(".png")
+    
+    try:
+        with Image.open(input_path) as img:
+            if img.mode == "CMYK":
+                img = img.convert("RGB")
+                
+            img.save(output_path, format="PNG", optimize=optimize)
+        console.print(f"[bold green]Success![/bold green] Saved to {output_path}")
+    except Exception as e:
+        console.print(f"[bold red]Error converting file:[/bold red] {e}")
+        raise typer.Exit(code=1)
+
+@app.command("to-webp")
+def to_png(
+    input_path: Path = typer.Argument(
+        ..., 
+        exists=True, 
+        file_okay=True, 
+        dir_okay=False, 
+        readable=True,
+        help="Path to the source image file"
+    ),
+    quality: int = typer.Option(
+        90, 
+        "--quality", "-q", 
+        min=1, max=100, 
+        help="Compression quality (1-100). 100 means lossless."
+    ),
+):
+    """
+    Convert any incoming image file to WEBP format.
+    """
+    console.print(f"[yellow]Processing:[/yellow] {input_path.name}...")
+    
+    # Cross-platform safe path modification
+    output_path = input_path.with_suffix(".webp")
+    
+    try:
+        with Image.open(input_path) as img:
+            if img.mode == "CMYK":
+                img = img.convert("RGB")
+                
+            img.save(output_path, format="WEBP", quality=quality)
+
+        console.print(f"[bold green]Success![/bold green] Saved to {output_path} (Quality: {quality})")
+    except Exception as e:
+        console.print(f"[bold red]Error converting file:[/bold red] {e}")
+        raise typer.Exit(code=1)
+
+@app.command("to-jpg")
+def to_jpg(
+    input_path: Path = typer.Argument(
+        ..., 
+        exists=True, 
+        file_okay=True, 
+        dir_okay=False, 
+        readable=True,
+        help="Path to the source image file"
+    ),
+    quality: int = typer.Option(
+        85, 
+        "--quality", "-q", 
+        min=1, max=100, 
+        help="JPEG compression quality (1-100)"
+    ),
+):
+    """
+    Convert any incoming image file to JPG format.
+    """
+    console.print(f"[yellow]Processing:[/yellow] {input_path.name}...")
+    output_path = input_path.with_suffix(".jpg")
+    
+    try:
+        with Image.open(input_path) as img:
+            # Crucial: If the input has transparency (RGBA or P), 
+            # we must flatten it onto a solid background color (white)
+            if img.mode in ("RGBA", "P"):
+                background = Image.new("RGB", img.size, (255, 255, 255))
+                # Paste the transparent image on top of the white background
+                background.paste(img, mask=img.convert("RGBA").split()[3])
+                img = background
+            elif img.mode == "CMYK":
+                img = img.convert("RGB")
+                
+            img.save(output_path, format="JPEG", quality=quality)
+            
+        console.print(f"[bold green]Success![/bold green] Saved to {output_path} (Quality: {quality})")
+    except Exception as e:
+        console.print(f"[bold red]Error converting file:[/bold red] {e}")
+        raise typer.Exit(code=1)

convashun-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,9 @@
+convashun/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+convashun/cli.py,sha256=70O-LqwGPxdou_J-ldoN7AUfWmraYsJtqraTs7x9WyQ,753
+convashun/document.py,sha256=S7Drl0_zYnVsn3T3KmIj-rohXjlFIXBGWTcLu6qN54E,21826
+convashun/image.py,sha256=-TTirZxpPKgACbrSmowo3Re3uulqqgSZ-0LvsMLjCpw,3831
+convashun-0.1.0.dist-info/METADATA,sha256=1UAdOrlZPg8gaEBvjwGNN7O0k8wWfqg9KTHA4B78T6s,5652
+convashun-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+convashun-0.1.0.dist-info/entry_points.txt,sha256=W94Q7BFnXOqRywszW8xU4aVOCQjmkrQEXLkTtfTqjgg,46
+convashun-0.1.0.dist-info/licenses/LICENSE,sha256=VLGELCbLgyTym14JsR_0iY2m-rnwaAlCpoTFtgYW9nA,1067
+convashun-0.1.0.dist-info/RECORD,,

convashun-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

convashun-0.1.0.dist-info/entry_points.txt

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

convashun-0.1.0.dist-info/licenses/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.