From b0e5073b39d4ec98f579a5b83bd9901aa4315c53 Mon Sep 17 00:00:00 2001
From: Oliver Booth <me@olivr.me>
Date: Tue, 17 Dec 2019 11:50:27 +0000
Subject: [PATCH] =?UTF-8?q?=E2=9C=A8=20Add=20DictionaryExtensions?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 X10D/DictionaryExtensions.cs | 108 +++++++++++++++++++++++++++++++++++
 X10D/README.md               |   1 +
 2 files changed, 109 insertions(+)
 create mode 100644 X10D/DictionaryExtensions.cs

diff --git a/X10D/DictionaryExtensions.cs b/X10D/DictionaryExtensions.cs
new file mode 100644
index 0000000..d92977f
--- /dev/null
+++ b/X10D/DictionaryExtensions.cs
@@ -0,0 +1,108 @@
+namespace X10D
+{
+    #region Using Directives
+
+    using System;
+    using System.Collections.Generic;
+    using System.Linq;
+    using System.Text.RegularExpressions;
+    using System.Web;
+
+    #endregion
+
+    /// <summary>
+    /// A set of extension methods for <see cref="Dictionary{TKey,TValue}"/>.
+    /// </summary>
+    public static class DictionaryExtensions
+    {
+        /// <summary>
+        /// Converts a <see cref="IReadOnlyDictionary{T1,T2}"/> to an object-relational-safe connection string.
+        /// </summary>
+        /// <typeparam name="T1">The key type.</typeparam>
+        /// <typeparam name="T2">The value type.</typeparam>
+        /// <param name="dictionary">The dictionary.</param>
+        /// <returns>Returns a <see cref="String"/> representing the dictionary as a key=value; set.</returns>
+        public static string ToConnectionString<T1, T2>(this IReadOnlyDictionary<T1, T2> dictionary)
+        {
+            static string SanitizeValue<T>(T value)
+            {
+                return
+                    value is string str &&
+                    Regex.IsMatch(str, "\\s")
+                        ? $"\"{str}\""
+                        : value.ToString();
+            }
+
+            IEnumerable<string> strings =
+                dictionary.Select(o => $"{o.Key}={SanitizeValue(o.Value)}");
+            return String.Join(";", strings);
+        }
+
+        /// <summary>
+        /// Converts a <see cref="IDictionary{T1,T2}"/> to an object-relational-safe connection string.
+        /// </summary>
+        /// <typeparam name="T1">The key type.</typeparam>
+        /// <typeparam name="T2">The value type.</typeparam>
+        /// <param name="dictionary">The dictionary.</param>
+        /// <returns>Returns a <see cref="String"/> representing the dictionary as a key=value; set.</returns>
+        public static string ToConnectionString<T1, T2>(this IDictionary<T1, T2> dictionary)
+        {
+            return ((IReadOnlyDictionary<T1, T2>) dictionary).ToConnectionString();
+        }
+
+        /// <summary>
+        /// Converts a <see cref="Dictionary{T1,T2}"/> to an object-relational-safe connection string.
+        /// </summary>
+        /// <typeparam name="T1">The key type.</typeparam>
+        /// <typeparam name="T2">The value type.</typeparam>
+        /// <param name="dictionary">The dictionary.</param>
+        /// <returns>Returns a <see cref="String"/> representing the dictionary as a key=value; set.</returns>
+        public static string ToConnectionString<T1, T2>(this Dictionary<T1, T2> dictionary)
+        {
+            return ((IReadOnlyDictionary<T1, T2>) dictionary).ToConnectionString();
+        }
+
+        /// <summary>
+        /// Converts an <see cref="IReadOnlyDictionary{T1,T2}"/> to a HTTP GET parameter string.
+        /// </summary>
+        /// <typeparam name="T1">The key type.</typeparam>
+        /// <typeparam name="T2">The value type.</typeparam>
+        /// <param name="dictionary">The dictionary.</param>
+        /// <returns>Returns a <see cref="String"/> representing the dictionary as a key=value& set.</returns>
+        public static string ToGetParameters<T1, T2>(this IReadOnlyDictionary<T1, T2> dictionary)
+        {
+            static string Sanitize(KeyValuePair<T1, T2> kvp)
+            {
+                string key   = HttpUtility.UrlEncode(kvp.Key.ToString());
+                string value = HttpUtility.UrlEncode(kvp.Value.ToString());
+                return $"{key}={value}";
+            }
+
+            return String.Join("&", dictionary.Select(Sanitize));
+        }
+
+        /// <summary>
+        /// Converts an <see cref="IDictionary{T1,T2}"/> to a HTTP GET parameter string.
+        /// </summary>
+        /// <typeparam name="T1">The key type.</typeparam>
+        /// <typeparam name="T2">The value type.</typeparam>
+        /// <param name="dictionary">The dictionary.</param>
+        /// <returns>Returns a <see cref="String"/> representing the dictionary as a key=value& set.</returns>
+        public static string ToGetParameters<T1, T2>(this IDictionary<T1, T2> dictionary)
+        {
+            return ((IReadOnlyDictionary<T1, T2>) dictionary).ToGetParameters();
+        }
+
+        /// <summary>
+        /// Converts a <see cref="Dictionary{T1,T2}"/> to a HTTP GET parameter string.
+        /// </summary>
+        /// <typeparam name="T1">The key type.</typeparam>
+        /// <typeparam name="T2">The value type.</typeparam>
+        /// <param name="dictionary">The dictionary.</param>
+        /// <returns>Returns a <see cref="String"/> representing the dictionary as a key=value& set.</returns>
+        public static string ToGetParameters<T1, T2>(this Dictionary<T1, T2> dictionary)
+        {
+            return ((IReadOnlyDictionary<T1, T2>) dictionary).ToGetParameters();
+        }
+    }
+}
diff --git a/X10D/README.md b/X10D/README.md
index f185661..a160289 100644
--- a/X10D/README.md
+++ b/X10D/README.md
@@ -24,3 +24,4 @@ Below is a list of the number of extension methods written for a given type. Ove
 | `IList<T>` | `X10D` | 2 |
 | `Random` | `X10D` | 2 |
 | `string` / `SecureString` | `X10D` | 8 |
+| `Dictionary<T1, T2>` | 2 |
\ No newline at end of file