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

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

@@ -1,5 +1,9 @@
 # Changelog
 
+## [1.0.2] - 2025-09-15
+
+- _Describe changes here._
+
 ## [1.0.1] - 2025-09-15
 
 - _Describe changes here._

lib_cli_exit_tools-1.0.2/Makefile

@@ -0,0 +1,105 @@
+SHELL := /bin/bash
+.ONESHELL:
+
+# Config
+PY ?= python3
+PIP ?= pip
+PKG ?= lib_cli_exit_tools
+GIT_REF ?= v0.1.0
+REMOTE ?= origin
+NIX_FLAKE ?= packaging/nix
+HATCHLING_VERSION ?= 1.25.0
+BREW_FORMULA ?= packaging/brew/Formula/lib-cli-exit-tools.rb
+CONDA_RECIPE ?= packaging/conda/recipe
+FAIL_UNDER ?= 80
+# Coverage mode: on|auto|off (default: on locally)
+# - on   : always run coverage
+# - auto : enable on CI or when CODECOV_TOKEN is set
+# - 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
+
+help: ## Show help
+	@grep -E '^[a-zA-Z_-]+:.*?## ' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'
+
+install: ## Install package editable
+	$(PY) scripts/install.py
+
+dev: ## Install package with dev extras
+	$(PY) scripts/dev.py
+
+_bootstrap-dev:
+	@if [ "$(SKIP_BOOTSTRAP)" = "1" ]; then \
+	  echo "[bootstrap] Skipping dev dependency bootstrap (SKIP_BOOTSTRAP=1)"; \
+	else \
+	  if ! command -v ruff >/dev/null 2>&1 || ! command -v pyright >/dev/null 2>&1 || ! python -c "import pytest" >/dev/null 2>&1; then \
+	    echo "[bootstrap] Installing dev dependencies via '$(PIP) install -e .[dev]'"; \
+	    $(PIP) install -e .[dev]; \
+	  else \
+	    echo "[bootstrap] Dev tools present"; \
+	  fi; \
+	  if ! python -c "import sqlite3" >/dev/null 2>&1; then \
+	    echo "[bootstrap] sqlite3 stdlib module not available; installing pysqlite3-binary"; \
+	    $(PIP) install pysqlite3-binary || true; \
+	  fi; \
+	fi
+
+test: _bootstrap-dev ## Lint, type-check, run tests with coverage, upload to Codecov
+	$(PY) scripts/test.py --coverage=$(COVERAGE)
+
+run: ## Run module CLI (requires dev install or src on PYTHONPATH)
+	$(PY) scripts/run_cli.py -- --help || true
+
+version-current: ## Print current version from pyproject.toml
+	$(PY) scripts/version_current.py
+
+bump: ## Bump version: VERSION=X.Y.Z or PART=major|minor|patch (default: patch); updates pyproject.toml and CHANGELOG.md
+	@set -e; \
+	if [ -n "$(VERSION)" ]; then \
+	  $(PY) scripts/bump.py --version "$(VERSION)"; \
+	else \
+	  $(PY) scripts/bump.py --part "$(PART)"; \
+	fi
+
+bump-patch: ## Bump patch version (X.Y.Z -> X.Y.(Z+1))
+	$(PY) scripts/bump_patch.py
+
+bump-minor: ## Bump minor version (X.Y.Z -> X.(Y+1).0)
+	$(PY) scripts/bump_minor.py
+
+bump-major: ## Bump major version ((X+1).0.0)
+	$(PY) scripts/bump_major.py
+
+clean: ## Remove caches, build artifacts, and coverage
+	rm -rf \
+	  .pytest_cache \
+	  .ruff_cache \
+	  .pyright \
+	  .mypy_cache \
+	  .tox .nox \
+	  .eggs *.egg-info \
+	  build dist \
+	  htmlcov .coverage coverage.xml \
+	  codecov.sh \
+	  .cache \
+	  result
+
+push: ## Commit all changes once and push to GitHub (no CI monitoring)
+	$(PY) scripts/push.py --remote=$(REMOTE)
+
+build: ## Build wheel/sdist and attempt conda, brew, and nix builds (auto-installs tools if missing)
+	$(PY) scripts/build.py
+
+
+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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lib_cli_exit_tools
-Version: 1.0.1
+Version: 1.0.2
 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
