diff --git a/lib/ansible/plugins/lookup/filetree.py b/lib/ansible/plugins/lookup/filetree.py index 83b52f389f6..274f25dd740 100644 --- a/lib/ansible/plugins/lookup/filetree.py +++ b/lib/ansible/plugins/lookup/filetree.py @@ -11,7 +11,7 @@ version_added: "2.4" short_description: recursively match all files in a directory tree description: - This lookup enables you to template a complete tree of files on a target system while retaining permissions and ownership. -- Supports directories, files and symlinks, including SELinux and other file properties +- Supports directories, files and symlinks, including SELinux and other file properties. - If you provide more than one path, it will implement a first_found logic, and will not process entries it already processed in previous paths. This enables merging different trees in order of importance, or add role_vars to specific paths to influence different instances of the same role. options: @@ -29,7 +29,7 @@ EXAMPLES = """ with_filetree: web/ when: item.state == 'directory' -- name: Template files +- name: Template files (explicitly skip directories in order to use the 'src' attribute) template: src: '{{ item.src }}' dest: /web/{{ item.path }} @@ -53,7 +53,9 @@ RETURN = """ description: list of dictionaries with file information contains: src: - description: TODO + description: + - full path to file + - not returned when C(item.state) is set to C(directory) root: description: allows filtering by original location path: