emailparser/parse

#!/usr/bin/python

import os, argparse, hashlib, email, email.header, glob, sqlite3

parser = argparse.ArgumentParser(description='Parses emails into an SQLite database, and optionally renders static HTML files.')

parser.add_argument('-p', dest='pattern', action='store', default='*',
                   help='glob pattern (including path) that has to be matched for a file to be parsed')
                   
parser.add_argument('-d', dest='database', action='store', default='emails.db',
                   help='path of the database that should be used to store the emails (will be created if it does not exist yet)')
                   
parser.add_argument('-a', dest='attachment_dir', action='store', default='attachments',
                   help='path where attachments should be stored (will be created if it does not exist yet)')
                   
parser.add_argument('-r', '--render', dest='render', action='store_true',
                   help='render static HTML files using the template files in templates/')

args = parser.parse_args()
options = vars(args)

def getheader(header_text, default="ascii"):
	headers = email.header.decode_header(header_text)
	header_sections = [unicode(text, charset or default) for text, charset in headers]
	return u"".join(header_sections)
	
def find_submessages(message):
	if message.is_multipart():
		return [find_submessages(part) for part in message.get_payload()]
	else:
		return message

def flatten(x):
	# http://kogs-www.informatik.uni-hamburg.de/~meine/python_tricks
	result = []
	for el in x:
		if hasattr(el, "__iter__") and not isinstance(el, basestring):
			result.extend(flatten(el))
		else:
			result.append(el)
	return result

def get_charset(part):
	if part.get_content_charset():
		return part.get_content_charset()
	elif part.get_charset():
		return part.get_charset()
	else:
		return "ascii"

# Connect to database
database = sqlite3.connect(options['database'])
cursor = database.cursor()

try:
	# Create attachment directory first
	os.makedirs(options['attachment_dir'])
except OSError:
	pass

try:
	# Try to create emails table
	cursor.execute("CREATE TABLE emails (`message_id`, `from`, `to`, `subject`, `date`, `body`, `html`, `hash`)")
except sqlite3.OperationalError:
	pass
	
try:
	# Try to create attachments table
	cursor.execute("CREATE TABLE attachments (`message_hash`, `filename`, `type`, `hash`, `size`)")
except sqlite3.OperationalError:
	pass

# Select all files matching the given pattern
file_list = glob.glob(options['pattern'])

for email_file in file_list:
	message = email.message_from_file(open(email_file))
	
	if message['message-id'] is None:
		print "%s is not a valid e-mail file." % email_file
	else:
		if 'subject' not in message or message['subject'] is None:
			subject = ""
		else:
			subject = message['subject']
		
		textbody = ""
		htmlbody = ""
		attachment_list = []
		
		sha1_hash = hashlib.sha1("%s/%s/%s/%s" % (message['from'], message['to'], message['message-id'], subject)).hexdigest()
		
		message_parts = [find_submessages(message)]
		message_parts = flatten(message_parts)
		
		for part in message_parts:
			if part.get_filename() is None:
				# Part of the message
				if part.get_content_type() == "text/plain":
					if textbody == "":
						textbody = part.get_payload(decode=True).decode(get_charset(part))
				elif part.get_content_type() == "text/html" or part.get_content_type == "text/xhtml+xml" or part.get_content_type == "application/xhtml+xml":
					if htmlbody == "":
						htmlbody = part.get_payload(decode=True).decode(get_charset(part))
				else:
					# Technically this is supposed to be part of the message body, but we have no idea what format it is in...
					print "WARNING: Unknown message format encountered in %s, message may be incomplete." % sha1_hash
			else:
				# Attachment
				attachment_data = part.get_payload(decode=True)
				attachment_sha1 = hashlib.sha1(attachment_data).hexdigest()
				attachment_filename = part.get_filename()
				attachment_type = part.get_content_type()
				attachment_extension = os.path.splitext(attachment_filename)[1][1:]
				attachment_size = len(attachment_data)
				attachment_destination = "%s/%s.%s" % (options['attachment_dir'], attachment_sha1, attachment_extension)
				attachment_list.append((attachment_filename, attachment_type, attachment_sha1, attachment_size))
				
				attachment_file = open(attachment_destination, "w")
				attachment_file.write(attachment_data)
				attachment_file.close()
		
		timestamp = 0
		
		new_row = (getheader(message['message-id']), getheader(message['from']), getheader(message['to']), getheader(subject), timestamp, textbody, htmlbody, sha1_hash)
		cursor.execute("INSERT INTO emails VALUES (?, ?, ?, ?, ?, ?, ?, ?)", new_row)
		
		print "Successfully parsed and inserted e-mail with SHA1 hash %s." % sha1_hash
		
		if len(attachment_list) > 0:
			for attachment in attachment_list:
				new_row = (sha1_hash, attachment[0], attachment[1], attachment[2], attachment[3])
				cursor.execute("INSERT INTO attachments VALUES (?, ?, ?, ?, ?)", new_row)
				
			print "Successfully inserted %d attachment(s) for %s." % (len(attachment_list), sha1_hash)

database.commit()
print "Changes successfully committed to database, exiting..."