Struct Composition 

pub struct Composition {
    pub from: Option<Mailbox>,
    pub to: Vec<Mailbox>,
    pub cc: Vec<Mailbox>,
    pub bcc: Vec<Mailbox>,
    pub subject: String,
    pub body: String,
    pub html_body: Option<String>,
    pub attachments: Vec<Attachment>,
    pub reply: Option<ReplyContext>,
    pub message_id_domain: Option<String>,
}

A message to build: text/plain, or multipart/alternative when it has an HTML body.

Fields

from: Option<Mailbox>

The From mailbox. None leaves the header out, and Gmail fills in the account’s primary address. Gmail only sends as a verified send-as alias, so the caller checks it first (see crate::gmail::send_as_api::resolve_from).

to: Vec<Mailbox>

To recipients.

cc: Vec<Mailbox>

Cc recipients.

bcc: Vec<Mailbox>

Bcc recipients. Kept as a header: Gmail reads it from the draft when the draft is sent, and strips it from what recipients receive.

subject: String

The Subject. May be empty.

body: String

The plain-text body, or with html_body its plain-text alternative.

html_body: Option<String>

The HTML body. Sent as multipart/alternative after body, so clients that can render HTML show this one.

attachments: Vec<Attachment>

Files attached after the body. Any attachment makes the message multipart/mixed.

reply: Option<ReplyContext>

When replying: the source of In-Reply-To and References.

message_id_domain: Option<String>

The domain for the generated Message-ID, normally the account address’s (see message_id_domain). None leaves the id to mail-builder, which ends it in @localhost.

Implementations

impl Composition

pub fn build(&self) -> Result<Vec<u8>>

Serialises the message to RFC 5322 bytes with CRLF line endings.

The Message-ID is <{random}@{message_id_domain}>. Gmail replaces it on the stored draft (#1966), but whether the id is also replaced when the draft is sent is unverified (#1953), so it is made valid either way rather than left as @localhost.

Trait Implementations

impl Clone for Composition

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 Composition

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

Formats the value using the given formatter.

impl Default for Composition

fn default() -> Self

Returns the “default value” for a type.