awslambdalocal 1.0.3

A tool to simulate running an AWS Lambda locally

py-lambda-local

awslambdalocal is a tool to simulate running an AWS Lambda locally, for lambda functions in Python.

Table of Contents

• Requirements
• Installation
• About: CLI
  • Positional Arguments
  • Optional Arguments
  • CLI Examples
• Tutorials
  • Debug Python in VSCode

Requirements

• Python => 3.8
• Poetry => 1.1.12 or another package manager that supports direct git dependencies

Install

To install awslambdalocal, we recommend adding it to your pyproject.toml in the dev-dependencies section as shown in the example below.

pip install awslambdalocal

Obs.: We recommend using Poetry. See https://python-poetry.org/docs/

About: CLI

Positional Arguments:

Argument	Description
lambda_path	Specify Lambda function file name.
event_path	Specify event data file name.

Optional Arguments:

Argument	Description
--help	Show this help message and exit
-h	Lambda function handler name. Default is "lambda_handler"
-t	Seconds until lambda function timeout. Default is 3 seconds
-p	Read the AWS profile of the file.
-r	Sets the AWS region, defaults to us-east-1.

CLI Examples

# Simple usage
pyhton -m awslambdalocal main.py test-event.json

# Input all arguments
pyhton -m awslambdalocal main.py test-event.json -p my_profile -r my_region -h lambda_handler -t 30

Tutorials

---

This session contains a collection of tutorials.

Debug Python in VSCode

To use vscode debug with awslambdalocal follow the steps below

1. Click run and debug

2. Click create a launch.json file

3. Choose Python

4. Choose Module

5. After this process, VSCode will create a file called launch.json in the .vscode folder located at the root of the project

6. Copy and paste the json below into the launch.json file, this file aims to call the awslambdalocal module and passes the necessary and optional parameters as arguments

   {
       // Use o IntelliSense para saber mais sobre os atributos possíveis.
       // Focalizar para exibir as descrições dos atributos existentes.
       // Para obter mais informações, acesse: https://go.microsoft.com/fwlink/?linkid=830387
       "version": "0.2.0",
       "configurations": [
           {
               "name": "Lambda Local",
               "type": "python",
               "request": "launch",
               "module": "awslambdalocal",
               "args": [
                   "file_python.py",
                   "your_test_event.json",
                   // Optional args ...
                   "-h",
                   "handler",
                   "-t",
                   "10",
                   "-p",
                   "your_profile",
                   "-r",
                   "us-east-1"
               ]
           }
       ]
   }