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

ansible/plugins/filter/mandatory.yml

@@ -10,11 +10,18 @@ DOCUMENTATION:
       description: Mandatory expression.
       type: raw
       required: true
+    msg:
+      description: The customized message that is printed when the given variable is not defined.
+      type: str
+      required: false
 EXAMPLES: |
 
     # results in a Filter Error
     {{ notdefined | mandatory }}
 
+    # print a custom error message
+    {{ notdefined | mandatory(msg='This variable is required.') }}
+
 RETURN:
   _value:
     description: The input if defined, otherwise an error.

ansible/plugins/filter/mathstuff.py

@@ -18,21 +18,19 @@
 # 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 itertools
 import math
 
-from collections.abc import Hashable, Mapping, Iterable
+from collections.abc import Mapping, Iterable
 
 from jinja2.filters import pass_environment
 
 from ansible.errors import AnsibleFilterError, AnsibleFilterTypeError
 from ansible.module_utils.common.text import formatters
 from ansible.module_utils.six import binary_type, text_type
-from ansible.module_utils._text import to_native, to_text
+from ansible.module_utils.common.text.converters import to_native, to_text
 from ansible.utils.display import Display
 
 try:
@@ -84,27 +82,27 @@ def unique(environment, a, case_sensitive=None, attribute=None):
 
 @pass_environment
 def intersect(environment, a, b):
-    if isinstance(a, Hashable) and isinstance(b, Hashable):
-        c = set(a) & set(b)
-    else:
+    try:
+        c = list(set(a) & set(b))
+    except TypeError:
         c = unique(environment, [x for x in a if x in b], True)
     return c
 
 
 @pass_environment
 def difference(environment, a, b):
-    if isinstance(a, Hashable) and isinstance(b, Hashable):
-        c = set(a) - set(b)
-    else:
+    try:
+        c = list(set(a) - set(b))
+    except TypeError:
         c = unique(environment, [x for x in a if x not in b], True)
     return c
 
 
 @pass_environment
 def symmetric_difference(environment, a, b):
-    if isinstance(a, Hashable) and isinstance(b, Hashable):
-        c = set(a) ^ set(b)
-    else:
+    try:
+        c = list(set(a) ^ set(b))
+    except TypeError:
         isect = intersect(environment, a, b)
         c = [x for x in union(environment, a, b) if x not in isect]
     return c
@@ -112,9 +110,9 @@ def symmetric_difference(environment, a, b):
 
 @pass_environment
 def union(environment, a, b):
-    if isinstance(a, Hashable) and isinstance(b, Hashable):
-        c = set(a) | set(b)
-    else:
+    try:
+        c = list(set(a) | set(b))
+    except TypeError:
         c = unique(environment, a + b, True)
     return c
 

ansible/plugins/filter/normpath.yml

@@ -15,7 +15,7 @@ DOCUMENTATION:
       plugin_type: filter
 EXAMPLES: |
 
-  # To get a normalized path (ex. '/foo/bar') from the path (ex. '/foo//bar')
+  # To get a normalized path (for example - '/foo/bar') from the path (for example - '/foo//bar')
   {{ path | normpath }}
 
 RETURN:

ansible/plugins/filter/path_join.yml

@@ -6,6 +6,8 @@ DOCUMENTATION:
   positional: _input
   description:
     - Returns a path obtained by joining one or more path components.
+    - If a path component is an absolute path, then all previous components
+      are ignored and joining continues from the absolute path. See examples for details.
   options:
     _input:
       description: A path, or a list of paths.
@@ -21,9 +23,14 @@ EXAMPLES: |
   # equivalent to '/etc/subdir/{{filename}}'
   wheremyfile: "{{ ['/etc', 'subdir', filename] | path_join }}"
 
-  # trustme => '/etc/apt/trusted.d/mykey.gpgp'
+  # trustme => '/etc/apt/trusted.d/mykey.gpg'
   trustme: "{{ ['/etc', 'apt', 'trusted.d', 'mykey.gpg'] | path_join }}"
 
+  # If one of the paths is absolute, then path_join ignores all previous path components
+  # If backup_dir == '/tmp' and backup_file == '/sample/baz.txt', the result is '/sample/baz.txt'
+  # backup_path => "/sample/baz.txt"
+  backup_path: "{{ ('/etc', backup_dir, backup_file) | path_join }}"
+
 RETURN:
   _value:
     description: The concatenated path.

