use uv for docs build (#502)

Author: gruebel

.github/workflows/test.yml

@@ -12,7 +12,7 @@ permissions:
   contents: read
 
 env:
-  PREK_VERSION: '0.2.11'
+  PREK_VERSION: '0.2.13'
 
 jobs:
   prek:

.readthedocs.yml

@@ -8,6 +8,15 @@ build:
   os: ubuntu-24.04
   tools:
     python: "3.10"
+  jobs:
+    pre_create_environment:
+      - asdf plugin add uv
+      - asdf install uv latest:0.9
+      - asdf global uv latest
+    create_environment:
+      - uv venv "${READTHEDOCS_VIRTUALENV_PATH}"
+    install:
+      - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --frozen --group docs
 
 mkdocs:
   configuration: mkdocs.yml
@@ -16,7 +25,3 @@ mkdocs:
 
 # Optionally build your docs in additional formats such as PDF and ePub
 formats: all
-
-python:
-   install:
-      - requirements: docs/requirements.txt

docs/requirements.txt

@@ -52,11 +52,27 @@ dev = [
     "boto3-stubs-lite[iam,s3,sts]>=1.40.0,<2.0.0",
     "coverage>=7.11.0,<8.0.0",
     "mypy>=1.18.0,<2.0.0",
-    "prek>=0.2.11,<0.3.0",
+    "prek>=0.2.13,<0.3.0",
     "pytest>=8.4.0,<9.0.0",
     "types-pyyaml>=6.0.12,<7.0.0",
 ]
 
+docs = [
+    "atomicwrites>=1.4.0,<2.0.0",
+    "distlib>=0.4.0,<0.5.0",
+    "docutils>=0.22.0,<0.23.0",
+    "filelock>=3.20.0,<4.0.0",
+    "mkdocs>=1.6.0,<2.0.0",
+    "mkdocs-material>=9.6.0,<10.0.0",
+    "mkdocs-material-extensions>=1.3.0,<2.0.0",
+    "mkdocstrings>=0.30.0,<0.31.0",
+    "mkdocstrings-python>=1.18.0,<2.0.0",
+    "mkdocstrings-python-legacy>=0.2.0,<0.3.0",
+    "pygments>=2.19.0,<3.0.0",
+    "pymdown-extensions>=10.16.0,<11.0.0",
+    "pytkdocs>=0.16.0,<0.17.0",
+]
+
 [build-system]
 requires = ["uv_build~=0.9.0"]
 build-backend = "uv_build"