mailx/mailx.go

// Package mailx 是一个简单易用的多通道邮件发送库。
//
// 核心特性：
//   - 多通道支持：smtp / 阿里云 / AWS SES / mailgun 等，可自由扩展
//   - 链式消息构建：mailx.NewMessage().From(...).To(...).Subject(...).Build()
//   - 通道管理器：注册多个通道，发送时按名称路由或临时指定配置
//   - 发送时指定配置：SendWith 选已注册通道，SendBy 直接传入带配置的通道
//
// 快速开始：
//
//	ctx := context.Background()
//
//	// 方式一：直接使用单个通道
//	err := smtp.New(smtp.Config{Host: "...", Port: 465, User: "...", Password: "..."}).
//		Send(ctx, mailx.NewMessage().
//			From("a@example.com").
//			To("b@example.com").
//			Subject("hello").
//			Body("world").
//			Build())
//
//	// 方式二：多通道管理器，发送时切换通道
//	mgr := mailx.NewManager()
//	mgr.Register(smtp.New(...))
//	mgr.Register(aliyun.New(...))
//	mgr.Send(ctx, msg)                    // 默认通道
//	mgr.SendWith(ctx, "aliyun", msg)      // 指定通道
//	mgr.SendBy(ctx, mailgun.New(...), msg) // 临时指定配置的通道
package mailx