Merge pull request #458 from JefStat/StringToEmailAddress

Add a StringToEmailAddress helper function

Author: thinkingserious

src/SendGrid/Helpers/Mail/MailHelper.cs

@@ -6,12 +6,19 @@
 namespace SendGrid.Helpers.Mail
 {
     using System.Collections.Generic;
+    using System.Text.RegularExpressions;
 
     /// <summary>
     /// Simplified email sending for common use cases
     /// </summary>
     public class MailHelper
     {
+        private const string NameGroup = "name";
+        private const string EmailGroup = "email";
+        private static readonly Regex Rfc2822Regex = new Regex(
+            $@"(?:(?<{NameGroup}>)(?<{EmailGroup}>[^\<]*@.*[^\>])|(?<{NameGroup}>[^\<]*)\<(?<{EmailGroup}>.*@.*)\>)",
+            RegexOptions.ECMAScript);
+
         /// <summary>
         /// Send a single simple email
         /// </summary>
@@ -121,5 +128,23 @@ public static SendGridMessage CreateMultipleEmailsToMultipleRecipients(
 
             return msg;
         }
+
+        /// <summary>
+        /// Uncomplex conversion of a <![CDATA["Name <[email protected]>"]]> to EmailAddress
+        /// </summary>
+        /// <param name="rfc2822Email">"[email protected]" or <![CDATA["Name <[email protected]>"]]> string</param>
+        /// <returns>EmailsAddress Object</returns>
+        public static EmailAddress StringToEmailAddress(string rfc2822Email)
+        {
+            var match = Rfc2822Regex.Match(rfc2822Email);
+            if (!match.Success)
+            {
+                return new EmailAddress(rfc2822Email);
+            }
+
+            var email = match.Groups[EmailGroup].Value.Trim();
+            var name = match.Groups[NameGroup].Value.Trim();
+            return new EmailAddress(email, name);
+        }
     }
-}
+}

tests/SendGrid.Tests/Integration.cs

@@ -6037,4 +6037,18 @@ public override HttpResponseMessage Send(HttpRequestMessage request)
             throw new TimeoutException(exceptionMessage);
         }
     }
+
+    public class MailHelperTests
+    {
+        [Theory]
+        [InlineData("Name Of A Person+", "[email protected]", "Name Of A Person+ <   [email protected]  >   ")]
+        [InlineData("", "[email protected]", "   [email protected]  ")]
+        [InlineData(null, "notAValidEmail", "notAValidEmail")]
+        public void StringToEmail(string expectedName, string expectedEmail, string rf2822Email)
+        {
+            var address = MailHelper.StringToEmailAddress(rf2822Email);
+            Assert.Equal(expectedEmail, address.Email);
+            Assert.Equal(expectedName, address.Name);
+        }
+    }
 }