Archived

This project has been archived by its maintainers, and is no longer receiving any updates.

Lambda powertools python layer

Why this project exists

This is a custom construct that will create AWS Lambda Layer with AWS Powertools for Python library. There are different ways how to create a layer and when working with CDK you need to install the library, create a zip file and wire it correctly. With this construct you don't have to care about packaging and dependency management, just create a construct and add it to your function. The construct is an extension of the existing LayerVersion construct from the CDK library, so you have access to all fields and methods.

See the API for details.

import { LambdaPowertoolsLayer } from 'cdk-lambda-powertools-python-layer';

const powertoolsLayer = new LambdaPowertoolsLayer(this, 'TestLayer');

Python

from cdk_lambda_powertools_python_layer import LambdaPowertoolsLayer

powertoolsLayer = LambdaPowertoolsLayer(self, 'PowertoolsLayer')

The layer will be created during the CDK synth step and thus requires Docker.

Install

TypeSript/JavaScript:

npm i cdk-lambda-powertools-python-layer

Python:

pip install cdk-lambda-powertools-python-layer

Usage

Python

A single line will create a layer with powertools for python:

from cdk_lambda_powertools_python_layer import LambdaPowertoolsLayer

powertoolsLayer = LambdaPowertoolsLayer(self, 'PowertoolsLayer')

You can then add the layer to your funciton:

from aws_cdk import aws_lambda

aws_lambda.Function(self, 'LambdaFunction',
                            code=aws_lambda.Code.from_asset('function'),
                            handler='app.handler',
                            runtime=aws_lambda.Runtime.PYTHON_3_9,
                            layers=[powertoolsLayer])

You can specify the powertools version by passing the optional version paramter, otherwise the construct will take the latest version from pypi repository.

LambdaPowertoolsLayer(self, 'PowertoolsLayer', version='1.24.0')

Additionally, powertools have extras depenedncies such as Pydantic, documented here. This is not included by default, and you have to set this option in the construct definition if you need it:

LambdaPowertoolsLayer(self, 'PowertoolsLayer', include_extras=True)

Full example:

from aws_cdk import Stack, aws_lambda
from cdk_lambda_powertools_python_layer import LambdaPowertoolsLayer
from constructs import Construct


class LayerTestStack(Stack):

    def __init__(self, scope: Construct, construct_id: str, **kwargs) -> None:
        super().__init__(scope, construct_id, **kwargs)

        powertoolsLayer = LambdaPowertoolsLayer(
            self, 'PowertoolsLayer', include_extras=True, version='1.24.0')

        aws_lambda.Function(self, 'LambdaFunction',
                            code=aws_lambda.Code.from_asset('function'),
                            handler='app.handler',
                            runtime=aws_lambda.Runtime.PYTHON_3_9,
                            layers=[powertoolsLayer])

TypeScript

Full example for TypeScript:

import { Stack, StackProps } from 'aws-cdk-lib';
import { Construct } from 'constructs';
import { LambdaPowertoolsLayer } from 'cdk-lambda-powertools-python-layer';
import { Code, Function, Runtime } from 'aws-cdk-lib/aws-lambda';
import * as path from 'path';

export class CdkPowertoolsExampleStack extends Stack {
  constructor(scope: Construct, id: string, props?: StackProps) {
    super(scope, id, props);

    const powertoolsLayer = new LambdaPowertoolsLayer(this, 'TestLayer', {
      version: '1.22.0',
      includeExtras: true
    });

    new Function(this, 'LambdaFunction', {
      code: Code.fromAsset(path.join('./function')),
      handler: 'app.handler',
      runtime: Runtime.PYTHON_3_9,
      layers: [powertoolsLayer],
    });
  }
}

Metadata

Release files for cdk-lambda-powertools-python-layer 2.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cdk-lambda-powertools-python-layer 2.1.0
File	Size	Uploaded
cdk-lambda-powertools-python-layer-2.1.0.tar.gz	27.8 kB	Aug 26, 2022	Details

Built distribution (wheel)

Table of built distributions (wheels) for cdk-lambda-powertools-python-layer 2.1.0
File	Interpreter	ABI	Platform	Reset
cdk_lambda_powertools_python_layer-2.1.0-py3-none-any.whl 26.8 kB Aug 26, 2022	Python 3	none	any	Details

Total release size: 54.7 kB

Release files / cdk-lambda-powertools-python-layer-2.1.0.tar.gz

Download URL	cdk-lambda-powertools-python-layer-2.1.0.tar.gz
Size	27.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`d149af5612e7873b731e6bb38d34de3c3e08f903deca8d997506e3f143798fd9`
BLAKE2b-256 checksum How to use checksums	`6be309506741dbb03f7b7394bcadcabee705c4f026bef4819be176050730d50f`
Upload date	Aug 26, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.1 CPython/3.10.6`

Release files / cdk_lambda_powertools_python_layer-2.1.0-py3-none-any.whl

Download URL	cdk_lambda_powertools_python_layer-2.1.0-py3-none-any.whl
Size	26.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`6cc82a33b90ecd46a51067e22b3323182189b312f293ab9061095b09de44ab73`
BLAKE2b-256 checksum How to use checksums	`8356ae55f7f99e3a075c889780827bf72c6284f06bf64324f6536d0dcb527666`
Upload date	Aug 26, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.1 CPython/3.10.6`