12 unstable releases (3 breaking)
new 0.3.0 | Dec 1, 2024 |
---|---|
0.2.2 | Nov 23, 2024 |
0.2.1 | Oct 6, 2024 |
0.2.0 | Sep 28, 2024 |
0.0.7 | Aug 21, 2024 |
#128 in Email
328 downloads per month
66KB
1.5K
SLoC
Dependencies
spring-mail = { version = "<version>" }
Configuration items
[mail]
host = "smtp.gmail.com" # SMTP mail server address,
port = 465 # SMTP server port number
secure = true # Enable TLS
auth = { user = "user@gmail.com", password = "passwd" } # Authentication information
test_connection = false # Whether to test mail server connection on startup
Components
After configuring the above configuration items, the plugin will automatically register a Mailer
STMP asynchronous client. This object is an alias of lettre::AsyncSmtpTransport<Tokio1Executor>
.
pub type Mailer = lettre::AsyncSmtpTransport<Tokio1Executor>;
Extract the Component registered by the plugin
The MailPlugin
plugin automatically registers an SMTP client for us. We can use Component
to extract this connection pool from AppState. Component
is an axum extractor.
async fn send_mail(Component(mailer): Component<Mailer>) -> Result<impl IntoResponse> {
let email = Message::builder()
.from("NoBody <nobody@domain.tld>".parse().unwrap())
.reply_to("Yuin <yuin@domain.tld>".parse().unwrap())
.to("hff1996723@163.com".parse().unwrap())
.subject("Happy new year")
.header(ContentType::TEXT_PLAIN)
.body(String::from("Be happy!"))
.unwrap();
let resp = mailer.send(email).await.context("send mail failed")?;
Ok(Json(resp))
}
For the complete code, please refer to mail-example
Dependencies
~14–46MB
~708K SLoC