Skip to main content

Parses an email message file and extracts the data from it.

Project description

Coverage Status CLA assistant CircleCI

parse-emails

Parses an email message file and extracts the data from it.

The key features are:

  • Supports .eml and .msg files.
  • Extracts nested attachments.

Requirements

Python 3.8.5+

Installation

$ pip install parse-emails
$ brew install libmagic

Usage

The main class EmailParser contains all what you need to parse an email:

import parse_emails

email = parse_emails.EmailParser(file_path=<file_path>, max_depth=3, parse_only_headers=False)
email.parse()
print(email.parsed_email['Subject'])

Inputs

Argument Name Description
file_path* the file_path of a in msg or eml format
parse_only_headers Will parse only the headers and return headers table, Default is False
max_depth How many levels deep we should parse the attached emails (e.g. email contains an emails contains an email). Default depth level is 3. Minimum level is 1, if set to 1 the script will parse only the first level email
file_info the file info

Contributing

Contributions are welcome and appreciated. To contribute you can submit a PR.

Before merging any PRs, we need all contributors to sign a contributor license agreement. By signing a contributor license agreement, we ensure that the community is free to use your contributions.

When you open a new pull request, a bot will evaluate whether you have signed the CLA. If required, the bot will comment on the pull request, including a link to accept the agreement. The CLA document is also available for review as a PDF.

If the license/cla status check remains on Pending, even though all contributors have accepted the CLA, you can recheck the CLA status by visiting the following link (replace [PRID] with the ID of your PR): https://cla-assistant.io/check/demisto/email-parser?pullRequest=[PRID] .

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

parse_emails-0.1.39.tar.gz (8.9 MB view details)

Uploaded Source

Built Distribution

parse_emails-0.1.39-py3-none-any.whl (8.9 MB view details)

Uploaded Python 3

File details

Details for the file parse_emails-0.1.39.tar.gz.

File metadata

  • Download URL: parse_emails-0.1.39.tar.gz
  • Upload date:
  • Size: 8.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.10.18 Linux/6.1.100+

File hashes

Hashes for parse_emails-0.1.39.tar.gz
Algorithm Hash digest
SHA256 b84fcf0621cdf7a751210059b3676edcc7ad5916a4c8d7b45ae642be2160f3c2
MD5 ed740a0af3f6aa52f6a0df2efdc0062b
BLAKE2b-256 423372d5a59524fb729b0b842ec9aabea084d400ad969ff837ff46fdb701f329

See more details on using hashes here.

File details

Details for the file parse_emails-0.1.39-py3-none-any.whl.

File metadata

  • Download URL: parse_emails-0.1.39-py3-none-any.whl
  • Upload date:
  • Size: 8.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.10.18 Linux/6.1.100+

File hashes

Hashes for parse_emails-0.1.39-py3-none-any.whl
Algorithm Hash digest
SHA256 7d401ff988ec62629705a5774682fcc2f842f733bc11edc5ec8537a142f3bd3b
MD5 81613684300f58d1c00d5b02a61bdcaa
BLAKE2b-256 9b029f85170252a049e0413fde649fd730a621979013717642587eddc664b2cb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page