Struct Address

Source

pub struct Address {
    pub name: Option<String>,
    pub email: String,
}

Expand description

An email address with an optional display name.

§Examples

use missive::Address;

// From email string
let addr: Address = "user@example.com".into();
assert_eq!(addr.email, "user@example.com");
assert_eq!(addr.name, None);

// From tuple (name, email)
let addr: Address = ("Alice", "alice@example.com").into();
assert_eq!(addr.email, "alice@example.com");
assert_eq!(addr.name, Some("Alice".to_string()));

Fields§

§name: Option<String>

Optional display name (e.g., “Alice Smith”)

§email: String

Email address (e.g., “alice@example.com”)

Implementations§

Source §

impl Address

Source

pub fn new(email: impl Into<String>) -> Self

Create a new address with just an email.

This performs a basic sanity check (non-empty, contains @) and logs a warning if the email looks invalid. For strict validation, use Address::parse instead.

Source

pub fn with_name(name: impl Into<String>, email: impl Into<String>) -> Self

Create a new address with a name and email.

This performs a basic sanity check (non-empty, contains @) and logs a warning if the email looks invalid. For strict validation, use Address::parse_with_name instead.

Source

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

Set the display name.

Source

pub fn parse(email: &str) -> Result<Self, MailError>

Parse and validate an email address.

Uses RFC 5321/5322 compliant validation. Returns an error if the email address is invalid.

§Examples

use missive::Address;

// Valid address
let addr = Address::parse("user@example.com").unwrap();
assert_eq!(addr.email, "user@example.com");

// Invalid address
assert!(Address::parse("not-an-email").is_err());
assert!(Address::parse("").is_err());

Source

pub fn parse_with_name(name: &str, email: &str) -> Result<Self, MailError>

Parse and validate an email address with a display name.

§Examples

use missive::Address;

let addr = Address::parse_with_name("Alice", "alice@example.com").unwrap();
assert_eq!(addr.email, "alice@example.com");
assert_eq!(addr.name, Some("Alice".to_string()));

// Invalid email
assert!(Address::parse_with_name("Alice", "not-valid").is_err());

Source

pub fn to_ascii(&self) -> Result<String, MailError>

Convert the domain part of the email address to ASCII (Punycode).

This is useful for international domain names (IDN) that contain non-ASCII characters. The local part (before @) is preserved as-is.

§Examples

use missive::Address;

// Japanese domain
let addr = Address::new("user@例え.jp");
assert_eq!(addr.to_ascii().unwrap(), "user@xn--r8jz45g.jp");

// Already ASCII domain
let addr = Address::new("user@example.com");
assert_eq!(addr.to_ascii().unwrap(), "user@example.com");

Source

pub fn formatted_ascii(&self) -> Result<String, MailError>

Format with ASCII-encoded domain (Punycode for IDN).

Like formatted() but converts international domain names to ASCII. Use this when sending emails through SMTP or other protocols that require ASCII domain names.

§Examples

use missive::Address;

let addr = Address::with_name("User", "user@例え.jp");
assert_eq!(addr.formatted_ascii().unwrap(), "User <user@xn--r8jz45g.jp>");

Source