Adopt PEP 723 script metadata, uv build, and a .python-version file

Author: tpvasconcelos

.python-version

@@ -0,0 +1 @@
+3.10

MANIFEST.in

@@ -2,6 +2,7 @@
 include Makefile
 include .coveragerc
 include .editorconfig
+include .python-version
 include *.cfg
 include *.ini
 include *.md

cicd_utils/cicd/scripts/extract_latest_release_notes.py

@@ -1,4 +1,18 @@
-#!/usr/bin/env python
+#!/usr/bin/env -S uv run --script
+# /// script
+# requires-python = ">=3.10"
+# dependencies = [
+#     "markdown-it-py",
+#     "mdit-py-plugins",
+#     "mdformat",
+#     "mdformat-footnote",
+# ]
+# ///
+# NOTE: The PEP 723 inline metadata above is used when running this
+#       script standalone (e.g. via `uv run` or the `release-notes`
+#       tox env). The same dependencies are also declared in the
+#       `cicd_utils` dependency group in pyproject.toml, which is
+#       needed for the unit tests that import this module.
 """Extract the latest release notes
 
 Execution steps:

pyproject.toml

@@ -64,7 +64,10 @@ cicd_utils = [
     #       manylinux2014_armv7l wheel, which breaks universal
     #       (multi-platform) resolution with `uv sync`/`uv lock`
     "kaleido<0.4,!=0.2.1.post1",
-    # ./cicd_utils/cicd/scripts/extract_latest_release_notes.py
+    # Deps for ./cicd_utils/cicd/scripts/extract_latest_release_notes.py
+    # NOTE: these are also declared in the script's PEP 723 inline
+    #       metadata (used by `uv run`); they are duplicated here so
+    #       that the unit tests can import the script's module
     "markdown-it-py",
     "mdit-py-plugins",
     "mdformat",

tests/cicd_utils/test_scripts/test_scripts_are_executable.py

@@ -26,4 +26,6 @@ def test_py_scripts_are_executable(script_path: Path) -> None:
 def test_py_scripts_have_py_shebang(script_path: Path) -> None:
     with script_path.open("r") as f:
         first_line = f.readline()
-    assert first_line.startswith("#!/usr/bin/env python")
+    # Scripts are either run directly with python or, when they declare
+    # PEP 723 inline metadata, through `uv run --script`
+    assert first_line.startswith(("#!/usr/bin/env python", "#!/usr/bin/env -S uv run --script"))

tox.ini

@@ -103,16 +103,17 @@ commands =
 [testenv:release-notes]
 description = extract release notes from docs/reference/changelog.md
 skip_install = true
-dependency_groups = cicd_utils
-commands = python cicd_utils/cicd/scripts/extract_latest_release_notes.py
+allowlist_externals = uv
+# The script's dependencies are declared as PEP 723 inline metadata,
+# which `uv run` resolves into an isolated (cached) script environment
+commands = uv run --no-project --script cicd_utils/cicd/scripts/extract_latest_release_notes.py
 
 [testenv:build-dists]
 description = build source (sdist) and binary (wheel) distributions
-deps =
-    build
-    twine
-allowlist_externals = rm
+skip_install = true
+deps = twine
+allowlist_externals = rm, uv
 commands =
     rm -rf dist/
-    python -m build
+    uv build
     twine check --strict dist/*