litestar-email

litestar-email 0.4.0 provides one async sending interface for console, memory, SMTP, Resend, SendGrid, Mailgun, Amazon SES, and custom backends. Match the backend already selected by the project; keep message construction independent from the transport.

Code Style Rules

• Use NamedDependency[EmailService] for handler injection. The plugin registers a named Litestar dependency, not a global service singleton.
• Pass recipient collections as list[str]. to, cc, bcc, and reply_to are list fields.
• Pass attachment content as bytes. Do file I/O before constructing the message and keep that I/O async.
• Await send_message() and send_messages(). Both return the count sent.
• Keep API keys and SMTP credentials in the project's settings layer.

Quick Reference