email-validator-rfc5322

RFC 5322 compliant email address validator for Rust with detailed error reporting.

Features

• Full RFC 5322 Section 3.4.1 compliance
• Quoted local parts ("john doe"@example.com)
• IP literal domains (user@[192.168.1.1], user@[IPv6:2001:db8::1])
• All RFC 5322 special characters in local parts
• RFC 5321 length limits (64 local, 255 domain, 254 total)
• Detailed error types for debugging

Installation

[dependencies]
email-validator-rfc5322 = "0.1"

Usage

use email_validator_rfc5322::{validate_email, is_valid_email};

// Simple boolean check
if is_valid_email("user@example.com") {
    println!("Valid!");
}

// With detailed error information
match validate_email("invalid..email@example.com") {
    Ok(()) => println!("Valid"),
    Err(e) => println!("Invalid: {}", e), // "consecutive dots not allowed"
}

Valid Email Examples

// Standard addresses
validate_email("user@example.com");
validate_email("user.name@domain.org");
validate_email("user+tag@example.com");

// Quoted strings
validate_email("\"john doe\"@example.com");
validate_email("\"user@domain\"@example.com");

// IP literals
validate_email("user@[192.168.1.1]");
validate_email("user@[IPv6:2001:db8::1]");

// Special characters
validate_email("user!#$%&'*+/=?^_`{|}~@example.com");

Error Types

RFC Compliance

• RFC 5322: Internet Message Format (email address syntax)
• RFC 5321: SMTP (length limits)
• RFC 1035: DNS (domain label limits)

MSRV

Minimum supported Rust version: 1.80 (for std::sync::LazyLock)

License

MIT