summaryrefslogtreecommitdiffstats
path: root/lib/ansible/plugins/test/regex.yml
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-28 16:04:21 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-28 16:04:21 +0000
commit8a754e0858d922e955e71b253c139e071ecec432 (patch)
tree527d16e74bfd1840c85efd675fdecad056c54107 /lib/ansible/plugins/test/regex.yml
parentInitial commit. (diff)
downloadansible-core-upstream.tar.xz
ansible-core-upstream.zip
Adding upstream version 2.14.3.upstream/2.14.3upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'lib/ansible/plugins/test/regex.yml')
-rw-r--r--lib/ansible/plugins/test/regex.yml37
1 files changed, 37 insertions, 0 deletions
diff --git a/lib/ansible/plugins/test/regex.yml b/lib/ansible/plugins/test/regex.yml
new file mode 100644
index 0000000..90ca786
--- /dev/null
+++ b/lib/ansible/plugins/test/regex.yml
@@ -0,0 +1,37 @@
+DOCUMENTATION:
+ name: regex
+ author: Ansible Core
+ short_description: Does string match regular expression from the start
+ description:
+ - Compare string against regular expression using Python's match or search functions.
+ options:
+ _input:
+ description: String to match.
+ type: string
+ required: True
+ pattern:
+ description: Regex to match against.
+ type: string
+ required: True
+ ignorecase:
+ description: Use case insenstive matching.
+ type: boolean
+ default: False
+ multiline:
+ description: Match against multiple lines in string.
+ type: boolean
+ default: False
+ match_type:
+ description: Decide which function to be used to do the matching.
+ type: string
+ choices: [match, search]
+ default: search
+
+EXAMPLES: |
+ url: "https://example.com/users/foo/resources/bar"
+ foundmatch: url is regex("example\.com/\w+/foo")
+
+RETURN:
+ _value:
+ description: Returns C(True) if there is a match, C(False) otherwise.
+ type: boolean