ansible-core 2.18.4rc1__py3-none-any.whl → 2.19.0b1__py3-none-any.whl

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

@@ -1,4 +1,5 @@
 """Import the given python module(s) and report error(s) encountered."""
+
 from __future__ import annotations
 
 
@@ -43,6 +44,7 @@ def main():
         # noinspection PyCompatibility
         from importlib import import_module
     except ImportError:
+
         def import_module(name, package=None):  # type: (str, str | None) -> types.ModuleType
             assert package is None
             __import__(name)
@@ -60,11 +62,10 @@ def main():
 
     if collection_full_name:
         # allow importing code from collections when testing a collection
-        from ansible.module_utils.common.text.converters import to_bytes, to_text, to_native, text_type
 
         # noinspection PyProtectedMember
         from ansible.utils.collection_loader._collection_finder import _AnsibleCollectionFinder
-        from ansible.utils.collection_loader import _collection_finder
+        from ansible.utils.collection_loader import _collection_finder, _to_text
 
         yaml_to_dict_cache = {}
 
@@ -74,7 +75,7 @@ def main():
 
         def parse_value(value):
             """Custom value parser for JSON deserialization that recognizes our internal ISO date format."""
-            if isinstance(value, text_type):
+            if isinstance(value, str):
                 match = iso_date_re.search(value)
 
                 if match:
@@ -86,7 +87,7 @@ def main():
             """Object hook for custom ISO date deserialization from JSON."""
             return dict((key, parse_value(value)) for key, value in data.items())
 
