PyPI - prezo - Versions diffs - 2026.1.1__py3-none-any.whl → 2026.1.3__py3-none-any.whl - Mend

prezo 2026.1.1py3-none-any.whl → 2026.1.3py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (18) hide show

prezo/__init__.py +8 -0
prezo/app.py +25 -31
prezo/config.py +1 -1
prezo/export/__init__.py +36 -0
prezo/export/common.py +77 -0
prezo/export/html.py +340 -0
prezo/export/images.py +261 -0
prezo/export/pdf.py +497 -0
prezo/export/svg.py +170 -0
prezo/layout.py +680 -0
prezo/parser.py +11 -4
prezo/widgets/__init__.py +9 -1
prezo/widgets/slide_content.py +81 -0
{prezo-2026.1.1.dist-info → prezo-2026.1.3.dist-info}/METADATA +25 -4
{prezo-2026.1.1.dist-info → prezo-2026.1.3.dist-info}/RECORD +17 -10
prezo/export.py +0 -835
{prezo-2026.1.1.dist-info → prezo-2026.1.3.dist-info}/WHEEL +0 -0
{prezo-2026.1.1.dist-info → prezo-2026.1.3.dist-info}/entry_points.txt +0 -0

prezo/export/pdf.py ADDED Viewed

@@ -0,0 +1,497 @@
+"""PDF export functionality with multiple backend support."""
+from __future__ import annotations
+import io
+import re
+import shutil
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+from prezo.parser import parse_presentation
+from .common import (
+    EXIT_FAILURE,
+    EXIT_SUCCESS,
+    ExportError,
+    check_font_availability,
+    print_font_warnings,
+)
+from .svg import render_slide_to_svg
+def _find_chrome() -> str | None:
+    """Find Chrome/Chromium executable.
+    Returns:
+        Path to Chrome executable, or None if not found.
+    """
+    # Try common Chrome executable names
+    for name in ["chromium", "google-chrome", "chrome", "google-chrome-stable"]:
+        path = shutil.which(name)
+        if path:
+            return path
+    # macOS application paths
+    mac_paths = [
+        "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+        "/Applications/Chromium.app/Contents/MacOS/Chromium",
+    ]
+    for path in mac_paths:
+        if Path(path).exists():
+            return path
+    return None
+def _convert_svg_to_pdf_chrome(svg_file: Path, pdf_file: Path) -> bool:
+    """Convert a single SVG to PDF using Chrome headless.
+    Args:
+        svg_file: Path to SVG file.
+        pdf_file: Path for output PDF.
+    Returns:
+        True if successful, False otherwise.
+    """
+    chrome = _find_chrome()
+    if not chrome:
+        return False
+    # Read SVG and get dimensions from viewBox
+    svg_content = svg_file.read_text()
+    match = re.search(r'viewBox="0 0 ([\d.]+) ([\d.]+)"', svg_content)
+    if match:
+        width = int(float(match.group(1)))
+        height = int(float(match.group(2)))
+    else:
+        width, height = 994, 612
+    # Create HTML wrapper with proper page size
+    # overflow:hidden prevents extra blank pages from slight size mismatches
+    html_content = f"""<!DOCTYPE html>
+<html>
+<head>
+<style>
+  @page {{ margin: 0; size: {width}px {height}px; }}
+  html, body {{ margin: 0; padding: 0; overflow: hidden; height: {height}px; width: {width}px; }}
+  svg {{ display: block; }}
+</style>
+</head>
+<body>
+{svg_content}
+</body>
+</html>"""
+    # Write HTML to temp file
+    with tempfile.NamedTemporaryFile(
+        mode="w", suffix=".html", delete=False
+    ) as html_file:
+        html_file.write(html_content)
+        html_path = Path(html_file.name)
+    try:
+        result = subprocess.run(
+            [
+                chrome,
+                "--headless",
+                "--disable-gpu",
+                "--password-store=basic",
+                "--use-mock-keychain",
+                f"--print-to-pdf={pdf_file}",
+                "--no-pdf-header-footer",
+                str(html_path),
+            ],
+            capture_output=True,
+            timeout=60,
+            check=False,
+        )
+        return result.returncode == 0 and pdf_file.exists()
+    except (subprocess.TimeoutExpired, subprocess.SubprocessError):
+        return False
+    finally:
+        html_path.unlink(missing_ok=True)
+def _convert_svg_to_pdf_inkscape(svg_file: Path, pdf_file: Path) -> bool:
+    """Convert a single SVG to PDF using Inkscape.
+    Args:
+        svg_file: Path to SVG file.
+        pdf_file: Path for output PDF.
+    Returns:
+        True if successful, False otherwise.
+    """
+    inkscape = shutil.which("inkscape")
+    if not inkscape:
+        return False
+    try:
+        result = subprocess.run(
+            [
+                inkscape,
+                str(svg_file),
+                f"--export-filename={pdf_file}",
+                "--export-type=pdf",
+            ],
+            capture_output=True,
+            timeout=60,
+            check=False,
+        )
+        return result.returncode == 0 and pdf_file.exists()
+    except (subprocess.TimeoutExpired, subprocess.SubprocessError):
+        return False
+def _convert_svg_to_pdf_cairosvg(svg_file: Path) -> bytes | None:
+    """Convert a single SVG to PDF using CairoSVG.
+    Args:
+        svg_file: Path to SVG file.
+    Returns:
+        PDF bytes if successful, None otherwise.
+    """
+    try:
+        import cairosvg  # noqa: PLC0415
+    except ImportError:
+        return None
+    # CairoSVG doesn't properly support textLength, so we strip it
+    svg_content = svg_file.read_text()
+    svg_content = re.sub(r'\s*textLength="[^"]*"', "", svg_content)
+    svg_content = re.sub(r'\s*lengthAdjust="[^"]*"', "", svg_content)
+    return cairosvg.svg2pdf(bytestring=svg_content.encode("utf-8"))
+def _select_pdf_backend(backend: str) -> tuple[str, str | None]:
+    """Select the PDF backend to use.
+    Args:
+        backend: Requested backend ("auto", "chrome", "inkscape", "cairosvg")
+    Returns:
+        Tuple of (selected_backend, error_message). Error is None if OK.
+    """
+    checks = {
+        "chrome": (
+            _find_chrome,
+            "Chrome/Chromium not found. Install it or use a different backend.",
+        ),
+        "inkscape": (
+            lambda: shutil.which("inkscape"),
+            "Inkscape not found. Install it or use --pdf-backend=cairosvg",
+        ),
+    }
+    if backend in checks:
+        check_fn, error_msg = checks[backend]
+        return (backend, None) if check_fn() else ("", error_msg)
+    if backend == "cairosvg":
+        return "cairosvg", None
+    # auto: prefer Chrome > Inkscape > CairoSVG
+    for name, (check_fn, _) in checks.items():
+        if check_fn():
+            return name, None
+    return "cairosvg", None
+def combine_svgs_to_pdf(
+    svg_files: list[Path], output: Path, *, backend: str = "auto"
+) -> Path:
+    """Combine multiple SVG files into a single PDF.
+    Args:
+        svg_files: List of paths to SVG files
+        output: Output PDF path
+        backend: PDF conversion backend ("auto", "chrome", "inkscape", "cairosvg")
+    Returns:
+        Path to the created PDF file.
+    Raises:
+        ExportError: If PDF generation fails.
+    """
+    selected, error = _select_pdf_backend(backend)
+    if error:
+        raise ExportError(error)
+    match selected:
+        case "chrome":
+            return _combine_svgs_to_pdf_chrome(svg_files, output)
+        case "inkscape":
+            return _combine_svgs_to_pdf_inkscape(svg_files, output)
+        case _:
+            return _combine_svgs_to_pdf_cairosvg(svg_files, output)
+def _combine_svgs_to_pdf_chrome(svg_files: list[Path], output: Path) -> Path:
+    """Combine SVGs to PDF using Chrome headless."""
+    try:
+        from pypdf import PdfReader, PdfWriter  # noqa: PLC0415
+    except ImportError as e:
+        msg = "Required package not installed. Install with:\n  pip install pypdf"
+        raise ExportError(msg) from e
+    pdf_pages: list[Path] = []
+    try:
+        for svg_file in svg_files:
+            with tempfile.NamedTemporaryFile(suffix=".pdf", delete=False) as tmp:
+                pdf_path = Path(tmp.name)
+            if not _convert_svg_to_pdf_chrome(svg_file, pdf_path):
+                for p in pdf_pages:
+                    p.unlink(missing_ok=True)
+                msg = "Chrome PDF conversion failed"
+                raise ExportError(msg)
+            pdf_pages.append(pdf_path)
+        # Combine all pages
+        writer = PdfWriter()
+        for pdf_path in pdf_pages:
+            reader = PdfReader(pdf_path)
+            for page in reader.pages:
+                writer.add_page(page)
+        with open(output, "wb") as f:
+            writer.write(f)
+        # Clean up temp files
+        for p in pdf_pages:
+            p.unlink(missing_ok=True)
+        return output
+    except ExportError:
+        raise
+    except Exception as e:
+        for p in pdf_pages:
+            p.unlink(missing_ok=True)
+        msg = f"PDF generation failed: {e}"
+        raise ExportError(msg) from e
+def _combine_svgs_to_pdf_inkscape(svg_files: list[Path], output: Path) -> Path:
+    """Combine SVGs to PDF using Inkscape."""
+    try:
+        from pypdf import PdfReader, PdfWriter  # noqa: PLC0415
+    except ImportError as e:
+        msg = "Required package not installed. Install with:\n  pip install pypdf"
+        raise ExportError(msg) from e
+    pdf_pages: list[Path] = []
+    try:
+        for svg_file in svg_files:
+            with tempfile.NamedTemporaryFile(suffix=".pdf", delete=False) as tmp:
+                pdf_path = Path(tmp.name)
+            if not _convert_svg_to_pdf_inkscape(svg_file, pdf_path):
+                # Clean up and fail
+                for p in pdf_pages:
+                    p.unlink(missing_ok=True)
+                msg = "Inkscape conversion failed"
+                raise ExportError(msg)
+            pdf_pages.append(pdf_path)
+        # Combine all pages
+        writer = PdfWriter()
+        for pdf_path in pdf_pages:
+            reader = PdfReader(pdf_path)
+            for page in reader.pages:
+                writer.add_page(page)
+        with open(output, "wb") as f:
+            writer.write(f)
+        # Clean up temp files
+        for p in pdf_pages:
+            p.unlink(missing_ok=True)
+        return output
+    except ExportError:
+        raise
+    except Exception as e:
+        for p in pdf_pages:
+            p.unlink(missing_ok=True)
+        msg = f"PDF generation failed: {e}"
+        raise ExportError(msg) from e
+def _combine_svgs_to_pdf_cairosvg(svg_files: list[Path], output: Path) -> Path:
+    """Combine SVGs to PDF using CairoSVG."""
+    try:
+        from pypdf import PdfReader, PdfWriter  # noqa: PLC0415
+    except ImportError as e:
+        msg = (
+            "Required packages not installed. Install with:\n"
+            "  pip install cairosvg pypdf"
+        )
+        raise ExportError(msg) from e
+    # Warn about CairoSVG limitations
+    print(
+        "⚠️  Using CairoSVG backend. For better alignment, install Inkscape "
+        "or use --pdf-backend=inkscape",
+        file=sys.stderr,
+    )
+    pdf_pages = []
+    try:
+        for svg_file in svg_files:
+            pdf_bytes = _convert_svg_to_pdf_cairosvg(svg_file)
+            if pdf_bytes is None:
+                msg = "CairoSVG not installed. Install with:\n  pip install cairosvg"
+                raise ExportError(msg)
+            pdf_pages.append(io.BytesIO(pdf_bytes))
+        writer = PdfWriter()
+        for page_io in pdf_pages:
+            reader = PdfReader(page_io)
+            for page in reader.pages:
+                writer.add_page(page)
+        with open(output, "wb") as f:
+            writer.write(f)
+        return output
+    except ExportError:
+        raise
+    except Exception as e:
+        msg = f"PDF generation failed: {e}"
+        raise ExportError(msg) from e
+def export_to_pdf(
+    source: Path,
+    output: Path,
+    *,
+    theme: str = "dark",
+    width: int = 80,
+    height: int = 24,
+    chrome: bool = True,
+    pdf_backend: str = "auto",
+) -> Path:
+    """Export presentation to PDF matching TUI appearance.
+    Args:
+        source: Path to the markdown presentation
+        output: Path for the output PDF
+        theme: Theme to use for rendering
+        width: Console width in characters
+        height: Console height in lines
+        chrome: If True, include window decorations; if False, plain output for printing
+        pdf_backend: Backend for PDF conversion ("auto", "inkscape", "cairosvg")
+    Returns:
+        Path to the created PDF file.
+    Raises:
+        ExportError: If export fails.
+    """
+    if not source.exists():
+        msg = f"Source file not found: {source}"
+        raise ExportError(msg)
+    # Parse the presentation
+    try:
+        presentation = parse_presentation(source)
+    except Exception as e:
+        msg = f"Failed to parse presentation: {e}"
+        raise ExportError(msg) from e
+    if presentation.total_slides == 0:
+        msg = "Presentation has no slides"
+        raise ExportError(msg)
+    # Check font availability and warn if needed
+    font_warnings = check_font_availability()
+    print_font_warnings(font_warnings)
+    # Create temporary directory for SVG files
+    with tempfile.TemporaryDirectory() as tmpdir_str:
+        tmpdir = Path(tmpdir_str)
+        svg_files = []
+        # Render each slide to SVG
+        for i, slide in enumerate(presentation.slides):
+            svg_content = render_slide_to_svg(
+                slide.content,
+                i,
+                presentation.total_slides,
+                theme_name=theme,
+                width=width,
+                height=height,
+                chrome=chrome,
+            )
+            svg_file = tmpdir / f"slide_{i:04d}.svg"
+            svg_file.write_text(svg_content)
+            svg_files.append(svg_file)
+        # Combine into PDF
+        return combine_svgs_to_pdf(svg_files, output, backend=pdf_backend)
+def run_export(
+    source: str,
+    output: str | None = None,
+    *,
+    theme: str = "dark",
+    width: int = 80,
+    height: int = 24,
+    chrome: bool = True,
+    pdf_backend: str = "auto",
+) -> int:
+    """Run PDF export from command line.
+    Args:
+        source: Path to the markdown presentation (string)
+        output: Optional path for the output PDF (string)
+        theme: Theme to use for rendering
+        width: Console width in characters
+        height: Console height in lines
+        chrome: If True, include window decorations; if False, plain output for printing
+        pdf_backend: Backend for PDF conversion ("auto", "inkscape", "cairosvg")
+    Returns:
+        Exit code (0 for success)
+    """
+    source_path = Path(source)
+    output_path = Path(output) if output else source_path.with_suffix(".pdf")
+    try:
+        result_path = export_to_pdf(
+            source_path,
+            output_path,
+            theme=theme,
+            width=width,
+            height=height,
+            chrome=chrome,
+            pdf_backend=pdf_backend,
+        )
+        print(f"Exported to {result_path}")
+        return EXIT_SUCCESS
+    except ExportError as e:
+        print(f"error: {e}", file=sys.stderr)
+        return EXIT_FAILURE

