ad085d9b82
The new ImapTransport parameter ssl_context replaces the usesslcontext parameter and allows the user to supply their own ssl context object. If ssl_context is not given, but ssl is true, python's default ssl context is used. That default context is the one that actually does some certificate checks, such as whether the hostname matches the names given in the server's certificate and not the default context used by IMAP4_SSL when instantiated with ssl_context=None which does not certificate checks at all. The Imbox class is extended with the same ssl_context parameter which is simply passed through to ImapTransport. This commit together with the previous commits from Dustin Demuth changes Imbox in a slightly incompatible way: SSL-Certificates are now checked by default whereas before they were not checked at all. This improves security substantially but users need to be aware that working programs might start raising exceptions due to failing certificate checks.
Imbox - Python IMAP for Humans
Python library for reading IMAP mailboxes and converting email content to machine readable data
Installation
pip install imbox
Usage
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')
for uid, 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.body.plain
message.body.html
message.attachments
# 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'
}],
'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'
}
Roadmap
- Lazy email fetching
- Improved attachement handling
- Search mailboxes
- Manage labels
- Delete emails
- Compose emails