Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

Python IMAP for Humans

Project description

Mailbox - Python IMAP for Humans
=======

Python library for reading IMAP mailboxes and converting the email content to human readable data

Installation
============

pip install mailbox


or

git clone git@github.com:martinrusev/mailbox.git
python setup.py install


Usage
=====


from mailbox import MailBox

mailbox = MailBox('imap.gmail.com',
username='username',
password='password',
ssl=True)

# Gets all messages
all_messages = mailbox.messages()

# Unread messages
unread_messages = mailbox.messages(unread=True)


for message in all_messages:
........
# Every message is an object with the following keys

message.sent_from
message.sent_to
message.subject
message.headers
message.message-id
message.date
message.text_body

# To check all available keys
print message.keys()


# To check the whole object, just write

print message

{
'headers':
[{
'Name': 'Received-SPF',
'Value': 'pass (google.com: domain of ......;'
},
{
'Name': 'MIME-Version',
'Value': '1.0'
}],
'text_body': ['ASCII'],
'date': u 'Fri, 26 Jul 2013 10:56:26 +0300',
'message-id': u '51F22BAA.1040606',
'sent_from': [{
'name': u 'Martin Rusev',
'email': 'martin@amon.cx'
}],
'sent_to': [{
'name': u 'John Doe',
'email': 'john@gmail.com'
}],
'subject': u 'Hello John, How are you today'
}

TODO
======

- Replace the dictionaries with objects and generators
- Add logging and exceptions
- Implement smarter header parsing

Project details


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
mailbox-0.4.tar.gz (4.1 kB) Copy SHA256 hash SHA256 Source None Jul 26, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page