-        def yaml_to_dict(yaml, content_id):
+        def yaml_to_dict(yaml: str | bytes, content_id):
             """
             Return a Python dict version of the provided YAML.
             Conversion is done in a subprocess since the current Python interpreter does not have access to PyYAML.
@@ -96,18 +97,18 @@ def main():
 
             try:
                 cmd = [external_python, yaml_to_json_path]
-                proc = subprocess.Popen([to_bytes(c) for c in cmd],  # pylint: disable=consider-using-with
-                                        stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
-                stdout_bytes, stderr_bytes = proc.communicate(to_bytes(yaml))
+                proc = subprocess.Popen(cmd,  # pylint: disable=consider-using-with
+                                        stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
+                stdout, stderr = proc.communicate(_to_text(yaml))
 
                 if proc.returncode != 0:
-                    raise Exception('command %s failed with return code %d: %s' % ([to_native(c) for c in cmd], proc.returncode, to_native(stderr_bytes)))
+                    raise Exception('command %s failed with return code %d: %s' % (cmd, proc.returncode, stderr))
 
-                data = yaml_to_dict_cache[content_id] = json.loads(to_text(stdout_bytes), object_hook=object_hook)
+                data = yaml_to_dict_cache[content_id] = json.loads(stdout, object_hook=object_hook)
 
                 return data
             except Exception as ex:
-                raise Exception('internal importer error - failed to parse yaml: %s' % to_native(ex))
+                raise Exception(f'internal importer error - failed to parse yaml: {ex}')
 
         _collection_finder._meta_yml_to_dict = yaml_to_dict  # pylint: disable=protected-access
 
@@ -142,11 +143,13 @@ def main():
 
     class ImporterAnsibleModule:
         """Replacement for AnsibleModule to support import testing."""
+
         def __init__(self, *args, **kwargs):
             raise ImporterAnsibleModuleException()
 
     class RestrictedModuleLoader:
         """Python module loader that restricts inappropriate imports."""
+
         def __init__(self, path, name, restrict_to_module_paths):
             self.path = path
             self.name = name
@@ -431,6 +434,7 @@ def main():
 
     class Capture:
         """Captured output and/or exception."""
+
         def __init__(self):
             # use buffered IO to simulate StringIO; allows Ansible's stream patching to behave without warnings
             self.stdout = TextIOWrapper(BytesIO())
@@ -489,6 +493,7 @@ def main():
         finally:
             if import_type == 'plugin' and not collection_loader:
                 from ansible.utils.collection_loader._collection_finder import _AnsibleCollectionFinder
+
                 _AnsibleCollectionFinder._remove()  # pylint: disable=protected-access
 
             if sys.meta_path[0] != restricted_loader:
@@ -541,12 +546,6 @@ def main():
                     "ignore",
                     "AnsibleCollectionFinder has already been configured")
 
-            # ansible.utils.unsafe_proxy attempts patching sys.intern generating a warning if it was already patched
-            warnings.filterwarnings(
-                "ignore",
-                "skipped sys.intern patch; appears to have already been patched"
-            )
-
             try:
                 yield
             finally:

ansible_test/_util/target/setup/bootstrap.sh

@@ -26,13 +26,13 @@ install_ssh_keys()
         echo "${ssh_private_key}" > "${ssh_private_key_path}"
 
         # add public key to authorized_keys
-        authoried_keys_path="${HOME}/.ssh/authorized_keys"
+        authorized_keys_path="${HOME}/.ssh/authorized_keys"
 
         # the existing file is overwritten to avoid conflicts (ex: RHEL on EC2 blocks root login)
-        cat "${public_key_path}" > "${authoried_keys_path}"
-        chmod 0600 "${authoried_keys_path}"
+        cat "${public_key_path}" > "${authorized_keys_path}"
+        chmod 0600 "${authorized_keys_path}"
 
-        # add localhost's server keys to known_hosts
+        # add localhost server keys to known_hosts
         known_hosts_path="${HOME}/.ssh/known_hosts"
 
         for key in /etc/ssh/ssh_host_*_key.pub; do
@@ -154,6 +154,7 @@ bootstrap_remote_freebsd()
         py${python_package_version}-sqlite3
         py${python_package_version}-setuptools
         bash
+        ca_root_nss
         curl
         gtar
         sudo
@@ -162,27 +163,14 @@ bootstrap_remote_freebsd()
     if [ "${controller}" ]; then
         jinja2_pkg="py${python_package_version}-jinja2"
         cryptography_pkg="py${python_package_version}-cryptography"
-        pyyaml_pkg="py${python_package_version}-yaml"
+        pyyaml_pkg="py${python_package_version}-pyyaml"
         packaging_pkg="py${python_package_version}-packaging"
 
         # 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
-            13.3/3.9)
-                # defaults above 'just work'TM
-                ;;
-            13.3/3.11)
-                jinja2_pkg=""  # not available
-                cryptography_pkg=""  # not available
-                pyyaml_pkg=""  # not available
-                ;;
-            14.1/3.9)
-                # defaults above 'just work'TM
-                ;;
-            14.1/3.11)
-                cryptography_pkg=""  # not available
-                jinja2_pkg=""  # not available
-                pyyaml_pkg=""  # not available
+            14.2/3.11)
+                # defaults available
                 ;;
             *)
                 # just assume nothing is available
@@ -238,6 +226,7 @@ prefer-binary = yes
 
     # enable sudo without a password for the wheel group, allowing ansible to use the sudo become plugin
     echo '%wheel ALL=(ALL:ALL) NOPASSWD: ALL' > /usr/local/etc/sudoers.d/ansible-test
+    chmod 440 /usr/local/etc/sudoers.d/ansible-test
 }
 
 bootstrap_remote_macos()

ansible_test/_util/target/setup/probe_cgroups.py

@@ -1,4 +1,5 @@
 """A tool for probing cgroups to determine write access."""
+
 from __future__ import annotations
 
 import json

ansible_test/_util/target/setup/quiet_pip.py

@@ -1,4 +1,5 @@
 """Custom entry-point for pip that filters out unwanted logging and warnings."""
+
 from __future__ import annotations
 
 import logging

ansible_test/_util/target/setup/requirements.py

@@ -1,4 +1,5 @@
 """A tool for installing test requirements on the controller and target host."""
+
 from __future__ import annotations
 
 # pylint: disable=wrong-import-position
@@ -62,13 +63,15 @@ def main():  # type: () -> None
 
 
 # noinspection PyUnusedLocal
-def bootstrap(pip, options):  # type: (str, t.Dict[str, t.Any]) -> None
+def bootstrap(pip: str, options: dict[str, t.Any]) -> None:
     """Bootstrap pip and related packages in an empty virtual environment."""
     pip_version = options['pip_version']
     packages = options['packages']
     setuptools = options['setuptools']
     wheel = options['wheel']
 
+    del options
+
     url = 'https://ci-files.testing.ansible.com/ansible-test/get-pip-%s.py' % pip_version
     cache_path = os.path.expanduser('~/.ansible/test/cache/get_pip_%s.py' % pip_version.replace(".", "_"))
     temp_path = cache_path + '.download'
@@ -83,7 +86,7 @@ def bootstrap(pip, options):  # type: (str, t.Dict[str, t.Any]) -> None
         try:
             download_file(url, temp_path)
         except Exception as ex:
-            raise ApplicationError(('''
+            raise ApplicationError(("""
 Download failed: %s
 
 The bootstrap script can be manually downloaded and saved to: %s
@@ -91,7 +94,7 @@ The bootstrap script can be manually downloaded and saved to: %s
 If you're behind a proxy, consider commenting on the following GitHub issue:
 
 https://github.com/ansible/ansible/issues/77304
