ansible-core 2.16.5rc1__py3-none-any.whl → 2.17.0b1__py3-none-any.whl

ansible/plugins/doc_fragments/backup.py

@@ -2,8 +2,7 @@
 
 # Copyright: (c) 2015, Ansible, Inc
 # 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
 
 
 class ModuleDocFragment(object):

ansible/plugins/doc_fragments/connection_pipelining.py

@@ -1,7 +1,6 @@
 # Copyright (c) 2021 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
 
 
 class ModuleDocFragment(object):

ansible/plugins/doc_fragments/constructed.py

@@ -2,8 +2,7 @@
 
 # Copyright: (c) 2017, 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
 
 
 class ModuleDocFragment(object):

ansible/plugins/doc_fragments/decrypt.py

@@ -2,8 +2,7 @@
 
 # Copyright: (c) 2017, Brian Coca <bcoca@redhat.com>
 # 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
 
 
 class ModuleDocFragment(object):
@@ -13,7 +12,7 @@ class ModuleDocFragment(object):
 options:
   decrypt:
     description:
-      - This option controls the autodecryption of source files using vault.
+      - This option controls the auto-decryption of source files using vault.
     type: bool
     default: yes
     version_added: '2.4'

ansible/plugins/doc_fragments/default_callback.py

@@ -2,8 +2,7 @@
 
 # Copyright: (c) 2017, 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
 
 
 class ModuleDocFragment(object):

ansible/plugins/doc_fragments/files.py

@@ -2,8 +2,7 @@
 
 # Copyright: (c) 2014, Matt Martz <matt@sivel.net>
 # 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
 
 
 class ModuleDocFragment(object):

ansible/plugins/doc_fragments/inventory_cache.py

@@ -2,8 +2,7 @@
 
 # Copyright: (c) 2017, 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
 
 
 class ModuleDocFragment(object):

ansible/plugins/doc_fragments/result_format_callback.py

@@ -2,8 +2,7 @@
 
 # Copyright: (c) 2017, 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
 
 
 class ModuleDocFragment(object):

ansible/plugins/doc_fragments/return_common.py

@@ -2,8 +2,7 @@
 
 # Copyright: (c) 2016, Ansible, Inc
 # 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
 
 
 class ModuleDocFragment(object):

ansible/plugins/doc_fragments/shell_common.py

@@ -1,7 +1,6 @@
 # Copyright (c) 2017 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
 
 
 class ModuleDocFragment(object):

ansible/plugins/doc_fragments/shell_windows.py

@@ -1,7 +1,6 @@
 # Copyright (c) 2019 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
 
 
 class ModuleDocFragment(object):

ansible/plugins/doc_fragments/template_common.py

@@ -3,8 +3,7 @@
 # Copyright (c) 2019 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
 
 
 class ModuleDocFragment(object):

ansible/plugins/doc_fragments/url.py

@@ -2,8 +2,7 @@
 
 # Copyright: (c) 2018, John Barker <gundalow@redhat.com>
 # 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
 
 
 class ModuleDocFragment(object):

ansible/plugins/doc_fragments/url_windows.py

@@ -3,8 +3,7 @@
 # Copyright (c) 2019 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
 
 
 class ModuleDocFragment:

ansible/plugins/doc_fragments/validate.py

@@ -2,8 +2,7 @@
 
 # Copyright: (c) 2015, Ansible, Inc
 # 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
 
 
 class ModuleDocFragment(object):

ansible/plugins/doc_fragments/vars_plugin_staging.py

@@ -3,8 +3,7 @@
 # Copyright: (c) 2019,  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
 
 
 class ModuleDocFragment(object):

ansible/plugins/filter/__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 import constants as C
 from ansible.plugins import AnsibleJinja2Plugin

ansible/plugins/filter/b64decode.yml

@@ -2,28 +2,28 @@ DOCUMENTATION:
   name: b64decode
   author: ansible core team
   version_added: 'historical'
