Struct Email

pub struct Email {
    pub id: Uuid,
    pub from: String,
    pub to: Vec<String>,
    pub cc: Option<Vec<String>>,
    pub bcc: Option<Vec<String>>,
    pub reply_to: Option<String>,
    pub subject: String,
    pub html_body: Option<String>,
    pub text_body: Option<String>,
    pub attachments: Vec<Attachment>,
    pub headers: HashMap<String, String>,
    pub tracking: TrackingOptions,
}

Core email message structure

Fields

id: Uuid

Unique identifier for tracking

from: String

Sender email address

to: Vec<String>

Recipient email addresses

cc: Option<Vec<String>>

CC recipients

bcc: Option<Vec<String>>

BCC recipients

reply_to: Option<String>

Reply-to address

subject: String

Email subject

html_body: Option<String>

HTML body content

text_body: Option<String>

Plain text body content

attachments: Vec<Attachment>

Email attachments

headers: HashMap<String, String>

Email headers

tracking: TrackingOptions

Tracking metadata

Implementations

impl Email

Extension methods for Email to work with templates

pub fn from_template( engine: &TemplateEngine, template: &EmailTemplate, context: impl IntoTemplateContext, ) -> Result<Self, EmailError>

Create email from template

pub fn with_template( self, engine: &TemplateEngine, template_name: &str, context: impl IntoTemplateContext, ) -> Result<Self, EmailError>

Update email with rendered template content by name

pub fn with_template_struct( self, engine: &TemplateEngine, template: &EmailTemplate, context: impl IntoTemplateContext, ) -> Result<Self, EmailError>

Update email with rendered template content using EmailTemplate struct

impl Email

Extension methods for Email validation

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

Validate this email

impl Email

pub fn new() -> Self

Create a new email

pub fn from(self, from: impl Into<String>) -> Self

Set sender

pub fn to(self, to: impl Into<String>) -> Self

Add recipient

pub fn subject(self, subject: impl Into<String>) -> Self

Set subject

pub fn html_body(self, html: impl Into<String>) -> Self

Set HTML body

pub fn text_body(self, text: impl Into<String>) -> Self

Set text body

pub fn attach(self, attachment: Attachment) -> Self

Add attachment

pub fn with_tracking(self, track_opens: bool, track_clicks: bool) -> Self

Enable tracking

pub fn attach_inline(self, attachment: Attachment) -> Self

Add an inline attachment (for embedding in HTML emails)

pub fn validate_attachments( &self, config: &AttachmentConfig, ) -> Result<(), EmailError>

Validate all attachments against configuration

pub fn inline_attachments(&self) -> Vec<&Attachment>

Get all inline attachments (for HTML embedding)

pub fn regular_attachments(&self) -> Vec<&Attachment>

Get all regular attachments

pub fn compress_attachments( &mut self, config: &AttachmentConfig, ) -> Result<(), EmailError>

Apply compression to all attachments if configured

pub fn estimated_compressed_size(&self) -> usize

Get estimated size after compression

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() -> Self

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.