ansible-core 2.16.7rc1__py3-none-any.whl → 2.17.0__py3-none-any.whl

ansible/plugins/strategy/linear.py

@@ -14,9 +14,7 @@
 #
 # You should have received a copy of the GNU General Public License
 # along with Ansible.  If not, see <http://www.gnu.org/licenses/>.
-# Make coding more python3-ish
-from __future__ import (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 DOCUMENTATION = '''
     name: linear
@@ -33,7 +31,7 @@ DOCUMENTATION = '''
 
 from ansible import constants as C
 from ansible.errors import AnsibleError, AnsibleAssertionError, AnsibleParserError
-from ansible.executor.play_iterator import IteratingStates, FailedStates
+from ansible.executor.play_iterator import IteratingStates
 from ansible.module_utils.common.text.converters import to_text
 from ansible.playbook.handler import Handler
 from ansible.playbook.included_file import IncludedFile
@@ -293,7 +291,12 @@ class StrategyModule(StrategyBase):
                                 )
                             else:
                                 is_handler = isinstance(included_file._task, Handler)
-                                new_blocks = self._load_included_file(included_file, iterator=iterator, is_handler=is_handler)
+                                new_blocks = self._load_included_file(
+                                    included_file,
+                                    iterator=iterator,
+                                    is_handler=is_handler,
+                                    handle_stats_and_callbacks=False,
+                                )
 
                             # let PlayIterator know about any new handlers included via include_role or
                             # import_role within include_role/include_taks
@@ -326,13 +329,19 @@ class StrategyModule(StrategyBase):
                         except AnsibleParserError:
                             raise
                         except AnsibleError as e:
-                            if included_file._is_role:
-                                # include_role does not have on_include callback so display the error
-                                display.error(to_text(e), wrap_text=False)
+                            display.error(to_text(e), wrap_text=False)
                             for r in included_file._results:
                                 r._result['failed'] = True
+                                r._result['reason'] = str(e)
+                                self._tqm._stats.increment('failures', r._host.name)
+                                self._tqm.send_callback('v2_runner_on_failed', r)
                                 failed_includes_hosts.add(r._host)
-                            continue
+                        else:
+                            # since we skip incrementing the stats when the task result is
+                            # first processed, we do so now for each host in the list
+                            for host in included_file._hosts:
+                                self._tqm._stats.increment('ok', host.name)
+                            self._tqm.send_callback('v2_playbook_on_include', included_file)
 
                     for host in failed_includes_hosts:
                         self._tqm._failed_hosts[host.name] = True
@@ -356,25 +365,16 @@ class StrategyModule(StrategyBase):
                 failed_hosts = []
                 unreachable_hosts = []
                 for res in results:
-                    # execute_meta() does not set 'failed' in the TaskResult
-                    # so we skip checking it with the meta tasks and look just at the iterator
-                    if (res.is_failed() or res._task.action in C._ACTION_META) and iterator.is_failed(res._host):
+                    if res.is_failed():
                         failed_hosts.append(res._host.name)
                     elif res.is_unreachable():
                         unreachable_hosts.append(res._host.name)
 
-                # if any_errors_fatal and we had an error, mark all hosts as failed
-                if any_errors_fatal and (len(failed_hosts) > 0 or len(unreachable_hosts) > 0):
-                    dont_fail_states = frozenset([IteratingStates.RESCUE, IteratingStates.ALWAYS])
+                if any_errors_fatal and (failed_hosts or unreachable_hosts):
                     for host in hosts_left:
-                        (s, dummy) = iterator.get_next_task_for_host(host, peek=True)
-                        # the state may actually be in a child state, use the get_active_state()
-                        # method in the iterator to figure out the true active state
-                        s = iterator.get_active_state(s)
-                        if s.run_state not in dont_fail_states or \
-                           s.run_state == IteratingStates.RESCUE and s.fail_state & FailedStates.RESCUE != 0:
+                        if host.name not in failed_hosts:
                             self._tqm._failed_hosts[host.name] = True
-                            result |= self._tqm.RUN_FAILED_BREAK_PLAY
+                            iterator.mark_host_failed(host)
                 display.debug("done checking for any_errors_fatal")
 
                 display.debug("checking for max_fail_percentage")

ansible/plugins/terminal/__init__.py

@@ -16,8 +16,7 @@
 # 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 (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 import re
 