ansible/plugins/filter/realpath.yml

@@ -4,8 +4,8 @@ DOCUMENTATION:
   version_added: "1.8"
   short_description: Turn path into real path
   description:
-    - Resolves/follows symliknks to return the 'real path' from a given path.
-    - Filters alwasy run on controller so this path is resolved using the controller's filesystem.
+    - Resolves/follows symlinks to return the 'real path' from a given path.
+    - Filters always run on the controller so this path is resolved using the controller's filesystem.
   options:
     _input:
       description: A path.
@@ -13,6 +13,7 @@ DOCUMENTATION:
       required: true
 EXAMPLES: |
 
+  # realpath => /usr/bin/somebinary
   realpath: {{ '/path/to/synlink' | realpath }}
 
 RETURN:

ansible/plugins/filter/regex_findall.yml

@@ -14,11 +14,11 @@ DOCUMENTATION:
       description: Regular expression string that defines the match.
       type: str
     multiline:
-      description: Search across line endings if C(True), do not if otherwise.
+      description: Search across line endings if V(True), do not if otherwise.
       type: bool
       default: no
     ignorecase:
-      description: Force the search to be case insensitive if C(True), case sensitive otherwise.
+      description: Force the search to be case insensitive if V(True), case sensitive otherwise.
       type: bool
       default: no
 
@@ -27,6 +27,12 @@ EXAMPLES: |
   # all_pirates => ['CAR', 'tar', 'bar']
   all_pirates: "{{ 'CAR\ntar\nfoo\nbar\n' | regex_findall('^.ar$', multiline=True, ignorecase=True) }}"
 
+  # Using inline regex flags instead of passing options to filter
+  # See https://docs.python.org/3/library/re.html for more information
+  # on inline regex flags
+  # all_pirates => ['CAR', 'tar', 'bar']
+  all_pirates: "{{ 'CAR\ntar\nfoo\nbar\n' | regex_findall('(?im)^.ar$') }}"
+
   # get_ips => ['8.8.8.8', '8.8.4.4']
   get_ips: "{{ 'Some DNS servers are 8.8.8.8 and 8.8.4.4' | regex_findall('\\b(?:[0-9]{1,3}\\.){3}[0-9]{1,3}\\b') }}"
 

ansible/plugins/filter/regex_replace.yml

@@ -5,7 +5,7 @@ DOCUMENTATION:
   description:
     - 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.replace).
+    - Maps to Python's C(re.sub).
   positional: _input, _regex_match, _regex_replace
   options:
     _input:
@@ -21,11 +21,11 @@ DOCUMENTATION:
       type: int
       required: true
     multiline:
-      description: Search across line endings if C(True), do not if otherwise.
+      description: Search across line endings if V(True), do not if otherwise.
       type: bool
       default: no
     ignorecase:
-      description: Force the search to be case insensitive if C(True), case sensitive otherwise.
+      description: Force the search to be case insensitive if V(True), case sensitive otherwise.
       type: bool
       default: no
 
@@ -40,6 +40,12 @@ EXAMPLES: |
   # piratecomment => '#CAR\n#tar\nfoo\n#bar\n'
   piratecomment: "{{ 'CAR\ntar\nfoo\nbar\n' | regex_replace('^(.ar)$', '#\\1', multiline=True, ignorecase=True) }}"
 
+  # Using inline regex flags instead of passing options to filter
+  # See https://docs.python.org/3/library/re.html for more information
+  # on inline regex flags
+  # piratecomment => '#CAR\n#tar\nfoo\n#bar\n'
+  piratecomment: "{{ 'CAR\ntar\nfoo\nbar\n' | regex_replace('(?im)^(.ar)$', '#\\1') }}"
+
 RETURN:
   _value:
     description: String with substitution (or original if no match).

ansible/plugins/filter/regex_search.yml

@@ -16,11 +16,11 @@ DOCUMENTATION:
       description: Regular expression string that defines the match.
       type: str
     multiline:
-      description: Search across line endings if C(True), do not if otherwise.
+      description: Search across line endings if V(True), do not if otherwise.
       type: bool
       default: no
     ignorecase:
