Mail-parser

Highlights

- Added logging on standard output for command line.
- Resolved many bugs
- Code cleaning

Highlights
- Added custom exceptions:


MailParserError: Base MailParser Exception
|
├── MailParserOutlookError: Raised with Outlook integration errors
|
├── MailParserEnvironmentError: Raised when the environment is not correct
|
├── MailParserOSError: Raised when there is an OS error

Highlights
- `received` headers are now parsed as single hops. All hops are date in UTC, and delay between actual and before hop.


"received": [
{
"from": "host86-187-174-57.range86-187.btcentralplus.com 86.187.174.57 :45321 helo=User",
"delay": 0,
"date_utc": "2016-08-19T14:34:52",
"hop": 1,
"date": "Fri, 19 Aug 2016 20:34:52 +0600",
"with": "esmtpa Exim 4.87 envelope-from <anabelgonzalofanox.com> id 1bakrE-000291-LF",
"by": "localhost.localdomain.com"
},
{
"from": "localhost.localdomain.com mail.revesoft.com 208.74.72.248",
"delay": 159287.0,
"date_utc": "2016-08-21T10:49:39",
"hop": 2,
"date": "21 Aug 2016 10:49:39 -0000",
"with": "ESMTP via TCP",
"by": "mx03.futurequest.net 69.5.6.174"
},
{
"date": "21 Aug 2016 10:49:40 -0000",
"delay": 1.0,
"date_utc": "2016-08-21T10:49:40",
"from": "network",
"hop": 3
},
{
"from": "mx03.futurequest.net mx03.futurequest.net 69.5.6.174",
"delay": 0.0,
"date_utc": "2016-08-21T10:49:40",
"hop": 4,
"date": "21 Aug 2016 10:49:40 -0000",
"with": "FQDP via TCP",
"by": "pt02.futurequest.net 69.5.6.173"
},
{
"date": "21 Aug 2016 10:49:40 -0000",
"delay": 0.0,
"date_utc": "2016-08-21T10:49:40",
"from": "network",
"hop": 5
}
],

Highlights
- There are 2 docker images, for master and for develop
- It's possible more headers with the same name of RFC (in `from` case use `from_`)
- With `mail` property will be returned all mail headers, attachments and body, only if they aren't `None`
- Every property has object, JSON and raw part. So you can get mail as object with `.mail`, as JSON with `.mail_json`, and as raw with `.mail_raw`.
- Added logging on stdout for command line.



:warning: Breaking Changes :warning:
This new release is not compatible with the previous. This version is all object oriented, the simple header is tokenized in every its parts. Example:

Reply-To: "VICTORIA Souvenirs" <smgesi4gmail.com>

now becomes:


"reply_to": [
[
"VICTORIA Souvenirs",
"smgesi4gmail.com"
]
],

- The method `parse_from_*` are removed.
- The anomalies detection are removed.

Highlights
- Added parsing from file-like object, like `sys.stdin`.
- Added option to command line tool to parse standard input.

Highlights
- Parsing Outlook msg email
- Added _received_ field also in JSON complete output
- Added `flag binary` if the attachment is a binary. Detection binary in `quoted-printable` `Content-Transfer-Encoding`
- Normalize `headers` property (all multiple spaces become one space)