Skip to main content

Project overview

Lambda API Decorators keeps the declarations that shape an AWS Lambda API close to the Python handlers that implement it. Decorators describe routes, configuration, authentication intent, and resource permissions without replacing the handler or requiring the application code to construct AWS resources directly.

The project has two complementary layers:

  • The CDK-free lambda-api-decorators package records declarations on Python callables and provides runtime helpers.
  • The lambda-api-decorators-cdk package reads those declarations while an AWS CDK application is synthesized and turns them into Lambda and API Gateway resources and related configuration.

This relationship is the project’s working idea of Infrastructure as Decorators. It is a term that emerged from this project, not an established industry standard. The distinction from infrastructure ownership is important: your IaC application continues to own the stack, APIs, networks, roles, and other resources. Decorators describe how application code participates in that infrastructure; they do not replace the IaC source of truth.

AWS CDK is the backend implemented today. Other IaC backends, such as Pulumi, may be a possible future direction, but they are not supported functionality.

See Packages and repositories for the project map, Compatibility and status for the currently verified boundaries, and Contributing for repository-specific development commands.