Sourced from aws-lambda-powertools's releases.

v3.22.1

Summary

In this release, we fixed a regression introduced by [PR #7227](aws-powertools/powertools-lambda-python#7227) that affected customers using the Event Handler utility with nested metadata annotations such as annotated_types or Interval. Thanks to @​rtandy for identifying the bug and validating the fix.

We also fixed small bugs in type annotations and in our documentation.

⭐ Congrats @​rpivo and @​czechnology for contributing to this project for the first time!

Changes

• fix(typing): Fix type of Metrics.set_timestamp argument (#7582) by @​czechnology

📜 Documentation updates

• docs(batch): fix error handling code highlight line number (#7638) by @​ConnorKirk
• docs(tracer): fix typo in the tracer documentation (#7617) by @​rpivo

🐛 Bug and hot fixes

• fix(event-handler): preserve metadata constraints in parameter validation (#7609) by @​leandrodamascena
• fix(batch): ensure Python 3.14 compatibility for async event loop handling (#7599) by @​leandrodamascena

🔧 Maintenance

• chore(deps): bump docker/setup-qemu-action from 3.6.0 to 3.7.0 (#7639) by @dependabot[bot]
• chore(deps-dev): bump types-protobuf from 6.32.1.20250918 to 6.32.1.20251105 (#7640) by @dependabot[bot]
• chore(deps): bump pydantic from 2.12.3 to 2.12.4 (#7641) by @dependabot[bot]
• chore(deps): bump mkdocs-material from 9.6.22 to 9.6.23 (#7630) by @dependabot[bot]
• chore(deps-dev): bump pytest-benchmark from 5.2.0 to 5.2.1 (#7629) by @dependabot[bot]
• chore(deps-dev): bump cfn-lint from 1.40.3 to 1.40.4 (#7632) by @dependabot[bot]
• chore(deps-dev): bump aws-cdk-aws-lambda-python-alpha from 2.221.1a0 to 2.222.0a0 (#7628) by @dependabot[bot]
• chore(deps-dev): bump aws-cdk-lib from 2.221.1 to 2.222.0 (#7631) by @dependabot[bot]
• chore(deps): bump squidfunk/mkdocs-material from f5c556a to 58dee36 in /docs (#7622) by @dependabot[bot]
• chore(deps): bump mkdocs-material from 9.6.22 to 9.6.23 (#7624) by @dependabot[bot]
• chore(event_handler): fix typos in api_gateway.py file (#7619) by @​mahveotm
• chore(deps-dev): bump hvac from 2.3.0 to 2.4.0 (#7602) by @dependabot[bot]
• chore(deps-dev): bump ruff from 0.14.2 to 0.14.3 (#7610) by @dependabot[bot]
• chore(deps-dev): bump boto3-stubs from 1.40.61 to 1.40.64 (#7611) by @dependabot[bot]
• chore(deps-dev): bump pytest-benchmark from 5.1.0 to 5.2.0 (#7606) by @dependabot[bot]
• chore(deps-dev): bump aws-cdk from 2.1031.0 to 2.1031.1 (#7601) by @dependabot[bot]
• chore(deps-dev): bump cdklabs-generative-ai-cdk-constructs from 0.1.311 to 0.1.312 (#7605) by @dependabot[bot]
• chore(deps): bump aws-xray-sdk from 2.14.0 to 2.15.0 (#7603) by @dependabot[bot]
• chore(deps-dev): bump sentry-sdk from 2.42.1 to 2.43.0 (#7594) by @dependabot[bot]
• chore(deps-dev): bump aws-cdk-aws-lambda-python-alpha from 2.221.0a0 to 2.221.1a0 (#7593) by @dependabot[bot]
• chore(deps-dev): bump boto3-stubs from 1.40.60 to 1.40.61 (#7590) by @dependabot[bot]
• chore(deps-dev): bump cfn-lint from 1.40.2 to 1.40.3 (#7585) by @dependabot[bot]
• chore(deps-dev): bump boto3-stubs from 1.40.59 to 1.40.60 (#7587) by @dependabot[bot]
• chore(deps): bump redis from 7.0.0 to 7.0.1 (#7586) by @dependabot[bot]
• chore(deps-dev): bump ruff from 0.14.1 to 0.14.2 (#7575) by @dependabot[bot]

... (truncated)

Sourced from aws-lambda-powertools's changelog.

[v3.22.1] - 2025-11-05

Bug Fixes

• batch: ensure Python 3.14 compatibility for async event loop handling (#7599)
• event-handler: preserve metadata constraints in parameter validation (#7609)
• typing: Fix type of Metrics.set_timestamp argument (#7582)

Documentation

• tracer: fix typo in the tracer documentation (#7617)

Maintenance

• version bump
• ci: new pre-release 3.22.1a0 (#7567)
• ci: new pre-release 3.22.1a1 (#7583)
• ci: new pre-release 3.22.1a8 (#7633)
• ci: new pre-release 3.22.1a2 (#7588)
• ci: new pre-release 3.22.1a7 (#7625)
• ci: new pre-release 3.22.1a6 (#7615)
• ci: new pre-release 3.22.1a4 (#7597)
• ci: new pre-release 3.22.1a3 (#7591)
• ci: new pre-release 3.22.1a5 (#7607)
• deps: bump mkdocs-material from 9.6.22 to 9.6.23 (#7630)
• deps: bump squidfunk/mkdocs-material from f5c556a to 58dee36 in /docs (#7622)
• deps: bump aws-xray-sdk from 2.14.0 to 2.15.0 (#7603)
• deps: bump actions/upload-artifact from 4.6.2 to 5.0.0 (#7578)
• deps: bump redis from 6.4.0 to 7.0.0 (#7570)
• deps: bump actions/download-artifact from 5.0.0 to 6.0.0 (#7577)
• deps: bump mkdocs-material from 9.6.22 to 9.6.23 (#7624)
• deps: bump redis from 7.0.0 to 7.0.1 (#7586)
• deps-dev: bump boto3-stubs from 1.40.60 to 1.40.61 (#7590)
• deps-dev: bump pytest-benchmark from 5.1.0 to 5.2.0 (#7606)
• deps-dev: bump cdklabs-generative-ai-cdk-constructs from 0.1.311 to 0.1.312 (#7605)
• deps-dev: bump cfn-lint from 1.40.2 to 1.40.3 (#7585)
• deps-dev: bump boto3-stubs from 1.40.59 to 1.40.60 (#7587)
• deps-dev: bump aws-cdk-lib from 2.221.1 to 2.222.0 (#7631)
• deps-dev: bump hvac from 2.3.0 to 2.4.0 (#7602)
• deps-dev: bump aws-cdk-aws-lambda-python-alpha from 2.221.0a0 to 2.221.1a0 (#7593)
• deps-dev: bump ruff from 0.14.1 to 0.14.2 (#7575)
• deps-dev: bump boto3-stubs from 1.40.55 to 1.40.59 (#7579)
• deps-dev: bump sentry-sdk from 2.42.1 to 2.43.0 (#7594)
• deps-dev: bump aws-cdk-aws-lambda-python-alpha from 2.220.0a0 to 2.221.0a0 (#7580)
• deps-dev: bump ruff from 0.14.2 to 0.14.3 (#7610)
• deps-dev: bump boto3-stubs from 1.40.61 to 1.40.64 (#7611)
• deps-dev: bump aws-cdk from 2.1030.0 to 2.1031.0 (#7569)
• deps-dev: bump aws-cdk-aws-lambda-python-alpha from 2.221.1a0 to 2.222.0a0 (#7628)
• deps-dev: bump cfn-lint from 1.40.3 to 1.40.4 (#7632)
• deps-dev: bump pytest-benchmark from 5.2.0 to 5.2.1 (#7629)
• deps-dev: bump aws-cdk from 2.1031.0 to 2.1031.1 (#7601)

... (truncated)

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

---

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

End of support v2

!!! warning "On March 25st, 2025, Powertools for AWS Lambda (Python) v2 reached end of support and will no longer receive updates or releases. If you are still using v2, we strongly recommend you to read our upgrade guide and update to the latest version."

Given our commitment to all of our customers using Powertools for AWS Lambda (Python), we will keep Pypi{target="_blank"} v2 releases and documentation 2.x versions to prevent any disruption.

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.9.
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.

... (truncated)

• f6bc9d9 chore: version bump
• 41dd01d chore(ci): new pre-release 3.22.1a8 (#7633)
• 3e45ae1 chore(deps): bump mkdocs-material from 9.6.22 to 9.6.23 (#7630)
• 5935689 chore(deps-dev): bump pytest-benchmark from 5.2.0 to 5.2.1 (#7629)
• 6a2beb2 chore(deps-dev): bump cfn-lint from 1.40.3 to 1.40.4 (#7632)
• 89582fe chore(deps-dev): bump aws-cdk-aws-lambda-python-alpha from 2.221.1a0 to 2.222...
• 0db6ce5 chore(deps-dev): bump aws-cdk-lib from 2.221.1 to 2.222.0 (#7631)
• 29f9232 chore(ci): changelog rebuild (#7626)
• 2236dee chore(deps): bump squidfunk/mkdocs-material from f5c556a to 58dee36 in /d...
• 839ad3e chore(deps): bump mkdocs-material from 9.6.22 to 9.6.23 (#7624)
• 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)