diff options
Diffstat (limited to 'lib/ansible/plugins/filter/human_readable.yml')
-rw-r--r-- | lib/ansible/plugins/filter/human_readable.yml | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/lib/ansible/plugins/filter/human_readable.yml b/lib/ansible/plugins/filter/human_readable.yml new file mode 100644 index 0000000..e3028ac --- /dev/null +++ b/lib/ansible/plugins/filter/human_readable.yml @@ -0,0 +1,35 @@ +DOCUMENTATION: + name: human_redable + version_added: "historical" + short_description: Make bytes/bits human readable + description: + - Convert byte or bit figures to more human readable formats. + positional: _input, isbits, unit + options: + _input: + description: Number of bytes, or bits. Depends on I(isbits). + type: int + required: true + isbits: + description: Whether the input is bits, instead of bytes. + type: bool + default: false + unit: + description: Unit to force output into. If none specified the largest unit arrived at will be used. + type: str + choices: [ 'Y', 'Z', 'E', 'P', 'T', 'G', 'M', 'K', 'B'] +EXAMPLES: | + + # size => "1.15 GB" + size: "{{ 1232345345 | human_readable }}" + + # size => "1.15 Gb" + size_bits: "{{ 1232345345 | human_readable(true) }}" + + # size => "1175.26 MB" + size_MB: "{{ 1232345345 | human_readable(unit='M') }}" + +RETURN: + _value: + description: Human readable byte or bit size. + type: str |