summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJürgen Gmach <juergen.gmach@googlemail.com>2023-04-21 17:46:40 +0200
committerGitHub <noreply@github.com>2023-04-21 08:46:40 -0700
commit47f13f5140a3f9235ea48596df3e86f08b03ec9d (patch)
treeee5af9a9dde847b3287a4358ad5ae62eb3aab3b4
parentff84a64c55618be281f05b7b4af44c827c48777f (diff)
downloadtox-git-47f13f5140a3f9235ea48596df3e86f08b03ec9d.tar.gz
Add FAQ entry on how to test against EOL Python versions (#2991)
* Add FAQ entry on how to test against EOL Python versions * [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --------- Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
-rw-r--r--docs/changelog/2989.doc.rst1
-rw-r--r--docs/faq.rst20
2 files changed, 21 insertions, 0 deletions
diff --git a/docs/changelog/2989.doc.rst b/docs/changelog/2989.doc.rst
new file mode 100644
index 00000000..4ac05f1e
--- /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 e1864e6f..257c6a57 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 <https://virtualenv.pypa.io/en/latest/changelog.html#v20-22-0-2023-04-19>`_
+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 <https://github.com/asottile/all-repos>`_.