golazy.dev
–
golazy.dev
/
lazymailer
Index
|
Files
package lazymailer
import "golazy.dev/lazymailer"Functions
func MustParseAddress
func MustParseAddress(value string) mail.Addressfunc ParseAddress
func ParseAddress(value string) (mail.Address, error)func Recipients
func Recipients(addresses []mail.Address) []stringfunc WithContext
func WithContext(ctx context.Context, mailer *Mailer) context.ContextTypes
type Address
type Address = mail.Addresstype Base
type Base struct {
// contains filtered or unexported fields
}func NewBase
func NewBase(ctx context.Context, controller string, defaults Defaults) (Base, error)func (b *Base) Build
func (b *Base) Build(options Options) (Message, error)func (b *Base) Mail
func (b *Base) Mail(options Options) errorfunc (b *Base) Set
func (b *Base) Set(name string, value any)type Defaults
type Defaults struct {
From mail.Address
Delivery string
Layout string
Headers textproto.MIMEHeader
}type Delivery
type Delivery interface {
Deliver(context.Context, Message) error
}type DeliveryFunc
type DeliveryFunc func(context.Context, Message) errorfunc (f DeliveryFunc) Deliver
func (f DeliveryFunc) Deliver(ctx context.Context, message Message) errortype Mailer
type Mailer struct {
// contains filtered or unexported fields
}func FromContext
func FromContext(ctx context.Context) (*Mailer, bool)func New
func New(ctx context.Context, deliveries *Registry) (*Mailer, error)type MemoryDelivery
type MemoryDelivery struct {
// contains filtered or unexported fields
}func (d *MemoryDelivery) Deliver
func (d *MemoryDelivery) Deliver(_ context.Context, message Message) errorfunc (d *MemoryDelivery) Messages
func (d *MemoryDelivery) Messages() []Messagetype Message
type Message struct {
From mail.Address
To []mail.Address
Subject string
Headers textproto.MIMEHeader
Text string
HTML string
}func (m Message) Bytes
func (m Message) Bytes() ([]byte, error)type Options
type Options struct {
Action string
To []mail.Address
From mail.Address
Subject string
Delivery string
Layout string
Headers textproto.MIMEHeader
}type Registry
type Registry struct {
// contains filtered or unexported fields
}func NewRegistry
func NewRegistry(defaultName string, deliveries map[string]Delivery) *Registryfunc (r *Registry) Deliver
func (r *Registry) Deliver(ctx context.Context, name string, message Message) errortype SMTPDelivery
type SMTPDelivery struct {
Addr string
Auth smtp.Auth
}func (d SMTPDelivery) Deliver
func (d SMTPDelivery) Deliver(_ context.Context, message Message) error
Package lazymailer renders Rails-style mailer views into standard-library MIME messages and sends them through pluggable delivery implementations.
In a GoLazy application, create a Mailer from the application context after lazyapp has installed the shared renderer, store it in context with WithContext, and embed Base in app mailer types. Mailer views use the same lazyview engine, helpers, layouts, variants, and embedded filesystem as controller views.
The package is also usable without lazyapp when a lazycontroller.Renderer is available in context. Delivery is intentionally small: SMTPDelivery sends via net/smtp, MemoryDelivery captures messages for tests, and DeliveryFunc adapts custom transports.