PyPI - prezo - Versions diffs - 2026.1.2__py3-none-any.whl → 2026.1.4__py3-none-any.whl - Mend

prezo 2026.1.2py3-none-any.whl → 2026.1.4py3-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 (17) hide show

prezo/__init__.py +20 -1
prezo/app.py +295 -43
prezo/config.py +2 -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 +360 -53
prezo/parser.py +29 -0
prezo/widgets/status_bar.py +20 -2
{prezo-2026.1.2.dist-info → prezo-2026.1.4.dist-info}/METADATA +1 -1
{prezo-2026.1.2.dist-info → prezo-2026.1.4.dist-info}/RECORD +16 -11
prezo/export.py +0 -860
{prezo-2026.1.2.dist-info → prezo-2026.1.4.dist-info}/WHEEL +0 -0
{prezo-2026.1.2.dist-info → prezo-2026.1.4.dist-info}/entry_points.txt +0 -0

prezo/export/html.py ADDED Viewed

@@ -0,0 +1,340 @@
+"""HTML export functionality."""
+from __future__ import annotations
+from pathlib import Path
+from prezo.parser import clean_marp_directives, extract_notes, parse_presentation
+from prezo.themes import get_theme
+from .common import EXIT_FAILURE, EXIT_SUCCESS, ExportError
+# HTML export templates
+HTML_TEMPLATE = """\
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{title}</title>
+    <style>
+        * {{
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }}
+        body {{
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, sans-serif;
+            background: {background};
+            color: {text};
+            min-height: 100vh;
+        }}
+        .slides {{
+            max-width: 1200px;
+            margin: 0 auto;
+            padding: 2rem;
+        }}
+        .slide {{
+            background: {surface};
+            border: 1px solid {border};
+            border-radius: 8px;
+            padding: 3rem 4rem;
+            margin-bottom: 3rem;
+            min-height: 70vh;
+            display: flex;
+            flex-direction: column;
+            page-break-after: always;
+        }}
+        .slide-number {{
+            color: {text_muted};
+            font-size: 0.9rem;
+            margin-bottom: 1rem;
+            padding-bottom: 0.5rem;
+            border-bottom: 1px solid {border};
+        }}
+        .slide-content {{
+            flex: 1;
+        }}
+        h1 {{
+            font-size: 2.5rem;
+            margin-bottom: 1.5rem;
+            color: {primary};
+        }}
+        h2 {{
+            font-size: 2rem;
+            margin-bottom: 1.2rem;
+            color: {primary};
+        }}
+        h3 {{
+            font-size: 1.5rem;
+            margin-bottom: 1rem;
+            color: {text};
+        }}
+        p {{
+            font-size: 1.2rem;
+            line-height: 1.6;
+            margin-bottom: 1rem;
+        }}
+        ul, ol {{
+            margin: 1rem 0;
+            padding-left: 2rem;
+        }}
+        li {{
+            font-size: 1.2rem;
+            line-height: 1.6;
+            margin-bottom: 0.5rem;
+        }}
+        pre {{
+            background: {background};
+            border-radius: 4px;
+            padding: 1rem;
+            overflow-x: auto;
+            font-family: 'Fira Code', 'Consolas', monospace;
+            font-size: 1rem;
+            margin: 1rem 0;
+        }}
+        code {{
+            font-family: 'Fira Code', 'Consolas', monospace;
+            background: {background};
+            padding: 0.2rem 0.4rem;
+            border-radius: 3px;
+            font-size: 0.95em;
+        }}
+        pre code {{
+            padding: 0;
+            background: none;
+        }}
+        table {{
+            width: 100%;
+            border-collapse: collapse;
+            margin: 1rem 0;
+        }}
+        th, td {{
+            border: 1px solid {border};
+            padding: 0.75rem;
+            text-align: left;
+        }}
+        th {{
+            background: {background};
+        }}
+        blockquote {{
+            border-left: 4px solid {primary};
+            padding-left: 1rem;
+            margin: 1rem 0;
+            font-style: italic;
+            color: {text_muted};
+        }}
+        a {{
+            color: {primary};
+        }}
+        img {{
+            max-width: 100%;
+            height: auto;
+        }}
+        /* Multi-column layouts */
+        .columns {{
+            display: flex;
+            gap: 2rem;
+            align-items: flex-start;
+        }}
+        .columns > div {{
+            flex: 1;
+            min-width: 0;
+        }}
+        .notes {{
+            margin-top: 2rem;
+            padding: 1rem;
+            background: {background};
+            border-radius: 4px;
+            font-size: 0.9rem;
+            color: {text_muted};
+        }}
+        .notes-title {{
+            font-weight: bold;
+            margin-bottom: 0.5rem;
+        }}
+        @media print {{
+            .slide {{
+                break-inside: avoid;
+                page-break-inside: avoid;
+            }}
+            body {{
+                background: white;
+                color: black;
+            }}
+        }}
+    </style>
+</head>
+<body>
+    <div class="slides">
+{slides}
+    </div>
+</body>
+</html>
+"""
+SLIDE_TEMPLATE = """\
+        <div class="slide" id="slide-{num}">
+            <div class="slide-number">Slide {display_num} of {total}</div>
+            <div class="slide-content">
+{content}
+            </div>
+{notes}
+        </div>
+"""
+NOTES_TEMPLATE = """\
+            <div class="notes">
+                <div class="notes-title">Presenter Notes</div>
+{notes_content}
+            </div>
+"""
+def render_slide_to_html(content: str) -> str:
+    """Convert markdown content to basic HTML.
+    Args:
+        content: Markdown content of the slide.
+    Returns:
+        HTML string for the slide content.
+    """
+    try:
+        import markdown  # noqa: PLC0415
+        html = markdown.markdown(
+            content,
+            extensions=["tables", "fenced_code", "codehilite"],
+        )
+    except ImportError:
+        # Fallback: basic markdown-to-html conversion
+        import html as html_mod  # noqa: PLC0415
+        html = html_mod.escape(content)
+        # Basic transformations
+        html = html.replace("\n\n", "</p><p>")
+        html = f"<p>{html}</p>"
+    return html
+def export_to_html(
+    source: Path,
+    output: Path,
+    *,
+    theme: str = "dark",
+    include_notes: bool = False,
+) -> Path:
+    """Export presentation to HTML.
+    Args:
+        source: Path to the markdown presentation.
+        output: Path for the output HTML file.
+        theme: Theme to use for styling.
+        include_notes: Whether to include presenter notes.
+    Returns:
+        Path to the created HTML file.
+    Raises:
+        ExportError: If export fails.
+    """
+    if not source.exists():
+        msg = f"Source file not found: {source}"
+        raise ExportError(msg)
+    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)
+    theme_obj = get_theme(theme)
+    # Render each slide
+    slides_html = []
+    for i, slide in enumerate(presentation.slides):
+        # Use raw_content and clean with keep_divs=True to preserve column layouts
+        slide_content, _ = extract_notes(slide.raw_content)
+        cleaned_content = clean_marp_directives(slide_content, keep_divs=True)
+        content_html = render_slide_to_html(cleaned_content)
+        # Handle notes
+        notes_html = ""
+        if include_notes and slide.notes:
+            notes_content = render_slide_to_html(slide.notes)
+            notes_html = NOTES_TEMPLATE.format(notes_content=notes_content)
+        slide_html = SLIDE_TEMPLATE.format(
+            num=i,
+            display_num=i + 1,
+            total=presentation.total_slides,
+            content=content_html,
+            notes=notes_html,
+        )
+        slides_html.append(slide_html)
+    # Build final HTML
+    title = presentation.title or source.stem
+    html = HTML_TEMPLATE.format(
+        title=title,
+        background=theme_obj.background,
+        surface=theme_obj.surface,
+        text=theme_obj.text,
+        text_muted=theme_obj.text_muted,
+        primary=theme_obj.primary,
+        border=theme_obj.text_muted,
+        slides="\n".join(slides_html),
+    )
+    try:
+        output.write_text(html)
+        return output
+    except Exception as e:
+        msg = f"Failed to write HTML: {e}"
+        raise ExportError(msg) from e
+def run_html_export(
+    source: str,
+    output: str | None = None,
+    *,
+    theme: str = "light",
+    include_notes: bool = False,
+) -> int:
+    """Run HTML export from command line.
+    Args:
+        source: Path to the markdown presentation (string).
+        output: Optional path for the output HTML (string).
+        theme: Theme to use for styling.
+        include_notes: Whether to include presenter notes.
+    Returns:
+        Exit code (0 for success).
+    """
+    import sys  # noqa: PLC0415
+    source_path = Path(source)
+    output_path = Path(output) if output else source_path.with_suffix(".html")
+    try:
+        result_path = export_to_html(
+            source_path,
+            output_path,
+            theme=theme,
+            include_notes=include_notes,
+        )
+        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/images.py ADDED Viewed

