ansible-core 2.15.4rc1__py3-none-any.whl → 2.16.0b2__py3-none-any.whl

ansible_test/_util/controller/sanity/pylint/plugins/deprecated.py

@@ -5,14 +5,31 @@
 from __future__ import annotations
 
 import datetime
+import functools
+import json
 import re
+import shlex
 import typing as t
+from tokenize import COMMENT, TokenInfo
 
 import astroid
 
-from pylint.interfaces import IAstroidChecker
-from pylint.checkers import BaseChecker
-from pylint.checkers.utils import check_messages
+# support pylint 2.x and 3.x -- remove when supporting only 3.x
+try:
+    from pylint.interfaces import IAstroidChecker, ITokenChecker
+except ImportError:
+    class IAstroidChecker:
+        """Backwards compatibility for 2.x / 3.x support."""
+
+    class ITokenChecker:
+        """Backwards compatibility for 2.x / 3.x support."""
+
+try:
+    from pylint.checkers.utils import check_messages
+except ImportError:
+    from pylint.checkers.utils import only_required_for_messages as check_messages
+
+from pylint.checkers import BaseChecker, BaseTokenChecker
 
 from ansible.module_utils.compat.version import LooseVersion
 from ansible.module_utils.six import string_types
@@ -95,7 +112,7 @@ ANSIBLE_VERSION = LooseVersion('.'.join(ansible_version_raw.split('.')[:3]))
 
 
 def _get_expr_name(node):
