lib-cli-exit-tools 1.0.2__tar.gz → 1.0.3__tar.gz

{lib_cli_exit_tools-1.0.2 → lib_cli_exit_tools-1.0.3}/CHANGELOG.md

@@ -1,12 +1,16 @@
 # Changelog
 
+## [1.0.3] - 2025-09-16
+
+- added make menu
+
 ## [1.0.2] - 2025-09-15
 
-- _Describe changes here._
+- minor internals
 
 ## [1.0.1] - 2025-09-15
 
-- _Describe changes here._
+- minor internals 
 
 ## [1.0.0] - 2025-09-15
 
@@ -16,7 +20,7 @@
 
 ### Added
 - CI job to execute Jupyter notebook on Python 3.10 (installs ipykernel, normalizes notebook IDs) and a tag‑time packaging‑consistency check.
-- Packaging auto‑sync: `make test`, `make push`, and the bump script now align Conda/Brew/Nix files to `pyproject.toml` version, `requires-python`, and runtime deps. Homebrew resources are updated (URL + sha256) using PyPI metadata. A sync‑only mode is available via `python tools/bump_version.py --sync-packaging`.
+- Packaging auto‑sync: `make test`, `make push`, and the bump script now align Conda/Brew/Nix files to `pyproject.toml` version, `requires-python`, and runtime deps. Homebrew resources are updated (URL + sha256) using PyPI metadata. A sync‑only mode is available via `python scripts/bump_version.py --sync-packaging`.
 - Tests covering SystemExit variants, tolerant output printing, English CLI messages, and Windows mapping via monkeypatched `os.name`.
 
 ### Changed

{lib_cli_exit_tools-1.0.2 → lib_cli_exit_tools-1.0.3}/CONTRIBUTING.md

@@ -28,7 +28,7 @@ Thanks for helping improve lib_cli_exit_tools! This guide keeps changes small, s
     - Homebrew: ensures a `resource "<dep>"` for each dep; if pinned, uses that version; otherwise pins to the latest PyPI release, updating `url` + `sha256`.
     - Nix: updates the package version, `pkgs.pythonXYZPackages`/`pkgs.pythonXYZ` to match the min Python, and `propagatedBuildInputs` to include all deps as `pypkgs.<name>`.
 - Network note: Homebrew resource updates fetch PyPI metadata; if offline, those updates may be skipped.
-- If packaging drifts, run: `python tools/bump_version.py --sync-packaging`.
+- If packaging drifts, run: `python scripts/bump_version.py --sync-packaging`.
 - CI enforces consistency on tags via a `packaging-consistency` job.
 
 ## 5) Tests & Style

{lib_cli_exit_tools-1.0.2 → lib_cli_exit_tools-1.0.3}/Makefile

@@ -1,6 +1,5 @@
 SHELL := /bin/bash
 .ONESHELL:
-
 # Config
 PY ?= python3
 PIP ?= pip
@@ -18,7 +17,7 @@ FAIL_UNDER ?= 80
 # - off  : never run coverage
 COVERAGE ?= on
 
-.PHONY: help install dev test run clean build push release version-current bump bump-patch bump-minor bump-major menu menu-cli menu-tui _bootstrap-dev
+.PHONY: help install dev test run clean build push release version-current bump bump-patch bump-minor bump-major menu _bootstrap-dev
 
 help: ## Show help
 	@grep -E '^[a-zA-Z_-]+:.*?## ' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'
@@ -95,11 +94,5 @@ build: ## Build wheel/sdist and attempt conda, brew, and nix builds (auto-instal
 release: ## Create and push tag vX.Y.Z from pyproject, create GitHub release (if gh present), then sync packaging
 	$(PY) scripts/release.py --remote=$(REMOTE)
 
-menu: ## Interactive menu (CLI prompts by default)
-	$(PY) -u scripts/menu_cli.py < /dev/tty > /dev/tty 2>&1
-
-menu-cli: ## Force simple CLI prompt menu (no TUI)
-	$(PY) -u scripts/menu_cli.py < /dev/tty > /dev/tty 2>&1
-
-menu-tui: ## Force Textual TUI menu (may not work on limited terminals)
-	$(PY) -u scripts/menu_tui.py < /dev/tty > /dev/tty 2>&1
+menu: ## Interactive TUI menu
+	$(PY) -u scripts/menu.py < /dev/tty > /dev/tty 2>&1

