Python library for reading IMAP mailboxes and converting email content to machine readable data
pip install imbox
or
git clone git@github.com:wckd/imbox.git
python setup.py install
from imbox import Imbox
imbox = Imbox('imap.gmail.com',
username='username',
password='password',
ssl=True)
# Gets all messages
all_messages = imbox.messages()
# Unread messages
unread_messages = imbox.messages(unread=True)
# Messages sent FROM
messages_from = imbox.messages(sent_from='martin@amon.cx')
# Messages sent TO
messages_from = imbox.messages(sent_to='martin@amon.cx')
# Messages received before specific date
messages_from = imbox.messages(date__lt='31-July-2013')
# Messages received after specific date
messages_from = imbox.messages(date__gt='30-July-2013')
# Messages from a specific folder
messages_folder = imbox.messages(folder='Social')
# Get messages in read-only mode
messages_folder = inbox.messages(folder='Social', readonly=True)
# Get all messages in all folders
from imbox import Imbox
imbox = Imbox('imap.gmail.com',
username=username,
password=password,
ssl=True)
boxlist = []
rc = imbox.connection.list()[1]
derp = [boxlist.append(rc[item].partition('"/"')[2].strip()) for item in range(len(rc))]
for box in boxlist:
messages = imbox.messages(folder=box, readonly=True)
for message in messages:
message = message[1]
print message.subject.encode('utf-8')
print message.cc # Returns None if empty
# Get all messages in selected folder
for message in all_messages:
........
# Every message is an object with the following keys
message = message[1]
message.sent_from
message.sent_to
message.subject
message.headers
message.message_id
message.date
message.body['plain']
message.body['html']
message.attachments
message.rfc822
message.gmsgid
message.gthrid
message.flags
# To check all available keys
print message.keys()
# To check the whole object, just write
print message[1]
{
'headers':
[{
'Name': 'Received-SPF',
'Value': 'pass (google.com: domain of ......;'
},
{
'Name': 'MIME-Version',
'Value': '1.0'
}],
'body': {
'plain: ['ASCII'],
'html': ['HTML BODY']
},
'attachments': [{
'content': <StringIO.StringIO instance at 0x7f8e8445fa70>,
'filename': "avatar.png",
'content-type': 'image/png',
'size': 80264
}],
'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'
}
- Lazy email fetching
- Improved attachement handling
- Search mailboxes
- Manage labels
- Delete emails
- Compose emails