# Gomail

## Introduction

Package gomail provides a simple interface to send emails.

It requires Go 1.2 or newer.


## Features

 * Dead-simple API
 * Highly flexible
 * Backward compatibility promise
 * Supports HTML and text templates
 * Attachments
 * Embedded images
 * Automatic encoding of special characters
 * Well-documented
 * High test coverage


## Documentation

https://godoc.org/gopkg.in/gomail.v1


## Download

    go get gopkg.in/gomail.v1


## Example

    package main

    import (
    	"gopkg.in/gomail.v1"
    )

    func main() {
    	msg := gomail.NewMessage()
    	msg.SetHeader("From", "alex@example.com")
    	msg.SetHeader("To", "bob@example.com", "cora@example.com")
    	msg.SetAddressHeader("Cc", "dan@example.com", "Dan")
    	msg.SetHeader("Subject", "Hello!")
    	msg.SetBody("text/html", "Hello <b>Bob</b> and <i>Cora</i>!")

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

    	// Send the email to Bob, Cora and Dan
    	mailer := gomail.NewMailer("smtp.example.com", "user", "123456", 25)
    	if err := mailer.Send(msg); err != nil {
    		panic(err)
    	}
    }


## Contact

You are more than welcome to open issues and send pull requests if you find a
bug or need a new feature.

You can also ask questions on the [Gomail
thread](https://groups.google.com/d/topic/golang-nuts/ywPpNlmSt6U/discussion)
in the Go mailing-list or via Twitter [@alexandrecesaro](https://twitter.com/alexandrecesaro).