Allows users to submit rfc822 formatted email addresses

helpers/mail/mail_v3.go

@@ -3,6 +3,7 @@ package mail
 import (
 	"encoding/json"
 	"log"
+	"net/mail"
 )
 
 type SGMailV3 struct {
@@ -569,3 +570,13 @@ func NewSandboxModeSetting(enable bool, forwardSpam bool, spamCheck *SpamCheckSe
 		SpamCheck:   spamCheck,
 	}
 }
+
+// ParseEmail parses a string that contains an rfc822 formatted email address
+// and returns an instance of *Email.
+func ParseEmail(emailInfo string) (*Email, error) {
+	e, err := mail.ParseAddress(emailInfo)
+	if err != nil {
+		return nil, err
+	}
+	return NewEmail(e.Name, e.Address), nil
+}

helpers/mail/mail_v3_test.go

@@ -963,3 +963,25 @@ func TestV3NewSandboxModeSetting(t *testing.T) {
 		t.Error("SpamCheck should not be nil")
 	}
 }
+
+func TestParseEmail(t *testing.T) {
+	e, err := ParseEmail("example example <[email protected]>")
+	if err != nil {
+		t.Error("Email should have been parsed successfully")
+	}
+	expectedName := "example example"
+	if e.Name != expectedName {
+		t.Errorf("Expect email with name %s but got %s", expectedName, e.Name)
+	}
+	expectedAddress := "[email protected]"
+	if e.Address != expectedAddress {
+		t.Errorf("Expect email with address %s but got %s", expectedAddress, e.Address)
+	}
+}
+
+func TestParseInvalidEmail(t *testing.T) {
+	_, err := ParseEmail("example example <example/example.com>")
+	if err == nil {
+		t.Error("Expected an error to be thrown from ParseEmail")
+	}
+}