Struct Mail 

pub struct Mail { /* private fields */ }

The mail handle. Cheap to clone: every clone is the same mail service.

Implementations

impl Mail

pub fn new( mailer: Arc<dyn Mailer>, sender: Sender, templates: Templates, queue: Queue, available: Vec<MailDriverReg>, db: Db, ) -> Self

A mail service delivering through mailer as sender, rendering from templates, queueing on queue. available lists the drivers Mail::reconfigure may switch to.

pub fn from_config( config: &MailConfig, extra: impl IntoIterator<Item = MailDriverReg>, templates: Templates, queue: Queue, db: Db, ) -> CoreResult<Self>

The service [mail] configures, over the built-in drivers and extra.

pub fn reconfigure(&self, config: &MailConfig) -> CoreResult<()>

Replaces the driver and sender, as a saved Mail settings model asks.

pub fn set_mailer(&self, mailer: Arc<dyn Mailer>)

Swaps the driver alone (a test’s stub).

pub fn driver_name(&self) -> &'static str

pub fn driver_names(&self) -> Vec<&'static str>

The names of every driver this service can switch to, sorted.

pub fn sender(&self) -> Sender

pub fn templates(&self) -> &Templates

The templates, to read, edit, preview and reset.

pub async fn send(&self, message: Message) -> CoreResult<Pushed>

Queues message: a worker renders and delivers it. With queue.mode = inline it goes out here.

pub async fn send_now(&self, message: Message) -> CoreResult<()>

Renders and delivers message here, returning the driver’s error.

pub async fn envelope(&self, message: Message) -> CoreResult<Envelope>

Renders message into what the driver would deliver, addresses resolved; nothing is sent.

pub async fn send_test(&self, to: &str) -> CoreResult<()>

Sends the built-in test template to to here, returning the driver’s error: what the Mail settings’ Send test does.

Trait Implementations

impl Clone for Mail

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Mail

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

Formats the value using the given formatter.