diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-28 16:04:21 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-28 16:04:21 +0000 |
commit | 8a754e0858d922e955e71b253c139e071ecec432 (patch) | |
tree | 527d16e74bfd1840c85efd675fdecad056c54107 /lib/ansible/plugins/filter/from_yaml.yml | |
parent | Initial commit. (diff) | |
download | ansible-core-8a754e0858d922e955e71b253c139e071ecec432.tar.xz ansible-core-8a754e0858d922e955e71b253c139e071ecec432.zip |
Adding upstream version 2.14.3.upstream/2.14.3upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'lib/ansible/plugins/filter/from_yaml.yml')
-rw-r--r-- | lib/ansible/plugins/filter/from_yaml.yml | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/lib/ansible/plugins/filter/from_yaml.yml b/lib/ansible/plugins/filter/from_yaml.yml new file mode 100644 index 0000000..e9b1599 --- /dev/null +++ b/lib/ansible/plugins/filter/from_yaml.yml @@ -0,0 +1,25 @@ +DOCUMENTATION: + name: from_yaml + version_added: 'historical' + short_description: Convert YAML string into variable structure + description: + - Converts a YAML string representation into an equivalent structured Ansible variable. + - Ansible automatically converts YAML strings into variable structures in most contexts, use this plugin in contexts where automatic conversion does not happen. + notes: + - This filter functions as a wrapper to the L(Python pyyaml library, https://pypi.org/project/PyYAML/)'s C(yaml.safe_load) function. + options: + _input: + description: A YAML string. + type: string + required: true +EXAMPLES: | + # variable from string variable containing a YAML document + {{ github_workflow | from_yaml}} + + # variable from string JSON document + {{ '{"a": true, "b": 54, "c": [1,2,3]}' | from_yaml }} + +RETURN: + _value: + description: The variable resulting from deserializing the YAML document. + type: raw |