427fb4e35c
The textnonce dependency pulls in quite a few transitive dependencies. However, we only use the dependency in a single location, to generate MIME boundaries. For this, we can use `rand` directly (which is already a transitive dependency anyways, since it's required by uuid). This reduces the dependency count for a standard build from 117 to 105.
lettre
A mailer library for Rust
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
Lettre does not provide (for now):
- Async support
- Email parsing
Example
This library requires Rust 1.20 or newer.
To use this library, add the following to your Cargo.toml:
[dependencies]
lettre = "0.9"
lettre_email = "0.9"
use lettre::{EmailTransport, SmtpTransport};
use lettre_email::EmailBuilder;
use std::path::Path;
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.
The builder comes from emailmessage-rs by Kayo, under MIT license.
See LICENSE for details.