Struct Email 

pub struct Email {
    pub to: Vec<String>,
    pub from: Option<String>,
    pub reply_to: Option<String>,
    pub cc: Vec<String>,
    pub bcc: Vec<String>,
    pub subject: Option<String>,
    pub text: Option<String>,
    pub html: Option<String>,
    pub headers: Vec<(String, String)>,
}

An email message

Use the builder pattern to construct emails:

use acton_htmx::email::Email;

let email = Email::new()
    .to("user@example.com")
    .from("noreply@myapp.com")
    .subject("Welcome!")
    .text("Welcome to our app!")
    .html("<h1>Welcome to our app!</h1>");

Fields

to: Vec<String>

Email recipients (To)

from: Option<String>

Email sender (From)

reply_to: Option<String>

Reply-To address

cc: Vec<String>

CC recipients

bcc: Vec<String>

BCC recipients

subject: Option<String>

Email subject

text: Option<String>

Plain text body

html: Option<String>

HTML body

headers: Vec<(String, String)>

Custom headers

Implementations

impl Email

pub fn new() -> Self

Create a new empty email

Examples

use acton_htmx::email::Email;

let email = Email::new();

pub fn from_template<T: EmailTemplate>(template: &T) -> Result<Self, EmailError>

Create an email from a template

Errors

Returns EmailError::TemplateError if the template fails to render

Examples

use acton_htmx::email::{Email, EmailTemplate};
use askama::Template;

#[derive(Template)]
#[template(path = "emails/welcome.html")]
struct WelcomeEmail {
    name: String,
}

let template = WelcomeEmail {
    name: "Alice".to_string(),
};

let email = Email::from_template(&template)?;

pub fn to(self, address: &str) -> Self

Add a recipient (To)

Examples

use acton_htmx::email::Email;

let email = Email::new()
    .to("user@example.com");

pub fn to_multiple(self, addresses: &[&str]) -> Self

Add multiple recipients (To)

Examples

use acton_htmx::email::Email;

let email = Email::new()
    .to_multiple(&["user1@example.com", "user2@example.com"]);

pub fn from(self, address: &str) -> Self

Set the sender (From)

Examples

use acton_htmx::email::Email;

let email = Email::new()
    .from("noreply@myapp.com");

pub fn reply_to(self, address: &str) -> Self

Set the reply-to address

Examples

use acton_htmx::email::Email;

let email = Email::new()
    .reply_to("support@myapp.com");

pub fn cc(self, address: &str) -> Self

Add a CC recipient

Examples

use acton_htmx::email::Email;

let email = Email::new()
    .cc("manager@example.com");

pub fn bcc(self, address: &str) -> Self

Add a BCC recipient

Examples

use acton_htmx::email::Email;

let email = Email::new()
    .bcc("admin@example.com");

pub fn subject(self, subject: &str) -> Self

Set the email subject

Examples

use acton_htmx::email::Email;

let email = Email::new()
    .subject("Welcome to Our App!");

pub fn text(self, body: &str) -> Self

Set the plain text body

Examples

use acton_htmx::email::Email;

let email = Email::new()
    .text("Welcome to our app!");

pub fn html(self, body: &str) -> Self

Set the HTML body

Examples

use acton_htmx::email::Email;

let email = Email::new()
    .html("<h1>Welcome to our app!</h1>");

pub fn header(self, name: &str, value: &str) -> Self

Add a custom header

Examples

use acton_htmx::email::Email;

let email = Email::new()
    .header("X-Priority", "1");

pub fn validate(&self) -> Result<(), EmailError>

Validate the email

Checks that all required fields are present

Errors

Returns errors if:

• No recipients
• No sender
• No subject
• No content (text or HTML)

Trait Implementations

impl Clone for Email

fn clone(&self) -> Email

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Email

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Email

fn default() -> Email

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Email

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Email

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.