lof 0.2.3

AWS Lambdas on FastAPI it is a Cli utilit that up & run your Python lambdas in local env based on AWS CloudFormation Template

AWS Lambdas on FastAPI - LoF

AWS Lambdas on FastAPI (LoF) is a command line tool that helps you fast & easy up & run your Python AWS Lambdas for tests and local development.

Pay attention, that this is only for Python lambdas.

It does not support any other programming languages.

How does it work?

Install

pip install lof

Now run lof & provide to it path to your template yaml file. Or you can run it from source dir with template.yaml without any args

How to use

lof

# or if path custom

lof --template example/template.yaml

You can choose that lambdas exclude from run by passing their names:

lof --template example/template.yaml --exclude=PostLambda2Function

To pass environment variables to Lambdas, use flag –env, you can pass variables in 2 formats - json format and ‘.env’ format. Both files as examples presented in example/ folder

lof --env=.env

# or

lof --env=vars.json

This mean, that lof will up & run all lambdas exclude this 2: PostTrafficHook & Roles

Demo

will be added soon

TODO

1. Add feature to call Authorizer & CORS lambdas handlers in local run.

2. Support JSON AWS Cloud Formation Template

Example

To try how LoF works you can use AWS CloudFormation template.yaml & Lambdas from example/ folder.

Issues & features request

Fill free to open Issues & report bugs. I will solve them as soon as possible.

Problem Context

On my current project I works a lot with AWS Lambdas & tries to up & run them with SAM local. And there is some issues especially when you work on the project with a big count of lambdas.

Some of them:

1. First of all it does not allow skip some lambdas form config

2. It build lambdas inside each docker container so it takes significant time to build/rebuild & up all containers (and you need up all containers if you want to have fast integration tests)

Both points in the mix make impossible to use SAM in weak developers envs like VDI, for example.

Changelog

v0.2.3

1. Possibility to send port & host to start several instances in same time.

v0.2.2

1. README.md is updated

2. Fixed Issue with lambdas in template, that does not have Events with Path (like S3 triggered lambdas)

3. Fixed issue with status code 204 - now it returns correct answer with no failes.

4. Added some tests

v0.2.1

1. Now LoF do not try/except lambdas errors

v0.2.0

1. Fixed status_code resend from lambda & JSON body response

v0.1.0

1. First version of Lambdas on FastApi. Based on AWS CloudFormation template it’s serve lambdas as FastAPI endpoints for local testing.