Skip to content

alexcesaro/mail

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 

Deprecated

This package is deprecated, use these new repositories instead:

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.

About

Deprecated use Gomail instead.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages