AWS Lambda Powertools (Python)

Warnings

• breaking AWS Lambda Powertools v3.24.0 and later have dropped support for Python 3.9. Attempting to use these versions with a Python 3.9 runtime will result in errors.
  Fix: Upgrade your AWS Lambda function's runtime to Python 3.10 or newer. Python 3.14 is also supported from v3.23.0 onwards.
• gotcha Versions prior to v3.19.0 of AWS Lambda Powertools had critical bugs affecting Data validation and Middleware within the Event Handler utility, potentially leading to incorrect processing or validation errors.
  Fix: Upgrade to v3.19.0 or a later version to ensure correct behavior of Event Handler's data validation and middleware functionalities.
• gotcha A regression was introduced in v3.22.0 affecting the Event Handler utility when using nested metadata annotations (e.g., `annotated_types` or `Interval`).
  Fix: If you are using Event Handler with nested metadata annotations, upgrade to v3.22.1 or a later version to resolve this regression.
• gotcha AWS Lambda Powertools v3 is compatible with Pydantic V2. Users migrating from Pydantic V1 might need to update their model syntax (e.g., `model_validator` instead of `validator`) when using models with Event Handler or Parser utilities.
  Fix: Consult the Pydantic V2 migration guide and update your Pydantic models to adhere to the V2 syntax for seamless integration with Powertools.

Install

• pip install aws-lambda-powertools Install latest version

Imports

• Logger

  from aws_lambda_powertools import Logger

• Tracer

  from aws_lambda_powertools import Tracer

• Metrics

  from aws_lambda_powertools import Metrics

• App

  from aws_lambda_powertools.event_handler import App

  The 'App' class for Event Handler is a sub-utility and must be imported from `aws_lambda_powertools.event_handler`.
• Parser

  from aws_lambda_powertools.utilities.parser import Parser

• Idempotency

  from aws_lambda_powertools.utilities.idempotency import IdempotencyConfig, idempotent

Quickstart

This quickstart demonstrates the `Logger` utility, automatically enriching logs with Lambda context and logging the incoming event. It's designed to run in an AWS Lambda environment.

import json
from aws_lambda_powertools import Logger

logger = Logger(service="payment_processing")

@logger.inject_lambda_context(log_event=True)
def handler(event, context):
    # Accessing event data via a common pattern
    if event and 'body' in event:
        try:
            body = json.loads(event['body'])
            transaction_id = body.get('transaction_id', 'N/A')
            logger.info(f"Processing transaction: {transaction_id}")
        except json.JSONDecodeError:
            logger.error("Invalid JSON in event body")
            return {"statusCode": 400, "body": json.dumps({"message": "Invalid JSON"})}
    else:
        logger.info("No event body provided.")

    logger.info("Hello from Lambda, using Powertools Logger!")
    return {
        "statusCode": 200,
        "body": json.dumps("Successfully processed request."),
    }