mail

README

Deprecated

This package is deprecated, use these new repositories instead:

• Gomail: https://github.com/go-gomail/gomail
• quotedprintable: https://github.com/alexcesaro/quotedprintable
• mailer has been merged into Gomail

The new version of Gomail has new features, better performances and a simpler API!

Here is the list of breaking changes and how to update your code:

Import

Before:

import "github.com/alexcesaro/mail/gomail"

After:

import "gopkg.in/gomail.v1"

Add*Header functions

Functions AddHeader, AddAddressHeader and AddDateHeader were removed.

Before:

msg.SetHeader("To", "alex@example.com")
msg.AddHeader("To", "bob@example.com")

After:

msg.SetHeader("From", "alex@example.com", "bob@example.com")

To replace AddAddressHeader and AddDateHeader you can use the new functions FormatAddress and FormatDate with SetHeader or SetHeaders.

Attach a file

Before:

if err := msg.Attach("/home/Alex/lolcat.jpg"); err != nil {
    panic(err)
}

After:

f, err := gomail.OpenFile("/home/Alex/lolcat.jpg")
if err != nil {
    panic(err)
}
msg.Attach(f)

NewCustomMessage

Before:

msg := NewMessage("ISO-8859-1", Base64)

After:

msg := NewMessage(SetCharset("ISO-8859-1"), SetEncoding(Base64))

Export

Before:

m, err := msg.Export()
if err != nil {
    panic(err)
}

After:

m := msg.Export()

Constants

Constants QuotedPrintable and Base64 had type string and now have type Encoding. If you just used these constants in NewCustomMessage there is nothing to do.

---

This repository contains mail packages for Go:

• gomail is the main package of this repository, it provides a simple interface to easily write and send emails.
• mailer provides functions to easily send emails. It should be used with or inside a package that helps writing emails like it is done in gomail.
• quotedprintable is a package that implements quoted-printable and message header encoding. Someday, it might enter the Go standard library.

You are more than welcome to ask questions on the Go mailing-list and open issues here if you find bugs.

gomail

Documentation

Package gomail provides a simple interface to easily write and send emails.

Example:

package main

import (
    "log"

    "github.com/alexcesaro/mail/gomail"
)

func main() {
    msg := gomail.NewMessage()
    msg.SetAddressHeader("From", "alex@example.com", "Alex")
    msg.SetHeader("To", "bob@example.com")
    msg.AddHeader("To", "cora@example.com")
    msg.SetHeader("Subject", "Hello!")
    msg.SetBody("text/plain", "Hello Bob and Cora!")
    msg.AddAlternative("text/html", "Hello <b>Bob</b> and <i>Cora</i>!")
    if err := msg.Attach("/home/Alex/lolcat.jpg"); err != nil {
        log.Println(err)
        return
    }

    m := gomail.NewMailer("smtp.example.com", "user", "123456", 25)
    if err := m.Send(msg); err != nil { // This will send the email to Bob and Cora
        log.Println(err)
    }
}

mailer

Documentation

Package mailer provides functions to easily send emails.

This package can be used as a standalone but if you want to send emails with non-ASCII characters or with attachment you should use it with or inside a package that helps writing emails like it is done in gomail.

package main

import (
    "log"
    "net/mail"
    "strings"

    "github.com/alexcesaro/mail/mailer"
)

func main() {
    msg := &mail.Message{
        mail.Header{
            "From":         {"alex@example.com"},
            "To":           {"bob@example.com", "cora@example.com"},
            "Subject":      {"Hello!"},
            "Content-Type": {"text/plain"},
        },
        strings.NewReader("Hello, how are you ?"),
    }

    m := mailer.NewMailer("smtp.example.com", "user", "123456", 25)
    if err := m.Send(msg); err != nil { // This will send the email to Bob and Cora
        log.Println(err)
    }
}

quotedprintable

Documentation

Package quotedprintable implements quoted-printable and message header encoding as specified by RFC 2045 and RFC 2047.

Someday, it might enter the Go standard library. See this post on the golang-dev mailing-list or this code review or issue 4943 of the Go bug tracker.