docs: support Sphinx>=3.1 and require it
Previously was restricted to >=1.8.2,<2.1, but newer versions have some nice improvements I'd like to be able to use in upcoming changes. Changelog: https://www.sphinx-doc.org/en/master/changes.html#release-3-1-0-released-jun-08-2020 There are two issues that came up: 1. `highlightlang` is deprecated for `highlight`. 2. Doesn't like having two `automethod` generated for the same `Metafunc.parametrize` method. Gives this warning: `pytest/doc/en/reference.rst:846: WARNING: duplicate object description of _pytest.python.Metafunc.parametrize, other instance in reference, use :noindex: for one of them` To work around this I make `pytest.mark.parametrize` link to `Metafunc.parametrize` instead of repeating it.
This commit is contained in:
parent
358150c30e
commit
65b014a117
|
@ -1,4 +1,4 @@
|
||||||
.. highlightlang:: python
|
.. highlight:: python
|
||||||
.. _`goodpractices`:
|
.. _`goodpractices`:
|
||||||
|
|
||||||
Good Integration Practices
|
Good Integration Practices
|
||||||
|
|
|
@ -138,7 +138,7 @@ pytest.mark.parametrize
|
||||||
|
|
||||||
**Tutorial**: :doc:`parametrize`.
|
**Tutorial**: :doc:`parametrize`.
|
||||||
|
|
||||||
.. automethod:: _pytest.python.Metafunc.parametrize
|
This mark has the same signature as :py:meth:`_pytest.python.Metafunc.parametrize`; see there.
|
||||||
|
|
||||||
|
|
||||||
.. _`pytest.mark.skip ref`:
|
.. _`pytest.mark.skip ref`:
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
pallets-sphinx-themes
|
pallets-sphinx-themes
|
||||||
pygments-pytest>=1.1.0
|
pygments-pytest>=1.1.0
|
||||||
sphinx-removed-in>=0.2.0
|
sphinx-removed-in>=0.2.0
|
||||||
sphinx>=1.8.2,<2.1
|
sphinx>=3.1,<4
|
||||||
sphinxcontrib-trio
|
sphinxcontrib-trio
|
||||||
|
|
Loading…
Reference in New Issue