From 66428ef0c33312b7cc3677630f51359afb2e058d Mon Sep 17 00:00:00 2001
From: RoryBarnes <rory@astro.washington.edu>
Date: Fri, 2 Jan 2026 17:47:44 -0800
Subject: [PATCH] Upgrade Sphinx to v7+ for Python 3.13+ compatibility
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Fixed docs build failure with Python 3.14 caused by Sphinx 4.2.0 using the
deprecated 'imghdr' module that was removed in Python 3.13.

Changes:
- sphinx==4.2.0 → sphinx>=7.0.0 (Python 3.13+ compatible)
- Added sphinx_rtd_theme>=1.0.0 (was missing)
- Fixed indentation to match BigPlanet's environment.yml
- parameterized>=0.8.1 → parameterized==0.8.1 (match BigPlanet)

Now matches BigPlanet's working configuration.

Error was: 'Could not import extension sphinx.builders.epub3
(exception: No module named imghdr)'
---
 environment.yml | 27 ++++++++++++++-------------
 1 file changed, 14 insertions(+), 13 deletions(-)

diff --git a/environment.yml b/environment.yml
index d5f06bd..3536965 100644
--- a/environment.yml
+++ b/environment.yml
@@ -7,16 +7,17 @@ dependencies:
   - scipy>=1.5.2
   - setuptools>=51.3.3
   - pip:
-    - matplotlib>=3.3.3
-    - nose>=1.3.7
-    - parameterized>=0.8.1
-    - pytest>=6.2.4
-    - pytest-dependency>=0.5.1
-    - pytest-env>=0.6.2
-    - pytest-cov>=2.11.1
-    - sphinx==4.2.0
-    - breathe>=4.30.0
-    - sphinxcontrib-bibtex>=2.2.0
-    - coverage>=5.5
-    - argparse>=1.4
-    - h5py>=3.1
+     - matplotlib>=3.3.3
+     - nose>=1.3.7
+     - parameterized==0.8.1
+     - pytest>=6.2.4
+     - pytest-dependency>=0.5.1
+     - pytest-env>=0.6.2
+     - pytest-cov>=2.11.1
+     - sphinx>=7.0.0
+     - breathe>=4.30.0
+     - sphinxcontrib-bibtex>=2.2.0
+     - coverage>=5.5
+     - argparse>=1.4
+     - h5py>=3.1
+     - sphinx_rtd_theme>=1.0.0