mail-builder

mail-builder is a flexible e-mail builder library written in Rust that generates RFC5322 compliant e-mail messages. The library has full MIME support and automatically selects the most optimal encoding for each message body part.

Building e-mail messages is straightforward:

```rust // Build a simple text message with a single attachment let mut message = MessageBuilder::new(); message.from(("John Doe", "john@doe.com").into()); message.to("jane@doe.com".into()); message.subject("Hello, world!".into()); message.textbody("Text body contents go here."); message.binaryattachment("image/png", "image.png", &[1, 2, 3, 4]);

// Write message to memory
let mut output = Vec::new();
message.write_to(&mut output).unwrap();

```

More complex messages with grouped addresses, inline parts and multipart/alternative sections can also be easily built:

```rust // Build a multipart message with text and HTML bodies, // inline parts and attachments. let mut message = MessageBuilder::new(); message.from(("John Doe", "john@doe.com").into());

// To recipients
message.to(vec![
    ("Antoine de Saint-Exupéry", "antoine@exupery.com").into(),
    ("안녕하세요 세계", "test@test.com").into(),
    ("Xin chào", "addr@addr.com").into(),
]
.into());

// BCC recipients using grouped addresses
message.bcc(
    vec![
        (
            "My Group",
            vec![
                ("ASCII name", "addr1@addr7.com").into(),
                ("ハロー・ワールド", "addr2@addr6.com").into(),
                ("áéíóú", "addr3@addr5.com").into(),
                ("Γειά σου Κόσμε", "addr4@addr4.com").into(),
            ],
        )
            .into(),
        (
            "Another Group",
            vec![
                ("שלום עולם", "addr5@addr3.com").into(),
                ("ñandú come ñoquis", "addr6@addr2.com").into(),
                "addr7@addr1.com".into(),
            ],
        )
            .into(),
    ]
    .into(),
);

// Set RFC and custom headers
message.subject("Testing multipart messages".into());
message.in_reply_to(vec!["message-id-1", "message-id-2"].into());
message.header(
    "List-Archive",
    URL::new("http://example.com/archive").into(),
);

// Set HTML and plain text bodies
message.text_body("This is the text body!\n");
message.html_body("<p>HTML body with <img src=\"my-image\"/>!</p>");

// Include an embedded image as an inline part
message.binary_inline("image/png", "my-image", &[0, 1, 2, 3, 4, 5]);

// Add a text and a binary attachment
message.text_attachment("text/plain", "my fíle.txt", "Attachment contents go here.");
message.binary_attachment(
    "text/plain",
    "ハロー・ワールド",
    b"Binary contents go here.",
);

// Write the message to a file
message
    .write_to(File::create("message.eml").unwrap())
    .unwrap();

```

Nested MIME body structures can be created using the body method:

```rust // Build a nested multipart message let mut message = MessageBuilder::new();

message.from(Address::new_address("John Doe".into(), "john@doe.com"));
message.to(Address::new_address("Jane Doe".into(), "jane@doe.com"));
message.subject("Nested multipart message".into());

// Define the nested MIME body structure
message.body(MimePart::new_multipart(
    "multipart/mixed",
    vec![
        MimePart::new_text("Part A contents go here...").inline(),
        MimePart::new_multipart(
            "multipart/mixed",
            vec![
                MimePart::new_multipart(
                    "multipart/alternative",
                    vec![
                        MimePart::new_multipart(
                            "multipart/mixed",
                            vec![
                                MimePart::new_text("Part B contents go here...").inline(),
                                MimePart::new_binary(
                                    "image/jpeg",
                                    "Part C contents go here...".as_bytes(),
                                )
                                .inline(),
                                MimePart::new_text("Part D contents go here...").inline(),
                            ],
                        ),
                        MimePart::new_multipart(
                            "multipart/related",
                            vec![
                                MimePart::new_html("Part E contents go here...").inline(),
                                MimePart::new_binary(
                                    "image/jpeg",
                                    "Part F contents go here...".as_bytes(),
                                ),
                            ],
                        ),
                    ],
                ),
                MimePart::new_binary("image/jpeg", "Part G contents go here...".as_bytes())
                    .attachment("image_G.jpg"),
                MimePart::new_binary(
                    "application/x-excel",
                    "Part H contents go here...".as_bytes(),
                ),
                MimePart::new_binary(
                    "x-message/rfc822",
                    "Part J contents go here...".as_bytes(),
                ),
            ],
        ),
        MimePart::new_text("Part K contents go here...").inline(),
    ],
));

// Write the message to a file
message
    .write_to(File::create("nested-message.eml").unwrap())
    .unwrap();

```

Please note that this library does not support parsing e-mail messages as this functionality is provided separately by the mail-parser crate.

Testing

To run the testsuite:

bash $ cargo test --all-features

or, to run the testsuite with MIRI:

bash $ cargo +nightly miri test --all-features

License

Licensed under either of

Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Copyright

See [COPYING] for the license.