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)