-> uv

Author: Julian

.github/workflows/ci.yml

@@ -2,39 +2,30 @@ name: CI
 
 on:
   push:
+    branches-ignore:
+      - "wip*"
+    tags:
+      - "v*"
   pull_request:
-  release:
-    types: [published]
   schedule:
     # Daily at 5:41
     - cron: "41 5 * * *"
 
-env:
-  PIP_DISABLE_PIP_VERSION_CHECK: "1"
-  PIP_NO_PYTHON_VERSION_WARNING: "1"
-
 jobs:
-  pre-commit:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.x"
-      - uses: pre-commit/[email protected]
-
   list:
     runs-on: ubuntu-latest
     outputs:
       noxenvs: ${{ steps.noxenvs-matrix.outputs.noxenvs }}
     steps:
       - uses: actions/checkout@v4
-      - name: Set up nox
-        uses: wntrblm/[email protected]
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
       - id: noxenvs-matrix
         run: |
           echo >>$GITHUB_OUTPUT noxenvs=$(
-            nox --list-sessions --json | jq '[.[].session]'
+            uvx nox --list-sessions --json | jq '[.[].session]'
           )
 
   ci:
@@ -48,7 +39,7 @@ jobs:
         posargs: [""]
         include:
           - os: ubuntu-latest
-            noxenv: "tests-3.11"
+            noxenv: "tests-3.13"
             posargs: coverage github
 
     steps:
@@ -63,38 +54,44 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: |
-            3.8
             3.9
             3.10
             3.11
             3.12
+            3.13
             pypy3.10
           allow-prereleases: true
-      - name: Set up nox
-        uses: wntrblm/[email protected]
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
       - name: Run nox
-        run: nox -s "${{ matrix.noxenv }}" -- ${{ matrix.posargs }}
+        run: uvx nox -s "${{ matrix.noxenv }}" -- ${{ matrix.posargs }}
 
   packaging:
     needs: ci
     runs-on: ubuntu-latest
     environment:
       name: PyPI
       url: https://pypi.org/p/referencing-http
+
     permissions:
       contents: write
       id-token: write
 
     steps:
       - uses: actions/checkout@v4
-      - name: Set up Python
-        uses: actions/setup-python@v5
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
         with:
-          python-version: "3.x"
-      - name: Install dependencies
-        run: python -m pip install build
-      - name: Create packages
-        run: python -m build .
+          enable-cache: true
+
+      - name: Build our distributions
+        run: uv run --with 'build[uv]' -m build --installer=uv
+
       - name: Publish to PyPI
         if: github.event_name == 'push' && startsWith(github.event.ref, 'refs/tags')
         uses: pypa/gh-action-pypi-publish@release/v1

docs/requirements.txt

@@ -1,9 +1,5 @@
-#
-# This file is autogenerated by pip-compile with Python 3.12
-# by the following command:
-#
-#    pip-compile --strip-extras docs/requirements.in
-#
+# This file was autogenerated by uv via the following command:
+#    uv pip compile --output-file /Users/julian/Development/referencing-http/docs/requirements.txt docs/requirements.in
 alabaster==1.0.0
     # via sphinx
 attrs==25.3.0
@@ -12,7 +8,7 @@ babel==2.17.0
     # via sphinx
 beautifulsoup4==4.13.4
     # via furo
-certifi==2025.4.26
+certifi==2025.6.15
     # via requests
 charset-normalizer==3.4.2
     # via requests
@@ -34,7 +30,7 @@ pyenchant==3.3.0rc1
     # via
     #   -r docs/requirements.in
     #   sphinxcontrib-spelling
-pygments==2.19.1
+pygments==2.19.2
     # via
     #   furo
     #   pygments-github-lexers
@@ -45,17 +41,17 @@ pyyaml==6.0.2
     # via referencing-http
 referencing==0.36.2
     # via referencing-http
-file:.#egg=referencing-http
+referencing-http @ file:.#egg=referencing-http
     # via -r docs/requirements.in
-requests==2.32.3
+requests==2.32.4
     # via
     #   sphinx
     #   sphinxcontrib-spelling
 roman-numerals-py==3.1.0
     # via sphinx
-rpds-py==0.24.0
+rpds-py==0.25.1
     # via referencing
-snowballstemmer==2.2.0
+snowballstemmer==3.0.1
     # via sphinx
 soupsieve==2.7
     # via beautifulsoup4
@@ -87,9 +83,7 @@ sphinxcontrib-spelling==8.0.1
     # via -r docs/requirements.in
 sphinxext-opengraph==0.10.0
     # via -r docs/requirements.in
-typing-extensions==4.13.2
-    # via
-    #   beautifulsoup4
-    #   referencing
-urllib3==2.4.0
+typing-extensions==4.14.0
+    # via beautifulsoup4
+urllib3==2.5.0
     # via requests

noxfile.py

