Struct Mail 

#[non_exhaustive]
pub struct Mail {
    pub to: Vec<String>,
    pub subject: String,
    pub text: String,
    pub html: Option<String>,
    pub cc: Vec<String>,
    pub bcc: Vec<String>,
    pub reply_to: Option<String>,
    pub from: Option<String>,
    pub attachments: Vec<Attachment>,
}

One email message. html is optional; text is always sent.

let pdf: Vec<u8> = b"%PDF-1.7 ...".to_vec();
let mail = Mail::new("ben@example.com", "Invoice INV-001", "Your invoice is attached.")
    .also_to("finance@example.com")
    .cc("sales@example.com")
    .bcc("archive@example.com")
    .reply_to("Coffee Shop <hello@shop.example>")
    .from("Coffee Shop Billing <billing@shop.example>") // instead of MAIL_FROM_*
    .attach("INV-001.pdf", "application/pdf", pdf);

Addresses are a@b.c or Name <a@b.c>; an invalid one fails the send (and a queued mail isn’t retried for it).

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

to: Vec<String>

Recipients.

subject: String

The subject line.

text: String

The plain-text body.

html: Option<String>

An HTML body, sent next to text when set.

cc: Vec<String>

Carbon-copy recipients.

bcc: Vec<String>

Blind-carbon-copy recipients.

reply_to: Option<String>

The address replies go to.

from: Option<String>

Sender instead of MAIL_FROM_ADDRESS / MAIL_FROM_NAME.

attachments: Vec<Attachment>

Files sent with the mail.

Implementations

impl Mail

pub fn new( to: impl Into<String>, subject: impl Into<String>, text: impl Into<String>, ) -> Self

A mail to to with this subject and plain-text body.

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

Adds an HTML body; text is still sent as the plain alternative.

pub fn also_to(self, address: impl Into<String>) -> Self

Another recipient.

pub fn cc(self, address: impl Into<String>) -> Self

Adds a carbon-copy recipient.

pub fn bcc(self, address: impl Into<String>) -> Self

Adds a blind-carbon-copy recipient.

pub fn reply_to(self, address: impl Into<String>) -> Self

Where replies go.

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

Sends as address instead of MAIL_FROM_ADDRESS / MAIL_FROM_NAME.

pub fn attach( self, filename: impl Into<String>, content_type: impl Into<String>, data: impl Into<Vec<u8>>, ) -> Self

Attaches data as a file named filename of type content_type.

pub fn is_for(&self, address: &str) -> bool

Whether address is among to, cc or bcc.

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.

impl<'de> Deserialize<'de> for Mail

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Mail

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Mail

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Mail