-      description: Force the search to be case insensitive if C(True), case sensitive otherwise.
+      description: Force the search to be case insensitive if V(True), case sensitive otherwise.
       type: bool
       default: no
 
@@ -29,6 +29,12 @@ EXAMPLES: |
   # db => 'database42'
   db: "{{ 'server1/database42' | regex_search('database[0-9]+') }}"
 
+  # Using inline regex flags instead of passing options to filter
+  # See https://docs.python.org/3/library/re.html for more information
+  # on inline regex flags
+  # server => 'sErver1'
+  db: "{{ 'sErver1/database42' | regex_search('(?i)server([0-9]+)') }}"
+
   # drinkat => 'BAR'
   drinkat: "{{ 'foo\nBAR' | regex_search('^bar', multiline=True, ignorecase=True) }}"
 

ansible/plugins/filter/relpath.yml

@@ -5,8 +5,8 @@ DOCUMENTATION:
   short_description: Make a path relative
   positional: _input, start
   description:
-    - Converts the given path to a relative path from the I(start),
-      or relative to the directory given in I(start).
+    - Converts the given path to a relative path from the O(start),
+      or relative to the directory given in O(start).
   options:
     _input:
       description: A path.

ansible/plugins/filter/root.yml

@@ -18,7 +18,7 @@ DOCUMENTATION:
 EXAMPLES: |
 
   # => 8
-  fiveroot: "{{ 32768 | root (5) }}"
+  fiveroot: "{{ 32768 | root(5) }}"
 
   # 2
   sqrt_of_2: "{{ 4 | root }}"

ansible/plugins/filter/splitext.yml

@@ -21,7 +21,7 @@ EXAMPLES: |
   file_n_ext: "{{ 'ansible.cfg' | splitext }}"
 
   # hoax => ['/etc/hoasdf', '']
-  hoax: '{{ "/etc//hoasdf/"|splitext }}'
+  hoax: '{{ "/etc//hoasdf/" | splitext }}'
 
 RETURN:
   _value:

ansible/plugins/filter/subelements.yml

@@ -4,7 +4,7 @@ DOCUMENTATION:
   short_description: returns a product of a list and its elements
   positional: _input, _subelement, skip_missing
   description:
-    - This produces a product of an object and the subelement values of that object, similar to the subelements lookup. This lets you specify individual subelements to use in a template I(_input).
+    - This produces a product of an object and the subelement values of that object, similar to the subelements lookup. This lets you specify individual subelements to use in a template O(_input).
   options:
     _input:
       description: Original list.
@@ -16,7 +16,7 @@ DOCUMENTATION:
       type: str
       required: yes
     skip_missing:
-      description: If C(True), ignore missing subelements, otherwise missing subelements generate an error.
+      description: If V(True), ignore missing subelements, otherwise missing subelements generate an error.
       type: bool
       default: no
 

ansible/plugins/filter/symmetric_difference.yml

@@ -5,6 +5,7 @@ DOCUMENTATION:
   short_description: different items from two lists
   description:
     - Provide a unique list of all the elements unique to each list.
+    - Items in the resulting list are returned in arbitrary order.
   options:
     _input:
       description: A list.

ansible/plugins/filter/ternary.yml

@@ -4,22 +4,22 @@ DOCUMENTATION:
   version_added: '1.9'
   short_description: Ternary operation filter
   description:
-    - Return the first value if the input is C(True), the second if C(False).
+    - Return the first value if the input is V(True), the second if V(False).
   positional: true_val, false_val
   options:
     _input:
-      description: A boolean expression, must evaluate to C(True) or C(False).
+      description: A boolean expression, must evaluate to V(True) or V(False).
       type: bool
       required: true
     true_val:
-      description: Value to return if the input is C(True).
+      description: Value to return if the input is V(True).
       type: any
       required: true
     false_val:
-      description: Value to return if the input is C(False).
+      description: Value to return if the input is V(False).
       type: any
     none_val:
-      description: Value to return if the input is C(None). If not set, C(None) will be treated as C(False).
+      description: Value to return if the input is V(None). If not set, V(None) will be treated as V(False).
       type: any
       version_added: '2.8'
   notes:

ansible/plugins/filter/to_json.yml

