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

ansible/plugins/lookup/ini.py

@@ -39,7 +39,7 @@ DOCUMENTATION = """
         default: ''
       case_sensitive:
         description:
-          Whether key names read from C(file) should be case sensitive. This prevents
+          Whether key names read from O(file) should be case sensitive. This prevents
           duplicate key errors if keys only differ in case.
         default: False
         version_added: '2.12'
@@ -50,6 +50,9 @@ DOCUMENTATION = """
         default: False
         aliases: ['allow_none']
         version_added: '2.12'
+    seealso:
+      - ref: playbook_task_paths
+        description: Search paths used for relative files.
 """
 
 EXAMPLES = """
@@ -85,7 +88,7 @@ from collections import defaultdict
 from collections.abc import MutableSequence
 
 from ansible.errors import AnsibleLookupError, AnsibleOptionsError
-from ansible.module_utils._text import to_text, to_native
+from ansible.module_utils.common.text.converters import to_text, to_native
 from ansible.plugins.lookup import LookupBase
 
 
@@ -187,7 +190,7 @@ class LookupModule(LookupBase):
             config.seek(0, os.SEEK_SET)
 
             try:
-                self.cp.readfp(config)
+                self.cp.read_file(config)
             except configparser.DuplicateOptionError as doe:
                 raise AnsibleLookupError("Duplicate option in '{file}': {error}".format(file=paramvals['file'], error=to_native(doe)))
 

ansible/plugins/lookup/lines.py

@@ -20,6 +20,7 @@ DOCUMENTATION = """
       - Like all lookups, this runs on the Ansible controller and is unaffected by other keywords such as 'become'.
         If you need to use different permissions, you must change the command or run Ansible as another user.
       - Alternatively, you can use a shell/command task that runs against localhost and registers the result.
+      - The directory of the play is used as the current working directory.
 """
 
 EXAMPLES = """
@@ -44,7 +45,7 @@ RETURN = """
 import subprocess
 from ansible.errors import AnsibleError
 from ansible.plugins.lookup import LookupBase
-from ansible.module_utils._text import to_text
+from ansible.module_utils.common.text.converters import to_text
 
 
 class LookupModule(LookupBase):

ansible/plugins/lookup/password.py

@@ -28,17 +28,18 @@ DOCUMENTATION = """
          required: True
       encrypt:
         description:
-           - Which hash scheme to encrypt the returning password, should be one hash scheme from C(passlib.hash; md5_crypt, bcrypt, sha256_crypt, sha512_crypt).
+           - Which hash scheme to encrypt the returning password, should be one hash scheme from C(passlib.hash);
+             V(md5_crypt), V(bcrypt), V(sha256_crypt), V(sha512_crypt).
            - If not provided, the password will be returned in plain text.
            - Note that the password is always stored as plain text, only the returning password is encrypted.
            - Encrypt also forces saving the salt value for idempotence.
            - Note that before 2.6 this option was incorrectly labeled as a boolean for a long time.
       ident:
         description:
-          - Specify version of Bcrypt algorithm to be used while using C(encrypt) as C(bcrypt).
-          - The parameter is only available for C(bcrypt) - U(https://passlib.readthedocs.io/en/stable/lib/passlib.hash.bcrypt.html#passlib.hash.bcrypt).
+          - Specify version of Bcrypt algorithm to be used while using O(encrypt) as V(bcrypt).
+          - The parameter is only available for V(bcrypt) - U(https://passlib.readthedocs.io/en/stable/lib/passlib.hash.bcrypt.html#passlib.hash.bcrypt).
           - Other hash types will simply ignore this parameter.
-          - 'Valid values for this parameter are: C(2), C(2a), C(2y), C(2b).'
+          - 'Valid values for this parameter are: V(2), V(2a), V(2y), V(2b).'
         type: string
         version_added: "2.12"
       chars:
@@ -46,8 +47,7 @@ DOCUMENTATION = """
         description:
           - A list of names that compose a custom character set in the generated passwords.
           - This parameter defines the possible character sets in the resulting password, not the required character sets.
