�

���cz!���dd
lm
Z
mZmZ
eZdZdZdZddl	Z	ddl
Z
ddlmZm
Z

ddlmZ
ddlmZmZ
dd	lmZ
dd
lmZ
dd�
ZGd
�de��ZdS)�)�absolute_import�division�print_functiona�
    name: first_found
    author: Seth Vidal (!UNKNOWN) <skvidal@fedoraproject.org>
    version_added: historical
    short_description: return first file found from list
    description:
      - This lookup checks a list of files and paths and returns the full path to the first combination found.
      - As all lookups, when fed relative paths it will try use the current task's location first and go up the chain
        to the containing locations of role / play / include and so on.
      - The list of files has precedence over the paths searched.
        For example, A task in a role has a 'file1' in the play's relative path, this will be used, 'file2' in role's relative path will not.
      - Either a list of files C(_terms) or a key C(files) with a list of files is required for this plugin to operate.
    notes:
      - This lookup can be used in 'dual mode', either passing a list of file names or a dictionary that has C(files) and C(paths).
    options:
      _terms:
        description: A list of file names.
      files:
        description: A list of file names.
        type: list
        elements: string
        default: []
      paths:
        description: A list of paths in which to look for the files.
        type: list
        elements: string
        default: []
      skip:
        type: boolean
        default: False
        description:
          - When C(True), return an empty list when no files are matched.
          - This is useful when used with C(with_first_found), as an empty list return to C(with_) calls
            causes the calling task to be skipped.
          - When used as a template via C(lookup) or C(query), setting I(skip=True) will *not* cause the task to skip.
            Tasks must handle the empty list return from the template.
          - When C(False) and C(lookup) or C(query) specifies  I(errors='ignore') all errors (including no file found,
            but potentially others) return an empty string or an empty list respectively.
          - When C(True) and C(lookup) or C(query) specifies I(errors='ignore'), no file found will return an empty
            list and other potential errors return an empty string or empty list depending on the template call
            (in other words return values of C(lookup) v C(query)).
a�	
- name: Set _found_file to the first existing file, raising an error if a file is not found
  ansible.builtin.set_fact:
    _found_file: "{{ lookup('ansible.builtin.first_found', findme) }}"
  vars:
    findme:
      - /path/to/foo.txt
      - bar.txt  # will be looked in files/ dir relative to role and/or play
      - /path/to/biz.txt

- name: Set _found_file to the first existing file, or an empty list if no files found
  ansible.builtin.set_fact:
    _found_file: "{{ lookup('ansible.builtin.first_found', files, paths=['/extra/path'], skip=True) }}"
  vars:
    files:
      - /path/to/foo.txt
      - /path/to/bar.txt

- name: Include tasks only if one of the files exist, otherwise skip the task
  ansible.builtin.include_tasks:
    file: "{{ item }}"
  with_first_found:
    - files:
      - path/tasks.yaml
      - path/other_tasks.yaml
      skip: True

- name: Include tasks only if one of the files exists, otherwise skip
  ansible.builtin.include_tasks: '{{ tasks_file }}'
  when: tasks_file != ""
  vars:
    tasks_file: "{{ lookup('ansible.builtin.first_found', files=['tasks.yaml', 'other_tasks.yaml'], errors='ignore') }}"

- name: |
        copy first existing file found to /some/file,
        looking in relative directories from where the task is defined and
        including any play objects that contain it
  ansible.builtin.copy:
    src: "{{ lookup('ansible.builtin.first_found', findme) }}"
    dest: /some/file
  vars:
    findme:
      - foo
      - "{{ inventory_hostname }}"
      - bar

- name: same copy but specific paths
  ansible.builtin.copy:
    src: "{{ lookup('ansible.builtin.first_found', params) }}"
    dest: /some/file
  vars:
    params:
      files:
        - foo
        - "{{ inventory_hostname }}"
        - bar
      paths:
        - /tmp/production
        - /tmp/staging

- name: INTERFACES | Create Ansible header for /etc/network/interfaces
  ansible.builtin.template:
    src: "{{ lookup('ansible.builtin.first_found', findme)}}"
    dest: "/etc/foo.conf"
  vars:
    findme:
      - "{{ ansible_virtualization_type }}_foo.conf"
      - "default_foo.conf"

