lib-cli-exit-tools 1.1.1__tar.gz → 1.2.0__tar.gz

{lib_cli_exit_tools-1.1.1 → lib_cli_exit_tools-1.2.0}/.github/workflows/ci.yml

@@ -31,6 +31,7 @@ jobs:
         shell: bash
         run: |
           python -m pip install --upgrade pip
+          python -m pip install --upgrade click rich rich-click
           pip install -e .[dev]
       - name: Run full test suite (lint, types, tests, coverage, codecov)
         shell: bash

{lib_cli_exit_tools-1.1.1 → lib_cli_exit_tools-1.2.0}/.gitignore

@@ -64,6 +64,7 @@ coverage.xml
 # general cache directories (any project-level caching)
 .cache/
 .run/
+.import_linter_cache/
 
 # ====================================
 # Build & distribution artifacts

{lib_cli_exit_tools-1.1.1 → lib_cli_exit_tools-1.2.0}/AGENTS.md

@@ -2,20 +2,17 @@
 
 ## On session start
 
-- Connect to the `systemprompts` MCP filesystem.
-- Read following files and keep their guidance in working memory:
-  - core_programming_solid.md
-  - bash_clean_architecture.md
-  - bash_clean_code.md
-  - bash_small_functions.md
-  - python_solid_architecture_enforcer.md
-  - python_clean_architecture.md/media/srv-main-softdev/projects/libs/bitranox_template_py_cli
-  - python_clean_code.md
-  - python_small_functions_style.md
-  - python_libraries_to_use.md
-  - python_structure_template.md
-  - self_documenting.md
+Review the system prompt files in `/media/srv-main/softdev/*/projects/softwarestack/systemprompts` and keep their guidance in working memory:
 
+- core_programming_solid.md
+- python_solid_architecture_enforcer.md
+- python_clean_architecture.md
+- python_clean_code.md
+- python_small_functions_style.md
+- python_libraries_to_use.md
+- python_structure_template.md
+- self_documenting.md
+- self_documenting_template.md
 
 always apply those Rules :
 
@@ -37,7 +34,6 @@ when writing or refracturing Python scripts, apply those Rules :
 - python_libraries_to_use.md
 - python_lib_structure_template.md
 
-
 ## Project Structure & Module Organization
 
 - `src/lib_cli_exit_tools/`: Python package.

{lib_cli_exit_tools-1.1.1 → lib_cli_exit_tools-1.2.0}/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## [1.2.0] - 2025-09-25
+
+- use rich-click instead of click, minor fixes
+
 ## [1.1.1] - 2025-09-18
 
 - Documentation and doctest updates

