1 files changed, 21 insertions, 0 deletions
diff --git a/lib/ansible/plugins/test/link_exists.yml b/lib/ansible/plugins/test/link_exists.yml
new file mode 100644
index 0000000..f75a699
--- /dev/null
+++ b/lib/ansible/plugins/test/link_exists.yml
@@ -0,0 +1,21 @@
+DOCUMENTATION:
+  name: link_exists
+  author: Ansible Core
+  version_added: "2.5"
+  short_description: does the path exist, no follow
+  description:
+    - Check if the provided path maps to an existing symlink on the controller's filesystem (localhost).
+    - Does not follow symlinks, so it only verifies that the link itself exists.
+  options:
+    _input:
+      description: A path.
+      type: path
+
+EXAMPLES: |
+    ismyhostsalink: "{{ '/etc/hosts' is link_exists}}"
+    list_of_symlinks: "{{ list_of_paths | select('link_exists') }}"
+
+RETURN:
+  _value:
+    description: Returns C(True) if the path corresponds to an existing filesystem object on the controller, C(False) if otherwise.
+    type: boolean