@@ -23,8 +23,8 @@ DOCUMENTATION:
       default: True
       version_added: '2.9'
     allow_nan:
-      description: When C(False), strict adherence to float value limits of the JSON specifications, so C(nan), C(inf) and C(-inf) values will produce errors.
-                   When C(True), JavaScript equivalents will be used (C(NaN), C(Infinity), C(-Infinity)).
+      description: When V(False), strict adherence to float value limits of the JSON specifications, so C(nan), C(inf) and C(-inf) values will produce errors.
+                   When V(True), JavaScript equivalents will be used (C(NaN), C(Infinity), C(-Infinity)).
       default: True
       type: bool
     check_circular:
@@ -41,11 +41,11 @@ DOCUMENTATION:
       type: integer
     separators:
       description: The C(item) and C(key) separator to be used in the serialized output,
-                   default may change depending on I(indent) and Python version.
+                   default may change depending on O(indent) and Python version.
       default: "(', ', ': ')"
       type: tuple
     skipkeys:
-      description: If C(True), keys that are not basic Python types will be skipped.
+      description: If V(True), keys that are not basic Python types will be skipped.
       default: False
       type: bool
     sort_keys:
@@ -53,15 +53,15 @@ DOCUMENTATION:
       default: False
       type: bool
   notes:
-    - Both I(vault_to_text) and I(preprocess_unsafe) defaulted to C(False) between Ansible 2.9 and 2.12.
+    - 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, as they are overridden internally: I(cls), I(default)'
 
 EXAMPLES: |
   # dump variable in a template to create a JSON document
-  {{ docker_config|to_json }}
+  {{ docker_config | to_json }}
 
   # same as above but 'prettier' (equivalent to to_nice_json filter)
-  {{ docker_config|to_json(indent=4, sort_keys=True) }}
+  {{ docker_config | to_json(indent=4, sort_keys=True) }}
 
 RETURN:
   _value:

ansible/plugins/filter/to_nice_json.yml

@@ -23,8 +23,8 @@ DOCUMENTATION:
       default: True
       version_added: '2.9'
     allow_nan:
-      description: When C(False), strict adherence to float value limits of the JSON specification, so C(nan), C(inf) and C(-inf) values will produce errors.
-                   When C(True), JavaScript equivalents will be used (C(NaN), C(Infinity), C(-Infinity)).
+      description: When V(False), strict adherence to float value limits of the JSON specification, so C(nan), C(inf) and C(-inf) values will produce errors.
+                   When V(True), JavaScript equivalents will be used (C(NaN), C(Infinity), C(-Infinity)).
       default: True
       type: bool
     check_circular:
@@ -36,16 +36,16 @@ DOCUMENTATION:
       default: True
       type: bool
     skipkeys:
-      description: If C(True), keys that are not basic Python types will be skipped.
+      description: If V(True), keys that are not basic Python types will be skipped.
       default: False
       type: bool
   notes:
-    - Both I(vault_to_text) and I(preprocess_unsafe) defaulted to C(False) between Ansible 2.9 and 2.12.
+    - 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).'
 
 EXAMPLES: |
   # dump variable in a template to create a nicely formatted JSON document
-  {{ docker_config|to_nice_json }}
+  {{ docker_config | to_nice_json }}
 
 
 RETURN:

ansible/plugins/filter/to_yaml.yml

@@ -41,10 +41,10 @@ DOCUMENTATION:
 
 EXAMPLES: |
   # dump variable in a template to create a YAML document
-  {{ github_workflow |to_yaml}}
+  {{ github_workflow | to_yaml }}
 
   # same as above but 'prettier' (equivalent to to_nice_yaml filter)
-  {{ docker_config|to_yaml(indent=4) }}
+  {{ docker_config | to_yaml(indent=4) }}
 
 RETURN:
   _value:

ansible/plugins/filter/type_debug.yml

@@ -16,5 +16,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: The Python 'type' of the I(_input) provided.
+    description: The Python 'type' of the O(_input) provided.
     type: string

ansible/plugins/filter/union.yml

@@ -5,6 +5,7 @@ DOCUMENTATION:
   short_description: union of lists
   description:
     - Provide a unique list of all the elements of two lists.
+    - Items in the resulting list are returned in arbitrary order.
   options:
     _input:
       description: A list.

