Add LICENSE.txt

LICENSE.txt

@@ -0,0 +1,23 @@
+send_mail
+
+MIT License
+
+Copyright (c) 2023 Handmade Cities
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,45 @@
+------
+**DISCLAIMER: This project is very much a Work In Progress. It is for meetup hosts pioneering Handmade Meetups. Hosts are expected to be programmers who are comfortable running and editing command-line programs.**
+
+------
+`send_mail.py` lets you email a [meetup group](https://handmadecities.com/meetups) using Handmade Cities branding. 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
+The `send_mail` script is for Handmade meetup hosts. You can email a meetup invite to your 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 branding 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 (at handmadecities.com/meetups)
+## app.ini
+`send_mail` requires a companion `app.ini` file. It has the requisite secret credentials to be able to dump the mailing list and otherwise send the actual emails.
+
+Below is how the file looks like. Anything secret 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 whichever address is in TEST_EMAIL. Set it to true once you're ready to mass-email your entire meetup group.