-            If you want to require certain character sets for passwords, you can use the C(community.general.random_string lookup) plugin -
-            P(community.general.random_string#lookup).
+            If you want to require certain character sets for passwords, you can use the P(community.general.random_string#lookup) lookup plugin.
           - 'By default generated passwords contain a random mix of upper and lowercase ASCII letters, the numbers 0-9, and punctuation (". , : - _").'
           - "They can be either parts of Python's string module attributes or represented literally ( :, -)."
           - "Though string modules can vary by Python version, valid values for both major releases include:
@@ -133,7 +133,7 @@ import time
 import hashlib
 
 from ansible.errors import AnsibleError, AnsibleAssertionError
-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.module_utils.six import string_types
 from ansible.parsing.splitter import parse_kv
 from ansible.plugins.lookup import LookupBase

ansible/plugins/lookup/pipe.py

@@ -24,6 +24,7 @@ DOCUMENTATION = r"""
         It is strongly recommended to pass user input or variable input via quote filter before using with pipe lookup.
         See example section for this.
         Read more about this L(Bandit B602 docs,https://bandit.readthedocs.io/en/latest/plugins/b602_subprocess_popen_with_shell_equals_true.html)
+      - The directory of the play is used as the current working directory.
 """
 
 EXAMPLES = r"""

ansible/plugins/lookup/random_choice.py

@@ -35,13 +35,13 @@ RETURN = """
 import random
 
 from ansible.errors import AnsibleError
-from ansible.module_utils._text import to_native
+from ansible.module_utils.common.text.converters import to_native
 from ansible.plugins.lookup import LookupBase
 
 
 class LookupModule(LookupBase):
 
-    def run(self, terms, inject=None, **kwargs):
+    def run(self, terms, variables=None, **kwargs):
 
         ret = terms
         if terms:

ansible/plugins/lookup/sequence.py

@@ -175,7 +175,7 @@ class LookupModule(LookupBase):
         if not match:
             return False
 
-        _, start, end, _, stride, _, format = match.groups()
+        dummy, start, end, dummy, stride, dummy, format = match.groups()
 
         if start is not None:
             try:

ansible/plugins/lookup/subelements.py

@@ -19,8 +19,8 @@ DOCUMENTATION = """
         default: False
         description:
           - Lookup accepts this flag from a dictionary as optional. See Example section for more information.
-          - If set to C(True), the lookup plugin will skip the lists items that do not contain the given subkey.
-          - If set to C(False), the plugin will yield an error and complain about the missing subkey.
+          - If set to V(True), the lookup plugin will skip the lists items that do not contain the given subkey.
+          - If set to V(False), the plugin will yield an error and complain about the missing subkey.
 """
 
 EXAMPLES = """

ansible/plugins/lookup/template.py

@@ -56,6 +56,9 @@ DOCUMENTATION = """
         version_added: '2.12'
         type: str
         default: '#}'
+    seealso:
+      - ref: playbook_task_paths
+        description: Search paths used for relative templates.
 """
 
 EXAMPLES = """
@@ -86,7 +89,7 @@ import ansible.constants as C
 
 from ansible.errors import AnsibleError
 from ansible.plugins.lookup import LookupBase
-from ansible.module_utils._text import to_text
+from ansible.module_utils.common.text.converters import to_text
 from ansible.template import generate_ansible_template_vars, AnsibleEnvironment
 from ansible.utils.display import Display
 from ansible.utils.native_jinja import NativeJinjaText

ansible/plugins/lookup/unvault.py

@@ -16,6 +16,9 @@ DOCUMENTATION = """
         required: True
     notes:
       - This lookup does not understand 'globbing' nor shell environment variables.
+    seealso:
+      - ref: playbook_task_paths
+        description: Search paths used for relative files.
 """
 
 EXAMPLES = """
@@ -32,7 +35,7 @@ RETURN = """
 
 from ansible.errors import AnsibleParserError
 from ansible.plugins.lookup import LookupBase
-from ansible.module_utils._text import to_text
+from ansible.module_utils.common.text.converters import to_text
 from ansible.utils.display import Display
 
 display = Display()

ansible/plugins/lookup/url.py

@@ -64,7 +64,7 @@ options:
         - section: url_lookup
           key: timeout
   http_agent:
-    description: User-Agent to use in the request. The default was changed in 2.11 to C(ansible-httpget).
+    description: User-Agent to use in the request. The default was changed in 2.11 to V(ansible-httpget).
     type: string
     version_added: "2.10"
     default: ansible-httpget
@@ -81,12 +81,12 @@ options:
     version_added: "2.10"
     default: False
     vars:
-        - name: ansible_lookup_url_agent
+        - name: ansible_lookup_url_force_basic_auth
     env:
-        - name: ANSIBLE_LOOKUP_URL_AGENT
+        - name: ANSIBLE_LOOKUP_URL_FORCE_BASIC_AUTH
     ini:
         - section: url_lookup
-          key: agent
+          key: force_basic_auth
   follow_redirects:
     description: String of urllib2, all/yes, safe, none to determine how redirects are followed, see RedirectHandlerFactory for more information
     type: string
@@ -102,7 +102,7 @@ options:
   use_gssapi:
     description:
     - Use GSSAPI handler of requests
-    - As of Ansible 2.11, GSSAPI credentials can be specified with I(username) and I(password).
+    - As of Ansible 2.11, GSSAPI credentials can be specified with O(username) and O(password).
     type: boolean
     version_added: "2.10"
     default: False
@@ -211,7 +211,7 @@ RETURN = """
 from urllib.error import HTTPError, URLError
 
 from ansible.errors import AnsibleError
-from ansible.module_utils._text import to_text, to_native
+from ansible.module_utils.common.text.converters import to_text, to_native
 from ansible.module_utils.urls import open_url, ConnectionError, SSLValidationError
 from ansible.plugins.lookup import LookupBase
 from ansible.utils.display import Display

ansible/plugins/lookup/varnames.py

@@ -46,7 +46,7 @@ _value:
 import re
 
 from ansible.errors import AnsibleError
-from ansible.module_utils._text import to_native
+from ansible.module_utils.common.text.converters import to_native
 from ansible.module_utils.six import string_types
 from ansible.plugins.lookup import LookupBase
 

ansible/plugins/netconf/__init__.py

@@ -24,7 +24,7 @@ from functools import wraps
 
 from ansible.errors import AnsibleError
 from ansible.plugins import AnsiblePlugin
-from ansible.module_utils._text import to_native
+from ansible.module_utils.common.text.converters import to_native
 from ansible.module_utils.basic import missing_required_lib
 
 try:
@@ -62,8 +62,8 @@ class NetconfBase(AnsiblePlugin):
         :class:`TerminalBase` plugins are byte strings.  This is because of
         how close to the underlying platform these plugins operate.  Remember
         to mark literal strings as byte string (``b"string"``) and to use
-        :func:`~ansible.module_utils._text.to_bytes` and
-        :func:`~ansible.module_utils._text.to_text` to avoid unexpected
+        :func:`~ansible.module_utils.common.text.converters.to_bytes` and
+        :func:`~ansible.module_utils.common.text.converters.to_text` to avoid unexpected
         problems.
 
         List of supported rpc's:

ansible/plugins/shell/__init__.py

@@ -27,7 +27,7 @@ import time
 from collections.abc import Mapping, Sequence
 
 from ansible.errors import AnsibleError
-from ansible.module_utils._text import to_native
+from ansible.module_utils.common.text.converters import to_native
 from ansible.module_utils.six import text_type, string_types
 from ansible.plugins import AnsiblePlugin
 

ansible/plugins/shell/cmd.py

@@ -34,24 +34,24 @@ class ShellModule(PSShellModule):
     # Used by various parts of Ansible to do Windows specific changes
     _IS_WINDOWS = True
 
-    def quote(self, s):
+    def quote(self, cmd):
         # cmd does not support single quotes that the shlex_quote uses. We need to override the quoting behaviour to
         # better match cmd.exe.
         # https://blogs.msdn.microsoft.com/twistylittlepassagesallalike/2011/04/23/everyone-quotes-command-line-arguments-the-wrong-way/
 
         # Return an empty argument
-        if not s:
+        if not cmd:
             return '""'
 
-        if _find_unsafe(s) is None:
-            return s
+        if _find_unsafe(cmd) is None:
+            return cmd
 
         # Escape the metachars as we are quoting the string to stop cmd from interpreting that metachar. For example
         # 'file &whoami.exe' would result in 'file $(whoami.exe)' instead of the literal string
         # https://stackoverflow.com/questions/3411771/multiple-character-replace-with-python
         for c in '^()%!"<>&|':  # '^' must be the first char that we scan and replace
-            if c in s:
+            if c in cmd:
                 # I can't find any docs that explicitly say this but to escape ", it needs to be prefixed with \^.
-                s = s.replace(c, ("\\^" if c == '"' else "^") + c)
+                cmd = cmd.replace(c, ("\\^" if c == '"' else "^") + c)
 
-        return '^"' + s + '^"'
+        return '^"' + cmd + '^"'

ansible/plugins/shell/powershell.py

@@ -23,7 +23,7 @@ import pkgutil
 import xml.etree.ElementTree as ET
 import ntpath
 
-from ansible.module_utils._text import to_bytes, to_text
+from ansible.module_utils.common.text.converters import to_bytes, to_text
 from ansible.plugins.shell import ShellBase
 
 

ansible/plugins/strategy/__init__.py

@@ -43,7 +43,7 @@ from ansible.executor.process.worker import WorkerProcess
 from ansible.executor.task_result import TaskResult
 from ansible.executor.task_queue_manager import CallbackSend, DisplaySend, PromptSend
 from ansible.module_utils.six import string_types
-from ansible.module_utils._text import to_text
+from ansible.module_utils.common.text.converters import to_text
 from ansible.module_utils.connection import Connection, ConnectionError
 from ansible.playbook.conditional import Conditional
 from ansible.playbook.handler import Handler
@@ -54,7 +54,6 @@ from ansible.plugins import loader as plugin_loader
 from ansible.template import Templar
 from ansible.utils.display import Display
 from ansible.utils.fqcn import add_internal_fqcns
-from ansible.utils.multiprocessing import context as multiprocessing_context
 from ansible.utils.unsafe_proxy import wrap_var
 from ansible.utils.vars import combine_vars, isidentifier
 from ansible.vars.clean import strip_internal_keys, module_response_deepcopy
@@ -117,7 +116,8 @@ def results_thread_main(strategy):
             if isinstance(result, StrategySentinel):
                 break
             elif isinstance(result, DisplaySend):
-                display.display(*result.args, **result.kwargs)
+                dmethod = getattr(display, result.method)
+                dmethod(*result.args, **result.kwargs)
             elif isinstance(result, CallbackSend):
                 for arg in result.args:
                     if isinstance(arg, TaskResult):
@@ -571,10 +571,7 @@ class StrategyBase:
         Reads results off the final queue and takes appropriate action
         based on the result (executing callbacks, updating state, etc.).
         '''
-
         ret_results = []
-        handler_templar = Templar(self._loader)
-
         cur_pass = 0
         while True:
             try:
@@ -605,7 +602,7 @@ class StrategyBase:
                     else:
                         iterator.mark_host_failed(original_host)
 
-                    state, _ = iterator.get_next_task_for_host(original_host, peek=True)
+                    state, dummy = iterator.get_next_task_for_host(original_host, peek=True)
 
                     if iterator.is_failed(original_host) and state and state.run_state == IteratingStates.COMPLETE:
                         self._tqm._failed_hosts[original_host.name] = True
@@ -702,7 +699,7 @@ class StrategyBase:
                         else:
                             all_task_vars = found_task_vars
                         all_task_vars[original_task.register] = wrap_var(result_item)
-                        post_process_whens(result_item, original_task, handler_templar, all_task_vars)
+                        post_process_whens(result_item, original_task, Templar(self._loader), all_task_vars)
                         if original_task.loop or original_task.loop_with:
                             new_item_result = TaskResult(
                                 task_result._host,
@@ -1036,8 +1033,9 @@ class StrategyBase:
             # How would this work with allow_duplicates??
             if task.implicit:
                 role_obj = self._get_cached_role(task, iterator._play)
-                role_obj._completed[target_host.name] = True
-                msg = 'role_complete for %s' % target_host.name
+                if target_host.name in role_obj._had_task_run:
+                    role_obj._completed[target_host.name] = True
+                    msg = 'role_complete for %s' % target_host.name
         elif meta_action == 'reset_connection':
             all_vars = self._variable_manager.get_vars(play=iterator._play, host=target_host, task=task,
                                                        _hosts=self._hosts_cache, _hosts_all=self._hosts_cache_all)

ansible/plugins/strategy/free.py

@@ -40,7 +40,7 @@ from ansible.playbook.included_file import IncludedFile
 from ansible.plugins.loader import action_loader
 from ansible.plugins.strategy import StrategyBase
 from ansible.template import Templar
-from ansible.module_utils._text import to_text
+from ansible.module_utils.common.text.converters import to_text
 from ansible.utils.display import Display
 
 display = Display()

ansible/plugins/strategy/linear.py

@@ -34,7 +34,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.module_utils._text import to_text
+from ansible.module_utils.common.text.converters import to_text
 from ansible.playbook.handler import Handler
 from ansible.playbook.included_file import IncludedFile
 from ansible.playbook.task import Task
@@ -77,7 +77,7 @@ class StrategyModule(StrategyBase):
 
         if self._in_handlers and not any(filter(
             lambda rs: rs == IteratingStates.HANDLERS,
-            (s.run_state for s, _ in state_task_per_host.values()))
+            (s.run_state for s, dummy in state_task_per_host.values()))
         ):
             self._in_handlers = False
 
@@ -361,7 +361,7 @@ class StrategyModule(StrategyBase):
                 if any_errors_fatal and (len(failed_hosts) > 0 or len(unreachable_hosts) > 0):
                     dont_fail_states = frozenset([IteratingStates.RESCUE, IteratingStates.ALWAYS])
                     for host in hosts_left:
-                        (s, _) = iterator.get_next_task_for_host(host, peek=True)
+                        (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)

ansible/plugins/terminal/__init__.py

@@ -34,8 +34,8 @@ class TerminalBase(ABC):
         :class:`TerminalBase` plugins are byte strings.  This is because of
         how close to the underlying platform these plugins operate.  Remember
         to mark literal strings as byte string (``b"string"``) and to use
-        :func:`~ansible.module_utils._text.to_bytes` and
-        :func:`~ansible.module_utils._text.to_text` to avoid unexpected
+        :func:`~ansible.module_utils.common.text.converters.to_bytes` and
+        :func:`~ansible.module_utils.common.text.converters.to_text` to avoid unexpected
         problems.
     '''
 

ansible/plugins/test/abs.yml

@@ -19,5 +19,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: Returns C(True) if the path is absolute, C(False) if it is relative.
+    description: Returns V(True) if the path is absolute, V(False) if it is relative.
     type: boolean

ansible/plugins/test/all.yml

@@ -19,5 +19,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: Returns C(True) if all elements of the list were True, C(False) otherwise.
+    description: Returns V(True) if all elements of the list were True, V(False) otherwise.
     type: boolean

ansible/plugins/test/any.yml

@@ -19,5 +19,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: Returns C(True) if any element of the list was true, C(False) otherwise.
+    description: Returns V(True) if any element of the list was true, V(False) otherwise.
     type: boolean

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 C(True) if present
+    - This test checks for the existance 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
@@ -18,5 +18,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: Returns C(True) if the task was required changes, C(False) otherwise.
+    description: Returns V(True) if the task was required changes, V(False) otherwise.
     type: boolean

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 C(True) if present
+    - This test checks for the existance 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
@@ -18,5 +18,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: Returns C(True) if the task was required changes, C(False) otherwise.
+    description: Returns V(True) if the task was required changes, V(False) otherwise.
     type: boolean

ansible/plugins/test/contains.yml

@@ -45,5 +45,5 @@ EXAMPLES: |
               - em4
 RETURN:
   _value:
-    description: Returns C(True) if the specified element is contained in the supplied sequence, C(False) otherwise.
+    description: Returns V(True) if the specified element is contained in the supplied sequence, V(False) otherwise.
     type: boolean

ansible/plugins/test/core.py

@@ -27,7 +27,7 @@ from collections.abc import MutableMapping, MutableSequence
 from ansible.module_utils.compat.version import LooseVersion, StrictVersion
 
 from ansible import errors
-from ansible.module_utils._text import to_native, to_text
+from ansible.module_utils.common.text.converters import to_native, to_text
 from ansible.module_utils.parsing.convert_bool import boolean
 from ansible.utils.display import Display
 from ansible.utils.version import SemanticVersion

ansible/plugins/test/directory.yml

@@ -17,5 +17,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: Returns C(True) if the path corresponds to an existing directory on the filesystem on the controller, c(False) if otherwise.
+    description: Returns V(True) if the path corresponds to an existing directory on the filesystem on the controller, V(False) if otherwise.
     type: boolean

ansible/plugins/test/exists.yml

@@ -5,7 +5,8 @@ DOCUMENTATION:
   short_description: does the path exist, follow symlinks
   description:
     - Check if the provided path maps to an existing filesystem object on the controller (localhost).
-    - Follows symlinks and checks the target of the symlink instead of the link itself, use the C(link) or C(link_exists) tests to check on the link.
+    - Follows symlinks and checks the target of the symlink instead of the link itself, use the P(ansible.builtin.link#test)
+      or P(ansible.builtin.link_exists#test) tests to check on the link.
   options:
     _input:
       description: a path
@@ -18,5 +19,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: Returns C(True) if the path corresponds to an existing filesystem object on the controller (after following symlinks), C(False) if otherwise.
+    description: Returns V(True) if the path corresponds to an existing filesystem object on the controller (after following symlinks), V(False) if otherwise.
     type: boolean

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 C(True) if present.
+    - This test checks for the existance 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:
@@ -19,5 +19,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: Returns C(True) if the task was failed, C(False) otherwise.
+    description: Returns V(True) if the task was failed, V(False) otherwise.
     type: boolean

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 C(True) if present.
+    - This test checks for the existance 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:
@@ -19,5 +19,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: Returns C(True) if the task was failed, C(False) otherwise.
+    description: Returns V(True) if the task was failed, V(False) otherwise.
     type: boolean

ansible/plugins/test/falsy.yml

@@ -12,7 +12,7 @@ DOCUMENTATION:
       type: string
       required: True
     convert_bool:
-      description: Attempts to convert the result to a strict Python boolean vs normally acceptable values (C(yes)/C(no), C(on)/C(off), C(0)/C(1), etc).
+      description: Attempts to convert the result to a strict Python boolean vs normally acceptable values (V(yes)/V(no), V(on)/V(off), V(0)/V(1), etc).
       type: bool
       default: false
 EXAMPLES: |
@@ -20,5 +20,5 @@ EXAMPLES: |
     thisistrue: '{{ "" is falsy }}'
 RETURN:
   _value:
-    description: Returns C(False) if the condition is not "Python truthy", C(True) otherwise.
+    description: Returns V(False) if the condition is not "Python truthy", V(True) otherwise.
     type: boolean

ansible/plugins/test/file.yml

@@ -18,5 +18,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: Returns C(True) if the path corresponds to an existing file on the filesystem on the controller, C(False) if otherwise.
+    description: Returns V(True) if the path corresponds to an existing file on the filesystem on the controller, V(False) if otherwise.
     type: boolean

ansible/plugins/test/finished.yml

@@ -5,7 +5,7 @@ DOCUMENTATION:
   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 C(1) if present
+    - This test checks for the existance 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 C(True) if the aysnc task has finished, C(False) otherwise.
+    description: Returns V(True) if the aysnc task has finished, V(False) otherwise.
     type: boolean

ansible/plugins/test/is_abs.yml

@@ -19,5 +19,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: Returns C(True) if the path is absolute, C(False) if it is relative.
+    description: Returns V(True) if the path is absolute, V(False) if it is relative.
     type: boolean

ansible/plugins/test/is_dir.yml

@@ -17,5 +17,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: Returns C(True) if the path corresponds to an existing directory on the filesystem on the controller, c(False) if otherwise.
+    description: Returns V(True) if the path corresponds to an existing directory on the filesystem on the controller, V(False) if otherwise.
     type: boolean

ansible/plugins/test/is_file.yml

@@ -18,5 +18,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: Returns C(True) if the path corresponds to an existing file on the filesystem on the controller, C(False) if otherwise.
+    description: Returns V(True) if the path corresponds to an existing file on the filesystem on the controller, V(False) if otherwise.
     type: boolean

ansible/plugins/test/is_link.yml

@@ -17,5 +17,5 @@ EXAMPLES: |
 
 RETURN:
   _value:
-    description: Returns C(True) if the path corresponds to an existing symlink on the filesystem on the controller, C(False) if otherwise.
+    description: Returns V(True) if the path corresponds to an existing symlink on the filesystem on the controller, V(False) if otherwise.
     type: boolean