Struct MailSettings 

pub struct MailSettings {

    pub backend: Option<String>,
    pub smtp_host: Option<String>,
    pub smtp_port: Option<u16>,
    pub smtp_username: Option<String>,
    pub smtp_password: Option<String>,
    pub smtp_tls: Option<String>,
    pub smtp_timeout_secs: Option<u64>,
    pub from_address: Option<String>,
    pub server_email: Option<String>,
    pub email_subject_prefix: Option<String>,
    pub admins: Vec<String>,
    pub managers: Vec<String>,
    pub file_email_dir: Option<PathBuf>,
}

Mailer config. Slice 10.2 lights up.

Fields

backend: Option<String>

"smtp", "console" (default for dev), "memory" (tests).

smtp_host: Option<String>

SMTP host. Required when backend = "smtp".

smtp_port: Option<u16>

SMTP port. Defaults vary by TLS mode — 25 for none, 587 for starttls, 465 for implicit. Issue #48.

smtp_username: Option<String>

SMTP AUTH username. Set alongside smtp_password to enable PLAIN/LOGIN auth — both must be present, otherwise the transport connects anonymously. Issue #48.

smtp_password: Option<String>

SMTP AUTH password. Prefer reading from an env var rather than committing to TOML — the config loader’s env-overlay (see crate::config) makes RUSTANGO_MAIL__SMTP_PASSWORD Just Work. Issue #48.

smtp_tls: Option<String>

TLS mode: "none", "starttls" (default — RFC 3207 upgrade on port 587), "implicit" (SMTPS — TLS from byte one on port 465). Unknown values fall back to "starttls" with a warning. Issue #48.

smtp_timeout_secs: Option<u64>

Django-shape EMAIL_TIMEOUT — SMTP connection timeout in seconds. None defers to lettre’s default (no explicit timeout). Set this on every prod deployment — a wedged SMTP relay otherwise stalls request workers waiting on the transport for the kernel-default TCP timeout (several minutes).

from_address: Option<String>

Django-shape DEFAULT_FROM_EMAIL — the From: address on regular outgoing mail (send_pool, send_many_pool). from_address is the historical alias rustango shipped first; both names read the same field — default_from_email wins when both are set.

server_email: Option<String>

Django-shape SERVER_EMAIL — the From: address on server-generated mail (mail_admins, mail_managers, future error-mail paths). Falls back to from_address when unset (Django’s default behavior). Setting it separately lets ops surface admin mail under a distinct sender — noreply@example.com for users, alerts@example.com for ops.

email_subject_prefix: Option<String>

Django-shape EMAIL_SUBJECT_PREFIX — string prepended to subjects sent via mail_admins / mail_managers. Django default is "[Django] "; rustango omits it by default so projects opt into branded prefixes consciously. Set to "[Acme] " (note trailing space) to match Django’s shape.

admins: Vec<String>

Django-shape ADMINS — list of email addresses that email::mail_admins(...) sends to. Typically the project’s site operators (the “5xx pages me at 3am” cohort). Issue #416.

managers: Vec<String>

Django-shape MANAGERS — list of email addresses that email::mail_managers(...) sends to. Conventionally a broader-but-less-urgent ops list than admins. Issue #416.

file_email_dir: Option<PathBuf>

Django-shape EMAIL_FILE_PATH — directory the "file" mail backend writes outgoing .eml files to (instead of sending). Set alongside backend = "file"; if backend = "file" is requested but this is unset, the resolver falls back to ConsoleMailer with a tracing warning. Issue #417.

Trait Implementations

impl Clone for MailSettings

fn clone(&self) -> MailSettings

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MailSettings

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MailSettings

fn default() -> MailSettings

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MailSettings

where MailSettings: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for MailSettings

fn eq(&self, other: &MailSettings) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for MailSettings