Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions docs/requirements-docs.txt
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
sphinx==7.3.7
furo==2024.5.6
sphinx-autobuild==2024.4.16
sphinx==9.1.0
furo==2025.12.19
sphinx-autobuild==2025.8.25
sphinx-copybutton==0.5.2
sphinx-sitemap==2.6.0
sphinx-click==5.0.1
sphinx-autodoc-typehints==2.3.0
sphinx-sitemap==2.9.0
sphinx-click==6.2.0
sphinx-autodoc-typehints==3.6.2
Comment on lines +1 to +7
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Find Python version constraints and doc build config files
fd -a -t f 'pyproject.toml|setup.cfg|setup.py|tox.ini|.python-version|noxfile.py|docs/conf.py' .

Repository: DagsHub/client

Length of output: 119


🏁 Script executed:

#!/bin/bash
# Search for Python version requirements and dependencies config
rg -n 'python_requires|requires-python|python_version' -t toml -t cfg -t py --max-count 20 .

Repository: DagsHub/client

Length of output: 85


🏁 Script executed:

#!/bin/bash
# Check docs/conf.py if it exists and examine Sphinx/Docutils configuration
if [ -f docs/conf.py ]; then
  echo "=== docs/conf.py ===" 
  head -100 docs/conf.py
fi

Repository: DagsHub/client

Length of output: 40


🏁 Script executed:

#!/bin/bash
# Search for any existing Sphinx or Docutils version constraints
rg -n 'sphinx|docutils' docs/requirements-docs.txt -i -C 1

Repository: DagsHub/client

Length of output: 229


🏁 Script executed:

#!/bin/bash
# Read pyproject.toml to find Python version constraints
cat -n pyproject.toml | head -100

Repository: DagsHub/client

Length of output: 102


🏁 Script executed:

#!/bin/bash
# Read setup.py to find Python version constraints
cat -n setup.py

Repository: DagsHub/client

Length of output: 2782


🏁 Script executed:

#!/bin/bash
# Search for Sphinx or Docutils mentions in the codebase
rg -n 'sphinx|docutils' -i --max-count 50 .

Repository: DagsHub/client

Length of output: 2768


🏁 Script executed:

#!/bin/bash
# Read the Sphinx configuration file
cat -n docs/source/conf.py

Repository: DagsHub/client

Length of output: 3149


🌐 Web query:

Sphinx 9.1.0 breaking changes Python 3.9 compatibility

💡 Result:

Sphinx 9.1.0 (released Dec 31, 2025) — breaking/compatibility notes

Python 3.9 compatibility

  • Not compatible with Python 3.9. Sphinx 9.1.0 requires Python ≥ 3.12 (so 3.9/3.10/3.11 won’t work). [1]

Breaking changes called out in 9.1.0 notes

  • Dropped Python 3.11 support (and, by implication of the package requirement, older Pythons such as 3.9 are also unsupported). [1][2]
  • Dropped Docutils 0.20 support (you’ll need a newer Docutils than 0.20.x). [2]

Sources: PyPI metadata for Sphinx 9.1.0 [1], Sphinx changelog entry for 9.1.0 [2].


🌐 Web query:

Sphinx 9.1.0 release notes deprecated features

💡 Result:

Sphinx 9.1.0 (released Dec 31, 2025) does not list any “Deprecated” features/APIs in its release notes section—only Dependencies, Features added, and Bugs fixed are present. (sphinx-doc.org)

If you’re looking for the deprecations relevant to the Sphinx 9.x line, they were introduced in Sphinx 9.0 (e.g., deprecating remaining public .app attributes, Parser.set_application(), Parser.config / Parser.env, non‑UTF8 source encodings, and the entire sphinx.io module). (sphinx-doc.org)

For a consolidated, maintained list of deprecated public APIs (including what version they were deprecated in and when they’re planned to be removed), see Sphinx’s “Deprecated APIs” page. (sphinx-doc.org)

Sources (numbered):

  1. Changelog (Release 9.1.0 section). (sphinx-doc.org)
  2. Sphinx 9.0 changelog (Deprecated section). (sphinx-doc.org)
  3. “Deprecated APIs” index page. (sphinx-doc.org)

Citations:


Sphinx 9.1.0 requires Python ≥3.12, but project supports Python ≥3.9—this breaks docs for Python 3.9–3.11 users.

Sphinx 9.1.0 dropped support for Python versions below 3.12. The project's setup.py declares python_requires=">=3.9", creating a critical incompatibility: users on Python 3.9, 3.10, or 3.11 will not be able to build documentation. Either constrain the docs requirements to Python ≥3.12 or downgrade Sphinx to a version supporting the full range of project Python versions.

14 changes: 7 additions & 7 deletions requirements-dev.txt
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
setuptools==80.9.0
pytest==8.3.5
setuptools==82.0.0
pytest==9.0.2
respx==0.22.0
pytest-git==1.8.0
pytest-env==1.1.5
pytest-mock==3.14.0
fiftyone==1.5.2
datasets==3.6.0
ultralytics==8.3.237
pytest-env==1.3.2
pytest-mock==3.15.1
fiftyone==1.13.0
datasets==4.5.0
ultralytics==8.4.14
Loading