Sending Email

The cmailer package (from gocopper/pkg) provides a simple Mailer interface with two backends: AWS SES for production and a log mailer for development. To get started, install the package:

go get github.com/gocopper/pkg/cmailer

Setup

cmailer does not ship a wire module, so you should provide the constructor for the backend you would like to use directly in your app’s wire set:

pkg/app/wire.go

var WireModule = wire.NewSet(
	// ...
	cmailer.NewLogMailer, // dev: logs emails instead of sending them
)

In production, you may use cmailer.NewAWSMailer instead and configure your SES credentials:

config/prod.toml

[aws]
region = "us-east-1"
access_key_id = "{{ .EnvVars.AWS_ACCESS_KEY_ID }}"
secret_access_key = "{{ .EnvVars.AWS_SECRET_ACCESS_KEY }}"

Sending

To send an email, inject cmailer.Mailer wherever you need it and call its Send method:

err := s.mailer.Send(ctx, cmailer.SendParams{
	From:     "mission-control@rocketlog.dev",
	To:       []string{crew.Email},
	Subject:  "Launch confirmed",
	HTMLBody: cvars.Ptr("<p>Your rocket launches at T-minus 10.</p>"),
})

HTMLBody and PlainBody are both optional pointers, and you may set either or both. The cvars.Ptr helper (from github.com/gocopper/pkg/cvars) saves you a temporary variable.

The log mailer writes the full email to your app’s logs, so you can develop email flows without an SES account or a real inbox.

Getting Started

The Basics

Architecture

HTTP

Database

Frontend

Digging Deeper

Reference

Setup

Sending

​Setup

​Sending

Setup

Sending