esp-idf-smtp 0.4.0

Lightweight SMTP client over esp_tls for esp-idf-svc in Rust
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at https://mozilla.org/MPL/2.0/.

use crate::config::SmtpConfig;
use crate::email::Email;
use crate::error::SmtpError;
use crate::esp_transport::EspTransport;
use crate::protocol;

/// SMTP client for sending emails.
///
/// Each `send()` call opens a new connection and closes it after QUIT.
/// Uses `EspTransport` (esp_tls) for the underlying connection.
pub struct SmtpClient {
    config: SmtpConfig,
}

impl SmtpClient {
    /// Create a new SMTP client with the given configuration.
    pub fn new(config: SmtpConfig) -> Self {
        Self { config }
    }

    /// Send an email.
    ///
    /// Opens a connection, runs the SMTP protocol, and closes the connection.
    /// The connection is cleaned up (QUIT sent) on both success and error paths.
    pub fn send(&self, email: &Email) -> Result<(), SmtpError> {
        let mut transport =
            EspTransport::connect(&self.config).map_err(|e| SmtpError::Connection {
                host: self.config.host.clone(),
                port: self.config.port,
                source: e,
            })?;

        protocol::send_email(&mut transport, &self.config, email)
    }
}