-  short_description: Decode a base64 string
+  short_description: Decode a Base64 string
   description:
     - Base64 decoding function.
     - The return value is a string.
-    - Trying to store a binary blob in a string most likely corrupts the binary. To base64 decode a binary blob,
-      use the ``base64`` command  and pipe the encoded data through standard input.
-      For example, in the ansible.builtin.shell`` module, ``cmd="base64 --decode > myfile.bin" stdin="{{ encoded }}"``.
+    - Trying to store a binary blob in a string most likely corrupts the binary. To Base64 decode a binary blob,
+      use the I(base64) command and pipe the encoded data through standard input.
+      For example, in the M(ansible.builtin.shell) module, ``cmd="base64 --decode > myfile.bin" stdin="{{ encoded }}"``.
   positional: _input
   options:
     _input:
-      description: A base64 string to decode.
+      description: A Base64 string to decode.
       type: string
       required: true
 
 EXAMPLES: |
-  # b64 decode a string
+  # Base64 decode a string
   lola: "{{ 'bG9sYQ==' | b64decode }}"
 
-  # b64 decode the content of 'b64stuff' variable
+  # Base64 decode the content of 'b64stuff' variable
   stuff: "{{ b64stuff | b64decode }}"
 
 RETURN:
   _value:
-    description: The contents of the base64 encoded string.
+    description: The contents of the Base64 encoded string.
     type: string

ansible/plugins/filter/b64encode.yml

@@ -2,7 +2,7 @@ DOCUMENTATION:
   name: b64encode
   author: ansible core team
   version_added: 'historical'
-  short_description: Encode a string as base64
+  short_description: Encode a string as Base64
   description:
     - Base64 encoding function.
   positional: _input
@@ -13,13 +13,13 @@ DOCUMENTATION:
       required: true
 
 EXAMPLES: |
-  # b64 encode a string
+  # Base64 encode a string
   b64lola: "{{ 'lola'| b64encode }}"
 
-  # b64 encode the content of 'stuff' variable
+  # Base64 encode the content of 'stuff' variable
   b64stuff: "{{ stuff | b64encode }}"
 
 RETURN:
   _value:
-    description: A base64 encoded string.
+    description: A Base64 encoded string.
     type: string

ansible/plugins/filter/comment.yml

@@ -18,7 +18,7 @@ DOCUMENTATION:
     decoration:
       description: Indicator for comment or intermediate comment depending on the style.
       type: string
-    begining:
+    beginning:
       description: Indicator of the start of a comment block, only available for styles that support multiline comments.
       type: string
     end:

ansible/plugins/filter/core.py

@@ -1,9 +1,7 @@
 # (c) 2012, Jeroen Hoekx <jeroen@hoekx.be>
 # 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 base64
 import glob
@@ -46,7 +44,7 @@ UUID_NAMESPACE_ANSIBLE = uuid.UUID('361E6D51-FAEC-444A-9079-341386DA8E2E')
 
 
 def to_yaml(a, *args, **kw):
-    '''Make verbose, human readable yaml'''
+    '''Make verbose, human-readable yaml'''
     default_flow_style = kw.pop('default_flow_style', None)
     try:
         transformed = yaml.dump(a, Dumper=AnsibleDumper, allow_unicode=True, default_flow_style=default_flow_style, **kw)
@@ -56,7 +54,7 @@ def to_yaml(a, *args, **kw):
 
 
 def to_nice_yaml(a, indent=4, *args, **kw):
-    '''Make verbose, human readable yaml'''
+    '''Make verbose, human-readable yaml'''
     try:
         transformed = yaml.dump(a, Dumper=AnsibleDumper, indent=indent, allow_unicode=True, default_flow_style=False, **kw)
     except Exception as e:
@@ -77,7 +75,7 @@ def to_json(a, *args, **kw):
 
 
 def to_nice_json(a, indent=4, sort_keys=True, *args, **kw):
