
    Vh                    >    d dl mZ dZdZdZd dlmZ  G d de      Zy)	    )annotationsaV  
    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                      e Zd Zd Zy)LookupModulec                $    | j                  |      S )N)_flatten)selftermskwargss      L/home/dcms/DCMS/lib/python3.12/site-packages/ansible/plugins/lookup/items.pyrunzLookupModule.runF   s    }}U##    N)__name__
__module____qualname__r    r   r   r   r   D   s    $r   r   N)
__future__r   DOCUMENTATIONEXAMPLESRETURNansible.plugins.lookupr   r   r   r   r   <module>r      s1    #"!F
 .$: $r   