email-draft-generator 0.0.1

A utility to generate E-mail drafts from a list of E-mail addresses.

Email Generator

Installation

Download the latest release as a tar.gz file.

Setup

Set up the Google API

Follow the guide at https://developers.google.com/gmail/api/quickstart/python#set_up_your_environment to generate OAuth2 credentials, and, when you are at the step to configure the OAuth consent screen, add the gmail.compose scope so the script can edit drafts. Download them into .credentials/credentials.json (you will have to create this directory yourself, and show hidden files to see it on MacOS).

Set up the template

• update the email template in email_generator/email_creator.py
• put the file paths to any attachments in the attachment_paths list in email_generator/main.py

Build program

Run setup.sh (can be run by simply double-clicking on the file) If you make any changes to the template after this, run setup.sh again.

Usage

Prepare data

• copy and paste the table into email-template.txt
• make sure there is nothing else in the file
• save it

Run the program

Run run.sh (can be run by double-clicking as well) The first time it is run, you will need to authenticate with the account that you want to upload the drafts to. A browser window should be opened automatically to do this in (if it is not, copy and paste the URL from the terminal window into your browser). The authentication flow may not work in Firefox or other Gecko-based browsers, so try Chrome, Safari, or another Chromium- or Webkit-based browser if it doesn't work for you.

Building from source

Install the build tool with pip and run python3 -m build to build the package.