https://github.com/nilslice/email
Minimal SMTP client in Go. Handles MX lookup, mail server connection on common ports.
https://github.com/nilslice/email
dns email go golang mx-lookup smtp smtp-client
Last synced: 6 months ago
JSON representation
Minimal SMTP client in Go. Handles MX lookup, mail server connection on common ports.
- Host: GitHub
- URL: https://github.com/nilslice/email
- Owner: nilslice
- License: mit
- Created: 2016-11-08T00:50:05.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2018-11-11T19:00:02.000Z (almost 7 years ago)
- Last Synced: 2025-04-15T01:03:22.044Z (6 months ago)
- Topics: dns, email, go, golang, mx-lookup, smtp, smtp-client
- Language: Go
- Size: 8.79 KB
- Stars: 102
- Watchers: 6
- Forks: 10
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Email
I needed a way to send email from a [Ponzu](https://ponzu-cms.org) installation
running on all kinds of systems without shelling out. `sendmail` or `postfix` et
al are not standard on all systems, and I didn't want to force users to add API
keys from a third-party just to send something like an account recovery email.
### Usage:
`$ go get github.com/nilslice/email`
```go
package main
import (
"fmt"
"github.com/nilslice/email"
)
func main() {
msg := email.Message{
To: "you@server.name", // do not add < > or name in quotes
From: "me@server.name", // do not add < > or name in quotes
Subject: "A simple email",
Body: "Plain text email body. HTML not yet supported, but send a PR!",
}
err := msg.Send()
if err != nil {
fmt.Println(err)
}
}
```
### Under the hood
`email` looks at a `Message`'s `To` field, splits the string on the @ symbol and
issues an MX lookup to find the mail exchange server(s). Then it iterates over
all the possibilities in combination with commonly used SMTP ports for non-SSL
clients: `25, 2525, & 587`
It stops once it has an active client connected to a mail server and sends the
initial information, the message, and then closes the connection.
Currently, this doesn't support any additional headers or `To` field formatting
(the recipient's email must be the only string `To` takes). Although these would
be fairly strightforward to implement, I don't need them yet.. so feel free to
contribute anything you find useful.
#### Warning
Be cautious of how often you run this locally or in testing, as it's quite
likely your IP will be blocked/blacklisted if it is not already.