@@ -24,6 +24,7 @@ Requires-Dist: pyright>=1.1; extra == 'dev'
 Requires-Dist: pytest-cov>=5.0; extra == 'dev'
 Requires-Dist: pytest>=8.2; extra == 'dev'
 Requires-Dist: ruff>=0.5; extra == 'dev'
+Requires-Dist: textual>=0.50; extra == 'dev'
 Requires-Dist: twine>=5.1; extra == 'dev'
 Description-Content-Type: text/markdown
 
@@ -135,13 +136,80 @@ pip install .
 | `test`            | Lint, type-check, run tests with coverage, upload to Codecov                               |
 | `run`             | Run module CLI (requires dev install or src on PYTHONPATH)                                 |
 | `version-current` | Print current version from pyproject.toml                                                  |
-| `bump`            | Bump version: VERSION=X.Y.Z or PART=major                                                  |minor|patch (default: patch); updates pyproject.toml and CHANGELOG.md |
+| `bump`            | Bump version (updates pyproject.toml and CHANGELOG.md)                                     |
 | `bump-patch`      | Bump patch version (X.Y.Z -> X.Y.(Z+1))                                                    |
 | `bump-minor`      | Bump minor version (X.Y.Z -> X.(Y+1).0)                                                    |
 | `bump-major`      | Bump major version ((X+1).0.0)                                                             |
 | `clean`           | Remove caches, build artifacts, and coverage                                               |
 | `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)
+
+- Global
+  - `PY` (default: `python3`) — Python interpreter used to run scripts
+  - `PIP` (default: `pip`) — pip executable used by bootstrap/install
+
+- `install`
+  - No specific parameters (respects `PY`, `PIP`).
+
+- `dev`
+  - No specific parameters (respects `PY`, `PIP`).
+
+- `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
+  - Also respects `CODECOV_TOKEN` when needed for uploads
+
+- `run`
+  - No parameters via `make` (always shows `--help`). For custom args: `python scripts/run_cli.py -- <args>`.
+
+- `version-current`
+  - No parameters
+
+- `bump`
+  - `VERSION=X.Y.Z` — explicit target version
+  - `PART=major|minor|patch` — semantic part to bump (default if `VERSION` not set: `patch`)
+  - Examples:
+    - `make bump VERSION=1.0.2`
+    - `make bump PART=minor`
+
+- `bump-patch` / `bump-minor` / `bump-major`
+  - No parameters; shorthand for `make bump PART=...`
+
+- `clean`
+  - No parameters
+
+- `push`
+  - `REMOTE=<name>` (default: `origin`) — git remote to push to
+
+- `build`
+  - No parameters via `make`. Advanced: use the script directly, e.g. `python scripts/build.py --no-conda --no-nix`.
+
+- `release`
+  - `REMOTE=<name>` (default: `origin`) — git remote to push to
+  - Advanced (via script): `python scripts/release.py --retries 5 --retry-wait 3.0`
+
+### 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.
+
+Install dev extras if you haven’t:
+
+```bash
+pip install -e .[dev]
+```
+
+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
 

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

@@ -106,13 +106,80 @@ pip install .
 | `test`            | Lint, type-check, run tests with coverage, upload to Codecov                               |
 | `run`             | Run module CLI (requires dev install or src on PYTHONPATH)                                 |
 | `version-current` | Print current version from pyproject.toml                                                  |
