diff --git a/docs/changelog/2989.doc.rst b/docs/changelog/2989.doc.rst new file mode 100644 index 000000000..4ac05f1ef --- /dev/null +++ b/docs/changelog/2989.doc.rst @@ -0,0 +1 @@ +Add FAQ entry on how to test EOL Python versions by :user:`jugmac00`. diff --git a/docs/faq.rst b/docs/faq.rst index e1864e6f6..257c6a57d 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -348,3 +348,23 @@ Just make sure you switch the user to ``root`` when needed and switch back to `` rm -rf /var/lib/apt/lists/* USER tox + + +Testing end-of-life Python versions +----------------------------------- + +``tox`` uses ``virtualenv`` under its hood for managing virtual environments. + +`Virtualenv 20.22.0 `_ +dropped support for all Python versions smaller or equal to Python 3.6. + +If you need to test against e.g. Python 2.7, 3.5 or 3.6, you need to add the +following ``requires`` statement to your ``tox.ini`` configuration files. + +.. code-block:: ini + + [tox] + requires = virtualenv<20.22.0 + +In case you need to do this for many repositories, we recommend to use +`all-repos `_.