{lib_cli_exit_tools-1.0.2 → lib_cli_exit_tools-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lib_cli_exit_tools
-Version: 1.0.2
+Version: 1.0.3
 Summary: CLI exit handling helpers: clean signals, exit codes, and error printing
 Project-URL: Homepage, https://github.com/bitranox/lib_cli_exit_tools
 Project-URL: Repository, https://github.com/bitranox/lib_cli_exit_tools.git
@@ -144,8 +144,6 @@ pip install .
 | `push`            | Commit all changes once and push to GitHub (no CI monitoring)                              |
 | `build`           | Build wheel/sdist and attempt conda, brew, and nix builds (auto-installs tools if missing) |
 | `menu`            | Interactive TUI to run targets and edit parameters (requires dev dep: textual)             |
-| `menu-cli`        | Force simple prompt menu (no TUI)                                                          |
-| `menu-tui`        | Force Textual TUI (may not work in limited terminals)                                      |
 
 #### Target Parameters (env vars)
 
@@ -162,6 +160,7 @@ pip install .
 - `test`
   - `COVERAGE=on|auto|off` (default: `on`) — controls pytest coverage run and Codecov upload
   - `SKIP_BOOTSTRAP=1` — skip auto-install of dev tools if missing
+  - `TEST_VERBOSE=1` — echo each command executed by the test harness
   - Also respects `CODECOV_TOKEN` when needed for uploads
 
 - `run`
@@ -195,7 +194,7 @@ pip install .
 
 ### Interactive Menu (Textual)
 
-`make menu` launches a colorful terminal UI (powered by `textual`) to browse targets, edit parameters, and run them with live output. If the terminal doesn’t support a full TUI or `textual` can’t load, it falls back to a simple prompt menu.
+`make menu` launches a colorful terminal UI (powered by `textual`) to browse targets, edit parameters, and run them with live output.
 
 Install dev extras if you haven’t:
 
@@ -207,8 +206,6 @@ Run the menu:
 
 ```bash
 make menu
-make menu-cli   # always use simple prompt menu
-make menu-tui   # force TUI (if your terminal supports it)
 ```
 
 #### Target Details
@@ -288,7 +285,7 @@ COVERAGE=on make test        # force coverage and generate coverage.xml/codecov.
   - Homebrew: updates the source URL tag to `vX.Y.Z` and sets `depends_on "python@X.Y"` to match `requires-python`.
   - Nix: updates the package `version`, example `rev = "vX.Y.Z"`, and switches `pkgs.pythonXYZPackages` / `pkgs.pythonXYZ` to match the minimum Python version from `requires-python`.
 
-- To run just the sync without bumping versions: `python tools/bump_version.py --sync-packaging`.
+- To run just the sync without bumping versions: `python scripts/bump_version.py --sync-packaging`.
 
 - On release tags (`v*.*.*`), CI validates that packaging files are consistent with `pyproject.toml` and will fail if they drift.
 

{lib_cli_exit_tools-1.0.2 → lib_cli_exit_tools-1.0.3}/README.md

@@ -114,8 +114,6 @@ pip install .
 | `push`            | Commit all changes once and push to GitHub (no CI monitoring)                              |
 | `build`           | Build wheel/sdist and attempt conda, brew, and nix builds (auto-installs tools if missing) |
 | `menu`            | Interactive TUI to run targets and edit parameters (requires dev dep: textual)             |
-| `menu-cli`        | Force simple prompt menu (no TUI)                                                          |
-| `menu-tui`        | Force Textual TUI (may not work in limited terminals)                                      |
 
 #### Target Parameters (env vars)
 
@@ -132,6 +130,7 @@ pip install .
 - `test`
   - `COVERAGE=on|auto|off` (default: `on`) — controls pytest coverage run and Codecov upload
   - `SKIP_BOOTSTRAP=1` — skip auto-install of dev tools if missing
+  - `TEST_VERBOSE=1` — echo each command executed by the test harness
   - Also respects `CODECOV_TOKEN` when needed for uploads
 
 - `run`
@@ -165,7 +164,7 @@ pip install .
 
 ### Interactive Menu (Textual)
 
-`make menu` launches a colorful terminal UI (powered by `textual`) to browse targets, edit parameters, and run them with live output. If the terminal doesn’t support a full TUI or `textual` can’t load, it falls back to a simple prompt menu.
+`make menu` launches a colorful terminal UI (powered by `textual`) to browse targets, edit parameters, and run them with live output.
 
 Install dev extras if you haven’t:
 
@@ -177,8 +176,6 @@ Run the menu:
 
 ```bash
 make menu
-make menu-cli   # always use simple prompt menu
-make menu-tui   # force TUI (if your terminal supports it)
 ```
 
 #### Target Details
@@ -258,7 +255,7 @@ COVERAGE=on make test        # force coverage and generate coverage.xml/codecov.
   - Homebrew: updates the source URL tag to `vX.Y.Z` and sets `depends_on "python@X.Y"` to match `requires-python`.
   - Nix: updates the package `version`, example `rev = "vX.Y.Z"`, and switches `pkgs.pythonXYZPackages` / `pkgs.pythonXYZ` to match the minimum Python version from `requires-python`.
 
-- To run just the sync without bumping versions: `python tools/bump_version.py --sync-packaging`.
+- To run just the sync without bumping versions: `python scripts/bump_version.py --sync-packaging`.
 
 - On release tags (`v*.*.*`), CI validates that packaging files are consistent with `pyproject.toml` and will fail if they drift.
 

{lib_cli_exit_tools-1.0.2 → lib_cli_exit_tools-1.0.3}/codecov.yml

@@ -20,9 +20,9 @@ ignore:
   - "tests/**"
   - "packaging/**"
   - "**/__init__conf__.py"
+  - "scripts/**"
 
 comment:
   layout: "reach, diff, flags, files"
   behavior: default
   require_changes: false
-

{lib_cli_exit_tools-1.0.2 → lib_cli_exit_tools-1.0.3}/packaging/README.md

@@ -9,13 +9,13 @@ This directory contains packaging files and an automated sync flow so they stay
   - Or semantic part: `make bump PART=patch|minor|major`
 - To only synchronize packaging to the current `pyproject.toml` without changing versions:
   ```bash
-  python3 tools/bump_version.py --sync-packaging
+  python3 scripts/bump_version.py --sync-packaging
   ```
 - `make test` runs the same sync step up-front to keep packaging up to date.
 
 ## What auto-sync updates
 
-The script `tools/bump_version.py` updates the following when network access is available:
+The script `scripts/bump_version.py` updates the following when network access is available:
 
 1) Conda recipe (`packaging/conda/recipe/meta.yaml`)
    - Sets Jinja version to the current `pyproject.toml` version.

