Skip to content

Repository files navigation

Parsemail - simple email parsing Go library

Build StatusCoverage StatusGo Report Card

This library allows for parsing an email message into a more convenient form than the net/mail provides. Where the net/mail just gives you a map of header fields and a io.Reader of its body, Parsemail allows access to all the standard header fields set in RFC5322, html/text body as well as attachements/embedded content as binary streams with metadata.

Simple usage

You just parse a io.Reader that holds the email data. The returned Email struct contains all the standard email information/headers as public fields.

varreader io.Reader// this reads an email messageemail, err:=parsemail.Parse(reader) // returns Email struct and erroriferr!=nil {
// handle error
}
fmt.Println(email.Subject)
fmt.Println(email.From)
fmt.Println(email.To)
fmt.Println(email.HTMLBody)

Retrieving attachments

Attachments are a easily accessible as Attachment type, containing their mime type, filename and data stream.

varreader io.Readeremail, err:=parsemail.Parse(reader)
iferr!=nil {
// handle error
}
for_, a:=range(email.Attachments) {
fmt.Println(a.Filename)
fmt.Println(a.ContentType)
//and read a.Data
}

Retrieving embedded files

You can access embedded files in the same way you can access attachments. They contain the mime type, data stream and content id that is used to reference them through the email.

varreader io.Readeremail, err:=parsemail.Parse(reader)
iferr!=nil {
// handle error
}
for_, a:=range(email.EmbeddedFiles) {
fmt.Println(a.CID)
fmt.Println(a.ContentType)
//and read a.Data
}

About

Simple email parsing for Golang

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages