mangum 0.3.0

ASGI serverless adapters

Mangum

Mangum is a library for adapting ASGI applications to use on FaaS platforms.

Important: This project is under active development and in an experimental/unstable state.

Supported Platforms

• AWS Lambda + API Gateway
• Azure Functions

Requirements

Python 3.6+

Installation

pip3 install mangum

Dependencies

Currently the only optional dependency is:

• azure-functions - Required for azure_handler.

Example

Below is a basic ASGI application example that can be used with handler methods:

class App:
    def __init__(self, scope) -> None:
        self.scope = scope

    async def __call__(self, receive, send) -> None:
        message = await receive()
        if message["type"] == "http.request":
            await send(
                {
                    "type": "http.response.start",
                    "status": 200,
                    "headers": [[b"content-type", b"text/plain"]],
                }
            )
            await send({"type": "http.response.body", "body": b"Hello, world!"})

AWS Lambda + API Gateway

from mangum.handlers.aws import aws_handler

def asgi_handler(event, context):
    return aws_handler(App, event, context)

Azure Functions

from mangum.handlers.azure import azure_handler

def asgi_handler(req):
    return azure_handler(App, req)