1 files changed, 32 insertions, 0 deletions
diff --git a/lib/ansible/plugins/filter/split.yml b/lib/ansible/plugins/filter/split.yml
new file mode 100644
index 0000000..3e7b59e
--- /dev/null
+++ b/lib/ansible/plugins/filter/split.yml
@@ -0,0 +1,32 @@
+DOCUMENTATION:
+  name: split
+  version_added: "historical"
+  short_description: split a string into a list
+  description:
+    - Using Python's text object method C(split) we turn strings into lists via a 'spliting character'.
+  notes:
+    - This is a passthrough to Python's C(str.split).
+  positional: _input, _split_string
+  options:
+    _input:
+      description: A string to split.
+      type: str
+      required: true
+    _split_string:
+      description: A string on which to split the original.
+      type: str
+      default: ' '
+
+EXAMPLES: |
+
+    # listjojo => [ "jojo", "is", "a" ]
+    listjojo: "{{ 'jojo is a' | split }}"
+
+    # listjojocomma => [ "jojo is", "a" ]
+    listjojocomma: "{{ 'jojo is, a' | split(',' }}"
+
+RETURN:
+  _value:
+    description: List of substrings split from the original.
+    type: list
+    elements: str