[tornado] Asynchronous botocore

AWS services and boto project are great things, but that we can't use them asynchronously in tornado is a big disadvantage.

This article inspired me to search for a way to use boto asynchronously:

I found that it is easy to rewrite code in botocore and use tornado AsyncHTTPClien instead of urllib.
The idea is to rewrite botocore.operation.call to make it uses tornado.httpclient.AsyncHTTPClient. After some experiments I got a simple wrapper for botocore that allows to use it in tornado asynchronously.

Repository: https://github.com/nanvel/tornado-botocore

PyPI: https://pypi.python.org/pypi/tornado-botocore


pip install tornado-botocore

Usage example:

from tornado.ioloop import IOLoop
from tornado_botocore import Botocore

def on_response(response):
    for reservation in response['Reservations']:
        for instance in reservation['Instances']:
            print instance['InstanceId']

if __name__ == '__main__':
    ec2 = Botocore(
        service='ec2', operation='DescribeInstances',

Another one:

def send(self, ...):
    ses_send_email = Botocore(
        service='ses', operation='SendEmail',
    source = 'example@mail.com'
    message = {
        'Subject': {
            'Data': 'Example subject'.decode('utf-8'),
        'Body': {
            'Html': {
                'Data': '<html>Example content</html>'.decode('utf-8'),
            'Text': {
                'Data': 'Example content'.decode('utf-8'),
    destination = {
        'ToAddresses': ['target@mail.com'],
    res = yield gen.Task(ses_send_email.call,
        Source=source, Message=message, Destination=destination)
    raise gen.Return(res)
Licensed under CC BY-SA 3.0