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

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

@@ -1,8 +1,16 @@
 # Changelog
 
+## [1.0.3] - 2025-09-16
+
+- added make menu
+
+## [1.0.2] - 2025-09-15
+
+- minor internals
+
 ## [1.0.1] - 2025-09-15
 
-- _Describe changes here._
+- minor internals 
 
 ## [1.0.0] - 2025-09-15
 
@@ -12,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.1 → 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.3/Makefile

@@ -0,0 +1,98 @@
+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 _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 TUI menu
+	$(PY) -u scripts/menu.py < /dev/tty > /dev/tty 2>&1

{lib_cli_exit_tools-1.0.1 → 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.1
+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
@@ -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,77 @@ 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)             |
+
+#### 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
+  - `TEST_VERBOSE=1` — echo each command executed by the test harness
+  - 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.
+
+Install dev extras if you haven’t:
+
+```bash
+pip install -e .[dev]
+```
+
+Run the menu:
+
+```bash
+make menu
+```
 
 #### Target Details
 
@@ -220,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.1 → lib_cli_exit_tools-1.0.3}/README.md

@@ -106,13 +106,77 @@ 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)             |
+
+#### 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
+  - `TEST_VERBOSE=1` — echo each command executed by the test harness
+  - 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.
+
+Install dev extras if you haven’t:
+
+```bash
+pip install -e .[dev]
+```
+
+Run the menu:
+
+```bash
+make menu
+```
 
 #### Target Details
 
@@ -191,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.1 → 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.1 → 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.1 → lib_cli_exit_tools-1.0.3}/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.3.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.3}/packaging/conda/recipe/meta.yaml

@@ -1,5 +1,5 @@
 {% set name = "lib_cli_exit_tools" %}
-{% set version = "1.0.1" %}
+{% set version = "1.0.3" %}
 
 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.3}/packaging/nix/flake.nix

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

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

@@ -1,6 +1,6 @@
 [project]
 name = "lib_cli_exit_tools"
-version = "1.0.1"
+version = "1.0.3"
 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,9 @@ target-version = "py313"
 
 [tool.pyright]
 typeCheckingMode = "strict"
+exclude = [
+  "scripts/menu.py",
+]
 
 [tool.pytest.ini_options]
 addopts = ["--doctest-modules"]

lib_cli_exit_tools-1.0.3/qlty.toml

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

lib_cli_exit_tools-1.0.3/scripts/__init__.py

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

lib_cli_exit_tools-1.0.3/scripts/_utils.py

@@ -0,0 +1,125 @@
+from __future__ import annotations
+import re
+import shlex
+import subprocess
+import sys
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Mapping, Sequence
+from subprocess import CompletedProcess
+
+
+@dataclass(slots=True)
+class RunResult:
+    code: int
+    out: str
+    err: str
+
+
+def run(
+    cmd: Sequence[str] | str, *, check: bool = True, capture: bool = True, cwd: str | None = None, env: Mapping[str, str] | None = None, dry_run: bool = False
+) -> RunResult:
+    if isinstance(cmd, str):
+        display = cmd
+        shell = True
+        args: Sequence[str] | str = cmd
+    else:
+        display = " ".join(shlex.quote(p) for p in cmd)
+        shell = False
+        args = list(cmd)
+    if dry_run:
+        print(f"[dry-run] {display}")
+        return RunResult(0, "", "")
+    proc: CompletedProcess[str] = subprocess.run(
+        args,
+        shell=shell,
+        cwd=cwd,
+        env=env,
+        text=True,
+        capture_output=capture,
+    )
+    if check and proc.returncode != 0:
+        raise SystemExit(proc.returncode)
+    return RunResult(int(proc.returncode or 0), proc.stdout or "", proc.stderr or "")
+
+
+def cmd_exists(name: str) -> bool:
+    return subprocess.call(["bash", "-lc", f"command -v {shlex.quote(name)} >/dev/null 2>&1"], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) == 0
+
+
+def read_version_from_pyproject(pyproject: Path = Path("pyproject.toml")) -> str:
+    try:
+        import tomllib  # pyright: ignore[reportMissingImports, reportMissingTypeStubs]
+
+        data = tomllib.loads(pyproject.read_text(encoding="utf-8"))
+        version = str(data.get("project", {}).get("version", ""))
+        if version:
+            return version
+    except Exception:
+        pass
+    m = re.search(r'(?m)^version\s*=\s*"([0-9]+(?:\.[0-9]+){2})"', pyproject.read_text(encoding="utf-8"))
+    return m.group(1) if m else ""
+
+
+def ensure_clean_git_tree() -> None:
+    # unstaged or staged changes?
+    dirty = subprocess.call(["bash", "-lc", "! git diff --quiet || ! git diff --cached --quiet"], stdout=subprocess.DEVNULL)
+    if dirty == 0:
+        print("[release] Working tree not clean. Commit or stash changes first.", file=sys.stderr)
+        raise SystemExit(1)
+
+
+def git_branch() -> str:
+    return run(["git", "rev-parse", "--abbrev-ref", "HEAD"], capture=True).out.strip()
+
+
+def git_delete_tag(name: str, *, remote: str | None = None) -> None:
+    run(["git", "tag", "-d", name], check=False, capture=True)
+    if remote:
+        run(["git", "push", remote, f":refs/tags/{name}"], check=False)
+
+
+def git_tag_exists(name: str) -> bool:
+    return subprocess.call(["bash", "-lc", f"git rev-parse -q --verify {shlex.quote('refs/tags/' + name)} >/dev/null"], stdout=subprocess.DEVNULL) == 0
+
+
+def git_create_annotated_tag(name: str, message: str) -> None:
+    run(["git", "tag", "-a", name, "-m", message])
+
+
+def git_push(remote: str, ref: str) -> None:
+    run(["git", "push", remote, ref])
+
+
+def gh_available() -> bool:
+    return cmd_exists("gh")
+
+
+def gh_release_exists(tag: str) -> bool:
+    return subprocess.call(["bash", "-lc", f"gh release view {shlex.quote(tag)} >/dev/null 2>&1"], stdout=subprocess.DEVNULL) == 0
+
+
+def gh_release_create(tag: str, title: str, body: str) -> None:
+    run(["gh", "release", "create", tag, "-t", title, "-n", body], check=False)
+
+
+def gh_release_edit(tag: str, title: str, body: str) -> None:
+    run(["gh", "release", "edit", tag, "-t", title, "-n", body], check=False)
+
+
+def sync_packaging() -> None:
+    run([sys.executable, "scripts/bump_version.py", "--sync-packaging"], check=False)
+
+
+def bootstrap_dev() -> None:
+    # Install dev deps if ruff/pyright/pytest are missing
+    if not (cmd_exists("ruff") and cmd_exists("pyright")):
+        print("[bootstrap] Installing dev dependencies via 'pip install -e .[dev]'")
+        run([sys.executable, "-m", "pip", "install", "-e", ".[dev]"])
+    # sqlite fallback (rare)
+    try:
+        from importlib import import_module
+
+        import_module("sqlite3")
+    except Exception:
+        run([sys.executable, "-m", "pip", "install", "pysqlite3-binary"], check=False)

lib_cli_exit_tools-1.0.3/scripts/build.py

@@ -0,0 +1,37 @@
+from __future__ import annotations
+
+import click
+import sys
+
+from ._utils import cmd_exists, run
+
+
+@click.command(help="Build wheel/sdist, optionally attempt conda/brew/nix builds if tools present")
+@click.option("--conda/--no-conda", default=True, help="Attempt conda build if conda present")
+@click.option("--brew/--no-brew", default=True, help="Attempt Homebrew build if brew present (macOS)")
+@click.option("--nix/--no-nix", default=True, help="Attempt Nix build if nix present")
+def main(conda: bool, brew: bool, nix: bool) -> None:
+    click.echo("[1/4] Building wheel/sdist via python -m build")
+    run([sys.executable, "-m", "build"])  # requires build in dev deps
+
+    click.echo("[2/4] Attempting conda-build")
+    if conda and cmd_exists("conda"):
+        run(["bash", "-lc", "CONDA_USE_LOCAL=1 conda build packaging/conda/recipe"], check=False)
+    else:
+        click.echo("[conda] skipping: conda not available or disabled")
+
+    click.echo("[3/4] Attempting Homebrew build/install from local formula")
+    if brew and cmd_exists("brew"):
+        run(["bash", "-lc", "brew install --build-from-source packaging/brew/Formula/lib-cli-exit-tools.rb"], check=False)
+    else:
+        click.echo("[brew] skipping: Homebrew not available or disabled")
+
+    click.echo("[4/4] Attempting Nix flake build")
+    if nix and cmd_exists("nix"):
+        run(["bash", "-lc", "nix build packaging/nix#default -L"], check=False)
+    else:
+        click.echo("[nix] skipping: nix not available or disabled")
+
+
+if __name__ == "__main__":
+    main()

lib_cli_exit_tools-1.0.3/scripts/bump.py

@@ -0,0 +1,27 @@
+from __future__ import annotations
+
+import click
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
+from scripts._utils import run  # noqa: E402
+
+
+@click.command(help="Bump version in pyproject.toml and CHANGELOG.md")
+@click.option("--version", "version_", type=str, help="Explicit version X.Y.Z")
+@click.option("--part", type=click.Choice(["major", "minor", "patch"]), default=None)
+@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, "scripts/bump_version.py"]
+    if version_:
+        args += ["--version", version_]
+    else:
+        args += ["--part", part or "patch"]
+    args += ["--pyproject", str(pyproject), "--changelog", str(changelog)]
+    run(args)
+
+
+if __name__ == "__main__":
+    main()

lib_cli_exit_tools-1.0.3/scripts/bump_major.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+import click
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
+from scripts.bump import main as bump_main  # noqa: E402
+
+
+@click.command(help="Bump major version")
+def main() -> None:  # pragma: no cover
+    bump_main.main(standalone_mode=False, args=["--part", "major"])  # type: ignore[attr-defined]
+
+
+if __name__ == "__main__":
+    main()