aiohttp-sendgrid

aiohttp-sendgrid

.. image:: https://travis-ci.org/Kurlov/aiohttp-sendgrid.svg?branch=master :target: https://travis-ci.org/Kurlov/aiohttp-sendgrid .. image:: https://badge.fury.io/py/aiohttp-sendgrid.svg :target: https://badge.fury.io/py/aiohttp-sendgrid

SendGrid mail API wrapper

Installation

pip install aiohttp_sendgrid

Usage

Create an instance of API client:

.. code:: python

import asyncio
from aiohttp_sendgrid import Sendgrid
api_key = '<your_sendgrid_api_key>'
mailer = Sendgrid(api_key=api_key)

Important to note that if api_key is not provided then it will try to read SENDGRID_API_KEY environment variable

Send email to single recipient

.. code:: python

to = '[e-mail]'
sender = '[e-mail]'
subject = 'greetings'
content = '<h1>Hello</h1>'
send_mail = mailer.send(to, sender, subject, content)
loop = asyncio.get_event_loop()
loop.run_until_complete(send_mail)

Both to and sender might be also a dictionary with email key, if you want to specify name for sender or recipient then add name key to the dictionary. Thus, to = {'email': '[e-mail]', 'name': 'Recipient'} is also a correct value.

Send single email to multiple recipients

.. code:: python

to = ['[e-mail]', 'another@example']
sender = '[e-mail]'
subject = 'greetings'
content = '<h1>Hello</h1>'
send_mail = mailer.send(to, sender, subject, content)
loop = asyncio.get_event_loop()
loop.run_until_complete(send_mail)

to might be tuple or list of strings or dictionaries.