Repaint the scaffolding.

Author: Julian

.github/workflows/ci.yml

@@ -59,6 +59,17 @@ jobs:
       - name: Install dependencies
         run: brew install enchant
         if: runner.os == 'macOS' && startsWith(matrix.noxenv, 'docs')
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: |
+            3.8
+            3.9
+            3.10
+            3.11
+            3.12
+            pypy3.10
+          allow-prereleases: true
       - name: Set up nox
         uses: wntrblm/nox@2023.04.22
       - name: Run nox

noxfile.py

@@ -9,25 +9,35 @@
 DOCS = ROOT / "docs"
 PACKAGE = ROOT / "referencing"
 
+REQUIREMENTS = dict(
+    docs=DOCS / "requirements.txt",
+    tests=ROOT / "test-requirements.txt",
+)
+REQUIREMENTS_IN = [  # this is actually ordered, as files depend on each other
+    path.parent / f"{path.stem}.in" for path in REQUIREMENTS.values()
+]
+
+SUPPORTED = ["3.8", "3.9", "3.10", "3.11", "3.12", "pypy3.10"]
+LATEST = "3.12"
 
 nox.options.sessions = []
 
 
-def session(default=True, **kwargs):  # noqa: D103
+def session(default=True, python=LATEST, **kwargs):  # noqa: D103
     def _session(fn):
         if default:
             nox.options.sessions.append(kwargs.get("name", fn.__name__))
-        return nox.session(**kwargs)(fn)
+        return nox.session(python=python, **kwargs)(fn)
 
     return _session
 
 
-@session(python=["3.8", "3.9", "3.10", "3.11", "pypy3"])
+@session(python=SUPPORTED)
 def tests(session):
     """
     Run the test suite with a corresponding Python version.
     """
-    session.install("-r", ROOT / "test-requirements.txt")
+    session.install("-r", REQUIREMENTS["tests"])
 
     if session.posargs and session.posargs[0] == "coverage":
         if len(session.posargs) > 1 and session.posargs[1] == "github":
@@ -109,7 +119,7 @@ def docs(session, builder):
     """
     Build the documentation using a specific Sphinx builder.
     """
-    session.install("-r", DOCS / "requirements.txt")
+    session.install("-r", REQUIREMENTS["docs"])
     with TemporaryDirectory() as tmpdir_str:
         tmpdir = Path(tmpdir_str)
         argv = ["-n", "-T", "-W"]
@@ -147,7 +157,7 @@ def requirements(session):
     Update the project's pinned requirements. Commit the result.
     """
     session.install("pip-tools")
-    for each in [DOCS / "requirements.in", ROOT / "test-requirements.in"]:
+    for each in REQUIREMENTS_IN:
         session.run(
             "pip-compile",
             "--resolver",

pyproject.toml

@@ -29,8 +29,7 @@ classifiers = [
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
-  "Programming Language :: Python :: 3.8",
-  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: Implementation :: CPython",
   "Programming Language :: Python :: Implementation :: PyPy",
@@ -136,4 +135,4 @@ docstring-quotes = "double"
 [tool.ruff.per-file-ignores]
 "noxfile.py" = ["ANN", "D100"]
 "docs/*" = ["ANN", "D"]
-"referencing/loaders/tests/*" = ["ANN", "D", "RUF012"]
+"referencing/tests/*" = ["ANN", "D", "RUF012"]

referencing/loaders.py

@@ -0,0 +1,19 @@
+r"""
+Helpers for loading `referencing.Resource`\ s out of various places.
+"""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Iterable
+
+from referencing import Resource
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+
+def from_path(path: Path) -> Iterable[Resource[Any]]:
+    """
+    Load some resources recursively from a given directory path.
+    """
+    for _, _, _ in path.walk():
+        yield Resource.opaque(None)

referencing/loaders/__init__.py

@@ -0,0 +1,2 @@
+def test_it_imports(tmp_path):
+    import referencing.loaders  # noqa: F401