-    '''Make verbose, human readable JSON'''
+    '''Make verbose, human-readable JSON'''
     return to_json(a, indent=indent, sort_keys=sort_keys, separators=(',', ': '), *args, **kw)
 
 
@@ -122,7 +120,7 @@ def fileglob(pathname):
     return [g for g in glob.glob(pathname) if os.path.isfile(g)]
 
 
-def regex_replace(value='', pattern='', replacement='', ignorecase=False, multiline=False):
+def regex_replace(value='', pattern='', replacement='', ignorecase=False, multiline=False, count=0, mandatory_count=0):
     ''' Perform a `re.sub` returning a string '''
 
     value = to_text(value, errors='surrogate_or_strict', nonstring='simplerepr')
@@ -133,7 +131,11 @@ def regex_replace(value='', pattern='', replacement='', ignorecase=False, multil
     if multiline:
         flags |= re.M
     _re = re.compile(pattern, flags=flags)
-    return _re.sub(replacement, value)
+    (output, subs) = _re.subn(replacement, value, count=count)
+    if mandatory_count and mandatory_count != subs:
+        raise AnsibleFilterError("'%s' should match %d times, but matches %d times in '%s'"
+                                 % (pattern, mandatory_count, count, value))
+    return output
 
 
 def regex_findall(value, regex, multiline=False, ignorecase=False):
@@ -595,7 +597,7 @@ def commonpath(paths):
     :rtype: str
     """
     if not is_sequence(paths):
-        raise AnsibleFilterTypeError("|path_join expects sequence, got %s instead." % type(paths))
+        raise AnsibleFilterTypeError("|commonpath expects sequence, got %s instead." % type(paths))
 
     return os.path.commonpath(paths)
 

ansible/plugins/filter/encryption.py

@@ -1,8 +1,6 @@
 # Copyright: (c) 2021, Ansible Project
 
-# Make coding more python3-ish
-from __future__ import (absolute_import, division, print_function)
-__metaclass__ = type
+from __future__ import annotations
 
 from jinja2.runtime import Undefined
 from jinja2.exceptions import UndefinedError

ansible/plugins/filter/extract.yml

@@ -17,7 +17,7 @@ DOCUMENTATION:
       type: raw
       required: true
     morekeys:
-      description: Indicies or keys to extract from the initial result (subkeys/subindices).
+      description: Indices or keys to extract from the initial result (subkeys/subindices).
       type: list
       elements: dictionary
       required: true

ansible/plugins/filter/from_yaml_all.yml

@@ -5,7 +5,7 @@ DOCUMENTATION:
   description:
     - Converts a YAML documents in a string representation into an equivalent structured Ansible variable.
     - Ansible internally auto-converts YAML strings into variable structures in most contexts, but by default does not handle 'multi document' YAML files or strings.
-    - If multiple YAML documents are not supplied, this is the equivalend of using C(from_yaml).
+    - If multiple YAML documents are not supplied, this is the equivalence of using C(from_yaml).
   notes:
     - This filter functions as a wrapper to the Python C(yaml.safe_load_all) function, part of the L(pyyaml Python library, https://pypi.org/project/PyYAML/).
     - Possible conflicts in variable names from the multiple documents are resolved directly by the pyyaml library.

ansible/plugins/filter/human_readable.yml

@@ -1,9 +1,9 @@
 DOCUMENTATION:
   name: human_redable
   version_added: "historical"
-  short_description: Make bytes/bits human readable
+  short_description: Make bytes/bits human-readable
   description:
-    - Convert byte or bit figures to more human readable formats.
+    - Convert byte or bit figures to more human-readable formats.
   positional: _input, isbits, unit
   options:
     _input:
@@ -31,5 +31,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: Human readable byte or bit size.
+    description: human-readable byte or bit size.
     type: str

ansible/plugins/filter/human_to_bytes.yml

@@ -3,11 +3,11 @@ DOCUMENTATION:
   version_added: "historical"
   short_description: Get bytes from string
   description:
-    - Convert a human readable byte or bit string into a number bytes.
+    - Convert a human-readable byte or bit string into a number bytes.
   positional: _input, default_unit, isbits
   options:
     _input:
-      description: Human readable description of a number of bytes.
+      description: human-readable description of a number of bytes.
       type: int
       required: true
     default_unit:

ansible/plugins/filter/mandatory.yml

@@ -1,7 +1,7 @@
 DOCUMENTATION:
   name: mandatory
   version_added: "historical"
-  short_description: make a variable's existance mandatory
+  short_description: make a variable's existence mandatory
   description:
     - Depending on context undefined variables can be ignored or skipped, this ensures they force an error.
   positional: _input

ansible/plugins/filter/mathstuff.py

@@ -145,7 +145,7 @@ def inversepower(x, base=2):
 
 
 def human_readable(size, isbits=False, unit=None):
-    ''' Return a human readable string '''
+    ''' Return a human-readable string '''
     try:
         return formatters.bytes_to_human(size, isbits, unit)
     except TypeError as e:
@@ -155,7 +155,7 @@ def human_readable(size, isbits=False, unit=None):
 
 
 def human_to_bytes(size, default_unit=None, isbits=False):
-    ''' Return bytes count from a human readable string '''
+    ''' Return bytes count from a human-readable string '''
     try:
         return formatters.human_to_bytes(size, default_unit, isbits)
     except TypeError as e:

ansible/plugins/filter/password_hash.yml

@@ -7,6 +7,7 @@ DOCUMENTATION:
   positional: _input
   notes:
     - Algorithms available might be restricted by the system.
+    - Algorithms may restrict salt length or content. For example, Blowfish/bcrypt requires a 22-character salt.
   options:
     _input:
       description: Secret to hash.
@@ -18,8 +19,8 @@ DOCUMENTATION:
       default: sha512
       choices: [ md5, blowfish, sha256, sha512 ]
     salt:
-      description: Secret string that is used for the hashing, if none is provided a random one can be generated.
-      type: int
+      description: Secret string used for the hashing. If none is provided a random one can be generated. Use only numbers and letters (characters matching V([./0-9A-Za-z]+)).
+      type: string
     rounds:
       description: Number of encryption rounds, default varies by algorithm used.
       type: int

ansible/plugins/filter/regex_replace.yml

@@ -6,6 +6,8 @@ DOCUMENTATION:
     - Replace a substring defined by a regular expression with another defined by another regular expression based on the first match.
   notes:
     - Maps to Python's C(re.sub).
+    - 'The substring matched by the group is accessible via the symbolic group name or
+      the ``\{number}`` special sequence. See examples section.'
   positional: _input, _regex_match, _regex_replace
   options:
     _input:
@@ -28,6 +30,16 @@ DOCUMENTATION:
       description: Force the search to be case insensitive if V(True), case sensitive otherwise.
       type: bool
       default: no
+    count:
+      description: Maximum number of pattern occurrences to replace. If zero, replace all occurrences.
+      type: int
+      default: 0
+      version_added: "2.17"
+    mandatory_count:
+      description: Except a certain number of replacements. Raises an error otherwise. If zero, ignore.
+      type: int
+      default: 0
+      version_added: "2.17"
 
 EXAMPLES: |
 
@@ -46,6 +58,9 @@ EXAMPLES: |
   # piratecomment => '#CAR\n#tar\nfoo\n#bar\n'
   piratecomment: "{{ 'CAR\ntar\nfoo\nbar\n' | regex_replace('(?im)^(.ar)$', '#\\1') }}"
 
+  # 'foo=bar=baz' => 'foo:bar=baz'
+  key_value: "{{ 'foo=bar=baz' | regex_replace('=', ':', count=1) }}"
+
 RETURN:
   _value:
     description: String with substitution (or original if no match).

ansible/plugins/filter/regex_search.yml

@@ -6,6 +6,8 @@ DOCUMENTATION:
     - Search in a string to extract the part that matches the regular expression.
   notes:
     - Maps to Python's C(re.search).
+    - 'The substring matched by the group is accessible via the symbolic group name or
+      the ``\{number}`` special sequence. See examples section.'
   positional: _input, _regex
   options:
     _input:
@@ -38,6 +40,16 @@ EXAMPLES: |
   # drinkat => 'BAR'
   drinkat: "{{ 'foo\nBAR' | regex_search('^bar', multiline=True, ignorecase=True) }}"
 
+  # Extracts server and database id from a string using number
+  # (the substring matched by the group is accessible via the \number special sequence)
+  db: "{{ 'server1/database42' | regex_search('server([0-9]+)/database([0-9]+)', '\\1', '\\2') }}"
+  # => ['1', '42']
+
+  # Extracts dividend and divisor from a division
+  # (the substring matched by the group is accessible via the symbolic group name)
+  db: "{{ '21/42' | regex_search('(?P<dividend>[0-9]+)/(?P<divisor>[0-9]+)', '\\g<dividend>', '\\g<divisor>') }}"
+  # => ['21', '42']
+
 RETURN:
   _value:
     description: Matched string or empty string if no match.

ansible/plugins/filter/strftime.yml

@@ -21,6 +21,7 @@ DOCUMENTATION:
       description: Whether time supplied is in UTC.
       type: bool
       default: false
+      version_added: '2.14'
 
 EXAMPLES: |
   # for a complete set of features go to  https://strftime.org/
@@ -39,15 +40,7 @@ EXAMPLES: |
 
   # Use arbitrary epoch value
   {{ '%Y-%m-%d' | strftime(0) }}          # => 1970-01-01
-  {{ '%Y-%m-%d' | strftime(1441357287) }} # => 2015-09-04
-
-  # complex examples
-  vars:
-    date1: '2022-11-15T03:23:13.686956868Z'
-    date2: '2021-12-15T16:06:24.400087Z'
-    date_short: '{{ date1|regex_replace("([^.]+)(\.\d{6})(\d*)(.+)", "\1\2\4") }}' #shorten microseconds
-    iso8601format: '%Y-%m-%dT%H:%M:%S.%fZ'
-    date_diff_isoed: '{{ (date1|to_datetime(isoformat) - date2|to_datetime(isoformat)).total_seconds() }}'
+  {{ '%Y-%m-%d' | strftime(seconds=1441357287, utc=true) }} # => 2015-09-04
 
 RETURN:
   _value:

ansible/plugins/filter/to_datetime.yml

@@ -4,9 +4,14 @@ DOCUMENTATION:
   short_description: Get C(datetime) from string
   description:
     - Using the input string attempt to create a matching Python C(datetime) object.
+    - Adding or Subtracting two datetime objects will result in a Python C(timedelta) object.
   notes:
     - For a full list of format codes for working with Python date format strings, see
       L(the Python documentation, https://docs.python.org/3/library/datetime.html#strftime-and-strptime-behavior).
+    - The timedelta object produced by the difference of two datetimes store the days, seconds, and microseconds of
+      the delta. This results in the C(seconds) attribute being the total seconds of the minutes and hours of that
+      delta. See L(datatime.timedelta, https://docs.python.org/3/library/datetime.html#timedelta-objects) for more
+      information about how a timedelta works.
   positional: _input
   options:
     _input:
@@ -22,13 +27,23 @@ EXAMPLES: |
   # Get total amount of seconds between two dates. Default date format is %Y-%m-%d %H:%M:%S but you can pass your own format
   secsdiff: '{{ (("2016-08-14 20:00:12" | to_datetime) - ("2015-12-25" | to_datetime("%Y-%m-%d"))).total_seconds()  }}'
 
-  # Get remaining seconds after delta has been calculated. NOTE: This does NOT convert years, days, hours, and so on to seconds. For that, use total_seconds()
+  # Get remaining seconds after delta has been calculated. NOTE: This does NOT convert years and days to seconds. For that, use total_seconds()
   {{ (("2016-08-14 20:00:12" | to_datetime) - ("2016-08-14 18:00:00" | to_datetime)).seconds  }}
-  # This expression evaluates to "12" and not "132". Delta is 2 hours, 12 seconds
+  # This expression evaluates to "7212". Delta is 2 hours, 12 seconds
 
   # get amount of days between two dates. This returns only number of days and discards remaining hours, minutes, and seconds
   {{ (("2016-08-14 20:00:12" | to_datetime) - ("2015-12-25" | to_datetime('%Y-%m-%d'))).days  }}
 
+  # difference between to dotnet (100ns precision) and iso8601 microsecond timestamps
+  # the date1_short regex replace will work for any timestamp that has a higher than microsecond precision
+  # by cutting off anything more precise than microseconds
+  vars:
+    date1: '2022-11-15T03:23:13.6869568Z'
+    date2: '2021-12-15T16:06:24.400087Z'
+    date1_short: '{{ date1|regex_replace("([^.]+)(\.\d{6})(\d*)(.+)", "\1\2\4") }}' # shorten to microseconds
+    iso8601format: '%Y-%m-%dT%H:%M:%S.%fZ'
+    date_diff_isoed: '{{ (date1_short|to_datetime(iso8601format) - date2|to_datetime(iso8601format)).total_seconds() }}'
+
 RETURN:
   _value:
     description: C(datetime) object from the represented value.

ansible/plugins/filter/to_nice_json.yml

@@ -39,6 +39,10 @@ DOCUMENTATION:
       description: If V(True), keys that are not basic Python types will be skipped.
       default: False
       type: bool
+    sort_keys:
+      description: Affects sorting of dictionary keys.
+      default: True
+      type: bool      
   notes:
     - Both O(vault_to_text) and O(preprocess_unsafe) defaulted to V(False) between Ansible 2.9 and 2.12.
     - 'These parameters to C(json.dumps) will be ignored, they are overridden for internal use: I(cls), I(default), I(indent), I(separators), I(sort_keys).'

ansible/plugins/filter/union.yml

@@ -29,7 +29,7 @@ EXAMPLES: |
   # list1: [1, 2, 5, 1, 3, 4, 10]
   # list2: [1, 2, 3, 4, 5, 11, 99]
   {{ list1 | union(list2) }}
-  # => [1, 2, 5, 1, 3, 4, 10, 11, 99]
+  # => [1, 2, 5, 3, 4, 10, 11, 99]
 RETURN:
   _value:
     description: A unique list of all the elements from both lists.

ansible/plugins/filter/urls.py

@@ -3,8 +3,7 @@
 # Copyright: (c) 2012, Dag Wieers (@dagwieers) <dag@wieers.com>
 # 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 functools import partial
 

ansible/plugins/filter/urlsplit.py

@@ -2,8 +2,7 @@
 # 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
 
 DOCUMENTATION = r'''
   name: urlsplit

ansible/plugins/filter/zip.yml

@@ -5,7 +5,7 @@ DOCUMENTATION:
   positional: _input, _additional_lists
   description: Iterate over several iterables in parallel, producing tuples with an item from each one.
   notes:
-    - This is mostly a passhtrough to Python's C(zip) function.
+    - This is mostly a passthrough to Python's C(zip) function.
   options:
     _input:
       description: Original list.
@@ -34,7 +34,7 @@ EXAMPLES: |
     shorter: "{{ [1,2,3] | zip(['a','b','c','d','e','f']) }}"
 
     # compose dict from lists of keys and values
-    mydcit: "{{ dict(keys_list | zip(values_list)) }}"
+    mydict: "{{ dict(keys_list | zip(values_list)) }}"
 
 RETURN:
   _value: