prezo 0.3.1__py3-none-any.whl

prezo/widgets/slide_button.py

@@ -0,0 +1,72 @@
+"""Slide button widget for overview grid."""
+
+from __future__ import annotations
+
+import re
+
+from textual.widgets import Button
+
+MAX_TITLE_LENGTH = 35
+
+
+def extract_slide_title(content: str, slide_index: int) -> str:
+    """Extract the first heading (any level) from slide content.
+
+    Args:
+        content: Slide markdown content
+        slide_index: Zero-based slide index (for fallback title)
+
+    Returns:
+        Extracted or generated title, truncated to MAX_TITLE_LENGTH
+
+    """
+    for line in content.strip().split("\n"):
+        line = line.strip()
+        match = re.match(r"^(#{1,6})\s+(.+)$", line)
+        if match:
+            title = match.group(2).strip()
+            title = re.sub(r"\*{1,2}([^*]+)\*{1,2}", r"\1", title)
+            return _truncate(title)
+
+    for line in content.strip().split("\n"):
+        line = line.strip()
+        if line and not line.startswith("<!--"):
+            return _truncate(line)
+
+    return f"Slide {slide_index + 1}"
+
+
+def _truncate(text: str) -> str:
+    """Truncate text to MAX_TITLE_LENGTH with ellipsis if needed."""
+    if len(text) > MAX_TITLE_LENGTH:
+        return text[: MAX_TITLE_LENGTH - 3] + "..."
+    return text
+
+
+class SlideButton(Button):
+    """A button representing a slide in the overview grid."""
+
+    def __init__(
+        self,
+        slide_index: int,
+        content: str,
+        *,
+        is_current: bool = False,
+    ) -> None:
+        """Initialize a slide button.
+
+        Args:
+            slide_index: Zero-based index of the slide.
+            content: Markdown content of the slide.
+            is_current: Whether this is the currently active slide.
+
+        """
+        title = extract_slide_title(content, slide_index)
+        super().__init__(title, id=f"slide-{slide_index}")
+        self.slide_index = slide_index
+        self.is_current = is_current
+
+    def on_mount(self) -> None:
+        """Add current class if this is the active slide."""
+        if self.is_current:
+            self.add_class("current")

prezo/widgets/status_bar.py

