Metadata-Version: 2.1
Name: mailshake
Version: 2.2
Summary: Dramatically simplify sending email from your python app.
Home-page: https://github.com/jpsca/mailshake
Author: Juan-Pablo Scaletti
Author-email: juanpablo@jpscaletti.com
License: Apache License Version 2.0
Project-URL: Issue tracker, https://github.com/jpsca/mailshake/issues
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Requires-Python: <4.0,>=3.6
Description-Content-Type: text/markdown
Requires-Dist: html2text
Provides-Extra: dev
Requires-Dist: flake8 ; extra == 'dev'
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: pytest-cov ; extra == 'dev'
Requires-Dist: tox ; extra == 'dev'
Provides-Extra: test
Requires-Dist: flake8 ; extra == 'test'
Requires-Dist: pytest ; extra == 'test'
Requires-Dist: pytest-cov ; extra == 'test'

![Mailshake logo](https://raw.github.com/jpsca/mailshake/master/docs/static/images/mailshake@2x.png)

# Mailshake

[![Build Status](https://travis-ci.org/jpsca/mailshake.svg?branch=master)](https://travis-ci.org/jpsca/mailshake)

Although Python makes sending email relatively easy via the smtplib
module, this library provides a couple of light wrappers over it.

These wrappers make sending email extra quick, easy to test email
sending during development, and provides support for platforms that
can't use SMTP.

Mailers availiable:

-   SMTPMailer
-   AmazonSESMailer
-   ToConsoleMailer (prints the emails in the console)
-   ToFileMailer (save the emails in a file)
-   ToMemoryMailer (for testing)
-   DummyMailer (does nothing)

Usage:

```python
from mailshake import SMTPMailer

mailer = SMTPMailer()
mailer.send(
    subject='Hi',
    text_content='Hello world!',
    from_email='from@example.com',
    to=['mary@example.com', 'bob@example.com']
)
```

You can also compose several messages and send them at the same time:

```python
from mailshake import SMTPMailer, EmailMessage

mailer = SMTPMailer()
messages = []

email_msg = EmailMessage(
    "Weekend getaway",
    "Here's a photo of us from our trip.",
    "from@example.com",
    "bob@example.com"
)
email_msg.attach_file("picture.jpg")
messages.append(email_msg)

#…

mailer.send_messages(*messages)
```

## Install for development

First, create an activate a virtualenv. eg:

```bash
python -m virtualenv .venv
source .venv/bin/activate
```

Then run `pip install -e .[dev]` or `make install`. This will install the library in editable mode and all its dependencies.


