Skip to main content

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.

Files for mailbox, version 0.4
Filename, size File type Python version Upload date Hashes
Filename, size mailbox-0.4.tar.gz (4.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page