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

prezo/__init__.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import argparse
 import sys
 from pathlib import Path
+from typing import NoReturn
 
 # ANSI color codes for error messages
 RED = "\033[91m"
@@ -13,7 +14,7 @@ BOLD = "\033[1m"
 RESET = "\033[0m"
 
 
-def _error(message: str) -> None:
+def _error(message: str) -> NoReturn:
     """Print an error message and exit."""
     sys.stderr.write(f"{RED}{BOLD}error:{RESET} {message}\n")
     sys.exit(1)
@@ -24,6 +25,26 @@ def _warn(message: str) -> None:
     sys.stderr.write(f"{YELLOW}{BOLD}warning:{RESET} {message}\n")
 
 
+def _parse_size(size_str: str) -> tuple[int, int]:
+    """Parse a size string like '80x24' into width and height.
+
+    Args:
+        size_str: Size string in WIDTHxHEIGHT format.
+
+    Returns:
+        Tuple of (width, height).
+
+    """
+    try:
+        width, height = map(int, size_str.lower().split("x"))
+        return width, height
+    except ValueError:
+        _error(
+            f"invalid size format: {size_str}\n\n"
+            "Use WIDTHxHEIGHT format (e.g., 80x24, 100x30)"
+        )
+
+
 def _validate_file(path: Path, must_exist: bool = True) -> Path:
     """Validate a file path and return the resolved path.
 
@@ -158,13 +179,7 @@ def main() -> None:
         source_path = _validate_file(Path(args.file))
 
         # Parse size
-        try:
-            width, height = map(int, args.size.lower().split("x"))
-        except ValueError:
-            _error(
-                f"invalid size format: {args.size}\n\n"
-                "Use WIDTHxHEIGHT format (e.g., 80x24, 100x30)"
-            )
+        width, height = _parse_size(args.size)
 
         if args.export == "html":
             from .export import run_html_export  # noqa: PLC0415

prezo/app.py

@@ -12,9 +12,12 @@ import termios
 import tty
 from functools import partial
 from pathlib import Path
-from typing import ClassVar
+from typing import TYPE_CHECKING, ClassVar
 
 from textual.app import App, ComposeResult
+
+if TYPE_CHECKING:
+    from textual.timer import Timer
 from textual.binding import Binding, BindingType
 from textual.command import Hit, Hits, Provider
 from textual.containers import Horizontal, Vertical, VerticalScroll
@@ -196,7 +199,7 @@ class PrezoApp(App):
 
     ENABLE_COMMAND_PALETTE = True
     COMMAND_PALETTE_BINDING = "ctrl+p"
-    COMMANDS: ClassVar[set[type[Provider]]] = {PrezoCommands}
+    COMMANDS: ClassVar[set[type[Provider]]] = {PrezoCommands}  # type: ignore[assignment]
 
     CSS = """
     Screen {
@@ -239,12 +242,12 @@ class PrezoApp(App):
     #slide-container {
         width: 1fr;
         height: 100%;
-        padding: 1 4;
+        padding: 0 4 1 4;
     }
 
     #slide-content {
         width: 100%;
-        padding: 1 2;
+        padding: 0 2;
     }
 
     /* Image container - hidden by default */
@@ -371,7 +374,7 @@ class PrezoApp(App):
             self.watch_enabled = watch
 
         self._file_mtime: float | None = None
-        self._watch_timer = None
+        self._watch_timer: Timer | None = None
         self._reload_interval = self.config.behavior.reload_interval
 
     def compose(self) -> ComposeResult:
@@ -735,7 +738,7 @@ class PrezoApp(App):
     def watch_app_theme(self, theme_name: str) -> None:
         """Apply theme when it changes."""
         # Only apply to widgets after mount (watcher fires during init)
-        if not self.is_mounted:
+        if not self.is_mounted:  # type: ignore[truthy-function]
             return
         self._apply_theme(theme_name)
         self.notify(f"Theme: {theme_name}", timeout=1)

prezo/config.py

