email-clients 0.2.0

This is library that provides user with easy to use email clients collection in rust.
Documentation 
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
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

use crate::configuration::EmailConfiguration;
use crate::email::{EmailAddress, EmailObject};
use crate::traits::EmailTrait;
use async_trait::async_trait;

#[derive(Debug, Clone, serde::Deserialize, serde::Serialize, Default, PartialOrd, PartialEq)]
pub struct TerminalConfig {
    pub sender: EmailAddress,
}

impl From<String> for TerminalConfig {
    /// Converts a `String` into a `MemoryConfig`.
    ///
    /// # Parameters
    /// - `value`: A `String` value which will be used to initialize a `MemoryConfig` instance.
    ///
    /// # Returns
    /// A new instance of `MemoryConfig` with the `sender` property set to the provided `String`.
    ///
    /// # Examples
    /// ```rust
    /// use email_clients::clients::terminal::TerminalConfig;
    /// let value = String::from("sender@example.com");
    /// let config = TerminalConfig::from(value);
    /// assert_eq!(config.sender.to_string(), "sender@example.com");
    /// ```
    fn from(value: String) -> Self {
        Self {
            sender: value.as_str().into(),
        }
    }
}

#[derive(Clone, Debug, Default, PartialOrd, PartialEq)]
pub struct TerminalClient {
    sender: EmailAddress,
}

impl From<TerminalConfig> for EmailConfiguration {
    /// This module manages the Terminal Configuration for an Email Client. It can be used to generate a client from a configuration.
    ///
    /// # Examples
    ///
    /// Basic usage:
    ///
    /// ```
    /// # use email_clients::email::EmailObject;
    /// # use email_clients::clients::terminal::TerminalConfig;
    /// # use email_clients::configuration::EmailConfiguration;
    /// #
    /// let config: TerminalConfig = String::from("me@domain.com").into();
    /// let email_config: EmailConfiguration = config.into();
    ///```
    ///
    /// Converting a Terminal Configuration into an Email Configuration directly:
    ///
    /// ```
    /// # use email_clients::clients::terminal::TerminalConfig;
    /// # use email_clients::configuration::EmailConfiguration;
    /// #
    /// let config: TerminalConfig = String::from("me@domain.com").into();
    /// let new_config: EmailConfiguration = config.into();
    /// ```
    ///
    fn from(value: TerminalConfig) -> Self {
        EmailConfiguration::Terminal(value)
    }
}

impl TerminalClient {
    pub fn new(config: TerminalConfig) -> Self {
        Self {
            sender: config.sender,
        }
    }
}

#[async_trait]
impl EmailTrait for TerminalClient {
    fn get_sender(&self) -> EmailAddress {
        self.sender.clone()
    }

    async fn send_emails(&self, email: EmailObject) -> crate::Result<()> {
        println!("From: {}", self.sender);
        for e in email.to {
            println!("To: {} <{}>", e.name, e.email);
        }
        println!("Subject: {}\n\n", email.subject);
        println!("{}", email.plain);
        println!("----------");
        println!("{}", email.html);
        Ok(())
    }
}