Require sphinx>4

Author: jarrodmillman

.github/workflows/test.yml

@@ -13,7 +13,8 @@ jobs:
       matrix:
         os: [Ubuntu]
         python-version: ["3.7", "3.8", "3.9", "3.10"]
-        sphinx-version: ["sphinx==3.0", "sphinx==4.0", "sphinx>4.4"]
+        sphinx-version:
+          ["sphinx==4.0.2", "sphinx==4.5", "sphinx==5.0", "sphinx>=5.0"]
     steps:
       - uses: actions/checkout@v3
 
@@ -30,10 +31,6 @@ jobs:
           python -m pip install ${{ matrix.sphinx-version }}
           python -m pip list
 
-      - name: Downgrade Jinja2 for sphinx<4
-        if: ${{ matrix.sphinx-version }} == 'sphinx<4.0.2'
-        run: python -m pip install jinja2==3.0.3 markupsafe==2.0.1 pydata-sphinx-theme==0.8.0
-
       - name: Install
         run: |
           python -m pip install .
@@ -70,7 +67,8 @@ jobs:
       matrix:
         os: [ubuntu, macos, windows]
         python-version: ["3.11-dev"]
-        sphinx-version: ["sphinx==4.0", "sphinx==4.5"]
+        sphinx-version:
+          ["sphinx==4.0.2", "sphinx==4.5", "sphinx==5.0", "sphinx>=5.0"]
     steps:
       - uses: actions/checkout@v3
 
@@ -86,10 +84,6 @@ jobs:
           python -m pip install ${{ matrix.sphinx-version }}
           python -m pip list
 
-      - name: Downgrade Jinja2 for sphinx<4
-        if: ${{ matrix.sphinx-version }} == 'sphinx<4.0.2'
-        run: python -m pip install jinja2==3.0.3 markupsafe==2.0.1 pydata-sphinx-theme==0.8.0
-
       - name: Install
         run: |
           python -m pip install .

README.rst

@@ -18,7 +18,7 @@ docstrings formatted according to the NumPy documentation format.
 The extension also adds the code description directives
 ``np:function``, ``np-c:function``, etc.
 
-numpydoc requires Python 3.7+ and sphinx 3.0+.
+numpydoc requires Python 3.7+ and sphinx 4.0.2+.
 
 For usage information, please refer to the `documentation
 <https://numpydoc.readthedocs.io/>`_.

doc/install.rst

@@ -5,7 +5,7 @@ Getting started
 Installation
 ============
 
-This extension requires Python 3.7+, sphinx 3.0+ and is available from:
+This extension requires Python 3.7+, sphinx 4.0.2+ and is available from:
 
 * `numpydoc on PyPI <http://pypi.python.org/pypi/numpydoc>`_
 * `numpydoc on GitHub <https://github.com/numpy/numpydoc/>`_

numpydoc/__init__.py

@@ -5,32 +5,6 @@
 from ._version import __version__
 
 
-def _verify_sphinx_jinja():
-    """Ensure sphinx and jinja versions are compatible.
-
-    Jinja2>=3.1 requires Sphinx>=4.0.2. Raises exception if this condition is
-    not met.
-
-    TODO: This check can be removed when the minimum supported sphinx version
-    for numpydoc sphinx>=4.0.2
-    """
-    import sphinx, jinja2
-    from packaging import version
-
-    if version.parse(sphinx.__version__) <= version.parse("4.0.2"):
-        if version.parse(jinja2.__version__) >= version.parse("3.1"):
-            from sphinx.errors import VersionRequirementError
-
-            raise VersionRequirementError(
-                "\n\nSphinx<4.0.2 is incompatible with Jinja2>=3.1.\n"
-                "If you wish to continue using sphinx<4.0.2 you need to pin "
-                "Jinja2<3.1."
-            )
-
-
-_verify_sphinx_jinja()
-
-
 def setup(app, *args, **kwargs):
     from .numpydoc import setup
 

setup.py

@@ -52,7 +52,7 @@ def read(fname):
     author_email="[email protected]",
     url="https://numpydoc.readthedocs.io",
     license="BSD",
-    install_requires=["sphinx>=3.0", "Jinja2>=2.10"],
+    install_requires=["sphinx>=4.0.2", "Jinja2>=2.10"],
     python_requires=">=3.7",
     extras_require={
         "testing": [