lib-cli-exit-tools 2.2.2__tar.gz → 2.2.4__tar.gz

lib_cli_exit_tools-2.2.2/.github/workflows/ci.yml → lib_cli_exit_tools-2.2.4/.github/workflows/ci.yml_backup

@@ -83,14 +83,14 @@ jobs:
         run: |
           uv pip install pywin32 --system
       - name: Cache ruff
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: .ruff_cache
           key: ruff-${{ runner.os }}-${{ github.sha }}
           restore-keys: |
             ruff-${{ runner.os }}-
       - name: Cache pyright
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: .pyright
           key: pyright-${{ runner.os }}-py${{ matrix.python }}-${{ github.sha }}

lib_cli_exit_tools-2.2.4/.github/workflows/default_cicd_public.yml

@@ -0,0 +1,303 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+  schedule:
+    # Run daily at 3:17 AM UTC (off-peak hours, odd minute to avoid congestion)
+    - cron: '17 3 * * *'
+
+jobs:
+  test:
+    name: Tests (Python ${{ matrix.python }}, ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        # Test against all supported Python versions (3.10+)
+        python: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    env:
+      PYO3_USE_ABI3_FORWARD_COMPATIBILITY: "1"
+      PYTHONIOENCODING: "utf-8"
+      UV_LINK_MODE: "copy"
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python }}
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          prune-cache: false
+
+      - name: Install tomli (Python < 3.11)
+        shell: bash
+        run: python -c "import tomllib" 2>/dev/null || uv pip install tomli --system
+
+      - name: Extract project metadata
+        shell: python
+        run: |
+          import os
+          try:
+              import tomllib
+          except ModuleNotFoundError:
+              import tomli as tomllib
+
+          with open('pyproject.toml', 'rb') as f:
+              data = tomllib.load(f)
+          project = data['project']['name']
+          module = project.replace('-', '_')
+          dash = project.replace('_', '-')
+          scripts = list(data['project'].get('scripts', {}).keys())
+          cli_bin = scripts[0] if scripts else dash
+
+          with open(os.environ['GITHUB_ENV'], 'a', encoding='utf-8') as env:
+              env.write(f"PROJECT_NAME={project}\n")
+              env.write(f"PACKAGE_MODULE={module}\n")
+              env.write(f"CLI_BIN={cli_bin}\n")
+
+      - name: Install journald prerequisites
+        if: runner.os == 'Linux'
+        shell: bash
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y python3-systemd
+
+      - name: Install dev deps
+        shell: bash
+        run: |
+          uv pip install -e .[dev] --system
+
+      - name: Install Windows Event Log prerequisites
+        if: runner.os == 'Windows'
+        shell: bash
+        run: |
+          uv pip install pywin32 --system
+
+      - name: Restore ruff cache
+        id: ruff-cache
+        uses: actions/cache/restore@v5
+        with:
+          path: .ruff_cache
+          key: ruff-${{ runner.os }}-py${{ matrix.python }}-${{ github.sha }}
+          restore-keys: |
+            ruff-${{ runner.os }}-py${{ matrix.python }}-
+            ruff-${{ runner.os }}-
+
+      - name: Run ruff (lint + format)
+        id: ruff
+        continue-on-error: true
+        shell: bash
+        run: |
+          ruff check src tests notebooks
+          ruff format --check src tests notebooks
+
+      - name: Run pyright (type check)
+        id: pyright
+        continue-on-error: true
+        shell: bash
+        run: pyright
+
+      - name: Run pytest (tests + coverage)
+        id: pytest
+        continue-on-error: true
+        shell: bash
+        env:
+          TEST_VERBOSE: "1"
+        run: pytest --cov=src --cov-report=term-missing --cov-report=xml
+
+      - name: Run import-linter (architecture)
+        id: importlinter
+        continue-on-error: true
+        shell: bash
+        run: lint-imports
+
+      - name: Run bandit (security scan)
+        id: bandit
+        continue-on-error: true
+        shell: bash
+        run: bandit -q -r src/${{ env.PACKAGE_MODULE }}
+
+      - name: Run pip-audit (vulnerability scan)
+        id: pipaudit
+        continue-on-error: true
+        shell: python
+        run: |
+          import subprocess, sys
+          try:
+              import tomllib
+          except ModuleNotFoundError:
+              import tomli as tomllib
+          with open("pyproject.toml", "rb") as f:
+              data = tomllib.load(f)
+          vulns = data.get("tool", {}).get("pip-audit", {}).get("ignore-vulns", [])
+          cmd = ["pip-audit", "--skip-editable"]
+          for v in vulns:
+              cmd.extend(["--ignore-vuln", v])
+          sys.exit(subprocess.call(cmd))
+
+      - name: Check all steps passed
+        shell: bash
+        run: |
+          if [[ "${{ steps.ruff.outcome }}" != "success" ]]; then
+            echo "::error::Ruff check failed"
+            exit 1
+          fi
+          if [[ "${{ steps.pyright.outcome }}" != "success" ]]; then
+            echo "::error::Pyright check failed"
+            exit 1
+          fi
+          if [[ "${{ steps.pytest.outcome }}" != "success" ]]; then
+            echo "::error::Pytest failed"
+            exit 1
+          fi
+          if [[ "${{ steps.importlinter.outcome }}" != "success" ]]; then
+            echo "::error::Import-linter check failed"
+            exit 1
+          fi
+          if [[ "${{ steps.bandit.outcome }}" != "success" ]]; then
+            echo "::error::Bandit security scan failed"
+            exit 1
+          fi
+          if [[ "${{ steps.pipaudit.outcome }}" != "success" ]]; then
+            echo "::error::pip-audit vulnerability scan failed"
+            exit 1
+          fi
+          echo "All checks passed!"
+
+      - name: Build wheel/sdist
+        shell: bash
+        run: uv build
+
+      - name: Verify wheel install in clean env
+        shell: bash
+        run: |
+          uv venv .venv_wheel
+          . .venv_wheel/bin/activate 2>/dev/null || . .venv_wheel/Scripts/activate 2>/dev/null
+          uv pip install dist/*.whl
+          "$CLI_BIN" --version 2>/dev/null || python -m "$PACKAGE_MODULE" --version
+
+      - name: Prune uv cache
+        continue-on-error: true
+        shell: bash
+        run: uv cache prune --ci
+
+      - name: Save ruff cache
+        if: always() && steps.ruff-cache.outputs.cache-hit != 'true'
+        uses: actions/cache/save@v5
+        with:
+          path: .ruff_cache
+          key: ruff-${{ runner.os }}-py${{ matrix.python }}-${{ github.sha }}
+
+  pipx-uv:
+    name: pipx/uv verification (ubuntu)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.14"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          prune-cache: false
+
+      - name: Install tomli (Python < 3.11)
+        shell: bash
+        run: python -c "import tomllib" 2>/dev/null || uv pip install tomli --system
+
+      - name: Extract project metadata
+        shell: python
+        run: |
+          import os
+          try:
+              import tomllib
+          except ModuleNotFoundError:
+              import tomli as tomllib
+
+          with open('pyproject.toml', 'rb') as f:
+              data = tomllib.load(f)
+          project = data['project']['name']
+          module = project.replace('-', '_')
+          dash = project.replace('_', '-')
+          scripts = list(data['project'].get('scripts', {}).keys())
+          cli_bin = scripts[0] if scripts else dash
+
+          with open(os.environ['GITHUB_ENV'], 'a', encoding='utf-8') as env:
+              env.write(f"PROJECT_NAME={project}\n")
+              env.write(f"PACKAGE_MODULE={module}\n")
+              env.write(f"CLI_BIN={cli_bin}\n")
+
+      - name: Build wheel
+        run: uv build
+      - name: pipx install from wheel
+        run: |
+          uv pip install --system pipx
+          pipx ensurepath
+          export PATH="$HOME/.local/bin:$PATH"
+          pipx install dist/*.whl
+          "$CLI_BIN" --version
+
+      - name: uv tool install
+        run: |
+          export PATH="$HOME/.local/bin:$PATH"
+          uv tool install --force .
+          "$CLI_BIN" --version
+
+      - name: Prune uv cache
+        continue-on-error: true
+        run: uv cache prune --ci
+
+  notebooks:
+    name: Execute notebooks (ubuntu, Python 3.14)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.14"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          prune-cache: false
+
+      - name: Install notebook runner deps
+        run: |
+          uv pip install --system nbclient nbformat ipykernel jupyter_client
+          python -m ipykernel install --user --name python3 --display-name "Python 3"
+      - name: Execute Quickstart notebook
+        env:
+          PIP_DISABLE_PIP_VERSION_CHECK: "1"
+          PIP_NO_INPUT: "1"
+        run: |
+          python - << 'PY'
+          from pathlib import Path
+
+          import nbformat
+          from nbclient import NotebookClient
+
+          nb_path = Path('notebooks/Quickstart.ipynb')
+          if not nb_path.exists():
+              raise SystemExit(f"Notebook not found: {nb_path}")
+
+          notebook = nbformat.read(nb_path, as_version=4)
+          client = NotebookClient(
+              notebook,
+              timeout=900,
+              kernel_name='python3',
+              allow_errors=False,
+          )
+          client.execute()
+
+          out_path = Path('notebooks/Quickstart-executed.ipynb')
+          nbformat.write(notebook, out_path)
+          print(f"Executed notebook written to: {out_path}")
+          PY

lib_cli_exit_tools-2.2.4/.github/workflows/default_release_public.yml

@@ -0,0 +1,69 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch: {}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    env:
+      UV_LINK_MODE: "copy"
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.14'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          prune-cache: false
+
+      - name: Build artifacts
+        run: uv build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v6
+        with:
+          name: dist
+          path: dist/*
+
+      - name: Prune uv cache
+        continue-on-error: true
+        run: uv cache prune --ci
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+    steps:
+      - name: Verify PyPI token is set
+        run: |
+          if [ -z "${{ secrets.PYPI_API_TOKEN }}" ]; then
+            echo "::error title=Missing PyPI token::Set the PYPI_API_TOKEN secret in GitHub repository settings to enable PyPI publishing on releases."
+            echo "See: https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions"
+            exit 1
+          fi
+
+      - name: Download artifacts
+        uses: actions/download-artifact@v6
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          attestations: false
+          skip-existing: true

lib_cli_exit_tools-2.2.2/.github/workflows/release.yml → lib_cli_exit_tools-2.2.4/.github/workflows/release.yml_backup

@@ -44,7 +44,7 @@ jobs:
           attestations: false
           skip-existing: true
       - name: Upload artifacts
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: dist
           path: dist/*

{lib_cli_exit_tools-2.2.2 → lib_cli_exit_tools-2.2.4}/CHANGELOG.md

@@ -3,6 +3,29 @@
 All notable changes to this project are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [2.2.4] - 2026-01-26
+
+### Changed
+- Updated dependencies.
+- Excluded `scripts/` from pyright, pytest, and CI/CD test collection.
+
+## [2.2.3] - 2025-12-17
+
+### Fixed
+- Corrected README examples to use `rich_click` instead of plain `click` for consistency with library internals.
+- Fixed Example 2 (cli_session) to avoid nested `run_cli` calls.
+- Fixed Example 3 (multi-command CLI) so `--traceback` flag actually controls traceback display.
+- Added missing blank line in Example 4 (custom signal handlers).
+- Updated `print_exception_message` API reference signature to show `trace_back=None` default.
+
+### Changed
+- Updated CLAUDE.md with correct `docs/system-design/` path and added missing `python_data_architecture_enforcement.md` guideline.
+- Removed irrelevant Documentation & Translations section from CLAUDE.md.
+- Updated INSTALL.md to list all three console script entry points consistently.
+
+### Security
+- Added filelock CVE-2025-68146 to pip-audit ignore list (transitive dev dependency, fix pending upstream).
+
 ## [2.2.2] - 2025-12-12
 
 ### Changed

lib_cli_exit_tools-2.2.4/CLAUDE.md

@@ -0,0 +1,164 @@
+# Claude Code Guidelines for lib_cli_exit_tools
+
+## Session Initialization
+
+When starting a new session, read and apply the following system prompt files from `/media/srv-main-softdev/projects/softwarestack/systemprompts`:
+
+### Core Guidelines (Always Apply)
+- `core_programming_solid.md`
+
+### Bash-Specific Guidelines
+When working with Bash scripts:
+- `core_programming_solid.md`
+- `bash_clean_architecture.md`
+- `bash_clean_code.md`
+- `bash_small_functions.md`
+
+### Python-Specific Guidelines
+When working with Python code:
+- `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_data_architecture_enforcement.md`
+
+### Additional Guidelines
+- `self_documenting.md`
+- `self_documenting_template.md`
+- `python_jupyter_notebooks.md`
+- `python_testing.md`
+
+## Project Structure
+
+```
+lib_cli_exit_tools/
+├── .github/
+│   └── workflows/              # GitHub Actions CI/CD workflows
+├── .devcontainer/              # Dev container configuration
+├── docs/                       # Project documentation
+│   └── system-design/          # System design documents
+├── notebooks/                  # Jupyter notebooks for experiments
+├── scripts/                    # Build and automation scripts
+│   ├── __init__.py            # Package marker
+│   ├── __main__.py            # Module entry point
+│   ├── _utils.py              # Shared utilities
+│   ├── build.py               # Build wheel/sdist
+│   ├── bump.py                # Version bump (generic)
+│   ├── bump_major.py          # Bump major version
+│   ├── bump_minor.py          # Bump minor version
+│   ├── bump_patch.py          # Bump patch version
+│   ├── bump_version.py        # Version bump utilities
+│   ├── clean.py               # Clean build artifacts
+│   ├── cli.py                 # CLI for scripts
+│   ├── dependencies.py        # Dependency management
+│   ├── dev.py                 # Development install
+│   ├── help.py                # Show help
+│   ├── install.py             # Install package
+│   ├── menu.py                # Interactive TUI menu
+│   ├── push.py                # Git push
+│   ├── release.py             # Create releases
+│   ├── run_cli.py             # Run CLI
+│   ├── target_metadata.py     # Metadata generation
+│   ├── test.py                # Run tests with coverage
+│   ├── toml_config.py         # TOML configuration utilities
+│   └── version_current.py     # Print current version
+├── src/
+│   └── lib_cli_exit_tools/    # Main Python package
+│       ├── __init__.py        # Package initialization
+│       ├── __init__conf__.py  # Configuration constants
+│       ├── __main__.py        # CLI entry point
+│       ├── cli.py             # CLI implementation
+│       ├── lib_cli_exit_tools.py  # Core library functions
+│       ├── py.typed           # PEP 561 marker
+│       ├── adapters/          # Adapter layer
+│       │   └── signals.py     # Signal handling adapters
+│       ├── application/       # Application layer
+│       │   └── runner.py      # Application runner
+│       └── core/              # Core domain layer
+│           ├── configuration.py  # Configuration management
+│           └── exit_codes.py     # Exit code definitions
+├── tests/                     # Test suite
+├── .env.example               # Example environment variables
+├── CLAUDE.md                  # Claude Code guidelines (this file)
+├── CHANGELOG.md               # Version history
+├── CONTRIBUTING.md            # Contribution guidelines
+├── DEVELOPMENT.md             # Development setup guide
+├── INSTALL.md                 # Installation instructions
+├── LICENSE                    # MIT License
+├── Makefile                   # Make targets for common tasks
+├── pyproject.toml             # Project metadata & dependencies
+├── codecov.yml                # Codecov configuration
+└── README.md                  # Project overview
+```
+
+## Versioning & Releases
+
+- **Single Source of Truth**: Package version is in `pyproject.toml` (`[project].version`)
+- **Version Bumps**: update `pyproject.toml`, `CHANGELOG.md` and update the constants in `src/lib_cli_exit_tools/__init__conf__.py` according to `pyproject.toml`
+    - Automation rewrites `src/lib_cli_exit_tools/__init__conf__.py` from `pyproject.toml`, so runtime code imports generated constants instead of querying `importlib.metadata`.
+    - After updating project metadata (version, summary, URLs, authors) run `make test` (or `python -m scripts.test`) to regenerate the metadata module before committing.
+- **Release Tags**: Format is `vX.Y.Z` (push tags for CI to build and publish)
+
+## Common Make Targets
+
+| Target            | Description                                                                     |
+|-------------------|---------------------------------------------------------------------------------|
+| `build`           | Build wheel/sdist artifacts                                                     |
+| `bump`            | Bump version (VERSION=X.Y.Z or PART=major\|minor\|patch) and update changelog  |
+| `bump-major`      | Increment major version ((X+1).0.0)                                            |
+| `bump-minor`      | Increment minor version (X.Y.Z → X.(Y+1).0)                                    |
+| `bump-patch`      | Increment patch version (X.Y.Z → X.Y.(Z+1))                                    |
+| `clean`           | Remove caches, coverage, and build artifacts (includes `dist/` and `build/`)   |
+| `dev`             | Install package with dev extras                                                |
+| `help`            | Show make targets                                                              |
+| `install`         | Editable install                                                               |
+| `menu`            | Interactive TUI menu                                                           |
+| `push`            | Commit changes and push to GitHub (no CI monitoring)                           |
+| `release`         | Tag vX.Y.Z, push, sync packaging, run gh release if available                  |
+| `run`             | Run module entry (`python -m ... --help`)                                      |
+| `test`            | Lint, format, type-check, run tests with coverage, upload to Codecov           |
+| `version-current` | Print current version from `pyproject.toml`                                    |
+
+## Coding Style & Naming Conventions
+
+Follow the guidelines in `python_clean_code.md` for all Python code.
+
+## Architecture Overview
+
+This library follows Clean Architecture with three layers:
+- **core/**: Domain layer with exit codes and configuration (no external dependencies)
+- **application/**: Application services and runners
+- **adapters/**: External interfaces (signal handling)
+
+Import rules (enforced by import-linter):
+- `core` cannot import from `application`, `adapters`, or `cli`
+- `application` cannot import from `cli`
+
+Apply principles from `python_clean_architecture.md` when designing and implementing features.
+
+## Security & Configuration
+
+- `.env` files are for local tooling only (CodeCov tokens, etc.)
+- **NEVER** commit secrets to version control
+- Rich logging should sanitize payloads before rendering
+
+## Commit & Push Policy
+
+### Pre-Push Requirements
+- **Always run `make test` before pushing** to avoid lint/test breakage
+- Ensure all tests pass and code is properly formatted
+
+### Post-Push Monitoring
+- Monitor GitHub Actions for errors after pushing
+- Attempt to correct any CI/CD errors that appear
+
+## Claude Code Workflow
+
+When working on this project:
+1. Read relevant system prompts at session start
+2. Apply appropriate coding guidelines based on file type
+3. Run `make test` before commits
+4. Follow versioning guidelines for releases
+5. Monitor CI after pushing changes

{lib_cli_exit_tools-2.2.2 → lib_cli_exit_tools-2.2.4}/INSTALL.md

@@ -126,8 +126,9 @@ We distribute via PyPI only. If you prefer isolated CLI installs, use tools such
 
 After installation the following commands should resolve:
 
-- `lib_cli_exit_tools`
-- `cli-exit-tools`
+- `lib-cli-exit-tools` (default console script)
+- `lib_cli_exit_tools` (alias)
+- `cli-exit-tools` (alias)
 - `python -m lib_cli_exit_tools`
 
 If you installed inside a virtual environment, activate it before running the commands. For user installs, ensure the relevant `bin`/`Scripts` directory is included in your PATH: