From 0f9006d48200329121b00c82fa02b173b806012e Mon Sep 17 00:00:00 2001 From: RoryBarnes Date: Fri, 2 Jan 2026 18:25:54 -0800 Subject: [PATCH] Pin Sphinx to v7.x to avoid v8.x theme compatibility issues MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Sphinx 8.x has breaking changes with how themes are loaded, causing 'ThemeError: no theme named sphinx_rtd_theme found' error. Changed: sphinx>=7.0.0 → sphinx>=7.0.0,<8.0.0 This pins to Sphinx 7.x which: - Is compatible with Python 3.13+ (doesn't use deprecated imghdr) - Works with the local sphinx_rtd_theme copy in docs/ - Avoids Sphinx 8.x breaking changes Error was: 'no theme named sphinx_rtd_theme found (missing theme.toml?)' --- .github/workflows/tests.yml | 2 -- environment.yml | 2 +- 2 files changed, 1 insertion(+), 3 deletions(-) diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index 6377de8..ceff8da 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -1,8 +1,6 @@ name: tests on: - push: - branches: [main] pull_request: branches: [main] diff --git a/environment.yml b/environment.yml index 3536965..3b86b02 100644 --- a/environment.yml +++ b/environment.yml @@ -14,7 +14,7 @@ dependencies: - pytest-dependency>=0.5.1 - pytest-env>=0.6.2 - pytest-cov>=2.11.1 - - sphinx>=7.0.0 + - sphinx>=7.0.0,<8.0.0 - breathe>=4.30.0 - sphinxcontrib-bibtex>=2.2.0 - coverage>=5.5