@@ -0,0 +1,240 @@
+"""Status bar widgets for Prezo."""
+
+from __future__ import annotations
+
+from datetime import datetime, timezone
+
+from textual.reactive import reactive
+from textual.widgets import Static
+
+
+def format_progress_bar(current: int, total: int, width: int = 20) -> str:
+    """Generate a progress bar string.
+
+    Args:
+        current: Current position (0-indexed)
+        total: Total number of items
+        width: Width of the progress bar in characters
+
+    Returns:
+        Progress bar string like "████████░░░░░░░░░░░░"
+
+    """
+    if total <= 0:
+        return "░" * width
+
+    progress = (current + 1) / total
+    filled = int(progress * width)
+    empty = width - filled
+
+    return "█" * filled + "░" * empty
+
+
+def format_time(seconds: int) -> str:
+    """Format seconds as HH:MM:SS or MM:SS."""
+    if seconds < 0:
+        return "-" + format_time(-seconds)
+
+    hours, remainder = divmod(seconds, 3600)
+    minutes, secs = divmod(remainder, 60)
+
+    if hours > 0:
+        return f"{hours}:{minutes:02d}:{secs:02d}"
+    return f"{minutes}:{secs:02d}"
+
+
+class StatusBar(Static):
+    """Combined status bar showing progress, clock, and elapsed time."""
+
+    current: reactive[int] = reactive(0)
+    total: reactive[int] = reactive(1)
+    show_clock: reactive[bool] = reactive(True)
+    show_elapsed: reactive[bool] = reactive(True)
+    show_countdown: reactive[bool] = reactive(False)
+    countdown_minutes: reactive[int] = reactive(0)
+
+    def __init__(self, **kwargs) -> None:
+        """Initialize the status bar."""
+        super().__init__(**kwargs)
+        self._start_time: datetime | None = None
+        self._timer = None
+
+    def on_mount(self) -> None:
+        """Start the timer on mount."""
+        self._start_time = datetime.now(tz=timezone.utc)
+        self._timer = self.set_interval(1.0, self._tick)
+
+    def _tick(self) -> None:
+        """Timer callback to refresh the display."""
+        self.refresh()
+
+    def render(self) -> str:
+        """Render the status bar content."""
+        # Progress part
+        bar = format_progress_bar(self.current, self.total, width=20)
+        progress = f"{bar} {self.current + 1}/{self.total}"
+
+        # Clock part
+        clock_parts = []
+        if self.show_clock:
+            clock_parts.append(
+                datetime.now(tz=timezone.utc).astimezone().strftime("%H:%M:%S"),
+            )
+
+        if self.show_elapsed and self._start_time:
+            elapsed = datetime.now(tz=timezone.utc) - self._start_time
+            elapsed_secs = int(elapsed.total_seconds())
+            clock_parts.append(f"+{format_time(elapsed_secs)}")
+
+        if self.show_countdown and self.countdown_minutes > 0 and self._start_time:
+            total_secs = self.countdown_minutes * 60
+            elapsed = datetime.now(tz=timezone.utc) - self._start_time
+            remaining = total_secs - int(elapsed.total_seconds())
+            clock_parts.append(f"-{format_time(remaining)}")
+
+        clock = " │ ".join(clock_parts) if clock_parts else ""
+
+        # Combine with spacing
+        if clock:
+            return f" {progress}    {clock} "
+        return f" {progress} "
+
+    def reset_timer(self) -> None:
+        """Reset the elapsed timer."""
+        self._start_time = datetime.now(tz=timezone.utc)
+        self.refresh()
+
+    def toggle_clock(self) -> None:
+        """Cycle through clock display modes."""
+        if self.show_clock and not self.show_elapsed:
+            self.show_elapsed = True
+        elif self.show_clock and self.show_elapsed and not self.show_countdown:
+            if self.countdown_minutes > 0:
+                self.show_countdown = True
+            else:
+                self.show_clock = False
+                self.show_elapsed = False
+        elif self.show_countdown:
+            self.show_clock = False
+            self.show_elapsed = False
+            self.show_countdown = False
+        else:
+            self.show_clock = True
+            self.show_elapsed = False
+
+    def watch_current(self, value: int) -> None:
+        """React to current slide changes."""
+        self.refresh()
+
+    def watch_total(self, value: int) -> None:
+        """React to total slides changes."""
+        self.refresh()
+
+    def watch_show_clock(self, value: bool) -> None:
+        """React to clock visibility changes."""
+        self.refresh()
+
+    def watch_show_elapsed(self, value: bool) -> None:
+        """React to elapsed time visibility changes."""
+        self.refresh()
+
+
+# Keep these for backwards compatibility and separate use
+class ProgressBar(Static):
+    """A progress bar widget showing slide progress."""
+
+    current: reactive[int] = reactive(0)
+    total: reactive[int] = reactive(1)
+
+    def __init__(self, current: int = 0, total: int = 1, **kwargs) -> None:
+        """Initialize the progress bar.
+
+        Args:
+            current: Current slide index (0-based).
+            total: Total number of slides.
+            **kwargs: Additional arguments for Static widget.
+
+        """
+        super().__init__(**kwargs)
+        self.current = current
+        self.total = total
+
+    def render(self) -> str:
+        """Render the progress bar."""
+        bar = format_progress_bar(self.current, self.total, width=30)
+        return f" {bar} {self.current + 1}/{self.total} "
+
+    def watch_current(self, value: int) -> None:
+        """React to current position changes."""
+        self.refresh()
+
+    def watch_total(self, value: int) -> None:
+        """React to total count changes."""
+        self.refresh()
+
+
+class ClockDisplay(Static):
+    """A clock widget showing current time, elapsed, and countdown."""
+
+    show_clock: reactive[bool] = reactive(True)
+    show_elapsed: reactive[bool] = reactive(True)
+    show_countdown: reactive[bool] = reactive(False)
+    countdown_minutes: reactive[int] = reactive(0)
+
+    def __init__(self, **kwargs) -> None:
+        """Initialize the clock display."""
+        super().__init__(**kwargs)
+        self._start_time: datetime | None = None
+        self._timer = None
+
+    def on_mount(self) -> None:
+        """Start the clock timer on mount."""
+        self._start_time = datetime.now(tz=timezone.utc)
+        self._timer = self.set_interval(1.0, self._update_time)
+
+    def _update_time(self) -> None:
+        """Timer callback to update the display."""
+        self.refresh()
+
+    def render(self) -> str:
+        """Render the clock display."""
+        parts = []
+
+        if self.show_clock:
+            now = datetime.now(tz=timezone.utc).astimezone()
+            parts.append(now.strftime("%H:%M:%S"))
+
+        if self.show_elapsed and self._start_time:
+            elapsed = datetime.now(tz=timezone.utc) - self._start_time
+            elapsed_secs = int(elapsed.total_seconds())
+            parts.append(f"+{format_time(elapsed_secs)}")
+
+        if self.show_countdown and self.countdown_minutes > 0 and self._start_time:
+            total_secs = self.countdown_minutes * 60
+            elapsed = datetime.now(tz=timezone.utc) - self._start_time
+            remaining = total_secs - int(elapsed.total_seconds())
+            parts.append(f"-{format_time(remaining)}")
+
+        return " │ ".join(parts) if parts else ""
+
+    def reset_timer(self) -> None:
+        """Reset the elapsed timer."""
+        self._start_time = datetime.now(tz=timezone.utc)
+        self.refresh()
+
+    def toggle_clock(self) -> None:
+        """Cycle through clock display modes."""
+        if self.show_clock and not self.show_elapsed:
+            self.show_elapsed = True
+        elif self.show_clock and self.show_elapsed and not self.show_countdown:
+            if self.countdown_minutes > 0:
+                self.show_countdown = True
+            else:
+                self.show_clock = False
+                self.show_elapsed = False
+        elif self.show_countdown:
+            self.show_clock = False
+            self.show_elapsed = False
+            self.show_countdown = False
+        else:
+            self.show_clock = True

