Move [doc] extra to a PEP 735 dependency group; add uv-sync CI check

Author: mwtoews

.github/workflows/dependencies.yml

@@ -40,3 +40,18 @@ jobs:
         else
           pytest -o addopts= -v smmap/smmap/test
         fi
+  uv-sync:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+        with:
+          enable-cache: false
+          version: "0.12.13"  # Released on 2026-09-10
+
+      # Ensure that dependencies and dependency groups are consistent and resolvable.
+      - run: uv sync --all-extras --all-groups --dry-run

.github/workflows/pythonpackage.yml

@@ -173,5 +173,5 @@ jobs:
     - name: Documentation
       if: matrix.build-docs
       run: |
-        pip install '.[doc]'
+        pip install --group doc
         make -C doc html

.gitignore

@@ -52,3 +52,6 @@ output.txt
 
 # Files created by OSS-Fuzz when running locally
 fuzz_*.pkg.spec
+
+# Lock files created by uv, pixi, pipenv and others
+*.lock

.readthedocs.yaml

@@ -13,6 +13,10 @@ build:
     # nodejs: "20"
     # rust: "1.70"
     # golang: "1.20"
+  jobs:
+    install:
+    - python -m pip install --upgrade --no-cache-dir pip setuptools
+    - python -m pip install --upgrade --upgrade-strategy only-if-needed --no-cache-dir --group doc .
 
 # Build documentation in the "doc/" directory with Sphinx.
 sphinx:
@@ -24,13 +28,3 @@ sphinx:
 
 # Optionally build your docs in additional formats such as PDF and ePub.
 formats: all
-
-# Optional but recommended, declare the Python requirements required
-# to build your documentation.
-# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
-python:
-  install:
-  - method: pip
-    path: .
-    extra_requirements:
-    - doc

doc/requirements.txt

@@ -40,14 +40,20 @@ dynamic = ["license", "version", "dependencies", "optional-dependencies"]
 "Source code" = "https://github.com/gitpython-developers/GitPython"
 "Documentation" = "https://gitpython.readthedocs.io/en/stable/"
 
+[dependency-groups]
+doc = [
+    'sphinx >=7.4.7,<8 ; python_version >= "3.9"',
+    "sphinx-autodoc-typehints",
+    "sphinx-rtd-theme",
+]
+
 [tool.setuptools]
 include-package-data = true
 
 [tool.setuptools.dynamic]
 version = {file = "VERSION"}
 dependencies = {file = "requirements.txt"}
 optional-dependencies."test" = {file = "test-requirements.txt"}
-optional-dependencies."doc" = {file = "doc/requirements.txt"}
 
 [tool.setuptools.packages.find]
 include = ["git", "git.*"]