Switch from requirements files to pyproject.toml (#2305)

Author: srittau

.github/workflows/build-docs.yml

@@ -21,6 +21,6 @@ jobs:
     - name: Install dependencies
       run: |
         pip install --upgrade pip
-        pip install -r docs/requirements.txt
+        pip install --group docs
     - name: Build the documentation
       run: make -C docs html

.github/workflows/ci.yml

@@ -15,17 +15,15 @@ jobs:
 
     steps:
       - uses: actions/checkout@v6
-      - name: Set up Python 3
-        uses: actions/setup-python@v6
+      - uses: actions/setup-python@v6
         with:
-          python-version: 3
+          python-version: "3.14"
           cache: "pip"
-          cache-dependency-path: "test-requirements.txt"
 
       - name: Install dependencies
         run: |
           pip install --upgrade pip
-          pip install -r test-requirements.txt
+          pip install --group test
 
       - name: Lint implementation
         run: flake8

.readthedocs.yaml

@@ -4,13 +4,17 @@
 version: 2
 
 build:
-  os: ubuntu-22.04
+  os: ubuntu-26.04
   tools:
     python: "3"
+  jobs:
+    install:
+      - uv sync --group docs
 
 sphinx:
   configuration: docs/conf.py
 
 python:
   install:
-  - requirements: docs/requirements.txt
+    - method: uv
+      command: sync

docs/Makefile

@@ -5,6 +5,7 @@
 # from the environment for the first two.
 SOURCEDIR     = .
 SOURCES       =
+ROOTDIR       = ..
 BUILDDIR      = _build
 PYTHON       = python3
 VENVDIR      = ./venv
@@ -38,8 +39,8 @@ text: build
 
 venv:
 	$(PYTHON) -m venv $(VENVDIR)
-	$(VENVDIR)/bin/python3 -m pip install -U pip setuptools
-	$(VENVDIR)/bin/python3 -m pip install -r requirements.txt
+	$(VENVDIR)/bin/python3 -m pip install -U pip
+	$(VENVDIR)/bin/python3 -m pip install --group $(ROOTDIR)/pyproject.toml:docs
 	@echo "The venv has been created in the $(VENVDIR) directory"
 
 # Catch-all target: route all unknown targets to Sphinx using the new

docs/requirements.txt

@@ -0,0 +1,21 @@
+[project]
+name = "typing"
+version = "1"  # dummy
+requires-python = ">= 3.12"  # for building the documentation etc.
+
+[dependency-groups]
+test = [
+    "flake8",
+    "flake8-bugbear",
+    "flake8-pyi",
+]
+docs = [
+    # Sphinx version is pinned so that new versions that introduce new warnings
+    # won't suddenly cause build failures. Updating the version is fine as long
+    # as no warnings are raised by doing so.
+    "sphinx==9.1.0",
+
+    # The theme used by the documentation is stored separately, so we need
+    # to install that as well.
+    "python-docs-theme",
+]