#eml #parse #email-parsing #email


A library for parsing .eml files

3 releases

0.1.3 Mar 12, 2022
0.1.2 Feb 14, 2021
0.1.0 Apr 25, 2020

#98 in Email

Download history 967/week @ 2023-02-02 819/week @ 2023-02-09 858/week @ 2023-02-16 797/week @ 2023-02-23 326/week @ 2023-03-02 798/week @ 2023-03-09 595/week @ 2023-03-16 511/week @ 2023-03-23 406/week @ 2023-03-30 541/week @ 2023-04-06 591/week @ 2023-04-13 551/week @ 2023-04-20 568/week @ 2023-04-27 448/week @ 2023-05-04 522/week @ 2023-05-11 428/week @ 2023-05-18

2,137 downloads per month
Used in 3 crates (via nu_plugin_formats)

Custom license

633 lines


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


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

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

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);


~38K SLoC