9 unstable releases (4 breaking)

0.8.1 Apr 11, 2018
0.8.0 Mar 31, 2018
0.7.0 Oct 8, 2017
0.6.2 Feb 18, 2017
0.5.0 Oct 26, 2015

#3 in Email

Download history 357/week @ 2018-09-18 353/week @ 2018-09-25 424/week @ 2018-10-02 449/week @ 2018-10-09 364/week @ 2018-10-16 311/week @ 2018-10-23 288/week @ 2018-10-30 522/week @ 2018-11-06 450/week @ 2018-11-13 427/week @ 2018-11-20 231/week @ 2018-11-27 456/week @ 2018-12-04 481/week @ 2018-12-11

655 downloads per month
Used in 9 crates

MIT license

107KB
2.5K SLoC

lettre

Lettre is a mailer library for Rust.

Build Status Build status codecov

Crate Docs Required Rust version MIT licensed

Gitter Average time to resolve an issue Percentage of issues still open

Useful links:


Features

Lettre provides the following features:

  • Multiple transport methods
  • Unicode support (for email content and addresses)
  • Secure delivery with SMTP using encryption and authentication
  • Easy email builders

Example

This library requires Rust 1.20 or newer. To use this library, add the following to your Cargo.toml:

[dependencies]
lettre = "0.8"
lettre_email = "0.8"
extern crate lettre;
extern crate lettre_email;

use lettre::{EmailTransport, SmtpTransport};
use lettre_email::EmailBuilder;
use std::path::Path;

fn main() {
    let email = EmailBuilder::new()
        // Addresses can be specified by the tuple (email, alias)
        .to(("user@example.org", "Firstname Lastname"))
        // ... or by an address only
        .from("user@example.com")
        .subject("Hi, Hello world")
        .text("Hello world.")
        .build()
        .unwrap();

    // Open a local connection on port 25
    let mut mailer = SmtpTransport::builder_unencrypted_localhost().unwrap()
                                                                   .build();
    // Send the email
    let result = mailer.send(&email);

    if result.is_ok() {
        println!("Email sent");
    } else {
        println!("Could not send email: {:?}", result);
    }

    assert!(result.is_ok());
}

Testing

The lettre tests require an open mail server listening locally on port 2525 and the sendmail command.

Code of conduct

Anyone who interacts with Lettre in any space, including but not limited to this GitHub repository, must follow our code of conduct.

License

This program is distributed under the terms of the MIT license.

See LICENSE for details.

Dependencies

~1.5MB
~22K SLoC