# MarkdownMerge


<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->

## Install

`pip install markdown_merge`

## How to use

### Provide your SMTP server settings, e.g. for AWS SES

``` python
import os
```

``` python
servernm = 'email-smtp.us-west-2.amazonaws.com'
username = os.getenv('SES_SMTP_USER')
password = os.getenv('SES_SMTP_PASS')
smtp_cfg = dict(host=servernm, port=587, user=username, password=password, use_ssl=False, use_tls=True)
```

You can configure your SMTP server settings using the `smtp_cfg`
dictionary format shown above. The example uses AWS SES with environment
variables for credentials.

### Provide your email details

``` python
from_addr = get_addr('XXX@fastmail.com', 'Jeremy Howard')
to_addrs = [get_addr('douglas@example.com', 'Douglas Adams'),
            get_addr('cleese@example.com', 'John Cleese')]
inserts  = [{'special': "Thanks for all the fish."},
            {'special': "That was a silly walk."}]

msg = """## Hello there!

Here is your special message: *{special}*"""
```

``` python
ml = MarkdownMerge(to_addrs, from_addr, 'A message', msg, smtp_cfg=smtp_cfg, inserts=inserts, test=True)
```

The `test=True` parameter prints the messages instead of sending them.

### Send your messages

``` python
ml.send_msgs()
```

    To: Douglas Adams <douglas@example.com>
    ----------------------------------------
    ## Hello there!

    Here is your special message: *Thanks for all the fish.*
    ========================================

    To: John Cleese <cleese@example.com>
    ----------------------------------------
    ## Hello there!

    Here is your special message: *That was a silly walk.*
    ========================================
