mailgun2 0.1.6

A python client for Mailgun API v2

python-mailgun2
===============

[](https://pypi.python.org/pypi?:action=display&name=mailgun2)

[ ](https://codeship.com/projects/138455)
[](https://codeclimate.com/github/albertyw/python-mailgun2)
[](https://gemnasium.com/albertyw/python-mailgun2)

Originally at https://github.com/ZeroCater/python-mailgun2

A super simple Python API for interacting with [Mailgun](http://www.mailgun.com/).
Currently only supports sending messages. Powered by
[Requests](http://docs.python-requests.org/en/latest/).

Python 3 support should be there but is currently untested.

Installation
------------

```shell
pip install mailgun2
```

Usage
-----

```python
from mailgun2 import Mailgun
mailer = Mailgun('apikey', 'example.mailgun.org')
mailer.send_message(
'[e-mail]',
['[e-mail]', '[e-mail]'],
subject='Hi!',
text='Sweet.'
)
```

Required arguments:
```
from_email: string of email address to set as sender
to: list or string of email address to send to
```

Optional arguments:

```
subject: string subject of the email
text: string body of the email. Either text or html is required.
html: string HTML of the email. Either text or html is required.
cc: list of cc addresses.
bcc: list of bcc addresses.
tags: list of mailgun tags to associate with the email.
reply_to: Convenience argument for setting the Reply-To header
headers: Extra headers for messages
inlines: List of file paths to attach inline to the message
attachments: List of (file name, content type, file handle) as a multipart attachment
```

Pull requests welcome!