From ac42e211c098fd29de84718d2f3c88347304696a Mon Sep 17 00:00:00 2001
From: Matthew Feickert <matthew.feickert@cern.ch>
Date: Fri, 10 May 2024 00:58:12 -0500
Subject: [PATCH] ci: Use uv for install on ReadTheDocs (#2475)

* RTD doesn't support uv at the same level as pip, but there are ways
  to still use it along with most of the infrastructure. Adopt the
  strategy provided in ReadTheDocs's 'Build process customization' section
  https://docs.readthedocs.io/en/latest/build-customization.html#install-dependencies-with-uv
  , from https://github.com/readthedocs/readthedocs.org/pull/11152/,
  but continue to monitor alternative faster methods such as those
  described in https://github.com/readthedocs/readthedocs.org/issues/11289 .
---
 .readthedocs.yaml | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/.readthedocs.yaml b/.readthedocs.yaml
index 6ff1c4c8b8..5bd7c51f22 100644
--- a/.readthedocs.yaml
+++ b/.readthedocs.yaml
@@ -13,6 +13,13 @@ build:
   apt_packages:
     - curl
     - jq
+  jobs:
+    post_create_environment:
+      - pip install uv
+    post_install:
+      # VIRTUAL_ENV needs to be set manually for now.
+      # See https://github.com/readthedocs/readthedocs.org/pull/11152/
+      - VIRTUAL_ENV=$READTHEDOCS_VIRTUALENV_PATH uv pip install '.[docs]'
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
@@ -20,11 +27,3 @@ sphinx:
 
 # If using Sphinx, optionally build your docs in additional formats such as PDF and ePub
 formats: all
-
-# python -m pip install '.[docs]'
-python:
-  install:
-    - method: pip
-      path: .
-      extra_requirements:
-        - docs