Metadata-Version: 1.0
Name: imbox
Version: 0.5.5
Summary: Python IMAP for Human beings
Home-page: https://github.com/martinrusev/imbox
Author: Martin Rusev
Author-email: martinrusev@live.com
License: MIT
Description: Imbox - Python IMAP for Humans
        =======
        
        [![Circle CI](https://circleci.com/gh/martinrusev/imbox/tree/master.png?circle-token=6d644013ad6c82223a952f018526aec416eeddc4)](https://circleci.com/gh/martinrusev/imbox)
        
        
        Python library for reading IMAP mailboxes and converting email content to machine readable data
        
        Installation
        ============
        
        	pip install imbox
        
        
        or 
        
        	git clone git@github.com:martinrusev/imbox.git
        	python setup.py install
        
        
        Usage 
        =====
        
        ```python
        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 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
        
        
Keywords: email,IMAP,parsing emails
Platform: UNKNOWN
