From 972c229d8cae0d892b276b77621d4a08fda2f44d Mon Sep 17 00:00:00 2001
From: Ross McFarland <rwmcfa1@gmail.com>
Date: Sun, 3 Aug 2025 19:49:26 -0700
Subject: [PATCH] more sphnix (downstream) early deps

---
 requirements-dev.txt       |  2 +-
 requirements-docs.txt      | 10 +++++++---
 script/cibuild             |  2 ++
 script/update-requirements | 18 ++++++++++++++++--
 4 files changed, 26 insertions(+), 6 deletions(-)

diff --git a/requirements-dev.txt b/requirements-dev.txt
index 1a8d501..3b44544 100644
--- a/requirements-dev.txt
+++ b/requirements-dev.txt
@@ -10,7 +10,7 @@ charset-normalizer==3.4.2
 click==8.1.8; python_version<'3.10'
 click==8.2.1; python_version>='3.10'
 cmarkgfm==2024.11.20
-coverage==7.10.1
+coverage==7.10.2
 cryptography==45.0.5
 docutils==0.21.2
 id==1.5.0
diff --git a/requirements-docs.txt b/requirements-docs.txt
index 05efa5f..149e18f 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -1,15 +1,19 @@
 # DO NOT EDIT THIS FILE DIRECTLY - use ./script/update-requirements to update
 Jinja2==3.1.6
 MarkupSafe==3.0.2
-Sphinx==8.2.3
+Sphinx==7.4.7; python_version=='3.9'
+Sphinx==8.1.3; python_version=='3.10'
+Sphinx==8.2.3; python_version>='3.11'
 accessible-pygments==0.0.5
-alabaster==1.0.0
+alabaster==0.7.16; python_version<'3.10'
+alabaster==1.0.0; python_version>='3.10'
 babel==2.17.0
 beautifulsoup4==4.13.4
 furo==2025.7.19
 imagesize==1.4.1
 mdit-py-plugins==0.4.2
-myst-parser==4.0.1
+myst-parser==3.0.1; python_version<'3.10'
+myst-parser==4.0.1; python_version>='3.10'
 roman-numerals-py==3.1.0
 snowballstemmer==3.0.1
 soupsieve==2.7
diff --git a/script/cibuild b/script/cibuild
index e652b72..2d919ca 100755
--- a/script/cibuild
+++ b/script/cibuild
@@ -29,4 +29,6 @@ echo "## formatting ############################################################
 script/format --check || (echo "Formatting check failed, run ./script/format" && exit 1)
 echo "## tests/coverage ##############################################################"
 script/coverage
+echo "## documentation ###############################################################"
+script/generate-docs
 echo "## complete ####################################################################"
diff --git a/script/update-requirements b/script/update-requirements
index 870b144..f00a9d6 100755
--- a/script/update-requirements
+++ b/script/update-requirements
@@ -40,12 +40,26 @@ with TemporaryDirectory() as tmpdir:
         p, v = pv.split('==')
         versions[p] = (v,)
 
-# special handling for click until python 3.9 is gone due to it dropping
-# support for active versions early
+
+# special handling for older python versions due to libraries dropping support
+# early
+versions['alabaster'] = (
+    "0.7.16; python_version<'3.10'",
+    f"{versions['alabaster'][0]}; python_version>='3.10'",
+)
 versions['click'] = (
     "8.1.8; python_version<'3.10'",
     f"{versions['click'][0]}; python_version>='3.10'",
 )
+versions['myst-parser'] = (
+    "3.0.1; python_version<'3.10'",
+    f"{versions['myst-parser'][0]}; python_version>='3.10'",
+)
+versions['Sphinx'] = (
+    "7.4.7; python_version=='3.9'",
+    "8.1.3; python_version=='3.10'",
+    f"{versions['Sphinx'][0]}; python_version>='3.11'",
+)
 
 
 def write_packages(fh, packages, header, prefix=''):