compiletools 8.2.2__tar.gz → 8.3.0__tar.gz

{compiletools-8.2.2 → compiletools-8.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: compiletools
-Version: 8.2.2
+Version: 8.3.0
 Summary: Tools to make compiling C/C++ projects easy
 Keywords: c++,make,development
 Author: DrGeoff
@@ -17,24 +17,29 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Dist: configargparse>=1.5.3
 Requires-Dist: appdirs>=1.4.4
-Requires-Dist: psutil>=5.9.0
 Requires-Dist: rich>=12.0.0
 Requires-Dist: rich-rst>=1.1.7
 Requires-Dist: stringzilla>=3.0.0
 Requires-Dist: bump-my-version>=0.26.0 ; extra == 'dev'
-Requires-Dist: twine>=5.0.0 ; extra == 'dev'
-Requires-Dist: pytest>=8.2.2 ; extra == 'dev'
+Requires-Dist: pytest>=8.3.0 ; extra == 'dev'
 Requires-Dist: pytest-xdist>=3.5 ; extra == 'dev'
 Requires-Dist: ruff>=0.14.0 ; extra == 'dev'
 Requires-Dist: pyright>=1.1 ; extra == 'dev'
 Requires-Dist: pre-commit>=4.0 ; extra == 'dev'
 Requires-Dist: pytest-cov>=6.0 ; extra == 'dev'
 Requires-Dist: textual>=0.40.0 ; extra == 'dev'
+Requires-Dist: sphinx>=7 ; extra == 'docs'
+Requires-Dist: furo ; extra == 'docs'
+Requires-Dist: sphinx-copybutton ; extra == 'docs'
+Requires-Dist: tomli ; python_full_version < '3.11' and extra == 'docs'
+Requires-Dist: twine>=5.0.0 ; extra == 'release'
 Requires-Dist: textual>=0.40.0 ; extra == 'tui'
 Requires-Python: >=3.10
 Project-URL: Download, https://github.com/DrGeoff/compiletools/archive/v{version}.tar.gz
 Project-URL: Homepage, http://drgeoff.github.io/compiletools/
 Provides-Extra: dev
+Provides-Extra: docs
+Provides-Extra: release
 Provides-Extra: tui
 Description-Content-Type: text/x-rst
 
@@ -55,7 +60,7 @@ C/C++ build tools that requires almost no configuration.
 
 :Author: drgeoffathome@gmail.com
 :Date:   2025-12-17
-:Version: 8.2.2
+:Version: 8.3.0
 :Manual section: 1
 :Manual group: developers
 
@@ -211,6 +216,7 @@ SEE ALSO
 ========
 * ct-backends (7) -- build backend architecture and selection guide
 * ct-build
+* ct-build-docs
 * ct-build-dynamic-library
 * ct-build-static-library
 * ct-cake

{compiletools-8.2.2 → compiletools-8.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "compiletools"
-version = "8.2.2"
+version = "8.3.0"
 description = "Tools to make compiling C/C++ projects easy"
 readme = "src/compiletools/README.ct-doc.rst"
 requires-python = ">=3.10"
@@ -23,7 +23,6 @@ classifiers = [
 dependencies = [
     "configargparse>=1.5.3",
     "appdirs>=1.4.4",
-    "psutil>=5.9.0",
     "rich>=12.0.0",
     "rich_rst>=1.1.7",
     "stringzilla>=3.0.0",
@@ -35,8 +34,7 @@ tui = [
 ]
 dev = [
     "bump-my-version>=0.26.0",
-    "twine>=5.0.0",
-    "pytest>=8.2.2",
+    "pytest>=8.3.0",
     "pytest-xdist>=3.5",
     "ruff>=0.14.0",
     "pyright>=1.1",
@@ -44,6 +42,15 @@ dev = [
     "pytest-cov>=6.0",
     "textual>=0.40.0",
 ]
+release = [
+    "twine>=5.0.0",
+]
+docs = [
+    "sphinx>=7",
+    "furo",
+    "sphinx-copybutton",
+    "tomli; python_version < '3.11'",
+]
 
 [project.urls]
 Homepage = "http://drgeoff.github.io/compiletools/"
@@ -96,7 +103,7 @@ include = [
 ]
 
 [tool.bumpversion]
-current_version = "8.2.2"
+current_version = "8.3.0"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
 serialize = ["{major}.{minor}.{patch}"]
 search = "{current_version}"

compiletools-8.3.0/scripts/ct-build-docs

@@ -0,0 +1,52 @@
+#!/usr/bin/bash
+set -euo pipefail
+
+SCRIPT_NAME=$(basename "$0")
+
+# Find README: check installed location first, then development location
+if [[ -f "/usr/share/doc/compiletools/README.${SCRIPT_NAME}.rst" ]]; then
+    README_PATH="/usr/share/doc/compiletools/README.${SCRIPT_NAME}.rst"
+else
+    README_PATH="$(dirname "$(readlink -f "$0")")/../src/compiletools/README.${SCRIPT_NAME}.rst"
+fi
+
+show_help() {
+    echo "Usage: ${SCRIPT_NAME}"
+    echo ""
+    if [[ -f "$README_PATH" ]]; then
+        cat "$README_PATH"
+    else
+        echo "No documentation available for ${SCRIPT_NAME}"
+        echo "See: https://github.com/DrGeoff/compiletools"
+    fi
+    exit 0
+}
+
+for arg in "$@"; do
+    case "$arg" in
+        --help|-h) show_help ;;
+    esac
+done
+
+# Ensure sphinx-build is available
+if ! command -v sphinx-build >/dev/null 2>&1; then
+    echo "Error: sphinx-build not found." >&2
+    echo "Install the [docs] extra:" >&2
+    echo "    uv pip install -e \".[docs]\"" >&2
+    exit 1
+fi
+
+REPO_ROOT="$(git -C "$(dirname "$(readlink -f "$0")")" rev-parse --show-toplevel)"
+DOCS_SRC="${REPO_ROOT}/docs"
+DOCS_OUT="${REPO_ROOT}/docs/_build/html"
+
+if [[ ! -f "${DOCS_SRC}/conf.py" ]]; then
+    echo "Error: ${DOCS_SRC}/conf.py not found" >&2
+    exit 1
+fi
+
+echo "Building docs from ${DOCS_SRC} -> ${DOCS_OUT}"
+sphinx-build -W -b html "${DOCS_SRC}" "${DOCS_OUT}"
+
+echo ""
+echo "Done. Open: ${DOCS_OUT}/index.html"

compiletools-8.3.0/scripts/ct-pytest-monitor

@@ -0,0 +1,171 @@
+#!/usr/bin/env bash
+# ct-pytest-monitor -- run pytest with crash-survivable diagnostics.
+#
+# On constrained devices (notably Termux on Android), the kernel OOM-killer
+# can SIGKILL the entire shell mid-test. This script monitors test progress
+# and host memory and writes both to disk -- before each kill arrives -- so
+# post-mortem inspection can identify the offending test and the memory
+# pressure leading up to it. It does NOT retry crashed runs or stress the
+# system; it is a single pytest invocation with durable side channels.
+#
+# What gets written to the log directory:
+#
+#   checkpoint.log -- one line per test, fsync'd BEFORE the test body runs.
+#                     The last line is the test that was running when the
+#                     kernel killed us.
+#   pytest.log     -- full unbuffered pytest output (verbose).
+#   meminfo.log    -- /proc/meminfo + top RSS consumers, sampled periodically.
+#   system.log     -- one-shot snapshot of host state at startup.
+#   summary.log    -- post-run summary (last test seen, final memory state).
+#
+# Run from anywhere; the script auto-detects the repo root from its own
+# location.
+set -euo pipefail
+
+SCRIPT_NAME=$(basename "$0")
+SCRIPT_DIR=$(cd "$(dirname "$(readlink -f "$0")")" && pwd)
+REPO_ROOT=$(cd "$SCRIPT_DIR/.." && pwd)
+
+if [[ -f "/usr/share/doc/compiletools/README.${SCRIPT_NAME}.rst" ]]; then
+    README_PATH="/usr/share/doc/compiletools/README.${SCRIPT_NAME}.rst"
+else
+    README_PATH="${REPO_ROOT}/src/compiletools/README.${SCRIPT_NAME}.rst"
+fi
+
+# ---------- options --------------------------------------------------------
+
+LOG_DIR=""
+INTERVAL=2
+PYTEST_ARGS=()
+
+show_help() {
+    echo "Usage: ${SCRIPT_NAME} [--logdir DIR] [--interval SECONDS] [-h|--help] [-- pytest args...]"
+    echo ""
+    if [[ -f "$README_PATH" ]]; then
+        cat "$README_PATH"
+    else
+        echo "No documentation available for ${SCRIPT_NAME}"
+        echo "See: https://github.com/drgeoffathome/compiletools"
+    fi
+    exit 0
+}
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --logdir)   LOG_DIR="$2"; shift 2 ;;
+        --interval) INTERVAL="$2"; shift 2 ;;
+        -h|--help)  show_help ;;
+        --)         shift; PYTEST_ARGS+=("$@"); break ;;
+        *)          PYTEST_ARGS+=("$1"); shift ;;
+    esac
+done
+
+# ---------- log dir --------------------------------------------------------
+
+if [[ -z "$LOG_DIR" ]]; then
+    LOG_DIR="${TMPDIR:-/tmp}/ct-pytest-monitor-$(date +%Y%m%d-%H%M%S)"
+fi
+mkdir -p "$LOG_DIR"
+LOG_DIR=$(cd "$LOG_DIR" && pwd)
+
+CHECKPOINT_LOG="${LOG_DIR}/checkpoint.log"
+PYTEST_LOG="${LOG_DIR}/pytest.log"
+MEMINFO_LOG="${LOG_DIR}/meminfo.log"
+SYSTEM_LOG="${LOG_DIR}/system.log"
+SUMMARY_LOG="${LOG_DIR}/summary.log"
+
+: > "$CHECKPOINT_LOG"
+: > "$PYTEST_LOG"
+: > "$MEMINFO_LOG"
+
+# ---------- one-shot system snapshot ---------------------------------------
+
+{
+    echo "=== ct-pytest-monitor started at $(date -Is) ==="
+    echo "=== uname -a ==="
+    uname -a
+    if [[ -n "${TERMUX_VERSION:-}" ]]; then
+        echo "=== TERMUX_VERSION=${TERMUX_VERSION} ==="
+    fi
+    echo "=== /proc/meminfo (initial) ==="
+    cat /proc/meminfo 2>/dev/null || echo "/proc/meminfo not available"
+    echo "=== free -h ==="
+    free -h 2>/dev/null || true
+    echo "=== python ==="
+    python --version 2>&1 || true
+    echo "=== pytest ==="
+    python -m pytest --version 2>&1 || true
+    echo "=== argv ==="
+    printf '%q ' "${PYTEST_ARGS[@]}"
+    echo
+} > "$SYSTEM_LOG"
+
+# ---------- background memory sampler --------------------------------------
+#
+# Each iteration opens, writes, and closes the log so a hard kill leaves the
+# file flushed up to the last completed sample.
+
+sampler_loop() {
+    while :; do
+        {
+            echo "--- $(date -Is) ---"
+            grep -E '^(MemTotal|MemFree|MemAvailable|Buffers|Cached|SwapTotal|SwapFree|AnonPages|Active|Inactive):' \
+                /proc/meminfo 2>/dev/null || true
+            echo "--- top RSS consumers (pid rss_kb cmd) ---"
+            ps -eo pid,rss,comm --no-headers 2>/dev/null | sort -k2 -nr | head -10 || true
+        } >> "$MEMINFO_LOG"
+        sleep "$INTERVAL"
+    done
+}
+
+sampler_loop &
+SAMPLER_PID=$!
+
+# ---------- cleanup --------------------------------------------------------
+
+cleanup() {
+    local exit_code=$?
+    if kill -0 "$SAMPLER_PID" 2>/dev/null; then
+        kill "$SAMPLER_PID" 2>/dev/null || true
+        wait "$SAMPLER_PID" 2>/dev/null || true
+    fi
+    {
+        echo "=== ct-pytest-monitor ended at $(date -Is) (exit ${exit_code}) ==="
+        echo "=== last test seen (checkpoint tail) ==="
+        tail -n 5 "$CHECKPOINT_LOG" 2>/dev/null || true
+        echo "=== last 20 lines of pytest.log ==="
+        tail -n 20 "$PYTEST_LOG" 2>/dev/null || true
+        echo "=== final /proc/meminfo ==="
+        cat /proc/meminfo 2>/dev/null || true
+    } > "$SUMMARY_LOG"
+    cat <<EOF
+
+ct-pytest-monitor logs in: ${LOG_DIR}
+  checkpoint.log -- last line = test running when shell died
+  pytest.log     -- full pytest output
+  meminfo.log    -- memory snapshots every ${INTERVAL}s
+  system.log     -- initial state
+  summary.log    -- end-of-run summary
+
+If the shell was SIGKILLed: tail -n1 "${CHECKPOINT_LOG}"
+EOF
+    exit "$exit_code"
+}
+trap cleanup EXIT INT TERM
+
+# ---------- run pytest -----------------------------------------------------
+
+cd "$REPO_ROOT"
+
+export CT_PYTEST_CHECKPOINT="$CHECKPOINT_LOG"
+export PYTHONUNBUFFERED=1
+
+# `stdbuf -oL -eL` keeps tee's input line-buffered so each line reaches the
+# log file as soon as pytest emits it. Lines that pass through tee may still
+# be lost on SIGKILL if they sit in tee's userspace buffer; the checkpoint
+# file (fsync'd by the conftest hook) is the authoritative crash record.
+if command -v stdbuf >/dev/null 2>&1; then
+    stdbuf -oL -eL python -u -m pytest -v "${PYTEST_ARGS[@]}" 2>&1 | tee "$PYTEST_LOG"
+else
+    python -u -m pytest -v "${PYTEST_ARGS[@]}" 2>&1 | tee "$PYTEST_LOG"
+fi