{lib_cli_exit_tools-1.0.2 → lib_cli_exit_tools-1.0.3}/packaging/brew/Formula/lib-cli-exit-tools.rb

@@ -3,7 +3,7 @@ class LibCliExitTools < Formula
 
   desc "CLI exit handling helpers: clean signals, exit codes, and error printing"
   homepage "https://github.com/bitranox/lib_cli_exit_tools"
-  url "https://github.com/bitranox/lib_cli_exit_tools/archive/refs/tags/v1.0.2.tar.gz"
+  url "https://github.com/bitranox/lib_cli_exit_tools/archive/refs/tags/v1.0.3.tar.gz"
 k3cc316e7d0b09dd79e617cb3e91b14ee414b7e6695b108a326d9d3ccd08dd9"
   license "MIT"
 

{lib_cli_exit_tools-1.0.2 → lib_cli_exit_tools-1.0.3}/packaging/conda/recipe/meta.yaml

@@ -1,5 +1,5 @@
 {% set name = "lib_cli_exit_tools" %}
-{% set version = "1.0.2" %}
+{% set version = "1.0.3" %}
 
 package:
   name: {{ name|lower }}

{lib_cli_exit_tools-1.0.2 → lib_cli_exit_tools-1.0.3}/packaging/nix/flake.nix

