apig-wsgi

Wrap a WSGI application in an AWS Lambda handler function for running on API Gateway or an ALB.

A quick example:

from apig_wsgi import make_lambda_handler
from myapp.wsgi import app

# Configure this as your entry point in AWS Lambda
lambda_handler = make_lambda_handler(app)

Installation

Use pip:

pip install apig-wsgi

Python 3.5-3.7 supported.

Usage

make_lambda_handler(app, binary_support=False)

app should be a WSGI app, for example from Django's wsgi.py or Flask's Flask() object.

If you want to support sending binary responses, set binary_support to True. ALB's support binary responses by default, but on API Gateway you need to make sure you have '*/*' in the 'binary media types' configuration on your Rest API (whilst API Gateway supports a list of binary media types, using '*/*' is the best way to do it, since it is used to match the request 'Accept' header as well, which WSGI applications are likely to ignore).

Note that binary responses aren't sent if your response has a 'Content-Type' starting 'text/html' or 'application/json' - this is to support sending larger text responses.

If the event from API Gateway contains the requestContext key, for example from custom request authorizers, this will be available in the WSGI environ at the key apig_wsgi.request_context.