internet/community.general
3
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2026-05-07 13:52:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

Exorcise Python-2.6

Browse Source
This commit is contained in:
Toshio Kuratomi
2018-07-18 11:34:16 -07:00
parent a3385a60b4
commit c4951cce0b
6 changed files with 31 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
docs/docsite/rst/dev_guide/developing_python_3.rst
View File

@@ -30,13 +30,15 @@ controller-side section.
Minimum Version of Python-3.x and Python-2.x
--------------------------------------------
In both controller side and module code, we support Python-3.5 or greater and Python-2.6 or
greater. Python-3.5 was chosen as a minimum because it is the earliest Python-3 version
adopted as the default Python by a Long Term Support (LTS) Linux distribution (in this case, Ubuntu-16.04).
Previous LTS Linux distributions shipped with a Python-2 version which users can rely upon instead of the
Python-3 version.
On the controller we support Python-3.5 or greater and Python-2.7 or greater. Module-side, we
support Python-3.5 or greater and Python-2.6 or greater.
For Python-2, the default is for modules to run on at least Python-2.6. This allows
Python-3.5 was chosen as a minimum because it is the earliest Python-3 version adopted as the
default Python by a Long Term Support (LTS) Linux distribution (in this case, Ubuntu-16.04).
Previous LTS Linux distributions shipped with a Python-2 version which users can rely upon instead
of the Python-3 version.
For Python 2, the default is for modules to run on at least Python-2.6. This allows
users with older distributions that are stuck on Python-2.6 to manage their
machines. Modules are allowed to drop support for Python-2.6 when one of
their dependent libraries requires a higher version of Python. This is not an

6
docs/docsite/rst/dev_guide/testing_units_modules.rst
View File

@@ -531,6 +531,12 @@ A helpful development approach to this should be to ensure that all of the tests
run under Python 2.6 and that each assertion in the test cases has been checked to work by breaking
the code in Ansible to trigger that failure.
.. warn:: Maintain Python-2.6 compatibility
Please remember that modules need to maintain compatibility with Python-2.6 so the unittests for
modules should also be compatible with Python-2.6.
.. seealso::
:doc:`testing_units`