------
**DISCLAIMER: This project is very much a Work In Progress. It is for meetup hosts pioneering Handmade Meetups. Hosts are expected to be programmers comfortable with command-line programs. You can get help or give feedback in the [`#meetups`](https://discord.com/channels/239737791225790464/424523844016144394) channel of the [Handmade Network Discord](https://discord.gg/hmn).**
------
# send_mail
`send_mail` lets you email a [meetup group](https://handmadecities.com/meetups) using Handmade Cities branding. You can send an invite to your meetup group like so:

`> python3 send_mail.py --subject SUBJECT --body BODY`

where `SUBJECT` is the subject of your email and `BODY` is the file containing its contents. Plain text or HTML is supported. Your email will automatically include the Handmade Cities brand along with unsubscribe links!

Note that you can dump the mailing list of your meetup group so far:

`> python3 send_mail.py --dump`

This list grows automatically as more people sign up for your city.
## app.ini
`send_mail` requires a companion `app.ini` file. It has the secret credentials to be able to dump the mailing list and otherwise send real emails.

Below is how the file might look like. (Secret stuff is censored as `xxx`):

```
; User Constants - Update as needed
[DEFAULT]
LIVE        = false
TEST_EMAIL  = abner@terminal.click
SENDER_NAME = Abner Coimbre

; Handmade Cities Credentials - DON'T TOUCH
[hmc]
API_URL       = https://api.handmadecities.com/v1/meetups/subscribers
SHARED_SECRET = xxx
CITY          = Seattle

; Postmark App Credentials - NO TOUCHY TOUCHY
[postmark]
SERVER_TOKEN   = xxx
API_URL        = https://api.postmarkapp.com/email/batchWithTemplates
TEMPLATE_ID    = xxx
SENDER_EMAIL   = abner@handmadecities.com
MESSAGE_STREAM = xxx
```

`LIVE` is false by default, in which case the script only sends an email to `TEST_EMAIL`. Set `LIVE` to true when you're ready to mass-email your group.
## Known Issues
`send_mail` uses the `requests` module which may or may not be in your system. You'll need to use `pip` if it's not. See [this issue](https://git.handmadecities.com/meetups/send-mail/issues/2) for details.