@@ -35,7 +35,7 @@
       {
         packages.default = pypkgs.buildPythonPackage {
           pname = "lib_cli_exit_tools";
-          version = "1.0.2";
+          version = "1.0.3";
           pyproject = true;
           # Build from the repository root (two levels up from packaging/nix)
           src = ../..;
@@ -43,7 +43,7 @@
           # src = pkgs.fetchFromGitHub {
           #   owner = "bitranox";
           #   repo = "lib_cli_exit_tools";
-          #   rev = "v1.0.2";
+          #   rev = "v1.0.3";
           #   sha256 = "<fill-me>";
           # };
 

{lib_cli_exit_tools-1.0.2 → lib_cli_exit_tools-1.0.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lib_cli_exit_tools"
-version = "1.0.2"
+version = "1.0.3"
 description = "CLI exit handling helpers: clean signals, exit codes, and error printing"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -62,7 +62,6 @@ target-version = "py313"
 typeCheckingMode = "strict"
 exclude = [
   "scripts/menu.py",
-  "docs",
 ]
 
 [tool.pytest.ini_options]

lib_cli_exit_tools-1.0.3/qlty.toml

@@ -0,0 +1,2 @@
+[analysis]
+ignore = ["scripts/"]

{lib_cli_exit_tools-1.0.2 → lib_cli_exit_tools-1.0.3}/scripts/_utils.py

@@ -49,7 +49,7 @@ def cmd_exists(name: str) -> bool:
 
 def read_version_from_pyproject(pyproject: Path = Path("pyproject.toml")) -> str:
     try:
-        import tomllib  # pyright: ignore[reportMissingImports]
+        import tomllib  # pyright: ignore[reportMissingImports, reportMissingTypeStubs]
 
         data = tomllib.loads(pyproject.read_text(encoding="utf-8"))
         version = str(data.get("project", {}).get("version", ""))
@@ -108,7 +108,7 @@ def gh_release_edit(tag: str, title: str, body: str) -> None:
 
 
 def sync_packaging() -> None:
-    run([sys.executable, "tools/bump_version.py", "--sync-packaging"], check=False)
+    run([sys.executable, "scripts/bump_version.py", "--sync-packaging"], check=False)
 
 
 def bootstrap_dev() -> None:

{lib_cli_exit_tools-1.0.2 → lib_cli_exit_tools-1.0.3}/scripts/bump.py

@@ -14,7 +14,7 @@ from scripts._utils import run  # noqa: E402
 @click.option("--pyproject", type=click.Path(path_type=Path), default=Path("pyproject.toml"))
 @click.option("--changelog", type=click.Path(path_type=Path), default=Path("CHANGELOG.md"))
 def main(version_: str | None, part: str | None, pyproject: Path, changelog: Path) -> None:
-    args = [sys.executable, "tools/bump_version.py"]
+    args = [sys.executable, "scripts/bump_version.py"]
     if version_:
         args += ["--version", version_]
     else:

{lib_cli_exit_tools-1.0.2/tools → lib_cli_exit_tools-1.0.3/scripts}/bump_version.py

@@ -11,7 +11,7 @@ import hashlib
 
 # Optional TOML parser for Python < 3.11 support during type checking
 try:  # pragma: no cover - import resolution
-    import tomllib as _tomllib  # type: ignore[attr-defined]
+    import tomllib as _tomllib  # type: ignore
 except Exception:  # pragma: no cover - best-effort fallback
     try:
         import tomli as _tomllib  # type: ignore

lib_cli_exit_tools-1.0.2/scripts/menu_tui.py → lib_cli_exit_tools-1.0.3/scripts/menu.py

@@ -4,13 +4,13 @@ import asyncio
 import os
 import signal
 from dataclasses import dataclass
-from typing import Callable, Dict, Optional
+from typing import TYPE_CHECKING, Callable, Dict, Optional
 
 import contextlib
 
 from rich.text import Text
 
-try:
+if TYPE_CHECKING:
     from textual import events
     from textual.app import App, ComposeResult
     from textual.containers import Container, Horizontal, Vertical
@@ -27,13 +27,31 @@ try:
         Select,
         Static,
     )
-except Exception as exc:  # pragma: no cover - textual import errors surface clearly
-    import sys
-    import traceback
+else:  # pragma: no cover
+    try:
+        from textual import events
+        from textual.app import App, ComposeResult
+        from textual.containers import Container, Horizontal, Vertical
+        from textual.reactive import reactive
+        from textual.screen import Screen
+        from textual.widgets import (
+            Button,
+            Footer,
+            Input,
+            Label,
+            ListItem,
+            ListView,
+            RichLog,
+            Select,
+            Static,
+        )
+    except Exception as exc:  # pragma: no cover - textual import errors surface clearly
+        import sys
+        import traceback
 
-    print("[menu-tui] Failed to import Textual components:", file=sys.stderr)
-    traceback.print_exc()
-    raise SystemExit("textual is not installed or incompatible in this environment. Install dev extras: pip install -e .[dev]") from exc
+        print("[menu-tui] Failed to import Textual components:", file=sys.stderr)
+        traceback.print_exc()
+        raise SystemExit("textual is not installed or incompatible in this environment. Install dev extras: pip install -e .[dev]") from exc
 
 
 @dataclass(slots=True)
@@ -84,6 +102,12 @@ def _build_targets() -> list[Target]:
                     default=_env_default("SKIP_BOOTSTRAP", "0"),
                     choices=["0", "1"],
                 ),
+                Param(
+                    "TEST_VERBOSE",
+                    "Verbose test runner output (1=yes, 0=no)",
+                    default=_env_default("TEST_VERBOSE", "0"),
+                    choices=["0", "1"],
+                ),
             ],
         ),
         Target("run", "Run CLI (shows --help)", []),
