Struct Mail 

pub struct Mail { /* private fields */ }

Plugin installer — call Self::client before app.install to share the handle (e.g. tasks).

Implementations

impl Mail

pub fn smtp(host: impl Into<String>) -> SmtpBuilder

SMTP relay (STARTTLS via lettre relay). Use SmtpBuilder::build or install via From.

pub fn fake() -> Self

Record messages in memory (tests / local demo).

pub fn file(dir: impl Into<PathBuf>) -> Self

Write .eml files under dir.

pub fn from_env() -> Self

Like Self::try_from_env, panics on invalid SMTP URL / unknown mailer.

Missing mailer + missing URL still yields fake (dev DX). Prefer Self::try_from_env in main when you want ?.

pub fn try_from_env() -> Result<Self>

Build from process env — see Self::try_from_vars.

pub fn try_from_vars<F>(get: F) -> Result<Self>

where F: FnMut(&str) -> Option<String>,

Build from a lookup fn (tests / custom env sources).

• SOVA_MAIL / SOVA_MAIL_MAILER: fake | smtp | file (optional)
• No mailer + no URL → Self::fake (dev)
• smtp / URL set + parse failure → Err (never silently fakes)
• file → SOVA_MAIL_PATH (default ./mail)

pub fn from(self, addr: impl Into<String>) -> Self

pub fn client(&self) -> MailClient

Shared client (clone before install for background jobs).

With feature templates, the templates slot is shared with the installed client — wiring at install / startup reaches earlier clones too.

pub fn recorder(&self) -> Option<&FakeMail>

Recorder when using Self::fake.

Trait Implementations

impl From<SmtpBuilder> for Mail

fn from(b: SmtpBuilder) -> Self

Converts to this type from the input type.

impl Plugin for Mail

fn id(&self) -> &'static str

Stable plugin identifier used for dependency checks and crate::App::has_plugin.

fn meta(&self) -> PluginMeta

Display name, description, and declared PluginMeta::sdk version.

fn install(self, app: &mut App)

Register middleware, state, routes, and hooks on app.

fn requires(&self) -> &'static [&'static str]

Required plugin ids that must be installed beforehand.