Adding upstream version 2.14.3.upstream/2.14.3upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 22 insertions, 0 deletions

diff --git a/lib/ansible/plugins/test/is_file.yml b/lib/ansible/plugins/test/is_file.yml
new file mode 100644
index 0000000..8b79c07
--- /dev/null
+++ b/lib/ansible/plugins/test/is_file.yml
@@ -0,0 +1,22 @@
+DOCUMENTATION:
+  name: file
+  author: Ansible Core
+  version_added: "2.5"
+  short_description: does the path resolve to an existing file
+  description:
+    - Check if the provided path maps to an existing file on the controller's filesystem (localhost)
+  aliases: [is_file]
+  options:
+    _input:
+      description: A path.
+      type: path
+
+EXAMPLES: |
+  vars:
+    my_etc_hosts_is_a_file: "{{ '/etc/hosts' is file }}"
+    list_of_files: "{{ list_of_paths | select('file') }}"
+
+RETURN:
+  _value:
+    description: Returns C(True) if the path corresponds to an existing file on the filesystem on the controller, C(False) if otherwise.
+    type: boolean