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.30.tar.gz (8.8 MB view details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: parse_emails-0.1.30.tar.gz
  • Upload date:
  • Size: 8.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.10.15 Linux/5.15.154+

File hashes

Hashes for parse_emails-0.1.30.tar.gz
Algorithm Hash digest
SHA256 42ef645b0b694ead0dbd843a2f8e8080684c4756254ba6e1ab9282aa10ea53e3
MD5 fbfbe12746a80393e476c72c34fd2309
BLAKE2b-256 299a2751dbd91abd59f9480c2be0b4316122efa074f36b9a59925f07588cd916

See more details on using hashes here.

File details

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

File metadata

  • Download URL: parse_emails-0.1.30-py3-none-any.whl
  • Upload date:
  • Size: 8.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.10.15 Linux/5.15.154+

File hashes

Hashes for parse_emails-0.1.30-py3-none-any.whl
Algorithm Hash digest
SHA256 23daabd34056d0ced289803d648db5fb3eccf8edb425f7593d3652a1057686fe
MD5 271e141159b5db5c7d1cbe22a2090c3e
BLAKE2b-256 af6e4be058128ccde3e55a1ae7e2bec96351abb9b842b117fca17466ee17feb6

See more details on using hashes here.

Supported by

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