Merge pull request 'release: 0.2.3 prep — index verification script, changelog' (#15) from release/0.2.3-prep into develop

Reviewed-on: https://git.zavage.net/Zavage-Software/app_skellington/pulls/15

CHANGELOG.md

@@ -1,6 +1,23 @@
 # Changelog
 
-## [0.2.2] (2020-07-19)
+## [0.2.3]
+
+Hotfix. In 0.2.2, `import app_skellington` raised
+`ImportError: cannot import name 'NoCommandSpecified' from partially initialized module`
+(a circular import) for every install.
+
+ * Fix the circular import between `cli` and `app_container`. The framework
+   exceptions now live in `_util`, and the public names are unchanged.
+ * Tested on Linux, CPython 3.8–3.14 (Gitea CI). Each version builds the wheel
+   and sdist, installs them and smoke-tests the import.
+ * Tooling: ruff replaces black/isort/flake8; uv with a committed lockfile.
+ * Removed the `[dev]` extra: `pip install app_skellington[dev]` no longer
+   installs dev tools. Contributors use `uv sync` (a PEP 735 dependency group).
+ * Metadata: license classifier corrected to MIT-0; Python version classifiers
+   added; "OS Independent" replaced by Linux (Windows and macOS untested).
+ * README: the debug variable is `APPSKELLINGTON_DEBUG`.
+
+## [0.2.2] (2024-11-17)
 
 Second release is focused on cleanup, documentation.
 

scripts/verify_index_release.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+# Install a published app_skellington from a package index into a clean venv
+# for every supported Python, then run scripts/smoke_import.py against it.
+#
+# Usage: scripts/verify_index_release.sh VERSION [INDEX_URL]
+#   INDEX_URL defaults to TestPyPI. Dependencies always come from PyPI,
+#   because TestPyPI hosts junk uploads under real dependency names.
+set -euo pipefail
+
+version="${1:?usage: $0 VERSION [INDEX_URL]}"
+index="${2:-https://test.pypi.org/simple/}"
+here="$(cd "$(dirname "$0")" && pwd)"
+pythons=(3.8 3.9 3.10 3.11 3.12 3.13 3.14)
+
+# The package must come from $index and nowhere else. Otherwise a local
+# build could pass for the published release. --no-config ignores
+# uv.toml/pyproject settings; these variables would still redirect, so refuse.
+for var in UV_INDEX UV_INDEX_URL UV_DEFAULT_INDEX UV_EXTRA_INDEX_URL \
+  UV_FIND_LINKS UV_INDEX_STRATEGY UV_NO_INDEX PIP_INDEX_URL \
+  PIP_EXTRA_INDEX_URL PIP_FIND_LINKS; do
+  if [ -n "${!var:-}" ]; then
+    echo "refusing: $var is set and could redirect the install away from $index" >&2
+    exit 2
+  fi
+done
+
+work="$(mktemp -d)"
+trap 'rm -rf "$work"' EXIT
+
+for py in "${pythons[@]}"; do
+  venv="$work/$py"
+  uv venv -q --no-config --python "$py" "$venv"
+  # Wheel only: an sdist fallback would fetch its build backend from $index
+  # (TestPyPI). Not quiet, so the log shows what was installed.
+  uv pip install --no-config --python "$venv" --no-cache --no-deps \
+    --only-binary :all: --index-url "$index" "app_skellington==$version"
+  "$venv/bin/python" -c 'import importlib.metadata as m; print("\n".join(m.requires("app_skellington") or []))' \
+    > "$work/requirements.txt"
+  uv pip install -q --no-config --python "$venv" -r "$work/requirements.txt"
+  (cd / && "$venv/bin/python" "$here/smoke_import.py" "$version")
+done
+
+echo "verified app_skellington==$version from $index on: ${pythons[*]}"

tests/test_ci_workflow.py

@@ -4,7 +4,6 @@
 import pathlib
 import re
 
-import pytest
 import yaml
 
 ROOT = pathlib.Path(__file__).resolve().parent.parent
@@ -95,7 +94,6 @@ def test_classifiers_match_matrix():
     assert claimed == expected_versions()
 
 
-@pytest.mark.skipif(not VERIFY_SCRIPT.exists(), reason="added with the release task")
 def test_verify_script_covers_matrix():
     match = re.search(r"^pythons=\(([^)]*)\)", VERIFY_SCRIPT.read_text(), re.M)
     assert match.group(1).split() == expected_versions()