a

�)gL�@sDdd
lm
Z
mZmZ
eZdZdZdZddl	m
Z

Gdd�de
�ZdS)	�)�absolute_import�division�print_functionaV
    name: items
    author: Michael DeHaan
    version_added: historical
    short_description: list of items
    description:
      - this lookup returns a list of items given to it, if any of the top level items is also a list it will flatten it, but it will not recurse
    notes:
      - this is the standard lookup used for loops in most examples
      - check out the 'flattened' lookup for recursive flattening
      - if you do not want flattening nor any other transformation look at the 'list' lookup.
    options:
      _terms:
        description: list of items
        required: True
a�
- name: "loop through list"
  ansible.builtin.debug:
    msg: "An item: {{ item }}"
  with_items:
    - 1
    - 2
    - 3

- name: add several users
  ansible.builtin.user:
    name: "{{ item }}"
    groups: "wheel"
    state: present
  with_items:
     - testuser1
     - testuser2

- name: "loop through list from a variable"
  ansible.builtin.debug:
    msg: "An item: {{ item }}"
  with_items: "{{ somelist }}"

- name: more complex items to add several users
  ansible.builtin.user:
    name: "{{ item.name }}"
    uid: "{{ item.uid }}"
    groups: "{{ item.groups }}"
    state: present
  with_items:
     - { name: testuser1, uid: 1002, groups: "wheel, staff" }
     - { name: testuser2, uid: 1003, groups: staff }

zE
  _raw:
    description:
      - once flattened list
    type: list
)
�
LookupBasec@seZ
dZd
d�ZdS)�LookupModulecKs
|�|
�
S)
N)
Z_flatten)�selfZterms�kwargs�r	�@/usr/lib/python3.9/site-packages/ansible/plugins/lookup/items.py�runGszLookupModule.runN)�__name__�
__module__�__qualname__rr	r	r	r
rEsrN)Z
__future__rrr�typeZ
__metaclass__Z
DOCUMENTATIONZEXAMPLESZRETURNZansible.plugins.lookuprrr	r	r	r
�<module>s
#