@@ -327,7 +351,7 @@ class ParamScreen(Screen[Dict[str, str] | None]):
         self._preset = preset
         self._inputs: Dict[str, Input | Select[str]] = {}
         self._error: Static | None = None
-        self._buttons: list[Button] = []
+        self._ok_button: Button | None = None
 
     def compose(self) -> ComposeResult:  # type: ignore[override]
         with Container(id="backdrop"):
@@ -354,38 +378,16 @@ class ParamScreen(Screen[Dict[str, str] | None]):
                     yield widget
                 with Horizontal(id="buttons"):
                     ok_btn = Button("OK", id="ok-btn")
-                    cancel_btn = Button("Cancel", id="cancel-btn")
-                    self._buttons = [ok_btn, cancel_btn]
+                    self._ok_button = ok_btn
                     yield ok_btn
-                    yield cancel_btn
         yield Footer()
 
     def on_mount(self) -> None:  # type: ignore[override]
-        self._focus_first_input()
+        self._focus_ok_button()
 
     def on_button_pressed(self, event: Button.Pressed) -> None:  # type: ignore[override]
         if event.button.id == "ok-btn":
             self._submit()
-        elif event.button.id == "cancel-btn":
-            self.action_cancel()
-
-    def on_key(self, event: events.Key) -> None:  # type: ignore[override]
-        if event.key not in {"left", "right"}:
-            return
-        focused = self.focused
-        if not isinstance(focused, Button):
-            return
-        try:
-            current = self._buttons.index(focused)
-        except ValueError:
-            return
-        if event.key == "left":
-            next_index = max(current - 1, 0)
-        else:
-            next_index = min(current + 1, len(self._buttons) - 1)
-        if next_index != current:
-            self._buttons[next_index].focus()
-            event.stop()
 
     def on_input_submitted(self, event: Input.Submitted) -> None:  # type: ignore[override]
         if event.input.id and event.input.id.startswith("input-"):
@@ -399,6 +401,10 @@ class ParamScreen(Screen[Dict[str, str] | None]):
             widget.focus()
             return
 
+    def _focus_ok_button(self) -> None:
+        if self._ok_button is not None:
+            self._ok_button.focus()
+
     def _submit(self) -> None:
         values, error = self._gather_values()
         if error:
@@ -450,8 +456,6 @@ class RunScreen(Screen[Optional[int]]):
         self._log = RichLog(highlight=True, markup=True, id="log")
         self._status = Static("", id="status")
         self._ok_button = Button("OK", id="ok-btn", disabled=True)
-        self._cancel_button = Button("Cancel", id="cancel-btn")
-        self._buttons: list[Button] = [self._ok_button, self._cancel_button]
         self._proc: asyncio.subprocess.Process | None = None
         self._runner: asyncio.Task[None] | None = None
         self._exit_code: Optional[int] = None
