summaryrefslogtreecommitdiffstats
path: root/lib/ansible/plugins/test/is_dir.yml
diff options
context:
space:
mode:
Diffstat (limited to 'lib/ansible/plugins/test/is_dir.yml')
-rw-r--r--lib/ansible/plugins/test/is_dir.yml21
1 files changed, 21 insertions, 0 deletions
diff --git a/lib/ansible/plugins/test/is_dir.yml b/lib/ansible/plugins/test/is_dir.yml
new file mode 100644
index 0000000..5d7fa78
--- /dev/null
+++ b/lib/ansible/plugins/test/is_dir.yml
@@ -0,0 +1,21 @@
+DOCUMENTATION:
+ name: directory
+ author: Ansible Core
+ version_added: "2.5"
+ short_description: does the path resolve to an existing directory
+ description:
+ - Check if the provided path maps to an existing directory on the controller's filesystem (localhost).
+ options:
+ _input:
+ description: A path.
+ type: path
+
+EXAMPLES: |
+ vars:
+ my_etc_hosts_not_a_dir: "{{ '/etc/hosts' is directory}}"
+ list_of_files: "{{ list_of_paths | reject('directory') }}"
+
+RETURN:
+ _value:
+ description: Returns C(True) if the path corresponds to an existing directory on the filesystem on the controller, c(False) if otherwise.
+ type: boolean