Struct MessageBuilder

pub struct MessageBuilder<'x> {
    pub headers: Vec<(Cow<'x, str>, HeaderType<'x>)>,
    pub html_body: Option<MimePart<'x>>,
    pub text_body: Option<MimePart<'x>>,
    pub attachments: Option<Vec<MimePart<'x>>>,
    pub body: Option<MimePart<'x>>,
}

Builds an RFC5322 compliant MIME email message.

Fields

headers: Vec<(Cow<'x, str>, HeaderType<'x>)>

html_body: Option<MimePart<'x>>

text_body: Option<MimePart<'x>>

attachments: Option<Vec<MimePart<'x>>>

body: Option<MimePart<'x>>

Implementations

impl<'x> MessageBuilder<'x>

pub fn new() -> MessageBuilder<'x>

Create a new MessageBuilder.

pub fn message_id(self, value: impl Into<MessageId<'x>>) -> MessageBuilder<'x>

Set the Message-ID header. If no Message-ID header is set, one will be generated automatically.

pub fn in_reply_to(self, value: impl Into<MessageId<'x>>) -> MessageBuilder<'x>

Set the In-Reply-To header.

pub fn references(self, value: impl Into<MessageId<'x>>) -> MessageBuilder<'x>

Set the References header.

pub fn sender(self, value: impl Into<Address<'x>>) -> MessageBuilder<'x>

Set the Sender header.

pub fn from(self, value: impl Into<Address<'x>>) -> MessageBuilder<'x>

Set the From header.

pub fn to(self, value: impl Into<Address<'x>>) -> MessageBuilder<'x>

Set the To header.

pub fn cc(self, value: impl Into<Address<'x>>) -> MessageBuilder<'x>

Set the Cc header.

pub fn bcc(self, value: impl Into<Address<'x>>) -> MessageBuilder<'x>

Set the Bcc header.

pub fn reply_to(self, value: impl Into<Address<'x>>) -> MessageBuilder<'x>

Set the Reply-To header.

pub fn subject(self, value: impl Into<Text<'x>>) -> MessageBuilder<'x>

Set the Subject header.

pub fn date(self, value: impl Into<Date>) -> MessageBuilder<'x>

Set the Date header. If no Date header is set, one will be generated automatically.

pub fn header( self, header: impl Into<Cow<'x, str>>, value: impl Into<HeaderType<'x>>, ) -> MessageBuilder<'x>

Add a custom header.

pub fn headers<T, U, V>(self, header: T, values: U) -> MessageBuilder<'x>

where T: Into<Cow<'x, str>>, U: IntoIterator<Item = V>, V: Into<HeaderType<'x>>,

Set custom headers.

pub fn text_body(self, value: impl Into<Cow<'x, str>>) -> MessageBuilder<'x>

Set the plain text body of the message. Note that only one plain text body per message can be set using this function. To build more complex MIME body structures, use the body method instead.

pub fn html_body(self, value: impl Into<Cow<'x, str>>) -> MessageBuilder<'x>

Set the HTML body of the message. Note that only one HTML body per message can be set using this function. To build more complex MIME body structures, use the body method instead.

pub fn attachment( self, content_type: impl Into<ContentType<'x>>, filename: impl Into<Cow<'x, str>>, value: impl Into<BodyPart<'x>>, ) -> MessageBuilder<'x>

Add a binary attachment to the message.

pub fn inline( self, content_type: impl Into<ContentType<'x>>, cid: impl Into<Cow<'x, str>>, value: impl Into<BodyPart<'x>>, ) -> MessageBuilder<'x>

Add an inline binary to the message.

pub fn body(self, value: MimePart<'x>) -> MessageBuilder<'x>

Set a custom MIME body structure.

pub fn write_to(self, output: impl Write) -> Result<(), Error>

Build the message.

pub fn write_body(self, output: impl Write) -> Result<(), Error>

Write the message body without headers.

pub fn write_to_vec(self) -> Result<Vec<u8>, Error>

Build message to a Vec.

pub fn write_to_string(self) -> Result<String, Error>

Build message to a String.

Trait Implementations

impl<'x> Clone for MessageBuilder<'x>

fn clone(&self) -> MessageBuilder<'x>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'x> Debug for MessageBuilder<'x>

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

Formats the value using the given formatter.

impl<'x> Default for MessageBuilder<'x>

fn default() -> MessageBuilder<'x>

Returns the “default value” for a type.

impl<'x, 'y> IntoMessage<'x> for MessageBuilder<'y>

fn into_message(self) -> Result<Message<'x>, Error>