lambda-httpx 0.2

Installation

pip intall lambda-httpx

Usage Examples

Lambda-httpx provides a transport which can be mounted with the httpx client. This then relays over all requests with http+lambda:// to AWS lambda whose name matches the hostname.

Using from existing event loop:

import httpx
from lambda_httpx import AsyncLambdaTransport
# ...
async with AsyncLambdaTransport() as transport:
    mounts = {"http+lambda://": transport}
    async with httpx.AsyncClient(mounts=mounts) as client:
        response = await client.get("http+lambda://flaskexp-test/health")

Stand alone that calls endpoint 10 times asyncronously.

import asyncio
import httpx
from lambda_httpx import AsyncLambdaTransport

async def main(count):
    async with AsyncLambdaTransport() as transport:
        mounts = {"http+lambda://": transport}
        async with httpx.AsyncClient(mounts=mounts) as client:
            coros = [client.get("http+lambda://flaskexp-test/health") for _ in range(count)]
            return await asyncio.gather(*coros)

if __name__ == "__main__":
    loop = asyncio.get_event_loop()
    responses = loop.run_until_complete(main(10))
    print(responses)

A synchronous Transport also exists and can be utilized as follows:

import httpx
from lambda_httpx import LambdaTransport

with LambdaTransport() as transport:
    mounts = {"http+lambda://": transport}
    with httpx.Client(mounts=mounts) as client:
        response = client.get("http+lambda://flaskexp-test/health")
        print(response)

Lambda authorization is configured via boto3, and can be set up using environment variables or a configuration file. Configuration file is recommended. Example credential file ~/.aws/credentials:

[default]
aws_access_key_id =  XXXXXXXXXXXXXXXXXXXX
aws_secret_access_key = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Similar to authorization, region can be configured either via the environment variable AWS_DEFAULT_REGION, configuration file. Region can also be set on initialization of AsyncLambdaTransport(region=”us-west-2”). Example configuration file ~/.aws/config:

[profile default]
region = us-west-2

The lambdas must support proxy integration, which is used commonly by frameworks such as Zappa, Mangum.