-| `bump`            | Bump version: VERSION=X.Y.Z or PART=major                                                  |minor|patch (default: patch); updates pyproject.toml and CHANGELOG.md |
+| `bump`            | Bump version (updates pyproject.toml and CHANGELOG.md)                                     |
 | `bump-patch`      | Bump patch version (X.Y.Z -> X.Y.(Z+1))                                                    |
 | `bump-minor`      | Bump minor version (X.Y.Z -> X.(Y+1).0)                                                    |
 | `bump-major`      | Bump major version ((X+1).0.0)                                                             |
 | `clean`           | Remove caches, build artifacts, and coverage                                               |
 | `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)
+
+- Global
+  - `PY` (default: `python3`) — Python interpreter used to run scripts
+  - `PIP` (default: `pip`) — pip executable used by bootstrap/install
+
+- `install`
+  - No specific parameters (respects `PY`, `PIP`).
+
+- `dev`
+  - No specific parameters (respects `PY`, `PIP`).
+
+- `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
+  - Also respects `CODECOV_TOKEN` when needed for uploads
+
+- `run`
+  - No parameters via `make` (always shows `--help`). For custom args: `python scripts/run_cli.py -- <args>`.
+
+- `version-current`
+  - No parameters
+
+- `bump`
+  - `VERSION=X.Y.Z` — explicit target version
+  - `PART=major|minor|patch` — semantic part to bump (default if `VERSION` not set: `patch`)
+  - Examples:
+    - `make bump VERSION=1.0.2`
+    - `make bump PART=minor`
+
+- `bump-patch` / `bump-minor` / `bump-major`
+  - No parameters; shorthand for `make bump PART=...`
+
+- `clean`
+  - No parameters
+
+- `push`
+  - `REMOTE=<name>` (default: `origin`) — git remote to push to
+
+- `build`
+  - No parameters via `make`. Advanced: use the script directly, e.g. `python scripts/build.py --no-conda --no-nix`.
+
+- `release`
+  - `REMOTE=<name>` (default: `origin`) — git remote to push to
+  - Advanced (via script): `python scripts/release.py --retries 5 --retry-wait 3.0`
+
+### 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.
+
+Install dev extras if you haven’t:
+
+```bash
+pip install -e .[dev]
+```
+
+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
 

lib_cli_exit_tools-1.0.2/docs/textual/README.md

