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).
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,7 +53,7 @@ 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)'
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,11 +36,11 @@ 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).'
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.
description:Whether to use strict version scheme. Mutually exclusive with C(version_type)
description:Whether to use strict version scheme. Mutually exclusive with O(version_type)
type:boolean
required:False
default:False
version_type:
description:Version scheme to use for comparison. Mutually exclusive with C(strict). See C(notes) for descriptions on the version types.
description:Version scheme to use for comparison. Mutually exclusive with O(strict). See C(notes) for descriptions on the version types.
type:string
required:False
choices:
@ -52,10 +52,10 @@ DOCUMENTATION:
- pep440
default:loose
notes:
- C(loose) - This type corresponds to the Python C(distutils.version.LooseVersion) class. All version formats are valid for this type. The rules for comparison are simple and predictable, but may not always give expected results.
- C(strict) - This type corresponds to the Python C(distutils.version.StrictVersion) class. A version number consists of two or three dot-separated numeric components, with an optional "pre-release" tag on the end. The pre-release tag consists of a single letter C(a) or C(b) followed by a number. If the numeric components of two version numbers are equal, then one with a pre-release tag will always be deemed earlier (lesser) than one without.
- C(semver)/C(semantic) - This type implements the L(Semantic Version,https://semver.org) scheme for version comparison.
- C(pep440) - This type implements the Python L(PEP-440,https://peps.python.org/pep-0440/) versioning rules for version comparison. Added in version 2.14.
- V(loose) - This type corresponds to the Python C(distutils.version.LooseVersion) class. All version formats are valid for this type. The rules for comparison are simple and predictable, but may not always give expected results.
- V(strict) - This type corresponds to the Python C(distutils.version.StrictVersion) class. A version number consists of two or three dot-separated numeric components, with an optional "pre-release" tag on the end. The pre-release tag consists of a single letter C(a) or C(b) followed by a number. If the numeric components of two version numbers are equal, then one with a pre-release tag will always be deemed earlier (lesser) than one without.
- V(semver)/V(semantic) - This type implements the L(Semantic Version,https://semver.org) scheme for version comparison.
- V(pep440) - This type implements the Python L(PEP-440,https://peps.python.org/pep-0440/) versioning rules for version comparison. Added in version 2.14.
EXAMPLES:|
- name:version test examples
assert:
@ -78,5 +78,5 @@ EXAMPLES: |
- "'2.14.0rc1' is version('2.14.0', 'lt', version_type='pep440')"
RETURN:
_value:
description:Returns C(True) or C(False) depending on the outcome of the comparison.
description:Returns V(True) or V(False) depending on the outcome of the comparison.