-''' % (ex, cache_path)).strip())
+""" % (ex, cache_path)).strip())
 
         shutil.move(temp_path, cache_path)
 
@@ -100,31 +103,33 @@ https://github.com/ansible/ansible/issues/77304
     env = common_pip_environment()
     env.update(GET_PIP=cache_path)
 
-    options = common_pip_options()
-    options.extend(packages)
+    pip_options = common_pip_options()
+    pip_options.extend(packages)
 
     if not setuptools:
-        options.append('--no-setuptools')
+        pip_options.append('--no-setuptools')
 
     if not wheel:
-        options.append('--no-wheel')
+        pip_options.append('--no-wheel')
 
-    command = [sys.executable, pip] + options
+    command = [sys.executable, pip] + pip_options
 
     execute_command(command, env=env)
 
 
-def install(pip, options):  # type: (str, t.Dict[str, t.Any]) -> None
+def install(pip: str, options: dict[str, t.Any]) -> None:
     """Perform a pip install."""
     requirements = options['requirements']
     constraints = options['constraints']
     packages = options['packages']
 
+    del options
+
     tempdir = tempfile.mkdtemp(prefix='ansible-test-', suffix='-requirements')
 
     try:
-        options = common_pip_options()
-        options.extend(packages)
+        pip_options = common_pip_options()
+        pip_options.extend(packages)
 
         for path, content in requirements:
             if path.split(os.sep)[0] in ('test', 'requirements'):
@@ -136,13 +141,13 @@ def install(pip, options):  # type: (str, t.Dict[str, t.Any]) -> None
                     pre_build.execute(pip)
 
             write_text_file(os.path.join(tempdir, path), content, True)
-            options.extend(['-r', path])
+            pip_options.extend(['-r', path])
 
         for path, content in constraints:
             write_text_file(os.path.join(tempdir, path), content, True)
-            options.extend(['-c', path])
+            pip_options.extend(['-c', path])
 
-        command = [sys.executable, pip, 'install'] + options
+        command = [sys.executable, pip, 'install'] + pip_options
 
         env = common_pip_environment()
 
@@ -163,8 +168,8 @@ class PreBuild:
         tempdir = tempfile.mkdtemp(prefix='ansible-test-', suffix='-pre-build')
 
         try:
-            options = common_pip_options()
-            options.append(self.requirement)
+            pip_options = common_pip_options()
+            pip_options.append(self.requirement)
 
             constraints = '\n'.join(self.constraints) + '\n'
             constraints_path = os.path.join(tempdir, 'constraints.txt')
@@ -174,7 +179,7 @@ class PreBuild:
             env = common_pip_environment()
             env.update(PIP_CONSTRAINT=constraints_path)
 
-            command = [sys.executable, pip, 'wheel'] + options
+            command = [sys.executable, pip, 'wheel'] + pip_options
 
             execute_command(command, env=env, cwd=tempdir)
         finally:
@@ -206,15 +211,17 @@ def parse_pre_build_instructions(requirements):  # type: (str) -> list[PreBuild]
     return instructions
 
 
-def uninstall(pip, options):  # type: (str, t.Dict[str, t.Any]) -> None
+def uninstall(pip: str, options: dict[str, t.Any]) -> None:
     """Perform a pip uninstall."""
     packages = options['packages']
     ignore_errors = options['ignore_errors']
 
-    options = common_pip_options()
-    options.extend(packages)
+    del options
+
+    pip_options = common_pip_options()
+    pip_options.extend(packages)
 
-    command = [sys.executable, pip, 'uninstall', '-y'] + options
+    command = [sys.executable, pip, 'uninstall', '-y'] + pip_options
 
     env = common_pip_environment()
 
@@ -226,13 +233,13 @@ def uninstall(pip, options):  # type: (str, t.Dict[str, t.Any]) -> None
 
 
 # noinspection PyUnusedLocal
-def version(pip, options):  # type: (str, t.Dict[str, t.Any]) -> None
+def version(pip: str, options: dict[str, t.Any]) -> None:
     """Report the pip version."""
     del options
 
-    options = common_pip_options()
+    pip_options = common_pip_options()
 
-    command = [sys.executable, pip, '-V'] + options
+    command = [sys.executable, pip, '-V'] + pip_options
 
     env = common_pip_environment()
 
@@ -264,11 +271,11 @@ def common_pip_options():  # type: () -> t.List[str]
 def devnull():  # type: () -> t.IO[bytes]
     """Return a file object that references devnull."""
     try:
-        return devnull.file
+        return devnull.file  # type: ignore[attr-defined]
     except AttributeError:
-        devnull.file = open(os.devnull, 'w+b')  # pylint: disable=consider-using-with
+        devnull.file = open(os.devnull, 'w+b')  # type: ignore[attr-defined]  # pylint: disable=consider-using-with
 
-    return devnull.file
+    return devnull.file  # type: ignore[attr-defined]
 
 
 def download_file(url, path):  # type: (str, str) -> None
@@ -284,6 +291,7 @@ class ApplicationError(Exception):
 
 class SubprocessError(ApplicationError):
     """A command returned a non-zero status."""
+
     def __init__(self, cmd, status, stdout, stderr):  # type: (t.List[str], int, str, str) -> None
         message = 'A command failed with status %d: %s' % (status, shlex.join(cmd))
 

ansible_test/_util/target/tools/virtualenvcheck.py

@@ -1,11 +1,12 @@
 """Detect the real python interpreter when running in a virtual environment created by the 'virtualenv' module."""
+
 from __future__ import annotations
 
 import json
 
 try:
     # virtualenv <20
-    from sys import real_prefix
+    from sys import real_prefix  # type: ignore[attr-defined]
 except ImportError:
     real_prefix = None
 

ansible_test/_util/target/tools/yamlcheck.py

@@ -1,4 +1,5 @@
 """Show availability of PyYAML and libyaml support."""
+
 from __future__ import annotations
 
 import json
@@ -11,7 +12,7 @@ except ImportError:
 try:
     from yaml import CLoader
 except ImportError:
-    CLoader = None
+    CLoader = None  # type: ignore[misc]
 
 print(json.dumps(dict(
     yaml=bool(yaml),

ansible/compat/selectors.py

@@ -1,32 +0,0 @@
-# (c) 2014, 2017 Toshio Kuratomi <tkuratomi@ansible.com>
-#
-# This file is part of Ansible
-#
-# Ansible is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ansible is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with Ansible.  If not, see <http://www.gnu.org/licenses/>.
-
-from __future__ import annotations
-
-import sys
-import selectors
-
-from ansible.module_utils.common.warnings import deprecate
-
-
-sys.modules['ansible.compat.selectors'] = selectors
-
-
-deprecate(
-    msg='The `ansible.module_utils.compat.selectors` module is deprecated.',
-    version='2.19',
-)

ansible/errors/yaml_strings.py

@@ -1,138 +0,0 @@
-# (c) 2012-2014, Michael DeHaan <michael.dehaan@gmail.com>
-#
-# This file is part of Ansible
-#
-# Ansible is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ansible is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with Ansible. If not, see <http://www.gnu.org/licenses/>.
-
-from __future__ import annotations
-
-__all__ = [
-    'YAML_SYNTAX_ERROR',
-    'YAML_POSITION_DETAILS',
-    'YAML_COMMON_DICT_ERROR',
-    'YAML_COMMON_UNQUOTED_VARIABLE_ERROR',
-    'YAML_COMMON_UNQUOTED_COLON_ERROR',
-    'YAML_COMMON_PARTIALLY_QUOTED_LINE_ERROR',
-    'YAML_COMMON_UNBALANCED_QUOTES_ERROR',
-]
-
-YAML_SYNTAX_ERROR = """\
-Syntax Error while loading YAML.
-  %s"""
-
-YAML_POSITION_DETAILS = """\
-The error appears to be in '%s': line %s, column %s, but may
-be elsewhere in the file depending on the exact syntax problem.
-"""
-
-YAML_COMMON_DICT_ERROR = """\
-This one looks easy to fix. YAML thought it was looking for the start of a
-hash/dictionary and was confused to see a second "{". Most likely this was
-meant to be an ansible template evaluation instead, so we have to give the
-parser a small hint that we wanted a string instead. The solution here is to
-just quote the entire value.
-
-For instance, if the original line was:
-
-    app_path: {{ base_path }}/foo
-
-It should be written as:
-
-    app_path: "{{ base_path }}/foo"
-"""
-
-YAML_COMMON_UNQUOTED_VARIABLE_ERROR = """\
-We could be wrong, but this one looks like it might be an issue with
-missing quotes. Always quote template expression brackets when they
-start a value. For instance:
-
-    with_items:
-      - {{ foo }}
-
-Should be written as:
-
-    with_items:
-      - "{{ foo }}"
-"""
-
-YAML_COMMON_UNQUOTED_COLON_ERROR = """\
-This one looks easy to fix. There seems to be an extra unquoted colon in the line
-and this is confusing the parser. It was only expecting to find one free
-colon. The solution is just add some quotes around the colon, or quote the
-entire line after the first colon.
-
-For instance, if the original line was:
-
-    copy: src=file.txt dest=/path/filename:with_colon.txt
-
-It can be written as:
-
-    copy: src=file.txt dest='/path/filename:with_colon.txt'
-
-Or:
-
-    copy: 'src=file.txt dest=/path/filename:with_colon.txt'
-"""
-
-YAML_COMMON_PARTIALLY_QUOTED_LINE_ERROR = """\
-This one looks easy to fix. It seems that there is a value started
-with a quote, and the YAML parser is expecting to see the line ended
-with the same kind of quote. For instance:
-
-    when: "ok" in result.stdout
-
-Could be written as:
-
-   when: '"ok" in result.stdout'
-
-Or equivalently:
-
-   when: "'ok' in result.stdout"
-"""
-
-YAML_COMMON_UNBALANCED_QUOTES_ERROR = """\
-We could be wrong, but this one looks like it might be an issue with
-unbalanced quotes. If starting a value with a quote, make sure the
-line ends with the same set of quotes. For instance this arbitrary
-example:
-
-    foo: "bad" "wolf"
-
-Could be written as:
-
-    foo: '"bad" "wolf"'
-"""
-
-YAML_COMMON_LEADING_TAB_ERROR = """\
-There appears to be a tab character at the start of the line.
-
-YAML does not use tabs for formatting. Tabs should be replaced with spaces.
-
-For example:
-    - name: update tooling
-      vars:
-        version: 1.2.3
-#    ^--- there is a tab there.
-
-Should be written as:
-    - name: update tooling
-      vars:
-        version: 1.2.3
-# ^--- all spaces here.
-"""
-
-YAML_AND_SHORTHAND_ERROR = """\
-There appears to be both 'k=v' shorthand syntax and YAML in this task. \
-Only one syntax may be used.
-"""

ansible/executor/action_write_locks.py

@@ -1,44 +0,0 @@
-# (c) 2016 - Red Hat, Inc. <info@ansible.com>
-#
-# This file is part of Ansible
-#
-# Ansible is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ansible is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with Ansible.  If not, see <http://www.gnu.org/licenses/>.
-
-from __future__ import annotations
-
-import multiprocessing.synchronize
-
-from ansible.utils.multiprocessing import context as multiprocessing_context
-
-from ansible.module_utils.facts.system.pkg_mgr import PKG_MGRS
-
-if 'action_write_locks' not in globals():
-    # Do not initialize this more than once because it seems to bash
-    # the existing one.  multiprocessing must be reloading the module
-    # when it forks?
-    action_write_locks: dict[str | None, multiprocessing.synchronize.Lock] = dict()
-
-    # Below is a Lock for use when we weren't expecting a named module.  It gets used when an action
-    # plugin invokes a module whose name does not match with the action's name.  Slightly less
-    # efficient as all processes with unexpected module names will wait on this lock
-    action_write_locks[None] = multiprocessing_context.Lock()
-
-    # These plugins are known to be called directly by action plugins with names differing from the
-    # action plugin name.  We precreate them here as an optimization.
-    # If a list of service managers is created in the future we can do the same for them.
-    mods = set(p['name'] for p in PKG_MGRS)
-
-    mods.update(('copy', 'file', 'setup', 'slurp', 'stat'))
-    for mod_name in mods:
-        action_write_locks[mod_name] = multiprocessing_context.Lock()

ansible/executor/discovery/python_target.py

@@ -1,47 +0,0 @@
-# Copyright: (c) 2018 Ansible Project
-# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
-
-# FUTURE: this could be swapped out for our bundled version of distro to move more complete platform
-# logic to the targets, so long as we maintain Py2.6 compat and don't need to do any kind of script assembly
-
-from __future__ import annotations
-
-import json
-import platform
-import io
-import os
-
-
-def read_utf8_file(path, encoding='utf-8'):
-    if not os.access(path, os.R_OK):
-        return None
-    with io.open(path, 'r', encoding=encoding) as fd:
-        content = fd.read()
-
-    return content
-
-
-def get_platform_info():
-    result = dict(platform_dist_result=[])
-
-    if hasattr(platform, 'dist'):
-        result['platform_dist_result'] = platform.dist()
-
-    osrelease_content = read_utf8_file('/etc/os-release')
-    # try to fall back to /usr/lib/os-release
-    if not osrelease_content:
-        osrelease_content = read_utf8_file('/usr/lib/os-release')
-
-    result['osrelease_content'] = osrelease_content
-
-    return result
-
-
-def main():
-    info = get_platform_info()
-
-    print(json.dumps(info))
-
-
-if __name__ == '__main__':
-    main()