1 files changed, 27 insertions, 0 deletions
diff --git a/lib/ansible/plugins/filter/shuffle.yml b/lib/ansible/plugins/filter/shuffle.yml
new file mode 100644
index 0000000..a7c3e7e
--- /dev/null
+++ b/lib/ansible/plugins/filter/shuffle.yml
@@ -0,0 +1,27 @@
+DOCUMENTATION:
+  name: shuffle
+  version_added: "2.6"
+  short_description: randomize a list
+  description:
+    - Take the elements of the input list and return in a random order.
+  positional: _input
+  options:
+    _input:
+      description: A number or list to randomize.
+      type: list
+      elements: any
+      required: true
+    seed:
+      description: If specified use a pseudo random selection instead (repeatable).
+      type: str
+
+EXAMPLES: |
+
+  randomized_list: "{{ ['a','b','c'] | shuffle}}"
+  per_host_repeatable: "{{ ['a','b','c'] | shuffle(seed=inventory_hostname) }}"
+
+RETURN:
+  _value:
+    description: Random number or list element.
+    type: list
+    elements: any