@@ -0,0 +1,109 @@
+ (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.
+

lib_cli_exit_tools-1.0.2/docs/textual/snippets/actions_bindings.py

@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+from textual.app import App, ComposeResult
+from textual.widgets import Header, Footer, Static
+
+
+class BindingApp(App):
+    BINDINGS = [
+        ("r", "set_bg('red')", "Red"),
+        ("g", "set_bg('green')", "Green"),
+        ("b", "set_bg('blue')", "Blue"),
+    ]
+
+    def compose(self) -> ComposeResult:
+        yield Header()
+        yield Static("Press R/G/B to change background")
+        yield Footer()
+
+    def action_set_bg(self, color: str) -> None:
+        self.screen.styles.background = color
+
+
+if __name__ == "__main__":
+    BindingApp().run()

lib_cli_exit_tools-1.0.2/docs/textual/snippets/listview_basic.py

@@ -0,0 +1,20 @@
+from __future__ import annotations
+
+from textual.app import App, ComposeResult
+from textual.widgets import Header, Footer, ListView, ListItem, Label
+
+
+class ListViewDemo(App):
+    def compose(self) -> ComposeResult:
+        yield Header()
+        yield ListView(
+            ListItem(Label("Install")),
+            ListItem(Label("Build")),
+            ListItem(Label("Release")),
+            id="targets",
+        )
+        yield Footer()
+
+
+if __name__ == "__main__":
+    ListViewDemo().run()

lib_cli_exit_tools-1.0.2/docs/textual/snippets/mount_await.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+from textual.app import App, ComposeResult
+from textual.widgets import Header, Footer, Static, Button
+
+
+class MountAwaitApp(App):
+    def compose(self) -> ComposeResult:
+        yield Header()
+        yield Button("Add Box", id="add")
+        yield Footer()
+
+    async def on_button_pressed(self, event: Button.Pressed) -> None:
+        if event.button.id == "add":
+            box = Static("I was mounted and styled!")
+            await self.mount(box)
+            box.styles.border = ("tall", "green")
+
+
+if __name__ == "__main__":
+    MountAwaitApp().run()

lib_cli_exit_tools-1.0.2/docs/textual/snippets/richlog_stream.py

@@ -0,0 +1,56 @@
+from __future__ import annotations
+
+import asyncio
+from textual.app import App, ComposeResult
+from textual.widgets import Header, Footer, RichLog, Button
+from textual.containers import Horizontal
+
+
+class StreamApp(App):
+    CSS = """
+    RichLog { border: tall $accent; }
+    """
+
+    def compose(self) -> ComposeResult:
+        yield Header()
+        self.log = RichLog(highlight=True)
+        yield self.log
+        with Horizontal():
+            yield Button("Run", id="run")
+            yield Button("Cancel", id="cancel")
+        yield Footer()
+
+    async def _run_cmd(self) -> None:
+        self._proc = await asyncio.create_subprocess_exec(
+            "python",
+            "-c",
+            "import time; [print(i) or time.sleep(0.3) for i in range(10)]",
+            stdout=asyncio.subprocess.PIPE,
+            stderr=asyncio.subprocess.PIPE,
+        )
+
+        async def pump(stream, label: str):
+            assert stream is not None
+            while True:
+                line = await stream.readline()
+                if not line:
+                    break
+                self.log.write(f"{label} {line.decode().rstrip()}\n")
+
+        await asyncio.gather(pump(self._proc.stdout, "stdout:"), pump(self._proc.stderr, "stderr:"))
+        rc = await self._proc.wait()
+        self.log.write(f"exit={rc}")
+
+    async def on_button_pressed(self, event: Button.Pressed) -> None:
+        if event.button.id == "run":
+            self.set_timer(0, lambda: asyncio.create_task(self._run_cmd()))
+        elif event.button.id == "cancel":
+            if getattr(self, "_proc", None):
+                try:
+                    self._proc.send_signal(getattr(asyncio.subprocess, "signal", __import__("signal")).SIGINT)
+                except Exception:
+                    self._proc.terminate()
+
+
+if __name__ == "__main__":
+    StreamApp().run()

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

@@ -3,8 +3,8 @@ 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.1.tar.gz"
-  sha256 "<fill-me>"
+  url "https://github.com/bitranox/lib_cli_exit_tools/archive/refs/tags/v1.0.2.tar.gz"
+k3cc316e7d0b09dd79e617cb3e91b14ee414b7e6695b108a326d9d3ccd08dd9"
   license "MIT"
 
   depends_on "python@3.10"
@@ -12,7 +12,7 @@ class LibCliExitTools < Formula
   # Vendor Python deps (fill versions/sha256 for an actual formula)
   resource "click" do
     url "https://files.pythonhosted.org/packages/60/6c/8ca2efa64cf75a977a0d7fac081354553ebe483345c734fb6b6515d96bbc/click-8.2.1.tar.gz"
-    sha256 "27c491cc05d968d271d5a1db13e3b5a184636d9d930f148c50b038f0d0646202"
+k3cc316e7d0b09dd79e617cb3e91b14ee414b7e6695b108a326d9d3ccd08dd9"
   end
 
   def install

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

@@ -1,5 +1,5 @@
 {% set name = "lib_cli_exit_tools" %}
-{% set version = "1.0.1" %}
+{% set version = "1.0.2" %}
 
 package:
   name: {{ name|lower }}
@@ -13,7 +13,7 @@ source:
 source:
   # For released tags; replace sha256 before submitting to conda-forge
   url: https://github.com/bitranox/{{ name }}/archive/refs/tags/v{{ version }}.tar.gz
-  sha256: "<fill-me>"
+  k3cc316e7d0b09dd79e617cb3e91b14ee414b7e6695b108a326d9d3ccd08dd9"
 {% endif %}
 
 build:

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

@@ -35,7 +35,7 @@
       {
         packages.default = pypkgs.buildPythonPackage {
           pname = "lib_cli_exit_tools";
-          version = "1.0.1";
+          version = "1.0.2";
           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.1";
+          #   rev = "v1.0.2";
           #   sha256 = "<fill-me>";
           # };
 

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

@@ -1,6 +1,6 @@
 [project]
 name = "lib_cli_exit_tools"
-version = "1.0.1"
+version = "1.0.2"
 description = "CLI exit handling helpers: clean signals, exit codes, and error printing"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -31,6 +31,7 @@ dev = [
   "build>=1.2",
   "twine>=5.1",
   "codecov>=2.1.13",
+  "textual>=0.50",
 ]
 
 [project.scripts]
@@ -59,6 +60,10 @@ target-version = "py313"
 
 [tool.pyright]
 typeCheckingMode = "strict"
+exclude = [
+  "scripts/menu.py",
+  "docs",
+]
 
 [tool.pytest.ini_options]
 addopts = ["--doctest-modules"]

lib_cli_exit_tools-1.0.2/scripts/__init__.py

@@ -0,0 +1,3 @@
+from __future__ import annotations
+
+__all__ = []