compiletools-8.3.0/scripts/ct-termux-install

@@ -0,0 +1,282 @@
+#!/usr/bin/env bash
+# ct-termux-install -- bootstrap a compiletools dev environment on Termux.
+#
+# Performs the recipe documented in INSTALL section 6:
+#   1. install required Termux pkgs (clang, nodejs, ruff, uv, git, ...)
+#   2. create a venv if missing
+#   3. install stringzilla with the clang-21+ CFLAGS workaround
+#   4. install compiletools (editable) and dev tooling, EXCLUDING ruff
+#      (ruff is satisfied by the Termux pkg; building it from sdist via
+#      cargo OOM-kills the device at the LTO link stage)
+#
+# Run from anywhere; the script auto-detects the repo root from its own
+# location.
+set -euo pipefail
+
+SCRIPT_NAME=$(basename "$0")
+SCRIPT_DIR=$(cd "$(dirname "$(readlink -f "$0")")" && pwd)
+REPO_ROOT=$(cd "$SCRIPT_DIR/.." && pwd)
+
+# Find README: check installed location first, then development location.
+if [[ -f "/usr/share/doc/compiletools/README.${SCRIPT_NAME}.rst" ]]; then
+    README_PATH="/usr/share/doc/compiletools/README.${SCRIPT_NAME}.rst"
+else
+    README_PATH="${REPO_ROOT}/src/compiletools/README.${SCRIPT_NAME}.rst"
+fi
+
+# ---------- options --------------------------------------------------------
+
+SKIP_PKG=0
+SKIP_VENV=0
+DRY_RUN=0
+ASSUME_YES=0
+
+show_help() {
+    echo "Usage: ${SCRIPT_NAME} [--skip-pkg] [--skip-venv] [--dry-run] [-y|--yes] [-h|--help]"
+    echo ""
+    if [[ -f "$README_PATH" ]]; then
+        cat "$README_PATH"
+    else
+        echo "No documentation available for ${SCRIPT_NAME}"
+        echo "See: https://github.com/drgeoffathome/compiletools"
+    fi
+    exit 0
+}
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --skip-pkg)  SKIP_PKG=1 ;;
+        --skip-venv) SKIP_VENV=1 ;;
+        --dry-run)   DRY_RUN=1 ;;
+        -y|--yes)    ASSUME_YES=1 ;;
+        -h|--help)   show_help ;;
+        *)           echo "Error: unknown option: $1" >&2; exit 2 ;;
+    esac
+    shift
+done
+
+# ---------- helpers --------------------------------------------------------
+
+if [[ -t 1 ]]; then
+    C_RED=$'\033[31m'; C_GREEN=$'\033[32m'; C_YELLOW=$'\033[33m'
+    C_BOLD=$'\033[1m'; C_RESET=$'\033[0m'
+else
+    C_RED=''; C_GREEN=''; C_YELLOW=''; C_BOLD=''; C_RESET=''
+fi
+
+info()  { printf '%s==>%s %s\n' "$C_BOLD" "$C_RESET" "$*"; }
+warn()  { printf '%sWARN:%s %s\n' "$C_YELLOW" "$C_RESET" "$*" >&2; }
+err()   { printf '%sERROR:%s %s\n' "$C_RED" "$C_RESET" "$*" >&2; }
+ok()    { printf '%sOK%s   %s\n' "$C_GREEN" "$C_RESET" "$*"; }
+
+run() {
+    printf '    %s$%s %s\n' "$C_BOLD" "$C_RESET" "$*"
+    if [[ "$DRY_RUN" -eq 0 ]]; then
+        "$@"
+    fi
+}
+
+confirm() {
+    local prompt=$1 answer
+    if [[ "$ASSUME_YES" -eq 1 ]]; then
+        return 0
+    fi
+    read -rp "$prompt [y/N] " answer
+    [[ "${answer,,}" == y || "${answer,,}" == yes ]]
+}
+
+require_cmd() {
+    command -v "$1" >/dev/null 2>&1 || {
+        err "required command not found: $1"
+        exit 1
+    }
+}
+
+# ---------- preflight ------------------------------------------------------
+
+# Refuse to run anywhere except Termux: the recipe is Termux-specific and
+# would clobber a non-Termux dev environment with the wrong CFLAGS.
+if [[ -z "${TERMUX_VERSION-}" ]] && [[ ! -d /data/data/com.termux ]]; then
+    err "this script is Termux-only (no TERMUX_VERSION env var, no /data/data/com.termux dir)."
+    err "for other platforms, see INSTALL."
+    exit 1
+fi
+
+# Confirm we are sitting in a compiletools checkout.
+if [[ ! -f "$REPO_ROOT/pyproject.toml" ]]; then
+    err "cannot find $REPO_ROOT/pyproject.toml -- is this a compiletools checkout?"
+    exit 1
+fi
+if ! grep -q '^name = "compiletools"' "$REPO_ROOT/pyproject.toml"; then
+    err "$REPO_ROOT/pyproject.toml does not look like compiletools"
+    exit 1
+fi
+
+# Memory check: cargo+rustc routinely needs 3+GB; warn if very tight.
+if command -v free >/dev/null 2>&1; then
+    avail_mb=$(free -m | awk '/^Mem:/ {print $7}')
+    swap_mb=$(free -m  | awk '/^Swap:/ {print $4}')
+    avail_mb=${avail_mb:-0}
+    swap_mb=${swap_mb:-0}
+    if (( avail_mb + swap_mb < 2048 )); then
+        warn "low memory: ${avail_mb}MB available + ${swap_mb}MB free swap"
+        warn "stringzilla compile or pip resolution may OOM. Close other apps."
+        confirm "Continue anyway?" || { err "aborted by user"; exit 1; }
+    fi
+fi
+
+info "compiletools repo root: $REPO_ROOT"
+[[ "$DRY_RUN" -eq 1 ]] && info "DRY RUN -- no commands will be executed"
+
+# ---------- step 1: Termux pkgs --------------------------------------------
+
+# 'ruff' is essential here -- there is no aarch64-android wheel on PyPI,
+# and building from sdist uses cargo+rustc with -C lto=fat which OOMs.
+# 'nodejs' is needed by pyright at runtime.
+# 'clang' is needed to compile stringzilla.
+TERMUX_PKGS=(python clang nodejs ruff uv git)
+
+if [[ "$SKIP_PKG" -eq 1 ]]; then
+    info "skipping pkg install (--skip-pkg)"
+else
+    require_cmd pkg
+    info "installing Termux prerequisites: ${TERMUX_PKGS[*]}"
+    # 'pkg install' is idempotent; already-installed pkgs are no-ops.
+    run pkg install -y "${TERMUX_PKGS[@]}"
+fi
+
+# Whether or not we ran pkg install, the binaries we depend on must now exist.
+if [[ "$DRY_RUN" -eq 0 ]]; then
+    for cmd in clang node ruff uv git python3; do
+        require_cmd "$cmd"
+    done
+    ok "all required tools on PATH"
+fi
+
+# ---------- step 2: venv ---------------------------------------------------
+
+VENV_DIR="$REPO_ROOT/.venv"
+
+if [[ "$SKIP_VENV" -eq 1 ]]; then
+    info "skipping venv creation (--skip-venv)"
+    if [[ "$DRY_RUN" -eq 0 && ! -x "$VENV_DIR/bin/python" ]]; then
+        err "--skip-venv given but $VENV_DIR/bin/python is missing"
+        exit 1
+    fi
+elif [[ -x "$VENV_DIR/bin/python" ]]; then
+    info "reusing existing venv: $VENV_DIR"
+else
+    info "creating venv at $VENV_DIR"
+    run uv venv "$VENV_DIR"
+fi
+
+# Activate. The activation script is bash-compatible and only sets a few env
+# vars, so 'set -u' is fine after sourcing.
+# shellcheck source=/dev/null
+[[ "$DRY_RUN" -eq 0 ]] && source "$VENV_DIR/bin/activate"
+
+# Hardlinks across Termux's bind-mounted home don't always work; copy mode is
+# safe and only marginally slower.
+export UV_LINK_MODE=copy
+
+# ---------- step 3: stringzilla --------------------------------------------
+
+# Clang 21+ promotes two stringzilla source issues from warnings to errors:
+# incompatible function pointer types in the CPython slot tables, and
+# const-discarding free()/realloc()/munmap() calls. Downgrading them keeps
+# the build going; the wheel is functionally correct.
+STRINGZILLA_CFLAGS=(
+    "-Wno-error=incompatible-function-pointer-types"
+    "-Wno-error=incompatible-pointer-types"
+    "-Wno-error=incompatible-pointer-types-discards-qualifiers"
+    "-Wno-incompatible-function-pointer-types"
+)
+
+if [[ "$DRY_RUN" -eq 0 ]] && python -c 'import stringzilla' 2>/dev/null; then
+    sz_ver=$(python -c 'import stringzilla; print(stringzilla.__version__)')
+    info "stringzilla already installed (${sz_ver}); skipping rebuild"
+else
+    info "installing stringzilla with clang-21 CFLAGS workaround"
+    # CFLAGS only need to be live for stringzilla's compile. Save+restore
+    # any pre-existing parent-shell value so we don't clobber it (`unset`
+    # would drop it entirely rather than restoring it).
+    if [[ -v CFLAGS ]]; then
+        _saved_cflags="$CFLAGS"
+        _had_cflags=1
+    else
+        _had_cflags=0
+    fi
+    export CFLAGS="${STRINGZILLA_CFLAGS[*]}"
+    run uv pip install "stringzilla>=4.6.0"
+    if [[ "$_had_cflags" -eq 1 ]]; then
+        export CFLAGS="$_saved_cflags"
+    else
+        unset CFLAGS
+    fi
+    unset _saved_cflags _had_cflags
+fi
+
+# ---------- step 4: compiletools + dev tooling -----------------------------
+
+info "installing compiletools (editable, runtime deps only)"
+run uv pip install -e "$REPO_ROOT"
+
+# DEV deps minus ruff. Ruff is provided by the Termux pkg installed in
+# step 1; do not let pip try to build it from sdist (cargo OOM).
+DEV_PKGS=(
+    bump-my-version
+    pytest
+    pytest-xdist
+    pytest-cov
+    pyright
+    pre-commit
+    textual
+)
+
+info "installing dev tooling (excluding ruff): ${DEV_PKGS[*]}"
+run uv pip install "${DEV_PKGS[@]}"
+
+# ---------- verify ---------------------------------------------------------
+
+if [[ "$DRY_RUN" -eq 1 ]]; then
+    ok "dry run complete"
+    exit 0
+fi
+
+info "verifying install"
+
+verify_failed=0
+verify() {
+    local label=$1
+    shift
+    if "$@" >/dev/null 2>&1; then
+        ok "$label"
+    else
+        err "$label FAILED: $*"
+        verify_failed=1
+    fi
+}
+
+verify "stringzilla import"   python -c 'import stringzilla; assert stringzilla.hash(b"abc") != 0'
+verify "compiletools import"  python -c 'import compiletools'
+verify "ruff on PATH"         ruff --version
+verify "pre-commit installed" pre-commit --version
+verify "pytest installed"     pytest --version
+verify "pyright installed"    pyright --version
+
+if [[ "$verify_failed" -ne 0 ]]; then
+    err "one or more verification steps failed; see messages above"
+    exit 1
+fi
+
+cat <<EOF
+
+${C_GREEN}${C_BOLD}Termux dev install complete.${C_RESET}
+
+  Activate the venv:    source $VENV_DIR/bin/activate
+  Install hooks:        pre-commit install
+  Run tests:            pytest -n auto
+
+Note: ruff lives on the system PATH (Termux pkg), not inside the venv.
+Pre-commit hooks and 'ruff check src/compiletools/' will find it normally.
+EOF

{compiletools-8.2.2 → compiletools-8.3.0}/src/compiletools/README.cleanup-remote-locks.rst

@@ -8,7 +8,7 @@ Legacy helper for pruning stale lockdir directories remotely
 
 :Author: drgeoffathome@gmail.com
 :Date:   2025-11-26
-:Version: 8.2.2
+:Version: 8.3.0
 :Manual section: 1
 :Manual group: developers
 

{compiletools-8.2.2 → compiletools-8.3.0}/src/compiletools/README.create-documentation.rst

@@ -8,7 +8,7 @@ Generate man(1) pages from the reStructuredText source tree
 
 :Author: drgeoffathome@gmail.com
 :Date:   2025-11-26
-:Version: 8.2.2
+:Version: 8.3.0
 :Manual section: 1
 :Manual group: developers
 

{compiletools-8.2.2 → compiletools-8.3.0}/src/compiletools/README.ct-backends.rst

@@ -8,7 +8,7 @@ Build backend architecture and selection guide
 
 :Author: drgeoffathome@gmail.com
 :Date:   2026-04-02
-:Version: 8.2.2
+:Version: 8.3.0
 :Manual section: 7
 :Manual group: developers