{lib_cli_exit_tools-1.1.1 → lib_cli_exit_tools-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lib_cli_exit_tools
-Version: 1.1.1
+Version: 1.2.0
 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
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
-Requires-Dist: click>=8.1
+Requires-Dist: rich-click>=1.9.1
 Provides-Extra: dev
 Requires-Dist: build>=1.2; extra == 'dev'
 Requires-Dist: codecov>=2.1.13; extra == 'dev'

{lib_cli_exit_tools-1.1.1 → lib_cli_exit_tools-1.2.0}/docs/system-design/reference.md

@@ -167,6 +167,13 @@ The package is the core runtime library for handling CLI exits within the broade
 **Output:** Dict passed to Click context settings.  
 **Location:** `lib_cli_exit_tools/cli.py`
 
+#### Function: _configure_rich_click_output
+**Purpose:** Neutralise rich-click styling when stdout is a pipe or uses non-UTF encodings so help text stays ASCII-safe on Windows CI.  
+**Input:** None; inspects the active stdout stream via `click.get_text_stream`.  
+**Output:** Adjusts rich-click globals (forced terminal flag, colour system, panel boxes) to avoid emitting characters that legacy encodings cannot represent.  
+**Location:** `lib_cli_exit_tools/cli.py`
+
+
 #### Function: cli
 **Purpose:** Root Click group that stores global options (currently `--traceback`) and updates library configuration.  
 **Input:** Click `Context`, boolean `traceback` option.  

{lib_cli_exit_tools-1.1.1 → lib_cli_exit_tools-1.2.0}/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.1.1.tar.gz"
+  url "https://github.com/bitranox/lib_cli_exit_tools/archive/refs/tags/v1.2.0.tar.gz"
 k3cc316e7d0b09dd79e617cb3e91b14ee414b7e6695b108a326d9d3ccd08dd9"
   license "MIT"
 
@@ -11,10 +11,15 @@ k3cc316e7d0b09dd79e617cb3e91b14ee414b7e6695b108a326d9d3ccd08dd9"
 
   # 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"
+    url "https://files.pythonhosted.org/packages/46/61/de6cd827efad202d7057d93e0fed9294b96952e188f7384832791c7b2254/click-8.3.0.tar.gz"
 k3cc316e7d0b09dd79e617cb3e91b14ee414b7e6695b108a326d9d3ccd08dd9"
   end
 
+  resource "rich-click" do
+    url "https://files.pythonhosted.org/packages/29/c2/f08b5e7c1a33af8a115be640aa0796ba01c4732696da6d2254391376b314/rich_click-1.9.1.tar.gz"
+    sha256 "4f2620589d7287f86265432e6a909de4f281de909fe68d8c835fbba49265d268"
+  end
+
   def install
     virtualenv_install_with_resources
   end

{lib_cli_exit_tools-1.1.1 → lib_cli_exit_tools-1.2.0}/packaging/conda/recipe/meta.yaml

@@ -1,5 +1,5 @@
 {% set name = "lib_cli_exit_tools" %}
-{% set version = "1.1.1" %}
+{% set version = "1.2.0" %}
 
 package:
   name: {{ name|lower }}
@@ -28,7 +28,7 @@ requirements:
     - hatchling >=1.25
   run:
     - python >=3.10
-    - click >=8.1
+    - rich-click >=1.9.1
 
 test:
   commands:

{lib_cli_exit_tools-1.1.1 → lib_cli_exit_tools-1.2.0}/packaging/nix/flake.nix

@@ -1,5 +1,5 @@
 {
-  description = "lib_cli_exit_tools Nix flake";
+  description = "bitranox_template_py_cli Nix flake";
 
   inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-24.05";
   inputs.flake-utils.url = "github:numtide/flake-utils";
@@ -11,15 +11,13 @@
         lib = pkgs.lib;
         pypkgs = pkgs.python310Packages;
 
-        # Vendor hatchling>=1.25 from PyPI (wheel) to satisfy PEP 517 build
         hatchlingVendor = pypkgs.buildPythonPackage rec {
           pname = "hatchling";
           version = "1.25.0";
-          format = "wheel"; # install straight from wheel to avoid circular build-backend
-          # Use explicit URL for py3 wheel; nixpkgs 24.05 fetchPypi may choose a py2.py3 path.
+          format = "wheel";
           src = pkgs.fetchurl {
-            url = "https://files.pythonhosted.org/packages/py3/h/hatchling/${pname}-${version}-py3-none-any.whl";
-            hash = "sha256-tHlI5F1NlzA0WE3UyznBS2pwInzyh6t+wK15g0CKiCw=";
+            url = "https://files.pythonhosted.org/packages/py3/h/hatchling/hatchling-1.25.0-py3-none-any.whl";
+            hash = "sha256-tHlI5F1NlzA0WE3UyznBS2pwInzyh6t+wK15g0CKiCw";
           };
           propagatedBuildInputs = [
             pypkgs.packaging
@@ -31,30 +29,30 @@
           ];
           doCheck = false;
         };
+        richClickVendor = pypkgs.buildPythonPackage rec {
+          pname = "rich-click";
+          version = "1.9.1";
+          format = "wheel";
+          src = pkgs.fetchurl {
+            url = "https://files.pythonhosted.org/packages/a8/77/e9144dcf68a0b3f3f4386986f97255c3d9f7c659be58bb7a5fe8f26f3efa/rich_click-1.9.1-py3-none-any.whl";
+            sha256 = "sha256-6mEUqeCBt9aMwHsxUHA5j4BvAbsODEnaVvEp5nKHeBc=";
+          };
+          doCheck = false;
+        };
+
       in
       {
         packages.default = pypkgs.buildPythonPackage {
           pname = "lib_cli_exit_tools";
-          version = "1.1.1";
+          version = "1.2.0";
           pyproject = true;
-          # Build from the repository root (two levels up from packaging/nix)
           src = ../..;
-          # For pinned releases, swap src for fetchFromGitHub with a rev/sha256.
-          # src = pkgs.fetchFromGitHub {
-          #   owner = "bitranox";
-          #   repo = "lib_cli_exit_tools";
-          #   rev = "v1.1.1";
-          #   sha256 = "<fill-me>";
-          # };
-
-          # Ensure PEP 517 backend is available at required version
-          # Ensure PEP 517 backend available at required version (>=1.25)
           nativeBuildInputs = [ hatchlingVendor ];
-          propagatedBuildInputs = [ pypkgs.click ];
+          propagatedBuildInputs = [ richClickVendor ];
 
           meta = with pkgs.lib; {
-            description = "CLI exit handling helpers: clean signals, exit codes, and error printing";
-            homepage = "https://github.com/bitranox/lib_cli_exit_tools";
+            description = "Rich-powered logging helpers for colorful terminal output";
+            homepage = "https://github.com/bitranox/bitranox_template_py_cli";
             license = licenses.mit;
             maintainers = [];
             platforms = platforms.unix ++ platforms.darwin;
@@ -65,7 +63,7 @@
           packages = [
             pkgs.python310
             hatchlingVendor
-            pypkgs.click
+            richClickVendor
             pypkgs.pytest
             pkgs.ruff
             pkgs.nodejs

{lib_cli_exit_tools-1.1.1 → lib_cli_exit_tools-1.2.0}/pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "lib_cli_exit_tools"
-version = "1.1.1"
+version = "1.2.0"
 description = "CLI exit handling helpers: clean signals, exit codes, and error printing"
 readme = "README.md"
 requires-python = ">=3.10"
-dependencies = ["click>=8.1"]
+dependencies = ["rich-click>=1.9.1"]
 license = { text = "MIT" }
 authors = [{ name = "bitranox", email = "bitranox@gmail.com" }]
 keywords = ["cli", "exit", "signals", "errors", "click"]

{lib_cli_exit_tools-1.1.1 → lib_cli_exit_tools-1.2.0}/scripts/_utils.py

@@ -1,9 +1,15 @@
 from __future__ import annotations
 
+import os
+import platform
 import re
 import shlex
 import subprocess
 import sys
+import tempfile
+import hashlib
+import json
+from urllib.request import urlopen
 from dataclasses import dataclass
 from pathlib import Path
 from subprocess import CompletedProcess
@@ -194,6 +200,95 @@ def read_version_from_pyproject(pyproject: Path = Path("pyproject.toml")) -> str
     return match.group(1) if match else ""
 
 
+def ensure_conda(auto_install: bool = True) -> bool:
+    """Ensure the `conda` CLI is available, optionally bootstrapping Miniforge."""
+
+    if cmd_exists("conda"):
+        return True
+
+    if not auto_install:
+        return False
+
+    system = platform.system().lower()
+    machine = platform.machine().lower()
+
+    if system.startswith("linux"):
+        os_name = "Linux"
+    elif system == "darwin":
+        os_name = "MacOSX"
+    else:
+        return False
+
+    if machine in {"x86_64", "amd64"}:
+        arch = "x86_64"
+    elif machine in {"aarch64", "arm64"}:
+        arch = "aarch64" if os_name == "Linux" else "arm64"
+    else:
+        return False
+
+    filename = f"Miniforge3-{os_name}-{arch}.sh"
+    base = "https://github.com/conda-forge/miniforge/releases/latest/download/"
+    asset_url = base + filename
+    sums_url = base + "SHA256SUMS"
+
+    try:
+        with urlopen("https://api.github.com/repos/conda-forge/miniforge/releases/latest", timeout=10) as resp:
+            release = json.loads(resp.read().decode("utf-8"))
+        for asset in release.get("assets", []):
+            name = asset.get("name")
+            if name == filename:
+                asset_url = asset.get("browser_download_url", asset_url)
+            elif name == "SHA256SUMS":
+                sums_url = asset.get("browser_download_url", sums_url)
+    except Exception:
+        pass
+
+    conda_root = Path.home() / "miniforge3"
+
+    if not conda_root.exists():
+        attempts = 3
+        for _ in range(attempts):
+            try:
+                installer_bytes = urlopen(asset_url, timeout=30).read()
+                sums_text = urlopen(sums_url, timeout=30).read().decode("utf-8")
+            except Exception:
+                continue
+
+            expected_hash = None
+            for line in sums_text.splitlines():
+                line = line.strip()
+                if line.endswith(f"  {filename}"):
+                    parts = line.split()
+                    if parts:
+                        expected_hash = parts[0]
+                    break
+
+            if not expected_hash:
+                continue
+
+            actual_hash = hashlib.sha256(installer_bytes).hexdigest()
+            if actual_hash != expected_hash:
+                continue
+
+            with tempfile.TemporaryDirectory() as tmp:
+                installer = Path(tmp) / filename
+                installer.write_bytes(installer_bytes)
+                installer.chmod(0o755)
+                install = run(["bash", str(installer), "-b"], check=False, capture=False)
+                if install.code == 0:
+                    break
+        else:
+            return False
+    candidates = [conda_root / "condabin", conda_root / "bin"]
+
+    existing = os.environ.get("PATH", "").split(os.pathsep)
+    new_entries = [str(p) for p in candidates if p.exists()]
+    if new_entries:
+        os.environ["PATH"] = os.pathsep.join(new_entries + [p for p in existing if p])
+
+    return cmd_exists("conda")
+
+
 def ensure_clean_git_tree() -> None:
     dirty = subprocess.call(["bash", "-lc", "! git diff --quiet || ! git diff --cached --quiet"], stdout=subprocess.DEVNULL)
     if dirty == 0:
@@ -241,6 +336,7 @@ def gh_release_edit(tag: str, title: str, body: str) -> None:
 
 def sync_packaging() -> None:
     run([sys.executable, "scripts/bump_version.py", "--sync-packaging"], check=False)
+    run([sys.executable, "scripts/generate_nix_flake.py"], check=False)
 
 
 def bootstrap_dev() -> None:
@@ -253,3 +349,38 @@ def bootstrap_dev() -> None:
         import_module("sqlite3")
     except Exception:
         run([sys.executable, "-m", "pip", "install", "pysqlite3-binary"], check=False)
+
+
+def ensure_nix(auto_install: bool = True) -> bool:
+    """Ensure the `nix` command is available, optionally bootstrapping it."""
+
+    if cmd_exists("nix"):
+        return True
+
+    if not auto_install:
+        return False
+
+    import os
+    import sys
+
+    platform = sys.platform
+    if not (platform.startswith("linux") or platform == "darwin"):
+        return False
+
+    # Install single-user Nix (no-daemon) for non-root environments.
+    install_cmd = "curl -L https://nixos.org/nix/install | sh -s -- --no-daemon"
+    run(["bash", "-lc", install_cmd], check=False, capture=False)
+
+    profile_dir = Path.home() / ".nix-profile"
+    profile_env = profile_dir / "etc" / "profile.d" / "nix.sh"
+    bin_dir = profile_dir / "bin"
+
+    if bin_dir.exists():
+        path_entries = os.environ.get("PATH", "").split(os.pathsep)
+        if str(bin_dir) not in path_entries:
+            os.environ["PATH"] = os.pathsep.join([str(bin_dir)] + [p for p in path_entries if p])
+
+    if profile_env.exists():
+        run(["bash", "-lc", f". {profile_env} >/dev/null 2>&1 && nix --version"], check=False, capture=False)
+
+    return cmd_exists("nix")

lib_cli_exit_tools-1.2.0/scripts/build.py

@@ -0,0 +1,66 @@
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+import click
+
+try:  # allow running as package module or stand-alone script
+    from ._utils import cmd_exists, ensure_conda, ensure_nix, get_project_metadata, run
+except ImportError:  # pragma: no cover - direct script execution path
+    sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
+    from scripts._utils import cmd_exists, ensure_conda, ensure_nix, get_project_metadata, 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")
+    build_result = run(["python", "-m", "build"], check=False, capture=False)
+    build_msg = click.style("success", fg="green") if build_result.code == 0 else click.style("failed", fg="red")
+    click.echo(f"[build] {build_msg}")
+    if build_result.code != 0:
+        raise SystemExit(build_result.code)
+
+    project = get_project_metadata()
+
+    click.echo("[2/4] Attempting conda-build")
+    conda_msg: str
+    if conda:
+        if ensure_conda():
+            conda_cmd = ". $HOME/miniforge3/etc/profile.d/conda.sh >/dev/null 2>&1 || true; conda clean --all --yes >/dev/null 2>&1 || true; CONDA_USE_LOCAL=1 conda build packaging/conda/recipe"
+            conda_result = run(["bash", "-lc", conda_cmd], check=False, capture=False)
+            conda_msg = click.style("success", fg="green") if conda_result.code == 0 else click.style("failed", fg="red")
+        else:
+            conda_msg = click.style("skipped", fg="yellow")
+    else:
+        conda_msg = click.style("skipped", fg="yellow")
+    click.echo(f"[conda] {conda_msg}")
+
+    click.echo("[3/4] Attempting Homebrew build/install from local formula")
+    brew_msg: str
+    if brew and cmd_exists("brew"):
+        brew_result = run(["bash", "-lc", f"brew install --build-from-source {project.brew_formula_path}"], check=False, capture=False)
+        brew_msg = click.style("success", fg="green") if brew_result.code == 0 else click.style("failed", fg="red")
+    else:
+        brew_msg = click.style("skipped", fg="yellow")
+    click.echo(f"[brew] {brew_msg}")
+
+    click.echo("[4/4] Attempting Nix flake build")
+    nix_msg: str
+    if nix:
+        if ensure_nix():
+            nix_cmd = ". $HOME/.nix-profile/etc/profile.d/nix.sh >/dev/null 2>&1 || true; nix build --extra-experimental-features 'nix-command flakes' ./packaging/nix#default -L"
+            nix_result = run(["bash", "-lc", nix_cmd], check=False, capture=False)
+            nix_msg = click.style("success", fg="green") if nix_result.code == 0 else click.style("failed", fg="red")
+        else:
+            nix_msg = click.style("skipped", fg="yellow")
+    else:
+        nix_msg = click.style("skipped", fg="yellow")
+    click.echo(f"[nix] {nix_msg}")
+
+
+if __name__ == "__main__":
+    main()