- name: read vars from first file found, use 'vars/' relative subdir
  ansible.builtin.include_vars: "{{lookup('ansible.builtin.first_found', params)}}"
  vars:
    params:
      files:
        - '{{ ansible_distribution }}.yml'
        - '{{ ansible_os_family }}.yml'
        - default.yml
      paths:
        - 'vars'
zW
  _raw:
    description:
      - path to file found
    type: list
    elements: path
N)�Mapping�Sequence)
�UndefinedError)�AnsibleLookupError�AnsibleUndefinedVariable)
�string_types)
�
LookupBase�
,c	�
�g}t
|t��rDtjd
d�ttj|
���
�
z|��}n(|D]%}|�t||
���
�

�&|S)Nz[%s]�)	�
isinstancer�re�split�join�map�escape�extend�	_split_on)�terms�spliters�termlist�
ts    �G/usr/lib/python3.11/site-packages/ansible/plugins/lookup/first_found.pyrr�s~���H��%��&�&�4��8�G�b�g�g�c�"�)�X�.F�.F�&G�&G�G��O�O����
	4�
	4�A��O�O�I�a��2�2�3�3�3�3��O�c
��eZ
dZd
�Zd�ZdS)�LookupModulec��g}d
}|
D�
]�}t
|t��r|�||���
n�t
|t��r|�||���
ngt
|t��r0|�|||��\}}|�|�
�

��tdt|�
�
�
d|�
��
�
�
|�	d�
�
}|�	d�
�
}	|�	d�
�
}t|d��}
t|	d	��}|rA|D]<}|
D]7}
tj�
||
��}|�|�
�

�8�=�
�f|
r|
}�
�l|�|�
�

�
��||fS)
NF)�var_options�directzNInvalid term supplied, can handle string, mapping or list of strings but got: z for �files�paths�skipz,;z,:;)rr�set_optionsrr�_process_termsrr	�type�
get_optionr�os�pathr�append)�selfr�	variables�kwargs�total_searchr%�term�partialr#r$�filelist�pathlistr+�fn�
fs               rr'zLookupModule._process_terms�s�
������� 	*� 	*�D��$��(�(�	
Y�� � �Y�t� �D�D�D�D��D�,�/�/�
Y�� � �Y�v� �F�F�F�F��D�(�+�+�
Y� $� 3� 3�D�)�V� L� L�
����#�#�G�,�,�,��(�(�GK�LP�GQ�GQ�GQ�GQ�SW�SW�*X�Y�Y�Y��O�O�G�,�,�E��O�O�G�,�,�E��?�?�6�*�*�D�!���-�-�H� ���.�.�H��	
*�$�/�/�D�&�/�/���G�L�L��r�2�2�
�$�+�+�A�.�.�.�.�/�/��
*�'����#�#�D�)�)�)�)��T�!�!rc�2
�|�|
||��\}}t|d
d��}d}|D]U}	|j�|�
�
}n#tt
f$r
Y�1wxYw
|�|||d���}|�|g
c
S�V|rgStd�
�
�
)N�_subdirr#T)
�ignore_missingz)No file was found when using first_found.)r'�getattr�_templar�templater
r�find_file_in_search_pathr	)	r-rr.r/r0r%�subdirr+r5s	         r�runzLookupModule.run�s���!�0�0��	�6�J�J���d���y�'�2�2�����	�	�B�
��]�+�+�B�/�/����,�n�=�

�

�

���

�����0�0��F�B�W[�0�\�\�D����v�
�
�
� ��	��I� �!L�M�M�Ms�A�A"�!
A"N)�__name__�
__module__�__qualname__r'r?�rrrr�s8������("�("�("�T
N
�N
�N
�N
�N
rr)
r
)�
__future__rrrr(�
__metaclass__�
DOCUMENTATION�EXAMPLES�RETURNr*r�collections.abcrr�jinja2.exceptionsr�ansible.errorsr	r
�ansible.module_utils.sixr�ansible.plugins.lookuprrrrCrr�<module>rN
s
�


�
C
�B�B�B�B�B�B�B�B�B��
�)�
�V
O
��b
��

�	�	�	�	�	�	�	�-�-�-�-�-�-�-�-�,�,�,�,�,�,�G�G�G�G�G�G�G�G�1�1�1�1�1�1�-�-�-�-�-�-�
�
�
�
�J

N
�J

N
�J

N
�J

N
�J

N
�:�J

N
�J

N
�J

N
�J

N
�J

N
r