@@ -11,7 +11,7 @@ from typing import Any
 try:
     import tomllib
 except ImportError:
-    import tomli as tomllib  # type: ignore[import-not-found,no-redef]
+    import tomli as tomllib  # type: ignore[no-redef]
 
 
 CONFIG_DIR = Path.home() / ".config" / "prezo"

prezo/export.py

@@ -240,8 +240,8 @@ def export_to_pdf(
         return EXPORT_FAILED, "Presentation has no slides"
 
     # Create temporary directory for SVG files
-    with tempfile.TemporaryDirectory() as tmpdir:
-        tmpdir = Path(tmpdir)
+    with tempfile.TemporaryDirectory() as tmpdir_str:
+        tmpdir = Path(tmpdir_str)
         svg_files = []
 
         # Render each slide to SVG
@@ -674,6 +674,8 @@ def export_slide_to_image(
             bytestring=svg_content.encode("utf-8"),
             scale=scale,
         )
+        if png_data is None:
+            return EXPORT_FAILED, "PNG conversion returned no data"
         output_path.write_bytes(png_data)
         return EXPORT_SUCCESS, f"Exported slide {slide_num + 1} to {output_path}"
     except Exception as e:

prezo/images/ascii.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 from functools import lru_cache
 from pathlib import Path
+from typing import cast
 
 # ASCII characters from dark to light
 ASCII_CHARS = " .:-=+*#%@"
@@ -54,7 +55,7 @@ class AsciiRenderer:
         """Render image using PIL."""
         from PIL import Image
 
-        img = Image.open(path)
+        img: Image.Image = Image.open(path)
 
         # Convert to grayscale
         img = img.convert("L")
@@ -68,8 +69,8 @@ class AsciiRenderer:
         # Resize
         img = img.resize((new_width, new_height))
 
-        # Convert to ASCII
-        pixels = list(img.getdata())
+        # Convert to ASCII (grayscale values 0-255)
+        pixels = cast("list[int]", list(img.get_flattened_data()))
         lines = []
 
         for y in range(new_height):
@@ -114,7 +115,7 @@ class ColorAsciiRenderer(AsciiRenderer):
         """Render image as colored ASCII."""
         from PIL import Image
 
-        img = Image.open(path)
+        img: Image.Image = Image.open(path)
 
         # Keep color, convert to RGB
         img = img.convert("RGB")
@@ -127,8 +128,8 @@ class ColorAsciiRenderer(AsciiRenderer):
         # Resize
         img = img.resize((new_width, new_height))
 
-        # Convert to colored ASCII
-        pixels = list(img.getdata())
+        # Convert to colored ASCII (RGB tuples)
+        pixels = cast("list[tuple[int, int, int]]", list(img.get_flattened_data()))
         lines = []
 
         for y in range(new_height):
@@ -178,7 +179,7 @@ class HalfBlockRenderer:
         """Render image using half-blocks."""
         from PIL import Image
 
-        img = Image.open(path)
+        img: Image.Image = Image.open(path)
         img = img.convert("RGB")
 
         # Calculate dimensions (height is doubled because of half-blocks)
@@ -190,7 +191,8 @@ class HalfBlockRenderer:
         new_height = new_height - (new_height % 2)
 
         img = img.resize((new_width, new_height))
-        pixels = list(img.getdata())
+        # RGB tuples for half-block rendering
+        pixels = cast("list[tuple[int, int, int]]", list(img.get_flattened_data()))
 
         lines = []
         for y in range(0, new_height, 2):

prezo/images/kitty.py

@@ -47,13 +47,14 @@ class KittyImageManager:
 
     _instance: KittyImageManager | None = None
     _next_id: int = 1
+    _initialized: bool = False
 
     def __new__(cls) -> Self:
         """Create or return singleton instance."""
         if cls._instance is None:
             cls._instance = super().__new__(cls)
             cls._instance._initialized = False
-        return cls._instance
+        return cls._instance  # type: ignore[return-value]
 
     def __init__(self) -> None:
         """Initialize the Kitty image manager."""

prezo/images/overlay.py

@@ -45,13 +45,14 @@ class ImageOverlayRenderer:
     """
 
     _instance: ImageOverlayRenderer | None = None
+    _initialized: bool = False
 
     def __new__(cls) -> Self:
         """Create or return singleton instance."""
         if cls._instance is None:
             cls._instance = super().__new__(cls)
             cls._instance._initialized = False
-        return cls._instance
+        return cls._instance  # type: ignore[return-value]
 
     def __init__(self) -> None:
         """Initialize the image overlay renderer."""

prezo/images/sixel.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, cast
 
 if TYPE_CHECKING:
     from pathlib import Path
@@ -53,7 +53,7 @@ class SixelRenderer:
         from PIL import Image
 
         # Load and resize image
-        img = Image.open(path)
+        img: Image.Image = Image.open(path)
         img = img.convert("RGB")
 
         # Calculate pixel dimensions
@@ -89,8 +89,8 @@ class SixelRenderer:
         """
         from PIL import Image
 
-        img = Image.open(path)
-        img = img.convert("P", palette=Image.ADAPTIVE, colors=256)
+        img: Image.Image = Image.open(path)
+        img = img.convert("P", palette=Image.Palette.ADAPTIVE, colors=256)
 
         # Calculate pixel dimensions
         pixel_width = width * 8
@@ -108,12 +108,12 @@ class SixelRenderer:
 
         img = img.resize((pixel_width, pixel_height))
 
-        # Get palette
+        # Get palette and pixel data (palette indices 0-255)
         palette = img.getpalette()
-        pixels = list(img.getdata())
+        pixels = cast("list[int]", list(img.get_flattened_data()))
 
         # Build sixel output
-        output = []
+        output: list[str] = []
 
         # Start sixel sequence
         output.append("\x1bPq")

prezo/terminal.py

@@ -128,7 +128,7 @@ def supports_true_color() -> bool:
     return _is_iterm() or _is_kitty()
 
 
-def get_capability_summary() -> dict[str, bool | str]:
+def get_capability_summary() -> dict[str, bool | int | str]:
     """Get a summary of terminal capabilities.
 
     Returns:

prezo/widgets/image_display.py

@@ -6,7 +6,7 @@ Falls back to Unicode halfcell rendering for unsupported terminals.
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any
 
 from textual.widgets import Static
 from textual_image.widget import Image as TextualImage
@@ -68,7 +68,7 @@ class ImageDisplay(Static):
         self._image_path: Path | str | None = image_path
         self._width: int | None = width
         self._height: int | None = height
-        self._image_widget: TextualImage | None = None
+        self._image_widget: Any = None  # TextualImage | None
 
     def compose(self) -> ComposeResult:
         """Compose the image widget."""

prezo/widgets/status_bar.py

@@ -3,10 +3,14 @@
 from __future__ import annotations
 
 from datetime import datetime, timezone
+from typing import TYPE_CHECKING
 
 from textual.reactive import reactive
 from textual.widgets import Static
 
+if TYPE_CHECKING:
+    from textual.timer import Timer
+
 
 def format_progress_bar(current: int, total: int, width: int = 20) -> str:
     """Generate a progress bar string.
@@ -57,7 +61,7 @@ class StatusBar(Static):
         """Initialize the status bar."""
         super().__init__(**kwargs)
         self._start_time: datetime | None = None
-        self._timer = None
+        self._timer: Timer | None = None
 
     def on_mount(self) -> None:
         """Start the timer on mount."""
@@ -185,7 +189,7 @@ class ClockDisplay(Static):
         """Initialize the clock display."""
         super().__init__(**kwargs)
         self._start_time: datetime | None = None
-        self._timer = None
+        self._timer: Timer | None = None
 
     def on_mount(self) -> None:
         """Start the clock timer on mount."""

{prezo-0.3.1.dist-info → prezo-2026.1.1.dist-info}/METADATA

@@ -1,12 +1,12 @@
 Metadata-Version: 2.3
 Name: prezo
-Version: 0.3.1
-Summary: Add your description here
+Version: 2026.1.1
+Summary: A TUI-based presentation tool for the terminal, built with Textual.
 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-Dist: python-frontmatter>=1.1.0
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 
@@ -135,6 +135,8 @@ Presenter notes go here (after ???)
 More content...
 ```
 
+See the [Writing Presentations in Markdown](docs/tutorial.md) tutorial for a complete guide on creating presentations, including images, presenter notes, and configuration directives.
+
 ## Themes
 
 Available themes: `dark`, `light`, `dracula`, `solarized-dark`, `nord`, `gruvbox`

{prezo-0.3.1.dist-info → prezo-2026.1.1.dist-info}/RECORD

@@ -1,16 +1,16 @@
-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/__init__.py,sha256=blmZoW_bPndFLVT4UZzrfAp8IaGuvmFhtNGUs0nHpFQ,6434
+prezo/app.py,sha256=5K1tcinaTSI-X24bqV7W7fuwC0Wtw6IH_Gfy2RI3WMo,32086
+prezo/config.py,sha256=byBBFHZU3fkq3dRfg5h4zG_eihbi7lHZkriSv-g-ogY,6672
+prezo/export.py,sha256=1npeBV3m9_eTGhYHG7G-ekDGIRX4vNBgtt2RwpjLydc,23324
 prezo/images/__init__.py,sha256=xrWSR3z0SXYpLtjIvR2VOMxiJGkxEsls5-EOs9GecFA,324
-prezo/images/ascii.py,sha256=lBN6LT2f3wd65lqp5HviByxIvf_w0bcByE_uAkV6ZaY,7342
+prezo/images/ascii.py,sha256=aNz02jN4rkDw0WzmkGDrAGw1R1dY5QGREvIIPI6jwow,7613
 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/kitty.py,sha256=mWR-tIE_WDP5BjOkQydPpxWBBGNaZL8PkMICesWQid8,10883
+prezo/images/overlay.py,sha256=lWIAvINxZrKembtB0gzWWaUoedNt7beFU4OhErfwWaw,9600
 prezo/images/processor.py,sha256=zMcfwltecup_AX2FhUIlPdO7c87a9jw7P9tLTIkr54U,4069
-prezo/images/sixel.py,sha256=6TL8WllZfH-rn4LDH2iigoTygyxY_jg80A2jUNvl8W0,5484
+prezo/images/sixel.py,sha256=2IeKDiMsWU1Tn3HYI3PC972ygxKGqpfz6tnhQcM_sVM,5604
 prezo/parser.py,sha256=bD2MecHm7EssHd5LB2Bw6JuUqbjWPztWUu2meYwsyIQ,14793
 prezo/screens/__init__.py,sha256=xHG9jNJz4vi1tpneSEVlD0D9I0M2U4gAGk6-R9xbUf4,508
 prezo/screens/base.py,sha256=2n6Uj8evfIbcpn4AVYNG5iM_k7rIJ3Vwmor_xrQPU9E,2057
@@ -20,13 +20,13 @@ 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/terminal.py,sha256=Z3DuuighY-qfF6GWH_AkR5RnAc5Gj3LsPS266VNj7Pk,3638
 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/image_display.py,sha256=8IKncaoC2iWebmJQp_QomF7UVgRxD4WThOshN1Nht2M,3361
 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/widgets/status_bar.py,sha256=Wcun71kg2Q4s5aduPwTvS4kDHZj5p-zDmD7Cx3_ZFP4,8136
+prezo-2026.1.1.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+prezo-2026.1.1.dist-info/entry_points.txt,sha256=74ShZJ_EKjzi63JyPynVnc0uCHGNjIWjAVs8vU_qTyA,38
+prezo-2026.1.1.dist-info/METADATA,sha256=b1ymsfoTcOMGVvcoTbb3OSucstuN2QmPz-te-beEjSM,5061
+prezo-2026.1.1.dist-info/RECORD,,