eml-parser

Crates.ioeml-parser
lib.rseml-parser
version0.1.4
sourcesrc
created_at2020-04-25 05:54:15.069065
updated_at2023-11-26 18:29:08.619453
descriptionA library for parsing .eml files.
homepagehttps://github.com/aeshirey/EmlParser/
repositoryhttps://github.com/aeshirey/EmlParser/
max_upload_size
id233861
size52,507
Adam Shirey (aeshirey)

documentation

README

EmlParser

EmlParser is a crate intended to parse .eml files. Currently, this crate is very basic, supporting extracting field (name,value) pairs from an email header plus the body of the message. Special headers To, From, and Subject are separated out; all others are currently listed in a Vec<HeaderField>.

The parsing for this crate attempts to follow RFC-0822, though in practice there seem to be deviations from the RFC as to how to handle newlines. The spec lays out that the body and header are separated by a null line, as delimited by CRLF. Often, we'll actually see \n\n, so EmlParser allows \n\n, \r\r, and \r\n\r\n.

Note that header fields are able to include newlines in them, defined as linear whitespace.

Finding the separator between the header and body follows the following transition digram:

Transition diagram for detecting the header/body delimiter

Usage

You can use EmlParser with a &str or a filename:

let eml: Eml = EmlParser::from_file("Re: hello.eml")?
    .ignore_body()
    .parse()?;

let expected = HeaderFieldValue::SingleEmailAddress(EmailAddress::NameAndEmailAddress {
    name: "Anne Thompson".to_string(),
    address: "anne@example.com".to_string(),
});

assert_eq!(Some(expected), eml.from);
assert_eq!(Some("Re: hello".to_string()), eml.subject);
Commit count: 31

cargo fmt