diff options
Diffstat (limited to 'lib/ansible/plugins/filter/union.yml')
-rw-r--r-- | lib/ansible/plugins/filter/union.yml | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/lib/ansible/plugins/filter/union.yml b/lib/ansible/plugins/filter/union.yml new file mode 100644 index 0000000..d737900 --- /dev/null +++ b/lib/ansible/plugins/filter/union.yml @@ -0,0 +1,35 @@ +DOCUMENTATION: + name: union + author: Brian Coca (@bcoca) + version_added: "1.4" + short_description: union of lists + description: + - Provide a unique list of all the elements of two lists. + options: + _input: + description: A list. + type: list + required: true + _second_list: + description: A list. + type: list + required: true + seealso: + - plugin_type: filter + plugin: ansible.builtin.difference + - plugin_type: filter + plugin: ansible.builtin.intersect + - plugin_type: filter + plugin: ansible.builtin.symmetric_difference + - plugin_type: filter + plugin: ansible.builtin.unique +EXAMPLES: | + # return the unique elements of list1 added to list2 + # list1: [1, 2, 5, 1, 3, 4, 10] + # list2: [1, 2, 3, 4, 5, 11, 99] + {{ list1 | union(list2) }} + # => [1, 2, 5, 1, 3, 4, 10, 11, 99] +RETURN: + _value: + description: A unique list of all the elements from both lists. + type: list |