ansible/plugins/filter/unvault.yml

@@ -23,12 +23,12 @@ DOCUMENTATION:
 EXAMPLES: |
   # simply decrypt my key from a vault
   vars:
-    mykey: "{{ myvaultedkey|unvault(passphrase) }} "
+    mykey: "{{ myvaultedkey | unvault(passphrase) }} "
 
   - name: save templated unvaulted data
     template: src=dump_template_data.j2 dest=/some/key/clear.txt
     vars:
-      template_data: '{{ secretdata|unvault(vaultsecret) }}'
+      template_data: '{{ secretdata | unvault(vaultsecret) }}'
 
 RETURN:
   _value:

ansible/plugins/filter/urldecode.yml

@@ -1,48 +1,29 @@
 DOCUMENTATION:
-  name: urlsplit
+  name: urldecode
   version_added: "2.4"
-  short_description: get components from URL
+  short_description: Decode percent-encoded sequences
   description:
-    - Split a URL into its component parts.
-  positional: _input, query
+    - Replace %xx escapes with their single-character equivalent in the given string.
+    - Also replace plus signs with spaces, as required for unquoting HTML form values.
+  positional: _input
   options:
     _input:
-      description: URL string to split.
+      description: URL encoded string to decode.
       type: str
       required: true
-    query:
-      description: Specify a single component to return.
-      type: str
-      choices: ["fragment", "hostname", "netloc", "password",  "path",  "port",  "query", "scheme",  "username"]
 
 RETURN:
   _value:
     description:
-      - A dictionary with components as keyword and their value.
-      - If I(query) is provided, a string or integer will be returned instead, depending on I(query).
+      - URL decoded value for the given string
     type: any
 
 EXAMPLES: |
 
-    {{ "http://user:password@www.acme.com:9000/dir/index.html?query=term#fragment" | urlsplit }}
-    # =>
-    #   {
-    #       "fragment": "fragment",
-    #       "hostname": "www.acme.com",
-    #       "netloc": "user:password@www.acme.com:9000",
-    #       "password": "password",
-    #       "path": "/dir/index.html",
-    #       "port": 9000,
-    #       "query": "query=term",
-    #       "scheme": "http",
-    #       "username": "user"
-    #   }
-
-    {{ "http://user:password@www.acme.com:9000/dir/index.html?query=term#fragment" | urlsplit('hostname') }}
-    # => 'www.acme.com'
-
-    {{ "http://user:password@www.acme.com:9000/dir/index.html?query=term#fragment" | urlsplit('query') }}
-    # => 'query=term'
+    # Decode urlencoded string
+    {{ '%7e/abc+def' | urldecode }}
+    # => "~/abc def"
 
-    {{ "http://user:password@www.acme.com:9000/dir/index.html?query=term#fragment" | urlsplit('path') }}
-    # => '/dir/index.html'
+    # Decode plus sign as well
+    {{ 'El+Ni%C3%B1o' | urldecode }}
+    # => "El Niño"

ansible/plugins/filter/urlsplit.py

@@ -53,7 +53,7 @@ RETURN = r'''
   _value:
     description:
       - A dictionary with components as keyword and their value.
-      - If I(query) is provided, a string or integer will be returned instead, depending on I(query).
+      - If O(query) is provided, a string or integer will be returned instead, depending on O(query).
     type: any
 '''
 

ansible/plugins/filter/vault.yml

@@ -26,7 +26,7 @@ DOCUMENTATION:
       default: 'filter_default'
     wrap_object:
       description:
-        - This toggle can force the return of an C(AnsibleVaultEncryptedUnicode) string object, when C(False), you get a simple string.
+        - This toggle can force the return of an C(AnsibleVaultEncryptedUnicode) string object, when V(False), you get a simple string.
         - Mostly useful when combining with the C(to_yaml) filter to output the 'inline vault' format.
       type: bool
       default: False

ansible/plugins/filter/zip.yml

@@ -18,7 +18,7 @@ DOCUMENTATION:
       elements: any
       required: yes
     strict:
-      description: If C(True) return an error on mismatching list length, otherwise shortest list determines output.
+      description: If V(True) return an error on mismatching list length, otherwise shortest list determines output.
       type: bool
       default: no
 

ansible/plugins/filter/zip_longest.yml

