Crate email_address_list

Relatively näive Pest based parser, picking out "contacts" from email address lists found in headers such as from, to, cc, etc.

This library aims to be practical rather than "correct". It is (potentially excessively) permissive to parse even the worst garbage in anyone's inbox. Limited testing with real world data has been, but the grammar that forms the basis for this library probably still needs work to catch more edge cases.

Example

use email_address_list::*;

let manual: AddressList = vec![
    Contact::new("ríomhphost@example.org").set_name("Túsainm Sloinne"),
    Contact::new("sampla@example.org")
].into();

let result = parse_address_list(
    "Túsainm Sloinne <ríomhphost@example.org>, sampla@example.org"
).unwrap();

assert!(result.deep_eq(&manual));

Modules

error

Structs

Contacts	Container for Contacts
EmailContact	A contact with at least an email address
GarbageContact	A string that we couldn't parse into an EmailContact but implements the Contactish trait regardless
Group	A group with a name and Contacts

Enums

AddressList	All forms which email headers like To, From, Cc, etc. can take
Contact	Either an EmailContact we could successfully parse or a GarbageContact we didn't want to throw away

Traits

Contactish	Unified interface for all contact types
Contactsish	For everything that has contacts
DeepEq	Check if all fields are the same rather than just a subset ("deep equals")

Functions

parse_address_list	Get an AddressList from a string
parse_contact	Parse only a single Contact, ignore the rest