@@ -14,14 +14,14 @@
     docs=DOCS / "requirements.txt",
     tests=ROOT / "test-requirements.txt",
 )
-REQUIREMENTS_IN = {
-    path.parent / f"{path.stem}.in" for path in REQUIREMENTS.values()
-}
+REQUIREMENTS_IN = [  # this is actually ordered, as files depend on each other
+    (path.parent / f"{path.stem}.in", path) for path in REQUIREMENTS.values()
+]
 
-
-SUPPORTED = ["pypy3.10", "3.10", "3.11", "3.12"]
+SUPPORTED = ["pypy3.10", "3.10", "3.11", "3.12", "3.13"]
 LATEST = SUPPORTED[-1]
 
+nox.options.default_venv_backend = "uv|virtualenv"
 nox.options.sessions = []
 
 
@@ -37,7 +37,7 @@ def _session(fn):
 @session(python=SUPPORTED)
 def tests(session):
     """
-    Run the test suite.
+    Run the test suite with a corresponding Python version.
     """
     session.install("-r", REQUIREMENTS["tests"])
 
@@ -65,7 +65,7 @@ def tests(session):
         session.run("python", "-m", "pytest", *session.posargs, PACKAGE)
 
 
-@session(python=SUPPORTED)
+@session()
 def audit(session):
     """
     Audit Python dependencies for vulnerabilities.
@@ -79,9 +79,15 @@ def build(session):
     """
     Build a distribution suitable for PyPI and check its validity.
     """
-    session.install("build", "twine")
+    session.install("build[uv]", "twine")
     with TemporaryDirectory() as tmpdir:
-        session.run("python", "-m", "build", ROOT, "--outdir", tmpdir)
+        session.run(
+            "pyproject-build",
+            "--installer=uv",
+            ROOT,
+            "--outdir",
+            tmpdir,
+        )
         session.run("twine", "check", "--strict", tmpdir + "/*")
 
 
@@ -97,7 +103,7 @@ def secrets(session):
 @session(tags=["style"])
 def style(session):
     """
-    Check for coding style.
+    Check Python code style.
     """
     session.install("ruff")
     session.run("ruff", "check", ROOT)
@@ -106,10 +112,10 @@ def style(session):
 @session()
 def typing(session):
     """
-    Statically check typing annotations.
+    Check static typing.
     """
     session.install("pyright", ROOT)
-    session.run("pyright", PACKAGE)
+    session.run("pyright", *session.posargs, PACKAGE)
 
 
 @session(tags=["docs"])
@@ -128,9 +134,9 @@ def typing(session):
 )
 def docs(session, builder):
     """
-    Build the documentation using various Sphinx builders.
+    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"]
@@ -152,7 +158,7 @@ def docs(session, builder):
 @session(tags=["docs", "style"], name="docs(style)")
 def docs_style(session):
     """
-    Check the documentation source style.
+    Check the documentation style.
     """
     session.install(
         "doc8",
@@ -165,15 +171,17 @@ def docs_style(session):
 @session(default=False)
 def requirements(session):
     """
-    Update requirements files.
+    Update the project's pinned requirements.
+
+    You should commit the result afterwards.
     """
-    session.install("pip-tools")
-    for each in REQUIREMENTS_IN:
-        session.run(
-            "pip-compile",
-            "--resolver",
-            "backtracking",
-            "--strip-extras",
-            "-U",
-            each.relative_to(ROOT),
-        )
+    if session.venv_backend == "uv":
+        cmd = ["uv", "pip", "compile"]
+    else:
+        session.install("pip-tools")
+        cmd = ["pip-compile", "--resolver", "backtracking", "--strip-extras"]
+
+    for each, out in REQUIREMENTS_IN:
+        # otherwise output files end up with silly absolute path comments...
+        relative = each.relative_to(ROOT)
+        session.run(*cmd, "--upgrade", "--output-file", out, relative)

test-requirements.txt

@@ -1,26 +1,22 @@
-#
-# This file is autogenerated by pip-compile with Python 3.12
-# by the following command:
-#
-#    pip-compile --strip-extras test-requirements.in
-#
+# This file was autogenerated by uv via the following command:
+#    uv pip compile --output-file /Users/julian/Development/referencing-http/test-requirements.txt test-requirements.in
 attrs==25.3.0
     # via referencing
 iniconfig==2.1.0
     # via pytest
 packaging==25.0
     # via pytest
-pluggy==1.5.0
+pluggy==1.6.0
     # via pytest
-pytest==8.3.5
+pygments==2.19.2
+    # via pytest
+pytest==8.4.1
     # via -r test-requirements.in
 pyyaml==6.0.2
     # via referencing-http
 referencing==0.36.2
     # via referencing-http
-file:.#egg=referencing_http
+referencing-http @ file:.#egg=referencing_http
     # via -r test-requirements.in
-rpds-py==0.24.0
-    # via referencing
-typing-extensions==4.13.2
+rpds-py==0.25.1
     # via referencing