From 2806758793c7829e955147263ae45e32e7d31878 Mon Sep 17 00:00:00 2001 From: Abhijeet Kasurde Date: Thu, 14 Mar 2024 12:11:33 -0700 Subject: [PATCH] filter: Misc fixes in docs (#82823) * misc fixes for the filter documentation Signed-off-by: Abhijeet Kasurde --- lib/ansible/plugins/filter/b64decode.yml | 16 ++++++++-------- lib/ansible/plugins/filter/b64encode.yml | 8 ++++---- lib/ansible/plugins/filter/core.py | 2 +- 3 files changed, 13 insertions(+), 13 deletions(-) diff --git a/lib/ansible/plugins/filter/b64decode.yml b/lib/ansible/plugins/filter/b64decode.yml index af8045a7654..339de3a724d 100644 --- a/lib/ansible/plugins/filter/b64decode.yml +++ b/lib/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 diff --git a/lib/ansible/plugins/filter/b64encode.yml b/lib/ansible/plugins/filter/b64encode.yml index 976d1fef22d..ed32bfb8066 100644 --- a/lib/ansible/plugins/filter/b64encode.yml +++ b/lib/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 diff --git a/lib/ansible/plugins/filter/core.py b/lib/ansible/plugins/filter/core.py index 474e743962e..1c62dd569d7 100644 --- a/lib/ansible/plugins/filter/core.py +++ b/lib/ansible/plugins/filter/core.py @@ -592,7 +592,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)