A collection of useful decorators for making AWS Lambda handlers
Project description
A collection of useful decorators for making AWS Lambda handlers
NOTE: this is in very early stages of development. And only supports python3
lambda_decorators is a collection of useful decorators for writing Python handlers for AWS Lambda. They allow you to avoid boiler plate for common things such as CORS headers, JSON serialization, etc.
These can be used as a library or simply copied and adapted to your needs. If you want to write your own “middlewares” it’s as easy as writing a decorator. The documentation has links to the source of each decorator. They also serve as handy examples for implemenenting your own boilerplate-reducing decorators.
Quick example
# handler.py
from lambda_decorators import cors_headers, json_http_resp, load_json_body
@cors_headers
@json_http_resp
@load_json_body
def handler(event, context):
return {'hello': event['body']['name']}
When deployed to Lambda behind API Gateway and cURL’d:
$ curl -d '{"name": "world"}' https://example.execute-api.us-east-1.amazonaws.com/dev/hello
{"hello": "world"}
Install
pip install lambda-decorators
Why
Initially, I was inspired by middy which I’ve tried out in JavaScript and was happy with it. So naturally, I thought I’d like to have something similar in Python too. But then as I thought about it more, it seemed that when thinking of functions as the compute unit, when using python, decorators pretty much are middleware! So instead of building a middleware engine and a few middlewares, I just built a few useful decorators.
Included Decorators:
async_handler - support for async handlers
cors_headers - automatic injection of CORS headers
dump_json_body - auto-serialization of http body to JSON
json_http_resp - automatic serialization of python object to HTTP JSON response
load_json_body - auto-deserialize of http body from JSON
no_retry_on_failure - detect and stop retry attempts for scheduled lambdas
See each individual decorators for specific usage details and the example for some more use cases.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for lambda_decorators-0.1a2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 348e3aa3e92b2926ac82cc8a3982b090f560c03089ca1541f3256d01374c0a14 |
|
MD5 | b31d041d63c946243e08e13312f73de3 |
|
BLAKE2b-256 | 6d29279d12d3862612eacf39cb2a2908e7b1f624291b5c8c8404d8caaf986dd1 |