@@ -85,7 +84,7 @@ class TerminalBase(ABC):
 
         This method is called right after the invoke_shell() is called from
         the Paramiko SSHClient instance.  It provides an opportunity to setup
-        terminal parameters such as disbling paging for instance.
+        terminal parameters such as disabling paging for instance.
         """
         pass
 

ansible/plugins/test/__init__.py

@@ -1,8 +1,7 @@
 # (c) Ansible Project
 # GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
 
-from __future__ import (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 from ansible.plugins import AnsibleJinja2Plugin
 

ansible/plugins/test/change.yml

@@ -6,7 +6,7 @@ DOCUMENTATION:
   aliases: [change]
   description:
     - Tests if task required changes to complete
-    - This test checks for the existance of a C(changed) key in the input dictionary and that it is V(True) if present
+    - This test checks for the existence of a C(changed) key in the input dictionary and that it is V(True) if present
   options:
     _input:
       description: registered result from an Ansible task

ansible/plugins/test/changed.yml

@@ -6,7 +6,7 @@ DOCUMENTATION:
   aliases: [change]
   description:
     - Tests if task required changes to complete
-    - This test checks for the existance of a C(changed) key in the input dictionary and that it is V(True) if present
+    - This test checks for the existence of a C(changed) key in the input dictionary and that it is V(True) if present
   options:
     _input:
       description: registered result from an Ansible task

ansible/plugins/test/contains.yml

@@ -21,7 +21,7 @@ EXAMPLES: |
 
   # as a selector
   - action: module=doessomething
-    when: lacp_groups|selectattr('interfaces', 'contains', 'em1')|first).master
+    when: (lacp_groups|selectattr('interfaces', 'contains', 'em1')|first).master
     vars:
       lacp_groups:
         - master: lacp0

ansible/plugins/test/core.py

@@ -15,9 +15,7 @@
 # You should have received a copy of the GNU General Public License
 # along with Ansible.  If not, see <http://www.gnu.org/licenses/>.
 
-# Make coding more python3-ish
-from __future__ import (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 import re
 import operator as py_operator
@@ -138,7 +136,7 @@ def regex(value='', pattern='', ignorecase=False, multiline=False, match_type='s
 
 
 def vault_encrypted(value):
-    """Evaulate whether a variable is a single vault encrypted value
+    """Evaluate whether a variable is a single vault encrypted value
 
     .. versionadded:: 2.10
     """

ansible/plugins/test/exists.yml

@@ -14,7 +14,7 @@ DOCUMENTATION:
 
 EXAMPLES: |
   vars:
-    my_etc_hosts_exists: "{{ '/etc/hosts' is exist }}"
+    my_etc_hosts_exists: "{{ '/etc/hosts' is exists }}"
     list_of_local_files_to_copy_to_remote: "{{ list_of_all_possible_files | select('exists') }}"
 
 RETURN:

ansible/plugins/test/failed.yml

@@ -6,7 +6,7 @@ DOCUMENTATION:
   aliases: [failure]
   description:
     - Tests if task finished in failure, opposite of C(succeeded).
-    - This test checks for the existance of a C(failed) key in the input dictionary and that it is V(True) if present.
+    - This test checks for the existence of a C(failed) key in the input dictionary and that it is V(True) if present.
     - Tasks that get skipped or not executed due to other failures (syntax, templating, unreachable host, etc) do not return a 'failed' status.
   options:
     _input:

ansible/plugins/test/failure.yml

@@ -6,7 +6,7 @@ DOCUMENTATION:
   aliases: [failure]
   description:
     - Tests if task finished in failure, opposite of C(succeeded).
-    - This test checks for the existance of a C(failed) key in the input dictionary and that it is V(True) if present.
+    - This test checks for the existence of a C(failed) key in the input dictionary and that it is V(True) if present.
     - Tasks that get skipped or not executed due to other failures (syntax, templating, unreachable host, etc) do not return a 'failed' status.
   options:
     _input:

ansible/plugins/test/files.py

@@ -15,9 +15,7 @@
 # You should have received a copy of the GNU General Public License
 # along with Ansible.  If not, see <http://www.gnu.org/licenses/>.
 
