JT-Gmail 0.0.18

My Gmail API Wrapper

JT_Gmail

This is a simple interface for programmatically sending emails using the Gmail API.

pip install JT_Gmail

To get started you must create a project and enable the Gmail API, create OAuth2 credentials and download them in a json file.

Before you can use this module for the first time, you must run:

import JT_Gmail as gmail

gmail.GetToken('scope1', 'scope2', ..., email_address='[e-mail]', cred_path="path_to_your_credentials.json")

Supply the scopes you plan on using as *args. A list of all the scopes can be found here. Each function also includes the required scopes in its docstring.

This will prompt for authentication and generate the proper token to use the scopes you supplied. The token and credentials are saved for later use, so you might only have to run that line once. As you perform actions, if they need new permissions, they will be requested. Authentication will be required for each gmail user you wish to use.

To send emails, it's as easy as:

import JT_Gmail as gmail

with open("email.html") as file:
    gmail.SendHTMLEmail(
        sender='[e-mail]', 
        to="[e-mail]", 
        subject="Example Email", 
        message_html=file.read()
)

This was base heavily on code snippets supplied by Google.