summaryrefslogtreecommitdiffstats
path: root/lib/ansible/plugins/filter/splitext.yml
diff options
context:
space:
mode:
Diffstat (limited to 'lib/ansible/plugins/filter/splitext.yml')
-rw-r--r--lib/ansible/plugins/filter/splitext.yml30
1 files changed, 30 insertions, 0 deletions
diff --git a/lib/ansible/plugins/filter/splitext.yml b/lib/ansible/plugins/filter/splitext.yml
new file mode 100644
index 0000000..ea9cbce
--- /dev/null
+++ b/lib/ansible/plugins/filter/splitext.yml
@@ -0,0 +1,30 @@
+DOCUMENTATION:
+ name: splitext
+ author: Matt Martz (@sivel)
+ version_added: "2.0"
+ short_description: split a path into root and file extension
+ positional: _input
+ description:
+ - Returns a list of two, with the elements consisting of filename root and extension.
+ options:
+ _input:
+ description: A path.
+ type: str
+ required: true
+
+EXAMPLES: |
+
+ # gobble => [ '/etc/make', 'conf' ]
+ gobble: "{{ '/etc/make.conf' | splitext }}"
+
+ # file_n_ext => [ 'ansible', 'cfg' ]
+ file_n_ext: "{{ 'ansible.cfg' | splitext }}"
+
+ # hoax => ['/etc/hoasdf', '']
+ hoax: '{{ "/etc//hoasdf/"|splitext }}'
+
+RETURN:
+ _value:
+ description: A list consisting of root of the path and the extension.
+ type: list
+ elements: str