Module lettre::message

This is supported on crate feature builder only.

Provides a strongly typed way to build emails

Creating messages

This section explains how to create emails.

Usage

Format email messages

With string body

The easiest way how we can create email message with simple string.

use lettre::message::Message;

let m = Message::builder()
    .from("NoBody <nobody@domain.tld>".parse().unwrap())
    .reply_to("Yuin <yuin@domain.tld>".parse().unwrap())
    .to("Hei <hei@domain.tld>".parse().unwrap())
    .subject("Happy new year")
    .body("Be happy!")
    .unwrap();

Will produce:

From: NoBody <nobody@domain.tld>
Reply-To: Yuin <yuin@domain.tld>
To: Hei <hei@domain.tld>
Subject: Happy new year

Be happy!

The unicode header data will be encoded using UTF8-Base64 encoding.

With MIME body

Single part

The more complex way is using MIME contents.

use lettre::message::{header, Message, SinglePart, Part};

let m = Message::builder()
    .from("NoBody <nobody@domain.tld>".parse().unwrap())
    .reply_to("Yuin <yuin@domain.tld>".parse().unwrap())
    .to("Hei <hei@domain.tld>".parse().unwrap())
    .subject("Happy new year")
    .singlepart(
        SinglePart::builder()
            .header(header::ContentType(
                "text/plain; charset=utf8".parse().unwrap(),
            )).header(header::ContentTransferEncoding::QuotedPrintable)
            .body("Привет, мир!"),
    )
    .unwrap();

The body will be encoded using selected Content-Transfer-Encoding.

From: NoBody <nobody@domain.tld>
Reply-To: Yuin <yuin@domain.tld>
To: Hei <hei@domain.tld>
Subject: Happy new year
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: quoted-printable

=D0=9F=D1=80=D0=B8=D0=B2=D0=B5=D1=82, =D0=BC=D0=B8=D1=80!

Multiple parts

And more advanced way of building message by using multipart MIME contents.

use lettre::message::{header, Message, MultiPart, SinglePart, Part};

let m = Message::builder()
    .from("NoBody <nobody@domain.tld>".parse().unwrap())
    .reply_to("Yuin <yuin@domain.tld>".parse().unwrap())
    .to("Hei <hei@domain.tld>".parse().unwrap())
    .subject("Happy new year")
    .multipart(
        MultiPart::mixed()
        .multipart(
            MultiPart::alternative()
            .singlepart(
                SinglePart::quoted_printable()
                .header(header::ContentType("text/plain; charset=utf8".parse().unwrap()))
                .body("Привет, мир!")
            )
            .multipart(
               MultiPart::related()
                .singlepart(
                    SinglePart::eight_bit()
                    .header(header::ContentType("text/html; charset=utf8".parse().unwrap()))
                    .body("<p><b>Hello</b>, <i>world</i>! <img src=smile.png></p>")
                )
                .singlepart(
                    SinglePart::base64()
                    .header(header::ContentType("image/png".parse().unwrap()))
                    .header(header::ContentDisposition {
                        disposition: header::DispositionType::Inline,
                        parameters: vec![],
                    })
                    .body("<smile-raw-image-data>")
                )
            )
        )
        .singlepart(
            SinglePart::seven_bit()
            .header(header::ContentType("text/plain; charset=utf8".parse().unwrap()))
            .header(header::ContentDisposition {
                disposition: header::DispositionType::Attachment,
                parameters: vec![
                    header::DispositionParam::Filename(
                        header::Charset::Ext("utf-8".into()),
                        None, "example.c".as_bytes().into()
                    )
                ]
            })
            .body("int main() { return 0; }")
        )
    ).unwrap();

From: NoBody <nobody@domain.tld>
Reply-To: Yuin <yuin@domain.tld>
To: Hei <hei@domain.tld>
Subject: Happy new year
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="RTxPCn9p31oAAAAAeQxtr1FbXr/i5vW1hFlH9oJqZRMWxRMK1QLjQ4OPqFk9R+0xUb/m"

--RTxPCn9p31oAAAAAeQxtr1FbXr/i5vW1hFlH9oJqZRMWxRMK1QLjQ4OPqFk9R+0xUb/m
Content-Type: multipart/alternative; boundary="qW9QCn9p31oAAAAAodFBg1L1Qrraa5hEl0bDJ6kfJMUcRT2LLSWEoeyhSEbUBIqbjWqy"

--qW9QCn9p31oAAAAAodFBg1L1Qrraa5hEl0bDJ6kfJMUcRT2LLSWEoeyhSEbUBIqbjWqy
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain; charset=utf8

=D0=9F=D1=80=D0=B8=D0=B2=D0=B5=D1=82, =D0=BC=D0=B8=D1=80!
--qW9QCn9p31oAAAAAodFBg1L1Qrraa5hEl0bDJ6kfJMUcRT2LLSWEoeyhSEbUBIqbjWqy
Content-Type: multipart/related; boundary="BV5RCn9p31oAAAAAUt42E9bYMDEAGCOWlxEz89Bv0qFA5Xsy6rOC3zRahMQ39IFZNnp8"

--BV5RCn9p31oAAAAAUt42E9bYMDEAGCOWlxEz89Bv0qFA5Xsy6rOC3zRahMQ39IFZNnp8
Content-Transfer-Encoding: 8bit
Content-Type: text/html; charset=utf8

<p><b>Hello</b>, <i>world</i>! <img src=smile.png></p>
--BV5RCn9p31oAAAAAUt42E9bYMDEAGCOWlxEz89Bv0qFA5Xsy6rOC3zRahMQ39IFZNnp8
Content-Transfer-Encoding: base64
Content-Type: image/png
Content-Disposition: inline

PHNtaWxlLXJhdy1pbWFnZS1kYXRhPg==
--BV5RCn9p31oAAAAAUt42E9bYMDEAGCOWlxEz89Bv0qFA5Xsy6rOC3zRahMQ39IFZNnp8--
--qW9QCn9p31oAAAAAodFBg1L1Qrraa5hEl0bDJ6kfJMUcRT2LLSWEoeyhSEbUBIqbjWqy--
--RTxPCn9p31oAAAAAeQxtr1FbXr/i5vW1hFlH9oJqZRMWxRMK1QLjQ4OPqFk9R+0xUb/m
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset=utf8
Content-Disposition: attachment; filename="example.c"

int main() { return 0; }
--RTxPCn9p31oAAAAAeQxtr1FbXr/i5vW1hFlH9oJqZRMWxRMK1QLjQ4OPqFk9R+0xUb/m--

Re-exports

pub use mime;

Modules

header

Headers widely used in email messages

Structs

Mailbox	Represents an email address with an optional name for the sender/recipient.
Mailboxes	Represents a sequence of Mailbox instances.
Message	Email message which can be formatted
MessageBuilder	A builder for messages
MultiPart	Multipart variant with parts
MultiPartBuilder	Multipart builder
SinglePart	Single part
SinglePartBuilder	Creates builder for single part

Enums

MultiPartKind	The kind of multipart
Part	MIME part variants

Traits

EmailFormat

Type Definitions

Parts

Parts of multipart body