Metadata-Version: 2.1
Name: py-emails
Version: 0.0.2
Summary: Simple wrapper around email and smtplib for composing and sending email messages in an intuitive, simple interface.
Home-page: https://github.com/whitebarry/py-emails
Author: Barry Barrette
Author-email: barrybarrette@gmail.com
License: UNKNOWN
Description: # py-emails
        [![Build Status](https://travis-ci.org/whitebarry/py-emails.svg?branch=master)](https://travis-ci.org/whitebarry/py-emails)
        [![Coverage Status](https://coveralls.io/repos/github/whitebarry/py-emails/badge.svg)](https://coveralls.io/github/whitebarry/py-emails)
        
        
        Simple wrapper around `email` and `smtplib` for composing and sending email messages in an intuitive, simple interface.
        Pure python, no dependencies outside of the standard library
        
        
        ## Installation and use
        Install with pip or your favorite package manager: `pip install py-emails`
        
        
        Emails can be created declaratively:
        ```
        from emails import Email
        
        first_attachment = {
            'filename': 'example.png', 
            'content': open('example.png', 'rb').read()
        }
        other_attachment = {
            'filename': 'example.csv', 
            'content': open('example.csv', 'rb').read()
        }
        my_email = Email(
            sender='me@example.com', 
            subject='How are you?'
            body='Long time no see, we should get together!',
            attachments=[first_attachment, other_attachment]
        )
        ```
        
        Or using a template dictionary:
        ```
        from emails import from_template
        
        first_attachment = {
            'filename': 'example.png', 
            'content': open('example.png', 'rb').read()
        }
        other_attachment = {
            'filename': 'example.csv', 
            'content': open('example.csv', 'rb').read()
        }
        template = {
            'sender': 'me@example.com',
            'subject': 'How are you?',
            'body': 'Long time no see, we should get together!',
            'attachments': [first_attachment, other_attachment]
        }
        my_email = from_template(template)
        ```
        
        Once you have the email object, sending it is as simple as specifying recipient(s) and an SMTP host:
        
        ```
        recipients = ['person1@example.com', 'person2@example.com']
        my_email.send(recipients, 'smtp.example.com')
        my_email.send('person3@example.com', 'smtp.example.com')
        ```
        
        
Platform: UNKNOWN
Description-Content-Type: text/markdown