@@ -5,7 +5,7 @@ DOCUMENTATION:
   positional: _input, _additional_lists
   description:
       - Make an iterator that aggregates elements from each of the iterables.
-        If the iterables are of uneven length, missing values are filled-in with I(fillvalue).
+        If the iterables are of uneven length, missing values are filled-in with O(fillvalue).
         Iteration continues until the longest iterable is exhausted.
   notes:
     - This is mostly a passhtrough to Python's C(itertools.zip_longest) function

ansible/plugins/inventory/__init__.py

@@ -30,7 +30,7 @@ from ansible.inventory.group import to_safe_group_name as original_safe
 from ansible.parsing.utils.addresses import parse_address
 from ansible.plugins import AnsiblePlugin
 from ansible.plugins.cache import CachePluginAdjudicator as CacheObject
-from ansible.module_utils._text import to_bytes, to_native
+from ansible.module_utils.common.text.converters import to_bytes, to_native
 from ansible.module_utils.parsing.convert_bool import boolean
 from ansible.module_utils.six import string_types
 from ansible.template import Templar

ansible/plugins/inventory/advanced_host_list.py

@@ -24,7 +24,7 @@ EXAMPLES = '''
 import os
 
 from ansible.errors import AnsibleError, AnsibleParserError
-from ansible.module_utils._text import to_bytes, to_native, to_text
+from ansible.module_utils.common.text.converters import to_bytes, to_native, to_text
 from ansible.plugins.inventory import BaseInventoryPlugin
 
 

ansible/plugins/inventory/constructed.py

@@ -13,7 +13,7 @@ DOCUMENTATION = '''
         - The Jinja2 conditionals that qualify a host for membership.
         - The Jinja2 expressions are calculated and assigned to the variables
         - Only variables already available from previous inventories or the fact cache can be used for templating.
-        - When I(strict) is False, failed expressions will be ignored (assumes vars were missing).
+        - When O(strict) is False, failed expressions will be ignored (assumes vars were missing).
     options:
         plugin:
             description: token that ensures this is a source file for the 'constructed' plugin.
@@ -84,7 +84,7 @@ from ansible import constants as C
 from ansible.errors import AnsibleParserError, AnsibleOptionsError
 from ansible.inventory.helpers import get_group_vars
 from ansible.plugins.inventory import BaseInventoryPlugin, Constructable
-from ansible.module_utils._text import to_native
+from ansible.module_utils.common.text.converters import to_native
 from ansible.utils.vars import combine_vars
 from ansible.vars.fact_cache import FactCache
 from ansible.vars.plugins import get_vars_from_inventory_sources

ansible/plugins/inventory/host_list.py

@@ -27,7 +27,7 @@ EXAMPLES = r'''
 import os
 
 from ansible.errors import AnsibleError, AnsibleParserError
-from ansible.module_utils._text import to_bytes, to_native, to_text
+from ansible.module_utils.common.text.converters import to_bytes, to_native, to_text
 from ansible.parsing.utils.addresses import parse_address
 from ansible.plugins.inventory import BaseInventoryPlugin
 

ansible/plugins/inventory/ini.py

@@ -75,12 +75,13 @@ host4 # same host as above, but member of 2 groups, will inherit vars from both
 
 import ast
 import re
+import warnings
 
 from ansible.inventory.group import to_safe_group_name
 from ansible.plugins.inventory import BaseFileInventoryPlugin
 
 from ansible.errors import AnsibleError, AnsibleParserError
-from ansible.module_utils._text import to_bytes, to_text
+from ansible.module_utils.common.text.converters import to_bytes, to_text
 from ansible.utils.shlex import shlex_split
 
 
@@ -341,9 +342,11 @@ class InventoryModule(BaseFileInventoryPlugin):
         (int, dict, list, unicode string, etc).
         '''
         try:
-            v = ast.literal_eval(v)
+            with warnings.catch_warnings():
+                warnings.simplefilter("ignore", SyntaxWarning)
+                v = ast.literal_eval(v)
         # Using explicit exceptions.
-        # Likely a string that literal_eval does not like. We wil then just set it.
+        # Likely a string that literal_eval does not like. We will then just set it.
         except ValueError:
             # For some reason this was thought to be malformed.
             pass