tnefparse - TNEF decoding and attachment extraction

https://travis-ci.org/koodaamo/tnefparse.png?branch=master

This is a pure-python library for decoding Microsoft's Transport Neutral Encapsulation Format (TNEF), for Python versions 2.7, 3.5+ and PyPy. For more information on TNEF, see for example wikipedia. The full TNEF specification is also available as a PDF download.

A tnefparse command-line utility is provided for listing contents of TNEF files, extracting attachments found inside them and so on:

usage: tnefparse [-h] [-o] [-a] [-p PATH] [-b] [-hb]
                 [-l LEVEL] [-c]
                 file [file ...]

Extract TNEF file contents. Show this help message if no arguments are given.

positional arguments:
  file                  space-separated list of paths to the TNEF files

optional arguments:
  -h, --help             show this help message and exit
  -o, --overview         show (possibly long) overview of TNEF file contents
  -a, --attachments      extract attachments, by default to current dir
  -p PATH, --path PATH   optional explicit path to extract attachments to
  -b, --body             extract the body to stdout
  -hb, --htmlbody        extract the HTML body to stdout
  -rb, --rtfbody         extract the RTF body to stdout
  -l LEVEL, --log LEVEL  set log level to DEBUG, INFO, WARN or ERROR
  -c, --checksum         calculate checksums (off by default)
  -d, --dump             extract a json dump of the tnef contents

The library can also be used as a basis for applications that need to parse TNEF. To parse a TNEF attachment, run eg. :

>>> from tnefparse import TNEF
>>> with open("tests/examples/one-file.tnef", "rb") as tneffile:
...    tnefobj = TNEF(tneffile.read())

The parsed attachment contents are then available as TNEF object attributes:

signature - TNEF file signature
key - generated by TNEF enabled transports before using the TNEF implementation to generate a TNEF stream
codepage - a Windows code page string
objects - a collection of TNEFObject instances
attachments - a collection of TNEFAttachment instances
mapiprops - a collection of MAPI properties represented by TNEFMAPI_Attribute instances
body - message body (may contain both HTML and RTF)
htmlbody - a string containing just the HTML message body
rtfbody - just the RTF body

Some of the above properties may be empty, depending on what's contained in the attachment that was parsed.

To run the tests, first install the package using e.g. pip install -e . and then run python setup.py test.

Issues and pull requests welcome. Please however always provide an example TNEF file that can be used to demonstrate the bug or desired behavior, if at all possible.

Note: If you have understanding of TNEF and/or MIME internals or just need this package and want to help with maintaining it, I am open to giving you commit rights. Just let me know.

Beercow/tnefparse

tnefparse - TNEF decoding and attachment extraction