SendGrid's smtpapi library in Python
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
examples
smtpapi
static/img
test
.codeclimate.yml
.dockerignore
.env_sample
.gitignore
.travis.yml
CHANGELOG.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
Dockerfile
FIRST-TIMERS.md
LICENSE.txt
MANIFEST.in fixed Travis, converted README and version as file Oct 9, 2018
README.rst
TROUBLESHOOTING.md
USAGE.md
VERSION.txt
changes.py
docker-compose.yml
run.sh
setup.py

README.rst

SendGrid Logo

Travis Badge Email Notifications Badge Twitter Follow Codecov branch Python Versions PyPI Version GitHub contributors MIT Licensed

This module helps build SendGrid's SMTP API headers.

Learn more about the SMTP API at SendGrid documentation.

Announcements

All updates to this module is documented in our CHANGELOG.

Table of Contents

Installation

Prerequisites

  • Python version 2.6, 2.7, 3.4 or 3.5
  • The SendGrid service, starting at the free level

Install Package

pip install smtpapi

Setup Environment Variables

Update the development environment with your SENDGRID_API_KEY, for example:

cp .env_sample .env

In .env set SENDGRID_API_KEY to your own API key.

You can add your environment variables to your environment by sourcing the file:

source .env

Quick Start

from smtpapi import SMTPAPIHeader

header = SMTPAPIHeader()
header.add_to('email@email.com')
print(header.json_string())

Usage

Roadmap

If you are interested in the future direction of this project, please take a look at our milestones. We would love to hear your feedback.

How to Contribute

We encourage contribution to our projects, please see our CONTRIBUTING guide for details.

Quick links:

Local Setup of the Project

The simplest local development workflow is by using docker.

Steps:

  1. Install Docker
  2. Run docker-compose build (this builds the container)
  3. Run docker-compose up (this runs tests by default)

About

smtpapi-python is guided and supported by the SendGrid Developer Experience Team.

smtpapi-python is maintained and funded by SendGrid, Inc. The names and logos for smtpapi-python are trademarks of SendGrid, Inc.

License

The MIT License (MIT)