summaryrefslogtreecommitdiffstats
path: root/lib/ansible/plugins/filter/fileglob.yml
diff options
context:
space:
mode:
Diffstat (limited to 'lib/ansible/plugins/filter/fileglob.yml')
-rw-r--r--lib/ansible/plugins/filter/fileglob.yml22
1 files changed, 22 insertions, 0 deletions
diff --git a/lib/ansible/plugins/filter/fileglob.yml b/lib/ansible/plugins/filter/fileglob.yml
new file mode 100644
index 0000000..69e8a9b
--- /dev/null
+++ b/lib/ansible/plugins/filter/fileglob.yml
@@ -0,0 +1,22 @@
+DOCUMENTATION:
+ name: fileglob
+ short_description: explode a path glob to matching files
+ description:
+ - Return a list of files that matches the supplied path glob pattern.
+ - Filters run on the controller, so the files are matched from the controller's file system.
+ positional: _input
+ options:
+ _input:
+ description: Path glob pattern.
+ type: string
+ required: true
+
+EXAMPLES: |
+ # found = ['/etc/hosts', '/etc/hasts']
+ found: "{{ '/etc/h?sts' | fileglob }}"
+
+RETURN:
+ _value:
+ description: List of files matched.
+ type: list
+ elements: string