prezo 0.3.1__tar.gz → 2026.1.1__tar.gz

{prezo-0.3.1 → prezo-2026.1.1}/PKG-INFO

@@ -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 → prezo-2026.1.1}/README.md

@@ -123,6 +123,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-2026.1.1/pyproject.toml

@@ -0,0 +1,73 @@
+[project]
+name = "prezo"
+version = "2026.1.1"
+description = "A TUI-based presentation tool for the terminal, built with Textual."
+readme = "README.md"
+authors = [
+    { name = "Stefane Fermigier", email = "sf@fermigier.com" }
+]
+requires-python = ">=3.12"
+dependencies = [
+    "textual>=0.89.1",
+    "textual-image>=0.8.0",
+    "python-frontmatter>=1.1.0",
+]
+
+[project.scripts]
+prezo = "prezo:main"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=1.3.0",
+    "abilian-devtools>=0.8.0",
+    "ty>=0.0.2",
+    # See below
+    "cairosvg>=2.7.0",
+    "pypdf>=4.0.0",
+    "types-markdown>=3.10.0.20251106",
+]
+export = [
+    "cairosvg>=2.7.0",
+    "pypdf>=4.0.0",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+
+[build-system]
+requires = ["uv_build>=0.8.4,<0.9.0"]
+build-backend = "uv_build"
+
+[tool.pyrefly.errors]
+# Disable errors for third-party library type issues
+missing-source-for-stubs = false  # markdown stubs bundled but source not found
+missing-import = false  # libsixel optional dependency
+missing-attribute = false  # PIL.Image.ADAPTIVE
+no-matching-overload = false  # PIL type stub issues
+bad-argument-type = false  # LiteralString strictness with string append
+bad-override = false  # Textual COMMANDS type override
+
+[tool.ty.rules]
+# Disable errors for third-party library type issues
+unresolved-import = "ignore"  # markdown, libsixel optional dependencies
+unresolved-attribute = "ignore"  # PIL.Image.ADAPTIVE
+invalid-argument-type = "ignore"  # PIL getdata() type issues
+invalid-type-form = "ignore"  # TextualImage type annotation
+
+[tool.mypy]
+python_version = "3.12"
+warn_return_any = false
+warn_unused_ignores = true
+ignore_missing_imports = true  # For optional dependencies like libsixel
+
+[[tool.mypy.overrides]]
+module = [
+    "frontmatter",
+    "cairosvg",
+    "libsixel",
+    "textual_image.*",
+]
+ignore_missing_imports = true

{prezo-0.3.1 → prezo-2026.1.1}/src/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-0.3.1 → prezo-2026.1.1}/src/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-0.3.1 → prezo-2026.1.1}/src/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-0.3.1 → prezo-2026.1.1}/src/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-0.3.1 → prezo-2026.1.1}/src/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-0.3.1 → prezo-2026.1.1}/src/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-0.3.1 → prezo-2026.1.1}/src/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-0.3.1 → prezo-2026.1.1}/src/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-0.3.1 → prezo-2026.1.1}/src/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-0.3.1 → prezo-2026.1.1}/src/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-0.3.1 → prezo-2026.1.1}/src/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/pyproject.toml

@@ -1,44 +0,0 @@
-[project]
-name = "prezo"
-version = "0.3.1"
-description = "Add your description here"
-readme = "README.md"
-authors = [
-    { name = "Stefane Fermigier", email = "sf@fermigier.com" }
-]
-requires-python = ">=3.12"
-dependencies = [
-    "textual>=0.89.1",
-    "python-frontmatter>=1.1.0",
-    "textual-image>=0.8.0",
-]
-
-[project.scripts]
-prezo = "prezo:main"
-
-[dependency-groups]
-dev = [
-    "pytest>=8.0.0",
-    "cairosvg>=2.7.0",
-    "pypdf>=4.0.0",
-    "abilian-devtools>=0.8.0",
-    "pytest-asyncio>=1.3.0",
-    "ty>=0.0.2",
-]
-export = [
-    "cairosvg>=2.7.0",
-    "pypdf>=4.0.0",
-]
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
-asyncio_mode = "auto"
-asyncio_default_fixture_loop_scope = "function"
-
-[build-system]
-requires = ["uv_build>=0.8.4,<0.9.0"]
-build-backend = "uv_build"
-
-# [build-system]
-# requires = ["hatchling"]
-# build-backend = "hatchling.build"