-# Make coding more python3-ish
-from __future__ import (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 from os.path import isdir, isfile, isabs, exists, lexists, islink, samefile, ismount
 

ansible/plugins/test/finished.yml

@@ -4,8 +4,8 @@ DOCUMENTATION:
   version_added: "1.9"
   short_description: Did async task finish
   description:
-    - Used to test if an async task has finished, it will aslo work with normal tasks but will issue a warning.
-    - This test checks for the existance of a C(finished) key in the input dictionary and that it is V(1) if present
+    - Used to test if an async task has finished, it will also work with normal tasks but will issue a warning.
+    - This test checks for the existence of a C(finished) key in the input dictionary and that it is V(1) if present
   options:
     _input:
       description: registered result from an Ansible task
@@ -17,5 +17,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: Returns V(True) if the aysnc task has finished, V(False) otherwise.
+    description: Returns V(True) if the async task has finished, V(False) otherwise.
     type: boolean

ansible/plugins/test/issuperset.yml

@@ -19,7 +19,7 @@ DOCUMENTATION:
       required: True
 EXAMPLES: |
   big: [1,2,3,4,5]
-  sml: [3,4]
+  small: [3,4]
   issmallinbig: '{{ big is superset(small) }}'
 RETURN:
   _value:

ansible/plugins/test/match.yml

@@ -15,7 +15,7 @@ DOCUMENTATION:
       type: string
       required: True
     ignorecase:
-      description: Use case insenstive matching.
+      description: Use case insensitive matching.
       type: boolean
       default: False
     multiline:

ansible/plugins/test/mathstuff.py

@@ -15,8 +15,7 @@
 # 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 (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 import math
 

ansible/plugins/test/reachable.yml

@@ -5,7 +5,7 @@ DOCUMENTATION:
   short_description: Task did not end due to unreachable host
   description:
     - Tests if task was able to reach the host for execution
-    - This test checks for the existance of a C(unreachable) key in the input dictionary and that it is V(False) if present
+    - This test checks for the existence of a C(unreachable) key in the input dictionary and that it is V(False) if present
   options:
     _input:
       description: registered result from an Ansible task

ansible/plugins/test/regex.yml

@@ -14,7 +14,7 @@ DOCUMENTATION:
       type: string
       required: True
     ignorecase:
-      description: Use case insenstive matching.
+      description: Use case insensitive matching.
       type: boolean
       default: False
     multiline:

ansible/plugins/test/search.yml

@@ -14,7 +14,7 @@ DOCUMENTATION:
       type: string
       required: True
     ignorecase:
-      description: Use case insenstive matching.
+      description: Use case insensitive matching.
       type: boolean
       default: False
     multiline:

ansible/plugins/test/skip.yml

@@ -6,7 +6,7 @@ DOCUMENTATION:
   aliases: [skip]
   description:
     - Tests if task was skipped
-    - This test checks for the existance of a C(skipped) key in the input dictionary and that it is V(True) if present
+    - This test checks for the existence of a C(skipped) key in the input dictionary and that it is V(True) if present
   options:
     _input:
       description: registered result from an Ansible task

ansible/plugins/test/skipped.yml

@@ -6,7 +6,7 @@ DOCUMENTATION:
   aliases: [skip]
   description:
     - Tests if task was skipped
-    - This test checks for the existance of a C(skipped) key in the input dictionary and that it is V(True) if present
+    - This test checks for the existence of a C(skipped) key in the input dictionary and that it is V(True) if present
   options:
     _input:
       description: registered result from an Ansible task

ansible/plugins/test/started.yml

@@ -5,7 +5,7 @@ DOCUMENTATION:
   short_description: Was async task started
   description:
     - Used to check if an async task has started, will also work with non async tasks but will issue a warning.
-    - This test checks for the existance of a C(started) key in the input dictionary and that it is V(1) if present
+    - This test checks for the existence of a C(started) key in the input dictionary and that it is V(1) if present
   options:
     _input:
       description: registered result from an Ansible task

ansible/plugins/test/succeeded.yml

@@ -6,7 +6,7 @@ DOCUMENTATION:
   aliases: [succeeded, successful]
   description:
     - Tests if task finished successfully, opposite of C(failed).
-    - This test checks for the existance of a C(failed) key in the input dictionary and that it is V(False) if present
+    - This test checks for the existence of a C(failed) key in the input dictionary and that it is V(False) if present
   options:
     _input:
       description: registered result from an Ansible task

ansible/plugins/test/success.yml

@@ -6,7 +6,7 @@ DOCUMENTATION:
   aliases: [succeeded, successful]
   description:
     - Tests if task finished successfully, opposite of C(failed).
-    - This test checks for the existance of a C(failed) key in the input dictionary and that it is V(False) if present
+    - This test checks for the existence of a C(failed) key in the input dictionary and that it is V(False) if present
   options:
     _input:
       description: registered result from an Ansible task

ansible/plugins/test/successful.yml

@@ -6,7 +6,7 @@ DOCUMENTATION:
   aliases: [succeeded, successful]
   description:
     - Tests if task finished successfully, opposite of C(failed).
-    - This test checks for the existance of a C(failed) key in the input dictionary and that it is V(False) if present
+    - This test checks for the existence of a C(failed) key in the input dictionary and that it is V(False) if present
   options:
     _input:
       description: registered result from an Ansible task

ansible/plugins/test/superset.yml

@@ -19,7 +19,7 @@ DOCUMENTATION:
       required: True
 EXAMPLES: |
   big: [1,2,3,4,5]
-  sml: [3,4]
+  small: [3,4]
   issmallinbig: '{{ big is superset(small) }}'
 RETURN:
   _value:

ansible/plugins/test/unreachable.yml

@@ -5,7 +5,7 @@ DOCUMENTATION:
   short_description: Did task end due to the host was unreachable
   description:
     - Tests if task was not able to reach the host for execution
-    - This test checks for the existance of a C(unreachable) key in the input dictionary and that it's value is V(True)
+    - This test checks for the existence of a C(unreachable) key in the input dictionary and that it's value is V(True)
   options:
     _input:
       description: registered result from an Ansible task

ansible/plugins/test/uri.py

@@ -1,8 +1,6 @@
 # (c) Ansible Project
 
-# Make coding more python3-ish
-from __future__ import (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 from urllib.parse import urlparse
 

ansible/plugins/vars/__init__.py

@@ -15,8 +15,7 @@
 #
 # 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 (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 from ansible.plugins import AnsiblePlugin
 from ansible.utils.path import basedir

ansible/plugins/vars/host_group_vars.py

@@ -15,8 +15,7 @@
 # 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 (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 DOCUMENTATION = '''
     name: host_group_vars
@@ -74,7 +73,7 @@ class VarsModule(BaseVarsPlugin):
 
     def load_found_files(self, loader, data, found_files):
         for found in found_files:
-            new_data = loader.load_from_file(found, cache=True, unsafe=True)
+            new_data = loader.load_from_file(found, cache='all', unsafe=True)
             if new_data:  # ignore empty files
                 data = combine_vars(data, new_data)
         return data

ansible/release.py

@@ -15,10 +15,8 @@
 # You should have received a copy of the GNU General Public License
 # along with Ansible.  If not, see <http://www.gnu.org/licenses/>.
 
-# Make coding more python3-ish
-from __future__ import (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
-__version__ = '2.16.7rc1'
+__version__ = '2.17.0'
 __author__ = 'Ansible, Inc.'
-__codename__ = "All My Love"
+__codename__ = "Gallows Pole"

ansible/template/__init__.py

@@ -15,12 +15,11 @@
 # You should have received a copy of the GNU General Public License
 # along with Ansible.  If not, see <http://www.gnu.org/licenses/>.
 
-# Make coding more python3-ish
-from __future__ import (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 import ast
 import datetime
+import functools
 import os
 import pwd
 import re
@@ -297,23 +296,7 @@ def _unroll_iterator(func):
             return list(ret)
         return ret
 
-    return _update_wrapper(wrapper, func)
-
-
-def _update_wrapper(wrapper, func):
-    # This code is duplicated from ``functools.update_wrapper`` from Py3.7.
-    # ``functools.update_wrapper`` was failing when the func was ``functools.partial``
-    for attr in ('__module__', '__name__', '__qualname__', '__doc__', '__annotations__'):
-        try:
-            value = getattr(func, attr)
-        except AttributeError:
-            pass
-        else:
-            setattr(wrapper, attr, value)
-    for attr in ('__dict__',):
-        getattr(wrapper, attr).update(getattr(func, attr, {}))
-    wrapper.__wrapped__ = func
-    return wrapper
+    return functools.update_wrapper(wrapper, func)
 
 
 def _wrap_native_text(func):
@@ -326,7 +309,7 @@ def _wrap_native_text(func):
         ret = func(*args, **kwargs)
         return NativeJinjaText(ret)
 
-    return _update_wrapper(wrapper, func)
+    return functools.update_wrapper(wrapper, func)
 
 
 class AnsibleUndefined(StrictUndefined):
@@ -493,7 +476,7 @@ class JinjaPluginIntercept(MutableMapping):
             self._seen_it.remove(key)
             raise TemplateSyntaxError('Could not load "%s": %s' % (key, to_native(original_exc or e)), 0)
 
-        # if i do have func and it is a filter, it nees wrapping
+        # if i do have func and it is a filter, it needs wrapping
         if self._pluginloader.type == 'filter':
             # filter need wrapping
             if key in C.STRING_TYPE_FILTERS:
@@ -1039,12 +1022,16 @@ class Templar:
                     if unsafe:
                         res = wrap_var(res)
             return res
-        except (UndefinedError, AnsibleUndefinedVariable) as e:
+        except UndefinedError as e:
             if fail_on_undefined:
-                raise AnsibleUndefinedVariable(e, orig_exc=e)
-            else:
-                display.debug("Ignoring undefined failure: %s" % to_text(e))
-                return data
+                raise AnsibleUndefinedVariable(e)
+            display.debug("Ignoring undefined failure: %s" % to_text(e))
+            return data
+        except AnsibleUndefinedVariable as e:
+            if fail_on_undefined:
+                raise
+            display.debug("Ignoring undefined failure: %s" % to_text(e))
+            return data
 
     # for backwards compatibility in case anyone is using old private method directly
     _do_template = do_template

ansible/template/native_helpers.py

@@ -1,9 +1,7 @@
 # Copyright: (c) 2018, Ansible Project
 # GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
 
-# Make coding more python3-ish
-from __future__ import (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 
 import ast

ansible/template/template.py

@@ -15,9 +15,7 @@
 # You should have received a copy of the GNU General Public License
 # along with Ansible.  If not, see <http://www.gnu.org/licenses/>.
 
-# Make coding more python3-ish
-from __future__ import (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 from jinja2.nativetypes import NativeTemplate
 

ansible/template/vars.py

@@ -1,5 +1,6 @@
 # (c) 2012, Michael DeHaan <michael.dehaan@gmail.com>
 # GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+from __future__ import annotations
 
 from collections import ChainMap
 

ansible/utils/__init__.py

@@ -15,6 +15,4 @@
 # You should have received a copy of the GNU General Public License
 # along with Ansible.  If not, see <http://www.gnu.org/licenses/>.
 
-# Make coding more python3-ish
-from __future__ import (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations

ansible/utils/cmd_functions.py

@@ -15,8 +15,7 @@
 # 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 (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 import os
 import select

ansible/utils/collection_loader/__init__.py

@@ -4,8 +4,7 @@
 # CAUTION: This implementation of the collection loader is used by ansible-test.
 #          Because of this, it must be compatible with all Python versions supported on the controller or remote.
 
-from __future__ import (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 # FIXME: decide what of this we want to actually be public/toplevel, put other stuff on a utility class?
 from ._collection_config import AnsibleCollectionConfig

ansible/utils/collection_loader/_collection_config.py

@@ -4,8 +4,7 @@
 # CAUTION: This implementation of the collection loader is used by ansible-test.
 #          Because of this, it must be compatible with all Python versions supported on the controller or remote.
 
-from __future__ import (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 from ansible.module_utils.common.text.converters import to_text
 from ansible.module_utils.six import add_metaclass

ansible/utils/collection_loader/_collection_finder.py

@@ -4,8 +4,7 @@
 # CAUTION: This implementation of the collection loader is used by ansible-test.
 #          Because of this, it must be compatible with all Python versions supported on the controller or remote.
 
-from __future__ import (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 import itertools
 import os

ansible/utils/collection_loader/_collection_meta.py

@@ -4,8 +4,7 @@
 # CAUTION: This implementation of the collection loader is used by ansible-test.
 #          Because of this, it must be compatible with all Python versions supported on the controller or remote.
 
-from __future__ import (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 try:
     from collections.abc import Mapping

ansible/utils/color.py

@@ -14,8 +14,7 @@
 #
 # 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 (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 import re
 import sys

ansible/utils/context_objects.py

@@ -1,13 +1,10 @@
 # Copyright: (c) 2018, Ansible Project
 # GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
 
-# Make coding more python3-ish
-from __future__ import (absolute_import, division, print_function)
-__metaclass__ = type
-
 """
 Hold command line arguments for use in other modules
 """
+from __future__ import annotations
 
 from abc import ABCMeta
 from collections.abc import Container, Mapping, Sequence, Set