A set of async generic Mailer and dynamic dyn DynMailer traits with runtime-pluggable Outlook (Office365) and SMTP implementations.
Add to your Cargo.toml:
toml
async-mailer = "0.3.2"
By default, features smtp, outlook and tracing are enabled.
Use default-features = false and features = [...] to select features individually.
Use new for a strongly typed mailer instance,
or new_box / new_arc for a type-erased dynamic mailer.
Microsoft Outlook and SMTP mailer variants are available.
async_mailer::Mailer:``rust
// Create animpl Mailer`.
//
// Alternative implementations can be used.
let mailer = asyncmailer::OutlookMailer::new(
"
// Alternative:
let mailer = asyncmailer::SmtpMailer::new(
"smtp.example.com".into(),
465,
asyncmailer::SmtpInvalidCertsPolicy::Deny,
"
// Further alternative mailers can be implemented by third parties.
// Build a message using the re-exported mail_builder::MessageBuilder'.
// For blazingly fast rendering of beautiful HTML mail, I recommend combiningaskamawithmrml`.
use asyncmailer::IntoMessage;
let message = asyncmailer::MessageBuilder::new()
.from(("From Name", "from@example.com"))
.to("to@example.com")
.subject("Subject")
.textbody("Mail body")
.intomessage()?;
// Send the message using the strongly typed Mailer.
use asyncmailer::Mailer;
mailer.sendmail(message).await?;
```
async_mailer::DynMailer:``rust
// Create aBoxMailer`.
//
// Alternative implementations can be used.
use asyncmailer::BoxMailer;
let mailer: BoxMailer = asyncmailer::OutlookMailer::newbox( // Or new_arc to use in e.g. globally shared server state.
"
// Alternative:
let mailer: BoxMailer = asyncmailer::SmtpMailer::newbox( // Or new_arc to use in e.g. globally shared server state.
"smtp.example.com".into(),
465,
asyncmailer::SmtpInvalidCertsPolicy::Deny,
"
// Further alternative mailers can be implemented by third parties.
// The trait object is Send and Sync and may be stored e.g. as part of your server state.
// Build a message using the re-exported mail_builder::MessageBuilder'.
// For blazingly fast rendering of beautiful HTML mail, I recommend combiningaskamawithmrml`.
use asyncmailer::IntoMessage;
let message = asyncmailer::MessageBuilder::new()
.from(("From Name", "from@example.com"))
.to("to@example.com")
.subject("Subject")
.textbody("Mail body")
.intomessage()?;
// Send the message using the implementation-agnostic dyn DynMailer.
mailer.send_mail(message).await?;
```
SmtpMailer.OutlookMailer.Further mailer implementations are possible. Please open an issue and ideally provide a pull request to add your alternative mailer implementation!