@@ -0,0 +1,261 @@
+"""Image (PNG/SVG) export functionality."""
+from __future__ import annotations
+import sys
+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 export_slide_to_image(
+    content: str,
+    slide_num: int,
+    total_slides: int,
+    output_path: Path,
+    *,
+    output_format: str = "png",
+    theme_name: str = "dark",
+    width: int = 80,
+    height: int = 24,
+    chrome: bool = True,
+    scale: float = 1.0,
+) -> Path:
+    """Export a single slide to PNG or SVG.
+    Args:
+        content: The markdown content of the slide.
+        slide_num: Current slide number (0-indexed).
+        total_slides: Total number of slides.
+        output_path: Path to save the image.
+        output_format: Output format ('png' or 'svg').
+        theme_name: Theme to use for rendering.
+        width: Console width in characters.
+        height: Console height in lines.
+        chrome: If True, include window decorations.
+        scale: Scale factor for PNG output (e.g., 2.0 for 2x resolution).
+    Returns:
+        Path to the created image file.
+    Raises:
+        ExportError: If export fails.
+    """
+    # Generate SVG
+    svg_content = render_slide_to_svg(
+        content,
+        slide_num,
+        total_slides,
+        theme_name=theme_name,
+        width=width,
+        height=height,
+        chrome=chrome,
+    )
+    if output_format == "svg":
+        try:
+            output_path.write_text(svg_content)
+            return output_path
+        except Exception as e:
+            msg = f"Failed to write SVG: {e}"
+            raise ExportError(msg) from e
+    # Convert SVG to PNG
+    try:
+        import cairosvg  # noqa: PLC0415
+    except ImportError as e:
+        msg = "PNG export requires cairosvg.\nInstall with: pip install prezo[export]"
+        raise ExportError(msg) from e
+    try:
+        png_data = cairosvg.svg2png(
+            bytestring=svg_content.encode("utf-8"),
+            scale=scale,
+        )
+        if png_data is None:
+            msg = "PNG conversion returned no data"
+            raise ExportError(msg)
+        output_path.write_bytes(png_data)
+        return output_path
+    except ExportError:
+        raise
+    except Exception as e:
+        msg = f"Failed to convert to PNG: {e}"
+        raise ExportError(msg) from e
+def export_to_images(
+    source: Path,
+    output: Path | None = None,
+    *,
+    output_format: str = "png",
+    theme: str = "dark",
+    width: int = 80,
+    height: int = 24,
+    chrome: bool = True,
+    slide_num: int | None = None,
+    scale: float = 2.0,
+) -> list[Path]:
+    """Export presentation slides to images.
+    Args:
+        source: Path to the markdown presentation.
+        output: Output path (file for single slide, directory for all).
+        output_format: Output format ('png' or 'svg').
+        theme: Theme to use for rendering.
+        width: Console width in characters.
+        height: Console height in lines.
+        chrome: If True, include window decorations.
+        slide_num: If set, export only this slide (1-indexed).
+        scale: Scale factor for PNG output (default 2.0 for higher resolution).
+    Returns:
+        List of paths to the created image files.
+    Raises:
+        ExportError: If export fails.
+    """
+    # Parse presentation
+    try:
+        presentation = parse_presentation(source)
+    except Exception as e:
+        msg = f"Failed to read {source}: {e}"
+        raise ExportError(msg) from e
+    if presentation.total_slides == 0:
+        msg = "No slides found in presentation"
+        raise ExportError(msg)
+    # Check font availability and warn if needed (for PNG export)
+    if output_format == "png":
+        font_warnings = check_font_availability()
+        print_font_warnings(font_warnings)
+    # Single slide export
+    if slide_num is not None:
+        if slide_num < 1 or slide_num > presentation.total_slides:
+            msg = (
+                f"Invalid slide number: {slide_num}. "
+                f"Presentation has {presentation.total_slides} slides."
+            )
+            raise ExportError(msg)
+        slide_idx = slide_num - 1
+        slide = presentation.slides[slide_idx]
+        out_path = Path(output) if output else source.with_suffix(f".{output_format}")
+        result_path = export_slide_to_image(
+            slide.content,
+            slide_idx,
+            presentation.total_slides,
+            out_path,
+            output_format=output_format,
+            theme_name=theme,
+            width=width,
+            height=height,
+            chrome=chrome,
+            scale=scale,
+        )
+        return [result_path]
+    # Export all slides
+    if output:
+        out_dir = Path(output)
+        if out_dir.suffix:  # Has extension, treat as file prefix
+            prefix = out_dir.stem  # Get stem before reassigning
+            out_dir = out_dir.parent
+        else:
+            prefix = source.stem
+    else:
+        out_dir = source.parent
+        prefix = source.stem
+    # Create output directory if needed
+    out_dir.mkdir(parents=True, exist_ok=True)
+    exported_paths = []
+    for i, slide in enumerate(presentation.slides):
+        out_path = out_dir / f"{prefix}_{i + 1:03d}.{output_format}"
+        result_path = export_slide_to_image(
+            slide.content,
+            i,
+            presentation.total_slides,
+            out_path,
+            output_format=output_format,
+            theme_name=theme,
+            width=width,
+            height=height,
+            chrome=chrome,
+            scale=scale,
+        )
+        exported_paths.append(result_path)
+    return exported_paths
+def run_image_export(
+    source: str,
+    output: str | None = None,
+    *,
+    output_format: str = "png",
+    theme: str = "dark",
+    width: int = 80,
+    height: int = 24,
+    chrome: bool = True,
+    slide_num: int | None = None,
+    scale: float = 2.0,
+) -> int:
+    """Run PNG/SVG export from command line.
+    Args:
+        source: Path to the markdown presentation.
+        output: Optional output path (file or directory).
+        output_format: Output format ('png' or 'svg').
+        theme: Theme to use for rendering.
+        width: Console width in characters.
+        height: Console height in lines.
+        chrome: If True, include window decorations.
+        slide_num: If set, export only this slide (1-indexed).
+        scale: Scale factor for PNG output (default 2.0 for higher resolution).
+    Returns:
+        Exit code (0 for success).
+    """
+    source_path = Path(source)
+    output_path = Path(output) if output else None
+    try:
+        exported_paths = export_to_images(
+            source_path,
+            output_path,
+            output_format=output_format,
+            theme=theme,
+            width=width,
+            height=height,
+            chrome=chrome,
+            slide_num=slide_num,
+            scale=scale,
+        )
+        if len(exported_paths) == 1:
+            print(f"Exported to {exported_paths[0]}")
+        else:
+            print(
+                f"Exported {len(exported_paths)} slides to {exported_paths[0].parent}/"
+            )
+        return EXIT_SUCCESS
+    except ExportError as e:
+        print(f"error: {e}", file=sys.stderr)
+        return EXIT_FAILURE

prezo 2026.1.2__py3-none-any.whl → 2026.1.4__py3-none-any.whl

prezo 2026.1.2py3-none-any.whl → 2026.1.4py3-none-any.whl