simple-lambda

simple-lambda is a script that wraps around uv to publish simple scripts to AWS Lambda.

The core idea surrounds PEP-723 inline metadata scripts which uv has great support for.

Prerequisites

• uv: the intention is to use the install UV.
• aws cli configured.

Installation

Optional installation as a tool.

uv tool install simple-lambda

Use uvx simple-lambda if you don't want to install it as a tool.

Usage

Deploying a package

 Usage: simple-lambda deploy [OPTIONS] FUNCTION_NAME FILE_PATH                                                         
                                                                                                                       
╭─ Arguments ─────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ *    function_name      TEXT  [required]                                                                            │
│ *    file_path          FILE  Path to the main Python file containing the Lambda function handler. [required]       │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --help          Show this message and exit.                                                                         │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

Define the lambda function first via the UI or using something like terraform.

Create a script locally:

touch my_code.py

Add dependencies using UV:

uv add --script my_code.py requests

Optionally lock dependencies using UV:

uv lock --script my_code.py

Once you finish adding your code to the file. You can now deploy it:

uvx simple-lambda deploy lambda_function_name my_code.py

simple-lambda will automatically handle the dependencies based on the architecture and the runtime defined for the lambda function.

Build package only

If you only want to build the zip file, you can use the build command. You will however need to specify the architecture and python version.

 Usage: simple-lambda build [OPTIONS] FILE_PATH                                                                        
                                                                                                                       
╭─ Arguments ─────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ *    file_path      FILE  Path to the main Python file containing the Lambda function handler. [required]           │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ *  --architecture          [x86_64|arm64]  The target architecture of the lambda. [required]                        │
│    --output                FILE            Path to the output .zip file. [default: deployment_package.zip]          │
│    --python-version        TEXT            The Python version for the Lambda deployment package. [default: 3.13]    │
│    --help                                  Show this message and exit.                                              │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