goemail

goemail

A wrapper over net/smtp to make sending email easier in go.

Features

• HTML email
• HTML template email
• Attach file ([]byte, os.File or by file path)

Usage

1. Get Client:

Use your smtp server credentials to get client object.

client := goemail.NewClient(&goemail.Config{
    Host:     "smtp.gmail.com",
    Port:     587,
    Email:    "[email protected]",
    Password: "password",
})

2. Get Mailer:

Get a new mailer object from the client for each new email to send.

mailer := client.NewMailer("Test Email", "This is an email for testing.")
})

3. Build Email and Send:

Add recipients of your email. Attach a file if you need to. And send the email.

mailer.AddRecipients([]mail.Address{
    {
        Name:  "Random Guy",
        Address: "[email protected]",
    },
})
mailer.AddBlindCopyRecipients([]mail.Address{
    {
        Address: "[email protected]",
    },
})
mailer.SetSender(mail.Address{
    Name:  "John Doe",
})

mailer.SetReplyToEmail("[email protected]")

_ = mailer.AttachFile("../Downloads/my_file.pdf")

_ = mailer.Send()

Html Template Example

package main

import (
    "github.com/datumbrain/goemail"
    "log"
    "net/mail"
)

func main() {
    client := goemail.NewClient(&goemail.Config{
        Host:     "smtp.gmail.com",
        Port:     587,
        Email:    "[email protected]",
        Password: "password",
    })
    
    templateValues := struct {
        Name  string
        Url   string
        Title string
    }{
        Name:  "John Doe",
        Url:   "http://johndoe.com",
        Title: "Welcome to my Homepage",
    }
        
    mailer, err := client.NewHtmlMailerFromTemplate("JohnDoe.com", "welcome.html", templateValues)
    if err != nil {
        log.Println(err)
        return
    }

    mailer.AddRecipients([]mail.Address{{Address: "[email protected]"}})

    err = mailer.Send()
    if err != nil {
        log.Println(err)
        return
    }
}

Known Issues

• AddInlineFile() adds gibberish in the email.