fileglob.py (ansible-2.14.0) | : | fileglob.py (ansible-2.14.1rc1) | ||
---|---|---|---|---|
skipping to change at line 21 | skipping to change at line 21 | |||
short_description: list files matching a pattern | short_description: list files matching a pattern | |||
description: | description: | |||
- Matches all files in a single directory, non-recursively, that match a pattern. | - Matches all files in a single directory, non-recursively, that match a pattern. | |||
It calls Python's "glob" library. | It calls Python's "glob" library. | |||
options: | options: | |||
_terms: | _terms: | |||
description: path(s) of files to read | description: path(s) of files to read | |||
required: True | required: True | |||
notes: | notes: | |||
- Patterns are only supported on files, not directory/paths. | - Patterns are only supported on files, not directory/paths. | |||
- See R(Ansible task paths,playbook_task_paths) to understand how file loo kup occurs with paths. | ||||
- Matching is against local system files on the Ansible controller. | - Matching is against local system files on the Ansible controller. | |||
To iterate a list of files on a remote node, use the M(ansible.builtin.f ind) module. | To iterate a list of files on a remote node, use the M(ansible.builtin.f ind) module. | |||
- Returns a string list of paths joined by commas, or an empty list if no files match. For a 'true list' pass C(wantlist=True) to the lookup. | - Returns a string list of paths joined by commas, or an empty list if no files match. For a 'true list' pass C(wantlist=True) to the lookup. | |||
""" | """ | |||
EXAMPLES = """ | EXAMPLES = """ | |||
- name: Display paths of all .txt files in dir | - name: Display paths of all .txt files in dir | |||
ansible.builtin.debug: msg={{ lookup('ansible.builtin.fileglob', '/my/path/*.t xt') }} | ansible.builtin.debug: msg={{ lookup('ansible.builtin.fileglob', '/my/path/*.t xt') }} | |||
- name: Copy each file over that matches the given pattern | - name: Copy each file over that matches the given pattern | |||
End of changes. 1 change blocks. | ||||
0 lines changed or deleted | 1 lines changed or added |