@@ -467,12 +471,11 @@ class RunScreen(Screen[Optional[int]]):
                 yield self._status
                 with Horizontal(id="buttons"):
                     yield self._ok_button
-                    yield self._cancel_button
         yield Footer()
 
     async def on_mount(self) -> None:  # type: ignore[override]
-        self._status.update("Running… Press Cancel to stop.")
-        self._cancel_button.focus()
+        self._status.update("Running… Press Esc to cancel.")
+        self._ok_button.focus()
         self._runner = asyncio.create_task(self._run_process())
 
     async def on_unmount(self) -> None:  # type: ignore[override]
@@ -484,26 +487,6 @@ class RunScreen(Screen[Optional[int]]):
     def on_button_pressed(self, event: Button.Pressed) -> None:  # type: ignore[override]
         if event.button.id == "ok-btn":
             self.dismiss(self._exit_code)
-        elif event.button.id == "cancel-btn":
-            self.action_cancel()
-
-    def on_key(self, event: events.Key) -> None:  # type: ignore[override]
-        if event.key not in {"left", "right"}:
-            return
-        focused = self.focused
-        if not isinstance(focused, Button):
-            return
-        try:
-            current = self._buttons.index(focused)
-        except ValueError:
-            return
-        if event.key == "left":
-            next_index = max(current - 1, 0)
-        else:
-            next_index = min(current + 1, len(self._buttons) - 1)
-        if next_index != current:
-            self._buttons[next_index].focus()
-            event.stop()
 
     def action_cancel(self) -> None:
         if self._proc and self._proc.returncode is None:

{lib_cli_exit_tools-1.0.2 → lib_cli_exit_tools-1.0.3}/scripts/test.py

@@ -13,23 +13,38 @@ from scripts._utils import bootstrap_dev, cmd_exists, run, sync_packaging  # noq
 
 @click.command(help="Run lints, type-check, tests with coverage, and Codecov upload if configured")
 @click.option("--coverage", type=click.Choice(["on", "auto", "off"]), default="on")
-def main(coverage: str) -> None:
+@click.option("--verbose", "-v", is_flag=True, help="Print executed commands before running them")
+def main(coverage: str, verbose: bool) -> None:
+    env_verbose = os.getenv("TEST_VERBOSE", "").lower()
+    if not verbose and env_verbose in {"1", "true", "yes", "on"}:
+        verbose = True
+
+    def _run(cmd: list[str] | str, *, env: dict[str, str] | None = None, check: bool = True) -> None:
+        display = cmd if isinstance(cmd, str) else " ".join(cmd)
+        if verbose:
+            click.echo(f"  $ {display}")
+            if env:
+                overrides = {k: v for k, v in env.items() if os.environ.get(k) != v}
+                if overrides:
+                    env_view = " ".join(f"{k}={v}" for k, v in overrides.items())
+                    click.echo(f"    env {env_view}")
+        run(cmd, env=env, check=check)  # type: ignore[arg-type]
+
     bootstrap_dev()
 
     click.echo("[0/4] Sync packaging (conda/brew/nix) with pyproject")
     sync_packaging()
 
     click.echo("[1/4] Ruff lint")
-    run(["ruff", "check", "."])  # type: ignore[list-item]
+    _run(["ruff", "check", "."], check=False)  # type: ignore[list-item]
 
     click.echo("[2/4] Ruff format (apply)")
-    run(["ruff", "format", "."])  # type: ignore[list-item]
+    _run(["ruff", "format", "."], check=False)  # type: ignore[list-item]
 
     click.echo("[3/4] Pyright type-check")
-    run(["pyright"])  # type: ignore[list-item]
+    _run(["pyright"], check=False)  # type: ignore[list-item]
 
     click.echo("[4/4] Pytest with coverage")
-    # remove old coverage
     for f in (".coverage", "coverage.xml"):
         try:
             Path(f).unlink()
@@ -42,7 +57,7 @@ def main(coverage: str) -> None:
             cov_file = Path(tmp) / ".coverage"
             click.echo(f"[coverage] file={cov_file}")
             env = os.environ | {"COVERAGE_FILE": str(cov_file)}
