summaryrefslogtreecommitdiffstats
path: root/lib/ansible/plugins/test/urn.yml
diff options
context:
space:
mode:
Diffstat (limited to 'lib/ansible/plugins/test/urn.yml')
-rw-r--r--lib/ansible/plugins/test/urn.yml21
1 files changed, 21 insertions, 0 deletions
diff --git a/lib/ansible/plugins/test/urn.yml b/lib/ansible/plugins/test/urn.yml
new file mode 100644
index 0000000..81a6686
--- /dev/null
+++ b/lib/ansible/plugins/test/urn.yml
@@ -0,0 +1,21 @@
+DOCUMENTATION:
+ name: urn
+ author: Ansible Core
+ version_added: "2.14"
+ short_description: is the string a valid URN
+ description:
+ - Validates that the input string conforms to the URN standard.
+ options:
+ _input:
+ description: Possible URN.
+ type: string
+ required: True
+EXAMPLES: |
+ # ISBN in URN format
+ {{ 'urn:isbn:9780302376463' is urn }}
+ # this is URL/URI but not URN
+ {{ 'mailto://nowone@example.com' is not urn }}
+RETURN:
+ _value:
+ description: Returns C(true) if the string is a URN and C(false) if it is not.
+ type: boolean