From 4d0c9e48992f30f5f630ab2fccd742abb9024550 Mon Sep 17 00:00:00 2001 From: Dmitriy Rabotyagov Date: Wed, 3 May 2023 16:09:23 +0200 Subject: [PATCH] Clarify expectations on keeping Python versions According to the PTI it was not clear whether Python versions should be kept whenever new platform is being adopted. This change adds recommendation for libraries and other projects to keep older platforms, including Python. Change-Id: Ie2bb6c96e39eb21ab42132774699f254c7f476a9 --- reference/project-testing-interface.rst | 8 ++++++++ reference/pti/python.rst | 12 ++++++++++-- 2 files changed, 18 insertions(+), 2 deletions(-) diff --git a/reference/project-testing-interface.rst b/reference/project-testing-interface.rst index 8e5ca0b2e..736eb709b 100644 --- a/reference/project-testing-interface.rst +++ b/reference/project-testing-interface.rst @@ -32,6 +32,14 @@ project: Tools and approaches vary by language, please choose which language is relevant to you. +.. note:: + + Project Testing Interface defines a *minimal* list of platforms that + projects should test against. Having a more extensive set of tested platforms + (for instance, keeping older platforms that are not yet EOL) is both allowed + and encouraged. + + .. _pti-documentation: Documentation diff --git a/reference/pti/python.rst b/reference/pti/python.rst index 7f8ca33c8..45b498c2d 100644 --- a/reference/pti/python.rst +++ b/reference/pti/python.rst @@ -26,11 +26,19 @@ tree: - ``sphinx-build -W -b html doc/source doc/build`` The Python 3 version may change from cycle to cycle. Projects should -target the following, replacing `3x` with the :ref:`tested Python 3 runtimes -` for the current development cycle: +target the following, extending supported Python `3x` with the +:ref:`tested Python 3 runtimes ` for the current +development cycle: - ``tox -e py3x`` +Projects should avoid removing Python versions that have not reached +`End Of Life `_ without a solid +reason. It is recommended to keep compatability with older Python versions +as long as possible. +While CI coverage of Python versions that are not mentioned in PTI can be reduced, +such reduction is not mandatory. + Projects that are translated should also support: - ``tox -e venv python setup.py extract_messages``