emaildecoder

README

go-emaildecoder

Purpose

This library handles heavy lifting when decoding an email source.

It uses an io.Reader as input and can be used to parse :

• EML files
• Input stream from an SMTP server

Features

• Finds text/plain and text/html
• Exposes mail.Header
• Allows for attachments parsing and callback
• Support decoding charsets to UTF-8

Example

package main

import (
	"fmt"
	"github.com/LeakIX/go-emaildecoder"
	"io"
	"os"
	"path/filepath"
)

func main() {
	// Creates an attachments directory
	if err := os.MkdirAll("attachments", 0750); err != nil && err != os.ErrExist {
		panic(err)
	}
	// Creates a new decoder from stdin, with an attachment handler, can be nil if not needed
	decoder := emaildecoder.NewDecoder(os.Stdin, handleAttachment)
	// Parse the email
	email, err := decoder.Decode()
	if err != nil {
		panic(err)
	}
	// Display results
	fmt.Printf("From: %s\nSubject: %s\n", email.Headers.Get("From"), email.Headers.Get("Subject"))
	fmt.Println(string(email.PlainText))
}

// Handle attachments
func handleAttachment(attachment emaildecoder.Attachment) {
	fmt.Printf("Saving %s...\n", attachment.Filename)
	if file, err := os.OpenFile(filepath.Join("attachments", attachment.Filename), os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0640); err != nil {
		panic(err)
	} else if _, err = io.Copy(file, attachment); err != nil {
		panic(err)
	} else if err = file.Close(); err != nil {
		panic(err)
	}
}

Documentation

Index

• type Attachment
• type AttachmentCallback
• type Decoder
  • func NewDecoder(reader io.Reader, attachmentCallback AttachmentCallback) *Decoder
  • func (d *Decoder) Decode() (*EmailContent, error)
• type EmailContent

Types

type Attachment

type Attachment struct {
	io.Reader
	Filename    string
	ContentType string
}

type AttachmentCallback

type AttachmentCallback func(attachment Attachment)

type Decoder

type Decoder struct {
	// contains filtered or unexported fields
}

func NewDecoder

func NewDecoder(reader io.Reader, attachmentCallback AttachmentCallback) *Decoder

func (*Decoder) Decode

func (d *Decoder) Decode() (*EmailContent, error)

type EmailContent

type EmailContent struct {
	HTML      []byte
	PlainText []byte
	Headers   mail.Header
}