diff --git a/docs/docsite/rst/playbooks_filters.rst b/docs/docsite/rst/playbooks_filters.rst index 2e6d687e66..2782f690d0 100644 --- a/docs/docsite/rst/playbooks_filters.rst +++ b/docs/docsite/rst/playbooks_filters.rst @@ -893,7 +893,7 @@ To create a UUID from a string (new in version 1.9):: To cast values as certain types, such as when you input a string as "True" from a vars_prompt and the system doesn't know it is a boolean value:: - - debug: + - debug: msg: test when: some_string_value | bool @@ -904,6 +904,17 @@ To make use of one attribute from each item in a list of complex variables, use # get a comma-separated list of the mount points (e.g. "/,/mnt/stuff") on a host {{ ansible_mounts|map(attribute='mount')|join(',') }} +.. versionadded:: 2.5 + +The `slice` filter can be used to extract the values of specific keys from a +hash:: + + {{ {'x': 1, 'y': 2, 'z': 3 } | slice(['x', 'z']) }} + +This will result in:: + + [1, 2] + To get date object from string use the `to_datetime` filter, (new in version in 2.2):: # get amount of seconds between two dates, default date format is %Y-%m-%d %H:%M:%S but you can pass your own one @@ -919,7 +930,7 @@ This set of filters returns a list of combined lists. To get permutations of a list:: - name: give me largest permutations (order matters) - debug: + debug: msg: "{{ [1,2,3,4,5]|permutations|list }}" - name: give me permutations of sets of three