-            run(
+            _run(
                 [
                     "python",
                     "-m",
@@ -57,17 +72,15 @@ def main(coverage: str) -> None:
             )
     else:
         click.echo("[coverage] disabled (set --coverage=on to force)")
-        run(["python", "-m", "pytest", "-q"])  # type: ignore[list-item]
+        _run(["python", "-m", "pytest", "-q"])  # type: ignore[list-item]
 
-    # Upload coverage to Codecov if present
     if Path("coverage.xml").exists():
         click.echo("Uploading coverage to Codecov")
         if cmd_exists("codecov"):
             version = run(["python", "-c", "import platform; print(platform.python_version())"]).out.strip()
-            run(["codecov", "-f", "coverage.xml", "-F", "local", "-n", f"local-$(uname)-{version}"], check=False)
+            _run(["codecov", "-f", "coverage.xml", "-F", "local", "-n", f"local-$(uname)-{version}"], check=False)
         else:
-            # fallback bash uploader
-            run(
+            _run(
                 [
                     "bash",
                     "-lc",

lib_cli_exit_tools-1.0.2/docs/textual/README.md

@@ -1,109 +0,0 @@
- (for this repo)
-
-makThis is a pragmatic quick‑reference for building and debugging Textual UIs that match the versions we use here (Textual ≥ 6.x). It focuses on patterns we implemented in `scripts/menu_tui.py` (ListView + RichLog + async subprocess + Cancel).
-
-## Install
-
-- Dev extras (recommended):
-  - `pip install -e .[dev]`
-- Or just Textual: `pip install textual`
-- Verify: `python -c "import textual,sys; print(sys.version, textual.__version__)"`
-
-## App + compose
-
-```python
-from textual.app import App, ComposeResult
-from textual.widgets import Header, Footer, Static
-
-class Hello(App):
-    def compose(self) -> ComposeResult:
-        yield Header()
-        yield Static("Hello Textual")
-        yield Footer()
-
-if __name__ == "__main__":
-    Hello().run()
-```
-
-## Mounting: schedule vs await
-
-- `self.mount(widget)` schedules. If you need to update/query the widget immediately, `await self.mount(widget)` inside an async handler (e.g. `async def on_mount(...)`).
-
-```python
-# See snippets/mount_await.py
-```
-
-## ListView (compose safely)
-
-Create items inside `compose` or after mount. For initial items:
-
-```python
-from textual.widgets import ListView, ListItem, Label
-
-yield ListView(
-    ListItem(Label("Item 1")),
-    ListItem(Label("Item 2")),
-    id="targets",
-)
-```
-
-Adding later (after mount):
-
-```python
-lv = self.query_one("#targets", ListView)
-await lv.append(ListItem(Label("New Item")))   # or lv.append(...) if in compose tick
-```
-
-## RichLog (Textual 6.x)
-
-- Use `RichLog` (not `TextLog`).
-- Append with `write()`.
-
-```python
-from textual.widgets import RichLog
-log = RichLog(highlight=True)
-log.write("Starting…")
-```
-
-## Async subprocess + live streaming
-
-```python
-# See snippets/richlog_stream.py
-# gist: create_subprocess_exec + read stdout/stderr per line → log.write()
-```
-
-POSIX Cancel: `proc.send_signal(signal.SIGINT)`; Windows: `proc.terminate()`.
-
-## Actions & key bindings
-
-Bind keys to actions:
-
-```python
-# See snippets/actions_bindings.py
-```
-
-## CSS basics (inline)
-
-```python
-CSS = """
-Screen { layout: horizontal; }
-#right { width: 1fr; }
-RichLog { border: tall $accent; }
-"""
-```
-
-## Run the examples
-
-```bash
-python docs/textual/snippets/listview_basic.py
-python docs/textual/snippets/richlog_stream.py
-python docs/textual/snippets/mount_await.py
-python docs/textual/snippets/actions_bindings.py
-```
-
-## Troubleshooting
-
-- Nothing shows under `make`: ensure stdin/stdout is a TTY. We wire `/dev/tty` in Make.
-- Textual import errors: check version (`textual.__version__`), install `pip install -e .[dev]`.
-- MountError on ListView: don’t append before the ListView is mounted; yield items in `compose` or `await mount()` first.
-