prezo-0.3.1.dist-info/METADATA

@@ -0,0 +1,194 @@
+Metadata-Version: 2.3
+Name: prezo
+Version: 0.3.1
+Summary: Add your description here
+Author: Stefane Fermigier
+Author-email: Stefane Fermigier <sf@fermigier.com>
+Requires-Dist: textual>=0.89.1
+Requires-Dist: python-frontmatter>=1.1.0
+Requires-Dist: textual-image>=0.8.0
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# Prezo
+
+A TUI-based presentation tool for the terminal, built with [Textual](https://textual.textualize.io/).
+
+Display presentations written in Markdown using conventions similar to those of [MARP](https://marp.app/) or [Deckset](https://www.deckset.com/).
+
+## Features (v0.3)
+
+- **Markdown presentations** - MARP/Deckset format with `---` slide separators
+- **Live reload** - Auto-refresh when file changes (1s polling)
+- **Keyboard navigation** - Vim-style keys, arrow keys, and more
+- **Slide overview** - Grid view for quick navigation (`o`)
+- **Search** - Find slides by content (`/`)
+- **Table of contents** - Navigate by headings (`t`)
+- **Go to slide** - Jump to specific slide number (`:`)
+- **Presenter notes** - Toggle notes panel (`p`)
+- **Themes** - 6 color schemes (`T` to cycle): dark, light, dracula, solarized-dark, nord, gruvbox
+- **Timer/Clock** - Elapsed time and countdown (`c`)
+- **Edit slides** - Open in $EDITOR (`e`), saves back to source file
+- **Export** - PDF, HTML, PNG, SVG formats with customizable themes and sizes
+- **Image support** - Inline and background images with MARP layout directives (left/right/fit)
+- **Native image viewing** - Press `i` for full-quality image display (iTerm2/Kitty protocols)
+- **Blackout/Whiteout** - Blank screen modes (`b`/`w`)
+- **Command palette** - Quick access to all commands (`Ctrl+P`)
+- **Config file** - Customizable settings via `~/.config/prezo/config.toml`
+- **Recent files** - Tracks recently opened presentations
+- **Position memory** - Remembers last slide position per file
+
+## Demo
+
+[![asciicast](https://asciinema.org/a/0rRbYzbq7iyha2wLkN6o4OPcX.svg)](https://asciinema.org/a/0rRbYzbq7iyha2wLkN6o4OPcX)
+
+
+## Installation
+
+```bash
+pip install prezo
+```
+
+Or with [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv tool install prezo
+```
+
+## Usage
+
+```bash
+# View a presentation
+prezo presentation.md
+
+# Disable auto-reload
+prezo --no-watch presentation.md
+
+# Use custom config
+prezo -c myconfig.toml presentation.md
+
+# Set image rendering mode
+prezo --image-mode ascii presentation.md   # Options: auto, kitty, sixel, iterm, ascii, none
+
+# Export to PDF
+prezo -e pdf presentation.md
+
+# Export with options
+prezo -e pdf presentation.md --theme light --size 100x30 --no-chrome
+```
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `→` / `j` / `Space` | Next slide |
+| `←` / `k` | Previous slide |
+| `Home` / `g` | First slide |
+| `End` / `G` | Last slide |
+| `:` | Go to slide number |
+| `/` | Search slides |
+| `o` | Slide overview |
+| `t` | Table of contents |
+| `p` | Toggle notes panel |
+| `c` | Cycle clock display |
+| `T` | Cycle theme |
+| `b` | Blackout screen |
+| `w` | Whiteout screen |
+| `i` | View image (native quality) |
+| `e` | Edit in $EDITOR |
+| `r` | Reload file |
+| `Ctrl+P` | Command palette |
+| `?` | Help |
+| `q` | Quit |
+
+## Presentation Format
+
+Prezo supports standard Markdown with MARP/Deckset conventions:
+
+```markdown
+---
+title: My Presentation
+theme: default
+---
+
+# First Slide
+
+Content here...
+
+---
+
+# Second Slide
+
+- Bullet points
+- Code blocks
+- Tables
+
+???
+Presenter notes go here (after ???)
+
+---
+
+# Third Slide
+
+<!-- notes: Alternative notes syntax -->
+
+More content...
+```
+
+## Themes
+
+Available themes: `dark`, `light`, `dracula`, `solarized-dark`, `nord`, `gruvbox`
+
+Press `T` to cycle through themes during presentation.
+
+## Export Options
+
+Prezo supports multiple export formats: PDF, HTML, PNG, and SVG.
+
+```bash
+# PDF export
+prezo -e pdf presentation.md                    # Default: 80x24, dark theme
+prezo -e pdf presentation.md --theme light      # Light theme (for printing)
+prezo -e pdf presentation.md --size 100x30      # Custom dimensions
+prezo -e pdf presentation.md --no-chrome        # No window decorations
+prezo -e pdf presentation.md -o slides.pdf      # Custom output path
+
+# HTML export (single self-contained file)
+prezo -e html presentation.md
+
+# Image export (PNG/SVG)
+prezo -e png presentation.md                    # All slides as PNG
+prezo -e png presentation.md --slide 3          # Single slide (1-indexed)
+prezo -e svg presentation.md --scale 2.0        # SVG with scale factor
+```
+
+PDF/PNG/SVG export requires optional dependencies:
+
+```bash
+pip install prezo[export]
+# or
+pip install cairosvg pypdf
+```
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/user/prezo.git
+cd prezo
+uv sync
+
+# Run
+uv run prezo presentation.md
+
+# Run tests
+uv run pytest
+
+# Lint
+uv run ruff check .
+uv run ruff format .
+```
+
+## License
+
+MIT

prezo-0.3.1.dist-info/RECORD

@@ -0,0 +1,32 @@
+prezo/__init__.py,sha256=01nNl1YtriyC0t81wvf_TYv9-GfdE3GrJ6hAAtewqUE,6118
+prezo/app.py,sha256=Y22P-v26eeUXeZrRevKRDHnba8ttMyH6LrS1y7VYc6g,31937
+prezo/config.py,sha256=643qfnmDB6mKxL5A0Hj52PPk7chscwtXEZp7vFAQUXc,6689
+prezo/export.py,sha256=gAVh9EjcJlG_DxSwy7nrG8bzNb9Mg5xo7pxLYW9t_HQ,23219
+prezo/images/__init__.py,sha256=xrWSR3z0SXYpLtjIvR2VOMxiJGkxEsls5-EOs9GecFA,324
+prezo/images/ascii.py,sha256=lBN6LT2f3wd65lqp5HviByxIvf_w0bcByE_uAkV6ZaY,7342
+prezo/images/base.py,sha256=STuS57AVSJ2lzwyn0QrIceGaSd2IWEiLGN-elT3u3AM,2749
+prezo/images/chafa.py,sha256=rqqctIw5xQarEYz5SR-2a5ePJ3xbm0a3NWiLwxNBEUE,3726
+prezo/images/iterm.py,sha256=bSIN6qfOt3URTjbV-d963K2bX9KdfT5cBQQOrIivZPs,3742
+prezo/images/kitty.py,sha256=PyB7aw4kI5Va4-HFtpCg7_TPIH3-V55M18-FyfScH7k,10822
+prezo/images/overlay.py,sha256=iPRJFGtf9MVVEhwfhgyx54c_GxdFBGGD3_VqDsRPMIA,9539
+prezo/images/processor.py,sha256=zMcfwltecup_AX2FhUIlPdO7c87a9jw7P9tLTIkr54U,4069
+prezo/images/sixel.py,sha256=6TL8WllZfH-rn4LDH2iigoTygyxY_jg80A2jUNvl8W0,5484
+prezo/parser.py,sha256=bD2MecHm7EssHd5LB2Bw6JuUqbjWPztWUu2meYwsyIQ,14793
+prezo/screens/__init__.py,sha256=xHG9jNJz4vi1tpneSEVlD0D9I0M2U4gAGk6-R9xbUf4,508
+prezo/screens/base.py,sha256=2n6Uj8evfIbcpn4AVYNG5iM_k7rIJ3Vwmor_xrQPU9E,2057
+prezo/screens/blackout.py,sha256=wPSdD9lgu8ykAIQjU1OesnmjQoQEn9BdC4TEpABYxW4,1640
+prezo/screens/goto.py,sha256=l9q6RAU8GX8WIALvbaPE3rcszrYWsJob8lGIDvUaWFM,2687
+prezo/screens/help.py,sha256=fjwHp9qPMmyRIaME-Bcz-g6bn8UrtbL_Dk269QSU-zs,2987
+prezo/screens/overview.py,sha256=s9-ifbcnXYhbxb_Kl2UhpB3IE7msInX6LWB-J1dazLo,5382
+prezo/screens/search.py,sha256=3YG9WLGEIKW3YHpM0K1lgwhuqBveXd8ZoQZ178_zGd4,7809
+prezo/screens/toc.py,sha256=8WYb5nbgP9agY-hUTATxLU4X1uka_bc2MN86hFW4aRg,8241
+prezo/terminal.py,sha256=1eMUFDpsnjlAkvBAjyPoMMuN7GxpvY94je99F47KxF8,3632
+prezo/themes.py,sha256=3keUgheOsNGjS0uCjRv7az9sVSnrz5tc-jZ58YNB7tg,3070
+prezo/widgets/__init__.py,sha256=UeTHBgPDvqTkK5tTsPXhdJXP3qZefnltKtUtvJBx9m0,295
+prezo/widgets/image_display.py,sha256=c3buM6NiM3oCcS2HWsb0HMeumsksS-U9PQnfl1EViEc,3349
+prezo/widgets/slide_button.py,sha256=g5mvtCZSorTIZp_PXgHYeYeeCSNFy0pW3K7iDlZu7yA,2012
+prezo/widgets/status_bar.py,sha256=C4Jw4pOpkx9FFLWo6Cmi57dJF0qt13LhfdKmBcGaY3o,8020
+prezo-0.3.1.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+prezo-0.3.1.dist-info/entry_points.txt,sha256=74ShZJ_EKjzi63JyPynVnc0uCHGNjIWjAVs8vU_qTyA,38
+prezo-0.3.1.dist-info/METADATA,sha256=1h7pr64Tq1ji0obykUIEpg1zBRwhJ_0Otlrj05eDUgU,4831
+prezo-0.3.1.dist-info/RECORD,,

prezo-0.3.1.dist-info/WHEEL

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

prezo-0.3.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+prezo = prezo:main
+