https://github.com/bbengfort/email-analysis
Analytics for email traffic
https://github.com/bbengfort/email-analysis
Last synced: 12 months ago
JSON representation
Analytics for email traffic
- Host: GitHub
- URL: https://github.com/bbengfort/email-analysis
- Owner: bbengfort
- License: mit
- Created: 2013-12-29T21:13:38.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2014-11-13T02:18:52.000Z (over 11 years ago)
- Last Synced: 2025-02-08T17:30:47.262Z (over 1 year ago)
- Language: Python
- Size: 703 KB
- Stars: 2
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Email Analysis [![Build Status][build_status_img]][build_status_page] #
**Analyzing email traffic with Python**
[![Tidal Wave][tidal_wave.jpg]][tidal_wave.jpg]
My company recently gave me the oppertunity to use [MineMyMail][minemymail] to perform an email-wide analysis of my correspondence. Being the data scientist I am, I decided to run some quick analytics to figure out what was going on inside my email; after all, email is a latent social network that is constructed in real time. Being a good Python programmer, I decided to go the whole nine yards and create an application that would work with the CSV output from [MineMyMail][minemymail] and generate a statistical report with Jinja2. Being a good open source guy- I created integration tests with [Travis CI][travis], a well structured repository, and open sourced it on [Github][github]. This is the result.
## Usage ##
This package expects a CSV output from MineMyMail, you can find an example in the `fixtures` directory. The ordered fields for this CSV file are as follows:
* Email Address
* Display Name
* First Name
* Middle Name
* Last Name
* City
* Region
* Country
* Facebook Link
* Count
* First Seen
* Last Seen
Once you have obtained this file, simply run the Python script in the `bin` directory as follows:
$ bin/m3stat analyze --output=report.html emails.csv
The output option is the path to where to write the HTML report (by default it will write it to the current working directory with the current timestamp). The only argument is the path to the CSV. To get more options and usage run:
$ bin/m3stat --help
Note, it is highly recommended that you create a virtual environment using `virtualenv` and install the requirements found in the requirements.txt file before executing this script. If any requirements are not met, an `ImportError` will be raised by the script.
## TODO ##
1. Write setup.py script
2. Include screenshots of report in documentation
[build_status_img]: https://travis-ci.org/bbengfort/email-analysis.png?branch=master
[build_status_page]: https://travis-ci.org/bbengfort/email-analysis
[tidal_wave.jpg]: http://static3.wikia.nocookie.net/__cb20120726190147/superfriends/images/8/87/Tidal_wave.jpg
[minemymail]: https://minemymail.com/
[jinja2]: http://jinja.pocoo.org/docs/
[travis]: https://travis-ci.org/
[github]: https://github.com