-    """Funciton to get either ``attrname`` or ``name`` from ``node.func.expr``
+    """Function to get either ``attrname`` or ``name`` from ``node.func.expr``
 
     Created specifically for the case of ``display.deprecated`` or ``self._display.deprecated``
     """
@@ -106,6 +123,17 @@ def _get_expr_name(node):
         return node.func.expr.name
 
 
+def _get_func_name(node):
+    """Function to get either ``attrname`` or ``name`` from ``node.func``
+
+    Created specifically for the case of ``from ansible.module_utils.common.warnings import deprecate``
+    """
+    try:
+        return node.func.attrname
+    except AttributeError:
+        return node.func.name
+
+
 def parse_isodate(value):
     """Parse an ISO 8601 date string."""
     msg = 'Expected ISO 8601 date string (YYYY-MM-DD)'
@@ -118,7 +146,7 @@ def parse_isodate(value):
     try:
         return datetime.datetime.strptime(value, '%Y-%m-%d').date()
     except ValueError:
-        raise ValueError(msg)
+        raise ValueError(msg) from None
 
 
 class AnsibleDeprecatedChecker(BaseChecker):
@@ -160,6 +188,8 @@ class AnsibleDeprecatedChecker(BaseChecker):
             self.add_message('ansible-deprecated-date', node=node, args=(date,))
 
     def _check_version(self, node, version, collection_name):
+        if collection_name is None:
+            collection_name = 'ansible.builtin'
         if not isinstance(version, (str, float)):
             if collection_name == 'ansible.builtin':
                 symbol = 'ansible-invalid-deprecated-version'
@@ -197,14 +227,14 @@ class AnsibleDeprecatedChecker(BaseChecker):
     @property
     def collection_name(self) -> t.Optional[str]:
         """Return the collection name, or None if ansible-core is being tested."""
-        return self.config.collection_name
+        return self.linter.config.collection_name
 
     @property
     def collection_version(self) -> t.Optional[SemanticVersion]:
         """Return the collection version, or None if ansible-core is being tested."""
-        if self.config.collection_version is None:
+        if self.linter.config.collection_version is None:
             return None
-        sem_ver = SemanticVersion(self.config.collection_version)
+        sem_ver = SemanticVersion(self.linter.config.collection_version)
         # Ignore pre-release for version comparison to catch issues before the final release is cut.
         sem_ver.prerelease = ()
         return sem_ver
@@ -216,8 +246,9 @@ class AnsibleDeprecatedChecker(BaseChecker):
         date = None
         collection_name = None
         try:
-            if (node.func.attrname == 'deprecated' and 'display' in _get_expr_name(node) or
-                    node.func.attrname == 'deprecate' and _get_expr_name(node)):
+            funcname = _get_func_name(node)
+            if (funcname == 'deprecated' and 'display' in _get_expr_name(node) or
+                    funcname == 'deprecate'):
                 if node.keywords:
                     for keyword in node.keywords:
                         if len(node.keywords) == 1 and keyword.arg is None:
@@ -263,6 +294,137 @@ class AnsibleDeprecatedChecker(BaseChecker):
             pass
 
 
+class AnsibleDeprecatedCommentChecker(BaseTokenChecker):
+    """Checks for ``# deprecated:`` comments to ensure that the ``version``
+    has not passed or met the time for removal
+    """
+
+    __implements__ = (ITokenChecker,)
+
+    name = 'deprecated-comment'
+    msgs = {
+        'E9601': ("Deprecated core version (%r) found: %s",
+                  "ansible-deprecated-version-comment",
+                  "Used when a '# deprecated:' comment specifies a version "
+                  "less than or equal to the current version of Ansible",
+                  {'minversion': (2, 6)}),
+        'E9602': ("Deprecated comment contains invalid keys %r",
+                  "ansible-deprecated-version-comment-invalid-key",
+                  "Used when a '#deprecated:' comment specifies invalid data",
+                  {'minversion': (2, 6)}),
+        'E9603': ("Deprecated comment missing version",
+                  "ansible-deprecated-version-comment-missing-version",
+                  "Used when a '#deprecated:' comment specifies invalid data",
+                  {'minversion': (2, 6)}),
+        'E9604': ("Deprecated python version (%r) found: %s",
+                  "ansible-deprecated-python-version-comment",
+                  "Used when a '#deprecated:' comment specifies a python version "
+                  "less than or equal to the minimum python version",
+                  {'minversion': (2, 6)}),
+        'E9605': ("Deprecated comment contains invalid version %r: %s",
+                  "ansible-deprecated-version-comment-invalid-version",
+                  "Used when a '#deprecated:' comment specifies an invalid version",
+                  {'minversion': (2, 6)}),
+    }
+
+    options = (
+        ('min-python-version-db', {
+            'default': None,
+            'type': 'string',
+            'metavar': '<path>',
+            'help': 'The path to the DB mapping paths to minimum Python versions.',
+        }),
+    )
+
+    def process_tokens(self, tokens: list[TokenInfo]) -> None:
+        for token in tokens:
+            if token.type == COMMENT:
+                self._process_comment(token)
+
+    def _deprecated_string_to_dict(self, token: TokenInfo, string: str) -> dict[str, str]:
+        valid_keys = {'description', 'core_version', 'python_version'}
+        data = dict.fromkeys(valid_keys)
+        for opt in shlex.split(string):
+            if '=' not in opt:
+                data[opt] = None
+                continue
+            key, _sep, value = opt.partition('=')
+            data[key] = value
+        if not any((data['core_version'], data['python_version'])):
+            self.add_message(
+                'ansible-deprecated-version-comment-missing-version',
+                line=token.start[0],
+                col_offset=token.start[1],
+            )
+        bad = set(data).difference(valid_keys)
+        if bad:
+            self.add_message(
+                'ansible-deprecated-version-comment-invalid-key',
+                line=token.start[0],
+                col_offset=token.start[1],
+                args=(','.join(bad),)
+            )
+        return data
+
+    @functools.cached_property
+    def _min_python_version_db(self) -> dict[str, str]:
+        """A dictionary of absolute file paths and their minimum required Python version."""
+        with open(self.linter.config.min_python_version_db) as db_file:
+            return json.load(db_file)
+
+    def _process_python_version(self, token: TokenInfo, data: dict[str, str]) -> None:
+        current_file = self.linter.current_file
+        check_version = self._min_python_version_db[current_file]
+
+        try:
+            if LooseVersion(data['python_version']) < LooseVersion(check_version):
+                self.add_message(
+                    'ansible-deprecated-python-version-comment',
+                    line=token.start[0],
+                    col_offset=token.start[1],
+                    args=(
+                        data['python_version'],
+                        data['description'] or 'description not provided',
+                    ),
+                )
+        except (ValueError, TypeError) as exc:
+            self.add_message(
+                'ansible-deprecated-version-comment-invalid-version',
+                line=token.start[0],
+                col_offset=token.start[1],
+                args=(data['python_version'], exc)
+            )
+
+    def _process_core_version(self, token: TokenInfo, data: dict[str, str]) -> None:
+        try:
+            if ANSIBLE_VERSION >= LooseVersion(data['core_version']):
+                self.add_message(
+                    'ansible-deprecated-version-comment',
+                    line=token.start[0],
+                    col_offset=token.start[1],
+                    args=(
+                        data['core_version'],
+                        data['description'] or 'description not provided',
+                    )
+                )
+        except (ValueError, TypeError) as exc:
+            self.add_message(
+                'ansible-deprecated-version-comment-invalid-version',
+                line=token.start[0],
+                col_offset=token.start[1],
+                args=(data['core_version'], exc)
+            )
+
+    def _process_comment(self, token: TokenInfo) -> None:
+        if token.string.startswith('# deprecated:'):
+            data = self._deprecated_string_to_dict(token, token.string[13:].strip())
+            if data['core_version']:
+                self._process_core_version(token, data)
+            if data['python_version']:
+                self._process_python_version(token, data)
+
+
 def register(linter):
     """required method to auto register this checker """
     linter.register_checker(AnsibleDeprecatedChecker(linter))
+    linter.register_checker(AnsibleDeprecatedCommentChecker(linter))

ansible_test/_util/controller/sanity/pylint/plugins/string_format.py

@@ -5,10 +5,21 @@
 from __future__ import annotations
 
 import astroid
-from pylint.interfaces import IAstroidChecker
+
+# support pylint 2.x and 3.x -- remove when supporting only 3.x
+try:
+    from pylint.interfaces import IAstroidChecker
+except ImportError:
+    class IAstroidChecker:
+        """Backwards compatibility for 2.x / 3.x support."""
+
+try:
+    from pylint.checkers.utils import check_messages
+except ImportError:
+    from pylint.checkers.utils import only_required_for_messages as check_messages
+
 from pylint.checkers import BaseChecker
 from pylint.checkers import utils
-from pylint.checkers.utils import check_messages
 
 MSGS = {
     'E9305': ("disabled",  # kept for backwards compatibility with inline ignores, remove after 2.14 is EOL

ansible_test/_util/controller/sanity/pylint/plugins/unwanted.py

@@ -6,8 +6,14 @@ import typing as t
 
 import astroid
 
+# support pylint 2.x and 3.x -- remove when supporting only 3.x
+try:
+    from pylint.interfaces import IAstroidChecker
+except ImportError:
+    class IAstroidChecker:
+        """Backwards compatibility for 2.x / 3.x support."""
+
 from pylint.checkers import BaseChecker
-from pylint.interfaces import IAstroidChecker
 
 ANSIBLE_TEST_MODULES_PATH = os.environ['ANSIBLE_TEST_MODULES_PATH']
 ANSIBLE_TEST_MODULE_UTILS_PATH = os.environ['ANSIBLE_TEST_MODULE_UTILS_PATH']

ansible_test/_util/controller/sanity/validate-modules/validate_modules/main.py

@@ -808,22 +808,22 @@ class ModuleValidator(Validator):
                         continue
 
                     if grandchild.id == 'DOCUMENTATION':
-                        docs['DOCUMENTATION']['value'] = child.value.s
+                        docs['DOCUMENTATION']['value'] = child.value.value
                         docs['DOCUMENTATION']['lineno'] = child.lineno
                         docs['DOCUMENTATION']['end_lineno'] = (
-                            child.lineno + len(child.value.s.splitlines())
+                            child.lineno + len(child.value.value.splitlines())
                         )
                     elif grandchild.id == 'EXAMPLES':
-                        docs['EXAMPLES']['value'] = child.value.s
+                        docs['EXAMPLES']['value'] = child.value.value
                         docs['EXAMPLES']['lineno'] = child.lineno
                         docs['EXAMPLES']['end_lineno'] = (
-                            child.lineno + len(child.value.s.splitlines())
+                            child.lineno + len(child.value.value.splitlines())
                         )
                     elif grandchild.id == 'RETURN':
-                        docs['RETURN']['value'] = child.value.s
+                        docs['RETURN']['value'] = child.value.value
                         docs['RETURN']['lineno'] = child.lineno
                         docs['RETURN']['end_lineno'] = (
-                            child.lineno + len(child.value.s.splitlines())
+                            child.lineno + len(child.value.value.splitlines())
                         )
 
         return docs

ansible_test/_util/controller/sanity/validate-modules/validate_modules/module_args.py

@@ -29,7 +29,7 @@ from contextlib import contextmanager
 from ansible.executor.powershell.module_manifest import PSModuleDepFinder
 from ansible.module_utils.basic import FILE_COMMON_ARGUMENTS, AnsibleModule
 from ansible.module_utils.six import reraise
-from ansible.module_utils._text import to_bytes, to_text
+from ansible.module_utils.common.text.converters import to_bytes, to_text
 
 from .utils import CaptureStd, find_executable, get_module_name_from_filename
 

ansible_test/_util/controller/sanity/validate-modules/validate_modules/utils.py

@@ -28,7 +28,7 @@ from io import BytesIO, TextIOWrapper
 import yaml
 import yaml.reader
 
-from ansible.module_utils._text import to_text
+from ansible.module_utils.common.text.converters import to_text
 from ansible.module_utils.basic import AnsibleModule
 from ansible.module_utils.common.yaml import SafeLoader
 from ansible.module_utils.six import string_types

ansible_test/_util/controller/sanity/yamllint/yamllinter.py

@@ -181,15 +181,15 @@ class YamlChecker:
                 if doc_types and target.id not in doc_types:
                     continue
 
-                fmt_match = fmt_re.match(statement.value.s.lstrip())
+                fmt_match = fmt_re.match(statement.value.value.lstrip())
                 fmt = 'yaml'
                 if fmt_match:
                     fmt = fmt_match.group(1)
 
                 docs[target.id] = dict(
-                    yaml=statement.value.s,
+                    yaml=statement.value.value,
                     lineno=statement.lineno,
-                    end_lineno=statement.lineno + len(statement.value.s.splitlines()),
+                    end_lineno=statement.lineno + len(statement.value.value.splitlines()),
                     fmt=fmt.lower(),
                 )
 

ansible_test/_util/controller/tools/collection_detail.py

@@ -50,7 +50,7 @@ def read_manifest_json(collection_path):
         )
         validate_version(result['version'])
     except Exception as ex:  # pylint: disable=broad-except
-        raise Exception('{0}: {1}'.format(os.path.basename(manifest_path), ex))
+        raise Exception('{0}: {1}'.format(os.path.basename(manifest_path), ex)) from None
 
     return result
 
@@ -71,7 +71,7 @@ def read_galaxy_yml(collection_path):
         )
         validate_version(result['version'])
     except Exception as ex:  # pylint: disable=broad-except
-        raise Exception('{0}: {1}'.format(os.path.basename(galaxy_path), ex))
+        raise Exception('{0}: {1}'.format(os.path.basename(galaxy_path), ex)) from None
 
     return result
 

ansible_test/_util/target/common/constants.py

@@ -7,14 +7,14 @@ __metaclass__ = type
 
 REMOTE_ONLY_PYTHON_VERSIONS = (
     '2.7',
-    '3.5',
     '3.6',
     '3.7',
     '3.8',
+    '3.9',
 )
 
 CONTROLLER_PYTHON_VERSIONS = (
-    '3.9',
     '3.10',
     '3.11',
+    '3.12',
 )

ansible_test/_util/target/pytest/plugins/ansible_forked.py

@@ -0,0 +1,103 @@
+"""Run each test in its own fork. PYTEST_DONT_REWRITE"""
+# MIT License (see licenses/MIT-license.txt or https://opensource.org/licenses/MIT)
+# Based on code originally from:
+# https://github.com/pytest-dev/pytest-forked
+# https://github.com/pytest-dev/py
+# TIP: Disable pytest-xdist when debugging internal errors in this plugin.
+from __future__ import absolute_import, division, print_function
+
+__metaclass__ = type
+
+import os
+import pickle
+import tempfile
+import warnings
+
+from pytest import Item, hookimpl
+
+try:
+    from pytest import TestReport
+except ImportError:
+    from _pytest.runner import TestReport  # Backwards compatibility with pytest < 7. Remove once Python 2.7 is not supported.
+
+from _pytest.runner import runtestprotocol
+
+
+@hookimpl(tryfirst=True)
+def pytest_runtest_protocol(item, nextitem):  # type: (Item, Item | None) -> object | None
+    """Entry point for enabling this plugin."""
+    # This is needed because pytest-xdist creates an OS thread (using execnet).
+    # See: https://github.com/pytest-dev/execnet/blob/d6aa1a56773c2e887515d63e50b1d08338cb78a7/execnet/gateway_base.py#L51
+    warnings.filterwarnings("ignore", "^This process .* is multi-threaded, use of .* may lead to deadlocks in the child.$", DeprecationWarning)
+
+    item_hook = item.ihook
+    item_hook.pytest_runtest_logstart(nodeid=item.nodeid, location=item.location)
+
+    reports = run_item(item, nextitem)
+
+    for report in reports:
+        item_hook.pytest_runtest_logreport(report=report)
+
+    item_hook.pytest_runtest_logfinish(nodeid=item.nodeid, location=item.location)
+
+    return True
+
+
+def run_item(item, nextitem):  # type: (Item, Item | None) -> list[TestReport]
+    """Run the item in a child process and return a list of reports."""
+    with tempfile.NamedTemporaryFile() as temp_file:
+        pid = os.fork()
+
+        if not pid:
+            temp_file.delete = False
+            run_child(item, nextitem, temp_file.name)
+
+        return run_parent(item, pid, temp_file.name)
+
+
+def run_child(item, nextitem, result_path):  # type: (Item, Item | None, str) -> None
+    """Run the item, record the result and exit. Called in the child process."""
+    with warnings.catch_warnings(record=True) as captured_warnings:
+        reports = runtestprotocol(item, nextitem=nextitem, log=False)
+
+    with open(result_path, "wb") as result_file:
+        pickle.dump((reports, captured_warnings), result_file)
+
+    os._exit(0)  # noqa
+
+
+def run_parent(item, pid, result_path):  # type: (Item, int, str) -> list[TestReport]
+    """Wait for the child process to exit and return the test reports. Called in the parent process."""
+    exit_code = waitstatus_to_exitcode(os.waitpid(pid, 0)[1])
+
+    if exit_code:
+        reason = "Test CRASHED with exit code {}.".format(exit_code)
+        report = TestReport(item.nodeid, item.location, {x: 1 for x in item.keywords}, "failed", reason, "call", user_properties=item.user_properties)
+
+        if item.get_closest_marker("xfail"):
+            report.outcome = "skipped"
+            report.wasxfail = reason
+
+        reports = [report]
+    else:
+        with open(result_path, "rb") as result_file:
+            reports, captured_warnings = pickle.load(result_file)  # type: list[TestReport], list[warnings.WarningMessage]
+
+        for warning in captured_warnings:
+            warnings.warn_explicit(warning.message, warning.category, warning.filename, warning.lineno)
+
+    return reports
+
+
+def waitstatus_to_exitcode(status):  # type: (int) -> int
+    """Convert a wait status to an exit code."""
+    # This function was added in Python 3.9.
+    # See: https://docs.python.org/3/library/os.html#os.waitstatus_to_exitcode
+
+    if os.WIFEXITED(status):
+        return os.WEXITSTATUS(status)
+
+    if os.WIFSIGNALED(status):
+        return -os.WTERMSIG(status)
+
+    raise ValueError(status)

ansible_test/_util/target/sanity/import/importer.py

@@ -552,14 +552,6 @@ def main():
                     "Python 2 is no longer supported by the Python core team. Support for it is now deprecated in cryptography,"
                     " and will be removed in the next release.")
 
-            if sys.version_info[:2] == (3, 5):
-                warnings.filterwarnings(
-                    "ignore",
-                    "Python 3.5 support will be dropped in the next release ofcryptography. Please upgrade your Python.")
-                warnings.filterwarnings(
-                    "ignore",
-                    "Python 3.5 support will be dropped in the next release of cryptography. Please upgrade your Python.")
-
             try:
                 yield
             finally:

ansible_test/_util/target/setup/bootstrap.sh

@@ -53,7 +53,7 @@ install_pip() {
                 pip_bootstrap_url="https://ci-files.testing.ansible.com/ansible-test/get-pip-20.3.4.py"
                 ;;
             *)
-                pip_bootstrap_url="https://ci-files.testing.ansible.com/ansible-test/get-pip-21.3.1.py"
+                pip_bootstrap_url="https://ci-files.testing.ansible.com/ansible-test/get-pip-23.1.2.py"
                 ;;
         esac
 
@@ -163,8 +163,6 @@ bootstrap_remote_freebsd()
         # Declare platform/python version combinations which do not have supporting OS packages available.
         # For these combinations ansible-test will use pip to install the requirements instead.
         case "${platform_version}/${python_version}" in
-            "12.4/3.9")
-                ;;
             *)
                 jinja2_pkg=""  # not available
                 cryptography_pkg=""  # not available
@@ -261,7 +259,7 @@ bootstrap_remote_rhel_8()
     if [ "${python_version}" = "3.6" ]; then
         py_pkg_prefix="python3"
     else
-        py_pkg_prefix="python${python_package_version}"
+        py_pkg_prefix="python${python_version}"
     fi
 
     packages="
@@ -269,6 +267,14 @@ bootstrap_remote_rhel_8()
         ${py_pkg_prefix}-devel
         "
 
+    # pip isn't included in the Python devel package under Python 3.11
+    if [ "${python_version}" != "3.6" ]; then
+        packages="
+            ${packages}
+            ${py_pkg_prefix}-pip
+        "
+    fi
+
     # Jinja2 is not installed with an OS package since the provided version is too old.
     # Instead, ansible-test will install it using pip.
     if [ "${controller}" ]; then
@@ -278,9 +284,19 @@ bootstrap_remote_rhel_8()
             "
     fi
 
+    # Python 3.11 isn't a module like the earlier versions
+    if [ "${python_version}" = "3.6" ]; then
+        while true; do
+            # shellcheck disable=SC2086
+            yum module install -q -y "python${python_package_version}" \
+            && break
+            echo "Failed to install packages. Sleeping before trying again..."
+            sleep 10
+        done
+    fi
+
     while true; do
         # shellcheck disable=SC2086
-        yum module install -q -y "python${python_package_version}" && \
         yum install -q -y ${packages} \
         && break
         echo "Failed to install packages. Sleeping before trying again..."
@@ -292,22 +308,34 @@ bootstrap_remote_rhel_8()
 
 bootstrap_remote_rhel_9()
 {
-    py_pkg_prefix="python3"
+    if [ "${python_version}" = "3.9" ]; then
+        py_pkg_prefix="python3"
+    else
+        py_pkg_prefix="python${python_version}"
+    fi
 
     packages="
         gcc
         ${py_pkg_prefix}-devel
         "
 
+    # pip is not included in the Python devel package under Python 3.11
+    if [ "${python_version}" != "3.9" ]; then
+        packages="
+            ${packages}
+            ${py_pkg_prefix}-pip
+        "
+    fi
+
     # Jinja2 is not installed with an OS package since the provided version is too old.
     # Instead, ansible-test will install it using pip.
+    # packaging and resolvelib are missing for Python 3.11 (and possible later) so we just
+    # skip them and let ansible-test install them from PyPI.
     if [ "${controller}" ]; then
         packages="
             ${packages}
             ${py_pkg_prefix}-cryptography
-            ${py_pkg_prefix}-packaging
             ${py_pkg_prefix}-pyyaml
-            ${py_pkg_prefix}-resolvelib
             "
     fi
 
@@ -387,14 +415,6 @@ bootstrap_remote_ubuntu()
         echo "Failed to install packages. Sleeping before trying again..."
         sleep 10
     done
-
-    if [ "${controller}" ]; then
-        if [ "${platform_version}/${python_version}" = "20.04/3.9" ]; then
-            # Install pyyaml using pip so libyaml support is available on Python 3.9.
-            # The OS package install (which is installed by default) only has a .so file for Python 3.8.
-            pip_install "--upgrade pyyaml"
-        fi
-    fi
 }
 
 bootstrap_docker()

ansible_test/_util/target/setup/quiet_pip.py

@@ -27,10 +27,6 @@ WARNING_MESSAGE_FILTERS = (
     # pip 21.0 will drop support for Python 2.7 in January 2021.
     # More details about Python 2 support in pip, can be found at https://pip.pypa.io/en/latest/development/release-process/#python-2-support
     'DEPRECATION: Python 2.7 reached the end of its life ',
-
-    # DEPRECATION: Python 3.5 reached the end of its life on September 13th, 2020. Please upgrade your Python as Python 3.5 is no longer maintained.
-    # pip 21.0 will drop support for Python 3.5 in January 2021. pip 21.0 will remove support for this functionality.
-    'DEPRECATION: Python 3.5 reached the end of its life ',
 )