Skip to main content

Introduction

Lambda API Decorators keeps AWS Lambda API declarations close to Python handlers.

The project has two packages:

  • lambda-api-decorators supplies lightweight, CDK-free decorators and runtime helpers. It is installed with the dependencies that are packaged into the Lambda and imported by its handlers.
  • lambda-api-decorators-cdk discovers those declarations and generates AWS Lambda and API Gateway infrastructure with AWS CDK. It is installed in the CDK application's environment.

These packages belong to different scopes. A CDK application needs lambda-api-decorators-cdk, while the deployed Lambda needs lambda-api-decorators; they do not need to be installed together in the same environment. The Getting Started guide shows the two dependency files separately.

Start with the Getting Started tutorial to create, deploy, and call a REST API from a new CDK project.

Then read Infrastructure as Decorators and Architecture to understand how declarations are discovered and turned into infrastructure. Continue with the Guides for focused usage and the API Reference for complete symbols. For the project's supported environments, known limitations, release model, and current scope, see Project.