py-sparcli 0.4.0__tar.gz → 0.5.0__tar.gz

{py_sparcli-0.4.0 → py_sparcli-0.5.0}/CHANGELOG.md

@@ -6,6 +6,18 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.5.0] – 2026-11-06
+
+### Added
+
+- `Theme` has five new fields for styles that were fixed in code: `diff_add` and `diff_delete` (the diff's added and removed lines, default green and red), `progress_empty` (the empty part of a progress bar, default dark gray), `code` (backtick code spans in markup, default cyan) and `stripe` (the shaded rows of a striped table, default dim). `Diff`, `ProgressOpts`, the markup parser and `Table` read them, so an app can theme them; the defaults are the previous look. The fields have defaults, so existing `Theme(...)` calls keep working. Mirrors the Rust release 0.5.0.
+- `Color.from_name` accepts the ratada `ansi:<name>` tokens (`ansi:dark_gray`, `ansi:light_red`, ...; `ansi:white` is the bright white), so one token names the same color in the Python and the Rust toolkits.
+- `tests/test_theme_only_colours.py` fails on a color literal in the package outside the color type and the built-in theme.
+
+### Changed
+
+- The unselected buttons of `Confirm` use `theme.hint` instead of a fixed dim style; the default `hint` is that same dim style.
+
 ## [0.4.0] – 2026-07-19
 
 ### Added
@@ -88,7 +100,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 - Unified `Theme`, inline `markup`, width utilities, terminal capability detection, validators, shortcuts and command history.
 - Dependency-free (standard library only).
 
-[Unreleased]: https://github.com/cgroening/py-sparcli/compare/v0.4.0...HEAD
+[Unreleased]: https://github.com/cgroening/py-sparcli/compare/v0.5.0...HEAD
+[0.5.0]: https://github.com/cgroening/py-sparcli/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/cgroening/py-sparcli/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/cgroening/py-sparcli/compare/v0.1.0...v0.3.0
 [0.1.0]: https://github.com/cgroening/py-sparcli/releases/tag/v0.1.0

{py_sparcli-0.4.0 → py_sparcli-0.5.0}/CLAUDE.md

@@ -1,6 +1,6 @@
 # CLAUDE.md – sparcli (Python)
 
-Requirements for all future sessions in this project. On conflict, this file takes precedence over general conventions, but not over explicit user instructions. The global style guide (`~/.claude/CLAUDE.md` → §12 Python) applies additionally; this file refines and overrides it wherever it is more specific.
+Requirements for all future sessions in this project. On conflict, this file takes precedence over general conventions, but not over explicit user instructions.
 
 ## What is this?
 
@@ -37,13 +37,13 @@ Requirements for all future sessions in this project. On conflict, this file tak
 
 Where a rule applies in more than one widget it lives in exactly one place. Do not reimplement these per call site: `core.width.truncate`/`truncate_line` for `…` clipping, `input.selection.SelectionCursor` for cursor and scroll window, `input.prompt.run_on_terminal` for the terminal handover, `core.command.split_command`/`resolve_from_env` for external commands.
 
-## Output streams (§1.6)
+## Output streams
 
-sparcli is a library, not a CLI program, so §1.6 binds it only through what it prints:
+sparcli is a library, not a CLI program, so the CLI output rules bind it only through what it prints:
 
 - Payload goes to **stdout**, progress indicators to **stderr**, and progress draws only when stderr is a terminal. `InPlace.progress()` is the seam.
 - `print`/`print_to` do **not** truncate when stdout is not a terminal: they lay out at `UNCONSTRAINED_WIDTH`, because clipping to an invented width loses piped data silently. An explicit `render(max_width)` still truncates – that width is the caller's decision.
-- §1.7 (TUI) rules – scrollbar on overflow, a `?` overlay in every prompt, `Ctrl+Q` – are deliberately **not** implemented. They govern terminal UIs, not a CLI output library.
+- TUI rules – scrollbar on overflow, a `?` overlay in every prompt, `Ctrl+Q` – are deliberately **not** implemented. They govern terminal UIs, not a CLI output library.
 - The public API is re-exported flat (`from sparcli import ...`, 81 symbols) plus the namespaces `sparcli.width/terminal/markup/event/validate/shortcut`. Every `__init__.py` carries an explicit `__all__` list.
 
 ## Dependencies
@@ -60,7 +60,7 @@ sparcli is a library, not a CLI program, so §1.6 binds it only through what it
 
 - Target Python: **3.12+** (`requires-python = ">=3.12"`).
 - **Strings: double quotes `"..."`** everywhere, including nested inside f-strings (PEP 701). Enforced via the `Q` lint rules with `inline-quotes = "double"` and `avoid-escape = false`; the formatter uses `quote-style = "preserve"` so it cannot rewrite the nested case back to single quotes. `repr` outputs in doctests keep their single quotes, because that is what Python prints.
-- **Formatting/linting:** `ruff` (format + lint), running the full rule set from the style guide. 80-character lines, enforced (`E501` is on). Imports isort-sorted (stdlib → third-party → local). `from __future__ import annotations` as the first line of every module. Every entry in the `ignore` list carries a comment saying why.
+- **Formatting/linting:** `ruff` (format + lint) with the rule set in `pyproject.toml`. 80-character lines, enforced (`E501` is on). Imports isort-sorted (stdlib → third-party → local). `from __future__ import annotations` as the first line of every module. Every entry in the `ignore` list carries a comment saying why.
 - **Docstrings:** NumPy convention. The fluent builder setters keep a single-line docstring instead of full `Parameters`/`Returns` blocks – they take one argument and return `self`, so the blocks would add length without information. Full blocks are required everywhere else.
 - **Type checking:** `basedpyright` in **strict** mode must report 0 errors. Complete, modern type hints (`X | None`, builtin generics, PEP 695).
 - No em dash; straight quotes/apostrophes; named constants instead of magic numbers/strings.

{py_sparcli-0.4.0 → py_sparcli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: py-sparcli
-Version: 0.4.0
+Version: 0.5.0
 Summary: Styled CLI output and interactive input widgets, dependency-free
 Project-URL: Homepage, https://github.com/cgroening/py-sparcli
 Project-URL: Repository, https://github.com/cgroening/py-sparcli
@@ -190,6 +190,8 @@ set_theme(
 active = theme()
 ```
 
+Every color a widget draws comes from the theme: the accent, the message roles (`success`, `error`, `warning`, `info`, `debug`), `secondary`/`hint`, `selection`/`cursor`, and the widget styles `diff_add`, `diff_delete`, `progress_empty`, `code` and `stripe`. `Color.from_name` also accepts the `ansi:<name>` tokens of the Rust toolkit family (`ansi:dark_gray`, `ansi:light_red`, ...), so one token means the same color everywhere.
+
 ## Output components
 
 The `output_readme.py` example composes a hero panel, a three-column dashboard and a progress bar:

{py_sparcli-0.4.0 → py_sparcli-0.5.0}/README.md

@@ -164,6 +164,8 @@ set_theme(
 active = theme()
 ```
 
+Every color a widget draws comes from the theme: the accent, the message roles (`success`, `error`, `warning`, `info`, `debug`), `secondary`/`hint`, `selection`/`cursor`, and the widget styles `diff_add`, `diff_delete`, `progress_empty`, `code` and `stripe`. `Color.from_name` also accepts the `ansi:<name>` tokens of the Rust toolkit family (`ansi:dark_gray`, `ansi:light_red`, ...), so one token means the same color everywhere.
+
 ## Output components
 
 The `output_readme.py` example composes a hero panel, a three-column dashboard and a progress bar:

{py_sparcli-0.4.0 → py_sparcli-0.5.0}/docs/DEVELOPMENT.md

@@ -54,7 +54,7 @@ basedpyright sparcli examples # strict type checking
 
 Both `ruff check` and `basedpyright` must be clean. The project targets strict typing: every public item is annotated, and `ruff` runs the full documented rule set, including docstring style (NumPy convention), annotations, complexity, security (`flake8-bandit`), `pathlib` usage and import ordering. Line length is enforced at 80 columns.
 
-Every entry in the `ignore` list in `pyproject.toml` carries a comment saying why it is there. The two that most often surprise newcomers: `D401` is off because the style guide mandates third-person docstring summaries ("Returns ...") where that rule wants the imperative, and `FBT001`/`FBT002` are off because the fluent builder API takes booleans by design (`Table.striped(True)`) to mirror the Rust port.
+Every entry in the `ignore` list in `pyproject.toml` carries a comment saying why it is there. The two that most often surprise newcomers: `D401` is off because docstring summaries are written in the third person ("Returns ...") where that rule wants the imperative, and `FBT001`/`FBT002` are off because the fluent builder API takes booleans by design (`Table.striped(True)`) to mirror the Rust port.
 
 Dependencies are audited separately:
 

{py_sparcli-0.4.0 → py_sparcli-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "py-sparcli"
-version = "0.4.0"
+version = "0.5.0"
 description = "Styled CLI output and interactive input widgets, dependency-free"
 readme = "README.md"
 license = "MIT"
@@ -82,8 +82,8 @@ select = [
     "TID", "PL", "RUF",
 ]
 # The numpy convention disables D212 and D213 alike, which silently permits
-# both layouts. D213 has to be re-enabled explicitly to enforce the one the
-# style guide mandates: summary on the line after the opening quotes.
+# both layouts. D213 has to be re-enabled explicitly to enforce the one used
+# here: summary on the line after the opening quotes.
 extend-select = ["D213"]
 
 ignore = [
@@ -91,8 +91,8 @@ ignore = [
     "TRY003",
     # Forbids deferred imports, which break the layering here.
     "PLC0415",
-    # Demands imperative docstrings; the style guide mandates third
-    # person singular ("Returns ..."), so this rule is inverted for us.
+    # Demands imperative docstrings; summaries here use the third person
+    # singular ("Returns ..."), so this rule is inverted for us.
     "D401",
     # Widget constructors are keyword-only by design and mirror the Rust
     # port's builder API, so their argument count is intentional.
@@ -112,15 +112,15 @@ ignore = [
     # callbacks are fixed-signature contracts; an implementation that does not
     # need a parameter still has to accept it under that exact name.
     "ARG002",
-    # The style guide mandates the en dash in prose, which this rule flags as
-    # an ambiguous character.
+    # Prose uses the en dash, which this rule flags as an ambiguous
+    # character.
     "RUF002",
     # Conflicts with D213 (summary on the line after the opening quotes).
     "D212",
 ]
 
 [tool.ruff.lint.pylint]
-# Guard-clause style (style guide 1.2.5) produces many early returns by
+# Guard-clause style produces many early returns by
 # design; the dispatch functions here top out at eight.
 max-returns = 8
 

{py_sparcli-0.4.0 → py_sparcli-0.5.0}/sparcli/core/color.py

@@ -103,6 +103,28 @@ _NAME_ALIASES: dict[str, ColorName] = {
     "brightwhite": ColorName.WHITE,
 }
 
+# The ratada `ansi:<name>` tokens, so one token names the same color in every
+# crate and package of the family; `ansi:white` is the bright white.
+_ANSI_PREFIX = "ansi:"
+_ANSI_TOKENS: dict[str, ColorName] = {
+    "black": ColorName.BLACK,
+    "red": ColorName.RED,
+    "green": ColorName.GREEN,
+    "yellow": ColorName.YELLOW,
+    "blue": ColorName.BLUE,
+    "magenta": ColorName.MAGENTA,
+    "cyan": ColorName.CYAN,
+    "gray": ColorName.GRAY,
+    "dark_gray": ColorName.DARK_GRAY,
+    "light_red": ColorName.LIGHT_RED,
+    "light_green": ColorName.LIGHT_GREEN,
+    "light_yellow": ColorName.LIGHT_YELLOW,
+    "light_blue": ColorName.LIGHT_BLUE,
+    "light_magenta": ColorName.LIGHT_MAGENTA,
+    "light_cyan": ColorName.LIGHT_CYAN,
+    "white": ColorName.WHITE,
+}
+
 _HEX_DIGITS = 6
 
 # Standard xterm RGB values of the sixteen named colors, by palette index.
@@ -210,17 +232,35 @@ class Color:
         """
         Parses a color name (case-insensitive), returning ``None`` if unknown.
 
+        The ``ansi:<name>`` tokens of ratada are accepted too
+        (``ansi:dark_gray``, ``ansi:light_red``, ..., where ``ansi:white`` is
+        the bright white), so one token names the same color across the
+        toolkit family.
+
         Parameters
         ----------
         text : str
-            A color name such as ``"red"`` or an alias such as ``"purple"``.
+            A color name such as ``"red"``, an alias such as ``"purple"`` or a
+            token such as ``"ansi:dark_gray"``.
 
         Returns
         -------
         Color | None
             The matching color, or ``None`` when the name is not recognized.
+
+        Examples
+        --------
+        >>> Color.from_name("ansi:dark_gray") == Color.DARK_GRAY
+        True
+        >>> Color.from_name("ansi:white") == Color.WHITE
+        True
         """
-        name = _NAME_ALIASES.get(text.strip().lower())
+        lowered = text.strip().lower()
+        if lowered.startswith(_ANSI_PREFIX):
+            token = lowered.removeprefix(_ANSI_PREFIX).replace("grey", "gray")
+            name = _ANSI_TOKENS.get(token)
+        else:
+            name = _NAME_ALIASES.get(lowered)
         return cls(name=name) if name is not None else None
 
     @classmethod

{py_sparcli-0.4.0 → py_sparcli-0.5.0}/sparcli/core/markup.py

@@ -18,6 +18,7 @@ from sparcli.core.color import Color
 from sparcli.core.render import Renderable, Rendered
 from sparcli.core.style import Attribute, Style
 from sparcli.core.text import Line, Span, Text
+from sparcli.core.theme import theme
 
 _BACKGROUND_KEYWORD = "on"
 
@@ -163,13 +164,13 @@ class _Parser:
         return end + 1
 
     def _toggle_code(self) -> None:
-        """Toggles a cyan code style on or off at the current nesting."""
+        """Toggles the theme's code style on or off at the current nesting."""
         self._flush_buffer()
         if self._in_code:
             if len(self._stack) > 1:
                 self._stack.pop()
         else:
-            code = self._current().patch(Style.new().with_fg(Color.CYAN))
+            code = self._current().patch(theme().code)
             self._stack.append(code)
         self._in_code = not self._in_code
 

{py_sparcli-0.4.0 → py_sparcli-0.5.0}/sparcli/core/theme.py

@@ -30,6 +30,11 @@ _DEBUG = Style.from_color(Color.MAGENTA)
 _SECONDARY = Style.new().dim()
 _SELECTION = Style.from_color(DEFAULT_ACCENT).bold()
 _CURSOR = Style.new().with_fg(Color.BLACK).with_bg(DEFAULT_ACCENT)
+_DIFF_ADD = Style.from_color(Color.GREEN)
+_DIFF_DELETE = Style.from_color(Color.RED)
+_PROGRESS_EMPTY = Color.DARK_GRAY
+_CODE = Style.from_color(Color.CYAN)
+_STRIPE = Style.new().dim()
 
 # Two-step glyphs: (unicode, ascii). ASCII is the fallback for plain terminals.
 _BULLET = ("•", "*")
@@ -53,6 +58,14 @@ class Theme:
         Semantic styles applied throughout the library.
     selection, cursor : Style
         Styles for the highlighted item and the text cursor.
+    diff_add, diff_delete : Style
+        Styles for added and removed lines in a diff.
+    progress_empty : Color
+        Color of the empty part of a progress bar.
+    code : Style
+        Style for backtick code spans in markup.
+    stripe : Style
+        Style for the shaded rows of a striped table.
     border : BorderType
         The default border look.
     unicode : bool
@@ -71,6 +84,11 @@ class Theme:
     hint: Style = _SECONDARY
     selection: Style = _SELECTION
     cursor: Style = _CURSOR
+    diff_add: Style = _DIFF_ADD
+    diff_delete: Style = _DIFF_DELETE
+    progress_empty: Color = _PROGRESS_EMPTY
+    code: Style = _CODE
+    stripe: Style = _STRIPE
     border: BorderType = BorderType.ROUNDED
     unicode: bool = True
 

{py_sparcli-0.4.0 → py_sparcli-0.5.0}/sparcli/input/confirm.py

@@ -16,7 +16,6 @@ from __future__ import annotations
 from typing import TYPE_CHECKING
 
 from sparcli.core.render import Rendered
-from sparcli.core.style import Style
 from sparcli.core.text import Line, Span
 from sparcli.core.theme import Theme, theme
 from sparcli.input.event import (
@@ -197,7 +196,7 @@ class Confirm:
 
 
 def _option_span(label: str, selected: bool, active: Theme) -> Span:
-    """Renders one option, highlighted when selected and dimmed otherwise."""
+    """Renders one option, highlighted when selected and as a hint otherwise."""
     if selected:
         return Span.styled(f"[{label}]", active.selection)
-    return Span.styled(f" {label} ", Style.new().dim())
+    return Span.styled(f" {label} ", active.hint)

{py_sparcli-0.4.0 → py_sparcli-0.5.0}/sparcli/output/diff.py

@@ -14,13 +14,15 @@ fall back to a plain delete-then-insert listing.
 from __future__ import annotations
 
 import enum
+from typing import TYPE_CHECKING
 
-from sparcli.core.color import Color
 from sparcli.core.render import Renderable, Rendered
-from sparcli.core.style import Style
 from sparcli.core.text import Line
 from sparcli.core.theme import theme
 
+if TYPE_CHECKING:
+    from sparcli.core.style import Style
+
 # Default number of unchanged context lines kept around each change.
 DEFAULT_CONTEXT = 3
 # Maximum lines per side before falling back to a full listing.
@@ -88,12 +90,10 @@ class Diff(Renderable):
         self._old_label = old_label
         self._new_label = new_label
         self._add_style = (
-            add_style
-            if add_style is not None
-            else Style.from_color(Color.GREEN)
+            add_style if add_style is not None else theme().diff_add
         )
         self._del_style = (
-            del_style if del_style is not None else Style.from_color(Color.RED)
+            del_style if del_style is not None else theme().diff_delete
         )
         self._hunk_style = (
             hunk_style if hunk_style is not None else theme().secondary

{py_sparcli-0.4.0 → py_sparcli-0.5.0}/sparcli/output/progress.py

@@ -17,14 +17,17 @@ from __future__ import annotations
 import enum
 import math
 from dataclasses import dataclass
+from typing import TYPE_CHECKING
 
-from sparcli.core.color import Color
 from sparcli.core.inplace import InPlace
 from sparcli.core.render import Rendered
 from sparcli.core.style import Style
 from sparcli.core.text import Line, Span
 from sparcli.core.theme import theme
 
+if TYPE_CHECKING:
+    from sparcli.core.color import Color
+
 # Default bar width in columns.
 DEFAULT_WIDTH = 30
 
@@ -127,7 +130,7 @@ class ProgressOpts:
             left_cap="",
             right_cap="",
             fill_color=active.accent,
-            empty_color=Color.DARK_GRAY,
+            empty_color=active.progress_empty,
             thresholds=None,
             show_percent=True,
             show_value=False,

{py_sparcli-0.4.0 → py_sparcli-0.5.0}/sparcli/output/table/table.py

@@ -194,7 +194,7 @@ class TableOpts:
     header: bool = True
     header_style: Style = field(default_factory=Style)
     striped: bool = False
-    stripe_style: Style = field(default_factory=lambda: Style().dim())
+    stripe_style: Style = field(default_factory=lambda: theme().stripe)
     title: Text | None = None
     title_style: Style = field(default_factory=Style)
     pad: int = 1
@@ -261,7 +261,7 @@ class Table(Renderable):
             ),
             striped=striped,
             stripe_style=(
-                stripe_style if stripe_style is not None else Style().dim()
+                stripe_style if stripe_style is not None else active.stripe
             ),
             title=into_text(title) if title is not None else None,
             title_style=(

{py_sparcli-0.4.0 → py_sparcli-0.5.0}/tests/test_output_streams.py

@@ -1,5 +1,5 @@
 """
-Tests for the CLI output rules of section 1.6 of the style guide.
+Tests for the CLI output rules.
 
 Two rules are load-bearing for a program that pipes its output onward: payload
 goes to stdout while progress goes to stderr, and nothing is truncated when

py_sparcli-0.5.0/tests/test_theme_only_colours.py

@@ -0,0 +1,58 @@
+"""
+Every color comes from the theme.
+
+No color literal may appear in the package outside the files in ``ALLOWED``,
+each listed with its reason. Comments and docstrings are not scanned.
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+PACKAGE = Path(__file__).parent.parent / "sparcli"
+
+# Files that may hold color values, and why.
+ALLOWED: dict[str, str] = {
+    "core/color.py": "the color type, its names and the xterm palette",
+    "core/theme.py": "the built-in theme",
+}
+
+# A named color constant, an RGB literal or a quoted `#rgb`/`#rrggbb` string.
+LITERAL = re.compile(
+    r"Color\.(BLACK|RED|GREEN|YELLOW|BLUE|MAGENTA|CYAN|GRAY|DARK_GRAY|WHITE"
+    r"|LIGHT_[A-Z]+)\b"
+    r"|Color\.rgb\(\s*\d"
+    r"|[\"']#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})[\"']"
+)
+
+TRIPLE_QUOTES = ('"""', "'''")
+
+
+def test_colors_come_only_from_the_theme() -> None:
+    found = [
+        f"{path.relative_to(PACKAGE)}:{number}: {line.strip()}"
+        for path in sorted(PACKAGE.rglob("*.py"))
+        if path.relative_to(PACKAGE).as_posix() not in ALLOWED
+        for number, line in code_lines(path)
+        if LITERAL.search(line)
+    ]
+    assert not found, "color literals outside the theme:\n" + "\n".join(found)
+
+
+def code_lines(path: Path) -> list[tuple[int, str]]:
+    """Returns the numbered lines of `path` outside comments and docstrings."""
+    lines: list[tuple[int, str]] = []
+    in_docstring = False
+    for number, line in enumerate(path.read_text().splitlines(), start=1):
+        stripped = line.strip()
+        quotes = sum(stripped.count(mark) for mark in TRIPLE_QUOTES)
+        if in_docstring or stripped.startswith(TRIPLE_QUOTES):
+            # An odd count opens or closes a docstring spanning lines.
+            if quotes % 2 == 1:
+                in_docstring = not in_docstring
+            continue
+        if stripped.startswith("#"):
+            continue
+        lines.append((number, line))
+    return lines

py_sparcli-0.5.0/tests/test_theme_styles.py

@@ -0,0 +1,89 @@
+"""The widget styles that come from the theme, and the ``ansi:`` tokens."""
+
+from __future__ import annotations
+
+from sparcli.core.border import BorderType
+from sparcli.core.color import Color
+from sparcli.core.markup import parse
+from sparcli.core.style import Style
+from sparcli.core.theme import Theme, set_theme
+from sparcli.input.confirm import Confirm
+from sparcli.output.diff import Diff
+from sparcli.output.progress import ProgressOpts
+from sparcli.output.table.table import Table
+
+
+class TestThemeDefaults:
+    def test_the_new_fields_keep_the_previous_look(self) -> None:
+        defaults = Theme()
+        assert defaults.diff_add == Style.from_color(Color.GREEN)
+        assert defaults.diff_delete == Style.from_color(Color.RED)
+        assert defaults.progress_empty == Color.DARK_GRAY
+        assert defaults.code == Style.from_color(Color.CYAN)
+        assert defaults.stripe == Style.new().dim()
+
+
+class TestWidgetsReadTheTheme:
+    def test_diff_lines_take_the_theme_styles(self) -> None:
+        set_theme(
+            Theme(
+                diff_add=Style.from_color(Color.BLUE),
+                diff_delete=Style.from_color(Color.MAGENTA),
+            )
+        )
+        rendered = Diff("a", "b").no_header().render(80)
+        colors = {
+            span.style.fg for line in rendered.lines for span in line.spans
+        }
+        assert Color.BLUE in colors
+        assert Color.MAGENTA in colors
+
+    def test_the_empty_progress_bar_takes_the_theme_color(self) -> None:
+        set_theme(Theme(progress_empty=Color.BLUE))
+        assert ProgressOpts.defaults().empty_color == Color.BLUE
+
+    def test_code_spans_take_the_theme_style(self) -> None:
+        set_theme(Theme(code=Style.from_color(Color.MAGENTA)))
+        spans = parse("`x`").lines[0].spans
+        assert any(span.style.fg == Color.MAGENTA for span in spans)
+
+    def test_table_stripes_take_the_theme_style(self) -> None:
+        set_theme(Theme(stripe=Style().with_bg(Color.BLUE)))
+        rendered = (
+            Table()
+            .striped(True)
+            .columns(["A"])
+            .row(["1"])
+            .row(["2"])
+            .border(BorderType.SINGLE)
+            .render(80)
+        )
+        second_body = rendered.lines[4]
+        assert any(span.style.bg == Color.BLUE for span in second_body.spans)
+
+    def test_the_unselected_confirm_button_takes_the_hint_style(self) -> None:
+        set_theme(Theme(hint=Style.from_color(Color.BLUE)))
+        lines = Confirm("Go?").frame().lines
+        spans = [span for line in lines for span in line.spans]
+        assert any(
+            span.content.strip() == "Yes" and span.style.fg == Color.BLUE
+            for span in spans
+        )
+
+
+class TestAnsiTokens:
+    def test_every_terminal_color_has_a_token(self) -> None:
+        names = [
+            "black", "red", "green", "yellow", "blue", "magenta", "cyan",
+            "gray", "dark_gray", "light_red", "light_green", "light_yellow",
+            "light_blue", "light_magenta", "light_cyan", "white",
+        ]
+        for name in names:
+            assert Color.from_name(f"ansi:{name}") is not None, name
+
+    def test_white_is_the_bright_white_and_grey_is_accepted(self) -> None:
+        assert Color.from_name("ansi:white") == Color.WHITE
+        assert Color.from_name("ANSI:Dark_Grey") == Color.DARK_GRAY
+
+    def test_an_unknown_token_is_none(self) -> None:
+        assert Color.from_name("ansi:orange") is None

{py_sparcli-0.4.0 → py_sparcli-0.5.0}/uv.lock

@@ -513,7 +513,7 @@ wheels = [
 
 [[package]]
 name = "py-sparcli"
-version = "0.4.0"
+version = "0.5.0"
 source = { editable = "." }
 
 [package.dev-dependencies]