litestar-email

litestar-email provides a pluggable email-sending abstraction for Litestar. One config + plugin, swap backends without touching call sites.

Backends:

• SMTPConfig — generic SMTP via aiosmtplib
• ResendConfig — Resend HTTP API
• SendGridConfig — SendGrid HTTP API
• MailgunConfig — Mailgun HTTP API
• SESConfig — Amazon SES API v2
• backend="memory" / InMemoryBackend — for tests; captures messages in InMemoryBackend.outbox
• backend="console" — for local development; prints messages

Code Style Rules

• PEP 604 unions: T | None, never Optional[T]
• Consumer Litestar app modules MAY use from __future__ import annotations
• Async all I/O — EmailService.send_message is async