summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJarrod Millman <jarrod.millman@gmail.com>2022-04-25 12:56:03 -0700
committerGitHub <noreply@github.com>2022-04-25 15:56:03 -0400
commiteb22997831c36656907fac11e808b0c01c15aecc (patch)
treeb053cf7437e011b6911c93760b34a372da704190
parentd7d937efde0cdb843cfcdb593fc7b3da369fcfbb (diff)
downloadnumpydoc-eb22997831c36656907fac11e808b0c01c15aecc.tar.gz
Require sphinx>3 (#385)
-rw-r--r--.github/workflows/test.yml5
-rw-r--r--README.rst2
-rw-r--r--doc/install.rst2
-rw-r--r--doc/requirements.txt2
-rw-r--r--numpydoc/numpydoc.py4
-rw-r--r--setup.py2
6 files changed, 8 insertions, 9 deletions
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 4818086..fa580dc 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -13,7 +13,7 @@ jobs:
matrix:
os: [Ubuntu]
python-version: ["3.7", "3.8", "3.9", "3.10"]
- sphinx-version: ["sphinx==1.8.0", "sphinx==2.1", "sphinx>3.0"]
+ sphinx-version: ["sphinx==3.0", "sphinx==4.0", "sphinx>4.4"]
steps:
- uses: actions/checkout@v2
@@ -31,8 +31,7 @@ jobs:
python -m pip list
- name: Downgrade Jinja2 for sphinx<4
- if: (${{ matrix.sphinx-version }} == 'sphinx==1.8.0') ||
- (${{ matrix.sphinx-version }} == 'sphinx==2.1')
+ if: ${{ matrix.sphinx-version }} == 'sphinx<4.0.2'
run: python -m pip install jinja2==3.0.3
- name: Install
diff --git a/README.rst b/README.rst
index 07a3d96..7d6c34e 100644
--- a/README.rst
+++ b/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 1.8+.
+numpydoc requires Python 3.7+ and sphinx 3.0+.
For usage information, please refer to the `documentation
<https://numpydoc.readthedocs.io/>`_.
diff --git a/doc/install.rst b/doc/install.rst
index 2604142..fb3c26b 100644
--- a/doc/install.rst
+++ b/doc/install.rst
@@ -5,7 +5,7 @@ Getting started
Installation
============
-This extension requires Python 3.7+, sphinx 1.8+ and is available from:
+This extension requires Python 3.7+, sphinx 3.0+ and is available from:
* `numpydoc on PyPI <http://pypi.python.org/pypi/numpydoc>`_
* `numpydoc on GitHub <https://github.com/numpy/numpydoc/>`_
diff --git a/doc/requirements.txt b/doc/requirements.txt
index d5c05ab..84b1eb8 100644
--- a/doc/requirements.txt
+++ b/doc/requirements.txt
@@ -1,4 +1,4 @@
numpy
matplotlib
pydata-sphinx-theme<=0.8.0
-sphinx>2
+sphinx>3
diff --git a/numpydoc/numpydoc.py b/numpydoc/numpydoc.py
index eaaad44..1775a7b 100644
--- a/numpydoc/numpydoc.py
+++ b/numpydoc/numpydoc.py
@@ -30,8 +30,8 @@ from sphinx.addnodes import pending_xref, desc_content
from sphinx.util import logging
from sphinx.errors import ExtensionError
-if sphinx.__version__ < '1.8':
- raise RuntimeError("Sphinx 1.8 or newer is required")
+if sphinx.__version__ < '3.0':
+ raise RuntimeError("Sphinx 3.0 or newer is required")
from .docscrape_sphinx import get_doc_object
from .validate import validate, ERROR_MSGS
diff --git a/setup.py b/setup.py
index 9624531..515f849 100644
--- a/setup.py
+++ b/setup.py
@@ -51,7 +51,7 @@ setup(
author_email="pav@iki.fi",
url="https://numpydoc.readthedocs.io",
license="BSD",
- install_requires=["sphinx>=1.8", 'Jinja2>=2.10'],
+ install_requires=["sphinx>=3.0", 'Jinja2>=2.10'],
python_requires=">=3.7",
extras_require={
"testing": [