71 lines
1.5 KiB
Markdown
71 lines
1.5 KiB
Markdown
|
# 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).
|