Python support

Pants can create a Lambda-compatible zip file from your Python code, allowing you to develop your Lambdas in your repository instead of using the online Cloud9 editor.

📘

Example repository

See the Python example repository for an example of creating an AWS Lambda from Python code.

📘

FYI: how Pants does this

Under-the-hood, Pants uses the Lambdex project. First, Pants will convert your code into a Pex file. Then, Pants will use Lambdex to convert the Pex into a zip file understood by AWS.

Step 1: Activate the Python AWS Lambda backend

Add this to your pants.toml:

[GLOBAL]
backend_packages2.add = [
  "pants.backend.awslambda.python",
  "pants.backend.python",
]

This adds the new python_awslambda target and the awslambda goal, which you can confirm by running <<pantscmd>> target-types --details=python_awslambda and <<pantscmd>> goals.

Step 2: Define a python_awslambda target

First, add your lambda function in Python like you would normally do with AWS Lambda. Specifically, create a function def handler_name(event, context).

Then, in your BUILD file, create a python_awslambda target and define the runtime and handler fields. The runtime should be one of the values from https://docs.aws.amazon.com/lambda/latest/dg/lambda-python.html. The handler has the form module.dotted.name:handler_func.

For example:

python_awslambda(
    sources=["awslambda_example.py"],
    runtime="python3.8",
    handler="project:example_handler",
)

def example_handler(event, context):
    print("Hello AWS!")

Step 3: Run awslambda

Now run <<pantscmd>> awslambda on your python_awslambda target to create a zipped file.

For example:

$ <<pantscmd>> awslambda project/awslambda_example.py
Wrote code bundle to dist/project.zip
  Runtime: python3.8
  Handler: lambdex_handler.handler

🚧

Running from macOS and failing to build?

AWS Lambdas must run on Linux, so Pants tells PEX and Pip to build for Linux when resolving your third party dependencies. This means that you can only use pre-built wheels (bdists). If your project requires any source distributions (sdists) that must be built locally, PEX and Pip will fail to run.

If this happens, you must either change your dependencies to only use dependencies with pre-built wheels or find a Linux environment to run <<pantscmd>> awslambda.

Step 4: Upload to AWS

You can use any of the various AWS methods to upload your zip file, such as the AWS console or the AWS CLI via aws lambda create-function and aws lambda update-function-code.

You must specify the AWS lambda handler as lambdex_handler.handler.