From 120ea9562ef50a94572b606b56d44e1aacd745a3 Mon Sep 17 00:00:00 2001
From: Oliver Booth <me@olivr.me>
Date: Sat, 16 Nov 2019 02:12:15 +0000
Subject: [PATCH] =?UTF-8?q?=E2=9C=A8=20Add=20ListExtensions.Shuffle<T>()?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Shuffle<T>() returns the source enumerable ordered randomly
---
 X10D/ListExtensions.cs | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/X10D/ListExtensions.cs b/X10D/ListExtensions.cs
index 586e4af..c67df16 100644
--- a/X10D/ListExtensions.cs
+++ b/X10D/ListExtensions.cs
@@ -50,5 +50,24 @@
         /// <returns>Returns a random element of type <see cref="T"/> from <paramref name="source"/>.</returns>
         public static T OneOf<T>(this IList<T> source, Random random) =>
             random.OneOf(source);
+
+        /// <summary>
+        /// Shuffles an enumerable.
+        /// </summary>
+        /// <typeparam name="T">The collection type.</typeparam>
+        /// <param name="source">The collection to shuffle.</param>
+        /// <returns>Returns <paramref name="source"/> shuffled.</returns>
+        public static IEnumerable<T> Shuffle<T>(this IEnumerable<T> source) =>
+            source.Shuffle(new Random());
+
+        /// <summary>
+        /// Shuffles an enumerable.
+        /// </summary>
+        /// <typeparam name="T">The collection type.</typeparam>
+        /// <param name="source">The collection to shuffle.</param>
+        /// <param name="random">The <see cref="Random"/> instance.</param>
+        /// <returns>Returns <paramref name="source"/> shuffled.</returns>
+        public static IEnumerable<T> Shuffle<T>(this IEnumerable<T> source, Random random) =>
+            source.OrderBy(x => random.Next());
     }
 }