community.general.cartesian – returns the cartesian product of lists
Note
This plugin is part of the community.general collection (version 3.8.1).
You might already have this collection installed if you are using the ansible
package. It is not included in ansible-core
. To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.general
.
To use it in a playbook, specify: community.general.cartesian
.
Synopsis
- Takes the input lists and returns a list that represents the product of the input lists.
- It is clearer with an example, it turns [1, 2, 3], [a, b] into [1, a], [1, b], [2, a], [2, b], [3, a], [3, b]. You can see the exact syntax in the examples section.
Parameters
Parameter | Choices/Defaults | Configuration | Comments |
---|---|---|---|
_raw string / required | a set of lists |
Examples
- name: Example of the change in the description ansible.builtin.debug: msg: "{{ lookup('community.general.cartesian', [1,2,3], [a, b])}}" - name: loops over the cartesian product of the supplied lists ansible.builtin.debug: msg: "{{item}}" with_community.general.cartesian: - "{{list1}}" - "{{list2}}" - [1,2,3,4,5,6]
Return Values
Common return values are documented here, the following are the fields unique to this lookup:
Key | Returned | Description |
---|---|---|
_list list / elements=list | success | list of lists composed of elements of the input lists |
Authors
- Unknown (!UNKNOWN)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/cartesian_lookup.html