SendGrid-django

Simple django backend to send email using SendGrid’s Web API.

Installation

Install the backend from PyPI:

pip install sendgrid-django

Add the following to your project’s settings.py:

EMAIL_BACKEND = "sgbackend.SendGridBackend"
SENDGRID_API_KEY = "Your SendGrid API Key"

Done!

Example

from django.core.mail import send_mail
from django.core.mail import EmailMultiAlternatives

send_mail("Your Subject", "This is a simple text email body.",
  "Yamil Asusta <hello@yamilasusta.com>", ["yamil@sendgrid.com"])

# or
mail = EmailMultiAlternatives(
  subject="Your Subject",
  body="This is a simple text email body.",
  from_email="Yamil Asusta <hello@yamilasusta.com>",
  to=["yamil@sendgrid.com"],
  headers={"Reply-To": "support@sendgrid.com"}
)
# Add template
mail.template_id = 'YOUR TEMPLATE ID FROM SENDGRID ADMIN'

# Replace substitutions in sendgrid template
mail.substitutions = {'%username%': 'elbuo8'}

# Attach file
with open('somefilename.pdf', 'rb') as file:
    mail.attachments = [
        ('somefilename.pdf', file.read(), 'application/pdf')
    ]

# Add categories
mail.categories = [
    'work',
    'urgent',
]

mail.attach_alternative(
    "<p>This is a simple HTML email body</p>", "text/html"
)

mail.send()

To create an instance of a SendGridBackend with an API key other than that provided in settings, pass api_key to the constructor

License

MIT

Enjoy :)

Development

Install dependencies::: pip install -r requirements-dev.txt
Run the tests with coverage::: pytest –cov=sgbackend
If you see the error “No module named sgbackend”, run::: pip install -e .

Release files for sendgrid-django 4.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sendgrid-django 4.2.0
File	Size	Uploaded
sendgrid-django-4.2.0.tar.gz	5.0 kB	Dec 19, 2017	Details

Release files / sendgrid-django-4.2.0.tar.gz

Download URL	sendgrid-django-4.2.0.tar.gz
Size	5.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`fef60ba37d588e5e1c4dcbb3b8b7f8c16920e3e89432de357f6abd6157c4f5f4`
BLAKE2b-256 checksum How to use checksums	`f5944749ff4acae2c2ca89c5acdf8449494ef4fbc4254a705866f07c6774ea8b`
Upload date	Dec 19, 2017
Uploaded using Trusted Publishing? What is trusted publishing?	No