From 693f5256d7c3aedde70a2400a4bf58c9989169b8 Mon Sep 17 00:00:00 2001
From: Todd Gamblin <tgamblin@llnl.gov>
Date: Tue, 25 Mar 2025 17:27:55 -0700
Subject: [PATCH] readthedocs: use `uv` to build instead of `pip`

`uv` is faster than `pip`, and `pip install` can take a while in our
readthedocs builds in CI. Try using `uv` instead.

See [readthedocs's docs](https://docs.readthedocs.com/platform/stable/build-customization.html#install-dependencies-with-uv)
for details.

Signed-off-by: Todd Gamblin <tgamblin@llnl.gov>
---
 .readthedocs.yml | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 012a6e6e0ae..db514e281e5 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -6,6 +6,17 @@ build:
     - graphviz
   tools:
     python: "3.11"
+  jobs:
+    create_environment:
+      - asdf plugin add uv
+      - asdf install uv latest
+      - asdf global uv latest
+      - uv venv
+    install:
+      - uv pip install -r requirements.txt
+    build:
+      html:
+        - uv run sphinx-build -T -b html docs $READTHEDOCS_OUTPUT/html
 
 sphinx:
   configuration: lib/spack/docs/conf.py