1 files changed, 26 insertions, 0 deletions
diff --git a/lib/ansible/plugins/filter/permutations.yml b/lib/ansible/plugins/filter/permutations.yml
new file mode 100644
index 0000000..6e0202b
--- /dev/null
+++ b/lib/ansible/plugins/filter/permutations.yml
@@ -0,0 +1,26 @@
+DOCUMENTATION:
+  name: permutations
+  version_added: "historical"
+  short_description: permutations from the elements of a list
+  description:
+    - Create a list of the permutations of lists from the elements of a list.
+    - Unlike combinations, in permutations order is significant.
+  positional: _input, list_size
+  options:
+    _input:
+      description: Elements to base the permutations on.
+      type: list
+      required: true
+    list_size:
+      description: The size of the list for each permutation.
+      type: int
+      required: true
+
+EXAMPLES: |
+  # ptrs_of_two => [ [ 1, 2 ], [ 1, 3 ], [ 1, 4 ], [ 1, 5 ], [ 2, 1 ], [ 2, 3 ], [ 2, 4 ], [ 2, 5 ], [ 3, 1 ], [ 3, 2 ], [ 3, 4 ], [ 3, 5 ], [ 4, 1 ], [ 4, 2 ], [ 4, 3 ], [ 4, 5 ], [ 5, 1 ], [ 5, 2 ], [ 5, 3 ], [ 5, 4 ] ]
+  prts_of_two:  "{{ [1,2,3,4,5] | permutations(2) }}"
+
+RETURN:
+  _value:
+    description: List of permutations lists resulting from the supplied elements and list size.
+    type: list