Sourced from aws-lambda-powertools's releases.

v3.3.0

Summary

In this release we added support for the newly released Python 3.13 AWS Lambda managed runtime 🚀.

We’ve also revamped the Parser documentation, and added MutualTLS scheme support when working with OpenAPI schemas and Event handler.

Oh hey, please welcome Ana as our new full-time maintainer - @​anafalcao 🎉

🌟 ⭐ Congrats to our new contributor @​Sector95 for getting their first PR merged.

Python 3.13 support

You can now use Powertools for AWS Lambda (Python) with the new Python 3.13 runtime in AWS Lambda.

We’ve partnered with the AWS Lambda team for this launch and have been testing our toolkit for the past few weeks to ensure compatibility with no changes from your side.

To start using Powertools for AWS with the new runtime, you can upgrade to this version via PyPi or use the latest version (v4) of our Lambda layers.

Parser documentation

Docs

In this release, we have improved the Parser documentation to include comprehensive examples of using this feature.

Kudos to @​anafalcao for this work and for her first merged PR 👏

Using MutualTLS in the OpenAPI schema

Docs

Customers now can use MutualTLS security scheme when defining their OpenAPI schema with Event Handler.

Last but not least, thanks to @​xkortex for catching a bug in the Parser utility.

Changes

🌟New features and non-breaking changes

• feat(runtime): add Python 3.13 support (#5527) by @​leandrodamascena
• feat(layers): introduce new CDK Python constructor for Powertools Lambda Layer (#5320) by @​leandrodamascena
• feat(event_handler): mutualTLS Security Scheme for OpenAPI (#5484) by @​Sector95

📜 Documentation updates

... (truncated)

Sourced from aws-lambda-powertools's changelog.

[v3.3.0] - 2024-11-14

Bug Fixes

• appsync: make contextual data accessible for async functions (#5317)
• ci: Update output to something easily copy/pasteable (#5435)
• ci: remove space (#5433)
• metrics: add warning for invalid dimension values; prevent their addition to EMF blobs (#5542)
• parameters: fix force_fetch feature when working with get_parameters (#5515)
• parser: support TypeAdapter instances as models (#5535)

Documentation

• layer: update layer version number - v3.2.0 (#5426)
• parser: change parser documentation (#5262)

Features

• event_handler: mutualTLS Security Scheme for OpenAPI (#5484)
• layers: introduce new CDK Python constructor for Powertools Lambda Layer (#5320)
• runtime: add Python 3.13 support (#5527)

Maintenance

• version bump
• ci: Bump CDK version to build layers and fix imports (#5555)
• ci: new pre-release 3.2.1a0 (#5434)
• ci: new pre-release 3.2.1a15 (#5551)
• ci: new pre-release 3.2.1a14 (#5545)
• ci: fix imports to build Lambda layer (#5557)
• ci: new pre-release 3.2.1a1 (#5443)
• ci: bump minimum required pydantic version (#5446)
• ci: new pre-release 3.2.1a2 (#5456)
• ci: new pre-release 3.2.1a12 (#5524)
• ci: new pre-release 3.2.1a3 (#5465)
• ci: new pre-release 3.2.1a4 (#5470)
• ci: new pre-release 3.2.1a5 (#5473)
• ci: new pre-release 3.2.1a11 (#5517)
• ci: new pre-release 3.2.1a6 (#5480)
• ci: new pre-release 3.2.1a7 (#5488)
• ci: new pre-release 3.2.1a10 (#5509)
• ci: new pre-release 3.2.1a8 (#5497)
• ci: new pre-release 3.2.1a9 (#5504)
• ci: new pre-release 3.2.1a13 (#5537)
• deps: bump pypa/gh-action-pypi-publish from 1.10.3 to 1.11.0 (#5477)
• deps: bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.15 to 3.0.16 (#5499)
• deps: bump actions/dependency-review-action from 4.3.4 to 4.3.5 (#5431)
• deps: bump actions/setup-python from 5.2.0 to 5.3.0 (#5529)
• deps: bump datadog-lambda from 6.99.0 to 6.100.0 (#5491)
• deps: bump actions/checkout from 4.2.1 to 4.2.2 (#5438)
• deps: bump actions/checkout from 4.2.0 to 4.2.2 (#5531)

... (truncated)

Sourced from aws-lambda-powertools's upgrade guide.

---

title: Upgrade guide description: Guide to update between major Powertools for AWS Lambda (Python) versions

Migrate to v3 from v2

!!! info "We strongly encourage you to migrate to v3. However, if you still need to upgrade from v1 to v2, you can find the upgrade guide."

We've made minimal breaking changes to make your transition to v3 as smooth as possible.

Quick summary

Area	Change	Code change required
Pydantic	We have removed support for Pydantic v1	No
Parser	We have replaced DynamoDBStreamModel AttributeValue with native Python types	Yes
Parser	We no longer export Pydantic objects from parser.pydantic.	Yes
Lambda layer	Lambda layers are now compiled according to the specific Python version and architecture	No
Event Handler	We have deprecated the get_header_value function.	Yes
Batch Processor	@batch_processor and @async_batch_processor decorators are now deprecated	Yes
Event Source Data Classes	We have updated default values for optional fields.	Yes
Parameters	The default cache TTL is now set to 5 minutes	No
Parameters	The config parameter is deprecated in favor of boto_config	Yes
JMESPath Functions	The extract_data_from_envelope function is deprecated in favor of query	Yes
Types file	We have removed the type imports from the shared/types.py file	Yes

First Steps

Before you start, we suggest making a copy of your current working project or create a new branch with git.

1. Upgrade Python to at least v3.8.
2. Ensure you have the latest version via Lambda Layer or PyPi{target="_blank"}.
3. Review the following sections to confirm if you need to make changes to your code.

Drop support for Pydantic v1

!!! note "No code changes required"

As of June 30, 2024, Pydantic v1 has reached its end-of-life, and we have discontinued support for this version. We now exclusively support Pydantic v2.

Use Pydantic v2 Migration Guide{target="_blank"} to migrate your custom Pydantic models to v2.

DynamoDBStreamModel in parser

!!! info "This also applies if you're using DynamoDB BatchProcessor{target="_blank"}."

DynamoDBStreamModel now returns native Python types when you access DynamoDB records through Keys, NewImage, and OldImage attributes.

... (truncated)

• 3da93e4 chore: version bump
• 6a6230e chore(ci): fix imports to build Lambda layer (#5557)
• 196ac7d chore(ci): Bump CDK version to build layers and fix imports (#5555)
• 6d07589 feat(runtime): add Python 3.13 support (#5527)
• b14ebdd chore(deps-dev): bump cdklabs-generative-ai-cdk-constructs from 0.1.279 to 0....
• e591f79 chore(deps-dev): bump boto3-stubs from 1.35.58 to 1.35.59 (#5549)
• bf8b528 chore(ci): new pre-release 3.2.1a15 (#5551)
• d1f7db6 chore(ci): changelog rebuild (#5546)
• ac64ea1 chore(ci): new pre-release 3.2.1a14 (#5545)
• f054880 chore(deps-dev): bump cfn-lint from 1.18.4 to 1.19.0 (#5544)
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)