prezo/export/svg.py ADDED Viewed

@@ -0,0 +1,170 @@
+"""SVG rendering for slides."""
+from __future__ import annotations
+import io
+from rich.console import Console
+from rich.markdown import Markdown
+from rich.panel import Panel
+from rich.style import Style
+from rich.text import Text
+from prezo.layout import has_layout_blocks, parse_layout, render_layout
+from prezo.themes import get_theme
+# SVG template without window chrome (for printing)
+# Uses Rich's template format: {var} for substitution, {{ }} for literal braces
+SVG_FORMAT_NO_CHROME = """\
+<svg class="rich-terminal" viewBox="0 0 {width} {height}" xmlns="http://www.w3.org/2000/svg">
+    <!-- Generated with Rich https://www.textualize.io -->
+    <style>
+    @font-face {{
+        font-family: "Fira Code";
+        src: local("FiraCode-Regular"),
+                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff2/FiraCode-Regular.woff2") format("woff2"),
+                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff/FiraCode-Regular.woff") format("woff");
+        font-style: normal;
+        font-weight: 400;
+    }}
+    @font-face {{
+        font-family: "Fira Code";
+        src: local("FiraCode-Bold"),
+                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff2/FiraCode-Bold.woff2") format("woff2"),
+                url("https://cdnjs.cloudflare.com/ajax/libs/firacode/6.2.0/woff/FiraCode-Bold.woff") format("woff");
+        font-style: bold;
+        font-weight: 700;
+    }}
+    .{{unique_id}}-matrix {{
+        font-family: Fira Code, "Apple Color Emoji", "Segoe UI Emoji", "Noto Color Emoji", monospace;
+        font-size: {{char_height}}px;
+        line-height: {{line_height}}px;
+        font-variant-east-asian: full-width;
+        /* Disable ligatures and ensure consistent character widths */
+        font-feature-settings: "liga" 0, "calt" 0, "dlig" 0;
+        font-variant-ligatures: none;
+        letter-spacing: 0;
+        word-spacing: 0;
+        white-space: pre;
+    }}
+    .{{unique_id}}-matrix text {{
+        /* Force uniform character spacing for box-drawing chars */
+        text-rendering: geometricPrecision;
+    }}
+    {{styles}}
+    </style>
+    <defs>
+    <clipPath id="{{unique_id}}-clip-terminal">
+      <rect x="0" y="0" width="{{width}}" height="{{height}}" />
+    </clipPath>
+    {{lines}}
+    </defs>
+    <g transform="translate(0, 0)" clip-path="url(#{{unique_id}}-clip-terminal)">
+    {{backgrounds}}
+    <g class="{{unique_id}}-matrix">
+    {{matrix}}
+    </g>
+    </g>
+</svg>
+"""
+def render_slide_to_svg(
+    content: str,
+    slide_num: int,
+    total_slides: int,
+    *,
+    theme_name: str = "dark",
+    width: int = 80,
+    height: int = 24,
+    chrome: bool = True,
+) -> str:
+    """Render a single slide to SVG using Rich console.
+    Args:
+        content: The markdown content of the slide
+        slide_num: Current slide number (0-indexed)
+        total_slides: Total number of slides
+        theme_name: Theme to use for rendering
+        width: Console width in characters
+        height: Console height in lines
+        chrome: If True, include window decorations; if False, plain SVG for printing
+    Returns:
+        SVG string of the rendered slide
+    """
+    theme = get_theme(theme_name)
+    # Create a console that records output (file=StringIO suppresses terminal output)
+    console = Console(
+        width=width,
+        record=True,
+        force_terminal=True,
+        color_system="truecolor",
+        file=io.StringIO(),  # Suppress terminal output
+    )
+    # Base style for the entire slide (background color)
+    base_style = Style(color=theme.text, bgcolor=theme.background)
+    # Render the content (with layout support)
+    if has_layout_blocks(content):
+        blocks = parse_layout(content)
+        slide_content = render_layout(blocks)
+    else:
+        slide_content = Markdown(content)
+    # Create a panel with the slide content (height - 2 for status bar and padding)
+    panel_height = height - 2
+    panel = Panel(
+        slide_content,
+        title=f"[{theme.text_muted}]Slide {slide_num + 1}/{total_slides}[/]",
+        title_align="right",
+        border_style=Style(color=theme.primary),
+        style=Style(color=theme.text, bgcolor=theme.surface),
+        padding=(1, 2),
+        expand=True,
+        height=panel_height,
+    )
+    # Print to the recording console with background
+    console.print(panel, style=base_style)
+    # Add status bar at the bottom
+    progress = (slide_num + 1) / total_slides
+    bar_width = 20
+    filled = int(progress * bar_width)
+    bar = "█" * filled + "░" * (bar_width - filled)
+    status_text = f" {bar} {slide_num + 1}/{total_slides} "
+    # Pad status bar to full width
+    status_text = status_text.ljust(width)
+    status = Text(status_text, style=Style(bgcolor=theme.primary, color=theme.text))
+    console.print(status, style=base_style)
+    # Export to SVG
+    if chrome:
+        svg = console.export_svg(title=f"Slide {slide_num + 1}")
+    else:
+        svg = console.export_svg(code_format=SVG_FORMAT_NO_CHROME)
+    # Add emoji font fallbacks to font-family declarations
+    # Rich only specifies "Fira Code, monospace" which lacks emoji glyphs
+    svg = svg.replace(
+        "font-family: Fira Code, monospace",
+        'font-family: Fira Code, "Apple Color Emoji", "Segoe UI Emoji", "Noto Color Emoji", monospace',
+    )
+    # Add background color to SVG (Rich doesn't set it by default)
+    # Insert a rect element right after the opening svg tag
+    bg_rect = f'<rect width="100%" height="100%" fill="{theme.background}"/>'
+    return svg.replace(
+        'xmlns="http://www.w3.org/2000/svg">',
+        f'xmlns="http://www.w3.org/2000/svg">\n    {bg_rect}',
+    )

prezo 2026.1.1__py3-none-any.whl → 2026.1.3__py3-none-any.whl

prezo 2026.1.1py3-none-any.whl → 2026.1.3py3-none-any.whl