diff --git a/.cfnlintrc.yaml b/.cfnlintrc.yaml
new file mode 100644
index 00000000000..3909b9bb437
--- /dev/null
+++ b/.cfnlintrc.yaml
@@ -0,0 +1,2 @@
+ignore_templates:
+ - examples/event_handler_appsync_events/sam/getting_started_with_appsync_events.yaml
diff --git a/.chglog/CHANGELOG.tpl.md b/.chglog/CHANGELOG.tpl.md
index b8919554b80..beb340ad645 100755
--- a/.chglog/CHANGELOG.tpl.md
+++ b/.chglog/CHANGELOG.tpl.md
@@ -10,7 +10,9 @@
## {{ .Title }}
{{ range .Commits -}}
+{{ if and (not (hasPrefix .Subject "changelog rebuild")) (not (hasPrefix .Subject "layer docs update")) (not (hasPrefix .Subject "bump version to")) -}}
* {{ if .Scope }}**{{ .Scope }}:** {{ end }}{{ .Subject }}
+{{ end -}}
{{ end }}
{{ end -}}
{{ end -}}
@@ -24,7 +26,9 @@
## {{ .Title }}
{{ range .Commits -}}
+{{ if and (not (hasPrefix .Subject "changelog rebuild")) (not (hasPrefix .Subject "layer docs update")) (not (hasPrefix .Subject "bump version to")) -}}
* {{ if .Scope }}**{{ .Scope }}:** {{ end }}{{ .Subject }}
+{{ end -}}
{{ end }}
{{ end -}}
diff --git a/.chglog/config.yml b/.chglog/config.yml
index 21577651526..9ec1c8ef31e 100755
--- a/.chglog/config.yml
+++ b/.chglog/config.yml
@@ -2,7 +2,7 @@ style: github
template: CHANGELOG.tpl.md
info:
title: CHANGELOG
- repository_url: https://github.com/awslabs/aws-lambda-powertools-python
+ repository_url: https://github.com/aws-powertools/powertools-lambda-python
options:
commits:
filters:
diff --git a/.clusterfuzzlite/Dockerfile b/.clusterfuzzlite/Dockerfile
new file mode 100644
index 00000000000..19d3018f3ac
--- /dev/null
+++ b/.clusterfuzzlite/Dockerfile
@@ -0,0 +1,12 @@
+FROM gcr.io/oss-fuzz-base/base-builder-python
+
+# Copy project source
+COPY . $SRC/powertools
+
+WORKDIR $SRC/powertools
+
+# Install project dependencies
+RUN pip3 install -e ".[all]"
+
+# Copy build script
+COPY .clusterfuzzlite/build.sh $SRC/
diff --git a/.clusterfuzzlite/build.sh b/.clusterfuzzlite/build.sh
new file mode 100644
index 00000000000..e5aadd80335
--- /dev/null
+++ b/.clusterfuzzlite/build.sh
@@ -0,0 +1,6 @@
+#!/bin/bash -eu
+
+# Build fuzz targets from tests/fuzz/
+for fuzzer in $(find $SRC/powertools/tests/fuzz -name 'fuzz_*.py'); do
+ compile_python_fuzzer "$fuzzer"
+done
diff --git a/.clusterfuzzlite/project.yaml b/.clusterfuzzlite/project.yaml
new file mode 100644
index 00000000000..de5f07bb82a
--- /dev/null
+++ b/.clusterfuzzlite/project.yaml
@@ -0,0 +1,4 @@
+language: python
+main_repo: https://github.com/aws-powertools/powertools-lambda-python
+sanitizers:
+ - address
diff --git a/.flake8 b/.flake8
index c7d6486ed48..1db8406d9e4 100644
--- a/.flake8
+++ b/.flake8
@@ -3,9 +3,11 @@ exclude = docs, .eggs, setup.py, example, .aws-sam, .git, dist, *.md, *.yaml, ex
ignore = E203, E266, W503, BLK100, W291, I004
max-line-length = 120
max-complexity = 15
+; flake8-builtins isn't honouring inline ignore (A003)
per-file-ignores =
tests/e2e/utils/data_builder/__init__.py:F401
tests/e2e/utils/data_fetcher/__init__.py:F401
+ aws_lambda_powertools/utilities/data_classes/s3_event.py:A003
[isort]
multi_line_output = 3
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
index d41dd7086a3..1062320f5b1 100644
--- a/.github/CODEOWNERS
+++ b/.github/CODEOWNERS
@@ -1,3 +1,3 @@
# https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
-* @awslabs/aws-lambda-powertools-python
+* @aws-powertools/lambda-python-core
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index 6d441bf0c64..21a8f3b035c 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -8,7 +8,7 @@ body:
value: |
Thank you for submitting a bug report. Please add as much information as possible to help us reproduce, and remove any potential sensitive data.
- Please become familiar with [our definition of bug](https://github.com/awslabs/aws-lambda-powertools-python/blob/develop/MAINTAINERS.md#is-that-a-bug).
+ Please become familiar with [our definition of bug](https://github.com/aws-powertools/powertools-lambda-python/blob/develop/MAINTAINERS.md#is-that-a-bug).
- type: textarea
id: expected_behaviour
attributes:
@@ -48,7 +48,7 @@ body:
- type: input
id: version
attributes:
- label: AWS Lambda Powertools for Python version
+ label: Powertools for AWS Lambda (Python) version
placeholder: "latest, 1.25.6"
value: latest
validations:
@@ -58,10 +58,11 @@ body:
attributes:
label: AWS Lambda function runtime
options:
- - 3.6
- - 3.7
- - 3.8
- - 3.9
+ - "3.10"
+ - "3.11"
+ - "3.12"
+ - "3.13"
+ - "3.14"
validations:
required: true
- type: dropdown
@@ -79,7 +80,7 @@ body:
id: logs
attributes:
label: Debugging logs
- description: If available, please share [debugging logs](https://awslabs.github.io/aws-lambda-powertools-python/#debug-mode)
+ description: If available, please share [debugging logs](https://docs.powertools.aws.dev/lambda/python/#debug-mode)
render: python
validations:
required: false
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index e6afc9082e9..8acf5081f3b 100644
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -1,5 +1,5 @@
blank_issues_enabled: false
contact_links:
- name: Ask a question
- url: https://github.com/awslabs/aws-lambda-powertools-python/discussions/new
+ url: https://github.com/aws-powertools/powertools-lambda-python/discussions/new
about: Ask a general question about Lambda Powertools
diff --git a/.github/ISSUE_TEMPLATE/documentation_improvements.yml b/.github/ISSUE_TEMPLATE/documentation_improvements.yml
index d48fb4fd379..e750d51923f 100644
--- a/.github/ISSUE_TEMPLATE/documentation_improvements.yml
+++ b/.github/ISSUE_TEMPLATE/documentation_improvements.yml
@@ -26,7 +26,6 @@ body:
attributes:
label: How can we improve?
description: Please share your thoughts on how we can improve this experience
- render: markdown
validations:
required: true
- type: textarea
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
index e7fbd3906b1..a39fb211ac1 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.yml
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -1,12 +1,12 @@
name: Feature request
-description: Suggest an idea for Lambda Powertools
+description: Suggest an idea for Powertools for AWS Lambda (Python)
title: "Feature request: TITLE"
labels: ["feature-request", "triage"]
body:
- type: markdown
attributes:
value: |
- Thank you for taking the time to suggest an idea to the Lambda Powertools project.
+ Thank you for taking the time to suggest an idea to the Powertools for AWS Lambda (Python) project.
*Future readers*: Please react with 👍 and your use case to help us understand customer demand.
- type: textarea
@@ -36,9 +36,9 @@ body:
attributes:
label: Acknowledgment
options:
- - label: This feature request meets [Lambda Powertools Tenets](https://awslabs.github.io/aws-lambda-powertools-python/latest/#tenets)
+ - label: This feature request meets [Powertools for AWS Lambda (Python) Tenets](https://docs.powertools.aws.dev/lambda/python/latest/#tenets)
required: true
- - label: Should this be considered in other Lambda Powertools languages? i.e. [Java](https://github.com/awslabs/aws-lambda-powertools-java/), [TypeScript](https://github.com/awslabs/aws-lambda-powertools-typescript/)
+ - label: Should this be considered in other Powertools for AWS Lambda languages? i.e. [Java](https://github.com/aws-powertools/powertools-lambda-java/), [TypeScript](https://github.com/aws-powertools/powertools-lambda-typescript/), and [.NET](https://github.com/aws-powertools/powertools-lambda-dotnet/)
required: false
- type: markdown
attributes:
diff --git a/.github/ISSUE_TEMPLATE/maintenance.yml b/.github/ISSUE_TEMPLATE/maintenance.yml
index 2f60a0f013a..bbc3ff3b3d8 100644
--- a/.github/ISSUE_TEMPLATE/maintenance.yml
+++ b/.github/ISSUE_TEMPLATE/maintenance.yml
@@ -1,5 +1,5 @@
name: Maintenance
-description: Suggest an activity to help address tech debt, governance, and anything internal
+description: Suggest an activity to help address governance and anything internal
title: "Maintenance: TITLE"
labels: ["internal", "triage"]
body:
@@ -9,13 +9,6 @@ body:
Thank you for taking the time to help us improve operational excellence.
*Future readers*: Please react with 👍 and your use case to help us understand customer demand.
- - type: textarea
- id: activity
- attributes:
- label: Summary
- description: Please provide an overview in one or two paragraphs
- validations:
- required: true
- type: textarea
id: importance
attributes:
@@ -29,8 +22,6 @@ body:
label: Which area does this relate to?
multiple: true
options:
- - Automation
- - Governance
- Tests
- Static typing
- Tracer
@@ -41,13 +32,14 @@ body:
- Middleware factory
- Parameters
- Batch processing
- - Typing
- Validation
- Event Source Data Classes
- Parser
- Idempotency
- Feature flags
- JMESPath functions
+ - Streaming
+ - Automation
- Other
- type: textarea
id: suggestion
@@ -61,9 +53,9 @@ body:
attributes:
label: Acknowledgment
options:
- - label: This request meets [Lambda Powertools Tenets](https://awslabs.github.io/aws-lambda-powertools-python/latest/#tenets)
+ - label: This request meets [Powertools for AWS Lambda (Python) Tenets](https://docs.powertools.aws.dev/lambda/python/latest/#tenets)
required: true
- - label: Should this be considered in other Lambda Powertools languages? i.e. [Java](https://github.com/awslabs/aws-lambda-powertools-java/), [TypeScript](https://github.com/awslabs/aws-lambda-powertools-typescript/)
+ - label: Should this be considered in other Powertools for AWS Lambda languages? i.e. [Java](https://github.com/aws-powertools/powertools-lambda-java/), [TypeScript](https://github.com/aws-powertools/powertools-lambda-typescript/), and [.NET](https://github.com/aws-powertools/powertools-lambda-dotnet/)
required: false
- type: markdown
attributes:
diff --git a/.github/ISSUE_TEMPLATE/rfc.yml b/.github/ISSUE_TEMPLATE/rfc.yml
index 6e4b0e047f8..31d8d7fe0c6 100644
--- a/.github/ISSUE_TEMPLATE/rfc.yml
+++ b/.github/ISSUE_TEMPLATE/rfc.yml
@@ -15,7 +15,7 @@ body:
- type: dropdown
id: area
attributes:
- label: Which AWS Lambda Powertools utility does this relate to?
+ label: Which Powertools for AWS Lambda (Python) utility does this relate to?
options:
- Tracer
- Logger
@@ -91,9 +91,9 @@ body:
attributes:
label: Acknowledgment
options:
- - label: This feature request meets [Lambda Powertools Tenets](https://awslabs.github.io/aws-lambda-powertools-python/latest/#tenets)
+ - label: This feature request meets [Powertools for AWS Lambda (Python) Tenets](https://docs.powertools.aws.dev/lambda/python/latest/#tenets)
required: true
- - label: Should this be considered in other Lambda Powertools languages? i.e. [Java](https://github.com/awslabs/aws-lambda-powertools-java/), [TypeScript](https://github.com/awslabs/aws-lambda-powertools-typescript/)
+ - label: Should this be considered in other Powertools for AWS Lambda languages? i.e. [Java](https://github.com/aws-powertools/powertools-lambda-java/), [TypeScript](https://github.com/aws-powertools/powertools-lambda-typescript/), and [.NET](https://github.com/aws-powertools/powertools-lambda-dotnet/)
required: false
- type: markdown
attributes:
diff --git a/.github/ISSUE_TEMPLATE/share_your_work.yml b/.github/ISSUE_TEMPLATE/share_your_work.yml
new file mode 100644
index 00000000000..e4e4ed601be
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/share_your_work.yml
@@ -0,0 +1,56 @@
+name: I Made This (showcase your work)
+description: Share what you did with Powertools for AWS Lambda (Python) 💞💞. Blog post, workshops, presentation, sample apps, etc.
+title: "[I Made This]: "
+labels: ["community-content"]
+body:
+ - type: markdown
+ attributes:
+ value: Thank you for helping spread the word out on Powertools, truly!
+ - type: input
+ id: content
+ attributes:
+ label: Link to your material
+ description: |
+ Please share the original link to your material.
+
+ *Note: Short links will be expanded when added to Powertools for AWS Lambda (Python) documentation*
+ validations:
+ required: true
+ - type: textarea
+ id: description
+ attributes:
+ label: Description
+ description: Describe in one paragraph what's in it for them (readers)
+ validations:
+ required: true
+ - type: input
+ id: author
+ attributes:
+ label: Preferred contact
+ description: What's your preferred contact? We'll list it next to this content
+ validations:
+ required: true
+ - type: input
+ id: author-social
+ attributes:
+ label: (Optional) Social Network
+ description: If different from preferred contact, what's your preferred contact for social interactions?
+ validations:
+ required: false
+ - type: textarea
+ id: notes
+ attributes:
+ label: (Optional) Additional notes
+ description: |
+ Any notes you might want to share with us related to this material.
+
+ *Note: These notes are explicitly to Powertools for AWS Lambda (Python) maintainers. It will not be added to the community resources page.*
+ validations:
+ required: false
+ - type: checkboxes
+ id: acknowledgment
+ attributes:
+ label: Acknowledgment
+ options:
+ - label: I understand this content may be removed from Powertools for AWS Lambda (Python) documentation if it doesn't conform with the [Code of Conduct](https://aws.github.io/code-of-conduct)
+ required: true
diff --git a/.github/ISSUE_TEMPLATE/static_typing.yml b/.github/ISSUE_TEMPLATE/static_typing.yml
index 863dde7d33f..399fd8bc09a 100644
--- a/.github/ISSUE_TEMPLATE/static_typing.yml
+++ b/.github/ISSUE_TEMPLATE/static_typing.yml
@@ -8,7 +8,7 @@ body:
value: |
Thank you for submitting a static typing report. Please add as much information as possible to help us reproduce.
- Our preferred static type checker is [Mypy](https://mypy.readthedocs.io/en/stable/) using the following [configuration](https://github.com/awslabs/aws-lambda-powertools-python/blob/develop/mypy.ini).
+ Our preferred static type checker is [Mypy](https://mypy.readthedocs.io/en/stable/) using the following [configuration](https://github.com/aws-powertools/powertools-lambda-python/blob/develop/mypy.ini).
- type: dropdown
id: tool
attributes:
@@ -25,16 +25,17 @@ body:
attributes:
label: AWS Lambda function runtime
options:
- - 3.6
- - 3.7
- - 3.8
- - 3.9
+ - "3.10"
+ - "3.11"
+ - "3.12"
+ - "3.13"
+ - "3.14"
validations:
required: true
- type: input
id: version
attributes:
- label: AWS Lambda Powertools for Python version
+ label: Powertools for AWS Lambda (Python) version
placeholder: "latest, 1.25.6"
value: latest
validations:
diff --git a/.github/ISSUE_TEMPLATE/support_powertools.yml b/.github/ISSUE_TEMPLATE/support_powertools.yml
new file mode 100644
index 00000000000..c2c5f33676c
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/support_powertools.yml
@@ -0,0 +1,64 @@
+name: Support Powertools for AWS Lambda (Python) (become a reference)
+description: Add your organization's name or logo to the Powertools for AWS Lambda (Python) documentation
+title: "[Support Powertools for AWS Lambda (Python)]: <your organization name>"
+labels: ["customer-reference"]
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Thank you for becoming a reference customer. Your support means a lot to us. It also helps new customers to know who's using it.
+
+ If you would like us to also display your organization's logo, please share a link in the `Company logo` field.
+ - type: input
+ id: organization
+ attributes:
+ label: Organization Name
+ description: Please share the name of your organization
+ placeholder: ACME
+ validations:
+ required: true
+ - type: input
+ id: name
+ attributes:
+ label: Your Name
+ description: Please share your name
+ validations:
+ required: true
+ - type: input
+ id: job
+ attributes:
+ label: Your current position
+ description: Please share your current position at your company
+ validations:
+ required: true
+ - type: input
+ id: logo
+ attributes:
+ label: (Optional) Company logo
+ description: Company logo you want us to display. You also allow us to resize for optimal placement in the documentation.
+ validations:
+ required: false
+ - type: textarea
+ id: use_case
+ attributes:
+ label: (Optional) Use case
+ description: How are you using Powertools for AWS Lambda (Python) today? *features, etc.*
+ validations:
+ required: false
+ - type: checkboxes
+ id: other_languages
+ attributes:
+ label: Also using other Powertools for AWS Lambda languages?
+ options:
+ - label: Java
+ required: false
+ - label: TypeScript
+ required: false
+ - label: .NET
+ required: false
+ - type: markdown
+ attributes:
+ value: |
+ *By raising a Support Powertools for AWS Lambda (Python) issue, you are granting AWS permission to use your company's name (and/or logo) for the limited purpose described here. You are also confirming that you have authority to grant such permission.*
+
+ *You can opt-out at any time by commenting or reopening this issue.*
diff --git a/.github/ISSUE_TEMPLATE/tech_debt.yml b/.github/ISSUE_TEMPLATE/tech_debt.yml
new file mode 100644
index 00000000000..064c118ba20
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/tech_debt.yml
@@ -0,0 +1,62 @@
+name: Technical debt
+description: Suggest an activity to help address technical debt.
+title: "Tech debt: TITLE"
+labels: ["tech-debt", "triage"]
+body:
+ - type: markdown
+ attributes:
+ value: Thank you for taking the time to help us proactively improve delivery velocity, safely.
+ - type: textarea
+ id: importance
+ attributes:
+ label: Why is this needed?
+ description: Please help us understand the value so we can prioritize it accordingly
+ validations:
+ required: true
+ - type: dropdown
+ id: area
+ attributes:
+ label: Which area does this relate to?
+ multiple: true
+ options:
+ - Tests
+ - Static typing
+ - Tracer
+ - Logger
+ - Metrics
+ - Event Handler - REST API
+ - Event Handler - GraphQL API
+ - Middleware factory
+ - Parameters
+ - Batch processing
+ - Validation
+ - Event Source Data Classes
+ - Parser
+ - Idempotency
+ - Feature flags
+ - JMESPath functions
+ - Streaming
+ - Automation
+ - Other
+ - type: textarea
+ id: suggestion
+ attributes:
+ label: Suggestion
+ description: If available, please share what a good solution would look like
+ validations:
+ required: false
+ - type: checkboxes
+ id: acknowledgment
+ attributes:
+ label: Acknowledgment
+ options:
+ - label: This request meets [Powertools for AWS Lambda (Python) Tenets](https://docs.powertools.aws.dev/lambda/python/latest/#tenets)
+ required: true
+ - label: Should this be considered in other Powertools for AWS Lambda languages? i.e. [Java](https://github.com/aws-powertools/powertools-lambda-java/), [TypeScript](https://github.com/aws-powertools/powertools-lambda-typescript/), and [.NET](https://github.com/aws-powertools/powertools-lambda-dotnet/)
+ required: false
+ - type: markdown
+ attributes:
+ value: |
+ ---
+
+ **Disclaimer**: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index de2d40678ba..234a347f24a 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,5 +1,5 @@
<!-- markdownlint-disable MD041 MD043 -->
-**Issue number:**
+**Issue number:** closes #<replace with issue number>
## Summary
@@ -11,29 +11,17 @@
> Please share what the user experience looks like before and after this change
-## Checklist
+<!-------
+Before creating the pull request, please make sure you do the following:
-If your change doesn't seem to apply, please leave them unchecked.
+- Read the Contributing Guidelines at https://github.com/aws-powertools/powertools-lambda-python/blob/main/CONTRIBUTING.md#sending-a-pull-request
+- Check that there isn't already a PR that addresses the same issue. If you find a duplicate, please leave a comment under the existing PR so we can discuss how to move forward
+- Check that the change meets the project's tenets https://docs.powertools.aws.dev/lambda/python/latest/#tenets
+- Add a PR title that follows the conventional commit semantics - https://github.com/aws-powertools/powertools-lambda-python/blob/develop/.github/semantic.yml
+- If relevant, add tests that prove that the change is effective and works
+------->
-* [ ] [Meet tenets criteria](https://awslabs.github.io/aws-lambda-powertools-python/#tenets)
-* [ ] I have performed a self-review of this change
-* [ ] Changes have been tested
-* [ ] Changes are documented
-* [ ] PR title follows [conventional commit semantics](https://github.com/awslabs/aws-lambda-powertools-python/blob/develop/.github/semantic.yml)
-
-<details>
-<summary>Is this a breaking change?</summary>
-
-**RFC issue number**:
-
-Checklist:
-
-* [ ] Migration process documented
-* [ ] Implement warnings (if it can live side by side)
-
-</details>
-
-## Acknowledgment
+---
By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.
diff --git a/.github/actionlint.yaml b/.github/actionlint.yaml
new file mode 100644
index 00000000000..c9597418e3f
--- /dev/null
+++ b/.github/actionlint.yaml
@@ -0,0 +1,3 @@
+self-hosted-runner:
+ labels:
+ - aws-powertools_ubuntu-latest_8-core
diff --git a/.github/actions/create-pr/action.yml b/.github/actions/create-pr/action.yml
new file mode 100644
index 00000000000..39ba6f60b1f
--- /dev/null
+++ b/.github/actions/create-pr/action.yml
@@ -0,0 +1,88 @@
+name: "Create PR custom action"
+description: "Create a PR and a temporary branch, close duplicates"
+
+# PROCESS
+#
+# 1. Setup git client using Powertools for AWS Lambda (Python) bot username
+# 2. Pushes staged files to a temporary branch
+# 3. Creates a PR from temporary branch against a target branch (typically trunk: develop, main, etc.)
+# 4. Searches for duplicate PRs with the same title
+# 5. If duplicates are found, link to the most recent one, close and delete their branches so we keep a single PR
+# 6. In the event of failure, we delete the now orphaned branch (if any), and propagate the failure
+
+# USAGE
+#
+# - name: Create PR
+# id: create-pr
+# uses: ./.github/actions/create-pr
+# with:
+# files: "CHANGELOG.md"
+# temp_branch_prefix: "ci-changelog"
+# pull_request_title: "chore(ci): changelog rebuild"
+# github_token: ${{ secrets.GITHUB_TOKEN }}
+# - name: Step to demonstrate how to access outputs (no need for this)
+# run: |
+# echo "PR number: ${PR_ID}"
+# echo "Branch: ${BRANCH}"
+# env:
+# PR_ID: ${{ steps.create-pr.outputs.pull_request_id}}
+# BRANCH: ${{ steps.create-pr.outputs.temp_branch}}
+
+inputs:
+ files:
+ description: "Files to add separated by space"
+ required: true
+ temp_branch_prefix:
+ description: "Prefix for temporary git branch to be created, e.g, ci-docs"
+ required: true
+ pull_request_title:
+ description: "Pull Request title to use"
+ required: true
+ github_token:
+ description: "GitHub token for GitHub CLI"
+ required: true
+ target_branch:
+ description: "Branch to target when creating a PR against (develop, by default)"
+ required: false
+ default: develop
+
+outputs:
+ pull_request_id:
+ description: "Pull request ID created"
+ value: ${{ steps.create-pr.outputs.pull_request_id }}
+ temp_branch:
+ description: "Temporary branch created with staged changed"
+ value: ${{ steps.create-pr.outputs.temp_branch }}
+
+runs:
+ using: "composite"
+ steps:
+ - id: adjust-path
+ run: echo "${{ github.action_path }}" >> $GITHUB_PATH
+ shell: bash
+ - id: setup-git
+ name: Git client setup and refresh tip
+ run: |
+ git config user.name "Powertools for AWS Lambda (Python) bot"
+ git config user.email "151832416+aws-powertools-bot@users.noreply.github.com"
+ git config pull.rebase true
+ git config remote.origin.url >&-
+ shell: bash
+ - id: create-pr
+ working-directory: ${{ env.GITHUB_WORKSPACE }}
+ run: create_pr_for_staged_changes.sh "${FILES}"
+ env:
+ FILES: ${{ inputs.files }}
+ TEMP_BRANCH_PREFIX: ${{ inputs.temp_branch_prefix }}
+ PR_TITLE: ${{ inputs.pull_request_title }}
+ BASE_BRANCH: ${{ inputs.target_branch }}
+ GH_TOKEN: ${{ inputs.github_token }}
+ shell: bash
+ - id: cleanup
+ name: Cleanup orphaned branch
+ if: failure()
+ run: git push origin --delete "${TEMP_BRANCH_PREFIX}-${GITHUB_RUN_ID}" || echo "Must have failed before creating temporary branch; no cleanup needed."
+ env:
+ TEMP_BRANCH_PREFIX: ${{ inputs.temp_branch_prefix }}
+ GITHUB_RUN_ID: ${{ github.run_id }}
+ shell: bash
diff --git a/.github/actions/create-pr/create_pr_for_staged_changes.sh b/.github/actions/create-pr/create_pr_for_staged_changes.sh
new file mode 100755
index 00000000000..f31217467ee
--- /dev/null
+++ b/.github/actions/create-pr/create_pr_for_staged_changes.sh
@@ -0,0 +1,148 @@
+#!/bin/bash
+set -uo pipefail # prevent accessing unset env vars, prevent masking pipeline errors to the next command
+
+#docs
+#title :create_pr_for_staged_changes.sh
+#description :This script will create a PR for staged changes, detect and close duplicate PRs. All PRs will be omitted from Release Notes and Changelogs
+#author :@heitorlessa
+#date :May 8th 2023
+#version :0.1
+#usage :bash create_pr_for_staged_changes.sh {git_staged_files_or_directories_separated_by_space}
+#notes :Meant to use in GitHub Actions only. Temporary branch will be named $TEMP_BRANCH_PREFIX-$GITHUB_RUN_ID
+#os_version :Ubuntu 22.04.2 LTS
+#required_env_vars :PR_TITLE, TEMP_BRANCH_PREFIX, GH_TOKEN
+#==============================================================================
+
+# Sets GitHub Action with error message to ease troubleshooting
+function error() {
+ echo "::error file=${FILENAME}::$1"
+ exit 1
+}
+
+function debug() {
+ TIMESTAMP=$(date -u "+%FT%TZ") # 2023-05-10T07:53:59Z
+ echo ""${TIMESTAMP}" - $1"
+}
+
+function notice() {
+ echo "::notice file=${FILENAME}::$1"
+}
+
+function start_span() {
+ echo "::group::$1"
+}
+
+function end_span() {
+ echo "::endgroup::"
+}
+
+function has_required_config() {
+ start_span "Validating required config"
+ test -z "${TEMP_BRANCH_PREFIX}" && error "TEMP_BRANCH_PREFIX env must be set to create a PR"
+ test -z "${PR_TITLE}" && error "PR_TITLE env must be set"
+ test -z "${GH_TOKEN}" && error "GH_TOKEN env must be set for GitHub CLI"
+
+ # Default GitHub Actions Env Vars: https://docs.github.com/en/actions/learn-github-actions/variables#default-environment-variables
+ debug "Are we running in GitHub Action environment?"
+ test -z "${GITHUB_RUN_ID}" && error "GITHUB_RUN_ID env must be set to trace Workflow Run ID back to PR"
+ test -z "${GITHUB_SERVER_URL}" && error "GITHUB_SERVER_URL env must be set to trace Workflow Run ID back to PR"
+ test -z "${GITHUB_REPOSITORY}" && error "GITHUB_REPOSITORY env must be set to trace Workflow Run ID back to PR"
+
+ debug "Config validated successfully!"
+ set_environment_variables
+ end_span
+}
+
+function set_environment_variables() {
+ start_span "Setting environment variables"
+ export readonly WORKFLOW_URL="${GITHUB_SERVER_URL}"/"${GITHUB_REPOSITORY}"/actions/runs/"${GITHUB_RUN_ID}" # e.g., heitorlessa/aws-lambda-powertools-test/actions/runs/4913570678
+ export readonly TEMP_BRANCH="${TEMP_BRANCH_PREFIX}"-"${GITHUB_RUN_ID}" # e.g., ci-changelog-4894658712
+ export readonly BASE_BRANCH="${BASE_BRANCH:-develop}" # e.g., main, defaults to develop if missing
+ export readonly PR_BODY="This is an automated PR created from the following workflow"
+ export readonly FILENAME=".github/scripts/$(basename "$0")"
+ export readonly NO_DUPLICATES_MESSAGE="No duplicated PRs found"
+ export readonly SKIP_LABEL="skip-changelog"
+
+ end_span
+}
+
+function has_anything_changed() {
+ start_span "Validating git staged files"
+ HAS_ANY_SOURCE_CODE_CHANGED="$(git status --porcelain)"
+
+ test -z "${HAS_ANY_SOURCE_CODE_CHANGED}" && debug "Nothing to update; exitting early" && exit 0
+ end_span
+}
+
+function create_temporary_branch_with_changes() {
+ start_span "Creating temporary branch: "${TEMP_BRANCH}""
+ git checkout -b "${TEMP_BRANCH}"
+
+ debug "Committing staged files: $*"
+ echo "$@" | xargs -n1 git add || error "Failed to add staged changes: "$@""
+ git commit -m "${PR_TITLE}"
+
+ git push origin "${TEMP_BRANCH}" || error "Failed to create new temporary branch"
+ end_span
+}
+
+function create_pr() {
+ start_span "Creating PR against ${TEMP_BRANCH} branch"
+ # TODO: create label
+ NEW_PR_URL=$(gh pr create --title "${PR_TITLE}" --body "${PR_BODY}: ${WORKFLOW_URL}" --base "${BASE_BRANCH}" --label "${SKIP_LABEL}" || error "Failed to create PR") # e.g, https://github.com/aws-powertools/powertools-lambda-python/pull/13
+
+ # greedy remove any string until the last URL path, including the last '/'. https://opensource.com/article/17/6/bash-parameter-expansion
+ debug "Extracing PR Number from PR URL: "${NEW_PR_URL}""
+ NEW_PR_ID="${NEW_PR_URL##*/}" # 13
+ export NEW_PR_URL
+ export NEW_PR_ID
+ end_span
+}
+
+function close_duplicate_prs() {
+ start_span "Searching for duplicate PRs"
+ DUPLICATE_PRS=$(gh pr list --search "${PR_TITLE}" --json number --jq ".[] | select(.number != ${NEW_PR_ID}) | .number") # e.g, 13\n14
+
+ if [ -z "${DUPLICATE_PRS}" ]; then
+ debug "No duplicate PRs found"
+ DUPLICATE_PRS="${NO_DUPLICATES_MESSAGE}"
+ else
+ debug "Closing duplicated PRs: "${DUPLICATE_PRS}""
+ echo "${DUPLICATE_PRS}" | xargs -L1 gh pr close --delete-branch --comment "Superseded by #${NEW_PR_ID}"
+ fi
+
+ export readonly DUPLICATE_PRS
+ end_span
+}
+
+function report_job_output() {
+ start_span "Updating job outputs"
+ echo pull_request_id="${NEW_PR_ID}" >>"$GITHUB_OUTPUT"
+ echo temp_branch="${TEMP_BRANCH}" >>"$GITHUB_OUTPUT"
+ end_span
+}
+
+function report_summary() {
+ start_span "Creating job summary"
+ echo "### Pull request created successfully :rocket: ${NEW_PR_URL} <br/><br/> Closed duplicated PRs: ${DUPLICATE_PRS}" >>"$GITHUB_STEP_SUMMARY"
+
+ notice "PR_URL is: ${NEW_PR_URL}"
+ notice "PR_BRANCH is: ${TEMP_BRANCH}"
+ notice "PR_DUPLICATES are: ${DUPLICATE_PRS}"
+ end_span
+}
+
+function main() {
+ # Sanity check
+ has_anything_changed
+ has_required_config
+
+ create_temporary_branch_with_changes "$@"
+ create_pr
+ close_duplicate_prs
+
+ report_job_output
+ report_summary
+}
+
+main "$@"
diff --git a/.github/actions/download-artifact/action.yml b/.github/actions/download-artifact/action.yml
new file mode 100644
index 00000000000..1f1347e4220
--- /dev/null
+++ b/.github/actions/download-artifact/action.yml
@@ -0,0 +1,58 @@
+name: Download artifact
+description: Wrapper around GitHub's official action, with additional extraction before download
+
+# PROCESS
+#
+# 1. Downloads artifact using actions/download-artifact action
+# 2. Extracts and overwrites tarball previously uploaded
+# 3. Remove archive after extraction
+
+# NOTES
+#
+# Upload-artifact and download-artifact takes ~2m40s to upload 8MB
+# so this is custom action cuts down the entire operation to 1s
+# by uploading/extracting a tarball while relying on the official upload-artifact/download-artifact actions
+#
+
+# USAGE
+#
+# NOTE: Meant to be used with ./.github/actions/upload-artifact
+#
+# - name: Restore sealed source code
+# uses: ./.github/actions/download-artifact
+# with:
+# name: ${{ needs.seal.outputs.INTEGRITY_HASH }}
+# path: .
+
+# https://github.com/actions/download-artifact/blob/main/action.yml
+inputs:
+ name:
+ description: Artifact name
+ required: true
+ path:
+ description: Destination path. By default, it will download to the current working directory.
+ required: false
+ default: .
+
+runs:
+ using: composite
+ steps:
+ - name: Download artifacts
+ uses: actions/download-artifact@65a9edc5881444af0b9093a5e628f2fe47ea3b2e # v4.1.7
+ with:
+ name: ${{ inputs.name }}
+ path: ${{ inputs.path }}
+
+ - name: Extract artifacts
+ run: tar -xvf "${ARCHIVE}"
+ env:
+ ARCHIVE: ${{ inputs.name }}.tar
+ shell: bash
+ working-directory: ${{ inputs.path }}
+
+ - name: Remove archive
+ run: rm -f "${ARCHIVE}"
+ env:
+ ARCHIVE: ${{ inputs.name }}.tar
+ shell: bash
+ working-directory: ${{ inputs.path }}
diff --git a/.github/actions/seal-restore/action.yml b/.github/actions/seal-restore/action.yml
new file mode 100644
index 00000000000..1107414b640
--- /dev/null
+++ b/.github/actions/seal-restore/action.yml
@@ -0,0 +1,82 @@
+name: "Restore sealed source code"
+description: "Restore sealed source code and confirm integrity hash"
+
+# PROCESS
+#
+# 1. Exports artifact name using Prefix + GitHub Run ID (unique for each release trigger)
+# 2. Compress entire source code as tarball OR given files
+# 3. Create and export integrity hash for tarball
+# 4. Upload artifact
+# 5. Remove archive
+
+# USAGE
+#
+# - name: Seal and upload
+# id: seal_source_code
+# uses: ./.github/actions/seal
+# with:
+# artifact_name_prefix: "source"
+#
+# - name: Restore sealed source code
+# uses: ./.github/actions/seal-restore
+# with:
+# integrity_hash: ${{ needs.seal_source_code.outputs.integrity_hash }}
+# artifact_name: ${{ needs.seal_source_code.outputs.artifact_name }}
+
+# NOTES
+#
+# To be used together with .github/actions/seal
+
+inputs:
+ integrity_hash:
+ description: "Integrity hash to verify"
+ required: true
+ artifact_name:
+ description: "Sealed artifact name to restore"
+ required: true
+
+runs:
+ using: "composite"
+ steps:
+ - id: adjust-path
+ run: echo "${{ github.action_path }}" >> $GITHUB_PATH
+ shell: bash
+
+ - name: Download artifacts
+ uses: actions/download-artifact@65a9edc5881444af0b9093a5e628f2fe47ea3b2e # v4.1.7
+ with:
+ name: ${{ inputs.artifact_name }}
+ path: .
+
+ - id: integrity_hash
+ name: Create integrity hash for downloaded artifact
+ run: |
+ HASH=$(sha256sum "${ARTIFACT_NAME}.tar" | awk '{print $1}')
+
+ echo "current_hash=${HASH}" >> "$GITHUB_OUTPUT"
+ env:
+ ARTIFACT_NAME: ${{ inputs.artifact_name }}
+ shell: bash
+
+ - id: verify_hash
+ name: Verify sealed artifact integrity hash
+ run: test "${CURRENT_HASH}" = "${PROVIDED_HASH}" || exit 1
+ env:
+ ARTIFACT_NAME: ${{ inputs.artifact_name }}
+ PROVIDED_HASH: ${{ inputs.integrity_hash }}
+ CURRENT_HASH: ${{ steps.integrity_hash.outputs.current_hash }}
+ shell: bash
+
+ # Restore and overwrite tarball in current directory
+ - id: overwrite
+ name: Extract tarball
+ run: tar -xvf "${ARTIFACT_NAME}".tar
+ env:
+ ARTIFACT_NAME: ${{ inputs.artifact_name }}
+ shell: bash
+
+ - name: Remove archive
+ run: rm -f "${ARTIFACT_NAME}.tar"
+ env:
+ ARTIFACT_NAME: ${{ inputs.artifact_name }}
+ shell: bash
diff --git a/.github/actions/seal/action.yml b/.github/actions/seal/action.yml
new file mode 100644
index 00000000000..c3e75a13e92
--- /dev/null
+++ b/.github/actions/seal/action.yml
@@ -0,0 +1,93 @@
+name: "Seal and hash source code"
+description: "Seal and export source code as a tarball artifact along with its integrity hash"
+
+# PROCESS
+#
+# 1. Exports artifact name using Prefix + GitHub Run ID (unique for each release trigger)
+# 2. Compress entire source code as tarball OR given files
+# 3. Create and export integrity hash for tarball
+# 4. Upload artifact
+# 5. Remove archive
+
+# USAGE
+#
+# - name: Seal and upload
+# id: seal_source_code
+# uses: ./.github/actions/seal
+# with:
+# artifact_name_prefix: "source"
+
+inputs:
+ files:
+ description: "Files to seal separated by space"
+ required: false
+ artifact_name_prefix:
+ description: "Prefix to use when exporting artifact"
+ required: true
+
+outputs:
+ integrity_hash:
+ description: "Source code integrity hash"
+ value: ${{ steps.integrity_hash.outputs.integrity_hash }}
+ artifact_name:
+ description: "Artifact name containTemporary branch created with staged changed"
+ value: ${{ steps.export_artifact_name.outputs.artifact_name }}
+
+runs:
+ using: "composite"
+ steps:
+ - id: adjust-path
+ run: echo "${{ github.action_path }}" >> $GITHUB_PATH
+ shell: bash
+
+ - id: export_artifact_name
+ name: Export final artifact name
+ run: echo "artifact_name=${ARTIFACT_PREFIX}-${GITHUB_RUN_ID}" >> "$GITHUB_OUTPUT"
+ env:
+ GITHUB_RUN_ID: ${{ github.run_id }}
+ ARTIFACT_PREFIX: ${{ inputs.artifact_name_prefix }}
+ shell: bash
+
+ # By default, create a tarball of the current directory minus .git
+ # otherwise it breaks GH Actions when restoring it
+ - id: compress_all
+ if: ${{ !inputs.files }}
+ name: Create tarball for entire source
+ run: tar --exclude-vcs -cvf "${ARTIFACT_NAME}".tar *
+ env:
+ ARTIFACT_NAME: ${{ steps.export_artifact_name.outputs.artifact_name }}
+ shell: bash
+
+ # If a list of files are given, then create a tarball for those only
+ - id: compress_selected_files
+ if: ${{ inputs.files }}
+ name: Create tarball for selected files
+ run: tar --exclude-vcs -cvf "${ARTIFACT_NAME}".tar "${FILES}"
+ env:
+ FILES: ${{ inputs.files }}
+ ARTIFACT_NAME: ${{ steps.export_artifact_name.outputs.artifact_name }}
+ shell: bash
+
+ - id: integrity_hash
+ name: Create and export integrity hash for tarball
+ run: |
+ HASH=$(sha256sum "${ARTIFACT_NAME}.tar" | awk '{print $1}')
+
+ echo "integrity_hash=${HASH}" >> "$GITHUB_OUTPUT"
+ env:
+ ARTIFACT_NAME: ${{ steps.export_artifact_name.outputs.artifact_name }}
+ shell: bash
+
+ - name: Upload artifacts
+ uses: actions/upload-artifact@65462800fd760344b1a7b4382951275a0abb4808 # v4.3.3
+ with:
+ if-no-files-found: error
+ name: ${{ steps.export_artifact_name.outputs.artifact_name }}
+ path: ${{ steps.export_artifact_name.outputs.artifact_name }}.tar
+ retention-days: 1
+
+ - name: Remove archive
+ run: rm -f "${ARTEFACT_NAME}.tar"
+ env:
+ ARTIFACT_NAME: ${{ steps.export_artifact_name.outputs.artifact_name }}
+ shell: bash
diff --git a/.github/actions/upload-artifact/action.yml b/.github/actions/upload-artifact/action.yml
new file mode 100644
index 00000000000..f88ea2475b9
--- /dev/null
+++ b/.github/actions/upload-artifact/action.yml
@@ -0,0 +1,82 @@
+name: Upload artifact
+description: Wrapper around GitHub's official action, with additional archiving before upload
+
+# PROCESS
+#
+# 1. Creates tarball excluding .git files
+# 2. Uploads tarball using actions/upload-artifact action, fail CI job if no file is found
+# 3. Remove archive after uploading it.
+
+# NOTES
+#
+# Upload-artifact and download-artifact takes ~2m40s to upload 8MB
+# so this is custom action cuts down the entire operation to 1s
+# by uploading/extracting a tarball while relying on the official upload-artifact/download-artifact actions
+#
+
+# USAGE
+#
+# NOTE: Meant to be used with ./.github/actions/download-artifact
+#
+# - name: Upload sealed source code
+# uses: ./.github/actions/upload-artifact
+# with:
+# name: ${{ steps.integrity.outputs.INTEGRITY_HASH }}
+# path: .
+
+# https://github.com/actions/upload-artifact/blob/main/action.yml
+inputs:
+ name:
+ description: Artifact name
+ required: true
+ path:
+ description: >
+ A file, directory or wildcard pattern that describes what to upload.
+
+ You can pass multiple paths separated by space (e.g., dir1 dir2 file.txt).
+
+ Paths and wildcard patterns must be tar command compatible.
+ required: true
+ retention-days:
+ description: >
+ Artifact retention in days. By default 1 day, max of 90 days, and 0 honours default repo retention.
+
+ You can change max days in the repository settings.
+ required: false
+ default: "1"
+ if-no-files-found:
+ description: >
+ Action to perform if no files are found: warn, error, ignore. By default, it fails fast with 'error'.
+
+ Options:
+ warn: Output a warning but do not fail the action
+ error: Fail the action with an error message
+ ignore: Do not output any warnings or errors, the action does not fail
+ required: false
+ default: error
+
+runs:
+ using: composite
+ steps:
+ - name: Archive artifacts
+ run: |
+ tar --exclude-vcs \
+ -cvf "${ARCHIVE}" "${PATH_TO_ARCHIVE}"
+ env:
+ ARCHIVE: ${{ inputs.name }}.tar
+ PATH_TO_ARCHIVE: ${{ inputs.path }}
+ shell: bash
+
+ - name: Upload artifacts
+ uses: actions/upload-artifact@65462800fd760344b1a7b4382951275a0abb4808 # v4.3.3
+ with:
+ if-no-files-found: ${{ inputs.if-no-files-found }}
+ name: ${{ inputs.name }}
+ path: ${{ inputs.name }}.tar
+ retention-days: ${{ inputs.retention-days }}
+
+ - name: Remove archive
+ run: rm -f "${ARCHIVE}"
+ env:
+ ARCHIVE: ${{ inputs.name }}.tar
+ shell: bash
diff --git a/.github/actions/upload-release-provenance/action.yml b/.github/actions/upload-release-provenance/action.yml
new file mode 100644
index 00000000000..d0829efd4f4
--- /dev/null
+++ b/.github/actions/upload-release-provenance/action.yml
@@ -0,0 +1,67 @@
+name: "Upload provenance attestation to release"
+description: "Download and upload newly generated provenance attestation to latest release."
+
+# PROCESS
+#
+# 1. Downloads provenance attestation artifact generated earlier in the release pipeline
+# 2. Updates latest GitHub draft release pointing to newly git release tag
+# 3. Uploads provenance attestation file to latest GitHub draft release
+
+# USAGE
+#
+# - name: Upload provenance
+# id: upload-provenance
+# uses: ./.github/actions/upload-release-provenance
+# with:
+# release_version: ${{ needs.seal.outputs.RELEASE_VERSION }}
+# provenance_name: ${{needs.provenance.outputs.provenance-name}}
+# github_token: ${{ secrets.GITHUB_TOKEN }}
+
+# NOTES
+#
+# There are no outputs.
+#
+
+inputs:
+ provenance_name:
+ description: "Provenance artifact name to download"
+ required: true
+ release_version:
+ description: "Release version (e.g., 2.20.0)"
+ required: true
+ github_token:
+ description: "GitHub token for GitHub CLI"
+ required: true
+
+runs:
+ using: "composite"
+ steps:
+ - id: adjust-path
+ run: echo "${{ github.action_path }}" >> $GITHUB_PATH
+ shell: bash
+
+ - id: download-provenance
+ name: Download newly generated provenance
+ uses: actions/download-artifact@65a9edc5881444af0b9093a5e628f2fe47ea3b2e # v4.1.7
+ with:
+ name: ${{ inputs.provenance_name }}
+
+ - id: sync-release-tag
+ name: Update draft release tag to release commit tag
+ run: |
+ CURRENT_DRAFT_RELEASE=$(gh release list | awk '{ if ($2 == "Draft") print $1}')
+ gh release edit "${CURRENT_DRAFT_RELEASE}" --tag v"${RELEASE_VERSION}"
+ env:
+ RELEASE_VERSION: ${{ inputs.release_version }}
+ GH_TOKEN: ${{ inputs.github_token }}
+ shell: bash
+
+ - id: upload-provenance
+ name: Upload provenance to release tag
+ # clobber flag means overwrite release asset if available (eventual consistency, retried failed steps)
+ run: gh release upload --clobber v"${RELEASE_VERSION}" "${PROVENANCE_FILE}"
+ env:
+ RELEASE_VERSION: ${{ inputs.release_version }}
+ PROVENANCE_FILE: ${{ inputs.provenance_name }}
+ GH_TOKEN: ${{ inputs.github_token }}
+ shell: bash
diff --git a/.github/actions/verify-provenance/verify_provenance.sh b/.github/actions/verify-provenance/verify_provenance.sh
new file mode 100755
index 00000000000..dbfe280473d
--- /dev/null
+++ b/.github/actions/verify-provenance/verify_provenance.sh
@@ -0,0 +1,134 @@
+#!/bin/bash
+set -uo pipefail # prevent accessing unset env vars, prevent masking pipeline errors to the next command
+
+#docs
+#title :verify_provenance.sh
+#description :This script will download and verify a signed Powertools for AWS Lambda (Python) release build with SLSA Verifier
+#author :@heitorlessa
+#date :July 1st 2023
+#version :0.1
+#usage :bash verify_provenance.sh {release version}
+#notes :Meant to use in GitHub Actions or locally (MacOS, Linux, WSL).
+#os_version :Ubuntu 22.04.2 LTS
+#==============================================================================
+
+# Check if RELEASE_VERSION is provided as a command line argument
+if [[ $# -eq 1 ]]; then
+ export readonly RELEASE_VERSION="$1"
+else
+ echo "ERROR: Please provider Powertools release version as a command line argument."
+ echo "Example: bash verify_provenance.sh 2.20.0"
+ exit 1
+fi
+
+export readonly ARCHITECTURE=$(uname -m | sed 's/x86_64/amd64/g') # arm64, x86_64 ->amd64
+export readonly OS_NAME=$(uname -s | tr '[:upper:]' '[:lower:]') # darwin, linux
+export readonly SLSA_VERIFIER_VERSION="2.3.0"
+export readonly SLSA_VERIFIER_CHECKSUM_FILE="SHA256SUM.md"
+export readonly SLSA_VERIFIER_BINARY="./slsa-verifier-${OS_NAME}-${ARCHITECTURE}"
+
+export readonly RELEASE_BINARY="aws_lambda_powertools-${RELEASE_VERSION}-py3-none-any.whl"
+export readonly ORG="aws-powertools"
+export readonly REPO="powertools-lambda-python"
+export readonly PROVENANCE_FILE="multiple.intoto.jsonl"
+
+export readonly FILES=("${SLSA_VERIFIER_BINARY}" "${SLSA_VERIFIER_CHECKSUM_FILE}" "${PROVENANCE_FILE}" "${RELEASE_BINARY}")
+
+function debug() {
+ TIMESTAMP=$(date -u "+%FT%TZ") # 2023-05-10T07:53:59Z
+ echo ""${TIMESTAMP}" DEBUG - [*] $1"
+}
+
+function error() {
+ cleanup
+ TIMESTAMP=$(date -u "+%FT%TZ") # 2023-05-10T07:53:59Z
+ echo ""${TIMESTAMP}" ERROR - [!] $1"
+ echo ""${TIMESTAMP}" ERROR - [!] exiting"
+ exit 1
+}
+
+function download_slsa_verifier() {
+ readonly SLSA_URL="https://github.com/slsa-framework/slsa-verifier/releases/download/v${SLSA_VERIFIER_VERSION}/slsa-verifier-${OS_NAME}-${ARCHITECTURE}"
+ # debug "Downloading SLSA Verifier for - Binary: slsa-verifier-${OS_NAME}-${ARCHITECTURE}"
+ debug "Downloading SLSA Verifier binary: ${SLSA_URL}"
+ curl \
+ --location \
+ --fail \
+ --silent \
+ -O "${SLSA_URL}" || error "Failed to download SLSA Verifier binary"
+
+ readonly SLSA_CHECKSUM_URL="https://raw.githubusercontent.com/slsa-framework/slsa-verifier/f59b55ef2190581d40fc1a5f3b7a51cab2f4a652/${SLSA_VERIFIER_CHECKSUM_FILE}"
+ debug "Downloading SLSA Verifier checksums"
+ curl \
+ --location \
+ --fail \
+ --silent \
+ -O "${SLSA_CHECKSUM_URL}" || error "Failed to download SLSA Verifier binary checksum file"
+
+ debug "Verifying SLSA Verifier binary integrity"
+ CURRENT_HASH=$(sha256sum "${SLSA_VERIFIER_BINARY}" | awk '{print $1}')
+ if [[ $(grep "${CURRENT_HASH}" "${SLSA_VERIFIER_CHECKSUM_FILE}") ]]; then
+ debug "SLSA Verifier binary integrity confirmed"
+ chmod +x "${SLSA_VERIFIER_BINARY}"
+ else
+ error "Failed integrity check for SLSA Verifier binary: ${SLSA_VERIFIER_BINARY}"
+ fi
+}
+
+function download_provenance() {
+ readonly PROVENANCE_URL="https://github.com/${ORG}/${REPO}/releases/download/v${RELEASE_VERSION}/${PROVENANCE_FILE}"
+ debug "Downloading attestation: ${PROVENANCE_URL}"
+
+ curl \
+ --location \
+ --fail \
+ --silent \
+ -O ${PROVENANCE_URL} || error "Failed to download provenance. Does the release already exist?"
+}
+
+function download_release_artifact() {
+ debug "Downloading ${RELEASE_VERSION} release from PyPi"
+ python -m pip download \
+ --only-binary=:all: \
+ --no-deps \
+ --quiet \
+ aws-lambda-powertools=="${RELEASE_VERSION}"
+}
+
+function verify_provenance() {
+ debug "Verifying attestation with slsa-verifier"
+ "${SLSA_VERIFIER_BINARY}" verify-artifact \
+ --provenance-path "${PROVENANCE_FILE}" \
+ --source-uri github.com/${ORG}/${REPO} \
+ ${RELEASE_BINARY}
+}
+
+function cleanup() {
+ debug "Cleaning up previously downloaded files"
+ rm -f "${SLSA_VERIFIER_BINARY}"
+ rm -f "${SLSA_VERIFIER_CHECKSUM_FILE}"
+ rm -f "${PROVENANCE_FILE}"
+ rm -f "${RELEASE_BINARY}"
+ echo "${FILES[@]}" | xargs -n1 echo "Removed file: "
+}
+
+function main() {
+ download_slsa_verifier
+ download_provenance
+ download_release_artifact
+ verify_provenance
+ cleanup
+}
+
+main
+
+# Lessons learned
+#
+# 1. If source doesn't match provenance
+#
+# FAILED: SLSA verification failed: source used to generate the binary does not match provenance: expected source 'awslabs/aws-lambda-powertools-python', got 'heitorlessa/aws-lambda-powertools-test'
+#
+# 2. Avoid building deps during download in Test registry endpoints
+#
+# FAILED: Could not find a version that satisfies the requirement poetry-core>=1.3.2 (from versions: 1.2.0)
+#
diff --git a/.github/boring-cyborg.yml b/.github/boring-cyborg.yml
index 38760c85de6..006db19c585 100644
--- a/.github/boring-cyborg.yml
+++ b/.github/boring-cyborg.yml
@@ -1,48 +1,50 @@
##### Labeler ##########################################################################################################
labelPRBasedOnFilePath:
- area/logger:
+ logger:
- aws_lambda_powertools/logging/*
- aws_lambda_powertools/logging/**/*
- aws_lambda_powertools/package_logger.py
- area/tracer:
+ tracer:
- aws_lambda_powertools/tracing/*
- aws_lambda_powertools/tracing/**/*
- area/metrics:
+ metrics:
- aws_lambda_powertools/metrics/*
- aws_lambda_powertools/metrics/**/*
- area/event_handlers:
+ event_handlers:
- aws_lambda_powertools/event_handler/*
- aws_lambda_powertools/event_handler/**/*
- area/middleware_factory:
+ middleware_factory:
- aws_lambda_powertools/middleware_factory/*
- aws_lambda_powertools/middleware_factory/**/*
- area/parameters:
+ parameters:
- aws_lambda_powertools/parameters/*
- aws_lambda_powertools/parameters/**/*
- area/batch:
+ batch:
- aws_lambda_powertools/batch/*
- aws_lambda_powertools/batch/**/*
- area/validator:
+ validator:
- aws_lambda_powertools/validation/*
- aws_lambda_powertools/validation/**/*
- area/event_sources:
+ event_sources:
- aws_lambda_powertools/data_classes/*
- aws_lambda_powertools/data_classes/**/*
- area/parser:
+ parser:
- aws_lambda_powertools/parser/*
- aws_lambda_powertools/parser/**/*
- area/idempotency:
+ idempotency:
- aws_lambda_powertools/idempotency/*
- aws_lambda_powertools/idempotency/**/*
- area/feature_flags:
+ feature_flags:
- aws_lambda_powertools/feature_flags/*
- aws_lambda_powertools/feature_flags/**/*
- area/jmespath:
+ jmespath:
- aws_lambda_powertools/utilities/jmespath_utils/*
- area/typing:
+ typing:
- aws_lambda_powertools/utilities/typing/*
- mypy.ini
- area/commons:
+ streaming:
+ - aws_lambda_powertools/utilities/streaming/*
+ commons:
- aws_lambda_powertools/shared/*
documentation:
@@ -95,7 +97,7 @@ labelPRBasedOnFilePath:
firstPRWelcomeComment: >
Thanks a lot for your first contribution! Please check out our contributing guidelines and don't hesitate to ask whatever you need.
- In the meantime, check out the #python channel on our AWS Lambda Powertools Discord: [Invite link](https://discord.gg/B8zZKbbyET)
+ In the meantime, check out the #python channel on our Powertools for AWS Lambda Discord: [Invite link](https://discord.gg/B8zZKbbyET)
# Comment to be posted to congratulate user on their first merged PR
firstPRMergeComment: >
@@ -105,7 +107,7 @@ firstPRMergeComment: >
firstIssueWelcomeComment: >
Thanks for opening your first issue here! We'll come back to you as soon as we can.
- In the meantime, check out the #python channel on our AWS Lambda Powertools Discord: [Invite link](https://discord.gg/B8zZKbbyET)
+ In the meantime, check out the #python channel on our Powertools for AWS Lambda Discord: [Invite link](https://discord.gg/B8zZKbbyET)
###### IssueLink Adder #################################################################################################
# Insert Issue (Jira/Github etc) link in PR description based on the Issue ID in PR title.
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index c0041b5a5a0..4d53389845e 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -1,37 +1,112 @@
version: 2
updates:
-
- package-ecosystem: "github-actions"
directory: "/"
schedule:
- interval: "daily"
+ interval: "weekly"
+ day: "monday"
commit-message:
prefix: chore
include: scope
+ groups:
+ github-actions:
+ patterns:
+ - "*"
- package-ecosystem: "pip"
directory: "/"
schedule:
- interval: "daily"
+ interval: "weekly"
+ day: "monday"
target-branch: "develop"
commit-message:
prefix: chore
include: scope
ignore:
- # 2022-04-23: Ignoring boto3 changes until we need to care about them.
- dependency-name: "boto3"
-
-
-# - package-ecosystem: "pip"
-# directory: "/"
-# schedule:
-# interval: "daily"
-# target-branch: "develop"
-# update_types:
-# - "semver:major"
-# labels:
-# - "do-not-merge"
-# - "dependencies"
-# commit-message:
-# prefix: chore
-# include: scope
+ groups:
+ boto-typing:
+ patterns:
+ - "mypy-boto3-*"
+ dev-dependencies:
+ patterns:
+ - "pytest*"
+ - "ruff"
+ - "mypy"
+ - "black"
+ - "coverage"
+ - "flake8*"
+ - "pre-commit"
+
+ - package-ecosystem: "npm"
+ directory: "/"
+ schedule:
+ interval: "weekly"
+ day: "monday"
+ target-branch: "develop"
+ commit-message:
+ prefix: chore
+ include: scope
+ allow:
+ - dependency-name: "aws-cdk*"
+ groups:
+ aws-cdk:
+ patterns:
+ - "aws-cdk*"
+
+ - package-ecosystem: pip
+ directory: /benchmark/src/instrumented
+ commit-message:
+ prefix: chore
+ include: scope
+ schedule:
+ interval: monthly
+
+ - package-ecosystem: pip
+ directory: /benchmark/src/reference
+ commit-message:
+ prefix: chore
+ include: scope
+ schedule:
+ interval: monthly
+
+ - package-ecosystem: docker
+ directory: /docs
+ commit-message:
+ prefix: chore
+ include: scope
+ schedule:
+ interval: monthly
+
+ - package-ecosystem: pip
+ directory: /docs
+ commit-message:
+ prefix: chore
+ include: scope
+ schedule:
+ interval: weekly
+ day: "monday"
+ groups:
+ docs-dependencies:
+ patterns:
+ - "*"
+
+ - package-ecosystem: pip
+ directory: /examples/event_handler_graphql/src
+ commit-message:
+ prefix: chore
+ include: scope
+ schedule:
+ interval: monthly
+
+ - package-ecosystem: gomod
+ directory: /layer/scripts/layer-balancer
+ commit-message:
+ prefix: chore
+ include: scope
+ schedule:
+ interval: monthly
+ groups:
+ layer-balancer:
+ patterns:
+ - "*"
diff --git a/.github/dependency-review-config.yml b/.github/dependency-review-config.yml
new file mode 100644
index 00000000000..208fd73c9e1
--- /dev/null
+++ b/.github/dependency-review-config.yml
@@ -0,0 +1,35 @@
+allow-licenses:
+ - 'Apache-1.1'
+ - 'Apache-2.0'
+ - 'MIT'
+ - 'MIT-0'
+ - 'MIT-CMU'
+ - 'MIT-enna'
+ - 'MIT-feh'
+ - 'MIT-Festival'
+ - 'MIT-Modern-Variant'
+ - 'MIT-open-group'
+ - 'MIT-testregex'
+ - 'MIT-Wu'
+ - 'BSD-1-Clause'
+ - 'BSD-2-Clause'
+ - 'BSD-2-Clause-Views'
+ - 'BSD-3-Clause'
+ - 'BSD-3-Clause-Attribution'
+ - 'BSD-3-Clause-Clear'
+ - 'BSD-3-Clause-flex'
+ - 'BSD-3-Clause-HP'
+ - 'BSD-3-Clause-LBNL'
+ - 'BSD-3-Clause-Modification'
+ - 'BSD-3-Clause-No-Military-License'
+ - 'BSD-3-Clause-No-Nuclear-License'
+ - 'BSD-3-Clause-No-Nuclear-License-2014'
+ - 'BSD-3-Clause-No-Nuclear-Warranty'
+ - 'BSD-3-Clause-Open-MPI'
+ - 'Python-2.0'
+ - 'Python-2.0.1'
+ - 'ISC'
+ - 'MPL-1.1'
+ - 'MPL-2.0'
+comment-summary-in-pr: on-failure
+fail-on-scopes: runtime
diff --git a/.github/scripts/comment_on_large_pr.js b/.github/scripts/comment_on_large_pr.js
deleted file mode 100644
index c17199faf76..00000000000
--- a/.github/scripts/comment_on_large_pr.js
+++ /dev/null
@@ -1,73 +0,0 @@
-const {
- PR_NUMBER,
- PR_ACTION,
- PR_AUTHOR,
- IGNORE_AUTHORS,
-} = require("./constants")
-
-
-/**
- * Notify PR author to split XXL PR in smaller chunks
- *
- * @param {object} core - core functions instance from @actions/core
- * @param {object} gh_client - Pre-authenticated REST client (Octokit)
- * @param {string} owner - GitHub Organization
- * @param {string} repository - GitHub repository
- */
-const notifyAuthor = async ({
- core,
- gh_client,
- owner,
- repository,
-}) => {
- core.info(`Commenting on PR ${PR_NUMBER}`)
-
- let msg = `### ⚠️Large PR detected⚠️
-
-Please consider breaking into smaller PRs to avoid significant review delays. Ignore if this PR has naturally grown to this size after reviews.
- `;
-
- try {
- await gh_client.rest.issues.createComment({
- owner: owner,
- repo: repository,
- body: msg,
- issue_number: PR_NUMBER,
- });
- } catch (error) {
- core.setFailed("Failed to notify PR author to split large PR");
- console.error(err);
- }
-}
-
-module.exports = async ({github, context, core}) => {
- if (IGNORE_AUTHORS.includes(PR_AUTHOR)) {
- return core.notice("Author in IGNORE_AUTHORS list; skipping...")
- }
-
- if (PR_ACTION != "labeled") {
- return core.notice("Only run on PRs labeling actions; skipping")
- }
-
-
- /** @type {string[]} */
- const { data: labels } = await github.rest.issues.listLabelsOnIssue({
- owner: context.repo.owner,
- repo: context.repo.repo,
- issue_number: PR_NUMBER,
- })
-
- // Schema: https://docs.github.com/en/rest/issues/labels#list-labels-for-an-issue
- for (const label of labels) {
- core.info(`Label: ${label}`)
- if (label.name == "size/XXL") {
- await notifyAuthor({
- core: core,
- gh_client: github,
- owner: context.repo.owner,
- repository: context.repo.repo,
- })
- break;
- }
- }
-}
diff --git a/.github/scripts/constants.js b/.github/scripts/constants.js
index deeaddd9c41..8bfe5571974 100644
--- a/.github/scripts/constants.js
+++ b/.github/scripts/constants.js
@@ -18,17 +18,23 @@ module.exports = Object.freeze({
/** @type {string} */
"PR_IS_MERGED": process.env.PR_IS_MERGED || "false",
+ /** @type {string} */
+ "PR_LABELS": process.env.PR_LABELS || "",
+
/** @type {string} */
"LABEL_BLOCK": "do-not-merge",
/** @type {string} */
"LABEL_BLOCK_REASON": "need-issue",
+ /** @type {string} */
+ "LABEL_BLOCK_MISSING_LICENSE_AGREEMENT": "need-license-agreement-acknowledge",
+
/** @type {string} */
"LABEL_PENDING_RELEASE": "pending-release",
/** @type {string} */
- "HANDLE_MAINTAINERS_TEAM": "@awslabs/aws-lambda-powertools-python",
+ "HANDLE_MAINTAINERS_TEAM": "@aws-powertools/powertools-lambda-python",
/** @type {string[]} */
"IGNORE_AUTHORS": ["dependabot[bot]", "markdownify[bot]"],
diff --git a/.github/scripts/download_pr_artifact.js b/.github/scripts/download_pr_artifact.js
deleted file mode 100644
index 274467c1f1c..00000000000
--- a/.github/scripts/download_pr_artifact.js
+++ /dev/null
@@ -1,26 +0,0 @@
-module.exports = async ({github, context, core}) => {
- const fs = require('fs');
-
- const workflowRunId = process.env.WORKFLOW_ID;
- core.info(`Listing artifacts for workflow run ${workflowRunId}`);
-
- const artifacts = await github.rest.actions.listWorkflowRunArtifacts({
- owner: context.repo.owner,
- repo: context.repo.repo,
- run_id: workflowRunId,
- });
-
- const matchArtifact = artifacts.data.artifacts.filter(artifact => artifact.name == "pr")[0];
-
- core.info(`Downloading artifacts for workflow run ${workflowRunId}`);
- const artifact = await github.rest.actions.downloadArtifact({
- owner: context.repo.owner,
- repo: context.repo.repo,
- artifact_id: matchArtifact.id,
- archive_format: 'zip',
- });
-
- core.info("Saving artifact found", artifact);
-
- fs.writeFileSync('pr.zip', Buffer.from(artifact.data));
-}
diff --git a/.github/scripts/enforce_acknowledgment.js b/.github/scripts/enforce_acknowledgment.js
deleted file mode 100644
index 3e3be636ede..00000000000
--- a/.github/scripts/enforce_acknowledgment.js
+++ /dev/null
@@ -1,40 +0,0 @@
-const {
-PR_ACTION,
-PR_AUTHOR,
-PR_BODY,
-PR_NUMBER,
-IGNORE_AUTHORS,
-LABEL_BLOCK,
-LABEL_BLOCK_REASON
-} = require("./constants")
-
-module.exports = async ({github, context, core}) => {
- if (IGNORE_AUTHORS.includes(PR_AUTHOR)) {
- return core.notice("Author in IGNORE_AUTHORS list; skipping...")
- }
-
- if (PR_ACTION != "opened") {
- return core.notice("Only newly open PRs are labelled to avoid spam; skipping")
- }
-
- const RELATED_ISSUE_REGEX = /Issue number:[^\d\r\n]+(?<issue>\d+)/;
- const isMatch = RELATED_ISSUE_REGEX.exec(PR_BODY);
- if (isMatch == null) {
- core.info(`No related issue found, maybe the author didn't use the template but there is one.`)
-
- let msg = "No related issues found. Please ensure there is an open issue related to this change to avoid significant delays or closure.";
- await github.rest.issues.createComment({
- owner: context.repo.owner,
- repo: context.repo.repo,
- body: msg,
- issue_number: PR_NUMBER,
- });
-
- return await github.rest.issues.addLabels({
- issue_number: PR_NUMBER,
- owner: context.repo.owner,
- repo: context.repo.repo,
- labels: [LABEL_BLOCK, LABEL_BLOCK_REASON]
- })
- }
-}
diff --git a/.github/scripts/label_missing_related_issue.js b/.github/scripts/label_missing_related_issue.js
deleted file mode 100644
index 705e414c47f..00000000000
--- a/.github/scripts/label_missing_related_issue.js
+++ /dev/null
@@ -1,40 +0,0 @@
-const {
- PR_ACTION,
- PR_AUTHOR,
- PR_BODY,
- PR_NUMBER,
- IGNORE_AUTHORS,
- LABEL_BLOCK,
- LABEL_BLOCK_REASON
-} = require("./constants")
-
-module.exports = async ({github, context, core}) => {
- if (IGNORE_AUTHORS.includes(PR_AUTHOR)) {
- return core.notice("Author in IGNORE_AUTHORS list; skipping...")
- }
-
- if (PR_ACTION != "opened") {
- return core.notice("Only newly open PRs are labelled to avoid spam; skipping")
- }
-
- const RELATED_ISSUE_REGEX = /Issue number:[^\d\r\n]+(?<issue>\d+)/;
- const isMatch = RELATED_ISSUE_REGEX.exec(PR_BODY);
- if (isMatch == null) {
- core.info(`No related issue found, maybe the author didn't use the template but there is one.`)
-
- let msg = "No related issues found. Please ensure there is an open issue related to this change to avoid significant delays or closure.";
- await github.rest.issues.createComment({
- owner: context.repo.owner,
- repo: context.repo.repo,
- body: msg,
- issue_number: PR_NUMBER,
- });
-
- return await github.rest.issues.addLabels({
- issue_number: PR_NUMBER,
- owner: context.repo.owner,
- repo: context.repo.repo,
- labels: [LABEL_BLOCK, LABEL_BLOCK_REASON]
- })
- }
-}
diff --git a/.github/scripts/label_pr_based_on_title.js b/.github/scripts/label_pr_based_on_title.js
deleted file mode 100644
index 95c33841f92..00000000000
--- a/.github/scripts/label_pr_based_on_title.js
+++ /dev/null
@@ -1,47 +0,0 @@
-const { PR_NUMBER, PR_TITLE } = require("./constants")
-
-module.exports = async ({github, context, core}) => {
- const FEAT_REGEX = /feat(\((.+)\))?(:.+)/
- const BUG_REGEX = /(fix|bug)(\((.+)\))?(:.+)/
- const DOCS_REGEX = /(docs|doc)(\((.+)\))?(:.+)/
- const CHORE_REGEX = /(chore)(\((.+)\))?(:.+)/
- const DEPRECATED_REGEX = /(deprecated)(\((.+)\))?(:.+)/
- const REFACTOR_REGEX = /(refactor)(\((.+)\))?(:.+)/
-
- const labels = {
- "feature": FEAT_REGEX,
- "bug": BUG_REGEX,
- "documentation": DOCS_REGEX,
- "internal": CHORE_REGEX,
- "enhancement": REFACTOR_REGEX,
- "deprecated": DEPRECATED_REGEX,
- }
-
- // Maintenance: We should keep track of modified PRs in case their titles change
- let miss = 0;
- try {
- for (const label in labels) {
- const matcher = new RegExp(labels[label])
- const matches = matcher.exec(PR_TITLE)
- if (matches != null) {
- core.info(`Auto-labeling PR ${PR_NUMBER} with ${label}`)
-
- await github.rest.issues.addLabels({
- issue_number: PR_NUMBER,
- owner: context.repo.owner,
- repo: context.repo.repo,
- labels: [label]
- })
-
- return;
- } else {
- core.debug(`'${PR_TITLE}' didn't match '${label}' semantic.`)
- miss += 1
- }
- }
- } finally {
- if (miss == Object.keys(labels).length) {
- core.notice(`PR ${PR_NUMBER} title '${PR_TITLE}' doesn't follow semantic titles; skipping...`)
- }
- }
-}
diff --git a/.github/scripts/label_related_issue.js b/.github/scripts/label_related_issue.js
deleted file mode 100644
index 790aac1ced5..00000000000
--- a/.github/scripts/label_related_issue.js
+++ /dev/null
@@ -1,53 +0,0 @@
-const {
- PR_AUTHOR,
- PR_BODY,
- PR_NUMBER,
- IGNORE_AUTHORS,
- LABEL_PENDING_RELEASE,
- HANDLE_MAINTAINERS_TEAM,
- PR_IS_MERGED,
-} = require("./constants")
-
-module.exports = async ({github, context, core}) => {
- if (IGNORE_AUTHORS.includes(PR_AUTHOR)) {
- return core.notice("Author in IGNORE_AUTHORS list; skipping...")
- }
-
- if (PR_IS_MERGED == "false") {
- return core.notice("Only merged PRs to avoid spam; skipping")
- }
-
- const RELATED_ISSUE_REGEX = /Issue number:[^\d\r\n]+(?<issue>\d+)/;
-
- const isMatch = RELATED_ISSUE_REGEX.exec(PR_BODY);
-
- try {
- if (!isMatch) {
- core.setFailed(`Unable to find related issue for PR number ${PR_NUMBER}.\n\n Body details: ${PR_BODY}`);
- return await github.rest.issues.createComment({
- owner: context.repo.owner,
- repo: context.repo.repo,
- body: `${HANDLE_MAINTAINERS_TEAM} No related issues found. Please ensure '${LABEL_PENDING_RELEASE}' label is applied before releasing.`,
- issue_number: PR_NUMBER,
- });
- }
- } catch (error) {
- core.setFailed(`Unable to create comment on PR number ${PR_NUMBER}.\n\n Error details: ${error}`);
- throw new Error(error);
- }
-
- const { groups: {issue} } = isMatch
-
- try {
- core.info(`Auto-labeling related issue ${issue} for release`)
- return await github.rest.issues.addLabels({
- issue_number: issue,
- owner: context.repo.owner,
- repo: context.repo.repo,
- labels: [LABEL_PENDING_RELEASE]
- })
- } catch (error) {
- core.setFailed(`Is this issue number (${issue}) valid? Perhaps a discussion?`);
- throw new Error(error);
- }
-}
diff --git a/.github/scripts/save_pr_details.js b/.github/scripts/save_pr_details.js
deleted file mode 100644
index 83bd3bf70d4..00000000000
--- a/.github/scripts/save_pr_details.js
+++ /dev/null
@@ -1,13 +0,0 @@
-module.exports = async ({context, core}) => {
- const fs = require('fs');
- const filename = "pr.txt";
-
- try {
- fs.writeFileSync(`./${filename}`, JSON.stringify(context.payload));
-
- return `PR successfully saved ${filename}`
- } catch (err) {
- core.setFailed("Failed to save PR details");
- console.error(err);
- }
-}
diff --git a/.github/workflows/auto-merge.yml b/.github/workflows/auto-merge.yml
deleted file mode 100644
index b63d0331edd..00000000000
--- a/.github/workflows/auto-merge.yml
+++ /dev/null
@@ -1,39 +0,0 @@
-name: auto-merge
-
-on:
- pull_request:
- types: [opened, edited, synchronize]
-
-permissions:
- contents: write
-
-jobs:
- dependabot:
- runs-on: ubuntu-latest
- if: ${{ github.actor == 'dependabot[bot]' }}
- steps:
- - name: Dependabot metadata
- id: metadata
- uses: dependabot/fetch-metadata@v1.3.3
- with:
- github-token: "${{ secrets.GITHUB_TOKEN }}"
- - name: Enable auto-merge for mypy-boto3 stubs Dependabot PRs
- if: ${{ contains(steps.metadata.outputs.dependency-names, 'mypy-boto3') && steps.metadata.outputs.update-type != 'version-update:semver-major' }}
- run: gh pr merge --auto --squash "$PR_URL"
- env:
- PR_URL: ${{github.event.pull_request.html_url}}
- GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
- # Maintenance: Experiment with literal array (toJSON('["dep1", "dep2"]')) to ease extending it
- - name: Enable auto-merge for CDK Construct Lambda Layer Dependabot PRs
- if: ${{ contains(steps.metadata.outputs.dependency-names, 'cdk-lambda-powertools-python-layer') && steps.metadata.outputs.update-type != 'version-update:semver-major' }}
- run: gh pr merge --auto --squash "$PR_URL"
- env:
- PR_URL: ${{github.event.pull_request.html_url}}
- GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
- # Maintenance: Revisit if CDK Constructs make breaking changes like CDK v1
- - name: Enable auto-merge for CDK Lib Construct
- if: ${{ contains(steps.metadata.outputs.dependency-names, 'aws-cdk-lib') && steps.metadata.outputs.update-type != 'version-update:semver-major' }}
- run: gh pr merge --auto --squash "$PR_URL"
- env:
- PR_URL: ${{github.event.pull_request.html_url}}
- GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
diff --git a/.github/workflows/bootstrap_region.yml b/.github/workflows/bootstrap_region.yml
new file mode 100644
index 00000000000..dc8c142efd5
--- /dev/null
+++ b/.github/workflows/bootstrap_region.yml
@@ -0,0 +1,117 @@
+name: Region Bootstrap
+
+# bootstraps new regions
+#
+# PURPOSE
+# Ensures new regions are deployable in future releases
+#
+# JOB 1 PROCESS
+#
+# 1. Installs CDK
+# 2. Bootstraps region
+#
+# JOB 2 PROCESS
+# 1. Sets up Go
+# 2. Installs the balance script
+# 3. Runs balance script to copy layers between aws regions
+
+on:
+ workflow_dispatch:
+ inputs:
+ environment:
+ type: choice
+ options:
+ - beta
+ - prod
+ description: Deployment environment
+ region:
+ type: string
+ required: true
+ description: AWS region to bootstrap (i.e. eu-west-1)
+
+run-name: Region Bootstrap ${{ inputs.region }}
+
+permissions:
+ contents: read
+
+jobs:
+ cdk:
+ name: Install CDK
+ runs-on: ubuntu-latest
+ permissions:
+ contents: read
+ id-token: write
+ environment: layer-${{ inputs.environment }}
+ steps:
+ - name: checkout
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ github.sha }}
+ - name: Setup Node.js
+ uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+ with:
+ node-version: "22"
+ - name: Setup dependencies
+ uses: aws-powertools/actions/.github/actions/cached-node-modules@828e78a26eee3554dc2e1d96048004548fbb169f
+ - id: credentials
+ name: AWS Credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885
+ with:
+ aws-region: ${{ inputs.region }}
+ role-to-assume: ${{ secrets.REGION_IAM_ROLE }}
+ mask-aws-account-id: true
+ - id: workdir
+ name: Create Workdir
+ run: |
+ mkdir -p build/project
+ - id: cdk-project
+ name: CDK Project
+ working-directory: build/project
+ run: |
+ npx cdk init app --language=typescript
+ AWS_REGION="${{ inputs.region }}" npx cdk bootstrap
+
+ copy_layers:
+ name: Copy Layers
+ runs-on: ubuntu-latest
+ permissions:
+ contents: read
+ id-token: write
+ strategy:
+ matrix:
+ layer:
+ - AWSLambdaPowertoolsPythonV3-python39-arm64
+ - AWSLambdaPowertoolsPythonV3-python310-arm64
+ - AWSLambdaPowertoolsPythonV3-python311-arm64
+ - AWSLambdaPowertoolsPythonV3-python312-arm64
+ - AWSLambdaPowertoolsPythonV3-python313-arm64
+ - AWSLambdaPowertoolsPythonV3-python314-arm64
+ - AWSLambdaPowertoolsPythonV3-python39-x86_64
+ - AWSLambdaPowertoolsPythonV3-python310-x86_64
+ - AWSLambdaPowertoolsPythonV3-python311-x86_64
+ - AWSLambdaPowertoolsPythonV3-python312-x86_64
+ - AWSLambdaPowertoolsPythonV3-python313-x86_64
+ - AWSLambdaPowertoolsPythonV3-python314-x86_64
+ environment: layer-${{ inputs.environment }}
+ steps:
+ - id: credentials
+ name: AWS Credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ aws-region: us-east-1
+ role-to-assume: ${{ secrets.REGION_IAM_ROLE }}
+ mask-aws-account-id: true
+ - id: go-setup
+ name: Setup Go
+ uses: actions/setup-go@4a3601121dd01d1626a1e23e37211e3254c1c06c # v6.4.0
+ with:
+ go-version: '>=1.23.0'
+ - id: go-env
+ name: Go Env
+ run: go env
+ - id: go-install-pkg
+ name: Install
+ run: go install github.com/aws-powertools/actions/layer-balancer/cmd/balance@29979bc5339bf54f76a11ac36ff67701986bb0f0
+ - id: run-balance
+ name: Run Balance
+ run: balance -read-region us-east-1 -write-region ${{ inputs.region }} -write-role ${{ secrets.BALANCE_ROLE_ARN }} -layer-name ${{ matrix.layer }} -dry-run=false
diff --git a/.github/workflows/build_changelog.yml b/.github/workflows/build_changelog.yml
index 3cd6fffe855..9509114b423 100644
--- a/.github/workflows/build_changelog.yml
+++ b/.github/workflows/build_changelog.yml
@@ -1,9 +1,25 @@
# Standalone workflow to update changelog if necessary
name: Build changelog
+# PROCESS
+#
+# 1. Fetch latest changes compared to the latest tag
+# 2. Rebuild CHANGELOG.md using Keep A Changelog format
+# 3. Create a PR with the latest changelog (close and reference any it supersedes)
+
+# USAGE
+#
+# Triggered manually from GitHub UI when needed (e.g., before a release).
+
on:
workflow_dispatch:
+permissions:
+ contents: read
+
jobs:
changelog:
+ permissions:
+ contents: write # create temporary branch to store changelog changes
+ pull-requests: write # create PR with changelog changes
uses: ./.github/workflows/reusable_publish_changelog.yml
diff --git a/.github/workflows/cflite_scheduled.yml b/.github/workflows/cflite_scheduled.yml
new file mode 100644
index 00000000000..1c4825b822f
--- /dev/null
+++ b/.github/workflows/cflite_scheduled.yml
@@ -0,0 +1,34 @@
+name: ClusterFuzzLite fuzzing
+
+on:
+ schedule:
+ # Run daily at 8 AM UTC
+ - cron: "0 8 * * *"
+ workflow_dispatch:
+
+permissions:
+ contents: read
+
+jobs:
+ PR:
+ runs-on: ubuntu-latest
+ concurrency:
+ group: ${{ github.workflow }}-${{ github.ref }}
+ cancel-in-progress: true
+ steps:
+ - name: Build Fuzzers
+ id: build
+ uses: google/clusterfuzzlite/actions/build_fuzzers@884713a6c30a92e5e8544c39945cd7cb630abcd1 # v1
+ with:
+ language: python
+ github-token: ${{ secrets.GITHUB_TOKEN }}
+ sanitizer: address
+
+ - name: Run Fuzzers
+ id: run
+ uses: google/clusterfuzzlite/actions/run_fuzzers@884713a6c30a92e5e8544c39945cd7cb630abcd1 # v1
+ with:
+ github-token: ${{ secrets.GITHUB_TOKEN }}
+ fuzz-seconds: 30
+ mode: code-change
+ sanitizer: address
diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
index f8a7849e7ea..7aeb1c4e2bd 100644
--- a/.github/workflows/codeql-analysis.yml
+++ b/.github/workflows/codeql-analysis.yml
@@ -1,36 +1,38 @@
name: "CodeQL"
+# PROCESS
+#
+# 1. Static code analysis with CodeQL
+
+# USAGE
+#
+# NOTE: This is our slowest workflow hence it only runs on code merged.
+#
+# Always triggered on PR merge when source code changes.
+
on:
push:
- branches: [develop, v2]
+ branches: [develop]
+
+permissions:
+ contents: read
jobs:
analyze:
name: Analyze
+ if: github.repository == 'aws-powertools/powertools-lambda-python'
runs-on: ubuntu-latest
-
- strategy:
- fail-fast: false
- matrix:
- # Override automatic language detection by changing the below list
- # Supported options are ['csharp', 'cpp', 'go', 'java', 'javascript', 'python']
- language: ["python"]
- # Learn more...
- # https://docs.github.com/en/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#overriding-automatic-language-detection
+ permissions:
+ security-events: write
+ actions: read
steps:
- name: Checkout repository
- uses: actions/checkout@v3
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
# Initializes the CodeQL tools for scanning.
- name: Initialize CodeQL
- uses: github/codeql-action/init@v2
- with:
- languages: ${{ matrix.language }}
- # If you wish to specify custom queries, you can do so here or in a config file.
- # By default, queries listed here will override any specified in a config file.
- # Prefix the list here with "+" to use these queries and those in the config file.
- # queries: ./path/to/local/query, your-org/your-repo/queries@main
+ uses: github/codeql-action/init@f31a31c052207cc13b328d6295c5b728bb49568c # v2.13.1
- name: Perform CodeQL Analysis
- uses: github/codeql-action/analyze@v2
+ uses: github/codeql-action/analyze@f31a31c052207cc13b328d6295c5b728bb49568c # v2.13.1
diff --git a/.github/workflows/dependency-review.yml b/.github/workflows/dependency-review.yml
new file mode 100644
index 00000000000..60ce40982bf
--- /dev/null
+++ b/.github/workflows/dependency-review.yml
@@ -0,0 +1,25 @@
+# Dependency Review Action
+#
+# This Action will scan dependency manifest files that change as part of a Pull Request,
+# surfacing known-vulnerable versions of the packages declared or updated in the PR.
+# Once installed, if the workflow run is marked as required,
+# PRs introducing known-vulnerable packages will be blocked from merging.
+#
+# Source repository: https://github.com/actions/dependency-review-action
+name: 'Dependency Review'
+on: [pull_request]
+
+permissions:
+ contents: read
+
+jobs:
+ dependency-review:
+ runs-on: ubuntu-latest
+ permissions:
+ contents: read
+ pull-requests: write
+ steps:
+ - name: 'Checkout Repository'
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ - name: 'Dependency Review'
+ uses: actions/dependency-review-action@a1d282b36b6f3519aa1f3fc636f609c47dddb294 # v5.0.0
diff --git a/.github/workflows/label_pr_on_title.yml b/.github/workflows/label_pr_on_title.yml
deleted file mode 100644
index 3815a49e9bd..00000000000
--- a/.github/workflows/label_pr_on_title.yml
+++ /dev/null
@@ -1,38 +0,0 @@
-name: Label PR based on title
-
-on:
- workflow_run:
- workflows: ["Record PR details"]
- types:
- - completed
-
-jobs:
- get_pr_details:
- # Guardrails to only ever run if PR recording workflow was indeed
- # run in a PR event and ran successfully
- if: ${{ github.event.workflow_run.conclusion == 'success' }}
- uses: ./.github/workflows/reusable_export_pr_details.yml
- with:
- record_pr_workflow_id: ${{ github.event.workflow_run.id }}
- workflow_origin: ${{ github.event.repository.full_name }}
- secrets:
- token: ${{ secrets.GITHUB_TOKEN }}
- label_pr:
- needs: get_pr_details
- runs-on: ubuntu-latest
- steps:
- - name: Checkout repository
- uses: actions/checkout@v3
- - name: "Label PR based on title"
- uses: actions/github-script@v6
- env:
- PR_NUMBER: ${{ needs.get_pr_details.outputs.prNumber }}
- PR_TITLE: ${{ needs.get_pr_details.outputs.prTitle }}
- with:
- github-token: ${{ secrets.GITHUB_TOKEN }}
- # This safely runs in our base repo, not on fork
- # thus allowing us to provide a write access token to label based on PR title
- # and label PR based on semantic title accordingly
- script: |
- const script = require('.github/scripts/label_pr_based_on_title.js')
- await script({github, context, core})
diff --git a/.github/workflows/layer_govcloud.yml b/.github/workflows/layer_govcloud.yml
new file mode 100644
index 00000000000..9daf6725808
--- /dev/null
+++ b/.github/workflows/layer_govcloud.yml
@@ -0,0 +1,224 @@
+name: Layer Deployment (GovCloud)
+
+# GovCloud Layer Publish
+# ---
+# This workflow publishes a specific layer version in an AWS account based on the environment input.
+#
+# Using a matrix, we pull each architecture and python version of the layer and store them as artifacts
+# we upload them to each of the GovCloud AWS accounts.
+#
+# A number of safety checks are performed to ensure safety.
+
+on:
+ workflow_dispatch:
+ inputs:
+ environment:
+ description: Deployment environment
+ type: choice
+ options:
+ - Gamma
+ - Prod
+ required: true
+ version:
+ description: Layer version to duplicate
+ type: string
+ required: true
+ workflow_call:
+ inputs:
+ environment:
+ description: Deployment environment
+ type: string
+ required: true
+ version:
+ description: Layer version to duplicate
+ type: string
+ required: true
+
+run-name: Layer Deployment (GovCloud) - ${{ inputs.environment }}
+
+permissions:
+ contents: read
+
+jobs:
+ download:
+ runs-on: ubuntu-latest
+ permissions:
+ id-token: write
+ contents: read
+ strategy:
+ matrix:
+ layer:
+ - AWSLambdaPowertoolsPythonV3-python39
+ - AWSLambdaPowertoolsPythonV3-python310
+ - AWSLambdaPowertoolsPythonV3-python311
+ - AWSLambdaPowertoolsPythonV3-python312
+ - AWSLambdaPowertoolsPythonV3-python313
+ - AWSLambdaPowertoolsPythonV3-python314
+ arch:
+ - arm64
+ - x86_64
+ environment: Prod (Readonly)
+ steps:
+ - name: Configure AWS Credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ role-to-assume: ${{ secrets.AWS_IAM_ROLE }}
+ aws-region: us-east-1
+ mask-aws-account-id: true
+ - name: Grab Zip
+ run: |
+ aws --region us-east-1 lambda get-layer-version-by-arn --arn arn:aws:lambda:us-east-1:017000801446:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ inputs.version }} --query 'Content.Location' | xargs curl -L -o ${{ matrix.layer }}_${{ matrix.arch }}.zip
+ aws --region us-east-1 lambda get-layer-version-by-arn --arn arn:aws:lambda:us-east-1:017000801446:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ inputs.version }} > ${{ matrix.layer }}_${{ matrix.arch }}.json
+ - name: Store Zip
+ uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+ with:
+ name: ${{ matrix.layer }}_${{ matrix.arch }}.zip
+ path: ${{ matrix.layer }}_${{ matrix.arch }}.zip
+ retention-days: 1
+ if-no-files-found: error
+ - name: Store Metadata
+ uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+ with:
+ name: ${{ matrix.layer }}_${{ matrix.arch }}.json
+ path: ${{ matrix.layer }}_${{ matrix.arch }}.json
+ retention-days: 1
+ if-no-files-found: error
+
+ copy_east:
+ name: Copy (East)
+ needs: download
+ runs-on: ubuntu-latest
+ permissions:
+ id-token: write
+ contents: read
+ strategy:
+ matrix:
+ layer:
+ - AWSLambdaPowertoolsPythonV3-python39
+ - AWSLambdaPowertoolsPythonV3-python310
+ - AWSLambdaPowertoolsPythonV3-python311
+ - AWSLambdaPowertoolsPythonV3-python312
+ - AWSLambdaPowertoolsPythonV3-python313
+ - AWSLambdaPowertoolsPythonV3-python314
+ arch:
+ - arm64
+ - x86_64
+ environment: GovCloud ${{ inputs.environment }} (East)
+ steps:
+ - name: Download Zip
+ uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+ with:
+ name: ${{ matrix.layer }}_${{ matrix.arch }}.zip
+ - name: Download Metadata
+ uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+ with:
+ name: ${{ matrix.layer }}_${{ matrix.arch }}.json
+ - name: Verify Layer Signature
+ run: |
+ SHA=$(jq -r '.Content.CodeSha256' '${{ matrix.layer }}_${{ matrix.arch }}.json')
+ test "$(openssl dgst -sha256 -binary ${{ matrix.layer }}_${{ matrix.arch }}.zip | openssl enc -base64)" == "$SHA" && echo "SHA OK: ${SHA}" || exit 1
+ - name: Configure AWS Credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ role-to-assume: ${{ secrets.AWS_IAM_ROLE }}
+ aws-region: us-gov-east-1
+ mask-aws-account-id: true
+ - name: Create Layer
+ id: create-layer
+ run: |
+ LAYER_VERSION=$(aws --region us-gov-east-1 lambda publish-layer-version \
+ --layer-name ${{ matrix.layer }}-${{ matrix.arch }} \
+ --zip-file fileb://./${{ matrix.layer }}_${{ matrix.arch }}.zip \
+ --compatible-runtimes "$(jq -r '.CompatibleRuntimes[0]' '${{ matrix.layer }}_${{ matrix.arch }}.json')" \
+ --compatible-architectures "$(jq -r '.CompatibleArchitectures[0]' '${{ matrix.layer }}_${{ matrix.arch }}.json')" \
+ --license-info "MIT-0" \
+ --description "$(jq -r '.Description' '${{ matrix.layer }}_${{ matrix.arch }}.json')" \
+ --query 'Version' \
+ --output text)
+
+ echo "LAYER_VERSION=$LAYER_VERSION" >> "$GITHUB_OUTPUT"
+
+ aws --region us-gov-east-1 lambda add-layer-version-permission \
+ --layer-name '${{ matrix.layer }}-${{ matrix.arch }}' \
+ --statement-id 'PublicLayer' \
+ --action lambda:GetLayerVersion \
+ --principal '*' \
+ --version-number "$LAYER_VERSION"
+ - name: Verify Layer
+ env:
+ LAYER_VERSION: ${{ steps.create-layer.outputs.LAYER_VERSION }}
+ run: |
+ REMOTE_SHA=$(aws --region us-gov-east-1 lambda get-layer-version-by-arn --arn 'arn:aws-us-gov:lambda:us-gov-east-1:${{ secrets.AWS_ACCOUNT_ID }}:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ env.LAYER_VERSION }}' --query 'Content.CodeSha256' --output text)
+ SHA=$(jq -r '.Content.CodeSha256' '${{ matrix.layer }}_${{ matrix.arch }}.json')
+ test "$REMOTE_SHA" == "$SHA" && echo "SHA OK: ${SHA}" || exit 1
+ aws --region us-gov-east-1 lambda get-layer-version-by-arn --arn 'arn:aws-us-gov:lambda:us-gov-east-1:${{ secrets.AWS_ACCOUNT_ID }}:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ env.LAYER_VERSION }}' --output table
+
+ copy_west:
+ name: Copy (West)
+ needs: download
+ runs-on: ubuntu-latest
+ permissions:
+ id-token: write
+ contents: read
+ strategy:
+ matrix:
+ layer:
+ - AWSLambdaPowertoolsPythonV3-python39
+ - AWSLambdaPowertoolsPythonV3-python310
+ - AWSLambdaPowertoolsPythonV3-python311
+ - AWSLambdaPowertoolsPythonV3-python312
+ - AWSLambdaPowertoolsPythonV3-python313
+ - AWSLambdaPowertoolsPythonV3-python314
+ arch:
+ - arm64
+ - x86_64
+ environment:
+ name: GovCloud ${{ inputs.environment }} (West)
+ steps:
+ - name: Download Zip
+ uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+ with:
+ name: ${{ matrix.layer }}_${{ matrix.arch }}.zip
+ - name: Download Metadata
+ uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+ with:
+ name: ${{ matrix.layer }}_${{ matrix.arch }}.json
+ - name: Verify Layer Signature
+ run: |
+ SHA=$(jq -r '.Content.CodeSha256' '${{ matrix.layer }}_${{ matrix.arch }}.json')
+ test "$(openssl dgst -sha256 -binary ${{ matrix.layer }}_${{ matrix.arch }}.zip | openssl enc -base64)" == "$SHA" && echo "SHA OK: ${SHA}" || exit 1
+ - name: Configure AWS Credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ role-to-assume: ${{ secrets.AWS_IAM_ROLE }}
+ aws-region: us-gov-west-1
+ mask-aws-account-id: true
+ - name: Create Layer
+ id: create-layer
+ run: |
+ LAYER_VERSION=$(aws --region us-gov-west-1 lambda publish-layer-version \
+ --layer-name ${{ matrix.layer }}-${{ matrix.arch }} \
+ --zip-file fileb://./${{ matrix.layer }}_${{ matrix.arch }}.zip \
+ --compatible-runtimes "$(jq -r '.CompatibleRuntimes[0]' '${{ matrix.layer }}_${{ matrix.arch }}.json')" \
+ --compatible-architectures "$(jq -r '.CompatibleArchitectures[0]' '${{ matrix.layer }}_${{ matrix.arch }}.json')" \
+ --license-info "MIT-0" \
+ --description "$(jq -r '.Description' '${{ matrix.layer }}_${{ matrix.arch }}.json')" \
+ --query 'Version' \
+ --output text)
+
+ echo "LAYER_VERSION=$LAYER_VERSION" >> "$GITHUB_OUTPUT"
+
+ aws --region us-gov-west-1 lambda add-layer-version-permission \
+ --layer-name '${{ matrix.layer }}-${{ matrix.arch }}' \
+ --statement-id 'PublicLayer' \
+ --action lambda:GetLayerVersion \
+ --principal '*' \
+ --version-number "$LAYER_VERSION"
+ - name: Verify Layer
+ env:
+ LAYER_VERSION: ${{ steps.create-layer.outputs.LAYER_VERSION }}
+ run: |
+ REMOTE_SHA=$(aws --region us-gov-west-1 lambda get-layer-version-by-arn --arn 'arn:aws-us-gov:lambda:us-gov-west-1:${{ secrets.AWS_ACCOUNT_ID }}:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ env.LAYER_VERSION }}' --query 'Content.CodeSha256' --output text)
+ SHA=$(jq -r '.Content.CodeSha256' '${{ matrix.layer }}_${{ matrix.arch }}.json')
+ test "$REMOTE_SHA" == "$SHA" && echo "SHA OK: ${SHA}" || exit 1
+ aws --region us-gov-west-1 lambda get-layer-version-by-arn --arn 'arn:aws-us-gov:lambda:us-gov-west-1:${{ secrets.AWS_ACCOUNT_ID }}:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ env.LAYER_VERSION }}' --output table
diff --git a/.github/workflows/layer_govcloud_python313.yml b/.github/workflows/layer_govcloud_python313.yml
new file mode 100644
index 00000000000..1dc2f4242d2
--- /dev/null
+++ b/.github/workflows/layer_govcloud_python313.yml
@@ -0,0 +1,209 @@
+name: Layer Deployment (GovCloud) - Temporary for Python 3.13
+
+# GovCloud Layer Publish
+# ---
+# This workflow publishes a specific layer version in an AWS account based on the environment input.
+#
+# Using a matrix, we pull each architecture and python version of the layer and store them as artifacts
+# we upload them to each of the GovCloud AWS accounts.
+#
+# A number of safety checks are performed to ensure safety.
+
+on:
+ workflow_dispatch:
+ inputs:
+ environment:
+ description: Deployment environment
+ type: choice
+ options:
+ - Gamma
+ - Prod
+ required: true
+ version:
+ description: Layer version to duplicate
+ type: string
+ required: true
+ workflow_call:
+ inputs:
+ environment:
+ description: Deployment environment
+ type: string
+ required: true
+ version:
+ description: Layer version to duplicate
+ type: string
+ required: true
+
+run-name: Layer Deployment (GovCloud) - ${{ inputs.environment }}
+
+permissions:
+ contents: read
+
+jobs:
+ download:
+ runs-on: ubuntu-latest
+ permissions:
+ id-token: write
+ contents: read
+ strategy:
+ matrix:
+ layer:
+ - AWSLambdaPowertoolsPythonV3-python313
+ arch:
+ - arm64
+ - x86_64
+ environment: Prod (Readonly)
+ steps:
+ - name: Configure AWS Credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ role-to-assume: ${{ secrets.AWS_IAM_ROLE }}
+ aws-region: us-east-1
+ mask-aws-account-id: true
+ - name: Grab Zip
+ run: |
+ aws --region us-east-1 lambda get-layer-version-by-arn --arn arn:aws:lambda:us-east-1:017000801446:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ inputs.version }} --query 'Content.Location' | xargs curl -L -o ${{ matrix.layer }}_${{ matrix.arch }}.zip
+ aws --region us-east-1 lambda get-layer-version-by-arn --arn arn:aws:lambda:us-east-1:017000801446:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ inputs.version }} > ${{ matrix.layer }}_${{ matrix.arch }}.json
+ - name: Store Zip
+ uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+ with:
+ name: ${{ matrix.layer }}_${{ matrix.arch }}.zip
+ path: ${{ matrix.layer }}_${{ matrix.arch }}.zip
+ retention-days: 1
+ if-no-files-found: error
+ - name: Store Metadata
+ uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+ with:
+ name: ${{ matrix.layer }}_${{ matrix.arch }}.json
+ path: ${{ matrix.layer }}_${{ matrix.arch }}.json
+ retention-days: 1
+ if-no-files-found: error
+
+ copy_east:
+ name: Copy (East)
+ needs: download
+ runs-on: ubuntu-latest
+ permissions:
+ id-token: write
+ contents: read
+ strategy:
+ matrix:
+ layer:
+ - AWSLambdaPowertoolsPythonV3-python313
+ arch:
+ - arm64
+ - x86_64
+ environment: GovCloud ${{ inputs.environment }} (East)
+ steps:
+ - name: Download Zip
+ uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+ with:
+ name: ${{ matrix.layer }}_${{ matrix.arch }}.zip
+ - name: Download Metadata
+ uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+ with:
+ name: ${{ matrix.layer }}_${{ matrix.arch }}.json
+ - name: Verify Layer Signature
+ run: |
+ SHA=$(jq -r '.Content.CodeSha256' '${{ matrix.layer }}_${{ matrix.arch }}.json')
+ test "$(openssl dgst -sha256 -binary ${{ matrix.layer }}_${{ matrix.arch }}.zip | openssl enc -base64)" == "$SHA" && echo "SHA OK: ${SHA}" || exit 1
+ - name: Configure AWS Credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ role-to-assume: ${{ secrets.AWS_IAM_ROLE }}
+ aws-region: us-gov-east-1
+ mask-aws-account-id: true
+ - name: Create Layer
+ id: create-layer
+ run: |
+ LAYER_VERSION=$(aws --region us-gov-east-1 lambda publish-layer-version \
+ --layer-name ${{ matrix.layer }}-${{ matrix.arch }} \
+ --zip-file fileb://./${{ matrix.layer }}_${{ matrix.arch }}.zip \
+ --compatible-runtimes "$(jq -r '.CompatibleRuntimes[0]' '${{ matrix.layer }}_${{ matrix.arch }}.json')" \
+ --compatible-architectures "$(jq -r '.CompatibleArchitectures[0]' '${{ matrix.layer }}_${{ matrix.arch }}.json')" \
+ --license-info "MIT-0" \
+ --description "$(jq -r '.Description' '${{ matrix.layer }}_${{ matrix.arch }}.json')" \
+ --query 'Version' \
+ --output text)
+
+ echo "LAYER_VERSION=$LAYER_VERSION" >> "$GITHUB_OUTPUT"
+
+ aws --region us-gov-east-1 lambda add-layer-version-permission \
+ --layer-name '${{ matrix.layer }}-${{ matrix.arch }}' \
+ --statement-id 'PublicLayer' \
+ --action lambda:GetLayerVersion \
+ --principal '*' \
+ --version-number "$LAYER_VERSION"
+ - name: Verify Layer
+ env:
+ LAYER_VERSION: ${{ steps.create-layer.outputs.LAYER_VERSION }}
+ run: |
+ REMOTE_SHA=$(aws --region us-gov-east-1 lambda get-layer-version-by-arn --arn 'arn:aws-us-gov:lambda:us-gov-east-1:${{ secrets.AWS_ACCOUNT_ID }}:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ env.LAYER_VERSION }}' --query 'Content.CodeSha256' --output text)
+ SHA=$(jq -r '.Content.CodeSha256' '${{ matrix.layer }}_${{ matrix.arch }}.json')
+ test "$REMOTE_SHA" == "$SHA" && echo "SHA OK: ${SHA}" || exit 1
+ aws --region us-gov-east-1 lambda get-layer-version-by-arn --arn 'arn:aws-us-gov:lambda:us-gov-east-1:${{ secrets.AWS_ACCOUNT_ID }}:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ env.LAYER_VERSION }}' --output table
+
+ copy_west:
+ name: Copy (West)
+ needs: download
+ runs-on: ubuntu-latest
+ permissions:
+ id-token: write
+ contents: read
+ strategy:
+ matrix:
+ layer:
+ - AWSLambdaPowertoolsPythonV3-python313
+ arch:
+ - arm64
+ - x86_64
+ environment:
+ name: GovCloud ${{ inputs.environment }} (West)
+ steps:
+ - name: Download Zip
+ uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+ with:
+ name: ${{ matrix.layer }}_${{ matrix.arch }}.zip
+ - name: Download Metadata
+ uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+ with:
+ name: ${{ matrix.layer }}_${{ matrix.arch }}.json
+ - name: Verify Layer Signature
+ run: |
+ SHA=$(jq -r '.Content.CodeSha256' '${{ matrix.layer }}_${{ matrix.arch }}.json')
+ test "$(openssl dgst -sha256 -binary ${{ matrix.layer }}_${{ matrix.arch }}.zip | openssl enc -base64)" == "$SHA" && echo "SHA OK: ${SHA}" || exit 1
+ - name: Configure AWS Credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ role-to-assume: ${{ secrets.AWS_IAM_ROLE }}
+ aws-region: us-gov-west-1
+ mask-aws-account-id: true
+ - name: Create Layer
+ id: create-layer
+ run: |
+ LAYER_VERSION=$(aws --region us-gov-west-1 lambda publish-layer-version \
+ --layer-name ${{ matrix.layer }}-${{ matrix.arch }} \
+ --zip-file fileb://./${{ matrix.layer }}_${{ matrix.arch }}.zip \
+ --compatible-runtimes "$(jq -r '.CompatibleRuntimes[0]' '${{ matrix.layer }}_${{ matrix.arch }}.json')" \
+ --compatible-architectures "$(jq -r '.CompatibleArchitectures[0]' '${{ matrix.layer }}_${{ matrix.arch }}.json')" \
+ --license-info "MIT-0" \
+ --description "$(jq -r '.Description' '${{ matrix.layer }}_${{ matrix.arch }}.json')" \
+ --query 'Version' \
+ --output text)
+
+ echo "LAYER_VERSION=$LAYER_VERSION" >> "$GITHUB_OUTPUT"
+
+ aws --region us-gov-west-1 lambda add-layer-version-permission \
+ --layer-name '${{ matrix.layer }}-${{ matrix.arch }}' \
+ --statement-id 'PublicLayer' \
+ --action lambda:GetLayerVersion \
+ --principal '*' \
+ --version-number "$LAYER_VERSION"
+ - name: Verify Layer
+ env:
+ LAYER_VERSION: ${{ steps.create-layer.outputs.LAYER_VERSION }}
+ run: |
+ REMOTE_SHA=$(aws --region us-gov-west-1 lambda get-layer-version-by-arn --arn 'arn:aws-us-gov:lambda:us-gov-west-1:${{ secrets.AWS_ACCOUNT_ID }}:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ env.LAYER_VERSION }}' --query 'Content.CodeSha256' --output text)
+ SHA=$(jq -r '.Content.CodeSha256' '${{ matrix.layer }}_${{ matrix.arch }}.json')
+ test "$REMOTE_SHA" == "$SHA" && echo "SHA OK: ${SHA}" || exit 1
+ aws --region us-gov-west-1 lambda get-layer-version-by-arn --arn 'arn:aws-us-gov:lambda:us-gov-west-1:${{ secrets.AWS_ACCOUNT_ID }}:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ env.LAYER_VERSION }}' --output table
diff --git a/.github/workflows/layer_govcloud_verify.yml b/.github/workflows/layer_govcloud_verify.yml
new file mode 100644
index 00000000000..004f9e091fb
--- /dev/null
+++ b/.github/workflows/layer_govcloud_verify.yml
@@ -0,0 +1,114 @@
+# GovCloud Layer Verification
+# ---
+# This workflow queries the GovCloud layer info in production only
+
+on:
+ workflow_dispatch:
+ inputs:
+ version:
+ description: Layer version to verify information
+ type: string
+ required: true
+ workflow_call:
+ inputs:
+ version:
+ description: Layer version to verify information
+ type: string
+ required: true
+
+name: Layer Verification (GovCloud)
+run-name: Layer Verification (GovCloud)
+
+jobs:
+ commercial:
+ runs-on: ubuntu-latest
+ permissions:
+ id-token: write
+ contents: read
+ strategy:
+ matrix:
+ layer:
+ - AWSLambdaPowertoolsPythonV3-python39
+ - AWSLambdaPowertoolsPythonV3-python310
+ - AWSLambdaPowertoolsPythonV3-python311
+ - AWSLambdaPowertoolsPythonV3-python312
+ - AWSLambdaPowertoolsPythonV3-python313
+ - AWSLambdaPowertoolsPythonV3-python314
+ arch:
+ - arm64
+ - x86_64
+ environment: Prod (Readonly)
+ steps:
+ - name: Configure AWS Credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ role-to-assume: ${{ secrets.AWS_IAM_ROLE }}
+ aws-region: us-east-1
+ mask-aws-account-id: true
+ - name: Output ${{ matrix.layer }}-${{ matrix.arch }}
+ run: |
+ aws --region us-east-1 lambda get-layer-version-by-arn --arn 'arn:aws:lambda:us-east-1:017000801446:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ inputs.version }}' | jq -r '{"Layer Version Arn": .LayerVersionArn, "Version": .Version, "Description": .Description, "Compatible Runtimes": .CompatibleRuntimes[0], "Compatible Architectures": .CompatibleArchitectures[0], "SHA": .Content.CodeSha256} | keys[] as $k | [$k, .[$k]] | @tsv' | column -t -s $'\t'
+
+ gov_east:
+ name: Verify (East)
+ needs: commercial
+ runs-on: ubuntu-latest
+ permissions:
+ id-token: write
+ contents: read
+ strategy:
+ matrix:
+ layer:
+ - AWSLambdaPowertoolsPythonV3-python39
+ - AWSLambdaPowertoolsPythonV3-python310
+ - AWSLambdaPowertoolsPythonV3-python311
+ - AWSLambdaPowertoolsPythonV3-python312
+ - AWSLambdaPowertoolsPythonV3-python313
+ - AWSLambdaPowertoolsPythonV3-python314
+ arch:
+ - arm64
+ - x86_64
+ environment: GovCloud Prod (East)
+ steps:
+ - name: Configure AWS Credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ role-to-assume: ${{ secrets.AWS_IAM_ROLE }}
+ aws-region: us-gov-east-1
+ mask-aws-account-id: true
+ - name: Verify Layer ${{ matrix.layer }}-${{ matrix.arch }}
+ id: verify-layer
+ run: |
+ aws --region us-gov-east-1 lambda get-layer-version-by-arn --arn 'arn:aws-us-gov:lambda:us-gov-east-1:${{ secrets.AWS_ACCOUNT_ID }}:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ inputs.version }}' | jq -r '{"Layer Version Arn": .LayerVersionArn, "Version": .Version, "Description": .Description, "Compatible Runtimes": .CompatibleRuntimes[0], "Compatible Architectures": .CompatibleArchitectures[0], "SHA": .Content.CodeSha256} | keys[] as $k | [$k, .[$k]] | @tsv' | column -t -s $'\t'
+
+ gov_west:
+ name: Verify (West)
+ needs: commercial
+ runs-on: ubuntu-latest
+ permissions:
+ id-token: write
+ contents: read
+ strategy:
+ matrix:
+ layer:
+ - AWSLambdaPowertoolsPythonV3-python39
+ - AWSLambdaPowertoolsPythonV3-python310
+ - AWSLambdaPowertoolsPythonV3-python311
+ - AWSLambdaPowertoolsPythonV3-python312
+ - AWSLambdaPowertoolsPythonV3-python313
+ - AWSLambdaPowertoolsPythonV3-python314
+ arch:
+ - arm64
+ - x86_64
+ environment: GovCloud Prod (West)
+ steps:
+ - name: Configure AWS Credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ role-to-assume: ${{ secrets.AWS_IAM_ROLE }}
+ aws-region: us-gov-east-1
+ mask-aws-account-id: true
+ - name: Verify Layer ${{ matrix.layer }}-${{ matrix.arch }}
+ id: verify-layer
+ run: |
+ aws --region us-gov-west-1 lambda get-layer-version-by-arn --arn 'arn:aws-us-gov:lambda:us-gov-west-1:${{ secrets.AWS_ACCOUNT_ID }}:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ inputs.version }}' | jq -r '{"Layer Version Arn": .LayerVersionArn, "Version": .Version, "Description": .Description, "Compatible Runtimes": .CompatibleRuntimes[0], "Compatible Architectures": .CompatibleArchitectures[0], "SHA": .Content.CodeSha256} | keys[] as $k | [$k, .[$k]] | @tsv' | column -t -s $'\t'
diff --git a/.github/workflows/layers_partition_verify.yml b/.github/workflows/layers_partition_verify.yml
new file mode 100644
index 00000000000..d3973e8083d
--- /dev/null
+++ b/.github/workflows/layers_partition_verify.yml
@@ -0,0 +1,158 @@
+# Partition Layer Verification
+# ---
+# This workflow queries the Partition layer info in production only
+
+on:
+ workflow_dispatch:
+ inputs:
+ environment:
+ description: Deployment environment
+ type: choice
+ options:
+ - Gamma
+ - Prod
+ required: true
+ version:
+ description: Layer version to verify
+ type: string
+ required: true
+ partition_version:
+ description: Layer version to verify, this is mostly used in Gamma where a version mismatch might exist
+ type: string
+ required: false
+ partition:
+ description: Partition to deploy to
+ type: choice
+ options:
+ - China
+ - GovCloud
+ workflow_call:
+ inputs:
+ environment:
+ description: Deployment environment
+ type: string
+ required: true
+ version:
+ description: Layer version to verify
+ type: string
+ required: true
+ partition_version:
+ description: Partition Layer version to verify, this is mostly used in Gamma where a version mismatch might exist
+ type: string
+ required: false
+
+name: Layer Verification (Partition)
+run-name: Layer Verification (${{ inputs.partition }}) - ${{ inputs.environment }} / Version - ${{ inputs.version }}
+
+permissions: {}
+
+jobs:
+ setup:
+ runs-on: ubuntu-latest
+ outputs:
+ regions: ${{ format('{0}{1}', steps.regions_china.outputs.regions, steps.regions_govcloud.outputs.regions) }}
+ partition: ${{ format('{0}{1}', steps.regions_china.outputs.partition, steps.regions_govcloud.outputs.partition) }}
+ aud: ${{ format('{0}{1}', steps.regions_china.outputs.aud, steps.regions_govcloud.outputs.aud) }}
+ steps:
+ - id: regions_china
+ name: Partition (China)
+ if: ${{ inputs.partition == 'China' }}
+ run: |
+ echo regions='["cn-north-1"]'>> "$GITHUB_OUTPUT"
+ echo partition='aws-cn'>> "$GITHUB_OUTPUT"
+ echo aud='sts.amazonaws.com.cn'>> "$GITHUB_OUTPUT"
+ - id: regions_govcloud
+ name: Partition (GovCloud)
+ if: ${{ inputs.partition == 'GovCloud' }}
+ run: |
+ echo regions='["us-gov-east-1", "us-gov-west-1"]'>> "$GITHUB_OUTPUT"
+ echo partition='aws-us-gov'>> "$GITHUB_OUTPUT"
+ echo aud='sts.amazonaws.com'>> "$GITHUB_OUTPUT"
+ commercial:
+ runs-on: ubuntu-latest
+ permissions:
+ id-token: write
+ contents: read
+ environment: Prod (Readonly)
+ strategy:
+ matrix:
+ layer:
+ - AWSLambdaPowertoolsPythonV3-python39
+ - AWSLambdaPowertoolsPythonV3-python310
+ - AWSLambdaPowertoolsPythonV3-python311
+ - AWSLambdaPowertoolsPythonV3-python312
+ - AWSLambdaPowertoolsPythonV3-python313
+ - AWSLambdaPowertoolsPythonV3-python314
+ arch:
+ - arm64
+ - x86_64
+ steps:
+ - name: Configure AWS Credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ role-to-assume: ${{ secrets.AWS_IAM_ROLE }}
+ aws-region: us-east-1
+ mask-aws-account-id: true
+ - name: Output ${{ matrix.layer }}-${{ matrix.arch }}
+ # fetch the specific layer version information from the us-east-1 commercial region
+ run: |
+ aws --region us-east-1 lambda get-layer-version-by-arn --arn 'arn:aws:lambda:us-east-1:017000801446:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ inputs.version }}' > '${{ matrix.layer }}-${{ matrix.arch }}.json'
+ - name: Store Metadata
+ uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+ with:
+ name: ${{ matrix.layer }}-${{ matrix.arch }}.json
+ path: ${{ matrix.layer }}-${{ matrix.arch }}.json
+ retention-days: 1
+ if-no-files-found: error
+
+ verify:
+ name: Verify
+ needs:
+ - setup
+ - commercial
+ runs-on: ubuntu-latest
+ permissions:
+ id-token: write
+ contents: read
+ # Environment should interperlate as "GovCloud Prod" or "China Beta"
+ environment: ${{ inputs.partition }} ${{ inputs.environment }}
+ strategy:
+ matrix:
+ region: ${{ fromJson(needs.setup.outputs.regions) }}
+ layer:
+ - AWSLambdaPowertoolsPythonV3-python39
+ - AWSLambdaPowertoolsPythonV3-python310
+ - AWSLambdaPowertoolsPythonV3-python311
+ - AWSLambdaPowertoolsPythonV3-python312
+ - AWSLambdaPowertoolsPythonV3-python313
+ - AWSLambdaPowertoolsPythonV3-python314
+ arch:
+ - arm64
+ - x86_64
+ steps:
+ - name: Download Metadata
+ uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+ with:
+ name: ${{ matrix.layer }}-${{ matrix.arch }}.json
+ - id: transform
+ run: |
+ echo 'CONVERTED_REGION=${{ matrix.region }}' | tr 'a-z\-' 'A-Z_' >> "$GITHUB_OUTPUT"
+ - name: Configure AWS Credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ role-to-assume: ${{ secrets[format('IAM_ROLE_{0}', steps.transform.outputs.CONVERTED_REGION)] }}
+ aws-region: ${{ matrix.region}}
+ mask-aws-account-id: true
+ audience: ${{ needs.setup.outputs.aud }}
+ - id: partition_version
+ name: Partition Layer Version
+ run: |
+ echo 'partition_version=$([[ -n "${{ inputs.partition_version}}" ]] && echo ${{ inputs.partition_version}} || echo ${{ inputs.version }} )' >> "$GITHUB_OUTPUT"
+ - name: Verify Layer
+ run: |
+ export layer_output='${{ matrix.layer }}-${{ matrix.arch }}-${{matrix.region}}.json'
+ aws --region ${{ matrix.region}} lambda get-layer-version-by-arn --arn "arn:${{ needs.setup.outputs.partition }}:lambda:${{ matrix.region}}:${{ secrets[format('AWS_ACCOUNT_{0}', steps.transform.outputs.CONVERTED_REGION)] }}:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ steps.partition_version.outputs.partition_version }}" > $layer_output
+ REMOTE_SHA=$(jq -r '.Content.CodeSha256' $layer_output)
+ LOCAL_SHA=$(jq -r '.Content.CodeSha256' ${{ matrix.layer }}-${{ matrix.arch }}.json)
+ test "$REMOTE_SHA" == "$LOCAL_SHA" && echo "SHA OK: ${LOCAL_SHA}" || exit 1
+ jq -s -r '["Layer Arn", "Runtimes", "Version", "Description", "SHA256"], ([.[0], .[1]] | .[] | [.LayerArn, (.CompatibleRuntimes | join("/")), .Version, .Description, .Content.CodeSha256]) |@tsv' ${{ matrix.layer }}-${{ matrix.arch }}.json $layer_output | column -t -s $'\t'
diff --git a/.github/workflows/layers_partitions.yml b/.github/workflows/layers_partitions.yml
new file mode 100644
index 00000000000..433ac84e357
--- /dev/null
+++ b/.github/workflows/layers_partitions.yml
@@ -0,0 +1,195 @@
+# Partitioned Layer Publish
+# ---
+# This workflow publishes a specific layer version in an AWS account based on the environment input.
+#
+# We pull each the version of the layer and store them as artifacts, the we upload them to each of the Partitioned AWS accounts.
+#
+# A number of safety checks are performed to ensure safety.
+
+on:
+ workflow_dispatch:
+ inputs:
+ environment:
+ description: Deployment environment
+ type: choice
+ options:
+ - Gamma
+ - Prod
+ required: true
+ version:
+ description: Layer version to duplicate
+ type: string
+ required: true
+ partition:
+ description: Partition to deploy to
+ type: choice
+ options:
+ - China
+ - GovCloud
+ workflow_call:
+ inputs:
+ environment:
+ description: Deployment environment
+ type: string
+ required: true
+ version:
+ description: Layer version to duplicate
+ type: string
+ required: true
+
+name: Layer Deployment (Partitions)
+run-name: Layer Deployment (${{ inputs.partition }}) - ${{ inputs.environment }} / Version - ${{ inputs.version }}
+
+permissions:
+ contents: read
+
+jobs:
+ setup:
+ runs-on: ubuntu-latest
+ outputs:
+ regions: ${{ format('{0}{1}', steps.regions_china.outputs.regions, steps.regions_govcloud.outputs.regions) }}
+ partition: ${{ format('{0}{1}', steps.regions_china.outputs.partition, steps.regions_govcloud.outputs.partition) }}
+ aud: ${{ format('{0}{1}', steps.regions_china.outputs.aud, steps.regions_govcloud.outputs.aud) }}
+ steps:
+ - id: regions_china
+ name: Partition (China)
+ if: ${{ inputs.partition == 'China' }}
+ run: |
+ echo regions='["cn-north-1"]'>> "$GITHUB_OUTPUT"
+ echo partition='aws-cn'>> "$GITHUB_OUTPUT"
+ echo aud='sts.amazonaws.com.cn'>> "$GITHUB_OUTPUT"
+ - id: regions_govcloud
+ name: Partition (GovCloud)
+ if: ${{ inputs.partition == 'GovCloud' }}
+ run: |
+ echo regions='["us-gov-east-1", "us-gov-west-1"]'>> "$GITHUB_OUTPUT"
+ echo partition='aws-us-gov'>> "$GITHUB_OUTPUT"
+ echo aud='sts.amazonaws.com'>> "$GITHUB_OUTPUT"
+ download:
+ runs-on: ubuntu-latest
+ permissions:
+ id-token: write
+ contents: read
+ environment: Prod (Readonly)
+ strategy:
+ matrix:
+ layer:
+ - AWSLambdaPowertoolsPythonV3-python39
+ - AWSLambdaPowertoolsPythonV3-python310
+ - AWSLambdaPowertoolsPythonV3-python311
+ - AWSLambdaPowertoolsPythonV3-python312
+ - AWSLambdaPowertoolsPythonV3-python313
+ - AWSLambdaPowertoolsPythonV3-python314
+ arch:
+ - arm64
+ - x86_64
+ steps:
+ - name: Configure AWS Credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ role-to-assume: ${{ secrets.AWS_IAM_ROLE }}
+ aws-region: us-east-1
+ mask-aws-account-id: true
+ - name: Grab Zip
+ run: |
+ aws --region us-east-1 lambda get-layer-version-by-arn --arn arn:aws:lambda:us-east-1:017000801446:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ inputs.version }} --query 'Content.Location' | xargs curl -L -o ${{ matrix.layer }}-${{ matrix.arch }}.zip
+ aws --region us-east-1 lambda get-layer-version-by-arn --arn arn:aws:lambda:us-east-1:017000801446:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ inputs.version }} > ${{ matrix.layer }}-${{ matrix.arch }}.json
+ - name: Store Zip
+ uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+ with:
+ name: ${{ matrix.layer }}-${{ matrix.arch }}.zip
+ path: ${{ matrix.layer }}-${{ matrix.arch }}.zip
+ retention-days: 1
+ if-no-files-found: error
+ - name: Store Metadata
+ uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+ with:
+ name: ${{ matrix.layer }}-${{ matrix.arch }}.json
+ path: ${{ matrix.layer }}-${{ matrix.arch }}.json
+ retention-days: 1
+ if-no-files-found: error
+
+ copy:
+ name: Copy
+ needs:
+ - setup
+ - download
+ runs-on: ubuntu-latest
+ permissions:
+ id-token: write
+ contents: read
+ # Environment should interperlate as "GovCloud Prod" or "China Beta"
+ environment: ${{ inputs.partition }} ${{ inputs.environment }}
+ strategy:
+ matrix:
+ region: ${{ fromJson(needs.setup.outputs.regions) }}
+ layer:
+ - AWSLambdaPowertoolsPythonV3-python39
+ - AWSLambdaPowertoolsPythonV3-python310
+ - AWSLambdaPowertoolsPythonV3-python311
+ - AWSLambdaPowertoolsPythonV3-python312
+ - AWSLambdaPowertoolsPythonV3-python313
+ - AWSLambdaPowertoolsPythonV3-python314
+ arch:
+ - arm64
+ - x86_64
+ steps:
+ - name: Download Zip
+ uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+ with:
+ name: ${{ matrix.layer }}-${{ matrix.arch }}.zip
+ - name: Download Metadata
+ uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+ with:
+ name: ${{ matrix.layer }}-${{ matrix.arch }}.json
+ - name: Verify Layer Signature
+ run: |
+ SHA=$(jq -r '.Content.CodeSha256' '${{ matrix.layer }}-${{ matrix.arch }}.json')
+ test "$(openssl dgst -sha256 -binary ${{ matrix.layer }}-${{ matrix.arch }}.zip | openssl enc -base64)" == "$SHA" && echo "SHA OK: ${SHA}" || exit 1
+ - id: transform
+ run: |
+ echo 'CONVERTED_REGION=${{ matrix.region }}' | tr 'a-z\-' 'A-Z_' >> "$GITHUB_OUTPUT"
+ - name: Configure AWS Credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ role-to-assume: ${{ secrets[format('IAM_ROLE_{0}', steps.transform.outputs.CONVERTED_REGION)] }}
+ aws-region: ${{ matrix.region}}
+ mask-aws-account-id: true
+ audience: ${{ needs.setup.outputs.aud }}
+ - name: Create Layer
+ id: create-layer
+ run: |
+ cat '${{ matrix.layer }}-${{ matrix.arch }}.json' | jq '{"LayerName": "${{ matrix.layer }}-${{ matrix.arch }}", "Description": .Description, "CompatibleRuntimes": .CompatibleRuntimes, "CompatibleArchitectures": .CompatibleArchitectures, "LicenseInfo": .LicenseInfo}' > input.json
+
+ LAYER_VERSION=$(aws --region ${{ matrix.region}} lambda publish-layer-version \
+ --zip-file 'fileb://./${{ matrix.layer }}-${{ matrix.arch }}.zip' \
+ --cli-input-json file://./input.json \
+ --query 'Version' \
+ --output text)
+
+ echo "LAYER_VERSION=$LAYER_VERSION" >> "$GITHUB_OUTPUT"
+
+ aws --region ${{ matrix.region}} lambda add-layer-version-permission \
+ --layer-name ${{ matrix.layer }}-${{ matrix.arch }} \
+ --statement-id 'PublicLayer' \
+ --action lambda:GetLayerVersion \
+ --principal '*' \
+ --version-number "$LAYER_VERSION"
+ - name: Verify Layer
+ env:
+ LAYER_VERSION: ${{ steps.create-layer.outputs.LAYER_VERSION }}
+ run: |
+ export layer_output='${{ matrix.layer }}-${{ matrix.arch }}-${{matrix.region}}.json'
+ aws --region ${{ matrix.region}} lambda get-layer-version-by-arn --arn 'arn:${{ needs.setup.outputs.partition }}:lambda:${{ matrix.region}}:${{ secrets[format('AWS_ACCOUNT_{0}', steps.transform.outputs.CONVERTED_REGION)] }}:layer:${{ matrix.layer }}-${{ matrix.arch }}:${{ env.LAYER_VERSION }}' > $layer_output
+ REMOTE_SHA=$(jq -r '.Content.CodeSha256' $layer_output)
+ LOCAL_SHA=$(jq -r '.Content.CodeSha256' '${{ matrix.layer }}-${{ matrix.arch }}.json')
+ test "$REMOTE_SHA" == "$LOCAL_SHA" && echo "SHA OK: ${LOCAL_SHA}" || exit 1
+ jq -s -r '["Layer Arn", "Runtimes", "Version", "Description", "SHA256"], ([.[0], .[1]] | .[] | [.LayerArn, (.CompatibleRuntimes | join("/")), .Version, .Description, .Content.CodeSha256]) |@tsv' '${{ matrix.layer }}-${{ matrix.arch }}.json' $layer_output | column -t -s $'\t'
+
+ - name: Store Metadata - ${{ matrix.region }}
+ uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+ with:
+ name: ${{ matrix.layer }}-${{ matrix.arch }}-${{ matrix.region }}.json
+ path: ${{ matrix.layer }}-${{ matrix.arch }}-${{ matrix.region }}.json
+ retention-days: 1
+ if-no-files-found: error
diff --git a/.github/workflows/on_closed_issues.yml b/.github/workflows/on_closed_issues.yml
deleted file mode 100644
index ca815e4c07f..00000000000
--- a/.github/workflows/on_closed_issues.yml
+++ /dev/null
@@ -1,18 +0,0 @@
-name: Closed Issue Message
-on:
- issues:
- types: [closed]
-jobs:
- auto_comment:
- runs-on: ubuntu-latest
- steps:
- - uses: aws-actions/closed-issue-message@v1
- with:
- repo-token: "${{ secrets.GITHUB_TOKEN }}"
- message: |
- ### ⚠️COMMENT VISIBILITY WARNING⚠️
- This issue is now closed. Please be mindful that future comments are hard for our team to see.
-
- If you need more assistance, please either tag a [team member](https://github.com/awslabs/aws-lambda-powertools-python/blob/develop/MAINTAINERS.md#current-maintainers) or open a new issue that references this one.
-
- If you wish to keep having a conversation with other community members under this issue feel free to do so.
diff --git a/.github/workflows/on_label_added.yml b/.github/workflows/on_label_added.yml
deleted file mode 100644
index e9180d8010a..00000000000
--- a/.github/workflows/on_label_added.yml
+++ /dev/null
@@ -1,38 +0,0 @@
-name: On Label added
-
-on:
- workflow_run:
- workflows: ["Record PR details"]
- types:
- - completed
-
-jobs:
- get_pr_details:
- if: ${{ github.event.workflow_run.conclusion == 'success' }}
- uses: ./.github/workflows/reusable_export_pr_details.yml
- with:
- record_pr_workflow_id: ${{ github.event.workflow_run.id }}
- workflow_origin: ${{ github.event.repository.full_name }}
- secrets:
- token: ${{ secrets.GITHUB_TOKEN }}
-
- split-large-pr:
- needs: get_pr_details
- runs-on: ubuntu-latest
- permissions:
- issues: write
- pull-requests: write
- steps:
- - uses: actions/checkout@v3
- # Maintenance: Persist state per PR as an artifact to avoid spam on label add
- - name: "Suggest split large Pull Request"
- uses: actions/github-script@v6
- env:
- PR_NUMBER: ${{ needs.get_pr_details.outputs.prNumber }}
- PR_ACTION: ${{ needs.get_pr_details.outputs.prAction }}
- PR_AUTHOR: ${{ needs.get_pr_details.outputs.prAuthor }}
- with:
- github-token: ${{ secrets.GITHUB_TOKEN }}
- script: |
- const script = require('.github/scripts/comment_on_large_pr.js');
- await script({github, context, core});
diff --git a/.github/workflows/on_merged_pr.yml b/.github/workflows/on_merged_pr.yml
deleted file mode 100644
index cd97e1c306e..00000000000
--- a/.github/workflows/on_merged_pr.yml
+++ /dev/null
@@ -1,35 +0,0 @@
-name: On PR merge
-
-on:
- workflow_run:
- workflows: ["Record PR details"]
- types:
- - completed
-
-jobs:
- get_pr_details:
- if: github.event.workflow_run.event == 'pull_request' && github.event.workflow_run.conclusion == 'success'
- uses: ./.github/workflows/reusable_export_pr_details.yml
- with:
- record_pr_workflow_id: ${{ github.event.workflow_run.id }}
- workflow_origin: ${{ github.event.repository.full_name }}
- secrets:
- token: ${{ secrets.GITHUB_TOKEN }}
- release_label_on_merge:
- needs: get_pr_details
- runs-on: ubuntu-latest
- if: needs.get_pr_details.outputs.prIsMerged == 'true'
- steps:
- - uses: actions/checkout@v3
- - name: "Label PR related issue for release"
- uses: actions/github-script@v6
- env:
- PR_NUMBER: ${{ needs.get_pr_details.outputs.prNumber }}
- PR_BODY: ${{ needs.get_pr_details.outputs.prBody }}
- PR_IS_MERGED: ${{ needs.get_pr_details.outputs.prIsMerged }}
- PR_AUTHOR: ${{ needs.get_pr_details.outputs.prAuthor }}
- with:
- github-token: ${{ secrets.GITHUB_TOKEN }}
- script: |
- const script = require('.github/scripts/label_related_issue.js')
- await script({github, context, core})
diff --git a/.github/workflows/on_opened_pr.yml b/.github/workflows/on_opened_pr.yml
deleted file mode 100644
index 6c5979c8b80..00000000000
--- a/.github/workflows/on_opened_pr.yml
+++ /dev/null
@@ -1,34 +0,0 @@
-name: On new PR
-
-on:
- workflow_run:
- workflows: ["Record PR details"]
- types:
- - completed
-
-jobs:
- get_pr_details:
- if: ${{ github.event.workflow_run.conclusion == 'success' }}
- uses: ./.github/workflows/reusable_export_pr_details.yml
- with:
- record_pr_workflow_id: ${{ github.event.workflow_run.id }}
- workflow_origin: ${{ github.event.repository.full_name }}
- secrets:
- token: ${{ secrets.GITHUB_TOKEN }}
- check_related_issue:
- needs: get_pr_details
- runs-on: ubuntu-latest
- steps:
- - uses: actions/checkout@v3
- - name: "Ensure related issue is present"
- uses: actions/github-script@v6
- env:
- PR_BODY: ${{ needs.get_pr_details.outputs.prBody }}
- PR_NUMBER: ${{ needs.get_pr_details.outputs.prNumber }}
- PR_ACTION: ${{ needs.get_pr_details.outputs.prAction }}
- PR_AUTHOR: ${{ needs.get_pr_details.outputs.prAuthor }}
- with:
- github-token: ${{ secrets.GITHUB_TOKEN }}
- script: |
- const script = require('.github/scripts/label_missing_related_issue.js')
- await script({github, context, core})
diff --git a/.github/workflows/on_pr_updates.yml b/.github/workflows/on_pr_updates.yml
new file mode 100644
index 00000000000..b81bfe228e5
--- /dev/null
+++ b/.github/workflows/on_pr_updates.yml
@@ -0,0 +1,35 @@
+# Fail PR check if do-not-merge label is present
+name: PR requirements
+
+# PROCESS
+#
+# 1. Verify whether 'do-not-merge' label is present
+# 2. Fail PR to prevent merging until resolved
+# 3. Pass PR if do-not-merge label is removed by a maintainer
+
+# USAGE
+#
+# Always triggered on PR labeling changes.
+
+# NOTES
+#
+# PR requirements are enforced synchronously here.
+
+on:
+ pull_request:
+ types:
+ - opened
+ - labeled
+ - unlabeled
+
+permissions: {} # no permission required
+
+jobs:
+ check-requirements:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Block if it doesn't minimum requirements
+ if: contains(github.event.pull_request.labels.*.name, 'do-not-merge')
+ run: |
+ echo "PR has 'do-not-merge' label. Please resolve the issues mentioned in the PR comments."
+ exit 1
diff --git a/.github/workflows/on_push_docs.yml b/.github/workflows/on_push_docs.yml
index d46879ca6b1..fc1aa3786e6 100644
--- a/.github/workflows/on_push_docs.yml
+++ b/.github/workflows/on_push_docs.yml
@@ -1,5 +1,15 @@
name: Docs
+# PROCESS
+#
+# 1. Build User Guide and API docs
+# 2. Publish to GitHub Pages
+# 3. Publish to S3 (new home)
+
+# USAGE
+#
+# Always triggered on PR merge when changes in documentation changes occur.
+
on:
push:
branches:
@@ -8,28 +18,19 @@ on:
- "docs/**"
- "mkdocs.yml"
- "examples/**"
+ - "CHANGELOG.md"
-jobs:
- changelog:
- permissions:
- contents: write
- uses: ./.github/workflows/reusable_publish_changelog.yml
+permissions:
+ contents: read
+jobs:
release-docs:
- needs: changelog
permissions:
- contents: write
- pages: write
+ contents: write # push to gh-pages
+ pages: write # deploy gh-pages website
+ id-token: write # trade JWT token for AWS credentials in AWS Docs account
+ secrets: inherit
uses: ./.github/workflows/reusable_publish_docs.yml
with:
version: develop
- alias: stage
-# Maintenance: Only necessary in repo migration
-# - name: Create redirect from old docs
-# run: |
-# git checkout gh-pages
-# test -f 404.html && echo "Redirect already set" && exit 0
-# git checkout develop -- 404.html
-# git add 404.html
-# git commit -m "chore: set docs redirect" --no-verify
-# git push origin gh-pages -f
+ alias: stage
\ No newline at end of file
diff --git a/.github/workflows/on_release_notes.yml b/.github/workflows/on_release_notes.yml
deleted file mode 100644
index 2b431defff0..00000000000
--- a/.github/workflows/on_release_notes.yml
+++ /dev/null
@@ -1,142 +0,0 @@
-name: Publish to PyPi
-
-# RELEASE PROCESS
-#
-# === Manual activities ===
-#
-# 1. Edit the current draft release notes
-# 2. If not already set, use `v<new version>` as a tag, e.g., v1.26.4, and select develop as target branch
-#
-# === Automated activities ===
-#
-# 1. Extract release notes tag that was published
-# 2. Run tests, linting, security and complexity base line
-# 3. Bump package version and generate latest Changelog
-# 4. Publish package to PyPi test and prod repository
-# 5. Kick off SAR App pipeline to publish latest version with minimal and extra dependencies
-# 6. Builds and publish latest changelog from tip of the branch
-# 7. Builds a new user guide and API docs with release version; update /latest pointing to newly released version
-# 8. Close all issues labeled "pending-release" and notify customers about the release
-
-# See MAINTAINERS.md "Releasing a new version" for release mechanisms
-
-env:
- BRANCH: develop
-
-on:
- release:
- types: [published]
- workflow_dispatch:
- inputs:
- version_to_publish:
- description: "Version to be released in PyPi, Docs, and Lambda Layer, e.g. v1.26.4"
- default: v1.26.4
- required: true
- skip_pypi:
- description: "Skip publishing to PyPi as it can't publish more than once. Useful for semi-failed releases"
- default: false
- type: boolean
- required: false
- skip_code_quality:
- description: "Skip tests, linting, and baseline. Only use if release fail for reasons beyond our control and you need a quick release."
- default: false
- type: boolean
- required: false
-
-jobs:
- release:
- environment: release
- runs-on: ubuntu-latest
- permissions:
- id-token: write
- contents: read
- outputs:
- RELEASE_VERSION: ${{ steps.release_version.outputs.RELEASE_VERSION }}
- env:
- RELEASE_TAG_VERSION: ${{ github.event.release.tag_name || inputs.version_to_publish }}
- steps:
- - uses: actions/checkout@v3
- with:
- fetch-depth: 0
- - name: Install poetry
- run: pipx install poetry
- - name: Set up Python
- uses: actions/setup-python@v4
- with:
- python-version: "3.8"
- cache: "poetry"
- - name: Set release notes tag
- id: release_version
- # transform tag format `v<version` to `<version`
- run: |
- RELEASE_VERSION="${RELEASE_TAG_VERSION:1}"
- echo "RELEASE_VERSION=${RELEASE_VERSION}" >> "$GITHUB_ENV"
- echo "::set-output name=RELEASE_VERSION::${RELEASE_VERSION}"
- - name: Install dependencies
- run: make dev
- - name: Run all tests, linting and baselines
- if: ${{ !inputs.skip_code_quality }}
- run: make pr
- - name: Bump package version
- run: poetry version "${RELEASE_VERSION}"
- - name: Build python package and wheel
- if: ${{ !inputs.skip_pypi }}
- run: poetry build
- - name: Upload to PyPi test
- if: ${{ !inputs.skip_pypi }}
- run: make release-test
- env:
- PYPI_USERNAME: __token__
- PYPI_TEST_TOKEN: ${{ secrets.PYPI_TEST_TOKEN }}
- - name: Upload to PyPi prod
- if: ${{ !inputs.skip_pypi }}
- run: make release-prod
- env:
- PYPI_USERNAME: __token__
- PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}
- - name: aws credentials
- uses: aws-actions/configure-aws-credentials@v1
- with:
- aws-region: eu-west-1
- role-to-assume: ${{ secrets.AWS_SAR_ROLE_ARN }}
- - name: publish lambda layer in SAR by triggering the internal codepipeline
- run: |
- aws ssm put-parameter --name "powertools-python-release-version" --value "$RELEASE_VERSION" --overwrite
- aws codepipeline start-pipeline-execution --name ${{ secrets.AWS_SAR_PIPELINE_NAME }}
-
- changelog:
- needs: release
- permissions:
- contents: write
- uses: ./.github/workflows/reusable_publish_changelog.yml
-
- docs:
- needs: [release, changelog]
- permissions:
- contents: write
- pages: write
- uses: ./.github/workflows/reusable_publish_docs.yml
- with:
- version: ${{ needs.release.outputs.RELEASE_VERSION }}
- alias: latest
- detached_mode: true
-
- post_release:
- needs: release
- permissions:
- contents: read
- issues: write
- discussions: write
- pull-requests: write
- runs-on: ubuntu-latest
- env:
- RELEASE_VERSION: ${{ needs.release.outputs.RELEASE_VERSION }}
- steps:
- - uses: actions/checkout@v3
- - name: Close issues related to this release
- uses: actions/github-script@v6
- with:
- github-token: ${{ secrets.GITHUB_TOKEN }}
- script: |
- const post_release = require('.github/scripts/post_release.js')
- await post_release({github, context, core})
diff --git a/.github/workflows/on_schedule_monthly_roadmap_reminder.yml b/.github/workflows/on_schedule_monthly_roadmap_reminder.yml
new file mode 100644
index 00000000000..a274e2dea08
--- /dev/null
+++ b/.github/workflows/on_schedule_monthly_roadmap_reminder.yml
@@ -0,0 +1,22 @@
+name: Monthly roadmap reminder
+
+on:
+ workflow_dispatch: {}
+ schedule:
+ - cron: '0 0 1 * *' # runs first day of the month
+
+permissions:
+ contents: read
+
+
+jobs:
+ call-workflow-passing-data:
+ permissions:
+ contents: read
+ pull-requests: read
+ issues: write # create monthly roadmap report
+
+ # setting to `@main` until we have releases and governance installed
+ uses: aws-powertools/actions/.github/workflows/monthly_roadmap_reminder.yml@main
+ secrets:
+ token: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.github/workflows/ossf_scorecard.yml b/.github/workflows/ossf_scorecard.yml
new file mode 100644
index 00000000000..3c6e87ab8c7
--- /dev/null
+++ b/.github/workflows/ossf_scorecard.yml
@@ -0,0 +1,48 @@
+name: Scorecard supply-chain security
+on:
+ # For Branch-Protection check. Only the default branch is supported. See
+ # https://github.com/ossf/scorecard/blob/main/docs/checks.md#branch-protection
+ branch_protection_rule:
+ schedule:
+ - cron: "0 9 * * *"
+ push:
+ branches: [develop]
+ workflow_dispatch:
+
+permissions: read-all
+
+jobs:
+ analysis:
+ name: Scorecard analysis
+ runs-on: ubuntu-latest
+ environment: scorecard
+ permissions:
+ security-events: write # update code-scanning dashboard
+ id-token: write # confirm org+repo identity before publish results
+
+ steps:
+ - name: "Checkout code"
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ persist-credentials: false
+
+ - name: "Run analysis"
+ uses: ossf/scorecard-action@4eaacf0543bb3f2c246792bd56e8cdeffafb205a # v2.4.3
+ with:
+ results_file: results.sarif
+ results_format: sarif
+ publish_results: true # publish to OSSF Scorecard REST API
+ repo_token: ${{ secrets.SCORECARD_TOKEN }} # read-only fine-grained token to read branch protection settings
+
+ - name: "Upload results"
+ uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+ with:
+ name: SARIF file
+ path: results.sarif
+ retention-days: 5
+
+ # Upload the results to GitHub's code scanning dashboard.
+ - name: "Upload to code-scanning"
+ uses: github/codeql-action/upload-sarif@17573ee1cc1b9d061760f3a006fc4aac4f944fd5 # v2.2.4
+ with:
+ sarif_file: results.sarif
diff --git a/.github/workflows/pre-release.yml b/.github/workflows/pre-release.yml
new file mode 100644
index 00000000000..07cf205ba20
--- /dev/null
+++ b/.github/workflows/pre-release.yml
@@ -0,0 +1,264 @@
+name: Pre-Release
+
+# PRE-RELEASE PROCESS
+#
+# === Automated activities ===
+#
+# 1. [Seal] Bump to release version and export source code with integrity hash
+# 2. [Quality check] Restore sealed source code, run tests, linting, security and complexity base line
+# 3. [Build] Restore sealed source code, create and export hashed build artifact for PyPi release (wheel, tarball)
+# 4. [Provenance] Generates provenance for build, signs attestation with GitHub OIDC claims to confirm it came from this release pipeline, commit, org, repo, branch, hash, etc.
+# 5. [Release] Restore built artifact, and publish package to PyPi prod repository
+# 6. [PR to bump version] Restore sealed source code, and create a PR to update trunk with latest released project metadata
+
+# NOTE
+#
+# See MAINTAINERS.md "Releasing a new version" for release mechanisms
+#
+# Every job is isolated and starts a new fresh container.
+
+env:
+ RELEASE_COMMIT: ${{ github.sha }}
+
+on:
+ workflow_dispatch:
+ inputs:
+ version:
+ description: "Pre-release version to publish (e.g., 3.24.0a0)"
+ required: true
+ type: string
+ skip_code_quality:
+ description: "Skip tests, linting, and baseline. Only use if release fail for reasons beyond our control and you need a quick release."
+ default: false
+ type: boolean
+ required: false
+ skip_pypi:
+ description: "Skip publishing to PyPi. Used for testing release steps."
+ default: false
+ type: boolean
+ required: false
+
+permissions:
+ contents: read
+
+jobs:
+
+ # This job bumps the package version to the pre-release version
+ # creates an integrity hash from the source code
+ # uploads the artifact with the integrity hash as the key name
+ # so subsequent jobs can restore from a trusted point in time to prevent tampering
+ seal:
+ # ignore forks
+ if: github.repository == 'aws-powertools/powertools-lambda-python'
+
+ runs-on: ubuntu-latest
+ permissions:
+ contents: read
+ outputs:
+ integrity_hash: ${{ steps.seal_source_code.outputs.integrity_hash }}
+ artifact_name: ${{ steps.seal_source_code.outputs.artifact_name }}
+ RELEASE_VERSION: ${{ steps.release_version.outputs.RELEASE_VERSION }}
+ steps:
+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ env.RELEASE_COMMIT }}
+
+ - name: Set release version
+ id: release_version
+ run: echo "RELEASE_VERSION=${{ inputs.version }}" >> "$GITHUB_OUTPUT"
+
+ - name: Verify pre-release version semantics
+ run: |
+ if [[ ! "${{ inputs.version }}" =~ ^[0-9]+\.[0-9]+\.[0-9]+[a-b][0-9]+$ ]]; then
+ echo "Version ${{ inputs.version }} doesn't look like a pre-release version (e.g., 3.24.0a0); aborting"
+ exit 1
+ fi
+
+ - name: Update version in pyproject.toml
+ run: sed -i 's/^version = ".*"/version = "${{ inputs.version }}"/' pyproject.toml
+
+ - name: Update version in version.py
+ run: sed -i 's/^VERSION = ".*"/VERSION = "${{ inputs.version }}"/' aws_lambda_powertools/shared/version.py
+
+ - name: Seal and upload
+ id: seal_source_code
+ uses: ./.github/actions/seal
+ with:
+ artifact_name_prefix: "source"
+
+ # This job runs our automated test suite, complexity and security baselines
+ # it ensures previously merged have been tested as part of the pull request process
+ #
+ # NOTE
+ #
+ # we don't upload the artifact after testing to prevent any tampering of our source code dependencies
+ quality_check:
+ needs: seal
+ runs-on: ubuntu-latest
+ permissions:
+ contents: read
+ steps:
+ # NOTE: we need actions/checkout to configure git first (pre-commit hooks in make dev)
+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ env.RELEASE_COMMIT }}
+
+ - name: Restore sealed source code
+ uses: ./.github/actions/seal-restore
+ with:
+ integrity_hash: ${{ needs.seal.outputs.integrity_hash }}
+ artifact_name: ${{ needs.seal.outputs.artifact_name }}
+
+ - name: Debug cache restore
+ run: cat pyproject.toml
+
+ - name: Install poetry
+ run: pipx install git+https://github.com/python-poetry/poetry@bd500dd3bdfaec3de6894144c9cedb3a9358be84 # v2.0.1
+ - name: Set up Python
+ uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+ with:
+ python-version: "3.14"
+ cache: "poetry"
+ - name: Install dependencies
+ run: make dev
+ - name: Run all tests, linting and baselines
+ run: make pr
+
+ # This job creates a release artifact (tar.gz, wheel)
+ # it checks out code from release commit for custom actions to work
+ # then restores the sealed source code (overwrites any potential tampering)
+ # it's done separately from release job to enforce least privilege.
+ # We export just the final build artifact for release
+ build:
+ runs-on: ubuntu-latest
+ needs: [quality_check, seal]
+ permissions:
+ contents: read
+ outputs:
+ integrity_hash: ${{ steps.seal_build.outputs.integrity_hash }}
+ artifact_name: ${{ steps.seal_build.outputs.artifact_name }}
+ attestation_hashes: ${{ steps.encoded_hash.outputs.attestation_hashes }}
+ steps:
+ # NOTE: we need actions/checkout to configure git first (pre-commit hooks in make dev)
+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ env.RELEASE_COMMIT }}
+
+ - name: Restore sealed source code
+ uses: ./.github/actions/seal-restore
+ with:
+ integrity_hash: ${{ needs.seal.outputs.integrity_hash }}
+ artifact_name: ${{ needs.seal.outputs.artifact_name }}
+
+ - name: Install poetry
+ run: pipx install git+https://github.com/python-poetry/poetry@bd500dd3bdfaec3de6894144c9cedb3a9358be84 # v2.0.1
+ - name: Set up Python
+ uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+ with:
+ python-version: "3.14"
+ cache: "poetry"
+
+ - name: Build python package and wheel
+ run: poetry build
+
+ - name: Seal and upload
+ id: seal_build
+ uses: ./.github/actions/seal
+ with:
+ artifact_name_prefix: "build"
+ files: "dist/"
+
+ # NOTE: SLSA retraces our build to its artifact to ensure it wasn't tampered
+ # coupled with GitHub OIDC, SLSA can then confidently sign it came from this release pipeline+commit+branch+org+repo+actor+integrity hash
+ - name: Create attestation encoded hash for provenance
+ id: encoded_hash
+ working-directory: dist
+ run: echo "attestation_hashes=$(sha256sum ./* | base64 -w0)" >> "$GITHUB_OUTPUT"
+
+ # This job creates a provenance file that describes how our release was built (all steps)
+ # after it verifies our build is reproducible within the same pipeline
+ # it confirms that its own software and the CI build haven't been tampered with (Trust but verify)
+ # lastly, it creates and sign an attestation (multiple.intoto.jsonl) that confirms
+ # this build artifact came from this GitHub org, branch, actor, commit ID, inputs that triggered this pipeline, and matches its integrity hash
+ # NOTE: supply chain threats review (we protect against all of them now): https://slsa.dev/spec/v1.0/threats-overview
+ provenance:
+ needs: [seal, build]
+ permissions:
+ contents: write # nested job explicitly require despite upload assets being set to false
+ actions: read # To read the workflow path.
+ id-token: write # To sign the provenance.
+ # NOTE: provenance fails if we use action pinning... it's a Github limitation
+ # because SLSA needs to trace & attest it came from a given branch; pinning doesn't expose that information
+ # https://github.com/slsa-framework/slsa-github-generator/blob/main/internal/builders/generic/README.md#referencing-the-slsa-generator
+ uses: slsa-framework/slsa-github-generator/.github/workflows/generator_generic_slsa3.yml@v2.1.0
+ with:
+ base64-subjects: ${{ needs.build.outputs.attestation_hashes }}
+ upload-assets: false # we upload its attestation in create_tag job, otherwise it creates a new release
+
+ # This job uses release artifact to publish to PyPi
+ # it exchanges JWT tokens with GitHub to obtain PyPi credentials
+ # since it's already registered as a Trusted Publisher.
+ # It uses the sealed build artifact (.whl, .tar.gz) to release it
+ release:
+ needs: [build, seal, provenance]
+ environment: pre-release
+ runs-on: ubuntu-latest
+ permissions:
+ id-token: write # OIDC for PyPi Trusted Publisher feature
+ env:
+ RELEASE_VERSION: ${{ needs.seal.outputs.RELEASE_VERSION }}
+ steps:
+ # NOTE: we need actions/checkout in order to use our local actions (e.g., ./.github/actions)
+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ env.RELEASE_COMMIT }}
+
+ - name: Restore sealed source code
+ uses: ./.github/actions/seal-restore
+ with:
+ integrity_hash: ${{ needs.build.outputs.integrity_hash }}
+ artifact_name: ${{ needs.build.outputs.artifact_name }}
+
+ - name: Upload to PyPi prod
+ if: ${{ !inputs.skip_pypi }}
+ uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # v1.14.0
+
+ # Creates a PR with the latest version we've just released
+ # since our trunk is protected against any direct pushes from automation
+ bump_version:
+ needs: [release, seal, provenance]
+ permissions:
+ contents: write # create-pr action creates a temporary branch
+ pull-requests: write # create-pr action creates a PR using the temporary branch
+ runs-on: ubuntu-latest
+ steps:
+ # NOTE: we need actions/checkout to authenticate and configure git first
+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ env.RELEASE_COMMIT }}
+
+ - name: Restore sealed source code
+ uses: ./.github/actions/seal-restore
+ with:
+ integrity_hash: ${{ needs.seal.outputs.integrity_hash }}
+ artifact_name: ${{ needs.seal.outputs.artifact_name }}
+
+ - name: Download provenance
+ uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+ with:
+ name: ${{needs.provenance.outputs.provenance-name}}
+
+ - name: Update provenance
+ run: mkdir -p "${PROVENANCE_DIR}" && mv "${PROVENANCE_FILE}" "${PROVENANCE_DIR}/"
+ env:
+ PROVENANCE_FILE: ${{ needs.provenance.outputs.provenance-name }}
+ PROVENANCE_DIR: provenance/${{ needs.seal.outputs.RELEASE_VERSION}}
+
+ - name: Create PR
+ id: create-pr
+ uses: ./.github/actions/create-pr
+ with:
+ files: "pyproject.toml aws_lambda_powertools/shared/version.py provenance/"
+ temp_branch_prefix: "ci-bump"
+ pull_request_title: "chore(ci): new pre-release ${{ needs.seal.outputs.RELEASE_VERSION }}"
+ github_token: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.github/workflows/publish_layer.yml b/.github/workflows/publish_layer.yml
deleted file mode 100644
index 564cbfad9de..00000000000
--- a/.github/workflows/publish_layer.yml
+++ /dev/null
@@ -1,86 +0,0 @@
-name: Deploy layer to all regions
-
-permissions:
- id-token: write
- contents: read
-
-on:
- workflow_dispatch:
- inputs:
- latest_published_version:
- description: "Latest PyPi published version to rebuild latest docs for, e.g. v1.22.0"
- default: "v1.22.0"
- required: true
- workflow_run:
- workflows: ["Publish to PyPi"]
- types:
- - completed
-
-jobs:
- build-layer:
- runs-on: ubuntu-latest
- if: ${{ (github.event.workflow_run.conclusion == 'success') || (github.event_name == 'workflow_dispatch') }}
- defaults:
- run:
- working-directory: ./layer
- steps:
- - name: checkout
- uses: actions/checkout@v3
- with:
- fetch-depth: 0
- - name: Install poetry
- run: pipx install poetry
- - name: Setup Node.js
- uses: actions/setup-node@v3
- with:
- node-version: "16.12"
- - name: Setup python
- uses: actions/setup-python@v4
- with:
- python-version: "3.9"
- cache: "pip"
- - name: Resolve and install project dependencies
- # CDK spawns system python when compiling stack
- # therefore it ignores both activated virtual env and cached interpreter by GH
- run: |
- poetry export --format requirements.txt --output requirements.txt
- pip install -r requirements.txt
- - name: Set release notes tag
- run: |
- RELEASE_INPUT=${{ inputs.latest_published_version }}
- LATEST_TAG=$(git describe --tag --abbrev=0)
- RELEASE_TAG_VERSION=${RELEASE_INPUT:-$LATEST_TAG}
- echo "RELEASE_TAG_VERSION=${RELEASE_TAG_VERSION:1}" >> $GITHUB_ENV
- - name: install cdk and deps
- run: |
- npm install -g aws-cdk@2.29.0
- cdk --version
- - name: CDK build
- run: cdk synth --context version=$RELEASE_TAG_VERSION -o cdk.out
- - name: zip output
- run: zip -r cdk.out.zip cdk.out
- - name: Archive CDK artifacts
- uses: actions/upload-artifact@v3
- with:
- name: cdk-layer-artefact
- path: layer/cdk.out.zip
-
- deploy-beta:
- needs:
- - build-layer
- uses: ./.github/workflows/reusable_deploy_layer_stack.yml
- secrets: inherit
- with:
- stage: "BETA"
- artefact-name: "cdk-layer-artefact"
- environment: "layer-beta"
-
- deploy-prod:
- needs:
- - deploy-beta
- uses: ./.github/workflows/reusable_deploy_layer_stack.yml
- secrets: inherit
- with:
- stage: "PROD"
- artefact-name: "cdk-layer-artefact"
- environment: "layer-prod"
diff --git a/.github/workflows/publish_v2_layer.yml b/.github/workflows/publish_v2_layer.yml
deleted file mode 100644
index 850063098cd..00000000000
--- a/.github/workflows/publish_v2_layer.yml
+++ /dev/null
@@ -1,19 +0,0 @@
-name: Deploy v2 layer to all regions
-
-permissions:
- id-token: write
- contents: read
-
-on:
- workflow_dispatch:
- inputs:
- latest_published_version:
- description: "Latest PyPi published version to rebuild latest docs for, e.g. v1.22.0"
- required: true
-
-jobs:
- dummy:
- runs-on: ubuntu-latest
- steps:
- - name: Hello world
- run: echo "hello world"
diff --git a/.github/workflows/publish_v3_layer.yml b/.github/workflows/publish_v3_layer.yml
new file mode 100644
index 00000000000..958402adf98
--- /dev/null
+++ b/.github/workflows/publish_v3_layer.yml
@@ -0,0 +1,325 @@
+name: Deploy v3 layer to all regions
+
+# PROCESS
+#
+# 1. Compile Layer using cdk-aws-lambda-powertools-layer CDK construct for Python3.10-3.14 and x86_64/ARM architectures (uses custom runner as it's CPU heavy)
+# 2. Kick off pipeline for beta, prod, and canary releases
+# 3. Create PR to update trunk so staged docs also point to the latest Layer ARN, when merged
+# 4. Builds and publishes docs with latest Layer ARN using given version (generally coming from release)
+
+# USAGE
+#
+# NOTE: meant to be used with ./.github/workflows/release-v3.yml
+#
+# publish_layer:
+# needs: [seal, release, create_tag]
+# secrets: inherit
+# permissions:
+# id-token: write
+# contents: write
+# pages: write
+# pull-requests: write
+# uses: ./.github/workflows/publish_v2_layer.yml
+# with:
+# latest_published_version: ${{ needs.seal.outputs.RELEASE_VERSION }}
+# pre_release: ${{ inputs.pre_release }}
+# source_code_artifact_name: ${{ needs.seal.outputs.artifact_name }}
+# source_code_integrity_hash: ${{ needs.seal.outputs.integrity_hash }}
+
+
+on:
+ workflow_dispatch:
+ inputs:
+ latest_published_version:
+ description: "Latest PyPi published version to rebuild latest docs for, e.g. 3.0.0, 3.0.0a1 (pre-release)"
+ required: true
+ layer_documentation_version:
+ description: "Version to be updated in our documentation. e.g. if the current layer number is 3, this value must be 4."
+ required: true
+ source_code_artifact_name:
+ description: "Artifact name to restore sealed source code"
+ type: string
+ required: true
+ source_code_integrity_hash:
+ description: "Sealed source code integrity hash"
+ type: string
+ required: true
+ pre_release:
+ description: "Publishes documentation using a pre-release tag (3.0.0a1)."
+ default: false
+ type: boolean
+ required: false
+ skip_lambda_layer:
+ description: "Skip publishing Lambda Layers as it can publish duplicated versions of the same layer. Useful for semi-failed releases"
+ type: boolean
+ required: false
+
+ workflow_call:
+ inputs:
+ latest_published_version:
+ type: string
+ description: "Latest PyPi published version to rebuild latest docs for, e.g. 3.0.0, 3.0.0a1 (pre-release)"
+ required: true
+ layer_documentation_version:
+ type: string
+ description: "Version to be updated in our documentation. e.g. if the current layer number is 3, this value must be 4."
+ required: true
+ pre_release:
+ description: "Publishes documentation using a pre-release tag (3.0.0a1)."
+ default: false
+ type: boolean
+ required: false
+ source_code_artifact_name:
+ description: "Artifact name to restore sealed source code"
+ type: string
+ required: true
+ source_code_integrity_hash:
+ description: "Sealed source code integrity hash"
+ type: string
+ required: true
+ skip_lambda_layer:
+ description: "Skip publishing Lambda Layers as it can publish duplicated versions of the same layer. Useful for semi-failed releases"
+ default: false
+ type: boolean
+ required: false
+
+permissions:
+ contents: read
+
+
+env:
+ RELEASE_COMMIT: ${{ github.sha }}
+
+jobs:
+ build-layer:
+ permissions:
+ # lower privilege propagated from parent workflow (release-v3.yml)
+ contents: read
+ id-token: write
+ pages: none
+ pull-requests: none
+ runs-on: aws-powertools_ubuntu-latest_8-core
+ strategy:
+ max-parallel: 5
+ matrix:
+ python-version: ["3.10","3.11","3.12","3.13","3.14"]
+ defaults:
+ run:
+ working-directory: ./layer_v3
+ steps:
+ - name: checkout
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ env.RELEASE_COMMIT }}
+
+ - name: Restore sealed source code
+ uses: ./.github/actions/seal-restore
+ with:
+ integrity_hash: ${{ inputs.source_code_integrity_hash }}
+ artifact_name: ${{ inputs.source_code_artifact_name }}
+
+ - name: Install poetry
+ run: |
+ pipx install git+https://github.com/python-poetry/poetry@bd500dd3bdfaec3de6894144c9cedb3a9358be84 # v2.0.1
+ pipx inject poetry git+https://github.com/python-poetry/poetry-plugin-export@8c83d26603ca94f2e203bfded7b6d7f530960e06 # v1.8.0
+ - name: Setup Node.js
+ uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+ with:
+ node-version: "18.20.4"
+ - name: Setup python
+ uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+ with:
+ python-version: ${{ matrix.python-version }}
+ cache: "pip"
+ - name: Resolve and install project dependencies
+ # CDK spawns system python when compiling stack
+ # therefore it ignores both activated virtual env and cached interpreter by GH
+ run: |
+ poetry export --format requirements.txt --output requirements.txt
+ pip install --require-hashes -r requirements.txt
+
+ - name: Set up QEMU
+ uses: docker/setup-qemu-action@ce360397dd3f832beb865e1373c09c0e9f86d70a # v4.0.0
+ with:
+ platforms: arm64
+ # NOTE: we need QEMU to build Layer against a different architecture (e.g., ARM)
+
+ - name: Set up Docker Buildx
+ id: builder
+ uses: docker/setup-buildx-action@4d04d5d9486b7bd6fa91e7baf45bbb4f8b9deedd # v4.0.0
+ with:
+ driver: docker
+ platforms: linux/amd64,linux/arm64
+
+ - name: Install CDK
+ working-directory: ./
+ run: |
+ npm ci
+ npx cdk --version
+
+ # Baking time for PyPi eventual consistency; 60s seemed more than enough
+ # https://github.com/aws-powertools/powertools-lambda-python/issues/2491
+ - name: Baking time (PyPi)
+ run: sleep 60
+
+ - name: CDK build
+ run: npx cdk synth --verbose --context version="${{ inputs.latest_published_version }}" --context pythonVersion="python${{ matrix.python-version }}" -o cdk.out
+ env:
+ BUILDX_BUILDER: ${{ steps.builder.outputs.name }}
+ - name: zip output
+ run: zip -r cdk.py${{ matrix.python-version }}.out.zip cdk.out
+ - name: Archive CDK artifacts
+ uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+ with:
+ name: cdk-layer-artifact-py${{ matrix.python-version }}
+ path: layer_v3/cdk.py${{ matrix.python-version }}.out.zip
+
+ beta:
+ needs: build-layer
+ # lower privilege propagated from parent workflow (release-v3.yml)
+ permissions:
+ id-token: write
+ contents: read
+ pages: write # docs will be updated with latest Layer ARNs
+ pull-requests: write # creation-action will create a PR with Layer ARN updates
+ uses: ./.github/workflows/reusable_deploy_v3_layer_stack.yml
+ secrets: inherit
+ with:
+ stage: "BETA"
+ environment: "layer-beta"
+ source_code_artifact_name: ${{ inputs.source_code_artifact_name }}
+ source_code_integrity_hash: ${{ inputs.source_code_integrity_hash }}
+
+ prod:
+ if: ${{ !inputs.skip_lambda_layer }}
+ needs: beta
+ # lower privilege propagated from parent workflow (release-v3.yml)
+ permissions:
+ id-token: write
+ contents: read
+ pages: write # docs will be updated with latest Layer ARNs
+ pull-requests: write # creation-action will create a PR with Layer ARN updates
+ uses: ./.github/workflows/reusable_deploy_v3_layer_stack.yml
+ secrets: inherit
+ with:
+ stage: "PROD"
+ environment: "layer-prod"
+ source_code_artifact_name: ${{ inputs.source_code_artifact_name }}
+ source_code_integrity_hash: ${{ inputs.source_code_integrity_hash }}
+
+ sar-beta:
+ needs: beta # canaries run on Layer Beta env
+ permissions:
+ # lower privilege propagated from parent workflow (release.yml)
+ id-token: write
+ contents: read
+ pull-requests: none
+ pages: none
+ uses: ./.github/workflows/reusable_deploy_v3_sar.yml
+ secrets: inherit
+ with:
+ stage: "BETA"
+ environment: "layer-beta"
+ package-version: ${{ inputs.latest_published_version }}
+ source_code_artifact_name: ${{ inputs.source_code_artifact_name }}
+ source_code_integrity_hash: ${{ inputs.source_code_integrity_hash }}
+
+ sar-prod:
+ needs: sar-beta
+ permissions:
+ # lower privilege propagated from parent workflow (release.yml)
+ id-token: write
+ contents: read
+ pull-requests: none
+ pages: none
+ uses: ./.github/workflows/reusable_deploy_v3_sar.yml
+ secrets: inherit
+ with:
+ stage: "PROD"
+ environment: "layer-prod"
+ package-version: ${{ inputs.latest_published_version }}
+ source_code_artifact_name: ${{ inputs.source_code_artifact_name }}
+ source_code_integrity_hash: ${{ inputs.source_code_integrity_hash }}
+
+
+ # Updating the documentation with the latest Layer ARNs is a two-phase process
+ #
+ # 1. Update layer ARNs with latest deployed locally and create a PR with these changes
+ # 2. Pull from temporary branch with these changes and update the docs we're releasing
+ #
+ # This keeps our permissions tight and we don't run into a conflict,
+ # where a new release creates a new doc (2.16.0) while layers are still pointing to 2.15
+ # because the PR has to be merged while release process is running
+
+ update_v3_layer_arn_docs:
+ needs: prod
+ outputs:
+ temp_branch: ${{ steps.create-pr.outputs.temp_branch }}
+ runs-on: ubuntu-latest
+ permissions:
+ # lower privilege propagated from parent workflow (release.yml)
+ contents: write
+ pull-requests: write
+ id-token: none
+ pages: none
+ steps:
+ - name: Checkout repository # reusable workflows start clean, so we need to checkout again
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ env.RELEASE_COMMIT }}
+
+ - name: Restore sealed source code
+ uses: ./.github/actions/seal-restore
+ with:
+ integrity_hash: ${{ inputs.source_code_integrity_hash }}
+ artifact_name: ${{ inputs.source_code_artifact_name }}
+
+ - name: Replace layer versions in documentation
+ run: ./layer_v3/scripts/update_layer_arn_v3.sh ${{ inputs.layer_documentation_version }}
+ # NOTE: It felt unnecessary creating yet another PR to update changelog w/ latest tag
+ # since this is the only step in the release where we update docs from a temp branch
+ - name: Update changelog with latest tag
+ run: make changelog
+ - name: Create PR
+ id: create-pr
+ uses: ./.github/actions/create-pr
+ with:
+ files: "docs/index.md docs/includes/_layer_homepage_arm64.md docs/includes/_layer_homepage_x86.md examples CHANGELOG.md"
+ temp_branch_prefix: "ci-layer-docs"
+ pull_request_title: "chore(ci): layer docs update"
+ github_token: ${{ secrets.GITHUB_TOKEN }}
+
+ prepare_docs_alias:
+ runs-on: ubuntu-latest
+ permissions:
+ # lower privilege propagated from parent workflow (release.yml)
+ contents: read
+ pages: none
+ id-token: none
+ pull-requests: none
+ outputs:
+ DOCS_ALIAS: ${{ steps.set-alias.outputs.DOCS_ALIAS }}
+ steps:
+ - name: Set docs alias
+ id: set-alias
+ run: |
+ DOCS_ALIAS=latest
+ if [[ "${{ inputs.pre_release }}" == true ]] ; then
+ DOCS_ALIAS=alpha
+ fi
+ echo DOCS_ALIAS="$DOCS_ALIAS" >> "$GITHUB_OUTPUT"
+
+ release_docs:
+ needs: [update_v3_layer_arn_docs, prepare_docs_alias]
+ permissions:
+ # lower privilege propagated from parent workflow (release.yml)
+ contents: write
+ pages: write
+ pull-requests: none
+ id-token: write
+ secrets: inherit
+ uses: ./.github/workflows/reusable_publish_docs.yml
+ with:
+ version: ${{ inputs.latest_published_version }}
+ alias: ${{ needs.prepare_docs_alias.outputs.DOCS_ALIAS }}
+ git_ref: ${{ needs.update_v3_layer_arn_docs.outputs.temp_branch }}
diff --git a/.github/workflows/python_build.yml b/.github/workflows/python_build.yml
deleted file mode 100644
index 812ae7b41dd..00000000000
--- a/.github/workflows/python_build.yml
+++ /dev/null
@@ -1,60 +0,0 @@
-name: Code quality
-
-on:
- pull_request:
- paths:
- - "aws_lambda_powertools/**"
- - "tests/**"
- - "pyproject.toml"
- - "poetry.lock"
- - "mypy.ini"
- branches:
- - develop
- - v2
- push:
- paths:
- - "aws_lambda_powertools/**"
- - "tests/**"
- - "pyproject.toml"
- - "poetry.lock"
- - "mypy.ini"
- branches:
- - develop
- - v2
-
-jobs:
- build:
- runs-on: ubuntu-latest
- strategy:
- max-parallel: 4
- matrix:
- python-version: [3.7, 3.8, 3.9]
- env:
- PYTHON: ${{ matrix.python-version }}
- steps:
- - uses: actions/checkout@v3
- - name: Install poetry
- run: pipx install poetry
- - name: Set up Python ${{ matrix.python-version }}
- uses: actions/setup-python@v4
- with:
- python-version: ${{ matrix.python-version }}
- cache: "poetry"
- - name: Install dependencies
- run: make dev
- - name: Formatting and Linting
- run: make lint
- - name: Static type checking
- run: make mypy
- - name: Test with pytest
- run: make test
- - name: Security baseline
- run: make security-baseline
- - name: Complexity baseline
- run: make complexity-baseline
- - name: Upload coverage to Codecov
- uses: codecov/codecov-action@d9f34f8cd5cb3b3eb79b3e4b5dae3a16df499a70 # 3.1.1
- with:
- file: ./coverage.xml
- env_vars: PYTHON
- name: aws-lambda-powertools-python-codecov
diff --git a/.github/workflows/quality_check.yml b/.github/workflows/quality_check.yml
new file mode 100644
index 00000000000..dfbc6528e0d
--- /dev/null
+++ b/.github/workflows/quality_check.yml
@@ -0,0 +1,86 @@
+name: Quality check - check code
+
+# PROCESS
+#
+# 1. Install all dependencies and spin off containers for all supported Python versions
+# 2. Run code formatters and linters (various checks) for code standard
+# 3. Run static typing checker for potential bugs
+# 4. Run entire test suite for regressions except end-to-end (unit, functional, performance)
+# 5. Run static analysis (in addition to CodeQL) for common insecure code practices
+# 6. Run complexity baseline to avoid error-prone bugs and keep maintenance lower
+# 7. Collect and report on test coverage
+
+# USAGE
+#
+# Always triggered on new PRs, PR changes and PR merge.
+
+on:
+ pull_request:
+ paths:
+ - "aws_lambda_powertools/**"
+ - "tests/**"
+ - "examples/**"
+ - "pyproject.toml"
+ - "poetry.lock"
+ - "mypy.ini"
+ branches:
+ - develop
+ push:
+ paths:
+ - "aws_lambda_powertools/**"
+ - "tests/**"
+ - "examples/**"
+ - "pyproject.toml"
+ - "poetry.lock"
+ - "mypy.ini"
+ branches:
+ - develop
+
+permissions:
+ contents: read
+
+jobs:
+ quality_check:
+ runs-on: ubuntu-latest
+ strategy:
+ fail-fast: false
+ max-parallel: 5
+ matrix:
+ python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+ env:
+ PYTHON: "${{ matrix.python-version }}"
+ permissions:
+ contents: read # checkout code only
+ steps:
+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ - name: Install poetry
+ run: pipx install poetry
+ - name: Set up Python ${{ matrix.python-version }}
+ uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+ with:
+ python-version: ${{ matrix.python-version }}
+ - name: Install dependencies
+ run: make dev-quality-code
+ - name: Checking and enforcing format
+ run: make format-check
+ - name: Formatting and Linting
+ run: make lint
+ - name: Static type checking (mypy)
+ run: make mypy
+ - name: Static type checking (ty)
+ run: make ty
+ - name: Test with pytest
+ run: make test
+ - name: Test dependencies with Nox
+ run: make test-dependencies
+ - name: Security baseline
+ run: make security-baseline
+ - name: Complexity baseline
+ run: make complexity-baseline
+ - name: Upload coverage to Codecov
+ uses: codecov/codecov-action@e79a6962e0d4c0c17b229090214935d2e33f8354 # 6.0.1
+ with:
+ token: ${{ secrets.CODECOV_TOKEN }}
+ files: ./coverage.xml
+ env_vars: PYTHON
+ name: aws-lambda-powertools-python-codecov
diff --git a/.github/workflows/quality_check_docs.yml b/.github/workflows/quality_check_docs.yml
new file mode 100644
index 00000000000..9a61cf90a23
--- /dev/null
+++ b/.github/workflows/quality_check_docs.yml
@@ -0,0 +1,50 @@
+name: Quality check - Build docs
+
+# PROCESS
+#
+# 1. Install all dependencies required to build the docs
+# 2. Build the docs
+
+# USAGE
+#
+# Always triggered on new PRs, PR changes and PR merge.
+
+
+on:
+ pull_request:
+ paths:
+ - "docs/**"
+ - "examples/**"
+ - "mkdocs.yml"
+ branches:
+ - develop
+ push:
+ paths:
+ - "docs/**"
+ - "examples/**"
+ - "mkdocs.yml"
+ branches:
+ - develop
+
+permissions:
+ contents: read
+
+jobs:
+ build_docs:
+ runs-on: ubuntu-latest
+ permissions:
+ contents: read # checkout code only
+ steps:
+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ - name: Set up Python
+ uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+ with:
+ python-version: 3.14
+ - name: Install doc generation dependencies
+ run: |
+ cat docs/requirements.txt
+ pip install --require-hashes -r docs/requirements.txt
+ - name: Build docs
+ run: |
+ rm -rf site
+ mkdocs build
diff --git a/.github/workflows/quality_code_cdk_constructor.yml b/.github/workflows/quality_code_cdk_constructor.yml
new file mode 100644
index 00000000000..497d0bea446
--- /dev/null
+++ b/.github/workflows/quality_code_cdk_constructor.yml
@@ -0,0 +1,71 @@
+name: Code quality - CDK constructor
+
+# PROCESS
+#
+# 1. Install all dependencies and spin off containers for all supported Python versions
+# 2. Run code formatters and linters (various checks) for code standard
+# 3. Run static typing checker for potential bugs
+# 4. Run tests
+
+# USAGE
+#
+# Always triggered on new PRs, PR changes and PR merge.
+
+
+on:
+ pull_request:
+ paths:
+ - "layer_v3/layer_constructors/**"
+ branches:
+ - develop
+ push:
+ paths:
+ - "layer_v3/layer_constructors/**"
+ branches:
+ - develop
+
+permissions:
+ contents: read
+
+jobs:
+ quality_check_cdk:
+ runs-on: ubuntu-latest
+ strategy:
+ max-parallel: 4
+ matrix:
+ python-version: ["3.14"]
+ env:
+ PYTHON: "${{ matrix.python-version }}"
+ permissions:
+ contents: read # checkout code only
+ defaults:
+ run:
+ working-directory: ./layer_v3/layer_constructors
+ steps:
+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ - name: Install poetry
+ run: pipx install poetry
+ - name: Set up Python ${{ matrix.python-version }}
+ uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+ with:
+ python-version: ${{ matrix.python-version }}
+ cache: "poetry"
+ - name: Set up QEMU
+ uses: docker/setup-qemu-action@ce360397dd3f832beb865e1373c09c0e9f86d70a # v4.0.0
+ with:
+ platforms: arm64
+ # NOTE: we need QEMU to build Layer against a different architecture (e.g., ARM)
+ - name: Set up Docker Buildx
+ id: builder
+ uses: docker/setup-buildx-action@4d04d5d9486b7bd6fa91e7baf45bbb4f8b9deedd # v4.0.0
+ with:
+ driver: docker
+ platforms: linux/amd64,linux/arm64
+ - name: Install dependencies
+ run: |
+ pip install --upgrade pip pre-commit poetry
+ poetry install
+ - name: Test with pytest
+ run: poetry run pytest tests
+ env:
+ BUILDX_BUILDER: ${{ steps.builder.outputs.name }}
diff --git a/.github/workflows/rebuild_latest_docs.yml b/.github/workflows/rebuild_latest_docs.yml
index eb995d95a12..665cad81dd1 100644
--- a/.github/workflows/rebuild_latest_docs.yml
+++ b/.github/workflows/rebuild_latest_docs.yml
@@ -1,30 +1,38 @@
name: Rebuild latest docs
+# PROCESS
#
-# === Documentation hotfix ===
+# 1. Build User Guide and API docs
+# 2. Publish to GitHub Pages
+# 3. Publish to S3 (new home)
+
+# USAGE
+#
+# Only used for deploying a documentation hotfix to /latest and its associated version w/o a full release.
+#
+# Steps:
#
# 1. Trigger "Rebuild latest docs" workflow manually: https://docs.github.com/en/actions/managing-workflow-runs/manually-running-a-workflow
-# 2. Use the latest version released under Releases e.g. v1.22.0
+# 2. Use the latest version released under Releases e.g. 2.0.0
on:
workflow_dispatch:
inputs:
latest_published_version:
- description: "Latest PyPi published version to rebuild latest docs for, e.g. v1.26.7"
- default: "v1.28.0"
+ description: "Latest PyPi published version to rebuild latest docs for, e.g. 2.16.3"
+ default: "2.16.3"
required: true
-jobs:
- changelog:
- permissions:
- contents: write
- uses: ./.github/workflows/reusable_publish_changelog.yml
+permissions:
+ contents: read
+jobs:
release-docs:
- needs: changelog
permissions:
- contents: write
- pages: write
+ contents: write # push to gh-pages
+ pages: write # deploy gh-pages website
+ id-token: write # trade JWT token for AWS credentials in AWS Docs account
+ secrets: inherit
uses: ./.github/workflows/reusable_publish_docs.yml
with:
version: ${{ inputs.latest_published_version }}
diff --git a/.github/workflows/record_pr.yml b/.github/workflows/record_pr.yml
deleted file mode 100644
index b1638ad8865..00000000000
--- a/.github/workflows/record_pr.yml
+++ /dev/null
@@ -1,22 +0,0 @@
-name: Record PR details
-
-on:
- pull_request:
- types: [opened, edited, closed, labeled]
-
-jobs:
- record_pr:
- runs-on: ubuntu-latest
-
- steps:
- - uses: actions/checkout@v3
- - name: "Extract PR details"
- uses: actions/github-script@v6
- with:
- script: |
- const script = require('.github/scripts/save_pr_details.js')
- await script({github, context, core})
- - uses: actions/upload-artifact@v3
- with:
- name: pr
- path: pr.txt
diff --git a/.github/workflows/release-drafter.yml b/.github/workflows/release-drafter.yml
index 3007aa0241d..e08dd925efe 100644
--- a/.github/workflows/release-drafter.yml
+++ b/.github/workflows/release-drafter.yml
@@ -1,15 +1,30 @@
name: Release Drafter
+# PROCESS
+#
+# 1. Enumerate all PRs in merged state
+# 2. Filter out any PR labeled `skip-changelog`
+# 3. Updates or creates a new release in Draft mode
+
+# USAGE
+#
+# Always run on merged PRs or manually via GitHub UI for debugging purposes.
+#
+# see .github/release-drafter.yml for configuration
+
on:
push:
branches:
- develop
workflow_dispatch:
+permissions:
+ contents: read
+
jobs:
update_release_draft:
runs-on: ubuntu-latest
+ permissions:
+ contents: write # create release in draft mode
steps:
- - uses: release-drafter/release-drafter@df69d584deac33d8569990cb6413f82447181076 # v5.20.1
- env:
- GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ - uses: release-drafter/release-drafter@c2e2804cc59f45f57076a99af580d0fedb697927 # v7.3.0
diff --git a/.github/workflows/release-v3.yml b/.github/workflows/release-v3.yml
new file mode 100644
index 00000000000..64099e11413
--- /dev/null
+++ b/.github/workflows/release-v3.yml
@@ -0,0 +1,398 @@
+name: Release V3
+
+# RELEASE PROCESS
+#
+# === Automated activities ===
+#
+# 1. [Seal] Bump to release version and export source code with integrity hash
+# 2. [Quality check] Restore sealed source code, run tests, linting, security and complexity base line
+# 3. [Build] Restore sealed source code, create and export hashed build artifact for PyPi release (wheel, tarball)
+# 4. [Provenance] Generates provenance for build, signs attestation with GitHub OIDC claims to confirm it came from this release pipeline, commit, org, repo, branch, hash, etc.
+# 5. [Release] Restore built artifact, and publish package to PyPi prod repository
+# 6. [Create Tag] Restore sealed source code, create a new git tag using released version, uploads provenance to latest draft release
+# 7. [PR to bump version] Restore sealed source code, and create a PR to update trunk with latest released project metadata
+# 8. [Publish Layer v3] Compile Layer in multiple Python versions and kick off pipeline for beta, prod, and canary releases
+# 9. [Publish Layer v3] Update docs with latest Layer ARNs and Changelog
+# 10. [Publish Layer v3] Create PR to update trunk so staged docs also point to the latest Layer ARN, when merged
+# 12. [Post release] Close all issues labeled "pending-release" and notify customers about the release
+#
+# === Manual activities ===
+#
+# 1. Kick off this workflow with the intended version
+# 2. Update draft release notes after this workflow completes
+# 3. If not already set, use `v<new version>` as a tag, e.g., v3.0.0, and select develop as target branch
+
+# NOTE
+#
+# See MAINTAINERS.md "Releasing a new version" for release mechanisms
+#
+# Every job is isolated and starts a new fresh container.
+
+env:
+ RELEASE_COMMIT: ${{ github.sha }}
+ RELEASE_TAG_VERSION: ${{ inputs.version_to_publish }}
+
+on:
+ workflow_dispatch:
+ inputs:
+ version_to_publish:
+ description: "Version to be released in PyPi, Docs, and Lambda Layer, e.g. v3.0.0, v3.0.0a0 (pre-release)"
+ default: v3.0.0
+ required: true
+ layer_documentation_version:
+ description: "Lambda layer version to be updated in our documentation. e.g. if the current layer number is 3, this value must be 4."
+ type: string
+ required: true
+ skip_pypi:
+ description: "Skip publishing to PyPi as it can't publish more than once. Useful for semi-failed releases"
+ default: false
+ type: boolean
+ required: false
+ skip_lambda_layer:
+ description: "Skip publishing Lambda Layers as it can publish duplicated versions of the same layer. Useful for semi-failed releases"
+ default: false
+ type: boolean
+ required: false
+ skip_code_quality:
+ description: "Skip tests, linting, and baseline. Only use if release fail for reasons beyond our control and you need a quick release."
+ default: false
+ type: boolean
+ required: false
+ pre_release:
+ description: "Publishes documentation using a pre-release tag (v3.0.0a0). You are still responsible for passing a pre-release version tag to the workflow."
+ default: false
+ type: boolean
+ required: false
+
+permissions:
+ contents: read
+
+jobs:
+
+ # This job bumps the package version to the release version
+ # creates an integrity hash from the source code
+ # uploads the artifact with the integrity hash as the key name
+ # so subsequent jobs can restore from a trusted point in time to prevent tampering
+ seal:
+ runs-on: ubuntu-latest
+ permissions:
+ contents: read
+ outputs:
+ integrity_hash: ${{ steps.seal_source_code.outputs.integrity_hash }}
+ artifact_name: ${{ steps.seal_source_code.outputs.artifact_name }}
+ RELEASE_VERSION: ${{ steps.release_version.outputs.RELEASE_VERSION }}
+ steps:
+ - name: Export release version
+ id: release_version
+ # transform tag format `v<version` to `<version>`
+ run: |
+ RELEASE_VERSION="${RELEASE_TAG_VERSION:1}"
+ echo "RELEASE_VERSION=${RELEASE_VERSION}" >> "$GITHUB_OUTPUT"
+
+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ env.RELEASE_COMMIT }}
+
+ # We use a pinned version of Poetry to be certain it won't modify source code before we create a hash
+ - name: Install poetry
+ run: |
+ pipx install git+https://github.com/python-poetry/poetry@bd500dd3bdfaec3de6894144c9cedb3a9358be84 # v2.0.1
+ pipx inject poetry git+https://github.com/monim67/poetry-bumpversion@348de6f247222e2953d649932426e63492e0a6bf # v0.3.3
+
+ - name: Bump package version
+ id: versioning
+ run: poetry version "${RELEASE_VERSION}"
+ env:
+ RELEASE_VERSION: ${{ steps.release_version.outputs.RELEASE_VERSION}}
+
+ - name: Seal and upload
+ id: seal_source_code
+ uses: ./.github/actions/seal
+ with:
+ artifact_name_prefix: "source"
+
+ # This job runs our automated test suite, complexity and security baselines
+ # it ensures previously merged have been tested as part of the pull request process
+ #
+ # NOTE
+ #
+ # we don't upload the artifact after testing to prevent any tampering of our source code dependencies
+ quality_check:
+ needs: seal
+ runs-on: ubuntu-latest
+ permissions:
+ contents: read
+ steps:
+ # NOTE: we need actions/checkout to configure git first (pre-commit hooks in make dev)
+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ env.RELEASE_COMMIT }}
+
+ - name: Restore sealed source code
+ uses: ./.github/actions/seal-restore
+ with:
+ integrity_hash: ${{ needs.seal.outputs.integrity_hash }}
+ artifact_name: ${{ needs.seal.outputs.artifact_name }}
+
+ - name: Debug cache restore
+ run: cat pyproject.toml
+
+ - name: Install poetry
+ run: pipx install git+https://github.com/python-poetry/poetry@bd500dd3bdfaec3de6894144c9cedb3a9358be84 # v2.0.1
+ - name: Set up Python
+ uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+ with:
+ python-version: "3.14"
+ cache: "poetry"
+ - name: Install dependencies
+ run: make dev
+ - name: Run all tests, linting and baselines
+ run: make pr
+
+ # This job creates a release artifact (tar.gz, wheel)
+ # it checks out code from release commit for custom actions to work
+ # then restores the sealed source code (overwrites any potential tampering)
+ # it's done separately from release job to enforce least privilege.
+ # We export just the final build artifact for release
+ build:
+ runs-on: ubuntu-latest
+ needs: [quality_check, seal]
+ permissions:
+ contents: read
+ outputs:
+ integrity_hash: ${{ steps.seal_build.outputs.integrity_hash }}
+ artifact_name: ${{ steps.seal_build.outputs.artifact_name }}
+ attestation_hashes: ${{ steps.encoded_hash.outputs.attestation_hashes }}
+ steps:
+ # NOTE: we need actions/checkout to configure git first (pre-commit hooks in make dev)
+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ env.RELEASE_COMMIT }}
+
+ - name: Restore sealed source code
+ uses: ./.github/actions/seal-restore
+ with:
+ integrity_hash: ${{ needs.seal.outputs.integrity_hash }}
+ artifact_name: ${{ needs.seal.outputs.artifact_name }}
+
+ - name: Install poetry
+ run: pipx install git+https://github.com/python-poetry/poetry@bd500dd3bdfaec3de6894144c9cedb3a9358be84 # v2.0.1
+ - name: Set up Python
+ uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+ with:
+ python-version: "3.14"
+ cache: "poetry"
+
+ - name: Build python package and wheel
+ run: poetry build
+
+ - name: Seal and upload
+ id: seal_build
+ uses: ./.github/actions/seal
+ with:
+ artifact_name_prefix: "build"
+ files: "dist/"
+
+ # NOTE: SLSA retraces our build to its artifact to ensure it wasn't tampered
+ # coupled with GitHub OIDC, SLSA can then confidently sign it came from this release pipeline+commit+branch+org+repo+actor+integrity hash
+ - name: Create attestation encoded hash for provenance
+ id: encoded_hash
+ working-directory: dist
+ run: echo "attestation_hashes=$(sha256sum ./* | base64 -w0)" >> "$GITHUB_OUTPUT"
+
+ # This job creates a provenance file that describes how our release was built (all steps)
+ # after it verifies our build is reproducible within the same pipeline
+ # it confirms that its own software and the CI build haven't been tampered with (Trust but verify)
+ # lastly, it creates and sign an attestation (multiple.intoto.jsonl) that confirms
+ # this build artifact came from this GitHub org, branch, actor, commit ID, inputs that triggered this pipeline, and matches its integrity hash
+ # NOTE: supply chain threats review (we protect against all of them now): https://slsa.dev/spec/v1.0/threats-overview
+ provenance:
+ needs: [seal, build]
+ permissions:
+ contents: write # nested job explicitly require despite upload assets being set to false
+ actions: read # To read the workflow path.
+ id-token: write # To sign the provenance.
+ # NOTE: provenance fails if we use action pinning... it's a Github limitation
+ # because SLSA needs to trace & attest it came from a given branch; pinning doesn't expose that information
+ # https://github.com/slsa-framework/slsa-github-generator/blob/main/internal/builders/generic/README.md#referencing-the-slsa-generator
+ uses: slsa-framework/slsa-github-generator/.github/workflows/generator_generic_slsa3.yml@v2.1.0
+ with:
+ base64-subjects: ${{ needs.build.outputs.attestation_hashes }}
+ upload-assets: false # we upload its attestation in create_tag job, otherwise it creates a new release
+
+ # This job uses release artifact to publish to PyPi
+ # it exchanges JWT tokens with GitHub to obtain PyPi credentials
+ # since it's already registered as a Trusted Publisher.
+ # It uses the sealed build artifact (.whl, .tar.gz) to release it
+ release:
+ needs: [build, seal, provenance]
+ environment: release
+ runs-on: ubuntu-latest
+ permissions:
+ id-token: write # OIDC for PyPi Trusted Publisher feature
+ env:
+ RELEASE_VERSION: ${{ needs.seal.outputs.RELEASE_VERSION }}
+ steps:
+ # NOTE: we need actions/checkout in order to use our local actions (e.g., ./.github/actions)
+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ env.RELEASE_COMMIT }}
+
+ - name: Restore sealed source code
+ uses: ./.github/actions/seal-restore
+ with:
+ integrity_hash: ${{ needs.build.outputs.integrity_hash }}
+ artifact_name: ${{ needs.build.outputs.artifact_name }}
+
+ - name: Upload to PyPi prod
+ if: ${{ !inputs.skip_pypi }}
+ uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # v1.14.0
+
+ # PyPi test maintenance affected us numerous times, leaving for history purposes
+ # - name: Upload to PyPi test
+ # if: ${{ !inputs.skip_pypi }}
+ # uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # v1.14.0
+ # with:
+ # repository-url: https://test.pypi.org/legacy/
+
+ # We create a Git Tag using our release version (e.g., v3.16.0)
+ # using our sealed source code we created earlier.
+ # Because we bumped version of our project as part of CI
+ # we need to add this into git before pushing the tag
+ # otherwise the release commit will be used as the basis for the tag.
+ # Later, we create a PR to update trunk with our newest release version (e.g., bump_version job)
+ create_tag:
+ needs: [release, seal, provenance]
+ runs-on: ubuntu-latest
+ permissions:
+ contents: write
+ steps:
+ # NOTE: we need actions/checkout to authenticate and configure git first
+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ env.RELEASE_COMMIT }}
+
+ - name: Restore sealed source code
+ uses: ./.github/actions/seal-restore
+ with:
+ integrity_hash: ${{ needs.seal.outputs.integrity_hash }}
+ artifact_name: ${{ needs.seal.outputs.artifact_name }}
+
+ - id: setup-git
+ name: Git client setup and refresh tip
+ run: |
+ git config user.name "Powertools for AWS Lambda (Python) bot"
+ git config user.email "151832416+aws-powertools-bot@users.noreply.github.com"
+ git config remote.origin.url >&-
+
+ - name: Create Git Tag
+ run: |
+ git add pyproject.toml aws_lambda_powertools/shared/version.py
+ git commit -m "chore: version bump"
+ git tag -a v"${RELEASE_VERSION}" -m "release_version: v${RELEASE_VERSION}"
+ git push origin v"${RELEASE_VERSION}"
+ env:
+ RELEASE_VERSION: ${{ needs.seal.outputs.RELEASE_VERSION }}
+
+ - name: Upload provenance
+ id: upload-provenance
+ uses: ./.github/actions/upload-release-provenance
+ with:
+ release_version: ${{ needs.seal.outputs.RELEASE_VERSION }}
+ provenance_name: ${{needs.provenance.outputs.provenance-name}}
+ github_token: ${{ secrets.GITHUB_TOKEN }}
+
+ # Creates a PR with the latest version we've just released
+ # since our trunk is protected against any direct pushes from automation
+ bump_version:
+ needs: [release, seal]
+ permissions:
+ contents: write # create-pr action creates a temporary branch
+ pull-requests: write # create-pr action creates a PR using the temporary branch
+ runs-on: ubuntu-latest
+ steps:
+ # NOTE: we need actions/checkout to authenticate and configure git first
+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ env.RELEASE_COMMIT }}
+
+ - name: Restore sealed source code
+ uses: ./.github/actions/seal-restore
+ with:
+ integrity_hash: ${{ needs.seal.outputs.integrity_hash }}
+ artifact_name: ${{ needs.seal.outputs.artifact_name }}
+
+ - name: Create PR
+ id: create-pr
+ uses: ./.github/actions/create-pr
+ with:
+ files: "pyproject.toml aws_lambda_powertools/shared/version.py"
+ temp_branch_prefix: "ci-bump"
+ pull_request_title: "chore(ci): bump version to ${{ needs.seal.outputs.RELEASE_VERSION }}"
+ github_token: ${{ secrets.GITHUB_TOKEN }}
+
+ # This job compiles a Lambda Layer optimized for space and speed (e.g., Cython)
+ # It then deploys to Layer's Beta and Prod account, including SAR Beta and Prod account.
+ # It uses canaries to attest Layers can be used and imported between stages.
+ # Lastly, it updates our documentation with the latest Layer ARN for all regions
+ #
+ # NOTE
+ #
+ # Watch out for the depth limit of 4 nested workflow_calls.
+ # publish_layer -> publish_3_layer -> reusable_deploy_v3_layer_stack
+ publish_layer:
+ needs: [seal, release, create_tag]
+ secrets: inherit
+ permissions:
+ id-token: write
+ contents: write
+ pages: write
+ pull-requests: write
+ uses: ./.github/workflows/publish_v3_layer.yml
+ with:
+ latest_published_version: ${{ needs.seal.outputs.RELEASE_VERSION }}
+ layer_documentation_version: ${{ inputs.layer_documentation_version }}
+ pre_release: ${{ inputs.pre_release }}
+ source_code_artifact_name: ${{ needs.seal.outputs.artifact_name }}
+ source_code_integrity_hash: ${{ needs.seal.outputs.integrity_hash }}
+ skip_lambda_layer: ${{ inputs.skip_lambda_layer }}
+
+ post_release:
+ needs: [seal, release, publish_layer]
+ permissions:
+ contents: read
+ issues: write
+ discussions: write
+ pull-requests: write
+ runs-on: ubuntu-latest
+ env:
+ RELEASE_VERSION: ${{ needs.seal.outputs.RELEASE_VERSION }}
+ steps:
+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ env.RELEASE_COMMIT }}
+ - name: Restore sealed source code
+ uses: ./.github/actions/seal-restore
+ with:
+ integrity_hash: ${{ needs.seal.outputs.integrity_hash }}
+ artifact_name: ${{ needs.seal.outputs.artifact_name }}
+ - name: Close issues related to this release
+ uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+ with:
+ github-token: ${{ secrets.GITHUB_TOKEN }}
+ script: |
+ const post_release = require('.github/scripts/post_release.js')
+ await post_release({github, context, core})
+
+ update_ssm:
+ needs: [seal, release, publish_layer]
+ secrets: inherit
+ permissions:
+ id-token: write
+ contents: read
+ uses: ./.github/workflows/update_ssm.yml
+ with:
+ environment: "Prod"
+ write_latest: true
+ package_version: ${{ needs.seal.outputs.RELEASE_VERSION }}
+ layer_version: ${{ inputs.layer_documentation_version }}
diff --git a/.github/workflows/reusable_deploy_layer_stack.yml b/.github/workflows/reusable_deploy_layer_stack.yml
deleted file mode 100644
index 20d69b9c814..00000000000
--- a/.github/workflows/reusable_deploy_layer_stack.yml
+++ /dev/null
@@ -1,99 +0,0 @@
-name: Deploy cdk stack
-
-permissions:
- id-token: write
- contents: read
-
-on:
- workflow_call:
- inputs:
- stage:
- description: "Deployment stage (BETA, PROD)"
- required: true
- type: string
- artefact-name:
- description: "CDK Layer Artefact name to download"
- required: true
- type: string
- environment:
- description: "GitHub Environment to use for encrypted secrets"
- required: true
- type: string
-
-jobs:
- deploy-cdk-stack:
- runs-on: ubuntu-latest
- environment: ${{ inputs.environment }}
- defaults:
- run:
- working-directory: ./layer
- strategy:
- fail-fast: false
- matrix:
- region:
- [
- "af-south-1",
- "eu-central-1",
- "us-east-1",
- "us-east-2",
- "us-west-1",
- "us-west-2",
- "ap-east-1",
- "ap-south-1",
- "ap-northeast-1",
- "ap-northeast-2",
- "ap-southeast-1",
- "ap-southeast-2",
- "ca-central-1",
- "eu-west-1",
- "eu-west-2",
- "eu-west-3",
- "eu-south-1",
- "eu-north-1",
- "sa-east-1",
- "ap-southeast-3",
- "ap-northeast-3",
- "me-south-1",
- ]
- steps:
- - name: checkout
- uses: actions/checkout@v3
- - name: Install poetry
- run: pipx install poetry
- - name: aws credentials
- uses: aws-actions/configure-aws-credentials@v1
- with:
- aws-region: ${{ matrix.region }}
- role-to-assume: ${{ secrets.AWS_LAYERS_ROLE_ARN }}
- - name: Setup Node.js
- uses: actions/setup-node@v3
- with:
- node-version: "16.12"
- - name: Setup python
- uses: actions/setup-python@v4
- with:
- python-version: "3.9"
- cache: "pip"
- - name: Resolve and install project dependencies
- # CDK spawns system python when compiling stack
- # therefore it ignores both activated virtual env and cached interpreter by GH
- run: |
- poetry export --format requirements.txt --output requirements.txt
- pip install -r requirements.txt
- - name: install cdk and deps
- run: |
- npm install -g aws-cdk@2.29.0
- cdk --version
- - name: install deps
- run: poetry install
- - name: Download artifact
- uses: actions/download-artifact@v3
- with:
- name: ${{ inputs.artefact-name }}
- path: layer
- - name: unzip artefact
- run: unzip cdk.out.zip
- - name: CDK Deploy Layer
- run: cdk deploy --app cdk.out --context region=${{ matrix.region }} 'LayerStack' --require-approval never --verbose
- - name: CDK Deploy Canary
- run: cdk deploy --app cdk.out --context region=${{ matrix.region}} --parameters DeployStage="${{ inputs.stage }}" 'CanaryStack' --require-approval never --verbose
diff --git a/.github/workflows/reusable_deploy_v3_layer_stack.yml b/.github/workflows/reusable_deploy_v3_layer_stack.yml
new file mode 100644
index 00000000000..58b7650e3cb
--- /dev/null
+++ b/.github/workflows/reusable_deploy_v3_layer_stack.yml
@@ -0,0 +1,219 @@
+name: Deploy CDK Layer v3 stack
+
+# PROCESS
+#
+# 1. Split what AWS regions support ARM vs regions that Lambda support ARM
+# 2. We build the Lambda layer for 3.10 to 3.14 Python runtime and both x86_64 and arm64 (see `matrix` section)
+# 3. Deploy previously built layer for each AWS commercial region
+# 4. Export all published Layers as JSON
+# 5. Deploy Canaries to every deployed region to test whether Powertools can be imported etc.
+
+# USAGE
+#
+# NOTE: meant to be used with ./.github/workflows/publish_v3_layer.yml
+#
+# beta:
+# needs: build-layer
+# # lower privilege propagated from parent workflow (release.yml)
+# permissions:
+# id-token: write
+# contents: read
+# pages: write # docs will be updated with latest Layer ARNs
+# pull-requests: write # creation-action will create a PR with Layer ARN updates
+# uses: ./.github/workflows/reusable_deploy_v3_layer_stack.yml
+# secrets: inherit
+# with:
+# stage: "BETA"
+# environment: "layer-beta"
+# source_code_artifact_name: code.zip
+# source_code_integrity_hash: sha256string
+
+on:
+ workflow_call:
+ inputs:
+ stage:
+ description: "Deployment stage (BETA, PROD)"
+ required: true
+ type: string
+ environment:
+ description: "GitHub Environment to use for encrypted secrets"
+ required: true
+ type: string
+ source_code_artifact_name:
+ description: "Artifact name to restore sealed source code"
+ type: string
+ required: true
+ source_code_integrity_hash:
+ description: "Sealed source code integrity hash"
+ type: string
+ required: true
+
+permissions:
+ contents: read
+
+env:
+ RELEASE_COMMIT: ${{ github.sha }} # it gets propagated from the caller for security reasons
+
+jobs:
+ deploy-cdk-stack:
+ runs-on: ubuntu-latest
+ environment: ${{ inputs.environment }}
+ # lower privilege propagated from parent workflow (publish_v3_layer.yml)
+ permissions:
+ id-token: write
+ pull-requests: none
+ contents: read
+ pages: none
+ defaults:
+ run:
+ working-directory: ./layer_v3
+ strategy:
+ fail-fast: false
+ matrix:
+ # To get a list of current regions, use:
+ # aws ec2 describe-regions --all-regions --query "Regions[].RegionName" --output text | tr "\t" "\n" | sort
+ region: ["af-south-1", "ap-east-1", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3",
+ "ap-south-1", "ap-south-2", "ap-southeast-1", "ap-southeast-2", "ap-southeast-3",
+ "ap-southeast-4", "ap-southeast-5", "ap-southeast-7", "ca-central-1", "ca-west-1", "eu-central-1", "eu-central-2",
+ "eu-north-1", "eu-south-1", "eu-south-2", "eu-west-1", "eu-west-2", "eu-west-3",
+ "il-central-1", "mx-central-1", "sa-east-1", "us-east-1",
+ "us-east-2", "us-west-1", "us-west-2"]
+ python-version: ["3.10","3.11","3.12","3.13","3.14"]
+ include:
+ - region: "af-south-1"
+ has_arm64_support: "true"
+ - region: "ap-east-1"
+ has_arm64_support: "true"
+ - region: "ap-northeast-1"
+ has_arm64_support: "true"
+ - region: "ap-northeast-2"
+ has_arm64_support: "true"
+ - region: "ap-northeast-3"
+ has_arm64_support: "true"
+ - region: "ap-south-1"
+ has_arm64_support: "true"
+ - region: "ap-south-2"
+ has_arm64_support: "true"
+ - region: "ap-southeast-1"
+ has_arm64_support: "true"
+ - region: "ap-southeast-2"
+ has_arm64_support: "true"
+ - region: "ap-southeast-3"
+ has_arm64_support: "true"
+ - region: "ap-southeast-4"
+ has_arm64_support: "true"
+ - region: "ap-southeast-5"
+ has_arm64_support: "true"
+ - region: "ap-southeast-7"
+ has_arm64_support: "true"
+ - region: "ca-central-1"
+ has_arm64_support: "true"
+ - region: "ca-west-1"
+ has_arm64_support: "true"
+ - region: "eu-central-1"
+ has_arm64_support: "true"
+ - region: "eu-central-2"
+ has_arm64_support: "true"
+ - region: "eu-north-1"
+ has_arm64_support: "true"
+ - region: "eu-south-1"
+ has_arm64_support: "true"
+ - region: "eu-south-2"
+ has_arm64_support: "true"
+ - region: "eu-west-1"
+ has_arm64_support: "true"
+ - region: "eu-west-2"
+ has_arm64_support: "true"
+ - region: "eu-west-3"
+ has_arm64_support: "true"
+ - region: "il-central-1"
+ has_arm64_support: "true"
+ - region: "mx-central-1"
+ has_arm64_support: "true"
+ - region: "sa-east-1"
+ has_arm64_support: "true"
+ - region: "us-east-1"
+ has_arm64_support: "true"
+ - region: "us-east-2"
+ has_arm64_support: "true"
+ - region: "us-west-1"
+ has_arm64_support: "true"
+ - region: "us-west-2"
+ has_arm64_support: "true"
+ steps:
+ - name: checkout
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ env.RELEASE_COMMIT }}
+
+ - name: Restore sealed source code
+ uses: ./.github/actions/seal-restore
+ with:
+ integrity_hash: ${{ inputs.source_code_integrity_hash }}
+ artifact_name: ${{ inputs.source_code_artifact_name }}
+
+ - name: Install poetry
+ run: |
+ pipx install git+https://github.com/python-poetry/poetry@bd500dd3bdfaec3de6894144c9cedb3a9358be84 # v2.0.1
+ pipx inject poetry git+https://github.com/python-poetry/poetry-plugin-export@8c83d26603ca94f2e203bfded7b6d7f530960e06 # v1.8.0
+ - name: Configure AWS credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ aws-region: ${{ matrix.region }}
+ role-to-assume: ${{ secrets.AWS_LAYERS_ROLE_ARN }}
+ mask-aws-account-id: true
+ - name: Setup Node.js
+ uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+ with:
+ node-version: "18.20.4"
+ - name: Setup python
+ uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+ with:
+ python-version: ${{ matrix.python-version }}
+ cache: "pip"
+ - name: Resolve and install project dependencies
+ # CDK spawns system python when compiling stack
+ # therefore it ignores both activated virtual env and cached interpreter by GH
+ run: |
+ poetry export --format requirements.txt --output requirements.txt
+ pip install --require-hashes -r requirements.txt
+ - name: install cdk and deps
+ working-directory: ./
+ run: |
+ npm ci
+ npx cdk --version
+ - name: install deps
+ run: poetry install
+ - name: Download artifact
+ uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+ with:
+ name: cdk-layer-artifact-py${{ matrix.python-version }}
+ path: layer_v3
+ - name: unzip artefact
+ run: unzip cdk.py${{ matrix.python-version }}.out.zip
+ - name: Define constants
+ id: constants
+ run: |
+ PYTHON_VERSION=$(echo ${{ matrix.python-version }} | tr -d '.')
+ echo "PYTHON_VERSION=${PYTHON_VERSION}" >> "$GITHUB_OUTPUT"
+ LAYER_VERSION=${{ matrix.region }}-$PYTHON_VERSION-layer-version.txt
+ echo "LAYER_VERSION=${LAYER_VERSION}" >> "$GITHUB_OUTPUT"
+ - name: CDK Deploy Layer
+ run: npx cdk deploy --app cdk.out --context region=${{ matrix.region }} --parameters HasARM64Support=${{ matrix.has_arm64_support }} "LayerV3Stack-python${{steps.constants.outputs.PYTHON_VERSION}}" --require-approval never --verbose --outputs-file cdk-outputs.json
+ - name: Store latest Layer ARN
+ if: ${{ inputs.stage == 'PROD' }}
+ run: |
+ mkdir cdk-layer-stack
+ jq -r -c ".[\"LayerV3Stack-python${{steps.constants.outputs.PYTHON_VERSION}}\"].LatestLayerArn" cdk-outputs.json > cdk-layer-stack/${{steps.constants.outputs.LAYER_VERSION}}
+ jq -r -c ".[\"LayerV3Stack-python${{steps.constants.outputs.PYTHON_VERSION}}\"].LatestLayerArm64Arn" cdk-outputs.json >> cdk-layer-stack/${{steps.constants.outputs.LAYER_VERSION}}
+ cat cdk-layer-stack/${{steps.constants.outputs.LAYER_VERSION}}
+ - name: Save Layer ARN artifact
+ if: ${{ inputs.stage == 'PROD' }}
+ uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+ with:
+ name: cdk-layer-stack-${{ matrix.region }}-${{ matrix.python-version }}
+ path: ./layer_v3/cdk-layer-stack/* # NOTE: upload-artifact does not inherit working-directory setting.
+ if-no-files-found: error
+ retention-days: 1
+ - name: CDK Deploy Canary
+ run: npx cdk deploy --app cdk.out --context region=${{ matrix.region }} --parameters DeployStage="${{ inputs.stage }}" --parameters HasARM64Support=${{ matrix.has_arm64_support }} "CanaryV3Stack-python${{steps.constants.outputs.PYTHON_VERSION}}" --require-approval never --verbose
diff --git a/.github/workflows/reusable_deploy_v3_sar.yml b/.github/workflows/reusable_deploy_v3_sar.yml
new file mode 100644
index 00000000000..3fc8cbc2fd4
--- /dev/null
+++ b/.github/workflows/reusable_deploy_v3_sar.yml
@@ -0,0 +1,211 @@
+name: Deploy V3 SAR
+
+# PROCESS
+#
+# 1. This workflow starts after the layer artifact is produced on `publish_v3_layer`
+# 2. We use the same layer artifact to ensure the SAR app is consistent with the published Lambda Layer
+# 3. We publish the SAR for 3.10 to 3.14 Python runtime and both x86_64 and arm64 (see `matrix` section)
+# 4. We use `sam package` and `sam publish` to publish the SAR app
+# 5. We remove the previous Canary stack (if present) and deploy a new one to test the SAR App. We retain the Canary in the account for debugging purposes
+# 6. Finally the published SAR app is made public on the PROD environment
+
+# USAGE
+#
+# NOTE: meant to be used with ./.github/workflows/publish_v3_layer.yml
+#
+# sar-beta:
+# needs: build-layer
+# permissions:
+# # lower privilege propagated from parent workflow (release.yml)
+# id-token: write
+# contents: read
+# pull-requests: none
+# pages: none
+# uses: ./.github/workflows/reusable_deploy_v3_sar.yml
+# secrets: inherit
+# with:
+# stage: "BETA"
+# environment: "layer-beta"
+# package-version: ${{ inputs.latest_published_version }}
+# source_code_artifact_name: ${{ inputs.source_code_artifact_name }}
+# source_code_integrity_hash: ${{ inputs.source_code_integrity_hash }}
+
+permissions:
+ id-token: write
+ contents: read
+
+env:
+ NODE_VERSION: 18.20.4
+ AWS_REGION: eu-west-1
+ SAR_NAME: aws-lambda-powertools-python-layer-v3
+ TEST_STACK_NAME: serverlessrepo-v3-powertools-layer-test-stack
+ RELEASE_COMMIT: ${{ github.sha }} # it gets propagated from the caller for security reasons
+
+on:
+ workflow_call:
+ inputs:
+ stage:
+ description: "Deployment stage (BETA, PROD)"
+ required: true
+ type: string
+ package-version:
+ description: "The version of the package to deploy"
+ required: true
+ type: string
+ environment:
+ description: "GitHub Environment to use for encrypted secrets"
+ required: true
+ type: string
+ source_code_artifact_name:
+ description: "Artifact name to restore sealed source code"
+ type: string
+ required: true
+ source_code_integrity_hash:
+ description: "Sealed source code integrity hash"
+ type: string
+ required: true
+
+jobs:
+ deploy-sar-app:
+ runs-on: ubuntu-latest
+ environment: ${{ inputs.environment }}
+ strategy:
+ matrix:
+ architecture: ["x86_64", "arm64"]
+ python-version: ["3.10","3.11","3.12","3.13","3.14"]
+ steps:
+ - name: checkout
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ ref: ${{ env.RELEASE_COMMIT }}
+
+ - name: Restore sealed source code
+ uses: ./.github/actions/seal-restore
+ with:
+ integrity_hash: ${{ inputs.source_code_integrity_hash }}
+ artifact_name: ${{ inputs.source_code_artifact_name }}
+
+
+ - name: Configure AWS credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ aws-region: ${{ env.AWS_REGION }}
+ role-to-assume: ${{ secrets.AWS_LAYERS_ROLE_ARN }}
+ mask-aws-account-id: true
+
+ # NOTE
+ # We connect to Layers account to log our intent to publish a SAR Layer
+ # we then jump to our specific SAR Account with the correctly scoped IAM Role
+ # this allows us to have a single trail when a release occurs for a given layer (beta+prod+SAR beta+SAR prod)
+ - name: AWS credentials SAR role
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ id: aws-credentials-sar-role
+ with:
+ aws-access-key-id: ${{ env.AWS_ACCESS_KEY_ID }}
+ aws-secret-access-key: ${{ env.AWS_SECRET_ACCESS_KEY }}
+ aws-session-token: ${{ env.AWS_SESSION_TOKEN }}
+ role-duration-seconds: 1200
+ aws-region: ${{ env.AWS_REGION }}
+ role-to-assume: ${{ secrets.AWS_SAR_V3_ROLE_ARN }}
+ mask-aws-account-id: true
+ - name: Setup Node.js
+ uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+ with:
+ node-version: ${{ env.NODE_VERSION }}
+ - name: Download artifact
+ uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+ with:
+ name: cdk-layer-artifact-py${{ matrix.python-version }}
+ - name: Unzip artefact
+ run: unzip cdk.py${{ matrix.python-version }}.out.zip
+ - name: normalize Python Version
+ run: |
+ PYTHON_VERSION=$(echo ${{ matrix.python-version }} | tr -d '.')
+ echo "PYTHON_VERSION=${PYTHON_VERSION}" >> "$GITHUB_ENV"
+ - name: Configure SAR name
+ run: |
+ if [[ "${{ inputs.stage }}" == "BETA" ]]; then
+ SAR_NAME="test-${SAR_NAME}"
+ fi
+ ARCH_NAME=$(echo ${{ matrix.architecture }} | tr '_' '-')
+ SAR_NAME="${SAR_NAME}-python${{env.PYTHON_VERSION}}-${ARCH_NAME}"
+ echo SAR_NAME="${SAR_NAME}" >> "$GITHUB_ENV"
+ - name: Prepare SAR App
+ run: |
+ # From the generated LayerStack cdk.out artifact, find the layer asset path for the correct architecture.
+ # We'll use this as the source directory of our SAR. This way we are re-using the same layer asset for our SAR.
+ PYTHON_VERSION=$(echo ${{ matrix.python-version }} | tr -d '.')
+ asset_cdk=$(jq -jc '.Resources[] | select(.Properties.CompatibleArchitectures == ["${{ matrix.architecture }}"]) | .Metadata."aws:asset:path"' "cdk.out/LayerV3Stack-python${PYTHON_VERSION}.template.json")
+
+ echo "Normalizing the asset variable"
+ asset=$(echo $asset_cdk | sed -E 's/^(asset\.[^.]+).*\1/\1/')
+
+ VERSION=$(echo ${{ inputs.package-version }} | sed 's/^v//')
+ echo $asset
+ echo $VERSION
+
+ # fill in the SAR SAM template
+ sed \
+ -e "s|<VERSION>|${VERSION}|g" \
+ -e "s/<SAR_APP_NAME>/${{ env.SAR_NAME }}/g" \
+ -e "s|<LAYER_CONTENT_PATH>|./cdk.out/$asset|g" \
+ -e "s|<PYTHON_RUNTIME>|${{ matrix.python-version }}|g" \
+ -e "s|<ARCHITECTURE>|${{ matrix.architecture }}|g" \
+ layer_v3/sar/template.txt > template.yml
+
+ # SAR needs a README and a LICENSE, so just copy the ones from the repo
+ cp README.md LICENSE "./cdk.out/$asset/"
+ - name: Deploy SAR
+ run: |
+ # Debug purposes
+ cat template.yml
+
+ # Package the SAR to our SAR S3 bucket, and publish it
+ sam package --template-file template.yml --output-template-file packaged.yml --s3-bucket ${{ secrets.AWS_SAR_S3_BUCKET_V3 }}
+ cat packaged.yml
+ sam publish --template packaged.yml --region "$AWS_REGION"
+ - name: Deploy BETA canary
+ if: ${{ inputs.stage == 'BETA' }}
+ run: |
+ ARCH_NAME=$(echo ${{ matrix.architecture }} | tr -d '_')
+ TEST_STACK_NAME="${TEST_STACK_NAME}-python${{env.PYTHON_VERSION}}-${ARCH_NAME}"
+
+ echo "Check if stack does not exist"
+ stack_exists=$(aws cloudformation list-stacks --query "StackSummaries[?(StackName == '$TEST_STACK_NAME' && StackStatus == 'CREATE_COMPLETE')].{StackId:StackId, StackName:StackName, CreationTime:CreationTime, StackStatus:StackStatus}" --output text)
+
+ if [[ -n "$stack_exists" ]] ; then
+ echo "Found test deployment stack, removing..."
+ aws cloudformation delete-stack --stack-name "$TEST_STACK_NAME"
+ aws cloudformation wait stack-delete-complete --stack-name "$TEST_STACK_NAME"
+ fi
+
+ echo "Creating canary stack"
+ echo "Stack name: $TEST_STACK_NAME"
+ aws serverlessrepo create-cloud-formation-change-set \
+ --application-id arn:aws:serverlessrepo:${{ env.AWS_REGION }}:${{ secrets.AWS_SAR_V3_ACCOUNTID }}:applications/${{ env.SAR_NAME }} \
+ --stack-name "${TEST_STACK_NAME/serverlessrepo-/}" \
+ --capabilities CAPABILITY_NAMED_IAM
+
+ CHANGE_SET_ID=$(aws cloudformation list-change-sets --stack-name "$TEST_STACK_NAME" --query 'Summaries[*].ChangeSetId' --output text)
+ aws cloudformation wait change-set-create-complete --change-set-name "$CHANGE_SET_ID"
+ aws cloudformation execute-change-set --change-set-name "$CHANGE_SET_ID"
+ aws cloudformation wait stack-create-complete --stack-name "$TEST_STACK_NAME"
+
+ echo "Waiting until stack deployment completes..."
+
+ echo "Exit with error if stack is not in CREATE_COMPLETE"
+ stack_exists=$(aws cloudformation list-stacks --query "StackSummaries[?(StackName == '$TEST_STACK_NAME' && StackStatus == 'CREATE_COMPLETE')].{StackId:StackId, StackName:StackName, CreationTime:CreationTime, StackStatus:StackStatus}")
+ if [[ -z "$stack_exists" ]] ; then
+ echo "Could find successful deployment, exit error..."
+ exit 1
+ fi
+ echo "Deployment successful"
+ - name: Publish SAR
+ if: ${{ inputs.stage == 'PROD' }}
+ run: |
+ # wait until SAR registers the app, otherwise it fails to make it public
+ sleep 15
+ echo "Make SAR app public"
+ aws serverlessrepo put-application-policy \
+ --application-id arn:aws:serverlessrepo:${{ env.AWS_REGION }}:${{ secrets.AWS_SAR_V3_ACCOUNTID }}:applications/${{ env.SAR_NAME }} \
+ --statements Principals='*',Actions=Deploy
diff --git a/.github/workflows/reusable_export_pr_details.yml b/.github/workflows/reusable_export_pr_details.yml
deleted file mode 100644
index ec168b95f20..00000000000
--- a/.github/workflows/reusable_export_pr_details.yml
+++ /dev/null
@@ -1,89 +0,0 @@
-name: Export previously recorded PR
-
-on:
- workflow_call:
- inputs:
- record_pr_workflow_id:
- description: "Record PR workflow execution ID to download PR details"
- required: true
- type: number
- workflow_origin: # see https://github.com/awslabs/aws-lambda-powertools-python/issues/1349
- description: "Repository full name for runner integrity"
- required: true
- type: string
- secrets:
- token:
- description: "GitHub Actions temporary and scoped token"
- required: true
- # Map the workflow outputs to job outputs
- outputs:
- prNumber:
- description: "PR Number"
- value: ${{ jobs.export_pr_details.outputs.prNumber }}
- prTitle:
- description: "PR Title"
- value: ${{ jobs.export_pr_details.outputs.prTitle }}
- prBody:
- description: "PR Body as string"
- value: ${{ jobs.export_pr_details.outputs.prBody }}
- prAuthor:
- description: "PR author username"
- value: ${{ jobs.export_pr_details.outputs.prAuthor }}
- prAction:
- description: "PR event action"
- value: ${{ jobs.export_pr_details.outputs.prAction }}
- prIsMerged:
- description: "Whether PR is merged"
- value: ${{ jobs.export_pr_details.outputs.prIsMerged }}
-
-jobs:
- export_pr_details:
- # see https://github.com/awslabs/aws-lambda-powertools-python/issues/1349
- if: inputs.workflow_origin == 'awslabs/aws-lambda-powertools-python'
- runs-on: ubuntu-latest
- env:
- FILENAME: pr.txt
- # Map the job outputs to step outputs
- outputs:
- prNumber: ${{ steps.prNumber.outputs.prNumber }}
- prTitle: ${{ steps.prTitle.outputs.prTitle }}
- prBody: ${{ steps.prBody.outputs.prBody }}
- prAuthor: ${{ steps.prAuthor.outputs.prAuthor }}
- prAction: ${{ steps.prAction.outputs.prAction }}
- prIsMerged: ${{ steps.prIsMerged.outputs.prIsMerged }}
- steps:
- - name: Checkout repository # in case caller workflow doesn't checkout thus failing with file not found
- uses: actions/checkout@v3
- - name: "Download previously saved PR"
- uses: actions/github-script@v6
- env:
- WORKFLOW_ID: ${{ inputs.record_pr_workflow_id }}
- # For security, we only download artifacts tied to the successful PR recording workflow
- with:
- github-token: ${{ secrets.token }}
- script: |
- const script = require('.github/scripts/download_pr_artifact.js')
- await script({github, context, core})
- # NodeJS standard library doesn't provide ZIP capabilities; use system `unzip` command instead
- - name: "Unzip PR artifact"
- run: unzip pr.zip
- # NOTE: We need separate steps for each mapped output and respective IDs
- # otherwise the parent caller won't see them regardless on how outputs are set.
- - name: "Export Pull Request Number"
- id: prNumber
- run: echo ::set-output name=prNumber::$(jq -c '.number' ${FILENAME})
- - name: "Export Pull Request Title"
- id: prTitle
- run: echo ::set-output name=prTitle::$(jq -c '.pull_request.title' ${FILENAME})
- - name: "Export Pull Request Body"
- id: prBody
- run: echo ::set-output name=prBody::$(jq -c '.pull_request.body' ${FILENAME})
- - name: "Export Pull Request Author"
- id: prAuthor
- run: echo ::set-output name=prAuthor::$(jq -c '.pull_request.user.login' ${FILENAME})
- - name: "Export Pull Request Action"
- id: prAction
- run: echo ::set-output name=prAction::$(jq -c '.action' ${FILENAME})
- - name: "Export Pull Request Merged status"
- id: prIsMerged
- run: echo ::set-output name=prIsMerged::$(jq -c '.pull_request.merged' ${FILENAME})
diff --git a/.github/workflows/reusable_publish_changelog.yml b/.github/workflows/reusable_publish_changelog.yml
index 30e49b98ae5..adccac305cc 100644
--- a/.github/workflows/reusable_publish_changelog.yml
+++ b/.github/workflows/reusable_publish_changelog.yml
@@ -1,40 +1,41 @@
name: Build and publish latest changelog
+# see ./.github/workflows/build_changelog.yml for docs
+
on:
workflow_call:
-permissions:
- contents: write
-
env:
- BRANCH: develop
+ TEMP_BRANCH_PREFIX: "ci-changelog"
+ PULL_REQUEST_TITLE: "chore(ci): changelog rebuild"
+ FILES_TO_COMMIT: "CHANGELOG.md"
+
+permissions:
+ contents: read
jobs:
publish_changelog:
+ if: github.repository == 'aws-powertools/powertools-lambda-python'
# Force Github action to run only a single job at a time (based on the group name)
# This is to prevent race-condition and inconsistencies with changelog push
concurrency:
group: changelog-build
runs-on: ubuntu-latest
+ permissions:
+ contents: write # create temporary branch with changelog
+ pull-requests: write # create PR
steps:
- name: Checkout repository # reusable workflows start clean, so we need to checkout again
- uses: actions/checkout@v3
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
with:
fetch-depth: 0
- - name: Git client setup and refresh tip
- run: |
- git config user.name "Release bot"
- git config user.email "aws-devax-open-source@amazon.com"
- git config pull.rebase true
- git config remote.origin.url >&- || git remote add origin https://github.com/"${origin}" # Git Detached mode (release notes) doesn't have origin
- git pull origin "${BRANCH}"
- name: "Generate latest changelog"
run: make changelog
- - name: Update Changelog in trunk
- run: |
- HAS_CHANGE=$(git status --porcelain)
- test -z "${HAS_CHANGE}" && echo "Nothing to update" && exit 0
- git add CHANGELOG.md
- git commit -m "update changelog with latest changes"
- git pull origin "${BRANCH}" # prevents concurrent branch update failing push
- git push origin HEAD:refs/heads/"${BRANCH}"
+ - name: Create PR
+ id: create-pr
+ uses: ./.github/actions/create-pr
+ with:
+ files: ${{ env.FILES_TO_COMMIT }}
+ temp_branch_prefix: ${{ env.TEMP_BRANCH_PREFIX }}
+ pull_request_title: ${{ env.PULL_REQUEST_TITLE }}
+ github_token: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.github/workflows/reusable_publish_docs.yml b/.github/workflows/reusable_publish_docs.yml
index a157783abf4..dd054e98639 100644
--- a/.github/workflows/reusable_publish_docs.yml
+++ b/.github/workflows/reusable_publish_docs.yml
@@ -1,14 +1,15 @@
name: Reusable publish documentation
+# see .github/workflows/on_push_docs.yml for docs
+
env:
- BRANCH: develop
- ORIGIN: awslabs/aws-lambda-powertools-python
+ ORIGIN: aws-powertools/powertools-lambda-python
on:
workflow_call:
inputs:
version:
- description: "Version to build and publish docs (v1.28.0, develop)"
+ description: "Version to build and publish docs (1.28.0, develop)"
required: true
type: string
alias:
@@ -20,31 +21,39 @@ on:
required: false
default: false
type: boolean
+ git_ref:
+ description: "Branch or commit ID to checkout from"
+ required: false
+ type: string
+ default: develop
permissions:
- contents: write
- pages: write
+ contents: read
jobs:
publish_docs:
+ if: github.repository == 'aws-powertools/powertools-lambda-python'
# Force Github action to run only a single job at a time (based on the group name)
# This is to prevent "race-condition" in publishing a new version of doc to `gh-pages`
concurrency:
group: on-docs-rebuild
runs-on: ubuntu-latest
+ environment: "Docs"
+ permissions:
+ id-token: write # trade JWT token for AWS credentials in AWS Docs account
steps:
- - uses: actions/checkout@v3
+ - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
with:
fetch-depth: 0
- - name: Install poetry
- run: pipx install poetry
+ ref: ${{ inputs.git_ref }}
- name: Set up Python
- uses: actions/setup-python@v4
+ uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
with:
- python-version: "3.8"
- cache: "poetry"
- - name: Install dependencies
- run: make dev
+ python-version: "3.12"
+ - name: Install doc generation dependencies
+ run: |
+ cat docs/requirements.txt
+ pip install --require-hashes -r docs/requirements.txt
- name: Git client setup
run: |
git config --global user.name Docs deploy
@@ -56,28 +65,59 @@ jobs:
git config pull.rebase true
git config remote.origin.url >&- || git remote add origin https://github.com/"$ORIGIN"
git pull origin "$BRANCH"
- - name: Build docs website and API reference
+ env:
+ BRANCH: ${{ inputs.git_ref }}
+ - name: Configure AWS credentials
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ aws-region: us-east-1
+ role-to-assume: ${{ secrets.AWS_DOCS_ROLE_ARN }}
+ mask-aws-account-id: true
+ - name: Build docs
env:
VERSION: ${{ inputs.version }}
ALIAS: ${{ inputs.alias }}
run: |
- make release-docs VERSION="$VERSION" ALIAS="$ALIAS"
- poetry run mike set-default --push latest
- # Maintenance: Migrate to new gh-pages action
- - name: Release API docs
- uses: peaceiris/actions-gh-pages@068dc23d9710f1ba62e86896f84735d869951305 # v3.8.0
+ rm -rf site
+ mkdocs build
+ - name: Deploy Docs (Version)
env:
VERSION: ${{ inputs.version }}
- with:
- github_token: ${{ secrets.GITHUB_TOKEN }}
- publish_dir: ./api
- keep_files: true
- destination_dir: ${{ env.VERSION }}/api
- - name: Release API docs to latest
- if: ${{ inputs.alias == 'latest' }}
- uses: peaceiris/actions-gh-pages@068dc23d9710f1ba62e86896f84735d869951305 # v3.8.0
- with:
- github_token: ${{ secrets.GITHUB_TOKEN }}
- publish_dir: ./api
- keep_files: true
- destination_dir: latest/api
+ ALIAS: ${{ inputs.alias }}
+ run: |
+ aws s3 sync \
+ site/ \
+ s3://${{ secrets.AWS_DOCS_BUCKET }}/lambda-python/${{ env.VERSION }}/
+ - name: Deploy Docs (Alias)
+ env:
+ VERSION: ${{ inputs.version }}
+ ALIAS: ${{ inputs.alias }}
+ run: |
+ aws s3 sync \
+ site/ \
+ s3://${{ secrets.AWS_DOCS_BUCKET }}/lambda-python/${{ env.ALIAS }}/
+ - name: Deploy Docs (Version JSON)
+ env:
+ VERSION: ${{ inputs.version }}
+ ALIAS: ${{ inputs.alias }}
+ # We originally used "mike" from PyPi to manage versions for us, but since we moved to S3, we can't use it to manage versions any more.
+ # Instead, we're using some shell script that manages the versions.
+ #
+ # Operations:
+ # 1. Download the versions.json file from S3
+ # 2. Find any reference to the alias and delete it from the versions file
+ # 3. This is voodoo (don't use JQ):
+ # - we assign the input as $o and the new version/alias as $n,
+ # - we check if the version number exists in the file already (for republishing docs)
+ # - if it's an alias (stage/latest/*) or old version, we do nothing and output $o (original input)
+ # - if it's a new version number, we add it at position 0 in the array.
+ # 4. Once done, we'll upload it back to S3.
+ run: |
+ aws s3 cp \
+ s3://${{ secrets.AWS_DOCS_BUCKET }}/lambda-python/versions.json \
+ versions_old.json
+ jq 'del(.[].aliases[] | select(. == "${{ env.ALIAS }}"))' < versions_old.json > versions_proc.json
+ jq '. as $o | [{"title": "${{ env.VERSION }}", "version": "${{ env.VERSION }}", "aliases": ["${{ env.ALIAS }}"] }] as $n | $n | if .[0].title | test("[a-z]+") or any($o[].title == $n[0].title;.) then [($o | .[] | select(.title == $n[0].title).aliases += $n[0].aliases | . )] else $n + $o end' < versions_proc.json > versions.json
+ aws s3 cp \
+ versions.json \
+ s3://${{ secrets.AWS_DOCS_BUCKET }}/lambda-python/versions.json
diff --git a/.github/workflows/run-e2e-tests.yml b/.github/workflows/run-e2e-tests.yml
index 86176968839..d05239bf089 100644
--- a/.github/workflows/run-e2e-tests.yml
+++ b/.github/workflows/run-e2e-tests.yml
@@ -1,10 +1,25 @@
name: Run end-to-end tests
+# PROCESS
+#
+# 1. Install all dependencies and spin off containers for all supported Python versions
+# 2. Install pinned CDK version
+# 3. Trade JWT token for AWS credentials to Test account
+# 4. Run E2E in parallel for each feature
+
+# USAGE
+#
+# see MAINTAINERS.md#internals for full details on mechanics.
+#
+# Always triggered on new PR merge.
+
on:
workflow_dispatch:
push:
- branches: [develop, v2]
+ branches:
+ - develop
+ - v3
paths:
- "aws_lambda_powertools/**"
- "tests/e2e/**"
@@ -19,34 +34,48 @@ on:
env:
AWS_DEFAULT_REGION: us-east-1
+concurrency: e2e
+
+permissions:
+ contents: read
+
jobs:
run:
- runs-on: ubuntu-latest
+ runs-on: aws-powertools_ubuntu-latest_8-core
permissions:
id-token: write # needed to request JWT with GitHub's OIDC Token endpoint. docs: https://bit.ly/3MNgQO9
- contents: read
+ contents: read # checkout code
strategy:
+ fail-fast: false # needed so if a version fails, the others will still be able to complete and cleanup
matrix:
- # Maintenance: disabled until we discover concurrency lock issue with multiple versions and tmp
- # version: ["3.7", "3.8", "3.9"]
- version: ["3.7"]
+ version: ["3.10", "3.11", "3.12","3.13","3.14"]
+ if: ${{ github.actor != 'dependabot[bot]' && github.repository == 'aws-powertools/powertools-lambda-python' }}
steps:
- name: "Checkout"
- uses: actions/checkout@v3
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
- name: Install poetry
run: pipx install poetry
- name: "Use Python"
- uses: actions/setup-python@v4
+ uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
with:
python-version: ${{ matrix.version }}
architecture: "x64"
cache: "poetry"
+ - name: Setup Node.js
+ uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+ with:
+ node-version: "20.10.0"
+ - name: Install CDK CLI
+ run: |
+ npm ci
+ npx cdk --version
- name: Install dependencies
- run: make dev
+ run: make dev-quality-code
- name: Configure AWS credentials
- uses: aws-actions/configure-aws-credentials@v1
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
with:
role-to-assume: ${{ secrets.AWS_TEST_ROLE_ARN }}
aws-region: ${{ env.AWS_DEFAULT_REGION }}
+ mask-aws-account-id: true
- name: Test
run: make e2e-test
diff --git a/.github/workflows/secure_workflows.yml b/.github/workflows/secure_workflows.yml
index bbe274806ea..e2f187a40f2 100644
--- a/.github/workflows/secure_workflows.yml
+++ b/.github/workflows/secure_workflows.yml
@@ -1,5 +1,16 @@
name: Lockdown untrusted workflows
+# PROCESS
+#
+# 1. Scans for any external GitHub Action being used without version pinning (@<commit-sha> vs @v3)
+# 2. Scans for insecure practices for inline bash scripts (shellcheck)
+# 3. Fail CI and prevent PRs to be merged if any malpractice is found
+
+# USAGE
+#
+# Always triggered on new PR, PR changes and PR merge.
+
+
on:
push:
paths:
@@ -8,25 +19,21 @@ on:
paths:
- ".github/workflows/**"
+permissions:
+ contents: read
+
jobs:
enforce_pinned_workflows:
name: Harden Security
runs-on: ubuntu-latest
+ permissions:
+ contents: read # checkout code and subsequently GitHub action workflows
steps:
- name: Checkout code
- uses: actions/checkout@v3
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
- name: Ensure 3rd party workflows have SHA pinned
- uses: zgosalvez/github-actions-ensure-sha-pinned-actions@6ca5574367befbc9efdb2fa25978084159c5902d # v1.3.0
+ uses: zgosalvez/github-actions-ensure-sha-pinned-actions@ca46236c6ce584ae24bc6283ba8dcf4b3ec8a066 # v5.0.4
with:
- # Trusted GitHub Actions and/or organizations
allowlist: |
- aws-actions/
- actions/checkout
- actions/github-script
- actions/setup-node
- actions/setup-python
- actions/upload-artifact
- actions/download-artifact
- github/codeql-action/init
- github/codeql-action/analyze
- dependabot/fetch-metadata
+ slsa-framework/slsa-github-generator
+ aws-powertools/actions
diff --git a/.github/workflows/update_ssm.yml b/.github/workflows/update_ssm.yml
new file mode 100644
index 00000000000..f290d9e560b
--- /dev/null
+++ b/.github/workflows/update_ssm.yml
@@ -0,0 +1,131 @@
+name: SSM Parameters
+
+# SSM Parameters update
+#
+# PROCESS
+# Creates parameters in regional AWS accounts for each layer we create, using the inputs to target specific releases
+# * environment: will prefix /beta/ into the parameter
+# * write_latest: will create a latest alias instead of a version number in the parameter
+# * package_version: semantic version number of the released layer (3.x.y)
+# * layer_version: this is sequential layer version from the ARN
+#
+# A successful parameter would look similar to:
+# /aws/service/powertools/python/arm64/python3.14/3.1.0
+# And will have a value of:
+# arn:aws:lambda:eu-west-1:017000801446:layer:AWSLambdaPowertoolsPythonV3-python313-arm64:4
+
+on:
+ workflow_dispatch:
+ inputs:
+ environment:
+ description: Environment to deploy to
+ type: choice
+ options:
+ - Beta
+ - Prod
+ required: true
+
+ write_latest:
+ description: Write to the latest path
+ type: boolean
+ required: false
+
+ package_version:
+ description: Semantic Version of published layer
+ type: string
+ required: true
+
+ layer_version:
+ description: Layer version
+ type: string
+ required: true
+
+ workflow_call:
+ inputs:
+ environment:
+ description: Environment to deploy to, one of `Prod` or `Beta`
+ type: string
+ required: true
+
+ write_latest:
+ description: Write to the latest path
+ type: boolean
+ required: false
+ default: true
+
+ package_version:
+ description: Semantic Version of published layer
+ type: string
+ required: true
+
+ layer_version:
+ description: Layer version
+ type: string
+ required: true
+
+run-name: SSM Parameters - Python - Layer version ${{ inputs.layer_version }} - v${{ inputs.package_version }}
+
+permissions:
+ contents: read
+
+jobs:
+ python:
+ runs-on: ubuntu-latest
+ environment: SSM
+ strategy:
+ matrix:
+ region: ["af-south-1", "ap-east-1", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3",
+ "ap-south-1", "ap-south-2", "ap-southeast-1", "ap-southeast-2", "ap-southeast-3",
+ "ap-southeast-4", "ap-southeast-5", "ap-southeast-7", "ca-central-1", "ca-west-1", "eu-central-1", "eu-central-2",
+ "eu-north-1", "eu-south-1", "eu-south-2", "eu-west-1", "eu-west-2", "eu-west-3",
+ "il-central-1", "mx-central-1", "sa-east-1", "us-east-1",
+ "us-east-2", "us-west-1", "us-west-2"]
+
+ permissions:
+ contents: read
+ id-token: write
+ steps:
+ - id: transform
+ run: |
+ echo 'CONVERTED_REGION=${{ matrix.region }}' | tr 'a-z\-' 'A-Z_' >> "$GITHUB_OUTPUT"
+ - id: creds
+ uses: aws-actions/configure-aws-credentials@d979d5b3a71173a29b74b5b88418bfda9437d885 # v6.1.1
+ with:
+ aws-region: ${{ matrix.region }}
+ role-to-assume: ${{ secrets[format('{0}', steps.transform.outputs.CONVERTED_REGION)] }}
+ mask-aws-account-id: true
+ - id: write-version
+ env:
+ prefix: ${{ inputs.environment == 'beta' && '/aws/service/powertools/beta' || '/aws/service/powertools' }}
+ PACKAGE_VERSION: ${{ inputs.package_version }}
+ LAYER_VERSION: ${{ inputs.layer_version }}
+ run: |
+ aws ssm put-parameter --name ${{ env.prefix }}/python/arm64/python3.10/$PACKAGE_VERSION --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python310-arm64:$LAYER_VERSION" --type String --overwrite
+ aws ssm put-parameter --name ${{ env.prefix }}/python/arm64/python3.11/$PACKAGE_VERSION --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python311-arm64:$LAYER_VERSION" --type String --overwrite
+ aws ssm put-parameter --name ${{ env.prefix }}/python/arm64/python3.12/$PACKAGE_VERSION --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python312-arm64:$LAYER_VERSION" --type String --overwrite
+ aws ssm put-parameter --name ${{ env.prefix }}/python/arm64/python3.13/$PACKAGE_VERSION --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python313-arm64:$LAYER_VERSION" --type String --overwrite
+ aws ssm put-parameter --name ${{ env.prefix }}/python/arm64/python3.14/$PACKAGE_VERSION --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python314-arm64:$LAYER_VERSION" --type String --overwrite
+
+ aws ssm put-parameter --name ${{ env.prefix }}/python/x86_64/python3.10/$PACKAGE_VERSION --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python310-x86_64:$LAYER_VERSION" --type String --overwrite
+ aws ssm put-parameter --name ${{ env.prefix }}/python/x86_64/python3.11/$PACKAGE_VERSION --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python311-x86_64:$LAYER_VERSION" --type String --overwrite
+ aws ssm put-parameter --name ${{ env.prefix }}/python/x86_64/python3.12/$PACKAGE_VERSION --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python312-x86_64:$LAYER_VERSION" --type String --overwrite
+ aws ssm put-parameter --name ${{ env.prefix }}/python/x86_64/python3.13/$PACKAGE_VERSION --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python313-x86_64:$LAYER_VERSION" --type String --overwrite
+ aws ssm put-parameter --name ${{ env.prefix }}/python/x86_64/python3.14/$PACKAGE_VERSION --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python314-x86_64:$LAYER_VERSION" --type String --overwrite
+
+ - id: write-latest
+ if: inputs.write_latest == true
+ env:
+ prefix: ${{ inputs.environment == 'beta' && '/aws/service/powertools/beta' || '/aws/service/powertools' }}
+ LAYER_VERSION: ${{ inputs.layer_version }}
+ run: |
+ aws ssm put-parameter --name ${{ env.prefix }}/python/arm64/python3.10/latest --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python310-arm64:$LAYER_VERSION" --type String --overwrite
+ aws ssm put-parameter --name ${{ env.prefix }}/python/arm64/python3.11/latest --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python311-arm64:$LAYER_VERSION" --type String --overwrite
+ aws ssm put-parameter --name ${{ env.prefix }}/python/arm64/python3.12/latest --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python312-arm64:$LAYER_VERSION" --type String --overwrite
+ aws ssm put-parameter --name ${{ env.prefix }}/python/arm64/python3.13/latest --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python313-arm64:$LAYER_VERSION" --type String --overwrite
+ aws ssm put-parameter --name ${{ env.prefix }}/python/arm64/python3.14/latest --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python314-arm64:$LAYER_VERSION" --type String --overwrite
+
+ aws ssm put-parameter --name ${{ env.prefix }}/python/x86_64/python3.10/latest --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python310-x86_64:$LAYER_VERSION" --type String --overwrite
+ aws ssm put-parameter --name ${{ env.prefix }}/python/x86_64/python3.11/latest --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python311-x86_64:$LAYER_VERSION" --type String --overwrite
+ aws ssm put-parameter --name ${{ env.prefix }}/python/x86_64/python3.12/latest --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python312-x86_64:$LAYER_VERSION" --type String --overwrite
+ aws ssm put-parameter --name ${{ env.prefix }}/python/x86_64/python3.13/latest --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python313-x86_64:$LAYER_VERSION" --type String --overwrite
+ aws ssm put-parameter --name ${{ env.prefix }}/python/x86_64/python3.14/latest --value "arn:aws:lambda:${{ matrix.region }}:017000801446:layer:AWSLambdaPowertoolsPythonV3-python314-x86_64:$LAYER_VERSION" --type String --overwrite
diff --git a/.github/workflows/v2_on_push_docs.yml b/.github/workflows/v2_on_push_docs.yml
deleted file mode 100644
index d70fedbc6c5..00000000000
--- a/.github/workflows/v2_on_push_docs.yml
+++ /dev/null
@@ -1,36 +0,0 @@
-name: Docs v2
-
-on:
- workflow_dispatch:
-# push:
-# branches:
-# - v2
-# paths:
-# - "docs/**"
-# - "mkdocs.yml"
-# - "examples/**"
-
-jobs:
- changelog:
- permissions:
- contents: write
- uses: ./.github/workflows/reusable_publish_changelog.yml
-
- release-docs:
- needs: changelog
- permissions:
- contents: write
- pages: write
- uses: ./.github/workflows/reusable_publish_docs.yml
- with:
- version: v2
- alias: alpha
-# Maintenance: Only necessary in repo migration
-# - name: Create redirect from old docs
-# run: |
-# git checkout gh-pages
-# test -f 404.html && echo "Redirect already set" && exit 0
-# git checkout develop -- 404.html
-# git add 404.html
-# git commit -m "chore: set docs redirect" --no-verify
-# git push origin gh-pages -f
diff --git a/.github/workflows/v2_rebuild_latest_docs.yml b/.github/workflows/v2_rebuild_latest_docs.yml
deleted file mode 100644
index 6d833cc3fef..00000000000
--- a/.github/workflows/v2_rebuild_latest_docs.yml
+++ /dev/null
@@ -1,14 +0,0 @@
-name: V2 Rebuild latest docs
-
-on:
- workflow_dispatch:
-
-jobs:
- release-docs:
- permissions:
- contents: write
- pages: write
- uses: ./.github/workflows/reusable_publish_docs.yml
- with:
- version: v2
- alias: alpha
diff --git a/.gitignore b/.gitignore
index b776e1999c2..2c93b2d1fbe 100644
--- a/.gitignore
+++ b/.gitignore
@@ -252,6 +252,7 @@ dmypy.json
.pyre/
### VisualStudioCode ###
+.vscode
.vscode/*
!.vscode/tasks.json
!.vscode/launch.json
@@ -305,5 +306,21 @@ site/
!404.html
!docs/overrides/*.html
+# CDK
+.cdk
+
!.github/workflows/lib
examples/**/sam/.aws-sam
+
+cdk.out
+# NOTE: different accounts will be used for E2E thus creating unnecessary git clutter
+cdk.context.json
+
+# vim
+*.swp
+
+# LLMs
+.claude
+.amazonq
+.kiro
+.github/instructions
diff --git a/.gitleaks.toml b/.gitleaks.toml
new file mode 100644
index 00000000000..0622b57c118
--- /dev/null
+++ b/.gitleaks.toml
@@ -0,0 +1,15 @@
+# Title for the gitleaks configuration file.
+title = "Gitleaks"
+
+[extend]
+# useDefault will extend the base configuration with the default gitleaks config:
+# https://github.com/zricethezav/gitleaks/blob/master/config/gitleaks.toml
+useDefault = true
+
+[allowlist]
+description = "Allow list false positive"
+
+# Allow list paths to ignore due to false positives.
+paths = [
+ '''tests/unit/parser/test_kinesis_firehose\.py''',
+]
diff --git a/.gitleaksignore b/.gitleaksignore
new file mode 100644
index 00000000000..d501e5cc212
--- /dev/null
+++ b/.gitleaksignore
@@ -0,0 +1,3 @@
+examples/batch_processing/src/context_manager_access_output_pydantic.txt:aws-access-token:10
+examples/batch_processing/src/context_manager_access_output_pydantic.txt:aws-access-token:15
+examples/batch_processing/src/context_manager_access_output.txt:aws-access-token:10
diff --git a/.gitpod.Dockerfile b/.gitpod.Dockerfile
deleted file mode 100644
index 2b055dd9348..00000000000
--- a/.gitpod.Dockerfile
+++ /dev/null
@@ -1,10 +0,0 @@
-# See here all gitpod images available: https://hub.docker.com/r/gitpod/workspace-python-3.9/tags
-# Current python version: 3.9.13
-FROM gitpod/workspace-python-3.9@sha256:de87d4ebffe8daab2e8fef96ec20497ae4f39e8dcb9dec1483d0be61ea78e8cd
-
-WORKDIR /app
-ADD . /app
-
-# Installing pre-commit as system package and not user package. Git needs this to execute pre-commit hooks.
-RUN export PIP_USER=no
-RUN python3 -m pip install pre-commit
diff --git a/.gitpod.yml b/.gitpod.yml
deleted file mode 100644
index d831f067bdd..00000000000
--- a/.gitpod.yml
+++ /dev/null
@@ -1,19 +0,0 @@
-image:
- file: .gitpod.Dockerfile
-tasks:
- - init: make dev-gitpod
-vscode:
- extensions:
- - ms-python.python # IntelliSense (Pylance), Linting, Debugging (multi-threaded, remote), Jupyter Notebooks, code formatting, refactoring, unit tests, and more.
- - littlefoxteam.vscode-python-test-adapter # Run your Python tests in the Sidebar of Visual Studio Code
- - ms-azuretools.vscode-docker # Makes it easy to create, manage, and debug containerized applications.
- - davidanson.vscode-markdownlint # Markdown linting and style checking for Visual Studio Code
- - bungcip.better-toml # Better TOML Language support
- - oderwat.indent-rainbow # Makes indentation easier to read
- - yzhang.markdown-all-in-one # Autoformat, better visualization, snippets, and markdown export to multiple fmts
- - bierner.markdown-mermaid # Previews mermaid diagrams when previewing markdown
- - matangover.mypy # Highlight mypy issues
- - njpwerner.autodocstring # Auto-generate docsstrings in numpy format that we use
- - netcorext.uuid-generator # For those helping create code snippets for docs
- - streetsidesoftware.code-spell-checker # Spell checker that works with camel case too
- - bungcip.better-toml # In case GitPod doesn't have support for TOML pyproject.toml
diff --git a/.markdownlint.yaml b/.markdownlint.yaml
index 4d571206e07..4529480ad19 100644
--- a/.markdownlint.yaml
+++ b/.markdownlint.yaml
@@ -73,8 +73,6 @@ MD013:
tables: false
# Include headings
headings: true
- # Include headings
- headers: true
# Strict length checking
strict: false
# Stern length checking
@@ -107,8 +105,6 @@ MD023: true
# MD024/no-duplicate-heading/no-duplicate-header - Multiple headings with the same content
MD024:
- # Only check sibling headings
- allow_different_nesting: false
# Only check sibling headings
siblings_only: false
diff --git a/.markdownlintignore b/.markdownlintignore
new file mode 100644
index 00000000000..11b6d7ffe29
--- /dev/null
+++ b/.markdownlintignore
@@ -0,0 +1,2 @@
+docs/core/metrics/index.md
+includes/abbreviations.md
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 71b1125cf54..f0ea1cbf495 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -5,42 +5,49 @@
repos:
- repo: https://github.com/pre-commit/pre-commit-hooks
- rev: v2.4.0
+ rev: "f71fa2c1f9cf5cb705f73dffe4b21f7c61470ba9" # v4.4.0
hooks:
- id: check-merge-conflict
- id: trailing-whitespace
- id: check-toml
- repo: local
hooks:
- - id: black
- name: formatting::black
- entry: poetry run black
+ - id: ruff
+ name: formatting::ruff
+ entry: poetry run ruff format
language: system
types: [python]
- - id: isort
- name: formatting::isort
- entry: poetry run isort
- language: system
- types: [python]
- - repo: local
- hooks:
- - id: flake8
- name: linting::flake8
- entry: poetry run flake8
+ - id: ruff
+ name: linting::ruff
+ entry: poetry run ruff check
language: system
types: [python]
- repo: https://github.com/igorshubovych/markdownlint-cli
- rev: "11c08644ce6df850480d98f628596446a526cbc6" # frozen: v0.31.1
+ rev: "ce0d77ac47dc921b62429804fe763d4d35f66a76" # v0.34.0
hooks:
- - id: markdownlint
+ - id: markdownlint-docker
args: ["--fix"]
- - repo: https://github.com/aws-cloudformation/cfn-python-lint
- rev: v0.61.1
+ - repo: local
hooks:
- - id: cfn-python-lint
- files: examples/.*\.(yaml|yml)$
+ - id: cloudformation
+ name: linting::cloudformation
+ entry: poetry run cfn-lint
+ language: system
+ types: [yaml]
+ exclude: examples/build_recipes/*
+ files: examples/.*
- repo: https://github.com/rhysd/actionlint
- rev: v1.6.16
+ rev: "fd7ba3c382e13dcc0248e425b4cbc3f1185fa3ee" # v1.6.24
hooks:
- id: actionlint-docker
args: [-pyflakes=]
+ - repo: https://github.com/antonbabenko/pre-commit-terraform
+ rev: 3420134c37197c21edffc7e6093b14ffae8402f2 # v1.81.0
+ hooks:
+ - id: terraform_fmt
+ args:
+ - --args=-recursive
+ - repo: https://github.com/gitleaks/gitleaks
+ rev: "7804d652c0460f0b61ea9bb2c1f202bfcdbbf144" # v8.16.3
+ hooks:
+ - id: gitleaks
diff --git a/404.html b/404.html
index 2ee34f1988f..f09a446555b 100644
--- a/404.html
+++ b/404.html
@@ -10,7 +10,7 @@
const versionRegex = /(\w.+)\/(latest|([0-9]+)\.([0-9]+)\.([0-9]+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+)?)/;
if (websitePath.search(versionRegex) === -1) {
- let projectName = "aws-lambda-powertools-python"
+ let projectName = "powertools-lambda-python"
// redirect old links to latest version alias
window.location = websitePath.replace(projectName, `${projectName}/latest`)
}
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 70d4becf592..f2dc360bea2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,41 +4,5360 @@
<a name="unreleased"></a>
# Unreleased
+
+<a name="v3.29.0"></a>
+## [v3.29.0] - 2026-05-04
+## Bug Fixes
+
+* **event_handler:** prevent deadlock when async middleware raises before calling next() ([#8196](https://github.com/aws-powertools/powertools-lambda-python/issues/8196))
+
+## Maintenance
+
+* version bump
+
+
+<a name="v3.28.0"></a>
+## [v3.28.0] - 2026-04-14
+## Bug Fixes
+
+* **data_class:** merge querystring parameters in ALB/APIGW classes ([#8154](https://github.com/aws-powertools/powertools-lambda-python/issues/8154))
+* **event_handler:** read swagger files with UTF-8 encoding ([#8131](https://github.com/aws-powertools/powertools-lambda-python/issues/8131))
+
+## Code Refactoring
+
+* **event_handler:** refactoring encoder file ([#8126](https://github.com/aws-powertools/powertools-lambda-python/issues/8126))
+* **event_handler:** refactoring proxy events ([#8125](https://github.com/aws-powertools/powertools-lambda-python/issues/8125))
+* **event_handler:** refactoring params to reduce code ([#8124](https://github.com/aws-powertools/powertools-lambda-python/issues/8124))
+* **event_handler:** extract OpenAPI schema generation from Route class ([#8098](https://github.com/aws-powertools/powertools-lambda-python/issues/8098))
+* **event_handlers:** remove unnecessary init methods ([#8127](https://github.com/aws-powertools/powertools-lambda-python/issues/8127))
+
+## Documentation
+
+* adding new Lambda features ([#7917](https://github.com/aws-powertools/powertools-lambda-python/issues/7917))
+* add openapi docs ([#7939](https://github.com/aws-powertools/powertools-lambda-python/issues/7939))
+
+## Features
+
+* **event_handler:** enrich request object ([#8153](https://github.com/aws-powertools/powertools-lambda-python/issues/8153))
+* **event_handler:** adding status_code OpenAPI field ([#8130](https://github.com/aws-powertools/powertools-lambda-python/issues/8130))
+* **event_handler:** add Dependency injection with Depends() ([#8128](https://github.com/aws-powertools/powertools-lambda-python/issues/8128))
+
+## Maintenance
+
+* version bump
+* bump dependabot dependencies. ([#8152](https://github.com/aws-powertools/powertools-lambda-python/issues/8152))
+* **deps:** bump cryptography from 46.0.6 to 46.0.7 ([#8132](https://github.com/aws-powertools/powertools-lambda-python/issues/8132))
+* **deps-dev:** bump aws-cdk from 2.1117.0 to 2.1118.0 in the aws-cdk group ([#8142](https://github.com/aws-powertools/powertools-lambda-python/issues/8142))
+* **deps-dev:** bump types-python-dateutil from 2.9.0.20260305 to 2.9.0.20260402 ([#8114](https://github.com/aws-powertools/powertools-lambda-python/issues/8114))
+* **deps-dev:** bump aws-cdk from 2.1115.0 to 2.1117.0 in the aws-cdk group ([#8111](https://github.com/aws-powertools/powertools-lambda-python/issues/8111))
+* **deps-dev:** bump boto3-stubs from 1.42.74 to 1.42.84 ([#8115](https://github.com/aws-powertools/powertools-lambda-python/issues/8115))
+* **deps-dev:** bump types-protobuf from 6.32.1.20260221 to 7.34.1.20260403 ([#8117](https://github.com/aws-powertools/powertools-lambda-python/issues/8117))
+* **deps-dev:** bump testcontainers from 4.14.1 to 4.14.2 ([#8116](https://github.com/aws-powertools/powertools-lambda-python/issues/8116))
+* **deps-dev:** bump cfn-lint from 1.46.0 to 1.48.1 ([#8113](https://github.com/aws-powertools/powertools-lambda-python/issues/8113))
+
+
+<a name="v3.27.0"></a>
+## [v3.27.0] - 2026-04-06
+## Bug Fixes
+
+* **data_classes:** support {proxy+} and path parameters in authorizer response ([#8092](https://github.com/aws-powertools/powertools-lambda-python/issues/8092))
+* **event_handler:** sync middleware receives real response in async ASGI context ([#8089](https://github.com/aws-powertools/powertools-lambda-python/issues/8089))
+* **event_handler:** support finding type annotated resolver when merging schemas ([#8074](https://github.com/aws-powertools/powertools-lambda-python/issues/8074))
+* **event_handler:** normalize Union and RootModel sequences in body validation ([#8067](https://github.com/aws-powertools/powertools-lambda-python/issues/8067))
+* **idempotency:** serialize Pydantic models with mode='json' for UUID/date support ([#8075](https://github.com/aws-powertools/powertools-lambda-python/issues/8075))
+
+## Documentation
+
+* adding docs to Request object ([#8105](https://github.com/aws-powertools/powertools-lambda-python/issues/8105))
+* fix ranthebuilder link in Update we_made_this.md ([#8084](https://github.com/aws-powertools/powertools-lambda-python/issues/8084))
+
+## Features
+
+* **event_handler:** add File parameter support for multipart/form-data uploads ([#8093](https://github.com/aws-powertools/powertools-lambda-python/issues/8093))
+* **event_handler:** add Cookie parameter support for OpenAPI utility ([#8095](https://github.com/aws-powertools/powertools-lambda-python/issues/8095))
+* **event_handler:** add Request object for middleware access to resolved route and args ([#8036](https://github.com/aws-powertools/powertools-lambda-python/issues/8036))
+
+## Maintenance
+
+* version bump
+* **deps:** bump valkey-glide from 2.2.7 to 2.3.0 ([#8080](https://github.com/aws-powertools/powertools-lambda-python/issues/8080))
+* **deps:** bump protobuf from 6.33.5 to 7.34.0 ([#8046](https://github.com/aws-powertools/powertools-lambda-python/issues/8046))
+* **deps:** bump mkdocs-material from 9.7.1 to 9.7.5 ([#8045](https://github.com/aws-powertools/powertools-lambda-python/issues/8045))
+* **deps:** bump requests from 2.32.4 to 2.33.0 in /docs ([#8070](https://github.com/aws-powertools/powertools-lambda-python/issues/8070))
+* **deps:** bump cryptography from 46.0.5 to 46.0.6 ([#8072](https://github.com/aws-powertools/powertools-lambda-python/issues/8072))
+* **deps:** bump squidfunk/mkdocs-material from `8f41b60` to `868ad4d` in /docs ([#8083](https://github.com/aws-powertools/powertools-lambda-python/issues/8083))
+* **deps:** bump the github-actions group across 1 directory with 10 updates ([#8081](https://github.com/aws-powertools/powertools-lambda-python/issues/8081))
+* **deps:** bump mkdocs-material from 9.7.5 to 9.7.6 ([#8079](https://github.com/aws-powertools/powertools-lambda-python/issues/8079))
+* **deps-dev:** bump aws-cdk from 2.1111.0 to 2.1113.0 in the aws-cdk group ([#8058](https://github.com/aws-powertools/powertools-lambda-python/issues/8058))
+* **deps-dev:** bump sentry-sdk from 2.54.0 to 2.56.0 ([#8082](https://github.com/aws-powertools/powertools-lambda-python/issues/8082))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.243.0a0 to 2.248.0a0 ([#8103](https://github.com/aws-powertools/powertools-lambda-python/issues/8103))
+* **deps-dev:** bump the dev-dependencies group across 1 directory with 4 updates ([#8086](https://github.com/aws-powertools/powertools-lambda-python/issues/8086))
+* **deps-dev:** bump pygments from 2.19.2 to 2.20.0 ([#8077](https://github.com/aws-powertools/powertools-lambda-python/issues/8077))
+* **deps-dev:** bump requests from 2.32.5 to 2.33.0 ([#8069](https://github.com/aws-powertools/powertools-lambda-python/issues/8069))
+* **deps-dev:** bump ty from 0.0.23 to 0.0.26 ([#8078](https://github.com/aws-powertools/powertools-lambda-python/issues/8078))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.315 to 0.1.316 ([#8061](https://github.com/aws-powertools/powertools-lambda-python/issues/8061))
+* **deps-dev:** bump boto3-stubs from 1.42.73 to 1.42.74 ([#8062](https://github.com/aws-powertools/powertools-lambda-python/issues/8062))
+* **deps-dev:** bump requests from 2.33.0 to 2.33.1 ([#8104](https://github.com/aws-powertools/powertools-lambda-python/issues/8104))
+* **deps-dev:** bump boto3-stubs from 1.42.67 to 1.42.68 ([#8043](https://github.com/aws-powertools/powertools-lambda-python/issues/8043))
+* **deps-dev:** bump nox from 2025.11.12 to 2026.2.9 ([#8044](https://github.com/aws-powertools/powertools-lambda-python/issues/8044))
+* **deps-dev:** bump aws-cdk from 2.1110.0 to 2.1111.0 in the aws-cdk group ([#8039](https://github.com/aws-powertools/powertools-lambda-python/issues/8039))
+* **deps-dev:** bump ruff from 0.15.8 to 0.15.9 in the dev-dependencies group ([#8100](https://github.com/aws-powertools/powertools-lambda-python/issues/8100))
+* **deps-dev:** bump isort from 7.0.0 to 8.0.1 ([#8101](https://github.com/aws-powertools/powertools-lambda-python/issues/8101))
+* **deps-dev:** bump types-requests from 2.32.4.20260107 to 2.33.0.20260402 ([#8102](https://github.com/aws-powertools/powertools-lambda-python/issues/8102))
+
+
+<a name="v3.26.0"></a>
+## [v3.26.0] - 2026-03-20
+## Bug Fixes
+
+* **ci:** add ty check to dataclasses utility ([#8038](https://github.com/aws-powertools/powertools-lambda-python/issues/8038))
+* **ci:** add ty check to parser folder ([#8037](https://github.com/aws-powertools/powertools-lambda-python/issues/8037))
+* **ci:** add ty check to parameters folder ([#8035](https://github.com/aws-powertools/powertools-lambda-python/issues/8035))
+* **openapi:** correct response validation for falsy objects ([#7990](https://github.com/aws-powertools/powertools-lambda-python/issues/7990))
+
+## Features
+
+* add ldms feature ([#8051](https://github.com/aws-powertools/powertools-lambda-python/issues/8051))
+* **batch:** add Kafka/MSK batch processing support ([#7941](https://github.com/aws-powertools/powertools-lambda-python/issues/7941))
+* **buffer-handler:** add buffering support for external loggers ([#7994](https://github.com/aws-powertools/powertools-lambda-python/issues/7994))
+
+## Maintenance
+
+* version bump
+* **deps:** bump aws-encryption-sdk from 4.0.3 to 4.0.4 ([#8027](https://github.com/aws-powertools/powertools-lambda-python/issues/8027))
+* **deps:** bump valkey-glide from 2.2.5 to 2.2.7 ([#8030](https://github.com/aws-powertools/powertools-lambda-python/issues/8030))
+* **deps-dev:** bump types-python-dateutil from 2.9.0.20260124 to 2.9.0.20260305 ([#8029](https://github.com/aws-powertools/powertools-lambda-python/issues/8029))
+* **deps-dev:** bump ijson from 3.4.0.post0 to 3.5.0 ([#8028](https://github.com/aws-powertools/powertools-lambda-python/issues/8028))
+* **deps-dev:** bump aws-cdk from 2.1108.0 to 2.1110.0 in the aws-cdk group ([#8023](https://github.com/aws-powertools/powertools-lambda-python/issues/8023))
+
+
+<a name="v3.25.0"></a>
+## [v3.25.0] - 2026-03-12
+## Bug Fixes
+
+* **ci:** remove DUB region ([#8031](https://github.com/aws-powertools/powertools-lambda-python/issues/8031))
+* **event-handler:** prevent OpenAPI schema bleed when reusing response dictionaries ([#7952](https://github.com/aws-powertools/powertools-lambda-python/issues/7952))
+* **event_handler:** add middleware validation per route ([#8020](https://github.com/aws-powertools/powertools-lambda-python/issues/8020))
+* **event_handler:** fix bug regression in Annotated field ([#7904](https://github.com/aws-powertools/powertools-lambda-python/issues/7904))
+* **event_handler:** return 415 status_code for unsupported content-type headers ([#7980](https://github.com/aws-powertools/powertools-lambda-python/issues/7980))
+* **event_handler:** sync alias and validation_alias for Pydantic 2.12+ compatibility ([#7901](https://github.com/aws-powertools/powertools-lambda-python/issues/7901))
+* **event_handler:** preserve openapi_examples on Body ([#7862](https://github.com/aws-powertools/powertools-lambda-python/issues/7862))
+* **logger:** preserve percent-style formatting args in flush_buffer ([#8009](https://github.com/aws-powertools/powertools-lambda-python/issues/8009))
+* **parameters:** fix variable shadowing in SSM parameter chunking ([#8006](https://github.com/aws-powertools/powertools-lambda-python/issues/8006))
+* **typing:** resolve ty diagnostics in logging and metrics modules ([#7953](https://github.com/aws-powertools/powertools-lambda-python/issues/7953))
+* **typing:** accept Mapping type in resolve() for event parameter ([#7909](https://github.com/aws-powertools/powertools-lambda-python/issues/7909))
+
+## Code Refactoring
+
+* **batch:** improve type annotation for event parameter ([#7924](https://github.com/aws-powertools/powertools-lambda-python/issues/7924))
+
+## Documentation
+
+* clarify append_context_keys behavior with overlapping keys ([#7846](https://github.com/aws-powertools/powertools-lambda-python/issues/7846))
+
+## Features
+
+* Add a flag to ALBResolver to URL-decode query parameters ([#7940](https://github.com/aws-powertools/powertools-lambda-python/issues/7940))
+* add HttpResolverAlpha resolver ([#7913](https://github.com/aws-powertools/powertools-lambda-python/issues/7913))
+* **decorators:** Support Durable Context in logger and metric decorators ([#7765](https://github.com/aws-powertools/powertools-lambda-python/issues/7765))
+* **event-handler:** add per-route validation support ([#7965](https://github.com/aws-powertools/powertools-lambda-python/issues/7965))
+* **event_source:** add support for S3 IntelligentTiering events ([#7954](https://github.com/aws-powertools/powertools-lambda-python/issues/7954))
+* **metrics:** add support for multiple dimension sets ([#7848](https://github.com/aws-powertools/powertools-lambda-python/issues/7848))
+* **openapi:** add support for micro Lambda pattern ([#7920](https://github.com/aws-powertools/powertools-lambda-python/issues/7920))
+
+## Maintenance
+
+* remove unused PR automation workflows ([#8008](https://github.com/aws-powertools/powertools-lambda-python/issues/8008))
+* adding fuzzing tests ([#7903](https://github.com/aws-powertools/powertools-lambda-python/issues/7903))
+* update swagger ui files ([#7914](https://github.com/aws-powertools/powertools-lambda-python/issues/7914))
+* version bump
+* **ci:** new pre-release 3.24.1a1 ([#7926](https://github.com/aws-powertools/powertools-lambda-python/issues/7926))
+* **deps:** bump jmespath from 1.0.1 to 1.1.0 ([#7970](https://github.com/aws-powertools/powertools-lambda-python/issues/7970))
+* **deps:** bump urllib3 from 2.6.0 to 2.6.3 in /docs ([#7921](https://github.com/aws-powertools/powertools-lambda-python/issues/7921))
+* **deps:** bump squidfunk/mkdocs-material from `3bba0a9` to `8f41b60` in /docs ([#8010](https://github.com/aws-powertools/powertools-lambda-python/issues/8010))
+* **deps:** bump the github-actions group with 4 updates ([#8013](https://github.com/aws-powertools/powertools-lambda-python/issues/8013))
+* **deps:** bump protobuf from 6.33.2 to 6.33.4 ([#7948](https://github.com/aws-powertools/powertools-lambda-python/issues/7948))
+* **deps:** bump valkey-glide from 2.2.3 to 2.2.5 ([#7947](https://github.com/aws-powertools/powertools-lambda-python/issues/7947))
+* **deps:** bump actions/dependency-review-action from 4.8.2 to 4.8.3 in the github-actions group ([#8004](https://github.com/aws-powertools/powertools-lambda-python/issues/8004))
+* **deps:** bump cryptography from 46.0.3 to 46.0.5 ([#7991](https://github.com/aws-powertools/powertools-lambda-python/issues/7991))
+* **deps:** bump the github-actions group with 3 updates ([#7960](https://github.com/aws-powertools/powertools-lambda-python/issues/7960))
+* **deps:** bump protobuf from 6.33.4 to 6.33.5 ([#7977](https://github.com/aws-powertools/powertools-lambda-python/issues/7977))
+* **deps:** bump datadog-lambda from 8.120.0 to 8.121.0 ([#8015](https://github.com/aws-powertools/powertools-lambda-python/issues/8015))
+* **deps:** bump the github-actions group with 3 updates ([#7971](https://github.com/aws-powertools/powertools-lambda-python/issues/7971))
+* **deps:** bump the github-actions group with 2 updates ([#7985](https://github.com/aws-powertools/powertools-lambda-python/issues/7985))
+* **deps-dev:** bump the dev-dependencies group with 2 updates ([#7969](https://github.com/aws-powertools/powertools-lambda-python/issues/7969))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.312 to 0.1.314 ([#7973](https://github.com/aws-powertools/powertools-lambda-python/issues/7973))
+* **deps-dev:** bump cfn-lint from 1.43.3 to 1.43.4 ([#7972](https://github.com/aws-powertools/powertools-lambda-python/issues/7972))
+* **deps-dev:** bump aws-cdk-lib from 2.233.0 to 2.236.0 ([#7974](https://github.com/aws-powertools/powertools-lambda-python/issues/7974))
+* **deps-dev:** bump aws-cdk from 2.1103.0 to 2.1105.0 in the aws-cdk group ([#7982](https://github.com/aws-powertools/powertools-lambda-python/issues/7982))
+* **deps-dev:** bump aws-cdk from 2.1101.0 to 2.1103.0 in the aws-cdk group ([#7967](https://github.com/aws-powertools/powertools-lambda-python/issues/7967))
+* **deps-dev:** bump sentry-sdk from 2.48.0 to 2.52.0 ([#7987](https://github.com/aws-powertools/powertools-lambda-python/issues/7987))
+* **deps-dev:** bump testcontainers from 4.14.0 to 4.14.1 ([#7988](https://github.com/aws-powertools/powertools-lambda-python/issues/7988))
+* **deps-dev:** bump cfn-lint from 1.43.2 to 1.43.3 ([#7958](https://github.com/aws-powertools/powertools-lambda-python/issues/7958))
+* **deps-dev:** bump testcontainers from 4.13.3 to 4.14.0 ([#7959](https://github.com/aws-powertools/powertools-lambda-python/issues/7959))
+* **deps-dev:** bump multiprocess from 0.70.18 to 0.70.19 ([#7961](https://github.com/aws-powertools/powertools-lambda-python/issues/7961))
+* **deps-dev:** bump aws-cdk from 2.1100.3 to 2.1101.0 in the aws-cdk group ([#7955](https://github.com/aws-powertools/powertools-lambda-python/issues/7955))
+* **deps-dev:** bump ruff from 0.14.11 to 0.14.13 in the dev-dependencies group ([#7957](https://github.com/aws-powertools/powertools-lambda-python/issues/7957))
+* **deps-dev:** bump bandit from 1.9.2 to 1.9.3 ([#7962](https://github.com/aws-powertools/powertools-lambda-python/issues/7962))
+* **deps-dev:** bump aws-cdk-lib from 2.237.1 to 2.238.0 ([#7986](https://github.com/aws-powertools/powertools-lambda-python/issues/7986))
+* **deps-dev:** bump virtualenv from 20.35.4 to 20.36.1 ([#7950](https://github.com/aws-powertools/powertools-lambda-python/issues/7950))
+* **deps-dev:** bump aws-cdk from 2.1100.2 to 2.1100.3 in the aws-cdk group ([#7942](https://github.com/aws-powertools/powertools-lambda-python/issues/7942))
+* **deps-dev:** bump boto3-stubs from 1.42.21 to 1.42.26 ([#7945](https://github.com/aws-powertools/powertools-lambda-python/issues/7945))
+* **deps-dev:** bump aws-cdk from 2.1105.0 to 2.1106.0 in the aws-cdk group ([#7995](https://github.com/aws-powertools/powertools-lambda-python/issues/7995))
+* **deps-dev:** bump ruff from 0.14.10 to 0.14.11 in the dev-dependencies group ([#7944](https://github.com/aws-powertools/powertools-lambda-python/issues/7944))
+* **deps-dev:** bump filelock from 3.20.2 to 3.20.3 ([#7946](https://github.com/aws-powertools/powertools-lambda-python/issues/7946))
+* **deps-dev:** bump filelock from 3.20.3 to 3.24.2 ([#7999](https://github.com/aws-powertools/powertools-lambda-python/issues/7999))
+* **deps-dev:** bump sentry-sdk from 2.52.0 to 2.53.0 ([#7998](https://github.com/aws-powertools/powertools-lambda-python/issues/7998))
+* **deps-dev:** bump urllib3 from 2.6.2 to 2.6.3 in /layer_v3 ([#7928](https://github.com/aws-powertools/powertools-lambda-python/issues/7928))
+* **deps-dev:** bump types-python-dateutil from 2.9.0.20251115 to 2.9.0.20260124 ([#7989](https://github.com/aws-powertools/powertools-lambda-python/issues/7989))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.233.0a0 to 2.238.0a0 ([#7997](https://github.com/aws-powertools/powertools-lambda-python/issues/7997))
+* **deps-dev:** bump cfn-lint from 1.44.0 to 1.46.0 ([#8018](https://github.com/aws-powertools/powertools-lambda-python/issues/8018))
+* **deps-dev:** bump aws-cdk from 2.1106.0 to 2.1108.0 in the aws-cdk group ([#8011](https://github.com/aws-powertools/powertools-lambda-python/issues/8011))
+* **deps-dev:** bump cfn-lint from 1.43.1 to 1.43.2 ([#7907](https://github.com/aws-powertools/powertools-lambda-python/issues/7907))
+* **deps-dev:** bump aws-cdk from 2.1100.1 to 2.1100.2 in the aws-cdk group ([#7905](https://github.com/aws-powertools/powertools-lambda-python/issues/7905))
+* **deps-dev:** bump filelock from 3.24.2 to 3.25.0 ([#8016](https://github.com/aws-powertools/powertools-lambda-python/issues/8016))
+* **deps-dev:** bump urllib3 from 2.6.2 to 2.6.3 ([#7922](https://github.com/aws-powertools/powertools-lambda-python/issues/7922))
+* **typing:** add ty type checker to CI with baseline exclusions ([#7938](https://github.com/aws-powertools/powertools-lambda-python/issues/7938))
+
+
+<a name="v3.24.0"></a>
+## [v3.24.0] - 2026-01-05
+## Bug Fixes
+
+* **batch_processor:** fix batch processor ([#7798](https://github.com/aws-powertools/powertools-lambda-python/issues/7798))
+* **ci:** add missing dollar signs in SSM parameter path variables ([#7695](https://github.com/aws-powertools/powertools-lambda-python/issues/7695))
+* **data-classes:** ensure lazy initialization for Cognito token generation response properties ([#7653](https://github.com/aws-powertools/powertools-lambda-python/issues/7653))
+
+## Code Refactoring
+
+* **event-handler:** remove kwargs from AppSync exception constructor ([#7699](https://github.com/aws-powertools/powertools-lambda-python/issues/7699))
+
+## Documentation
+
+* add EF Education First as customer reference ([#7809](https://github.com/aws-powertools/powertools-lambda-python/issues/7809))
+* clarify BedrockResponse.is_json() always returns True ([#7748](https://github.com/aws-powertools/powertools-lambda-python/issues/7748))
+* **event-handler:** add docstring for serializer in `BedrockAgentFunctionResolver` ([#7808](https://github.com/aws-powertools/powertools-lambda-python/issues/7808))
+* **homepage:** reorganize homepage and create dedicated installation page ([#7896](https://github.com/aws-powertools/powertools-lambda-python/issues/7896))
+* **readme:** update features list and improve readability ([#7889](https://github.com/aws-powertools/powertools-lambda-python/issues/7889))
+
+## Features
+
+* **idempotency:** Allow durable functions to replay ([#7764](https://github.com/aws-powertools/powertools-lambda-python/issues/7764))
+* **parser:** add model for the DynamoDB Stream Lambda invocation record ([#7818](https://github.com/aws-powertools/powertools-lambda-python/issues/7818))
+
+## Maintenance
+
+* version bump
+* drop Python3.9 support - WIP ([#7807](https://github.com/aws-powertools/powertools-lambda-python/issues/7807))
+* **ci:** new pre-release 3.23.1a5 ([#7725](https://github.com/aws-powertools/powertools-lambda-python/issues/7725))
+* **ci:** improve dependabot workflow to reduce noise ([#7890](https://github.com/aws-powertools/powertools-lambda-python/issues/7890))
+* **ci:** remove automated pre-release schedule ([#7894](https://github.com/aws-powertools/powertools-lambda-python/issues/7894))
+* **ci:** new pre-release 3.23.1a0 ([#7685](https://github.com/aws-powertools/powertools-lambda-python/issues/7685))
+* **ci:** new pre-release 3.23.1a1 ([#7697](https://github.com/aws-powertools/powertools-lambda-python/issues/7697))
+* **ci:** new pre-release 3.23.1a2 ([#7706](https://github.com/aws-powertools/powertools-lambda-python/issues/7706))
+* **ci:** new pre-release 3.23.1a8 ([#7753](https://github.com/aws-powertools/powertools-lambda-python/issues/7753))
+* **ci:** new pre-release 3.23.1a7 ([#7740](https://github.com/aws-powertools/powertools-lambda-python/issues/7740))
+* **ci:** new pre-release 3.23.1a3 ([#7710](https://github.com/aws-powertools/powertools-lambda-python/issues/7710))
+* **ci:** new pre-release 3.23.1a6 ([#7733](https://github.com/aws-powertools/powertools-lambda-python/issues/7733))
+* **ci:** remove daily changelog rebuild schedule ([#7897](https://github.com/aws-powertools/powertools-lambda-python/issues/7897))
+* **ci:** new pre-release 3.23.1a10 ([#7833](https://github.com/aws-powertools/powertools-lambda-python/issues/7833))
+* **ci:** new pre-release 3.23.1a4 ([#7715](https://github.com/aws-powertools/powertools-lambda-python/issues/7715))
+* **ci:** update layer version for all AWS partitions in docs ([#7757](https://github.com/aws-powertools/powertools-lambda-python/issues/7757))
+* **ci:** new pre-release 3.23.1a9 ([#7828](https://github.com/aws-powertools/powertools-lambda-python/issues/7828))
+* **deps:** bump protobuf from 6.33.0 to 6.33.1 ([#7681](https://github.com/aws-powertools/powertools-lambda-python/issues/7681))
+* **deps:** bump actions/setup-go from 6.0.0 to 6.1.0 ([#7718](https://github.com/aws-powertools/powertools-lambda-python/issues/7718))
+* **deps:** bump mkdocs-llmstxt from 0.4.0 to 0.5.0 in /docs ([#7720](https://github.com/aws-powertools/powertools-lambda-python/issues/7720))
+* **deps:** bump pymdown-extensions from 10.16 to 10.16.1 in /docs ([#7827](https://github.com/aws-powertools/powertools-lambda-python/issues/7827))
+* **deps:** bump squidfunk/mkdocs-material from `980e11f` to `3bba0a9` in /docs ([#7835](https://github.com/aws-powertools/powertools-lambda-python/issues/7835))
+* **deps:** bump mkdocs-material from 9.7.0 to 9.7.1 in /docs ([#7836](https://github.com/aws-powertools/powertools-lambda-python/issues/7836))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 4.0.0 to 4.0.1 ([#7810](https://github.com/aws-powertools/powertools-lambda-python/issues/7810))
+* **deps:** bump actions/checkout from 5.0.1 to 6.0.0 ([#7719](https://github.com/aws-powertools/powertools-lambda-python/issues/7719))
+* **deps:** bump valkey-glide from 2.2.2 to 2.2.3 ([#7837](https://github.com/aws-powertools/powertools-lambda-python/issues/7837))
+* **deps:** bump datadog-lambda from 8.118.0 to 8.120.0 ([#7815](https://github.com/aws-powertools/powertools-lambda-python/issues/7815))
+* **deps:** bump mkdocs-material from 9.7.0 to 9.7.1 ([#7838](https://github.com/aws-powertools/powertools-lambda-python/issues/7838))
+* **deps:** bump datadog-lambda from 8.116.0 to 8.118.0 ([#7785](https://github.com/aws-powertools/powertools-lambda-python/issues/7785))
+* **deps:** bump actions/checkout from 5.0.0 to 5.0.1 ([#7701](https://github.com/aws-powertools/powertools-lambda-python/issues/7701))
+* **deps:** bump docker/setup-buildx-action from 3.11.1 to 3.12.0 ([#7843](https://github.com/aws-powertools/powertools-lambda-python/issues/7843))
+* **deps:** bump actions/download-artifact from 6.0.0 to 7.0.0 ([#7801](https://github.com/aws-powertools/powertools-lambda-python/issues/7801))
+* **deps:** bump actions/checkout from 6.0.0 to 6.0.1 ([#7766](https://github.com/aws-powertools/powertools-lambda-python/issues/7766))
+* **deps:** bump actions/upload-artifact from 5.0.0 to 6.0.0 ([#7800](https://github.com/aws-powertools/powertools-lambda-python/issues/7800))
+* **deps:** bump valkey-glide from 2.1.1 to 2.2.1 ([#7783](https://github.com/aws-powertools/powertools-lambda-python/issues/7783))
+* **deps:** bump redis from 6.4.0 to 7.0.1 ([#7687](https://github.com/aws-powertools/powertools-lambda-python/issues/7687))
+* **deps:** bump valkey-glide from 2.2.1 to 2.2.2 ([#7802](https://github.com/aws-powertools/powertools-lambda-python/issues/7802))
+* **deps:** bump the github-actions group with 2 updates ([#7893](https://github.com/aws-powertools/powertools-lambda-python/issues/7893))
+* **deps:** bump actions/setup-node from 6.0.0 to 6.1.0 ([#7773](https://github.com/aws-powertools/powertools-lambda-python/issues/7773))
+* **deps:** bump protobuf from 6.33.1 to 6.33.2 ([#7786](https://github.com/aws-powertools/powertools-lambda-python/issues/7786))
+* **deps:** bump codecov/codecov-action from 5.5.1 to 5.5.2 ([#7788](https://github.com/aws-powertools/powertools-lambda-python/issues/7788))
+* **deps:** bump urllib3 from 2.5.0 to 2.6.0 in /docs ([#7778](https://github.com/aws-powertools/powertools-lambda-python/issues/7778))
+* **deps-dev:** bump boto3-stubs from 1.41.2 to 1.41.5 ([#7768](https://github.com/aws-powertools/powertools-lambda-python/issues/7768))
+* **deps-dev:** bump ruff from 0.14.6 to 0.14.7 ([#7770](https://github.com/aws-powertools/powertools-lambda-python/issues/7770))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.227.0a0 to 2.231.0a0 ([#7767](https://github.com/aws-powertools/powertools-lambda-python/issues/7767))
+* **deps-dev:** bump aws-cdk-lib from 2.227.0 to 2.231.0 ([#7771](https://github.com/aws-powertools/powertools-lambda-python/issues/7771))
+* **deps-dev:** bump boto3-stubs from 1.42.4 to 1.42.6 ([#7791](https://github.com/aws-powertools/powertools-lambda-python/issues/7791))
+* **deps-dev:** bump types-protobuf from 6.32.1.20251105 to 6.32.1.20251210 ([#7793](https://github.com/aws-powertools/powertools-lambda-python/issues/7793))
+* **deps-dev:** bump aws-cdk from 2.1033.0 to 2.1034.0 ([#7795](https://github.com/aws-powertools/powertools-lambda-python/issues/7795))
+* **deps-dev:** bump boto3-stubs from 1.42.6 to 1.42.7 ([#7796](https://github.com/aws-powertools/powertools-lambda-python/issues/7796))
+* **deps-dev:** bump sentry-sdk from 2.45.0 to 2.47.0 ([#7790](https://github.com/aws-powertools/powertools-lambda-python/issues/7790))
+* **deps-dev:** bump cfn-lint from 1.41.0 to 1.42.0 ([#7784](https://github.com/aws-powertools/powertools-lambda-python/issues/7784))
+* **deps-dev:** bump aws-cdk-lib from 2.232.1 to 2.232.2 ([#7816](https://github.com/aws-powertools/powertools-lambda-python/issues/7816))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.225.0a0 to 2.227.0a0 ([#7730](https://github.com/aws-powertools/powertools-lambda-python/issues/7730))
+* **deps-dev:** bump boto3-stubs from 1.40.76 to 1.41.1 ([#7727](https://github.com/aws-powertools/powertools-lambda-python/issues/7727))
+* **deps-dev:** bump ruff from 0.14.5 to 0.14.6 ([#7728](https://github.com/aws-powertools/powertools-lambda-python/issues/7728))
+* **deps-dev:** bump mypy-boto3-appconfigdata from 1.40.55 to 1.41.0 in the boto-typing group ([#7721](https://github.com/aws-powertools/powertools-lambda-python/issues/7721))
+* **deps-dev:** bump boto3-stubs from 1.42.7 to 1.42.9 ([#7814](https://github.com/aws-powertools/powertools-lambda-python/issues/7814))
+* **deps-dev:** bump aws-cdk from 2.1034.0 to 2.1100.0 ([#7811](https://github.com/aws-powertools/powertools-lambda-python/issues/7811))
+* **deps-dev:** bump cfn-lint from 1.42.0 to 1.43.0 ([#7812](https://github.com/aws-powertools/powertools-lambda-python/issues/7812))
+* **deps-dev:** bump urllib3 from 2.5.0 to 2.6.0 in /layer_v3 ([#7820](https://github.com/aws-powertools/powertools-lambda-python/issues/7820))
+* **deps-dev:** bump pytest-asyncio from 1.2.0 to 1.3.0 ([#7825](https://github.com/aws-powertools/powertools-lambda-python/issues/7825))
+* **deps-dev:** bump ruff from 0.14.8 to 0.14.9 ([#7823](https://github.com/aws-powertools/powertools-lambda-python/issues/7823))
+* **deps-dev:** bump aws-cdk from 2.1032.0 to 2.1033.0 ([#7713](https://github.com/aws-powertools/powertools-lambda-python/issues/7713))
+* **deps-dev:** bump boto3-stubs from 1.40.75 to 1.40.76 ([#7714](https://github.com/aws-powertools/powertools-lambda-python/issues/7714))
+* **deps-dev:** bump pytest from 8.4.2 to 9.0.2 ([#7826](https://github.com/aws-powertools/powertools-lambda-python/issues/7826))
+* **deps-dev:** bump isort from 6.1.0 to 7.0.0 ([#7824](https://github.com/aws-powertools/powertools-lambda-python/issues/7824))
+* **deps-dev:** bump boto3-stubs from 1.42.10 to 1.42.11 ([#7831](https://github.com/aws-powertools/powertools-lambda-python/issues/7831))
+* **deps-dev:** bump cfn-lint from 1.40.4 to 1.41.0 ([#7709](https://github.com/aws-powertools/powertools-lambda-python/issues/7709))
+* **deps-dev:** bump sentry-sdk from 2.44.0 to 2.45.0 ([#7708](https://github.com/aws-powertools/powertools-lambda-python/issues/7708))
+* **deps-dev:** bump aws-cdk from 2.1100.0 to 2.1100.1 ([#7830](https://github.com/aws-powertools/powertools-lambda-python/issues/7830))
+* **deps-dev:** bump ruff from 0.14.9 to 0.14.10 ([#7839](https://github.com/aws-powertools/powertools-lambda-python/issues/7839))
+* **deps-dev:** bump boto3-stubs from 1.40.73 to 1.40.74 ([#7703](https://github.com/aws-powertools/powertools-lambda-python/issues/7703))
+* **deps-dev:** bump types-python-dateutil from 2.9.0.20251108 to 2.9.0.20251115 ([#7702](https://github.com/aws-powertools/powertools-lambda-python/issues/7702))
+* **deps-dev:** bump boto3-stubs from 1.42.11 to 1.42.13 ([#7844](https://github.com/aws-powertools/powertools-lambda-python/issues/7844))
+* **deps-dev:** bump aws-cdk-lib from 2.232.2 to 2.233.0 ([#7845](https://github.com/aws-powertools/powertools-lambda-python/issues/7845))
+* **deps-dev:** bump filelock from 3.20.1 to 3.20.2 ([#7876](https://github.com/aws-powertools/powertools-lambda-python/issues/7876))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.224.0a0 to 2.225.0a0 ([#7704](https://github.com/aws-powertools/powertools-lambda-python/issues/7704))
+* **deps-dev:** bump boto3-stubs from 1.40.72 to 1.40.73 ([#7688](https://github.com/aws-powertools/powertools-lambda-python/issues/7688))
+* **deps-dev:** bump boto3-stubs from 1.42.19 to 1.42.21 ([#7892](https://github.com/aws-powertools/powertools-lambda-python/issues/7892))
+* **deps-dev:** bump coverage from 7.13.0 to 7.13.1 ([#7867](https://github.com/aws-powertools/powertools-lambda-python/issues/7867))
+* **deps-dev:** bump cfn-lint from 1.43.0 to 1.43.1 ([#7869](https://github.com/aws-powertools/powertools-lambda-python/issues/7869))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.232.2a0 to 2.233.0a0 ([#7868](https://github.com/aws-powertools/powertools-lambda-python/issues/7868))
+* **deps-dev:** bump ruff from 0.14.4 to 0.14.5 ([#7682](https://github.com/aws-powertools/powertools-lambda-python/issues/7682))
+* **deps-dev:** bump boto3-stubs from 1.42.17 to 1.42.19 ([#7873](https://github.com/aws-powertools/powertools-lambda-python/issues/7873))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.223.0a0 to 2.224.0a0 ([#7680](https://github.com/aws-powertools/powertools-lambda-python/issues/7680))
+* **deps-dev:** bump aws-cdk from 2.1031.2 to 2.1032.0 ([#7700](https://github.com/aws-powertools/powertools-lambda-python/issues/7700))
+* **maintenance:** remove cloud development environment configurations ([#7887](https://github.com/aws-powertools/powertools-lambda-python/issues/7887))
+
+
+<a name="v3.23.0"></a>
+## [v3.23.0] - 2025-11-13
+## Bug Fixes
+
+* **layer:** bump cdk version ([#7677](https://github.com/aws-powertools/powertools-lambda-python/issues/7677))
+
+## Documentation
+
+* **batch:** fix error handling code highlight line number ([#7638](https://github.com/aws-powertools/powertools-lambda-python/issues/7638))
+* **openapi:** Update docstring's openapi default version to match current default version ([#7669](https://github.com/aws-powertools/powertools-lambda-python/issues/7669))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.22.2a0 ([#7642](https://github.com/aws-powertools/powertools-lambda-python/issues/7642))
+* **ci:** new pre-release 3.22.2a1 ([#7646](https://github.com/aws-powertools/powertools-lambda-python/issues/7646))
+* **ci:** adding support for Python 3.14 - WIP ([#7431](https://github.com/aws-powertools/powertools-lambda-python/issues/7431))
+* **ci:** new pre-release 3.22.2a2 ([#7652](https://github.com/aws-powertools/powertools-lambda-python/issues/7652))
+* **ci:** new pre-release 3.22.2a3 ([#7659](https://github.com/aws-powertools/powertools-lambda-python/issues/7659))
+* **ci:** new pre-release 3.22.2a4 ([#7674](https://github.com/aws-powertools/powertools-lambda-python/issues/7674))
+* **deps:** bump actions/dependency-review-action from 4.8.1 to 4.8.2 ([#7662](https://github.com/aws-powertools/powertools-lambda-python/issues/7662))
+* **deps:** bump pydantic from 2.12.3 to 2.12.4 ([#7641](https://github.com/aws-powertools/powertools-lambda-python/issues/7641))
+* **deps:** bump docker/setup-qemu-action from 3.6.0 to 3.7.0 ([#7639](https://github.com/aws-powertools/powertools-lambda-python/issues/7639))
+* **deps:** bump squidfunk/mkdocs-material from `58dee36` to `980e11f` in /docs ([#7661](https://github.com/aws-powertools/powertools-lambda-python/issues/7661))
+* **deps:** bump mkdocstrings-python from 1.18.2 to 1.19.0 in /docs ([#7655](https://github.com/aws-powertools/powertools-lambda-python/issues/7655))
+* **deps:** bump mkdocs-material from 9.6.23 to 9.7.0 in /docs ([#7663](https://github.com/aws-powertools/powertools-lambda-python/issues/7663))
+* **deps-dev:** bump aws-cdk-lib from 2.222.0 to 2.223.0 ([#7656](https://github.com/aws-powertools/powertools-lambda-python/issues/7656))
+* **deps-dev:** bump types-python-dateutil from 2.9.0.20251008 to 2.9.0.20251108 ([#7657](https://github.com/aws-powertools/powertools-lambda-python/issues/7657))
+* **deps-dev:** bump aws-cdk from 2.1031.1 to 2.1031.2 ([#7645](https://github.com/aws-powertools/powertools-lambda-python/issues/7645))
+* **deps-dev:** bump boto3-stubs from 1.40.70 to 1.40.71 ([#7672](https://github.com/aws-powertools/powertools-lambda-python/issues/7672))
+* **deps-dev:** bump sentry-sdk from 2.43.0 to 2.44.0 ([#7665](https://github.com/aws-powertools/powertools-lambda-python/issues/7665))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.222.0a0 to 2.223.0a0 ([#7664](https://github.com/aws-powertools/powertools-lambda-python/issues/7664))
+* **deps-dev:** bump boto3-stubs from 1.40.64 to 1.40.69 ([#7654](https://github.com/aws-powertools/powertools-lambda-python/issues/7654))
+* **deps-dev:** bump types-protobuf from 6.32.1.20250918 to 6.32.1.20251105 ([#7640](https://github.com/aws-powertools/powertools-lambda-python/issues/7640))
+* **deps-dev:** bump pytest-benchmark from 5.2.1 to 5.2.3 ([#7658](https://github.com/aws-powertools/powertools-lambda-python/issues/7658))
+* **deps-dev:** bump nox from 2025.10.16 to 2025.11.12 ([#7671](https://github.com/aws-powertools/powertools-lambda-python/issues/7671))
+* **deps-dev:** bump ruff from 0.14.3 to 0.14.4 ([#7649](https://github.com/aws-powertools/powertools-lambda-python/issues/7649))
+* **docs:** fix broken images ([#7644](https://github.com/aws-powertools/powertools-lambda-python/issues/7644))
+
+
+<a name="v3.22.1"></a>
+## [v3.22.1] - 2025-11-05
+## Bug Fixes
+
+* **batch:** ensure Python 3.14 compatibility for async event loop handling ([#7599](https://github.com/aws-powertools/powertools-lambda-python/issues/7599))
+* **event-handler:** preserve metadata constraints in parameter validation ([#7609](https://github.com/aws-powertools/powertools-lambda-python/issues/7609))
+* **typing:** Fix type of Metrics.set_timestamp argument ([#7582](https://github.com/aws-powertools/powertools-lambda-python/issues/7582))
+
+## Documentation
+
+* **tracer:** fix typo in the tracer documentation ([#7617](https://github.com/aws-powertools/powertools-lambda-python/issues/7617))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.22.1a0 ([#7567](https://github.com/aws-powertools/powertools-lambda-python/issues/7567))
+* **ci:** new pre-release 3.22.1a1 ([#7583](https://github.com/aws-powertools/powertools-lambda-python/issues/7583))
+* **ci:** new pre-release 3.22.1a8 ([#7633](https://github.com/aws-powertools/powertools-lambda-python/issues/7633))
+* **ci:** new pre-release 3.22.1a2 ([#7588](https://github.com/aws-powertools/powertools-lambda-python/issues/7588))
+* **ci:** new pre-release 3.22.1a7 ([#7625](https://github.com/aws-powertools/powertools-lambda-python/issues/7625))
+* **ci:** new pre-release 3.22.1a6 ([#7615](https://github.com/aws-powertools/powertools-lambda-python/issues/7615))
+* **ci:** new pre-release 3.22.1a4 ([#7597](https://github.com/aws-powertools/powertools-lambda-python/issues/7597))
+* **ci:** new pre-release 3.22.1a3 ([#7591](https://github.com/aws-powertools/powertools-lambda-python/issues/7591))
+* **ci:** new pre-release 3.22.1a5 ([#7607](https://github.com/aws-powertools/powertools-lambda-python/issues/7607))
+* **deps:** bump mkdocs-material from 9.6.22 to 9.6.23 ([#7630](https://github.com/aws-powertools/powertools-lambda-python/issues/7630))
+* **deps:** bump squidfunk/mkdocs-material from `f5c556a` to `58dee36` in /docs ([#7622](https://github.com/aws-powertools/powertools-lambda-python/issues/7622))
+* **deps:** bump aws-xray-sdk from 2.14.0 to 2.15.0 ([#7603](https://github.com/aws-powertools/powertools-lambda-python/issues/7603))
+* **deps:** bump actions/upload-artifact from 4.6.2 to 5.0.0 ([#7578](https://github.com/aws-powertools/powertools-lambda-python/issues/7578))
+* **deps:** bump redis from 6.4.0 to 7.0.0 ([#7570](https://github.com/aws-powertools/powertools-lambda-python/issues/7570))
+* **deps:** bump actions/download-artifact from 5.0.0 to 6.0.0 ([#7577](https://github.com/aws-powertools/powertools-lambda-python/issues/7577))
+* **deps:** bump mkdocs-material from 9.6.22 to 9.6.23 ([#7624](https://github.com/aws-powertools/powertools-lambda-python/issues/7624))
+* **deps:** bump redis from 7.0.0 to 7.0.1 ([#7586](https://github.com/aws-powertools/powertools-lambda-python/issues/7586))
+* **deps-dev:** bump boto3-stubs from 1.40.60 to 1.40.61 ([#7590](https://github.com/aws-powertools/powertools-lambda-python/issues/7590))
+* **deps-dev:** bump pytest-benchmark from 5.1.0 to 5.2.0 ([#7606](https://github.com/aws-powertools/powertools-lambda-python/issues/7606))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.311 to 0.1.312 ([#7605](https://github.com/aws-powertools/powertools-lambda-python/issues/7605))
+* **deps-dev:** bump cfn-lint from 1.40.2 to 1.40.3 ([#7585](https://github.com/aws-powertools/powertools-lambda-python/issues/7585))
+* **deps-dev:** bump boto3-stubs from 1.40.59 to 1.40.60 ([#7587](https://github.com/aws-powertools/powertools-lambda-python/issues/7587))
+* **deps-dev:** bump aws-cdk-lib from 2.221.1 to 2.222.0 ([#7631](https://github.com/aws-powertools/powertools-lambda-python/issues/7631))
+* **deps-dev:** bump hvac from 2.3.0 to 2.4.0 ([#7602](https://github.com/aws-powertools/powertools-lambda-python/issues/7602))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.221.0a0 to 2.221.1a0 ([#7593](https://github.com/aws-powertools/powertools-lambda-python/issues/7593))
+* **deps-dev:** bump ruff from 0.14.1 to 0.14.2 ([#7575](https://github.com/aws-powertools/powertools-lambda-python/issues/7575))
+* **deps-dev:** bump boto3-stubs from 1.40.55 to 1.40.59 ([#7579](https://github.com/aws-powertools/powertools-lambda-python/issues/7579))
+* **deps-dev:** bump sentry-sdk from 2.42.1 to 2.43.0 ([#7594](https://github.com/aws-powertools/powertools-lambda-python/issues/7594))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.220.0a0 to 2.221.0a0 ([#7580](https://github.com/aws-powertools/powertools-lambda-python/issues/7580))
+* **deps-dev:** bump ruff from 0.14.2 to 0.14.3 ([#7610](https://github.com/aws-powertools/powertools-lambda-python/issues/7610))
+* **deps-dev:** bump boto3-stubs from 1.40.61 to 1.40.64 ([#7611](https://github.com/aws-powertools/powertools-lambda-python/issues/7611))
+* **deps-dev:** bump aws-cdk from 2.1030.0 to 2.1031.0 ([#7569](https://github.com/aws-powertools/powertools-lambda-python/issues/7569))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.221.1a0 to 2.222.0a0 ([#7628](https://github.com/aws-powertools/powertools-lambda-python/issues/7628))
+* **deps-dev:** bump cfn-lint from 1.40.3 to 1.40.4 ([#7632](https://github.com/aws-powertools/powertools-lambda-python/issues/7632))
+* **deps-dev:** bump pytest-benchmark from 5.2.0 to 5.2.1 ([#7629](https://github.com/aws-powertools/powertools-lambda-python/issues/7629))
+* **deps-dev:** bump aws-cdk from 2.1031.0 to 2.1031.1 ([#7601](https://github.com/aws-powertools/powertools-lambda-python/issues/7601))
+* **event_handler:** fix typos in api_gateway.py file ([#7619](https://github.com/aws-powertools/powertools-lambda-python/issues/7619))
+
+
+<a name="v3.22.0"></a>
+## [v3.22.0] - 2025-10-21
+## Bug Fixes
+
+* **event_handler:** Preserve `examples` field in OpenAPI schema for BedrockAgentResolver ([#7561](https://github.com/aws-powertools/powertools-lambda-python/issues/7561))
+
+## Documentation
+
+* **idempotency:** removed inexistent css class ([#7539](https://github.com/aws-powertools/powertools-lambda-python/issues/7539))
+
+## Features
+
+* **event_handler:** add support for Pydantic models in Query and Header types ([#7253](https://github.com/aws-powertools/powertools-lambda-python/issues/7253))
+
+## Maintenance
+
+* version bump
+* use approved sample names and addresses ([#7542](https://github.com/aws-powertools/powertools-lambda-python/issues/7542))
+* **ci:** new pre-release 3.21.1a5 ([#7538](https://github.com/aws-powertools/powertools-lambda-python/issues/7538))
+* **ci:** new pre-release 3.21.1a4 ([#7528](https://github.com/aws-powertools/powertools-lambda-python/issues/7528))
+* **ci:** new pre-release 3.21.1a7 ([#7563](https://github.com/aws-powertools/powertools-lambda-python/issues/7563))
+* **ci:** new pre-release 3.21.1a0 ([#7500](https://github.com/aws-powertools/powertools-lambda-python/issues/7500))
+* **ci:** update CONTRIBUTING.md ([#7549](https://github.com/aws-powertools/powertools-lambda-python/issues/7549))
+* **ci:** new pre-release 3.21.1a6 ([#7548](https://github.com/aws-powertools/powertools-lambda-python/issues/7548))
+* **ci:** new pre-release 3.21.1a1 ([#7506](https://github.com/aws-powertools/powertools-lambda-python/issues/7506))
+* **ci:** improve message when do-not-merge label is present ([#7505](https://github.com/aws-powertools/powertools-lambda-python/issues/7505))
+* **ci:** new pre-release 3.21.1a3 ([#7519](https://github.com/aws-powertools/powertools-lambda-python/issues/7519))
+* **ci:** new pre-release 3.21.1a2 ([#7514](https://github.com/aws-powertools/powertools-lambda-python/issues/7514))
+* **deps:** bump squidfunk/mkdocs-material from `00f9276` to `f5c556a` in /docs ([#7530](https://github.com/aws-powertools/powertools-lambda-python/issues/7530))
+* **deps:** bump mkdocs-material from 9.6.21 to 9.6.22 in /docs ([#7531](https://github.com/aws-powertools/powertools-lambda-python/issues/7531))
+* **deps:** bump pydantic from 2.12.0 to 2.12.2 ([#7522](https://github.com/aws-powertools/powertools-lambda-python/issues/7522))
+* **deps:** bump mkdocs-material from 9.6.21 to 9.6.22 ([#7534](https://github.com/aws-powertools/powertools-lambda-python/issues/7534))
+* **deps:** bump avro from 1.12.0 to 1.12.1 ([#7546](https://github.com/aws-powertools/powertools-lambda-python/issues/7546))
+* **deps:** bump protobuf from 6.32.1 to 6.33.0 ([#7544](https://github.com/aws-powertools/powertools-lambda-python/issues/7544))
+* **deps:** bump pydantic from 2.12.2 to 2.12.3 ([#7556](https://github.com/aws-powertools/powertools-lambda-python/issues/7556))
+* **deps:** bump actions/setup-node from 5.0.0 to 6.0.0 ([#7521](https://github.com/aws-powertools/powertools-lambda-python/issues/7521))
+* **deps:** bump valkey-glide from 2.1.0 to 2.1.1 ([#7498](https://github.com/aws-powertools/powertools-lambda-python/issues/7498))
+* **deps:** bump actions/dependency-review-action from 4.8.0 to 4.8.1 ([#7516](https://github.com/aws-powertools/powertools-lambda-python/issues/7516))
+* **deps-dev:** bump nox from 2024.10.9 to 2025.10.14 ([#7532](https://github.com/aws-powertools/powertools-lambda-python/issues/7532))
+* **deps-dev:** bump boto3-stubs from 1.40.49 to 1.40.51 ([#7517](https://github.com/aws-powertools/powertools-lambda-python/issues/7517))
+* **deps-dev:** bump cfn-lint from 1.40.1 to 1.40.2 ([#7525](https://github.com/aws-powertools/powertools-lambda-python/issues/7525))
+* **deps-dev:** bump aws-cdk-lib from 2.219.0 to 2.220.0 ([#7524](https://github.com/aws-powertools/powertools-lambda-python/issues/7524))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.219.0a0 to 2.220.0a0 ([#7526](https://github.com/aws-powertools/powertools-lambda-python/issues/7526))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.310 to 0.1.311 ([#7523](https://github.com/aws-powertools/powertools-lambda-python/issues/7523))
+* **deps-dev:** bump boto3-stubs from 1.40.47 to 1.40.49 ([#7503](https://github.com/aws-powertools/powertools-lambda-python/issues/7503))
+* **deps-dev:** bump ijson from 3.4.0 to 3.4.0.post0 ([#7510](https://github.com/aws-powertools/powertools-lambda-python/issues/7510))
+* **deps-dev:** bump aws-cdk from 2.1029.4 to 2.1030.0 ([#7508](https://github.com/aws-powertools/powertools-lambda-python/issues/7508))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.309 to 0.1.310 ([#7509](https://github.com/aws-powertools/powertools-lambda-python/issues/7509))
+* **deps-dev:** bump boto3-stubs from 1.40.51 to 1.40.53 ([#7535](https://github.com/aws-powertools/powertools-lambda-python/issues/7535))
+* **deps-dev:** bump sentry-sdk from 2.41.0 to 2.42.0 ([#7533](https://github.com/aws-powertools/powertools-lambda-python/issues/7533))
+* **deps-dev:** bump cfn-lint from 1.40.0 to 1.40.1 ([#7502](https://github.com/aws-powertools/powertools-lambda-python/issues/7502))
+* **deps-dev:** bump ruff from 0.14.0 to 0.14.1 ([#7545](https://github.com/aws-powertools/powertools-lambda-python/issues/7545))
+* **deps-dev:** bump sentry-sdk from 2.40.0 to 2.41.0 ([#7504](https://github.com/aws-powertools/powertools-lambda-python/issues/7504))
+* **deps-dev:** bump boto3-stubs from 1.40.53 to 1.40.54 ([#7547](https://github.com/aws-powertools/powertools-lambda-python/issues/7547))
+* **deps-dev:** bump boto3-stubs from 1.40.54 to 1.40.55 ([#7555](https://github.com/aws-powertools/powertools-lambda-python/issues/7555))
+* **deps-dev:** bump nox from 2025.10.14 to 2025.10.16 ([#7557](https://github.com/aws-powertools/powertools-lambda-python/issues/7557))
+* **deps-dev:** bump types-python-dateutil from 2.9.0.20250822 to 2.9.0.20251008 ([#7499](https://github.com/aws-powertools/powertools-lambda-python/issues/7499))
+* **deps-dev:** bump sentry-sdk from 2.42.0 to 2.42.1 ([#7562](https://github.com/aws-powertools/powertools-lambda-python/issues/7562))
+* **deps-dev:** bump mypy-boto3-appconfigdata from 1.40.0 to 1.40.55 in the boto-typing group ([#7554](https://github.com/aws-powertools/powertools-lambda-python/issues/7554))
+
+
+<a name="v3.21.0"></a>
+## [v3.21.0] - 2025-10-08
+## Bug Fixes
+
+* **docs:** correct build optimization script and docs ([#7367](https://github.com/aws-powertools/powertools-lambda-python/issues/7367))
+* **event_handler:** parse single list items in form data ([#7415](https://github.com/aws-powertools/powertools-lambda-python/issues/7415))
+
+## Code Refactoring
+
+* **parser:** Improve AppSync models with examples and descriptions ([#7330](https://github.com/aws-powertools/powertools-lambda-python/issues/7330))
+
+## Documentation
+
+* **aws:** add AWS docs bootstrap JavaScript ([#7472](https://github.com/aws-powertools/powertools-lambda-python/issues/7472))
+* **event_handler:** remove the wrong CORS warning ([#7385](https://github.com/aws-powertools/powertools-lambda-python/issues/7385))
+* **event_handler:** update test section ([#7374](https://github.com/aws-powertools/powertools-lambda-python/issues/7374))
+* **event_handler:** add info section about types ([#7368](https://github.com/aws-powertools/powertools-lambda-python/issues/7368))
+* **logger:** clarify Advanced Logging Controls interaction with sampling ([#7429](https://github.com/aws-powertools/powertools-lambda-python/issues/7429))
+
+## Features
+
+* **event-handler:** add support for Pydantic Field discriminator in validation ([#7227](https://github.com/aws-powertools/powertools-lambda-python/issues/7227))
+* **event_handler:** enhance OpenAPI response with headers, links, examples and encoding ([#7312](https://github.com/aws-powertools/powertools-lambda-python/issues/7312))
+* **parser:** add field metadata and examples for CloudWatch models ([#7343](https://github.com/aws-powertools/powertools-lambda-python/issues/7343))
+
+## Maintenance
+
+* Fix Discord badge in README ([#7488](https://github.com/aws-powertools/powertools-lambda-python/issues/7488))
+* version bump
+* **ci:** new pre-release 3.20.1a12 ([#7492](https://github.com/aws-powertools/powertools-lambda-python/issues/7492))
+* **ci:** new pre-release 3.20.1a5 ([#7418](https://github.com/aws-powertools/powertools-lambda-python/issues/7418))
+* **ci:** new pre-release 3.20.1a0 ([#7362](https://github.com/aws-powertools/powertools-lambda-python/issues/7362))
+* **ci:** new pre-release 3.20.1a11 ([#7485](https://github.com/aws-powertools/powertools-lambda-python/issues/7485))
+* **ci:** new pre-release 3.20.1a4 ([#7404](https://github.com/aws-powertools/powertools-lambda-python/issues/7404))
+* **ci:** new pre-release 3.20.1a10 ([#7479](https://github.com/aws-powertools/powertools-lambda-python/issues/7479))
+* **ci:** new pre-release 3.20.1a3 ([#7393](https://github.com/aws-powertools/powertools-lambda-python/issues/7393))
+* **ci:** new pre-release 3.20.1a1 ([#7372](https://github.com/aws-powertools/powertools-lambda-python/issues/7372))
+* **ci:** new pre-release 3.20.1a9 ([#7469](https://github.com/aws-powertools/powertools-lambda-python/issues/7469))
+* **ci:** new pre-release 3.20.1a8 ([#7456](https://github.com/aws-powertools/powertools-lambda-python/issues/7456))
+* **ci:** new pre-release 3.20.1a6 ([#7442](https://github.com/aws-powertools/powertools-lambda-python/issues/7442))
+* **ci:** new pre-release 3.20.1a2 ([#7383](https://github.com/aws-powertools/powertools-lambda-python/issues/7383))
+* **ci:** new pre-release 3.20.1a7 ([#7450](https://github.com/aws-powertools/powertools-lambda-python/issues/7450))
+* **deps:** bump mkdocs-llmstxt from 0.3.1 to 0.3.2 ([#7436](https://github.com/aws-powertools/powertools-lambda-python/issues/7436))
+* **deps:** bump mkdocs-material from 9.6.20 to 9.6.21 in /docs ([#7453](https://github.com/aws-powertools/powertools-lambda-python/issues/7453))
+* **deps:** bump squidfunk/mkdocs-material from `86d21da` to `00f9276` in /docs ([#7452](https://github.com/aws-powertools/powertools-lambda-python/issues/7452))
+* **deps:** bump ossf/scorecard-action from 2.4.2 to 2.4.3 ([#7458](https://github.com/aws-powertools/powertools-lambda-python/issues/7458))
+* **deps:** bump protobuf from 6.32.0 to 6.32.1 ([#7376](https://github.com/aws-powertools/powertools-lambda-python/issues/7376))
+* **deps:** bump pydantic-settings from 2.10.1 to 2.11.0 ([#7434](https://github.com/aws-powertools/powertools-lambda-python/issues/7434))
+* **deps:** bump mkdocs-material from 9.6.19 to 9.6.20 in /docs ([#7387](https://github.com/aws-powertools/powertools-lambda-python/issues/7387))
+* **deps:** bump mkdocs-llmstxt from 0.3.2 to 0.4.0 in /docs ([#7473](https://github.com/aws-powertools/powertools-lambda-python/issues/7473))
+* **deps:** bump mkdocs-material from 9.6.20 to 9.6.21 ([#7455](https://github.com/aws-powertools/powertools-lambda-python/issues/7455))
+* **deps:** bump mkdocs-material from 9.6.19 to 9.6.20 ([#7389](https://github.com/aws-powertools/powertools-lambda-python/issues/7389))
+* **deps:** bump actions/dependency-review-action from 4.7.3 to 4.8.0 ([#7432](https://github.com/aws-powertools/powertools-lambda-python/issues/7432))
+* **deps:** bump mkdocs-llmstxt from 0.3.2 to 0.4.0 ([#7475](https://github.com/aws-powertools/powertools-lambda-python/issues/7475))
+* **deps:** bump pydantic from 2.11.7 to 2.11.9 ([#7390](https://github.com/aws-powertools/powertools-lambda-python/issues/7390))
+* **deps:** bump valkey-glide from 2.0.1 to 2.1.0 ([#7403](https://github.com/aws-powertools/powertools-lambda-python/issues/7403))
+* **deps:** bump pydantic from 2.11.9 to 2.11.10 ([#7483](https://github.com/aws-powertools/powertools-lambda-python/issues/7483))
+* **deps:** bump mkdocs-material from 9.6.18 to 9.6.19 ([#7359](https://github.com/aws-powertools/powertools-lambda-python/issues/7359))
+* **deps:** bump pydantic from 2.11.10 to 2.12.0 ([#7491](https://github.com/aws-powertools/powertools-lambda-python/issues/7491))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.25 to 4.0.0 ([#7449](https://github.com/aws-powertools/powertools-lambda-python/issues/7449))
+* **deps:** bump mkdocs-llmstxt from 0.3.1 to 0.3.2 in /docs ([#7409](https://github.com/aws-powertools/powertools-lambda-python/issues/7409))
+* **deps:** bump squidfunk/mkdocs-material from `209b62d` to `86d21da` in /docs ([#7386](https://github.com/aws-powertools/powertools-lambda-python/issues/7386))
+* **deps-dev:** bump cfn-lint from 1.39.1 to 1.40.0 ([#7447](https://github.com/aws-powertools/powertools-lambda-python/issues/7447))
+* **deps-dev:** bump pytest-mock from 3.15.0 to 3.15.1 ([#7396](https://github.com/aws-powertools/powertools-lambda-python/issues/7396))
+* **deps-dev:** bump ruff from 0.12.12 to 0.13.2 ([#7427](https://github.com/aws-powertools/powertools-lambda-python/issues/7427))
+* **deps-dev:** bump types-protobuf from 6.30.2.20250822 to 6.32.1.20250918 ([#7406](https://github.com/aws-powertools/powertools-lambda-python/issues/7406))
+* **deps-dev:** bump aws-cdk from 2.1029.2 to 2.1029.3 ([#7420](https://github.com/aws-powertools/powertools-lambda-python/issues/7420))
+* **deps-dev:** bump aws-cdk-lib from 2.215.0 to 2.217.0 ([#7423](https://github.com/aws-powertools/powertools-lambda-python/issues/7423))
+* **deps-dev:** bump aws-cdk from 2.1029.1 to 2.1029.2 ([#7400](https://github.com/aws-powertools/powertools-lambda-python/issues/7400))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.215.0a0 to 2.217.0a0 ([#7424](https://github.com/aws-powertools/powertools-lambda-python/issues/7424))
+* **deps-dev:** bump boto3-stubs from 1.40.31 to 1.40.32 ([#7395](https://github.com/aws-powertools/powertools-lambda-python/issues/7395))
+* **deps-dev:** bump boto3-stubs from 1.40.32 to 1.40.39 ([#7425](https://github.com/aws-powertools/powertools-lambda-python/issues/7425))
+* **deps-dev:** bump coverage from 7.10.6 to 7.10.7 ([#7437](https://github.com/aws-powertools/powertools-lambda-python/issues/7437))
+* **deps-dev:** bump mypy from 1.18.1 to 1.18.2 ([#7435](https://github.com/aws-powertools/powertools-lambda-python/issues/7435))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.214.0a0 to 2.215.0a0 ([#7391](https://github.com/aws-powertools/powertools-lambda-python/issues/7391))
+* **deps-dev:** bump boto3-stubs from 1.40.30 to 1.40.31 ([#7388](https://github.com/aws-powertools/powertools-lambda-python/issues/7388))
+* **deps-dev:** bump boto3-stubs from 1.40.39 to 1.40.40 ([#7433](https://github.com/aws-powertools/powertools-lambda-python/issues/7433))
+* **deps-dev:** bump boto3-stubs from 1.40.27 to 1.40.29 ([#7371](https://github.com/aws-powertools/powertools-lambda-python/issues/7371))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.217.0a0 to 2.218.0a0 ([#7448](https://github.com/aws-powertools/powertools-lambda-python/issues/7448))
+* **deps-dev:** bump boto3-stubs from 1.40.40 to 1.40.41 ([#7445](https://github.com/aws-powertools/powertools-lambda-python/issues/7445))
+* **deps-dev:** bump sentry-sdk from 2.38.0 to 2.39.0 ([#7426](https://github.com/aws-powertools/powertools-lambda-python/issues/7426))
+* **deps-dev:** bump boto3-stubs from 1.40.41 to 1.40.42 ([#7454](https://github.com/aws-powertools/powertools-lambda-python/issues/7454))
+* **deps-dev:** bump boto3-stubs from 1.40.29 to 1.40.30 ([#7378](https://github.com/aws-powertools/powertools-lambda-python/issues/7378))
+* **deps-dev:** bump pytest-asyncio from 1.1.0 to 1.2.0 ([#7377](https://github.com/aws-powertools/powertools-lambda-python/issues/7377))
+* **deps-dev:** bump boto3-stubs from 1.40.42 to 1.40.43 ([#7460](https://github.com/aws-powertools/powertools-lambda-python/issues/7460))
+* **deps-dev:** bump mypy from 1.17.1 to 1.18.1 ([#7375](https://github.com/aws-powertools/powertools-lambda-python/issues/7375))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.218.0a0 to 2.219.0a0 ([#7464](https://github.com/aws-powertools/powertools-lambda-python/issues/7464))
+* **deps-dev:** bump aws-cdk from 2.1029.3 to 2.1029.4 ([#7459](https://github.com/aws-powertools/powertools-lambda-python/issues/7459))
+* **deps-dev:** bump ruff from 0.13.2 to 0.13.3 ([#7465](https://github.com/aws-powertools/powertools-lambda-python/issues/7465))
+* **deps-dev:** bump aws-cdk from 2.1029.0 to 2.1029.1 ([#7370](https://github.com/aws-powertools/powertools-lambda-python/issues/7370))
+* **deps-dev:** bump isort from 6.0.1 to 6.1.0 ([#7461](https://github.com/aws-powertools/powertools-lambda-python/issues/7461))
+* **deps-dev:** bump boto3-stubs from 1.40.44 to 1.40.45 ([#7474](https://github.com/aws-powertools/powertools-lambda-python/issues/7474))
+* **deps-dev:** bump sentry-sdk from 2.39.0 to 2.40.0 ([#7484](https://github.com/aws-powertools/powertools-lambda-python/issues/7484))
+* **deps-dev:** bump boto3-stubs from 1.40.26 to 1.40.27 ([#7358](https://github.com/aws-powertools/powertools-lambda-python/issues/7358))
+* **deps-dev:** bump pytest-cov from 6.3.0 to 7.0.0 ([#7357](https://github.com/aws-powertools/powertools-lambda-python/issues/7357))
+* **deps-dev:** bump ruff from 0.13.3 to 0.14.0 ([#7489](https://github.com/aws-powertools/powertools-lambda-python/issues/7489))
+* **deps-dev:** bump testcontainers from 4.12.0 to 4.13.0 ([#7360](https://github.com/aws-powertools/powertools-lambda-python/issues/7360))
+* **deps-dev:** bump sentry-sdk from 2.37.0 to 2.37.1 ([#7356](https://github.com/aws-powertools/powertools-lambda-python/issues/7356))
+* **deps-dev:** bump boto3-stubs from 1.40.45 to 1.40.47 ([#7490](https://github.com/aws-powertools/powertools-lambda-python/issues/7490))
+* **deps-dev:** bump sentry-sdk from 2.37.1 to 2.38.0 ([#7402](https://github.com/aws-powertools/powertools-lambda-python/issues/7402))
+
+
+<a name="v3.20.0"></a>
+## [v3.20.0] - 2025-09-09
+## Code Refactoring
+
+* **event_handler:** allow to pass dict as argument to exception classes ([#7341](https://github.com/aws-powertools/powertools-lambda-python/issues/7341))
+* **parser:** improves S3 models with examples and descriptions ([#7292](https://github.com/aws-powertools/powertools-lambda-python/issues/7292))
+* **parser:** Improve Transfer Family models with examples and descriptions ([#7294](https://github.com/aws-powertools/powertools-lambda-python/issues/7294))
+* **parser:** Improve Kafka models with examples and descriptions ([#7293](https://github.com/aws-powertools/powertools-lambda-python/issues/7293))
+* **parser:** Improve SQS models with examples and descriptions ([#7286](https://github.com/aws-powertools/powertools-lambda-python/issues/7286))
+* **parser:** Improve SNS models with examples and descriptions ([#7287](https://github.com/aws-powertools/powertools-lambda-python/issues/7287))
+* **parser:** Improve VPC Lattice with examples and descriptions ([#7234](https://github.com/aws-powertools/powertools-lambda-python/issues/7234))
+* **parser:** Improve DynamoDB models with examples and descriptions ([#7146](https://github.com/aws-powertools/powertools-lambda-python/issues/7146))
+
+## Documentation
+
+* fix SSM recursive parameter highlighting ([#7316](https://github.com/aws-powertools/powertools-lambda-python/issues/7316))
+* Add AWS copyright footer. ([#7313](https://github.com/aws-powertools/powertools-lambda-python/issues/7313))
+* Add installation snippet for uv package manager ([#7272](https://github.com/aws-powertools/powertools-lambda-python/issues/7272))
+* Fix copy to clipboard button ([#7270](https://github.com/aws-powertools/powertools-lambda-python/issues/7270))
+* **build_recipes:** add troubleshooting page ([#7195](https://github.com/aws-powertools/powertools-lambda-python/issues/7195))
+* **build_recipes:** add cicd page ([#7176](https://github.com/aws-powertools/powertools-lambda-python/issues/7176))
+* **build_recipes:** add initial build recipes structure ([#7163](https://github.com/aws-powertools/powertools-lambda-python/issues/7163))
+* **build_recipes:** add build tools page ([#7201](https://github.com/aws-powertools/powertools-lambda-python/issues/7201))
+* **build_recipes:** add cross build page ([#7199](https://github.com/aws-powertools/powertools-lambda-python/issues/7199))
+* **build_recipes:** add performance optimization page ([#7197](https://github.com/aws-powertools/powertools-lambda-python/issues/7197))
+* **index:** remove customer names ([#7318](https://github.com/aws-powertools/powertools-lambda-python/issues/7318))
+* **mkdocs:** fix docs warnings ([#7211](https://github.com/aws-powertools/powertools-lambda-python/issues/7211))
+* **public_reference:** add QuasiScience as a public reference ([#7228](https://github.com/aws-powertools/powertools-lambda-python/issues/7228))
+
+## Features
+
+* **parser:** add support for sourceIp with ipv6 and port ([#7351](https://github.com/aws-powertools/powertools-lambda-python/issues/7351))
+* **parser:** add support for sourceIp with port ([#7315](https://github.com/aws-powertools/powertools-lambda-python/issues/7315))
+
+## Maintenance
+
+* version bump
+* **automation:** update PR template to include closes command ([#7173](https://github.com/aws-powertools/powertools-lambda-python/issues/7173))
+* **ci:** new pre-release 3.19.1a11 ([#7278](https://github.com/aws-powertools/powertools-lambda-python/issues/7278))
+* **ci:** new pre-release 3.19.1a0 ([#7161](https://github.com/aws-powertools/powertools-lambda-python/issues/7161))
+* **ci:** new pre-release 3.19.1a16 ([#7350](https://github.com/aws-powertools/powertools-lambda-python/issues/7350))
+* **ci:** new pre-release 3.19.1a1 ([#7172](https://github.com/aws-powertools/powertools-lambda-python/issues/7172))
+* **ci:** new pre-release 3.19.1a2 ([#7192](https://github.com/aws-powertools/powertools-lambda-python/issues/7192))
+* **ci:** new pre-release 3.19.1a3 ([#7207](https://github.com/aws-powertools/powertools-lambda-python/issues/7207))
+* **ci:** new pre-release 3.19.1a4 ([#7217](https://github.com/aws-powertools/powertools-lambda-python/issues/7217))
+* **ci:** new pre-release 3.19.1a6 ([#7232](https://github.com/aws-powertools/powertools-lambda-python/issues/7232))
+* **ci:** new pre-release 3.19.1a7 ([#7244](https://github.com/aws-powertools/powertools-lambda-python/issues/7244))
+* **ci:** new pre-release 3.19.1a14 ([#7306](https://github.com/aws-powertools/powertools-lambda-python/issues/7306))
+* **ci:** new pre-release 3.19.1a5 ([#7226](https://github.com/aws-powertools/powertools-lambda-python/issues/7226))
+* **ci:** new pre-release 3.19.1a8 ([#7247](https://github.com/aws-powertools/powertools-lambda-python/issues/7247))
+* **ci:** new pre-release 3.19.1a9 ([#7256](https://github.com/aws-powertools/powertools-lambda-python/issues/7256))
+* **ci:** new pre-release 3.19.1a13 ([#7295](https://github.com/aws-powertools/powertools-lambda-python/issues/7295))
+* **ci:** new pre-release 3.19.1a12 ([#7290](https://github.com/aws-powertools/powertools-lambda-python/issues/7290))
+* **ci:** new pre-release 3.19.1a10 ([#7269](https://github.com/aws-powertools/powertools-lambda-python/issues/7269))
+* **ci:** new pre-release 3.19.1a15 ([#7328](https://github.com/aws-powertools/powertools-lambda-python/issues/7328))
+* **deps:** bump mkdocstrings-python from 1.17.0 to 1.18.0 ([#7268](https://github.com/aws-powertools/powertools-lambda-python/issues/7268))
+* **deps:** bump mkdocstrings-python from 1.18.0 to 1.18.2 in /docs ([#7273](https://github.com/aws-powertools/powertools-lambda-python/issues/7273))
+* **deps:** bump squidfunk/mkdocs-material from `1a4e939` to `209b62d` in /docs ([#7344](https://github.com/aws-powertools/powertools-lambda-python/issues/7344))
+* **deps:** bump aws-actions/configure-aws-credentials from aa1f74b81b53cb3adb28afcdb21d7b9f3fceea98 to 209f2a4450bb4b277e1dedaff40ad2fd8d4d0a4c ([#7160](https://github.com/aws-powertools/powertools-lambda-python/issues/7160))
+* **deps:** bump mkdocs-material from 9.6.18 to 9.6.19 ([#7346](https://github.com/aws-powertools/powertools-lambda-python/issues/7346))
+* **deps:** bump actions/setup-go from 5.5.0 to 6.0.0 ([#7323](https://github.com/aws-powertools/powertools-lambda-python/issues/7323))
+* **deps:** bump codecov/codecov-action from 5.5.0 to 5.5.1 ([#7345](https://github.com/aws-powertools/powertools-lambda-python/issues/7345))
+* **deps:** bump aws-actions/configure-aws-credentials from 241c954d319becef88d2022775301737d5eb5e24 to 1b2b73eb6a459c3a91fde76ba4c255e5b4b8e94e ([#7266](https://github.com/aws-powertools/powertools-lambda-python/issues/7266))
+* **deps:** bump aws-actions/configure-aws-credentials from 0eb446ecb2e3f0e1a19f106e12e76c6a98b6bdb2 to 241c954d319becef88d2022775301737d5eb5e24 ([#7260](https://github.com/aws-powertools/powertools-lambda-python/issues/7260))
+* **deps:** bump mkdocstrings-python from 1.18.0 to 1.18.2 ([#7277](https://github.com/aws-powertools/powertools-lambda-python/issues/7277))
+* **deps:** bump actions/setup-python from 5.6.0 to 6.0.0 ([#7321](https://github.com/aws-powertools/powertools-lambda-python/issues/7321))
+* **deps:** bump actions/github-script from 7.0.1 to 8.0.0 ([#7320](https://github.com/aws-powertools/powertools-lambda-python/issues/7320))
+* **deps:** bump aws-powertools/actions from 1.4.0 to 1.5.0 ([#7180](https://github.com/aws-powertools/powertools-lambda-python/issues/7180))
+* **deps:** bump squidfunk/mkdocs-material from `bb7b015` to `405aeb6` in /docs ([#7185](https://github.com/aws-powertools/powertools-lambda-python/issues/7185))
+* **deps:** bump actions/dependency-review-action from 4.7.2 to 4.7.3 ([#7255](https://github.com/aws-powertools/powertools-lambda-python/issues/7255))
+* **deps:** bump mkdocstrings-python from 1.17.0 to 1.18.0 ([#7254](https://github.com/aws-powertools/powertools-lambda-python/issues/7254))
+* **deps:** bump typing-extensions from 4.14.1 to 4.15.0 ([#7251](https://github.com/aws-powertools/powertools-lambda-python/issues/7251))
+* **deps:** bump mkdocs-material from 9.6.16 to 9.6.17 ([#7188](https://github.com/aws-powertools/powertools-lambda-python/issues/7188))
+* **deps:** bump fastjsonschema from 2.21.1 to 2.21.2 ([#7179](https://github.com/aws-powertools/powertools-lambda-python/issues/7179))
+* **deps:** bump aws-actions/configure-aws-credentials from 209f2a4450bb4b277e1dedaff40ad2fd8d4d0a4c to 3821430d177f66b128b701e38ba67c5319b1b0bd ([#7202](https://github.com/aws-powertools/powertools-lambda-python/issues/7202))
+* **deps:** bump aws-actions/configure-aws-credentials from 1b2b73eb6a459c3a91fde76ba4c255e5b4b8e94e to a03048d87541d1d9fcf2ecf528a4a65ba9bd7838 ([#7307](https://github.com/aws-powertools/powertools-lambda-python/issues/7307))
+* **deps:** bump mkdocstrings-python from 1.16.12 to 1.17.0 ([#7206](https://github.com/aws-powertools/powertools-lambda-python/issues/7206))
+* **deps:** bump actions/dependency-review-action from 4.7.1 to 4.7.2 ([#7203](https://github.com/aws-powertools/powertools-lambda-python/issues/7203))
+* **deps:** bump mkdocs-material from 9.6.17 to 9.6.18 ([#7237](https://github.com/aws-powertools/powertools-lambda-python/issues/7237))
+* **deps:** bump protobuf from 6.31.1 to 6.32.0 ([#7208](https://github.com/aws-powertools/powertools-lambda-python/issues/7208))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.12.4 to 1.13.0 ([#7322](https://github.com/aws-powertools/powertools-lambda-python/issues/7322))
+* **deps:** bump aws-actions/configure-aws-credentials from 3821430d177f66b128b701e38ba67c5319b1b0bd to 09a74e37ceda446282c61f1496cdca8d8dca0e57 ([#7213](https://github.com/aws-powertools/powertools-lambda-python/issues/7213))
+* **deps:** bump squidfunk/mkdocs-material from `405aeb6` to `1a4e939` in /docs ([#7236](https://github.com/aws-powertools/powertools-lambda-python/issues/7236))
+* **deps:** bump mkdocs-material from 9.6.16 to 9.6.17 ([#7216](https://github.com/aws-powertools/powertools-lambda-python/issues/7216))
+* **deps:** bump mkdocs-material from 9.6.17 to 9.6.18 in /docs ([#7235](https://github.com/aws-powertools/powertools-lambda-python/issues/7235))
+* **deps:** bump aws-encryption-sdk from 4.0.2 to 4.0.3 ([#7305](https://github.com/aws-powertools/powertools-lambda-python/issues/7305))
+* **deps:** bump actions/setup-node from 4.4.0 to 5.0.0 ([#7319](https://github.com/aws-powertools/powertools-lambda-python/issues/7319))
+* **deps:** bump aws-actions/configure-aws-credentials from 09a74e37ceda446282c61f1496cdca8d8dca0e57 to 0eb446ecb2e3f0e1a19f106e12e76c6a98b6bdb2 ([#7222](https://github.com/aws-powertools/powertools-lambda-python/issues/7222))
+* **deps:** bump codecov/codecov-action from 5.4.3 to 5.5.0 ([#7221](https://github.com/aws-powertools/powertools-lambda-python/issues/7221))
+* **deps:** bump mkdocstrings-python from 1.16.12 to 1.17.0 in /docs ([#7187](https://github.com/aws-powertools/powertools-lambda-python/issues/7187))
+* **deps-dev:** bump boto3-stubs from 1.40.23 to 1.40.25 ([#7334](https://github.com/aws-powertools/powertools-lambda-python/issues/7334))
+* **deps-dev:** bump boto3-stubs from 1.40.14 to 1.40.15 ([#7230](https://github.com/aws-powertools/powertools-lambda-python/issues/7230))
+* **deps-dev:** bump boto3-stubs from 1.40.13 to 1.40.14 ([#7224](https://github.com/aws-powertools/powertools-lambda-python/issues/7224))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.211.0a0 to 2.212.0a0 ([#7223](https://github.com/aws-powertools/powertools-lambda-python/issues/7223))
+* **deps-dev:** bump ruff from 0.12.9 to 0.12.10 ([#7231](https://github.com/aws-powertools/powertools-lambda-python/issues/7231))
+* **deps-dev:** bump sentry-sdk from 2.35.2 to 2.37.0 ([#7335](https://github.com/aws-powertools/powertools-lambda-python/issues/7335))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.213.0a0 to 2.214.0a0 ([#7303](https://github.com/aws-powertools/powertools-lambda-python/issues/7303))
+* **deps-dev:** bump boto3-stubs from 1.40.12 to 1.40.13 ([#7214](https://github.com/aws-powertools/powertools-lambda-python/issues/7214))
+* **deps-dev:** bump requests from 2.32.4 to 2.32.5 ([#7215](https://github.com/aws-powertools/powertools-lambda-python/issues/7215))
+* **deps-dev:** bump types-protobuf from 6.30.2.20250809 to 6.30.2.20250822 ([#7241](https://github.com/aws-powertools/powertools-lambda-python/issues/7241))
+* **deps-dev:** bump pytest-mock from 3.14.1 to 3.15.0 ([#7333](https://github.com/aws-powertools/powertools-lambda-python/issues/7333))
+* **deps-dev:** bump types-python-dateutil from 2.9.0.20250809 to 2.9.0.20250822 ([#7238](https://github.com/aws-powertools/powertools-lambda-python/issues/7238))
+* **deps-dev:** bump cfn-lint from 1.38.3 to 1.39.0 ([#7212](https://github.com/aws-powertools/powertools-lambda-python/issues/7212))
+* **deps-dev:** bump pytest from 8.4.1 to 8.4.2 ([#7325](https://github.com/aws-powertools/powertools-lambda-python/issues/7325))
+* **deps-dev:** bump aws-cdk from 2.1025.0 to 2.1026.0 ([#7239](https://github.com/aws-powertools/powertools-lambda-python/issues/7239))
+* **deps-dev:** bump coverage from 7.10.3 to 7.10.4 ([#7205](https://github.com/aws-powertools/powertools-lambda-python/issues/7205))
+* **deps-dev:** bump boto3-stubs from 1.40.15 to 1.40.16 ([#7240](https://github.com/aws-powertools/powertools-lambda-python/issues/7240))
+* **deps-dev:** bump sentry-sdk from 2.35.1 to 2.35.2 ([#7297](https://github.com/aws-powertools/powertools-lambda-python/issues/7297))
+* **deps-dev:** bump boto3-stubs from 1.40.11 to 1.40.12 ([#7204](https://github.com/aws-powertools/powertools-lambda-python/issues/7204))
+* **deps-dev:** bump aws-cdk-lib from 2.213.0 to 2.214.0 ([#7302](https://github.com/aws-powertools/powertools-lambda-python/issues/7302))
+* **deps-dev:** bump aws-cdk from 2.1028.0 to 2.1029.0 ([#7332](https://github.com/aws-powertools/powertools-lambda-python/issues/7332))
+* **deps-dev:** bump filelock from 3.18.0 to 3.19.1 ([#7177](https://github.com/aws-powertools/powertools-lambda-python/issues/7177))
+* **deps-dev:** bump boto3-stubs from 1.40.9 to 1.40.11 ([#7189](https://github.com/aws-powertools/powertools-lambda-python/issues/7189))
+* **deps-dev:** bump ruff from 0.12.11 to 0.12.12 ([#7324](https://github.com/aws-powertools/powertools-lambda-python/issues/7324))
+* **deps-dev:** bump coverage from 7.10.4 to 7.10.5 ([#7249](https://github.com/aws-powertools/powertools-lambda-python/issues/7249))
+* **deps-dev:** bump aws-cdk from 2.1024.0 to 2.1025.0 ([#7167](https://github.com/aws-powertools/powertools-lambda-python/issues/7167))
+* **deps-dev:** bump sentry-sdk from 2.34.1 to 2.35.0 ([#7181](https://github.com/aws-powertools/powertools-lambda-python/issues/7181))
+* **deps-dev:** bump boto3-stubs from 1.40.16 to 1.40.17 ([#7250](https://github.com/aws-powertools/powertools-lambda-python/issues/7250))
+* **deps-dev:** bump aws-cdk from 2.1027.0 to 2.1028.0 ([#7308](https://github.com/aws-powertools/powertools-lambda-python/issues/7308))
+* **deps-dev:** bump sentry-sdk from 2.35.0 to 2.35.1 ([#7258](https://github.com/aws-powertools/powertools-lambda-python/issues/7258))
+* **deps-dev:** bump cfn-lint from 1.39.0 to 1.39.1 ([#7259](https://github.com/aws-powertools/powertools-lambda-python/issues/7259))
+* **deps-dev:** bump ruff from 0.12.8 to 0.12.9 ([#7182](https://github.com/aws-powertools/powertools-lambda-python/issues/7182))
+* **deps-dev:** bump boto3-stubs from 1.40.21 to 1.40.23 ([#7309](https://github.com/aws-powertools/powertools-lambda-python/issues/7309))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.210.0a0 to 2.211.0a0 ([#7168](https://github.com/aws-powertools/powertools-lambda-python/issues/7168))
+* **deps-dev:** bump cfn-lint from 1.38.2 to 1.38.3 ([#7169](https://github.com/aws-powertools/powertools-lambda-python/issues/7169))
+* **deps-dev:** bump aws-cdk from 2.1026.0 to 2.1027.0 ([#7265](https://github.com/aws-powertools/powertools-lambda-python/issues/7265))
+* **deps-dev:** bump coverage from 7.10.5 to 7.10.6 ([#7282](https://github.com/aws-powertools/powertools-lambda-python/issues/7282))
+* **deps-dev:** bump pytest-cov from 6.2.1 to 6.3.0 ([#7349](https://github.com/aws-powertools/powertools-lambda-python/issues/7349))
+* **deps-dev:** bump boto3-stubs from 1.40.8 to 1.40.9 ([#7170](https://github.com/aws-powertools/powertools-lambda-python/issues/7170))
+* **deps-dev:** bump boto3-stubs from 1.40.25 to 1.40.26 ([#7348](https://github.com/aws-powertools/powertools-lambda-python/issues/7348))
+* **deps-dev:** bump boto3-stubs from 1.40.18 to 1.40.19 ([#7267](https://github.com/aws-powertools/powertools-lambda-python/issues/7267))
+* **deps-dev:** bump boto3-stubs from 1.40.7 to 1.40.8 ([#7159](https://github.com/aws-powertools/powertools-lambda-python/issues/7159))
+* **deps-dev:** bump boto3-stubs from 1.40.19 to 1.40.21 ([#7283](https://github.com/aws-powertools/powertools-lambda-python/issues/7283))
+* **deps-dev:** bump ruff from 0.12.10 to 0.12.11 ([#7275](https://github.com/aws-powertools/powertools-lambda-python/issues/7275))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.212.0a0 to 2.213.0a0 ([#7274](https://github.com/aws-powertools/powertools-lambda-python/issues/7274))
+* **deps-dev:** bump boto3-stubs from 1.40.17 to 1.40.18 ([#7264](https://github.com/aws-powertools/powertools-lambda-python/issues/7264))
+
+
+<a name="v3.19.0"></a>
+## [v3.19.0] - 2025-08-12
+## Bug Fixes
+
+* **event_handler:** split OpenAPI validation to respect middleware returns ([#7050](https://github.com/aws-powertools/powertools-lambda-python/issues/7050))
+* **parameters:** fix _transform_and_cache_get_parameters_response ([#7083](https://github.com/aws-powertools/powertools-lambda-python/issues/7083))
+
+## Code Refactoring
+
+* **parser:** Improve ALB models with examples and descriptions ([#7100](https://github.com/aws-powertools/powertools-lambda-python/issues/7100))
+* **parser:** Improve Kinesis models with examples and descriptions ([#7092](https://github.com/aws-powertools/powertools-lambda-python/issues/7092))
+* **parser:** Improve EventBridge models with examples and descriptions ([#7090](https://github.com/aws-powertools/powertools-lambda-python/issues/7090))
+
+## Documentation
+
+* **event_handler:** improve routing rules syntax documentation ([#7094](https://github.com/aws-powertools/powertools-lambda-python/issues/7094))
+* **logger:** fix typo in sampling examples ([#7133](https://github.com/aws-powertools/powertools-lambda-python/issues/7133))
+* **maintainers:** improve release process documentation ([#7088](https://github.com/aws-powertools/powertools-lambda-python/issues/7088))
+
+## Features
+
+* **parameters:** add support for retrieving batch of secrets ([#7058](https://github.com/aws-powertools/powertools-lambda-python/issues/7058))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.18.1a6 ([#7134](https://github.com/aws-powertools/powertools-lambda-python/issues/7134))
+* **ci:** new pre-release 3.18.1a5 ([#7114](https://github.com/aws-powertools/powertools-lambda-python/issues/7114))
+* **ci:** new pre-release 3.18.1a1 ([#7077](https://github.com/aws-powertools/powertools-lambda-python/issues/7077))
+* **ci:** new pre-release 3.18.1a0 ([#7068](https://github.com/aws-powertools/powertools-lambda-python/issues/7068))
+* **ci:** new pre-release 3.18.1a9 ([#7155](https://github.com/aws-powertools/powertools-lambda-python/issues/7155))
+* **ci:** new pre-release 3.18.1a8 ([#7147](https://github.com/aws-powertools/powertools-lambda-python/issues/7147))
+* **ci:** new pre-release 3.18.1a3 ([#7097](https://github.com/aws-powertools/powertools-lambda-python/issues/7097))
+* **ci:** new pre-release 3.18.1a7 ([#7141](https://github.com/aws-powertools/powertools-lambda-python/issues/7141))
+* **ci:** new pre-release 3.18.1a2 ([#7085](https://github.com/aws-powertools/powertools-lambda-python/issues/7085))
+* **ci:** new pre-release 3.18.1a4 ([#7105](https://github.com/aws-powertools/powertools-lambda-python/issues/7105))
+* **deps:** bump mkdocs-llmstxt from 0.3.0 to 0.3.1 ([#7112](https://github.com/aws-powertools/powertools-lambda-python/issues/7112))
+* **deps:** bump squidfunk/mkdocs-material from `0bfdba4` to `bb7b015` in /docs ([#7059](https://github.com/aws-powertools/powertools-lambda-python/issues/7059))
+* **deps:** bump redis from 6.3.0 to 6.4.0 ([#7140](https://github.com/aws-powertools/powertools-lambda-python/issues/7140))
+* **deps:** bump actions/checkout from 4.2.2 to 5.0.0 ([#7154](https://github.com/aws-powertools/powertools-lambda-python/issues/7154))
+* **deps:** bump aws-powertools/actions from 1.3.0 to 1.4.0 ([#7104](https://github.com/aws-powertools/powertools-lambda-python/issues/7104))
+* **deps:** bump actions/download-artifact from 4.3.0 to 5.0.0 ([#7126](https://github.com/aws-powertools/powertools-lambda-python/issues/7126))
+* **deps:** bump aws-powertools/actions from 1.1.0 to 1.3.0 ([#7061](https://github.com/aws-powertools/powertools-lambda-python/issues/7061))
+* **deps:** bump aws-actions/configure-aws-credentials from 4.2.1 to 4.3.0 ([#7103](https://github.com/aws-powertools/powertools-lambda-python/issues/7103))
+* **deps:** bump aws-actions/configure-aws-credentials from 59b441846ad109fa4a1549b73ef4e149c4bfb53b to aa1f74b81b53cb3adb28afcdb21d7b9f3fceea98 ([#7113](https://github.com/aws-powertools/powertools-lambda-python/issues/7113))
+* **deps:** bump redis from 6.2.0 to 6.3.0 ([#7108](https://github.com/aws-powertools/powertools-lambda-python/issues/7108))
+* **deps:** bump mkdocs-material from 9.6.15 to 9.6.16 in /docs ([#7060](https://github.com/aws-powertools/powertools-lambda-python/issues/7060))
+* **deps:** bump mkdocs-llmstxt from 0.3.0 to 0.3.1 ([#7130](https://github.com/aws-powertools/powertools-lambda-python/issues/7130))
+* **deps:** bump mkdocs-material from 9.6.15 to 9.6.16 ([#7065](https://github.com/aws-powertools/powertools-lambda-python/issues/7065))
+* **deps-dev:** bump boto3-stubs from 1.40.2 to 1.40.3 ([#7111](https://github.com/aws-powertools/powertools-lambda-python/issues/7111))
+* **deps-dev:** bump cfn-lint from 1.38.1 to 1.38.2 ([#7109](https://github.com/aws-powertools/powertools-lambda-python/issues/7109))
+* **deps-dev:** bump boto3-stubs from 1.40.1 to 1.40.2 ([#7102](https://github.com/aws-powertools/powertools-lambda-python/issues/7102))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.208.0a0 to 2.210.0a0 ([#7127](https://github.com/aws-powertools/powertools-lambda-python/issues/7127))
+* **deps-dev:** bump boto3-stubs from 1.40.0 to 1.40.1 ([#7093](https://github.com/aws-powertools/powertools-lambda-python/issues/7093))
+* **deps-dev:** bump aws-cdk from 2.1023.0 to 2.1024.0 ([#7125](https://github.com/aws-powertools/powertools-lambda-python/issues/7125))
+* **deps-dev:** bump boto3-stubs from 1.40.3 to 1.40.4 ([#7128](https://github.com/aws-powertools/powertools-lambda-python/issues/7128))
+* **deps-dev:** bump boto3-stubs from 1.40.6 to 1.40.7 ([#7153](https://github.com/aws-powertools/powertools-lambda-python/issues/7153))
+* **deps-dev:** bump mypy from 1.17.0 to 1.17.1 ([#7081](https://github.com/aws-powertools/powertools-lambda-python/issues/7081))
+* **deps-dev:** bump cfn-lint from 1.38.0 to 1.38.1 ([#7080](https://github.com/aws-powertools/powertools-lambda-python/issues/7080))
+* **deps-dev:** bump mypy-boto3-appconfigdata from 1.39.0 to 1.40.0 in the boto-typing group ([#7079](https://github.com/aws-powertools/powertools-lambda-python/issues/7079))
+* **deps-dev:** bump ruff from 0.12.7 to 0.12.8 ([#7138](https://github.com/aws-powertools/powertools-lambda-python/issues/7138))
+* **deps-dev:** bump boto3-stubs from 1.40.4 to 1.40.5 ([#7139](https://github.com/aws-powertools/powertools-lambda-python/issues/7139))
+* **deps-dev:** bump sentry-sdk from 2.34.0 to 2.34.1 ([#7075](https://github.com/aws-powertools/powertools-lambda-python/issues/7075))
+* **deps-dev:** bump ruff from 0.12.5 to 0.12.7 ([#7073](https://github.com/aws-powertools/powertools-lambda-python/issues/7073))
+* **deps-dev:** bump boto3-stubs from 1.39.16 to 1.39.17 ([#7072](https://github.com/aws-powertools/powertools-lambda-python/issues/7072))
+* **deps-dev:** bump boto3-stubs from 1.40.5 to 1.40.6 ([#7143](https://github.com/aws-powertools/powertools-lambda-python/issues/7143))
+* **deps-dev:** bump types-protobuf from 6.30.2.20250703 to 6.30.2.20250809 ([#7150](https://github.com/aws-powertools/powertools-lambda-python/issues/7150))
+* **deps-dev:** bump aws-cdk from 2.1022.0 to 2.1023.0 ([#7067](https://github.com/aws-powertools/powertools-lambda-python/issues/7067))
+* **deps-dev:** bump coverage from 7.10.2 to 7.10.3 ([#7152](https://github.com/aws-powertools/powertools-lambda-python/issues/7152))
+* **deps-dev:** bump sentry-sdk from 2.33.2 to 2.34.0 ([#7064](https://github.com/aws-powertools/powertools-lambda-python/issues/7064))
+* **deps-dev:** bump boto3-stubs from 1.39.14 to 1.39.16 ([#7066](https://github.com/aws-powertools/powertools-lambda-python/issues/7066))
+* **deps-dev:** bump coverage from 7.10.0 to 7.10.1 ([#7063](https://github.com/aws-powertools/powertools-lambda-python/issues/7063))
+* **deps-dev:** bump types-python-dateutil from 2.9.0.20250708 to 2.9.0.20250809 ([#7151](https://github.com/aws-powertools/powertools-lambda-python/issues/7151))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.207.0a0 to 2.208.0a0 ([#7062](https://github.com/aws-powertools/powertools-lambda-python/issues/7062))
+* **deps-dev:** bump coverage from 7.10.1 to 7.10.2 ([#7107](https://github.com/aws-powertools/powertools-lambda-python/issues/7107))
+* **git:** add LLM tools to .gitignore file ([#7137](https://github.com/aws-powertools/powertools-lambda-python/issues/7137))
+
+
+<a name="v3.17.1"></a>
+## [v3.17.1] - 2025-07-29
+## Maintenance
+
+
+
+<a name="v3.18.0"></a>
+## [v3.18.0] - 2025-07-29
+## Documentation
+
+* **event_handler:** add section about Pydantic serialization ([#7049](https://github.com/aws-powertools/powertools-lambda-python/issues/7049))
+* **event_handler:** enhance documentation on query/header parameters behavior ([#7000](https://github.com/aws-powertools/powertools-lambda-python/issues/7000))
+* **parameters:** fix typo in transform auto instruction ([#7017](https://github.com/aws-powertools/powertools-lambda-python/issues/7017))
+* **parser:** fix a a typo in SqsEnvelope ([#7052](https://github.com/aws-powertools/powertools-lambda-python/issues/7052))
+
+## Features
+
+* **event_handler:** add support for form data in OpenAPI utility ([#7028](https://github.com/aws-powertools/powertools-lambda-python/issues/7028))
+* **metrics:** add runtime validations for the metric name ([#7026](https://github.com/aws-powertools/powertools-lambda-python/issues/7026))
+* **parser:** add AppSync Events models ([#6999](https://github.com/aws-powertools/powertools-lambda-python/issues/6999))
+* **typing:** add tenant_id property ([#6985](https://github.com/aws-powertools/powertools-lambda-python/issues/6985))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.17.1a4 ([#7018](https://github.com/aws-powertools/powertools-lambda-python/issues/7018))
+* **ci:** improve feature flags UA ([#7051](https://github.com/aws-powertools/powertools-lambda-python/issues/7051))
+* **ci:** new pre-release 3.17.1a8 ([#7045](https://github.com/aws-powertools/powertools-lambda-python/issues/7045))
+* **ci:** new pre-release 3.17.1a9 ([#7054](https://github.com/aws-powertools/powertools-lambda-python/issues/7054))
+* **ci:** new pre-release 3.17.1a7 ([#7038](https://github.com/aws-powertools/powertools-lambda-python/issues/7038))
+* **ci:** new pre-release 3.17.1a0 ([#6989](https://github.com/aws-powertools/powertools-lambda-python/issues/6989))
+* **ci:** new pre-release 3.17.1a1 ([#6997](https://github.com/aws-powertools/powertools-lambda-python/issues/6997))
+* **ci:** add a new workflow to build docs in new PRs ([#7002](https://github.com/aws-powertools/powertools-lambda-python/issues/7002))
+* **ci:** new pre-release 3.17.1a2 ([#7008](https://github.com/aws-powertools/powertools-lambda-python/issues/7008))
+* **ci:** new pre-release 3.17.1a6 ([#7029](https://github.com/aws-powertools/powertools-lambda-python/issues/7029))
+* **ci:** new pre-release 3.17.1a3 ([#7014](https://github.com/aws-powertools/powertools-lambda-python/issues/7014))
+* **ci:** new pre-release 3.17.1a5 ([#7025](https://github.com/aws-powertools/powertools-lambda-python/issues/7025))
+* **ci:** remove closed-issue and opened-pr workflows ([#7047](https://github.com/aws-powertools/powertools-lambda-python/issues/7047))
+* **deps:** update aws-powertools/actions requirement to 5ae7c190d6b51491bb14f593c3509c1bcbf7a3c1 ([#7034](https://github.com/aws-powertools/powertools-lambda-python/issues/7034))
+* **deps-dev:** bump pytest-asyncio from 0.26.0 to 1.1.0 ([#6995](https://github.com/aws-powertools/powertools-lambda-python/issues/6995))
+* **deps-dev:** bump boto3-stubs from 1.39.8 to 1.39.9 ([#7011](https://github.com/aws-powertools/powertools-lambda-python/issues/7011))
+* **deps-dev:** bump boto3-stubs from 1.39.11 to 1.39.12 ([#7027](https://github.com/aws-powertools/powertools-lambda-python/issues/7027))
+* **deps-dev:** bump testcontainers from 4.10.0 to 4.12.0 ([#7021](https://github.com/aws-powertools/powertools-lambda-python/issues/7021))
+* **deps-dev:** bump boto3-stubs from 1.39.7 to 1.39.8 ([#7006](https://github.com/aws-powertools/powertools-lambda-python/issues/7006))
+* **deps-dev:** bump ruff from 0.12.3 to 0.12.4 ([#7005](https://github.com/aws-powertools/powertools-lambda-python/issues/7005))
+* **deps-dev:** bump aws-cdk from 2.1021.0 to 2.1022.0 ([#7031](https://github.com/aws-powertools/powertools-lambda-python/issues/7031))
+* **deps-dev:** bump aws-cdk-lib from 2.206.0 to 2.207.0 ([#7035](https://github.com/aws-powertools/powertools-lambda-python/issues/7035))
+* **deps-dev:** bump coverage from 7.9.2 to 7.10.0 ([#7033](https://github.com/aws-powertools/powertools-lambda-python/issues/7033))
+* **deps-dev:** bump sentry-sdk from 2.33.0 to 2.33.2 ([#7023](https://github.com/aws-powertools/powertools-lambda-python/issues/7023))
+* **deps-dev:** bump aws-cdk-lib from 2.205.0 to 2.206.0 ([#6996](https://github.com/aws-powertools/powertools-lambda-python/issues/6996))
+* **deps-dev:** bump boto3-stubs from 1.39.4 to 1.39.7 ([#6994](https://github.com/aws-powertools/powertools-lambda-python/issues/6994))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.205.0a0 to 2.206.0a0 ([#6993](https://github.com/aws-powertools/powertools-lambda-python/issues/6993))
+* **deps-dev:** bump aws-cdk from 2.1020.2 to 2.1021.0 ([#6992](https://github.com/aws-powertools/powertools-lambda-python/issues/6992))
+* **deps-dev:** bump boto3-stubs from 1.39.12 to 1.39.13 ([#7036](https://github.com/aws-powertools/powertools-lambda-python/issues/7036))
+* **deps-dev:** bump ruff from 0.12.4 to 0.12.5 ([#7032](https://github.com/aws-powertools/powertools-lambda-python/issues/7032))
+* **deps-dev:** bump sentry-sdk from 2.32.0 to 2.33.0 ([#6988](https://github.com/aws-powertools/powertools-lambda-python/issues/6988))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.204.0a0 to 2.205.0a0 ([#6986](https://github.com/aws-powertools/powertools-lambda-python/issues/6986))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.206.0a0 to 2.207.0a0 ([#7037](https://github.com/aws-powertools/powertools-lambda-python/issues/7037))
+* **deps-dev:** bump boto3-stubs from 1.39.13 to 1.39.14 ([#7042](https://github.com/aws-powertools/powertools-lambda-python/issues/7042))
+* **deps-dev:** bump boto3-stubs from 1.39.9 to 1.39.11 ([#7022](https://github.com/aws-powertools/powertools-lambda-python/issues/7022))
+
+
+<a name="v3.17.0"></a>
+## [v3.17.0] - 2025-07-15
+## Bug Fixes
+
+* enable response compression when using multi-value headers ([#6936](https://github.com/aws-powertools/powertools-lambda-python/issues/6936))
+
+## Documentation
+
+* **event-handler:** remove Amplify transformers section ([#6937](https://github.com/aws-powertools/powertools-lambda-python/issues/6937))
+* **event_handler:** revert deleted file ([#6947](https://github.com/aws-powertools/powertools-lambda-python/issues/6947))
+* **roadmap:** update roadmap items ([#6955](https://github.com/aws-powertools/powertools-lambda-python/issues/6955))
+* **we_made_this:** add MCP server template ([#6851](https://github.com/aws-powertools/powertools-lambda-python/issues/6851))
+
+## Features
+
+* **event_handler:** add support for externalDocs attribute in OpenAPI schema ([#6945](https://github.com/aws-powertools/powertools-lambda-python/issues/6945))
+* **parser:** Added Cognito trigger schemas ([#6737](https://github.com/aws-powertools/powertools-lambda-python/issues/6737))
+
+## Maintenance
+
+* version bump
+* **ci:** fix ssm workflow ([#6980](https://github.com/aws-powertools/powertools-lambda-python/issues/6980))
+* **ci:** new pre-release 3.16.1a7 ([#6974](https://github.com/aws-powertools/powertools-lambda-python/issues/6974))
+* **ci:** new pre-release 3.16.1a6 ([#6969](https://github.com/aws-powertools/powertools-lambda-python/issues/6969))
+* **ci:** new pre-release 3.16.1a5 ([#6967](https://github.com/aws-powertools/powertools-lambda-python/issues/6967))
+* **ci:** new pre-release 3.16.1a1 ([#6943](https://github.com/aws-powertools/powertools-lambda-python/issues/6943))
+* **ci:** new pre-release 3.16.1a4 ([#6964](https://github.com/aws-powertools/powertools-lambda-python/issues/6964))
+* **ci:** new pre-release 3.16.1a0 ([#6933](https://github.com/aws-powertools/powertools-lambda-python/issues/6933))
+* **ci:** new pre-release 3.16.1a2 ([#6954](https://github.com/aws-powertools/powertools-lambda-python/issues/6954))
+* **ci:** new pre-release 3.16.1a3 ([#6959](https://github.com/aws-powertools/powertools-lambda-python/issues/6959))
+* **deps:** bump aws-encryption-sdk from 4.0.1 to 4.0.2 ([#6932](https://github.com/aws-powertools/powertools-lambda-python/issues/6932))
+* **deps:** bump mkdocs-llmstxt from 0.2.0 to 0.3.0 in /docs ([#6979](https://github.com/aws-powertools/powertools-lambda-python/issues/6979))
+* **deps:** bump mkdocs-material from 9.6.14 to 9.6.15 ([#6931](https://github.com/aws-powertools/powertools-lambda-python/issues/6931))
+* **deps:** bump mkdocs-llmstxt from 0.2.0 to 0.3.0 ([#6978](https://github.com/aws-powertools/powertools-lambda-python/issues/6978))
+* **deps:** bump typing-extensions from 4.14.0 to 4.14.1 ([#6951](https://github.com/aws-powertools/powertools-lambda-python/issues/6951))
+* **deps-dev:** bump types-python-dateutil from 2.9.0.20250516 to 2.9.0.20250708 ([#6962](https://github.com/aws-powertools/powertools-lambda-python/issues/6962))
+* **deps-dev:** bump aws-cdk-lib from 2.203.1 to 2.204.0 ([#6949](https://github.com/aws-powertools/powertools-lambda-python/issues/6949))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.203.1a0 to 2.204.0a0 ([#6950](https://github.com/aws-powertools/powertools-lambda-python/issues/6950))
+* **deps-dev:** bump bandit from 1.8.5 to 1.8.6 ([#6957](https://github.com/aws-powertools/powertools-lambda-python/issues/6957))
+* **deps-dev:** bump boto3-stubs from 1.39.2 to 1.39.3 ([#6940](https://github.com/aws-powertools/powertools-lambda-python/issues/6940))
+* **deps-dev:** bump coverage from 7.9.1 to 7.9.2 ([#6941](https://github.com/aws-powertools/powertools-lambda-python/issues/6941))
+* **deps-dev:** bump aws-cdk from 2.1020.1 to 2.1020.2 ([#6942](https://github.com/aws-powertools/powertools-lambda-python/issues/6942))
+* **deps-dev:** bump ruff from 0.12.1 to 0.12.2 ([#6938](https://github.com/aws-powertools/powertools-lambda-python/issues/6938))
+* **deps-dev:** bump types-protobuf from 6.30.2.20250516 to 6.30.2.20250703 ([#6939](https://github.com/aws-powertools/powertools-lambda-python/issues/6939))
+* **deps-dev:** bump cfn-lint from 1.37.0 to 1.37.1 ([#6958](https://github.com/aws-powertools/powertools-lambda-python/issues/6958))
+* **deps-dev:** bump cfn-lint from 1.37.1 to 1.37.2 ([#6963](https://github.com/aws-powertools/powertools-lambda-python/issues/6963))
+* **deps-dev:** bump boto3-stubs from 1.39.3 to 1.39.4 ([#6966](https://github.com/aws-powertools/powertools-lambda-python/issues/6966))
+* **deps-dev:** bump ruff from 0.12.2 to 0.12.3 ([#6971](https://github.com/aws-powertools/powertools-lambda-python/issues/6971))
+* **deps-dev:** bump mypy from 1.16.1 to 1.17.0 ([#6977](https://github.com/aws-powertools/powertools-lambda-python/issues/6977))
+* **deps-dev:** bump aws-cdk-lib from 2.203.0 to 2.203.1 ([#6928](https://github.com/aws-powertools/powertools-lambda-python/issues/6928))
+* **deps-dev:** bump boto3-stubs from 1.39.1 to 1.39.2 ([#6930](https://github.com/aws-powertools/powertools-lambda-python/issues/6930))
+* **deps-dev:** bump aws-cdk from 2.1020.0 to 2.1020.1 ([#6927](https://github.com/aws-powertools/powertools-lambda-python/issues/6927))
+* **deps-dev:** bump cfn-lint from 1.37.2 to 1.38.0 ([#6976](https://github.com/aws-powertools/powertools-lambda-python/issues/6976))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.203.0a0 to 2.203.1a0 ([#6929](https://github.com/aws-powertools/powertools-lambda-python/issues/6929))
+
+
+<a name="v3.16.0"></a>
+## [v3.16.0] - 2025-07-02
+## Bug Fixes
+
+* **event_source:** fix decode headers with signed bytes ([#6878](https://github.com/aws-powertools/powertools-lambda-python/issues/6878))
+* **logger:** caplog working with parent Logger ([#6847](https://github.com/aws-powertools/powertools-lambda-python/issues/6847))
+* **logger:** fix exception on flush without buffer ([#6794](https://github.com/aws-powertools/powertools-lambda-python/issues/6794))
+
+## Documentation
+
+* **kafka:** refactor kafka documentation ([#6854](https://github.com/aws-powertools/powertools-lambda-python/issues/6854))
+
+## Features
+
+* **ci:** Partition workflow scripts updated to work ([#6900](https://github.com/aws-powertools/powertools-lambda-python/issues/6900))
+* **ci:** Deploy to AWS China partitions ([#6867](https://github.com/aws-powertools/powertools-lambda-python/issues/6867))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.15.2a6 ([#6923](https://github.com/aws-powertools/powertools-lambda-python/issues/6923))
+* **ci:** incorporate SSM update workflow into release pipeline ([#6914](https://github.com/aws-powertools/powertools-lambda-python/issues/6914))
+* **ci:** new pre-release 3.15.2a3 ([#6876](https://github.com/aws-powertools/powertools-lambda-python/issues/6876))
+* **ci:** new pre-release 3.15.2a2 ([#6865](https://github.com/aws-powertools/powertools-lambda-python/issues/6865))
+* **ci:** new pre-release 3.15.2a5 ([#6910](https://github.com/aws-powertools/powertools-lambda-python/issues/6910))
+* **ci:** new pre-release 3.15.2a4 ([#6881](https://github.com/aws-powertools/powertools-lambda-python/issues/6881))
+* **ci:** pinning versions in actions + refactor tests ([#6904](https://github.com/aws-powertools/powertools-lambda-python/issues/6904))
+* **ci:** stop publishing to gh-pages branch ([#6903](https://github.com/aws-powertools/powertools-lambda-python/issues/6903))
+* **ci:** stop publishing to gh-pages branch ([#6902](https://github.com/aws-powertools/powertools-lambda-python/issues/6902))
+* **ci:** stop publishing to gh-pages branch ([#6901](https://github.com/aws-powertools/powertools-lambda-python/issues/6901))
+* **ci:** stop publishing to gh-pages branch ([#6899](https://github.com/aws-powertools/powertools-lambda-python/issues/6899))
+* **ci:** remove v2 deployment files ([#6895](https://github.com/aws-powertools/powertools-lambda-python/issues/6895))
+* **ci:** bump urllib3 version ([#6893](https://github.com/aws-powertools/powertools-lambda-python/issues/6893))
+* **ci:** new pre-release 3.15.2a0 ([#6852](https://github.com/aws-powertools/powertools-lambda-python/issues/6852))
+* **ci:** refactor thread safe tests ([#6889](https://github.com/aws-powertools/powertools-lambda-python/issues/6889))
+* **ci:** new pre-release 3.15.2a1 ([#6860](https://github.com/aws-powertools/powertools-lambda-python/issues/6860))
+* **ci:** fix command to replace layer number ([#6868](https://github.com/aws-powertools/powertools-lambda-python/issues/6868))
+* **deps:** bump docker/setup-buildx-action from 3.10.0 to 3.11.1 ([#6823](https://github.com/aws-powertools/powertools-lambda-python/issues/6823))
+* **deps:** bump pydantic from 2.11.5 to 2.11.7 ([#6844](https://github.com/aws-powertools/powertools-lambda-python/issues/6844))
+* **deps:** bump mkdocs-material from 9.6.14 to 9.6.15 in /docs ([#6920](https://github.com/aws-powertools/powertools-lambda-python/issues/6920))
+* **deps:** bump redis from 5.3.0 to 6.2.0 ([#6827](https://github.com/aws-powertools/powertools-lambda-python/issues/6827))
+* **deps:** bump pydantic-settings from 2.9.1 to 2.10.1 ([#6872](https://github.com/aws-powertools/powertools-lambda-python/issues/6872))
+* **deps:** bump datadog-lambda from 6.110.0 to 6.111.0 ([#6857](https://github.com/aws-powertools/powertools-lambda-python/issues/6857))
+* **deps:** bump valkey-glide from 1.3.5 to 2.0.1 ([#6871](https://github.com/aws-powertools/powertools-lambda-python/issues/6871))
+* **deps:** bump squidfunk/mkdocs-material from `eb04b60` to `0bfdba4` in /docs ([#6915](https://github.com/aws-powertools/powertools-lambda-python/issues/6915))
+* **deps:** bump mkdocs-material from 9.5.50 to 9.6.14 in /docs ([#6908](https://github.com/aws-powertools/powertools-lambda-python/issues/6908))
+* **deps-dev:** bump sentry-sdk from 2.29.1 to 2.31.0 ([#6870](https://github.com/aws-powertools/powertools-lambda-python/issues/6870))
+* **deps-dev:** bump aws-cdk from 2.1019.1 to 2.1019.2 ([#6875](https://github.com/aws-powertools/powertools-lambda-python/issues/6875))
+* **deps-dev:** bump pytest from 8.4.0 to 8.4.1 ([#6874](https://github.com/aws-powertools/powertools-lambda-python/issues/6874))
+* **deps-dev:** bump cfn-lint from 1.35.4 to 1.36.1 ([#6855](https://github.com/aws-powertools/powertools-lambda-python/issues/6855))
+* **deps-dev:** bump boto3-stubs from 1.38.42 to 1.38.43 ([#6864](https://github.com/aws-powertools/powertools-lambda-python/issues/6864))
+* **deps-dev:** bump bandit from 1.8.3 to 1.8.5 ([#6856](https://github.com/aws-powertools/powertools-lambda-python/issues/6856))
+* **deps-dev:** bump boto3-stubs from 1.38.43 to 1.38.44 ([#6873](https://github.com/aws-powertools/powertools-lambda-python/issues/6873))
+* **deps-dev:** bump aws-cdk from 2.1018.1 to 2.1019.1 ([#6837](https://github.com/aws-powertools/powertools-lambda-python/issues/6837))
+* **deps-dev:** bump boto3-stubs from 1.38.41 to 1.38.42 ([#6858](https://github.com/aws-powertools/powertools-lambda-python/issues/6858))
+* **deps-dev:** bump boto3-stubs from 1.38.45 to 1.38.46 ([#6884](https://github.com/aws-powertools/powertools-lambda-python/issues/6884))
+* **deps-dev:** bump sentry-sdk from 2.31.0 to 2.32.0 ([#6885](https://github.com/aws-powertools/powertools-lambda-python/issues/6885))
+* **deps-dev:** bump ruff from 0.11.8 to 0.12.1 ([#6879](https://github.com/aws-powertools/powertools-lambda-python/issues/6879))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.202.0a0 to 2.203.0a0 ([#6919](https://github.com/aws-powertools/powertools-lambda-python/issues/6919))
+* **deps-dev:** bump mypy-boto3-appconfigdata from 1.38.0 to 1.39.0 in the boto-typing group ([#6905](https://github.com/aws-powertools/powertools-lambda-python/issues/6905))
+* **deps-dev:** bump pytest-xdist from 3.7.0 to 3.8.0 ([#6921](https://github.com/aws-powertools/powertools-lambda-python/issues/6921))
+* **deps-dev:** bump mypy from 1.16.0 to 1.16.1 ([#6828](https://github.com/aws-powertools/powertools-lambda-python/issues/6828))
+* **deps-dev:** bump boto3-stubs from 1.39.0 to 1.39.1 ([#6916](https://github.com/aws-powertools/powertools-lambda-python/issues/6916))
+* **deps-dev:** bump boto3-stubs from 1.38.34 to 1.38.41 ([#6845](https://github.com/aws-powertools/powertools-lambda-python/issues/6845))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.200.1a0 to 2.202.0a0 ([#6846](https://github.com/aws-powertools/powertools-lambda-python/issues/6846))
+* **deps-dev:** bump aws-cdk from 2.1019.2 to 2.1020.0 ([#6917](https://github.com/aws-powertools/powertools-lambda-python/issues/6917))
+* **deps-dev:** bump cfn-lint from 1.36.1 to 1.37.0 ([#6918](https://github.com/aws-powertools/powertools-lambda-python/issues/6918))
+* **deps-dev:** bump boto3-stubs from 1.38.44 to 1.38.45 ([#6880](https://github.com/aws-powertools/powertools-lambda-python/issues/6880))
+
+
+<a name="v3.15.1"></a>
+## [v3.15.1] - 2025-06-20
+## Features
+
+* **kafka:** add logic to handle protobuf deserialization ([#6841](https://github.com/aws-powertools/powertools-lambda-python/issues/6841))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.15.1a0 ([#6839](https://github.com/aws-powertools/powertools-lambda-python/issues/6839))
+
+
+<a name="v3.15.0"></a>
+## [v3.15.0] - 2025-06-19
+## Bug Fixes
+
+* **bedrock_agent:** fix querystring field resolution ([#6777](https://github.com/aws-powertools/powertools-lambda-python/issues/6777))
+
+## Documentation
+
+* **kafka:** add kafka documentation ([#6834](https://github.com/aws-powertools/powertools-lambda-python/issues/6834))
+* **public_reference:** add Instil as a public reference ([#6763](https://github.com/aws-powertools/powertools-lambda-python/issues/6763))
+
+## Features
+
+* **kafka:** add support for Confluence Producers ([#6833](https://github.com/aws-powertools/powertools-lambda-python/issues/6833))
+* **kafka:** New Kafka utility ([#6821](https://github.com/aws-powertools/powertools-lambda-python/issues/6821))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.14.1a6 ([#6830](https://github.com/aws-powertools/powertools-lambda-python/issues/6830))
+* **ci:** new pre-release 3.14.1a5 ([#6820](https://github.com/aws-powertools/powertools-lambda-python/issues/6820))
+* **ci:** new pre-release 3.14.1a0 ([#6773](https://github.com/aws-powertools/powertools-lambda-python/issues/6773))
+* **ci:** new pre-release 3.14.1a4 ([#6812](https://github.com/aws-powertools/powertools-lambda-python/issues/6812))
+* **ci:** new pre-release 3.14.1a3 ([#6797](https://github.com/aws-powertools/powertools-lambda-python/issues/6797))
+* **ci:** new pre-release 3.14.1a1 ([#6778](https://github.com/aws-powertools/powertools-lambda-python/issues/6778))
+* **ci:** new pre-release 3.14.1a2 ([#6788](https://github.com/aws-powertools/powertools-lambda-python/issues/6788))
+* **deps:** bump mkdocstrings-python from 1.16.11 to 1.16.12 in /docs ([#6768](https://github.com/aws-powertools/powertools-lambda-python/issues/6768))
+* **deps:** bump mkdocstrings-python from 1.16.11 to 1.16.12 ([#6765](https://github.com/aws-powertools/powertools-lambda-python/issues/6765))
+* **deps:** bump protobuf from 6.31.0 to 6.31.1 ([#6815](https://github.com/aws-powertools/powertools-lambda-python/issues/6815))
+* **deps-dev:** bump boto3-stubs from 1.38.29 to 1.38.30 ([#6772](https://github.com/aws-powertools/powertools-lambda-python/issues/6772))
+* **deps-dev:** bump aws-cdk from 2.1017.1 to 2.1018.0 ([#6775](https://github.com/aws-powertools/powertools-lambda-python/issues/6775))
+* **deps-dev:** bump boto3-stubs from 1.38.33 to 1.38.35 ([#6796](https://github.com/aws-powertools/powertools-lambda-python/issues/6796))
+* **deps-dev:** bump aws-cdk from 2.1018.0 to 2.1018.1 ([#6803](https://github.com/aws-powertools/powertools-lambda-python/issues/6803))
+* **deps-dev:** bump boto3-stubs from 1.38.30 to 1.38.31 ([#6776](https://github.com/aws-powertools/powertools-lambda-python/issues/6776))
+* **deps-dev:** bump requests from 2.32.3 to 2.32.4 ([#6789](https://github.com/aws-powertools/powertools-lambda-python/issues/6789))
+* **deps-dev:** bump boto3-stubs from 1.38.28 to 1.38.29 ([#6764](https://github.com/aws-powertools/powertools-lambda-python/issues/6764))
+* **deps-dev:** bump ruff from 0.11.12 to 0.11.13 ([#6780](https://github.com/aws-powertools/powertools-lambda-python/issues/6780))
+* **deps-dev:** bump boto3-stubs from 1.38.31 to 1.38.33 ([#6786](https://github.com/aws-powertools/powertools-lambda-python/issues/6786))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.200.0a0 to 2.200.1a0 ([#6766](https://github.com/aws-powertools/powertools-lambda-python/issues/6766))
+* **deps-dev:** bump aws-cdk-lib from 2.200.0 to 2.200.1 ([#6767](https://github.com/aws-powertools/powertools-lambda-python/issues/6767))
+* **deps-dev:** bump pytest-cov from 6.1.1 to 6.2.1 ([#6800](https://github.com/aws-powertools/powertools-lambda-python/issues/6800))
+* **deps-dev:** bump requests from 2.32.3 to 2.32.4 ([#6787](https://github.com/aws-powertools/powertools-lambda-python/issues/6787))
+
+
+<a name="v3.14.0"></a>
+## [v3.14.0] - 2025-06-03
+## Bug Fixes
+
+* **event_handler:** fix OpenAPI schema response for disabled validation ([#6720](https://github.com/aws-powertools/powertools-lambda-python/issues/6720))
+
+## Features
+
+* **bedrock_agent:** add new Amazon Bedrock Agents Functions Resolver ([#6564](https://github.com/aws-powertools/powertools-lambda-python/issues/6564))
+* **event_handler:** enable support for custom deserializer to parse the request body ([#6601](https://github.com/aws-powertools/powertools-lambda-python/issues/6601))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.13.1a7 ([#6759](https://github.com/aws-powertools/powertools-lambda-python/issues/6759))
+* **ci:** new pre-release 3.13.1a0 ([#6696](https://github.com/aws-powertools/powertools-lambda-python/issues/6696))
+* **ci:** new pre-release 3.13.1a6 ([#6751](https://github.com/aws-powertools/powertools-lambda-python/issues/6751))
+* **ci:** new pre-release 3.13.1a1 ([#6704](https://github.com/aws-powertools/powertools-lambda-python/issues/6704))
+* **ci:** new pre-release 3.13.1a2 ([#6709](https://github.com/aws-powertools/powertools-lambda-python/issues/6709))
+* **ci:** new pre-release 3.13.1a5 ([#6744](https://github.com/aws-powertools/powertools-lambda-python/issues/6744))
+* **ci:** new pre-release 3.13.1a4 ([#6738](https://github.com/aws-powertools/powertools-lambda-python/issues/6738))
+* **ci:** add missing dependency to build docs ([#6717](https://github.com/aws-powertools/powertools-lambda-python/issues/6717))
+* **ci:** new pre-release 3.13.1a3 ([#6732](https://github.com/aws-powertools/powertools-lambda-python/issues/6732))
+* **deps:** bump pydantic from 2.11.4 to 2.11.5 ([#6711](https://github.com/aws-powertools/powertools-lambda-python/issues/6711))
+* **deps:** bump mkdocstrings-python from 1.16.10 to 1.16.11 ([#6724](https://github.com/aws-powertools/powertools-lambda-python/issues/6724))
+* **deps:** bump redis from 6.1.0 to 6.2.0 ([#6736](https://github.com/aws-powertools/powertools-lambda-python/issues/6736))
+* **deps:** bump ossf/scorecard-action from 2.4.1 to 2.4.2 ([#6746](https://github.com/aws-powertools/powertools-lambda-python/issues/6746))
+* **deps:** bump mkdocstrings-python from 1.16.10 to 1.16.11 in /docs ([#6722](https://github.com/aws-powertools/powertools-lambda-python/issues/6722))
+* **deps:** bump datadog-lambda from 6.109.0 to 6.110.0 ([#6714](https://github.com/aws-powertools/powertools-lambda-python/issues/6714))
+* **deps-dev:** bump pytest-mock from 3.14.0 to 3.14.1 ([#6723](https://github.com/aws-powertools/powertools-lambda-python/issues/6723))
+* **deps-dev:** bump pytest-xdist from 3.6.1 to 3.7.0 ([#6730](https://github.com/aws-powertools/powertools-lambda-python/issues/6730))
+* **deps-dev:** bump aws-cdk-lib from 2.198.0 to 2.199.0 ([#6731](https://github.com/aws-powertools/powertools-lambda-python/issues/6731))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.197.0a0 to 2.198.0a0 ([#6715](https://github.com/aws-powertools/powertools-lambda-python/issues/6715))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.198.0a0 to 2.199.0a0 ([#6729](https://github.com/aws-powertools/powertools-lambda-python/issues/6729))
+* **deps-dev:** bump coverage from 7.8.1 to 7.8.2 ([#6713](https://github.com/aws-powertools/powertools-lambda-python/issues/6713))
+* **deps-dev:** bump boto3-stubs from 1.38.22 to 1.38.23 ([#6712](https://github.com/aws-powertools/powertools-lambda-python/issues/6712))
+* **deps-dev:** bump aws-cdk from 2.1016.1 to 2.1017.0 ([#6734](https://github.com/aws-powertools/powertools-lambda-python/issues/6734))
+* **deps-dev:** bump boto3-stubs from 1.38.23 to 1.38.25 ([#6735](https://github.com/aws-powertools/powertools-lambda-python/issues/6735))
+* **deps-dev:** bump ruff from 0.11.11 to 0.11.12 ([#6741](https://github.com/aws-powertools/powertools-lambda-python/issues/6741))
+* **deps-dev:** bump boto3-stubs from 1.38.25 to 1.38.26 ([#6742](https://github.com/aws-powertools/powertools-lambda-python/issues/6742))
+* **deps-dev:** bump cfn-lint from 1.35.1 to 1.35.3 ([#6708](https://github.com/aws-powertools/powertools-lambda-python/issues/6708))
+* **deps-dev:** bump ruff from 0.11.10 to 0.11.11 ([#6706](https://github.com/aws-powertools/powertools-lambda-python/issues/6706))
+* **deps-dev:** bump boto3-stubs from 1.38.21 to 1.38.22 ([#6707](https://github.com/aws-powertools/powertools-lambda-python/issues/6707))
+* **deps-dev:** bump aws-cdk from 2.1016.0 to 2.1016.1 ([#6703](https://github.com/aws-powertools/powertools-lambda-python/issues/6703))
+* **deps-dev:** bump aws-cdk from 2.1017.0 to 2.1017.1 ([#6748](https://github.com/aws-powertools/powertools-lambda-python/issues/6748))
+* **deps-dev:** bump boto3-stubs from 1.38.26 to 1.38.27 ([#6747](https://github.com/aws-powertools/powertools-lambda-python/issues/6747))
+* **deps-dev:** bump coverage from 7.8.0 to 7.8.1 ([#6701](https://github.com/aws-powertools/powertools-lambda-python/issues/6701))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.196.1a0 to 2.197.0a0 ([#6700](https://github.com/aws-powertools/powertools-lambda-python/issues/6700))
+* **deps-dev:** bump aws-cdk-lib from 2.196.1 to 2.197.0 ([#6699](https://github.com/aws-powertools/powertools-lambda-python/issues/6699))
+* **deps-dev:** bump pytest from 8.3.5 to 8.4.0 ([#6757](https://github.com/aws-powertools/powertools-lambda-python/issues/6757))
+* **deps-dev:** bump cfn-lint from 1.35.3 to 1.35.4 ([#6755](https://github.com/aws-powertools/powertools-lambda-python/issues/6755))
+* **deps-dev:** bump boto3-stubs from 1.38.27 to 1.38.28 ([#6756](https://github.com/aws-powertools/powertools-lambda-python/issues/6756))
+* **deps-dev:** bump aws-cdk-lib from 2.196.0 to 2.196.1 ([#6695](https://github.com/aws-powertools/powertools-lambda-python/issues/6695))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.196.0a0 to 2.196.1a0 ([#6694](https://github.com/aws-powertools/powertools-lambda-python/issues/6694))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.199.0a0 to 2.200.0a0 ([#6758](https://github.com/aws-powertools/powertools-lambda-python/issues/6758))
+* **deps-dev:** bump boto3-stubs from 1.38.19 to 1.38.21 ([#6698](https://github.com/aws-powertools/powertools-lambda-python/issues/6698))
+* **docs:** Add llms.txt to documentation ([#6693](https://github.com/aws-powertools/powertools-lambda-python/issues/6693))
+
+
+<a name="v3.13.0"></a>
+## [v3.13.0] - 2025-05-20
+## Code Refactoring
+
+* **idempotency:** replace Redis name with Cache and add valkey-glide support ([#6685](https://github.com/aws-powertools/powertools-lambda-python/issues/6685))
+
+## Features
+
+* **event_source:** add support for tumbling windows in Kinesis and DynamoDB events ([#6658](https://github.com/aws-powertools/powertools-lambda-python/issues/6658))
+* **event_source:** export SQSRecord in data_classes module ([#6639](https://github.com/aws-powertools/powertools-lambda-python/issues/6639))
+* **parser:** add support to decompress Kinesis CloudWatch logs in Kinesis envelope ([#6656](https://github.com/aws-powertools/powertools-lambda-python/issues/6656))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.12.1a2 ([#6638](https://github.com/aws-powertools/powertools-lambda-python/issues/6638))
+* **ci:** include allowed licenses file in dependency review workflow ([#6618](https://github.com/aws-powertools/powertools-lambda-python/issues/6618))
+* **ci:** new pre-release 3.12.1a8 ([#6683](https://github.com/aws-powertools/powertools-lambda-python/issues/6683))
+* **ci:** new pre-release 3.12.1a3 ([#6647](https://github.com/aws-powertools/powertools-lambda-python/issues/6647))
+* **ci:** new pre-release 3.12.1a7 ([#6675](https://github.com/aws-powertools/powertools-lambda-python/issues/6675))
+* **ci:** new pre-release 3.12.1a0 ([#6621](https://github.com/aws-powertools/powertools-lambda-python/issues/6621))
+* **ci:** new pre-release 3.12.1a6 ([#6670](https://github.com/aws-powertools/powertools-lambda-python/issues/6670))
+* **ci:** new pre-release 3.12.1a1 ([#6626](https://github.com/aws-powertools/powertools-lambda-python/issues/6626))
+* **ci:** new pre-release 3.12.1a4 ([#6655](https://github.com/aws-powertools/powertools-lambda-python/issues/6655))
+* **ci:** new pre-release 3.12.1a5 ([#6664](https://github.com/aws-powertools/powertools-lambda-python/issues/6664))
+* **deps:** bump aws-actions/configure-aws-credentials from 4.2.0 to 4.2.1 ([#6667](https://github.com/aws-powertools/powertools-lambda-python/issues/6667))
+* **deps:** bump squidfunk/mkdocs-material from `f6c81d5` to `eb04b60` in /docs ([#6659](https://github.com/aws-powertools/powertools-lambda-python/issues/6659))
+* **deps:** bump datadog-lambda from 6.107.0 to 6.108.0 ([#6634](https://github.com/aws-powertools/powertools-lambda-python/issues/6634))
+* **deps:** bump actions/setup-go from 5.4.0 to 5.5.0 ([#6630](https://github.com/aws-powertools/powertools-lambda-python/issues/6630))
+* **deps:** bump actions/dependency-review-action from 4.7.0 to 4.7.1 ([#6663](https://github.com/aws-powertools/powertools-lambda-python/issues/6663))
+* **deps:** bump redis from 5.2.1 to 6.1.0 ([#6662](https://github.com/aws-powertools/powertools-lambda-python/issues/6662))
+* **deps:** bump actions/dependency-review-action from 4.6.0 to 4.7.0 ([#6629](https://github.com/aws-powertools/powertools-lambda-python/issues/6629))
+* **deps:** bump codecov/codecov-action from 5.4.2 to 5.4.3 ([#6672](https://github.com/aws-powertools/powertools-lambda-python/issues/6672))
+* **deps:** bump squidfunk/mkdocs-material from `95f2ff4` to `f6c81d5` in /docs ([#6650](https://github.com/aws-powertools/powertools-lambda-python/issues/6650))
+* **deps:** bump aws-actions/configure-aws-credentials from 4.1.0 to 4.2.0 ([#6619](https://github.com/aws-powertools/powertools-lambda-python/issues/6619))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.24 to 3.0.25 ([#6686](https://github.com/aws-powertools/powertools-lambda-python/issues/6686))
+* **deps:** bump datadog-lambda from 6.108.0 to 6.109.0 ([#6641](https://github.com/aws-powertools/powertools-lambda-python/issues/6641))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.308 to 0.1.309 ([#6651](https://github.com/aws-powertools/powertools-lambda-python/issues/6651))
+* **deps-dev:** bump boto3-stubs from 1.38.12 to 1.38.13 ([#6644](https://github.com/aws-powertools/powertools-lambda-python/issues/6644))
+* **deps-dev:** bump cfn-lint from 1.35.0 to 1.35.1 ([#6642](https://github.com/aws-powertools/powertools-lambda-python/issues/6642))
+* **deps-dev:** bump ruff from 0.11.8 to 0.11.9 ([#6643](https://github.com/aws-powertools/powertools-lambda-python/issues/6643))
+* **deps-dev:** bump boto3-stubs from 1.38.13 to 1.38.14 ([#6653](https://github.com/aws-powertools/powertools-lambda-python/issues/6653))
+* **deps-dev:** bump sentry-sdk from 2.27.0 to 2.28.0 ([#6652](https://github.com/aws-powertools/powertools-lambda-python/issues/6652))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.194.0a0 to 2.195.0a0 ([#6635](https://github.com/aws-powertools/powertools-lambda-python/issues/6635))
+* **deps-dev:** bump aws-cdk from 2.1013.0 to 2.1014.0 ([#6636](https://github.com/aws-powertools/powertools-lambda-python/issues/6636))
+* **deps-dev:** bump mkdocs-material from 9.6.12 to 9.6.13 ([#6654](https://github.com/aws-powertools/powertools-lambda-python/issues/6654))
+* **deps-dev:** bump boto3-stubs from 1.38.11 to 1.38.12 ([#6633](https://github.com/aws-powertools/powertools-lambda-python/issues/6633))
+* **deps-dev:** bump aws-cdk-lib from 2.194.0 to 2.195.0 ([#6632](https://github.com/aws-powertools/powertools-lambda-python/issues/6632))
+* **deps-dev:** bump boto3-stubs from 1.38.14 to 1.38.15 ([#6660](https://github.com/aws-powertools/powertools-lambda-python/issues/6660))
+* **deps-dev:** bump ijson from 3.3.0 to 3.4.0 ([#6631](https://github.com/aws-powertools/powertools-lambda-python/issues/6631))
+* **deps-dev:** bump mkdocs-material from 9.6.13 to 9.6.14 ([#6661](https://github.com/aws-powertools/powertools-lambda-python/issues/6661))
+* **deps-dev:** bump boto3-stubs from 1.38.15 to 1.38.16 ([#6669](https://github.com/aws-powertools/powertools-lambda-python/issues/6669))
+* **deps-dev:** bump aws-cdk from 2.1014.0 to 2.1015.0 ([#6668](https://github.com/aws-powertools/powertools-lambda-python/issues/6668))
+* **deps-dev:** bump cfn-lint from 1.34.2 to 1.35.0 ([#6623](https://github.com/aws-powertools/powertools-lambda-python/issues/6623))
+* **deps-dev:** bump types-python-dateutil from 2.9.0.20241206 to 2.9.0.20250516 ([#6678](https://github.com/aws-powertools/powertools-lambda-python/issues/6678))
+* **deps-dev:** bump ruff from 0.11.9 to 0.11.10 ([#6673](https://github.com/aws-powertools/powertools-lambda-python/issues/6673))
+* **deps-dev:** bump boto3-stubs from 1.38.16 to 1.38.17 ([#6674](https://github.com/aws-powertools/powertools-lambda-python/issues/6674))
+* **deps-dev:** bump boto3-stubs from 1.38.9 to 1.38.10 ([#6620](https://github.com/aws-powertools/powertools-lambda-python/issues/6620))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.195.0a0 to 2.196.0a0 ([#6677](https://github.com/aws-powertools/powertools-lambda-python/issues/6677))
+* **deps-dev:** bump aws-cdk from 2.1015.0 to 2.1016.0 ([#6680](https://github.com/aws-powertools/powertools-lambda-python/issues/6680))
+* **deps-dev:** bump boto3-stubs from 1.38.18 to 1.38.19 ([#6687](https://github.com/aws-powertools/powertools-lambda-python/issues/6687))
+* **deps-dev:** bump boto3-stubs from 1.38.10 to 1.38.11 ([#6624](https://github.com/aws-powertools/powertools-lambda-python/issues/6624))
+
+
+<a name="v3.12.0"></a>
+## [v3.12.0] - 2025-05-06
+## Documentation
+
+* **appsync_events:** improve AppSync events documentation ([#6572](https://github.com/aws-powertools/powertools-lambda-python/issues/6572))
+* **community:** add Ran Isenberg blog post ([#6610](https://github.com/aws-powertools/powertools-lambda-python/issues/6610))
+* **i-made-this:** adding Michael's MCP server ([#6591](https://github.com/aws-powertools/powertools-lambda-python/issues/6591))
+
+## Features
+
+* **bedrock_agents:** add optional fields to response payload ([#6336](https://github.com/aws-powertools/powertools-lambda-python/issues/6336))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.11.1a5 ([#6598](https://github.com/aws-powertools/powertools-lambda-python/issues/6598))
+* **ci:** new pre-release 3.11.1a0 ([#6561](https://github.com/aws-powertools/powertools-lambda-python/issues/6561))
+* **ci:** new pre-release 3.11.1a6 ([#6606](https://github.com/aws-powertools/powertools-lambda-python/issues/6606))
+* **ci:** new pre-release 3.11.1a1 ([#6574](https://github.com/aws-powertools/powertools-lambda-python/issues/6574))
+* **ci:** new pre-release 3.11.1a2 ([#6578](https://github.com/aws-powertools/powertools-lambda-python/issues/6578))
+* **ci:** new pre-release 3.11.1a4 ([#6589](https://github.com/aws-powertools/powertools-lambda-python/issues/6589))
+* **ci:** new pre-release 3.11.1a3 ([#6582](https://github.com/aws-powertools/powertools-lambda-python/issues/6582))
+* **deps:** bump pydantic from 2.11.3 to 2.11.4 ([#6585](https://github.com/aws-powertools/powertools-lambda-python/issues/6585))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.23 to 3.0.24 ([#6611](https://github.com/aws-powertools/powertools-lambda-python/issues/6611))
+* **deps-dev:** bump ruff from 0.11.7 to 0.11.8 ([#6595](https://github.com/aws-powertools/powertools-lambda-python/issues/6595))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.306 to 0.1.307 ([#6580](https://github.com/aws-powertools/powertools-lambda-python/issues/6580))
+* **deps-dev:** bump boto3-stubs from 1.38.4 to 1.38.5 ([#6581](https://github.com/aws-powertools/powertools-lambda-python/issues/6581))
+* **deps-dev:** bump aws-cdk from 2.1012.0 to 2.1013.0 ([#6588](https://github.com/aws-powertools/powertools-lambda-python/issues/6588))
+* **deps-dev:** bump boto3-stubs from 1.38.6 to 1.38.7 ([#6594](https://github.com/aws-powertools/powertools-lambda-python/issues/6594))
+* **deps-dev:** bump boto3-stubs from 1.38.3 to 1.38.4 ([#6577](https://github.com/aws-powertools/powertools-lambda-python/issues/6577))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.307 to 0.1.308 ([#6597](https://github.com/aws-powertools/powertools-lambda-python/issues/6597))
+* **deps-dev:** bump h11 from 0.14.0 to 0.16.0 ([#6575](https://github.com/aws-powertools/powertools-lambda-python/issues/6575))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.192.0a0 to 2.193.0a0 ([#6586](https://github.com/aws-powertools/powertools-lambda-python/issues/6586))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.193.0a0 to 2.194.0a0 ([#6602](https://github.com/aws-powertools/powertools-lambda-python/issues/6602))
+* **deps-dev:** bump boto3-stubs from 1.38.2 to 1.38.3 ([#6569](https://github.com/aws-powertools/powertools-lambda-python/issues/6569))
+* **deps-dev:** bump cfn-lint from 1.34.1 to 1.34.2 ([#6568](https://github.com/aws-powertools/powertools-lambda-python/issues/6568))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.305 to 0.1.306 ([#6567](https://github.com/aws-powertools/powertools-lambda-python/issues/6567))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.191.0a0 to 2.192.0a0 ([#6566](https://github.com/aws-powertools/powertools-lambda-python/issues/6566))
+* **deps-dev:** bump aws-cdk-lib from 2.191.0 to 2.192.0 ([#6565](https://github.com/aws-powertools/powertools-lambda-python/issues/6565))
+* **deps-dev:** bump aws-cdk-lib from 2.193.0 to 2.194.0 ([#6603](https://github.com/aws-powertools/powertools-lambda-python/issues/6603))
+* **deps-dev:** bump boto3-stubs from 1.38.7 to 1.38.9 ([#6612](https://github.com/aws-powertools/powertools-lambda-python/issues/6612))
+* **deps-dev:** bump boto3-stubs from 1.38.5 to 1.38.6 ([#6587](https://github.com/aws-powertools/powertools-lambda-python/issues/6587))
+* **docs:** fix youtube embed link in we made this ([#6593](https://github.com/aws-powertools/powertools-lambda-python/issues/6593))
+
+
+<a name="v3.11.0"></a>
+## [v3.11.0] - 2025-04-24
+## Bug Fixes
+
+* **logger:** warn customers when the ALC log level is less verbose than log buffer ([#6509](https://github.com/aws-powertools/powertools-lambda-python/issues/6509))
+* **parser:** make key attribute optional in Kafka model ([#6523](https://github.com/aws-powertools/powertools-lambda-python/issues/6523))
+
+## Code Refactoring
+
+* **batch:** use standard collections for types ([#6475](https://github.com/aws-powertools/powertools-lambda-python/issues/6475))
+* **data_masking:** use standard collections for types ([#6493](https://github.com/aws-powertools/powertools-lambda-python/issues/6493))
+* **e2e-tests:** use standard collections for types + refactor code ([#6505](https://github.com/aws-powertools/powertools-lambda-python/issues/6505))
+* **event_handler:** use standard collections for types + refactor code ([#6495](https://github.com/aws-powertools/powertools-lambda-python/issues/6495))
+* **event_source:** use standard collections for types ([#6479](https://github.com/aws-powertools/powertools-lambda-python/issues/6479))
+* **feature_flags:** use standard collections for type ([#6489](https://github.com/aws-powertools/powertools-lambda-python/issues/6489))
+* **general:** add support for `ruff format` ([#6512](https://github.com/aws-powertools/powertools-lambda-python/issues/6512))
+* **idempotency:** use standard collections for types ([#6487](https://github.com/aws-powertools/powertools-lambda-python/issues/6487))
+* **logger:** use standard collections for types ([#6471](https://github.com/aws-powertools/powertools-lambda-python/issues/6471))
+* **metrics:** use standard collections for types ([#6472](https://github.com/aws-powertools/powertools-lambda-python/issues/6472))
+* **middleware_factory:** use standard collections for types ([#6485](https://github.com/aws-powertools/powertools-lambda-python/issues/6485))
+* **parameters:** use standard collections for types ([#6481](https://github.com/aws-powertools/powertools-lambda-python/issues/6481))
+* **streaming:** use standard collections for types ([#6483](https://github.com/aws-powertools/powertools-lambda-python/issues/6483))
+* **tests:** use standard collections for types + refactor code ([#6497](https://github.com/aws-powertools/powertools-lambda-python/issues/6497))
+* **tracer:** use standard collections for types ([#6473](https://github.com/aws-powertools/powertools-lambda-python/issues/6473))
+* **validation:** use standard collections for types ([#6491](https://github.com/aws-powertools/powertools-lambda-python/issues/6491))
+
+## Documentation
+
+* **bedrock:** fix BedrockServiceRole in template.yaml ([#6436](https://github.com/aws-powertools/powertools-lambda-python/issues/6436))
+* **bedrock_agents:** remove Pydantic v1 recommendation ([#6468](https://github.com/aws-powertools/powertools-lambda-python/issues/6468))
+* **event_handler:** add docs for AppSync event resolver ([#6557](https://github.com/aws-powertools/powertools-lambda-python/issues/6557))
+* **event_handler:** fix typo in api keys swagger url ([#6536](https://github.com/aws-powertools/powertools-lambda-python/issues/6536))
+
+## Features
+
+* **bedrock:** add `openapi_extensions` in BedrockAgentResolver ([#6510](https://github.com/aws-powertools/powertools-lambda-python/issues/6510))
+* **data-masking:** add support for Pydantic models, dataclasses, and standard classes ([#6413](https://github.com/aws-powertools/powertools-lambda-python/issues/6413))
+* **event_handler:** add AppSync events resolver ([#6558](https://github.com/aws-powertools/powertools-lambda-python/issues/6558))
+* **event_handler:** add extras HTTP Error Code Exceptions ([#6454](https://github.com/aws-powertools/powertools-lambda-python/issues/6454))
+* **event_handler:** add route-level custom response validation in OpenAPI utility ([#6341](https://github.com/aws-powertools/powertools-lambda-python/issues/6341))
+* **logger:** add support for exception notes ([#6465](https://github.com/aws-powertools/powertools-lambda-python/issues/6465))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.10.1a7 ([#6518](https://github.com/aws-powertools/powertools-lambda-python/issues/6518))
+* **ci:** new pre-release 3.10.1a0 ([#6431](https://github.com/aws-powertools/powertools-lambda-python/issues/6431))
+* **ci:** new pre-release 3.10.1a1 ([#6437](https://github.com/aws-powertools/powertools-lambda-python/issues/6437))
+* **ci:** new pre-release 3.10.1a2 ([#6446](https://github.com/aws-powertools/powertools-lambda-python/issues/6446))
+* **ci:** new pre-release 3.10.1a10 ([#6538](https://github.com/aws-powertools/powertools-lambda-python/issues/6538))
+* **ci:** new pre-release 3.10.1a3 ([#6455](https://github.com/aws-powertools/powertools-lambda-python/issues/6455))
+* **ci:** new pre-release 3.10.1a4 ([#6463](https://github.com/aws-powertools/powertools-lambda-python/issues/6463))
+* **ci:** new pre-release 3.10.1a9 ([#6533](https://github.com/aws-powertools/powertools-lambda-python/issues/6533))
+* **ci:** new pre-release 3.10.1a5 ([#6498](https://github.com/aws-powertools/powertools-lambda-python/issues/6498))
+* **ci:** new pre-release 3.10.1a11 ([#6546](https://github.com/aws-powertools/powertools-lambda-python/issues/6546))
+* **ci:** new pre-release 3.10.1a8 ([#6526](https://github.com/aws-powertools/powertools-lambda-python/issues/6526))
+* **ci:** new pre-release 3.10.1a6 ([#6506](https://github.com/aws-powertools/powertools-lambda-python/issues/6506))
+* **deps:** bump pydantic-settings from 2.8.1 to 2.9.1 ([#6530](https://github.com/aws-powertools/powertools-lambda-python/issues/6530))
+* **deps:** bump pydantic from 2.11.2 to 2.11.3 ([#6427](https://github.com/aws-powertools/powertools-lambda-python/issues/6427))
+* **deps:** bump squidfunk/mkdocs-material from sha256:23b69789b1dd836c53ea25b32f62ef8e1a23366037acd07c90959a219fd1f285 to sha256:95f2ff42251979c043d6cb5b1c82e6ae8189e57e02105813dd1ce124021a418b in /docs ([#6513](https://github.com/aws-powertools/powertools-lambda-python/issues/6513))
+* **deps:** bump actions/download-artifact from 4.2.1 to 4.3.0 ([#6550](https://github.com/aws-powertools/powertools-lambda-python/issues/6550))
+* **deps:** bump actions/setup-python from 5.5.0 to 5.6.0 ([#6549](https://github.com/aws-powertools/powertools-lambda-python/issues/6549))
+* **deps:** bump typing-extensions from 4.13.1 to 4.13.2 ([#6451](https://github.com/aws-powertools/powertools-lambda-python/issues/6451))
+* **deps:** bump actions/setup-node from 4.3.0 to 4.4.0 ([#6457](https://github.com/aws-powertools/powertools-lambda-python/issues/6457))
+* **deps:** bump codecov/codecov-action from 5.4.0 to 5.4.2 ([#6458](https://github.com/aws-powertools/powertools-lambda-python/issues/6458))
+* **deps-dev:** bump mkdocs-material from 9.6.11 to 9.6.12 ([#6514](https://github.com/aws-powertools/powertools-lambda-python/issues/6514))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.302 to 0.1.304 ([#6531](https://github.com/aws-powertools/powertools-lambda-python/issues/6531))
+* **deps-dev:** bump sentry-sdk from 2.25.1 to 2.26.1 ([#6477](https://github.com/aws-powertools/powertools-lambda-python/issues/6477))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.189.1a0 to 2.190.0a0 ([#6529](https://github.com/aws-powertools/powertools-lambda-python/issues/6529))
+* **deps-dev:** bump boto3-stubs from 1.37.37 to 1.37.38 ([#6537](https://github.com/aws-powertools/powertools-lambda-python/issues/6537))
+* **deps-dev:** bump aws-cdk-lib from 2.189.0 to 2.189.1 ([#6461](https://github.com/aws-powertools/powertools-lambda-python/issues/6461))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.189.0a0 to 2.189.1a0 ([#6462](https://github.com/aws-powertools/powertools-lambda-python/issues/6462))
+* **deps-dev:** bump boto3-stubs from 1.37.33 to 1.37.34 ([#6459](https://github.com/aws-powertools/powertools-lambda-python/issues/6459))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.301 to 0.1.302 ([#6460](https://github.com/aws-powertools/powertools-lambda-python/issues/6460))
+* **deps-dev:** bump cfn-lint from 1.34.0 to 1.34.1 ([#6528](https://github.com/aws-powertools/powertools-lambda-python/issues/6528))
+* **deps-dev:** bump cfn-lint from 1.33.2 to 1.34.0 ([#6502](https://github.com/aws-powertools/powertools-lambda-python/issues/6502))
+* **deps-dev:** bump aws-cdk from 2.1010.0 to 2.1012.0 ([#6540](https://github.com/aws-powertools/powertools-lambda-python/issues/6540))
+* **deps-dev:** bump mypy-boto3-appconfigdata from 1.37.0 to 1.38.0 in the boto-typing group ([#6541](https://github.com/aws-powertools/powertools-lambda-python/issues/6541))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.304 to 0.1.305 ([#6545](https://github.com/aws-powertools/powertools-lambda-python/issues/6545))
+* **deps-dev:** bump cfn-lint from 1.33.1 to 1.33.2 ([#6450](https://github.com/aws-powertools/powertools-lambda-python/issues/6450))
+* **deps-dev:** bump boto3-stubs from 1.37.31 to 1.37.33 ([#6449](https://github.com/aws-powertools/powertools-lambda-python/issues/6449))
+* **deps-dev:** bump boto3-stubs from 1.37.35 to 1.37.37 ([#6521](https://github.com/aws-powertools/powertools-lambda-python/issues/6521))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.190.0a0 to 2.191.0a0 ([#6543](https://github.com/aws-powertools/powertools-lambda-python/issues/6543))
+* **deps-dev:** bump h11 from 0.14.0 to 0.16.0 ([#6548](https://github.com/aws-powertools/powertools-lambda-python/issues/6548))
+* **deps-dev:** bump ruff from 0.11.4 to 0.11.5 ([#6443](https://github.com/aws-powertools/powertools-lambda-python/issues/6443))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.188.0a0 to 2.189.0a0 ([#6444](https://github.com/aws-powertools/powertools-lambda-python/issues/6444))
+* **deps-dev:** bump aws-cdk-lib from 2.188.0 to 2.189.0 ([#6445](https://github.com/aws-powertools/powertools-lambda-python/issues/6445))
+* **deps-dev:** bump cfn-lint from 1.33.0 to 1.33.1 ([#6442](https://github.com/aws-powertools/powertools-lambda-python/issues/6442))
+* **deps-dev:** bump ruff from 0.11.5 to 0.11.6 ([#6515](https://github.com/aws-powertools/powertools-lambda-python/issues/6515))
+* **deps-dev:** bump aws-cdk from 2.1007.0 to 2.1010.0 ([#6501](https://github.com/aws-powertools/powertools-lambda-python/issues/6501))
+* **deps-dev:** bump httpx from 0.25.1 to 0.28.1 ([#6554](https://github.com/aws-powertools/powertools-lambda-python/issues/6554))
+* **deps-dev:** bump boto3-stubs from 1.38.1 to 1.38.2 ([#6556](https://github.com/aws-powertools/powertools-lambda-python/issues/6556))
+* **deps-dev:** bump boto3-stubs from 1.37.29 to 1.37.31 ([#6433](https://github.com/aws-powertools/powertools-lambda-python/issues/6433))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.187.0a0 to 2.188.0a0 ([#6434](https://github.com/aws-powertools/powertools-lambda-python/issues/6434))
+* **deps-dev:** bump ruff from 0.11.3 to 0.11.4 ([#6428](https://github.com/aws-powertools/powertools-lambda-python/issues/6428))
+* **deps-dev:** bump pytest-cov from 6.1.0 to 6.1.1 ([#6429](https://github.com/aws-powertools/powertools-lambda-python/issues/6429))
+* **deps-dev:** bump cfn-lint from 1.32.4 to 1.33.0 ([#6430](https://github.com/aws-powertools/powertools-lambda-python/issues/6430))
+* **deps-dev:** bump multiprocess from 0.70.17 to 0.70.18 ([#6516](https://github.com/aws-powertools/powertools-lambda-python/issues/6516))
+* **deps-dev:** bump ruff from 0.11.6 to 0.11.7 ([#6555](https://github.com/aws-powertools/powertools-lambda-python/issues/6555))
+* **deps-dev:** bump sentry-sdk from 2.26.1 to 2.27.0 ([#6553](https://github.com/aws-powertools/powertools-lambda-python/issues/6553))
+* **deps-dev:** bump boto3-stubs from 1.37.34 to 1.37.35 ([#6504](https://github.com/aws-powertools/powertools-lambda-python/issues/6504))
+
+
+<a name="v3.10.0"></a>
+## [v3.10.0] - 2025-04-08
+## Bug Fixes
+
+* **event_source:** Added missing properties in APIGatewayWebSocketEvent class ([#6411](https://github.com/aws-powertools/powertools-lambda-python/issues/6411))
+* **event_source:** fix HomeDirectoryDetails type in TransferFamilyAuthorizerResponse method ([#6403](https://github.com/aws-powertools/powertools-lambda-python/issues/6403))
+* **logger:** improve behavior with `exc_info=True` to prevent errors ([#6417](https://github.com/aws-powertools/powertools-lambda-python/issues/6417))
+
+## Documentation
+
+* **homepage:** add SAR documentation ([#6347](https://github.com/aws-powertools/powertools-lambda-python/issues/6347))
+
+## Features
+
+* **parser:** add AppSyncResolver model ([#6400](https://github.com/aws-powertools/powertools-lambda-python/issues/6400))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.9.1a4 ([#6377](https://github.com/aws-powertools/powertools-lambda-python/issues/6377))
+* **ci:** new pre-release 3.9.1a8 ([#6415](https://github.com/aws-powertools/powertools-lambda-python/issues/6415))
+* **ci:** new pre-release 3.9.1a9 ([#6422](https://github.com/aws-powertools/powertools-lambda-python/issues/6422))
+* **ci:** new pre-release 3.9.1a0 ([#6354](https://github.com/aws-powertools/powertools-lambda-python/issues/6354))
+* **ci:** new pre-release 3.9.1a5 ([#6385](https://github.com/aws-powertools/powertools-lambda-python/issues/6385))
+* **ci:** new pre-release 3.9.1a7 ([#6401](https://github.com/aws-powertools/powertools-lambda-python/issues/6401))
+* **ci:** new pre-release 3.9.1a1 ([#6356](https://github.com/aws-powertools/powertools-lambda-python/issues/6356))
+* **ci:** new pre-release 3.9.1a2 ([#6364](https://github.com/aws-powertools/powertools-lambda-python/issues/6364))
+* **ci:** new pre-release 3.9.1a6 ([#6392](https://github.com/aws-powertools/powertools-lambda-python/issues/6392))
+* **ci:** new pre-release 3.9.1a3 ([#6369](https://github.com/aws-powertools/powertools-lambda-python/issues/6369))
+* **deps:** bump aws-encryption-sdk from 4.0.0 to 4.0.1 ([#6360](https://github.com/aws-powertools/powertools-lambda-python/issues/6360))
+* **deps:** bump pydantic from 2.11.1 to 2.11.2 ([#6395](https://github.com/aws-powertools/powertools-lambda-python/issues/6395))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.22 to 3.0.23 ([#6371](https://github.com/aws-powertools/powertools-lambda-python/issues/6371))
+* **deps:** bump squidfunk/mkdocs-material from `3555052` to `23b6978` in /docs ([#6404](https://github.com/aws-powertools/powertools-lambda-python/issues/6404))
+* **deps:** bump datadog-lambda from 6.106.0 to 6.107.0 ([#6405](https://github.com/aws-powertools/powertools-lambda-python/issues/6405))
+* **deps:** bump squidfunk/mkdocs-material from `f226a2d` to `3555052` in /docs ([#6372](https://github.com/aws-powertools/powertools-lambda-python/issues/6372))
+* **deps:** bump pydantic from 2.10.6 to 2.11.1 ([#6383](https://github.com/aws-powertools/powertools-lambda-python/issues/6383))
+* **deps:** bump typing-extensions from 4.12.2 to 4.13.1 ([#6418](https://github.com/aws-powertools/powertools-lambda-python/issues/6418))
+* **deps:** bump actions/setup-python from 5.4.0 to 5.5.0 ([#6349](https://github.com/aws-powertools/powertools-lambda-python/issues/6349))
+* **deps:** bump actions/dependency-review-action from 4.5.0 to 4.6.0 ([#6380](https://github.com/aws-powertools/powertools-lambda-python/issues/6380))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.186.0a0 to 2.187.0a0 ([#6382](https://github.com/aws-powertools/powertools-lambda-python/issues/6382))
+* **deps-dev:** bump pytest-cov from 6.0.0 to 6.1.0 ([#6381](https://github.com/aws-powertools/powertools-lambda-python/issues/6381))
+* **deps-dev:** bump coverage from 7.7.1 to 7.8.0 ([#6376](https://github.com/aws-powertools/powertools-lambda-python/issues/6376))
+* **deps-dev:** bump mkdocs-material from 9.6.9 to 9.6.10 ([#6375](https://github.com/aws-powertools/powertools-lambda-python/issues/6375))
+* **deps-dev:** bump boto3-stubs from 1.37.23 to 1.37.24 ([#6374](https://github.com/aws-powertools/powertools-lambda-python/issues/6374))
+* **deps-dev:** bump boto3-stubs from 1.37.24 to 1.37.25 ([#6384](https://github.com/aws-powertools/powertools-lambda-python/issues/6384))
+* **deps-dev:** bump sentry-sdk from 2.24.1 to 2.25.0 ([#6373](https://github.com/aws-powertools/powertools-lambda-python/issues/6373))
+* **deps-dev:** bump aws-cdk from 2.1006.0 to 2.1007.0 ([#6387](https://github.com/aws-powertools/powertools-lambda-python/issues/6387))
+* **deps-dev:** bump boto3-stubs from 1.37.25 to 1.37.26 ([#6389](https://github.com/aws-powertools/powertools-lambda-python/issues/6389))
+* **deps-dev:** bump sentry-sdk from 2.25.0 to 2.25.1 ([#6391](https://github.com/aws-powertools/powertools-lambda-python/issues/6391))
+* **deps-dev:** bump boto3-stubs from 1.37.22 to 1.37.23 ([#6366](https://github.com/aws-powertools/powertools-lambda-python/issues/6366))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.298 to 0.1.299 ([#6390](https://github.com/aws-powertools/powertools-lambda-python/issues/6390))
+* **deps-dev:** bump cfn-lint from 1.32.1 to 1.32.3 ([#6388](https://github.com/aws-powertools/powertools-lambda-python/issues/6388))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.185.0a0 to 2.186.0a0 ([#6363](https://github.com/aws-powertools/powertools-lambda-python/issues/6363))
+* **deps-dev:** bump boto3-stubs from 1.37.20 to 1.37.22 ([#6362](https://github.com/aws-powertools/powertools-lambda-python/issues/6362))
+* **deps-dev:** bump testcontainers from 4.9.2 to 4.10.0 ([#6397](https://github.com/aws-powertools/powertools-lambda-python/issues/6397))
+* **deps-dev:** bump mkdocstrings-python from 1.16.8 to 1.16.10 ([#6399](https://github.com/aws-powertools/powertools-lambda-python/issues/6399))
+* **deps-dev:** bump ruff from 0.11.2 to 0.11.3 ([#6398](https://github.com/aws-powertools/powertools-lambda-python/issues/6398))
+* **deps-dev:** bump boto3-stubs from 1.37.26 to 1.37.28 ([#6406](https://github.com/aws-powertools/powertools-lambda-python/issues/6406))
+* **deps-dev:** bump pytest-asyncio from 0.25.3 to 0.26.0 ([#6352](https://github.com/aws-powertools/powertools-lambda-python/issues/6352))
+* **deps-dev:** bump aws-cdk-lib from 2.187.0 to 2.188.0 ([#6407](https://github.com/aws-powertools/powertools-lambda-python/issues/6407))
+* **deps-dev:** bump cfn-lint from 1.32.0 to 1.32.1 ([#6351](https://github.com/aws-powertools/powertools-lambda-python/issues/6351))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.299 to 0.1.300 ([#6408](https://github.com/aws-powertools/powertools-lambda-python/issues/6408))
+* **deps-dev:** bump aws-cdk from 2.1005.0 to 2.1006.0 ([#6350](https://github.com/aws-powertools/powertools-lambda-python/issues/6350))
+* **deps-dev:** bump cfn-lint from 1.32.3 to 1.32.4 ([#6419](https://github.com/aws-powertools/powertools-lambda-python/issues/6419))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.300 to 0.1.301 ([#6420](https://github.com/aws-powertools/powertools-lambda-python/issues/6420))
+* **deps-dev:** bump boto3-stubs from 1.37.28 to 1.37.29 ([#6421](https://github.com/aws-powertools/powertools-lambda-python/issues/6421))
+* **deps-dev:** bump boto3-stubs from 1.37.19 to 1.37.20 ([#6353](https://github.com/aws-powertools/powertools-lambda-python/issues/6353))
+
+
+<a name="v3.9.0"></a>
+## [v3.9.0] - 2025-03-25
+## Bug Fixes
+
+* **idempotency:** include sk in error msgs when using composite key ([#6325](https://github.com/aws-powertools/powertools-lambda-python/issues/6325))
+* **metrics:** ensure proper type conversion for `DD_FLUSH_TO_LOG` env var ([#6280](https://github.com/aws-powertools/powertools-lambda-python/issues/6280))
+
+## Code Refactoring
+
+* **data_classes:** Add base class with common code ([#6297](https://github.com/aws-powertools/powertools-lambda-python/issues/6297))
+* **data_classes:** remove duplicated code ([#6288](https://github.com/aws-powertools/powertools-lambda-python/issues/6288))
+* **data_classes:** simplify nested data classes ([#6289](https://github.com/aws-powertools/powertools-lambda-python/issues/6289))
+* **tests:** add LambdaContext type in tests ([#6214](https://github.com/aws-powertools/powertools-lambda-python/issues/6214))
+
+## Documentation
+
+* **homepage:** update layer instructions link ([#6242](https://github.com/aws-powertools/powertools-lambda-python/issues/6242))
+* **public_reference:** add Guild as a public reference ([#6342](https://github.com/aws-powertools/powertools-lambda-python/issues/6342))
+
+## Features
+
+* **data_classes:** add API Gateway Websocket event ([#6287](https://github.com/aws-powertools/powertools-lambda-python/issues/6287))
+* **event_handler:** add custom method for OpenAPI configuration ([#6204](https://github.com/aws-powertools/powertools-lambda-python/issues/6204))
+* **event_handler:** add custom response validation in OpenAPI utility ([#6189](https://github.com/aws-powertools/powertools-lambda-python/issues/6189))
+* **general:** make logger, tracer and metrics utilities aware of provisioned concurrency ([#6324](https://github.com/aws-powertools/powertools-lambda-python/issues/6324))
+* **metrics:** allow change ColdStart function_name dimension ([#6315](https://github.com/aws-powertools/powertools-lambda-python/issues/6315))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.8.1a8 ([#6307](https://github.com/aws-powertools/powertools-lambda-python/issues/6307))
+* **ci:** new pre-release 3.8.1a11 ([#6340](https://github.com/aws-powertools/powertools-lambda-python/issues/6340))
+* **ci:** new pre-release 3.8.1a0 ([#6244](https://github.com/aws-powertools/powertools-lambda-python/issues/6244))
+* **ci:** new pre-release 3.8.1a10 ([#6332](https://github.com/aws-powertools/powertools-lambda-python/issues/6332))
+* **ci:** new pre-release 3.8.1a1 ([#6250](https://github.com/aws-powertools/powertools-lambda-python/issues/6250))
+* **ci:** new pre-release 3.8.1a2 ([#6253](https://github.com/aws-powertools/powertools-lambda-python/issues/6253))
+* **ci:** new pre-release 3.8.1a9 ([#6322](https://github.com/aws-powertools/powertools-lambda-python/issues/6322))
+* **ci:** new pre-release 3.8.1a3 ([#6259](https://github.com/aws-powertools/powertools-lambda-python/issues/6259))
+* **ci:** new pre-release 3.8.1a4 ([#6268](https://github.com/aws-powertools/powertools-lambda-python/issues/6268))
+* **ci:** Fix SAR pipeline ([#6313](https://github.com/aws-powertools/powertools-lambda-python/issues/6313))
+* **ci:** new pre-release 3.8.1a5 ([#6276](https://github.com/aws-powertools/powertools-lambda-python/issues/6276))
+* **ci:** new pre-release 3.8.1a6 ([#6290](https://github.com/aws-powertools/powertools-lambda-python/issues/6290))
+* **ci:** new pre-release 3.8.1a7 ([#6298](https://github.com/aws-powertools/powertools-lambda-python/issues/6298))
+* **deps:** bump actions/setup-go from 5.3.0 to 5.4.0 ([#6304](https://github.com/aws-powertools/powertools-lambda-python/issues/6304))
+* **deps:** bump actions/upload-artifact from 4.6.1 to 4.6.2 ([#6302](https://github.com/aws-powertools/powertools-lambda-python/issues/6302))
+* **deps:** bump squidfunk/mkdocs-material from `047452c` to `479a06a` in /docs ([#6261](https://github.com/aws-powertools/powertools-lambda-python/issues/6261))
+* **deps:** bump squidfunk/mkdocs-material from `479a06a` to `f226a2d` in /docs ([#6279](https://github.com/aws-powertools/powertools-lambda-python/issues/6279))
+* **deps:** bump actions/download-artifact from 4.1.9 to 4.2.0 ([#6294](https://github.com/aws-powertools/powertools-lambda-python/issues/6294))
+* **deps:** bump actions/download-artifact from 4.2.0 to 4.2.1 ([#6303](https://github.com/aws-powertools/powertools-lambda-python/issues/6303))
+* **deps:** bump actions/setup-node from 4.2.0 to 4.3.0 ([#6278](https://github.com/aws-powertools/powertools-lambda-python/issues/6278))
+* **deps-dev:** bump mkdocs-material from 9.6.7 to 9.6.8 ([#6264](https://github.com/aws-powertools/powertools-lambda-python/issues/6264))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.296 to 0.1.297 ([#6281](https://github.com/aws-powertools/powertools-lambda-python/issues/6281))
+* **deps-dev:** bump boto3-stubs from 1.37.12 to 1.37.14 ([#6282](https://github.com/aws-powertools/powertools-lambda-python/issues/6282))
+* **deps-dev:** bump aws-cdk from 2.1004.0 to 2.1005.0 ([#6301](https://github.com/aws-powertools/powertools-lambda-python/issues/6301))
+* **deps-dev:** bump boto3-stubs from 1.37.15 to 1.37.16 ([#6305](https://github.com/aws-powertools/powertools-lambda-python/issues/6305))
+* **deps-dev:** bump mkdocs-material from 9.6.8 to 9.6.9 ([#6285](https://github.com/aws-powertools/powertools-lambda-python/issues/6285))
+* **deps-dev:** bump cfn-lint from 1.31.0 to 1.31.3 ([#6306](https://github.com/aws-powertools/powertools-lambda-python/issues/6306))
+* **deps-dev:** bump ruff from 0.9.10 to 0.11.0 ([#6273](https://github.com/aws-powertools/powertools-lambda-python/issues/6273))
+* **deps-dev:** bump sentry-sdk from 2.24.0 to 2.24.1 ([#6339](https://github.com/aws-powertools/powertools-lambda-python/issues/6339))
+* **deps-dev:** bump aws-cdk-lib from 2.183.0 to 2.184.1 ([#6272](https://github.com/aws-powertools/powertools-lambda-python/issues/6272))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.183.0a0 to 2.184.1a0 ([#6271](https://github.com/aws-powertools/powertools-lambda-python/issues/6271))
+* **deps-dev:** bump filelock from 3.17.0 to 3.18.0 ([#6270](https://github.com/aws-powertools/powertools-lambda-python/issues/6270))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.184.1a0 to 2.185.0a0 ([#6317](https://github.com/aws-powertools/powertools-lambda-python/issues/6317))
+* **deps-dev:** bump boto3-stubs from 1.37.11 to 1.37.12 ([#6266](https://github.com/aws-powertools/powertools-lambda-python/issues/6266))
+* **deps-dev:** bump cfn-lint from 1.31.3 to 1.32.0 ([#6316](https://github.com/aws-powertools/powertools-lambda-python/issues/6316))
+* **deps-dev:** bump cfn-lint from 1.30.0 to 1.31.0 ([#6296](https://github.com/aws-powertools/powertools-lambda-python/issues/6296))
+* **deps-dev:** bump cfn-lint from 1.29.1 to 1.30.0 ([#6263](https://github.com/aws-powertools/powertools-lambda-python/issues/6263))
+* **deps-dev:** bump aws-cdk from 2.1003.0 to 2.1004.0 ([#6262](https://github.com/aws-powertools/powertools-lambda-python/issues/6262))
+* **deps-dev:** bump boto3-stubs from 1.37.14 to 1.37.15 ([#6295](https://github.com/aws-powertools/powertools-lambda-python/issues/6295))
+* **deps-dev:** bump boto3-stubs from 1.37.8 to 1.37.10 ([#6248](https://github.com/aws-powertools/powertools-lambda-python/issues/6248))
+* **deps-dev:** bump mkdocstrings-python from 1.16.6 to 1.16.7 ([#6319](https://github.com/aws-powertools/powertools-lambda-python/issues/6319))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.182.0a0 to 2.183.0a0 ([#6258](https://github.com/aws-powertools/powertools-lambda-python/issues/6258))
+* **deps-dev:** bump aws-cdk-lib from 2.182.0 to 2.183.0 ([#6257](https://github.com/aws-powertools/powertools-lambda-python/issues/6257))
+* **deps-dev:** bump ruff from 0.11.0 to 0.11.1 ([#6320](https://github.com/aws-powertools/powertools-lambda-python/issues/6320))
+* **deps-dev:** bump ruff from 0.11.1 to 0.11.2 ([#6326](https://github.com/aws-powertools/powertools-lambda-python/issues/6326))
+* **deps-dev:** bump boto3-stubs from 1.37.10 to 1.37.11 ([#6252](https://github.com/aws-powertools/powertools-lambda-python/issues/6252))
+* **deps-dev:** bump coverage from 7.7.0 to 7.7.1 ([#6328](https://github.com/aws-powertools/powertools-lambda-python/issues/6328))
+* **deps-dev:** bump cfn-lint from 1.28.0 to 1.29.1 ([#6249](https://github.com/aws-powertools/powertools-lambda-python/issues/6249))
+* **deps-dev:** bump boto3-stubs from 1.37.16 to 1.37.18 ([#6327](https://github.com/aws-powertools/powertools-lambda-python/issues/6327))
+* **deps-dev:** bump sentry-sdk from 2.23.1 to 2.24.0 ([#6329](https://github.com/aws-powertools/powertools-lambda-python/issues/6329))
+* **deps-dev:** bump boto3-stubs from 1.37.18 to 1.37.19 ([#6337](https://github.com/aws-powertools/powertools-lambda-python/issues/6337))
+* **deps-dev:** bump mkdocstrings-python from 1.16.7 to 1.16.8 ([#6338](https://github.com/aws-powertools/powertools-lambda-python/issues/6338))
+* **deps-dev:** bump ruff from 0.9.9 to 0.9.10 ([#6241](https://github.com/aws-powertools/powertools-lambda-python/issues/6241))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.295 to 0.1.296 ([#6240](https://github.com/aws-powertools/powertools-lambda-python/issues/6240))
+* **deps-dev:** bump boto3-stubs from 1.37.7 to 1.37.8 ([#6239](https://github.com/aws-powertools/powertools-lambda-python/issues/6239))
+* **deps-dev:** bump coverage from 7.6.12 to 7.7.0 ([#6284](https://github.com/aws-powertools/powertools-lambda-python/issues/6284))
+* **documentation:** v2 end of support ([#6343](https://github.com/aws-powertools/powertools-lambda-python/issues/6343))
+* **logger:** clear prev request buffers in manual mode ([#6314](https://github.com/aws-powertools/powertools-lambda-python/issues/6314))
+
+
+<a name="v3.8.0"></a>
+## [v3.8.0] - 2025-03-07
+## Bug Fixes
+
+* **event_handler:** revert regression when validating response ([#6234](https://github.com/aws-powertools/powertools-lambda-python/issues/6234))
+
+## Code Refactoring
+
+* **tracer:** fix capture_lambda_handler return type annotation ([#6197](https://github.com/aws-powertools/powertools-lambda-python/issues/6197))
+
+## Documentation
+
+* **layer:** Fix SSM parameter name for looking up layer ARN ([#6221](https://github.com/aws-powertools/powertools-lambda-python/issues/6221))
+
+## Features
+
+* **logger:** add logger buffer feature ([#6060](https://github.com/aws-powertools/powertools-lambda-python/issues/6060))
+* **logger:** add new logic to sample debug logs ([#6142](https://github.com/aws-powertools/powertools-lambda-python/issues/6142))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.7.1a2 ([#6186](https://github.com/aws-powertools/powertools-lambda-python/issues/6186))
+* **ci:** new pre-release 3.7.1a0 ([#6166](https://github.com/aws-powertools/powertools-lambda-python/issues/6166))
+* **ci:** new pre-release 3.7.1a6 ([#6229](https://github.com/aws-powertools/powertools-lambda-python/issues/6229))
+* **ci:** new pre-release 3.7.1a7 ([#6233](https://github.com/aws-powertools/powertools-lambda-python/issues/6233))
+* **ci:** new pre-release 3.7.1a1 ([#6178](https://github.com/aws-powertools/powertools-lambda-python/issues/6178))
+* **ci:** enable SAR deployment ([#6104](https://github.com/aws-powertools/powertools-lambda-python/issues/6104))
+* **ci:** new pre-release 3.7.1a5 ([#6219](https://github.com/aws-powertools/powertools-lambda-python/issues/6219))
+* **ci:** new pre-release 3.7.1a3 ([#6201](https://github.com/aws-powertools/powertools-lambda-python/issues/6201))
+* **ci:** new pre-release 3.7.1a4 ([#6211](https://github.com/aws-powertools/powertools-lambda-python/issues/6211))
+* **deps:** bump docker/setup-qemu-action from 3.5.0 to 3.6.0 ([#6190](https://github.com/aws-powertools/powertools-lambda-python/issues/6190))
+* **deps:** bump actions/download-artifact from 4.1.8 to 4.1.9 ([#6174](https://github.com/aws-powertools/powertools-lambda-python/issues/6174))
+* **deps:** bump squidfunk/mkdocs-material from `2615302` to `047452c` in /docs ([#6210](https://github.com/aws-powertools/powertools-lambda-python/issues/6210))
+* **deps:** bump docker/setup-qemu-action from 3.4.0 to 3.5.0 ([#6176](https://github.com/aws-powertools/powertools-lambda-python/issues/6176))
+* **deps:** bump docker/setup-buildx-action from 3.9.0 to 3.10.0 ([#6175](https://github.com/aws-powertools/powertools-lambda-python/issues/6175))
+* **deps:** bump datadog-lambda from 6.105.0 to 6.106.0 ([#6218](https://github.com/aws-powertools/powertools-lambda-python/issues/6218))
+* **deps:** bump codecov/codecov-action from 5.3.1 to 5.4.0 ([#6180](https://github.com/aws-powertools/powertools-lambda-python/issues/6180))
+* **deps:** bump pydantic-settings from 2.8.0 to 2.8.1 ([#6182](https://github.com/aws-powertools/powertools-lambda-python/issues/6182))
+* **deps:** bump jinja2 from 3.1.5 to 3.1.6 in /docs ([#6223](https://github.com/aws-powertools/powertools-lambda-python/issues/6223))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.294 to 0.1.295 ([#6207](https://github.com/aws-powertools/powertools-lambda-python/issues/6207))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.293 to 0.1.294 ([#6193](https://github.com/aws-powertools/powertools-lambda-python/issues/6193))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.181.0a0 to 2.181.1a0 ([#6194](https://github.com/aws-powertools/powertools-lambda-python/issues/6194))
+* **deps-dev:** bump ruff from 0.9.8 to 0.9.9 ([#6195](https://github.com/aws-powertools/powertools-lambda-python/issues/6195))
+* **deps-dev:** bump aws-cdk-lib from 2.181.1 to 2.182.0 ([#6222](https://github.com/aws-powertools/powertools-lambda-python/issues/6222))
+* **deps-dev:** bump testcontainers from 4.9.1 to 4.9.2 ([#6225](https://github.com/aws-powertools/powertools-lambda-python/issues/6225))
+* **deps-dev:** bump cfn-lint from 1.26.1 to 1.27.0 ([#6192](https://github.com/aws-powertools/powertools-lambda-python/issues/6192))
+* **deps-dev:** bump boto3-stubs from 1.37.2 to 1.37.3 ([#6181](https://github.com/aws-powertools/powertools-lambda-python/issues/6181))
+* **deps-dev:** bump isort from 6.0.0 to 6.0.1 ([#6183](https://github.com/aws-powertools/powertools-lambda-python/issues/6183))
+* **deps-dev:** bump boto3-stubs from 1.37.5 to 1.37.6 ([#6227](https://github.com/aws-powertools/powertools-lambda-python/issues/6227))
+* **deps-dev:** bump ruff from 0.9.7 to 0.9.8 ([#6184](https://github.com/aws-powertools/powertools-lambda-python/issues/6184))
+* **deps-dev:** bump boto3-stubs from 1.37.4 to 1.37.5 ([#6217](https://github.com/aws-powertools/powertools-lambda-python/issues/6217))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.181.1a0 to 2.182.0a0 ([#6226](https://github.com/aws-powertools/powertools-lambda-python/issues/6226))
+* **deps-dev:** bump cfn-lint from 1.27.0 to 1.28.0 ([#6228](https://github.com/aws-powertools/powertools-lambda-python/issues/6228))
+* **deps-dev:** bump pytest from 8.3.4 to 8.3.5 ([#6206](https://github.com/aws-powertools/powertools-lambda-python/issues/6206))
+* **deps-dev:** bump boto3-stubs from 1.37.0 to 1.37.1 ([#6170](https://github.com/aws-powertools/powertools-lambda-python/issues/6170))
+* **deps-dev:** bump boto3-stubs from 1.37.3 to 1.37.4 ([#6205](https://github.com/aws-powertools/powertools-lambda-python/issues/6205))
+* **deps-dev:** bump mkdocs-material from 9.6.5 to 9.6.7 ([#6208](https://github.com/aws-powertools/powertools-lambda-python/issues/6208))
+* **deps-dev:** bump aws-cdk from 2.1000.3 to 2.1001.0 ([#6173](https://github.com/aws-powertools/powertools-lambda-python/issues/6173))
+* **deps-dev:** bump cfn-lint from 1.26.0 to 1.26.1 ([#6169](https://github.com/aws-powertools/powertools-lambda-python/issues/6169))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.180.0a0 to 2.181.0a0 ([#6172](https://github.com/aws-powertools/powertools-lambda-python/issues/6172))
+* **deps-dev:** bump jinja2 from 3.1.5 to 3.1.6 ([#6224](https://github.com/aws-powertools/powertools-lambda-python/issues/6224))
+* **deps-dev:** bump aws-cdk from 2.1002.0 to 2.1003.0 ([#6232](https://github.com/aws-powertools/powertools-lambda-python/issues/6232))
+* **deps-dev:** bump cfn-lint from 1.25.1 to 1.26.0 ([#6164](https://github.com/aws-powertools/powertools-lambda-python/issues/6164))
+* **deps-dev:** bump boto3-stubs from 1.36.26 to 1.37.0 ([#6165](https://github.com/aws-powertools/powertools-lambda-python/issues/6165))
+* **deps-dev:** bump mypy-boto3-appconfigdata from 1.36.0 to 1.37.0 in the boto-typing group ([#6163](https://github.com/aws-powertools/powertools-lambda-python/issues/6163))
+* **deps-dev:** bump aws-cdk from 2.1000.2 to 2.1000.3 ([#6162](https://github.com/aws-powertools/powertools-lambda-python/issues/6162))
+* **deps-dev:** bump boto3-stubs from 1.37.6 to 1.37.7 ([#6231](https://github.com/aws-powertools/powertools-lambda-python/issues/6231))
+* **deps-dev:** bump aws-cdk from 2.1001.0 to 2.1002.0 ([#6209](https://github.com/aws-powertools/powertools-lambda-python/issues/6209))
+
+
+<a name="v3.7.0"></a>
+## [v3.7.0] - 2025-02-25
+## Bug Fixes
+
+* **logger:** correctly pick powertools or custom handler in custom environments ([#6083](https://github.com/aws-powertools/powertools-lambda-python/issues/6083))
+* **openapi:** validate response serialization when falsy ([#6119](https://github.com/aws-powertools/powertools-lambda-python/issues/6119))
+* **parser:** fix data types for `sourceIPAddress` and `sequencer` fields in S3RecordModel Model ([#6154](https://github.com/aws-powertools/powertools-lambda-python/issues/6154))
+* **parser:** fix EventBridgeModel when working with scheduled events ([#6134](https://github.com/aws-powertools/powertools-lambda-python/issues/6134))
+* **security:** fix encryption_context handling in data masking operations ([#6074](https://github.com/aws-powertools/powertools-lambda-python/issues/6074))
+
+## Documentation
+
+* **roadmap:** update roadmap ([#6077](https://github.com/aws-powertools/powertools-lambda-python/issues/6077))
+
+## Features
+
+* **batch:** raise exception for invalid batch event ([#6088](https://github.com/aws-powertools/powertools-lambda-python/issues/6088))
+* **event_handler:** add support for defining OpenAPI examples in parameters ([#6086](https://github.com/aws-powertools/powertools-lambda-python/issues/6086))
+* **layers:** add new comercial region ap-southeast-7 and mx-central-1 ([#6109](https://github.com/aws-powertools/powertools-lambda-python/issues/6109))
+* **parser:** Event source dataclasses for IoT Core Registry Events ([#6123](https://github.com/aws-powertools/powertools-lambda-python/issues/6123))
+* **parser:** Add IoT registry events models ([#5892](https://github.com/aws-powertools/powertools-lambda-python/issues/5892))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.6.1a9 ([#6157](https://github.com/aws-powertools/powertools-lambda-python/issues/6157))
+* **ci:** new pre-release 3.6.1a8 ([#6152](https://github.com/aws-powertools/powertools-lambda-python/issues/6152))
+* **ci:** new pre-release 3.6.1a4 ([#6120](https://github.com/aws-powertools/powertools-lambda-python/issues/6120))
+* **ci:** new pre-release 3.6.1a3 ([#6107](https://github.com/aws-powertools/powertools-lambda-python/issues/6107))
+* **ci:** new pre-release 3.6.1a0 ([#6084](https://github.com/aws-powertools/powertools-lambda-python/issues/6084))
+* **ci:** new pre-release 3.6.1a5 ([#6124](https://github.com/aws-powertools/powertools-lambda-python/issues/6124))
+* **ci:** new pre-release 3.6.1a7 ([#6139](https://github.com/aws-powertools/powertools-lambda-python/issues/6139))
+* **ci:** new pre-release 3.6.1a1 ([#6090](https://github.com/aws-powertools/powertools-lambda-python/issues/6090))
+* **ci:** new pre-release 3.6.1a6 ([#6132](https://github.com/aws-powertools/powertools-lambda-python/issues/6132))
+* **ci:** new pre-release 3.6.1a2 ([#6098](https://github.com/aws-powertools/powertools-lambda-python/issues/6098))
+* **ci:** remove python3.8 runtime when bootstrapping a new region ([#6101](https://github.com/aws-powertools/powertools-lambda-python/issues/6101))
+* **deps:** bump squidfunk/mkdocs-material from `f5bcec4` to `2615302` in /docs ([#6135](https://github.com/aws-powertools/powertools-lambda-python/issues/6135))
+* **deps:** bump squidfunk/mkdocs-material from `c62453b` to `f5bcec4` in /docs ([#6087](https://github.com/aws-powertools/powertools-lambda-python/issues/6087))
+* **deps:** bump actions/upload-artifact from 4.6.0 to 4.6.1 ([#6144](https://github.com/aws-powertools/powertools-lambda-python/issues/6144))
+* **deps:** bump aws-actions/configure-aws-credentials from 4.0.3 to 4.1.0 ([#6082](https://github.com/aws-powertools/powertools-lambda-python/issues/6082))
+* **deps:** bump pydantic-settings from 2.7.1 to 2.8.0 ([#6147](https://github.com/aws-powertools/powertools-lambda-python/issues/6147))
+* **deps:** bump ossf/scorecard-action from 2.4.0 to 2.4.1 ([#6143](https://github.com/aws-powertools/powertools-lambda-python/issues/6143))
+* **deps:** bump slsa-framework/slsa-github-generator from 2.0.0 to 2.1.0 ([#6155](https://github.com/aws-powertools/powertools-lambda-python/issues/6155))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.21 to 3.0.22 ([#6113](https://github.com/aws-powertools/powertools-lambda-python/issues/6113))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.292 to 0.1.293 ([#6129](https://github.com/aws-powertools/powertools-lambda-python/issues/6129))
+* **deps-dev:** bump sentry-sdk from 2.21.0 to 2.22.0 ([#6114](https://github.com/aws-powertools/powertools-lambda-python/issues/6114))
+* **deps-dev:** bump bandit from 1.8.2 to 1.8.3 ([#6117](https://github.com/aws-powertools/powertools-lambda-python/issues/6117))
+* **deps-dev:** bump mkdocstrings-python from 1.15.0 to 1.16.0 ([#6118](https://github.com/aws-powertools/powertools-lambda-python/issues/6118))
+* **deps-dev:** bump boto3-stubs from 1.36.19 to 1.36.22 ([#6116](https://github.com/aws-powertools/powertools-lambda-python/issues/6116))
+* **deps-dev:** bump cfn-lint from 1.24.0 to 1.25.1 ([#6115](https://github.com/aws-powertools/powertools-lambda-python/issues/6115))
+* **deps-dev:** bump mkdocstrings-python from 1.16.0 to 1.16.1 ([#6128](https://github.com/aws-powertools/powertools-lambda-python/issues/6128))
+* **deps-dev:** bump boto3-stubs from 1.36.22 to 1.36.24 ([#6131](https://github.com/aws-powertools/powertools-lambda-python/issues/6131))
+* **deps-dev:** bump aws-cdk from 2.178.2 to 2.1000.2 ([#6126](https://github.com/aws-powertools/powertools-lambda-python/issues/6126))
+* **deps-dev:** bump sentry-sdk from 2.20.0 to 2.21.0 ([#6096](https://github.com/aws-powertools/powertools-lambda-python/issues/6096))
+* **deps-dev:** bump mkdocs-material from 9.6.3 to 9.6.4 ([#6097](https://github.com/aws-powertools/powertools-lambda-python/issues/6097))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.178.2a0 to 2.179.0a0 ([#6127](https://github.com/aws-powertools/powertools-lambda-python/issues/6127))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.178.1a0 to 2.178.2a0 ([#6095](https://github.com/aws-powertools/powertools-lambda-python/issues/6095))
+* **deps-dev:** bump boto3-stubs from 1.36.17 to 1.36.19 ([#6093](https://github.com/aws-powertools/powertools-lambda-python/issues/6093))
+* **deps-dev:** bump aws-cdk-lib from 2.178.2 to 2.179.0 ([#6130](https://github.com/aws-powertools/powertools-lambda-python/issues/6130))
+* **deps-dev:** bump ruff from 0.9.6 to 0.9.7 ([#6138](https://github.com/aws-powertools/powertools-lambda-python/issues/6138))
+* **deps-dev:** bump aws-cdk from 2.178.1 to 2.178.2 ([#6089](https://github.com/aws-powertools/powertools-lambda-python/issues/6089))
+* **deps-dev:** bump mkdocs-material from 9.6.4 to 9.6.5 ([#6136](https://github.com/aws-powertools/powertools-lambda-python/issues/6136))
+* **deps-dev:** bump boto3-stubs from 1.36.24 to 1.36.25 ([#6137](https://github.com/aws-powertools/powertools-lambda-python/issues/6137))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.179.0a0 to 2.180.0a0 ([#6145](https://github.com/aws-powertools/powertools-lambda-python/issues/6145))
+* **deps-dev:** bump aws-cdk-lib from 2.179.0 to 2.180.0 ([#6148](https://github.com/aws-powertools/powertools-lambda-python/issues/6148))
+* **deps-dev:** bump coverage from 7.6.11 to 7.6.12 ([#6080](https://github.com/aws-powertools/powertools-lambda-python/issues/6080))
+* **deps-dev:** bump mkdocstrings-python from 1.14.6 to 1.15.0 ([#6079](https://github.com/aws-powertools/powertools-lambda-python/issues/6079))
+* **deps-dev:** bump boto3-stubs from 1.36.16 to 1.36.17 ([#6078](https://github.com/aws-powertools/powertools-lambda-python/issues/6078))
+* **deps-dev:** bump boto3-stubs from 1.36.25 to 1.36.26 ([#6146](https://github.com/aws-powertools/powertools-lambda-python/issues/6146))
+* **docs:** enable sitemap generation ([#6103](https://github.com/aws-powertools/powertools-lambda-python/issues/6103))
+
+
+<a name="v3.6.0"></a>
+## [v3.6.0] - 2025-02-11
+## Bug Fixes
+
+* **docs:** typo in a service name in Event Handler ([#5944](https://github.com/aws-powertools/powertools-lambda-python/issues/5944))
+* **logger:** child logger must respect log level ([#5950](https://github.com/aws-powertools/powertools-lambda-python/issues/5950))
+
+## Code Refactoring
+
+* **metrics:** Improve type annotations for metrics decorator ([#6000](https://github.com/aws-powertools/powertools-lambda-python/issues/6000))
+
+## Documentation
+
+* **api:** migrating the event handler utility to mkdocstrings ([#6023](https://github.com/aws-powertools/powertools-lambda-python/issues/6023))
+* **api:** migrating the metrics utility to mkdocstrings ([#6022](https://github.com/aws-powertools/powertools-lambda-python/issues/6022))
+* **api:** migrating the logger utility to mkdocstrings ([#6021](https://github.com/aws-powertools/powertools-lambda-python/issues/6021))
+* **api:** migrating the Middleware Factory utility to mkdocstrings ([#6019](https://github.com/aws-powertools/powertools-lambda-python/issues/6019))
+* **api:** migrating the tracer utility to mkdocstrings ([#6017](https://github.com/aws-powertools/powertools-lambda-python/issues/6017))
+* **api:** migrating the batch utility to mkdocstrings ([#6016](https://github.com/aws-powertools/powertools-lambda-python/issues/6016))
+* **api:** migrating the event source data classes utility to mkdocstrings ([#6015](https://github.com/aws-powertools/powertools-lambda-python/issues/6015))
+* **api:** migrating the data masking utility to mkdocstrings ([#6013](https://github.com/aws-powertools/powertools-lambda-python/issues/6013))
+* **api:** migrating the AppConfig utility to mkdocstrings ([#6008](https://github.com/aws-powertools/powertools-lambda-python/issues/6008))
+* **api:** migrating the idempotency utility to mkdocstrings ([#6007](https://github.com/aws-powertools/powertools-lambda-python/issues/6007))
+* **api:** migrating the jmespath utility to mkdocstrings ([#6006](https://github.com/aws-powertools/powertools-lambda-python/issues/6006))
+* **api:** migrating the parameters utility to mkdocstrings ([#6005](https://github.com/aws-powertools/powertools-lambda-python/issues/6005))
+* **api:** migrating the parser utility to mkdocstrings ([#6004](https://github.com/aws-powertools/powertools-lambda-python/issues/6004))
+* **api:** migrating the streaming utility to mkdocstrings ([#6003](https://github.com/aws-powertools/powertools-lambda-python/issues/6003))
+* **api:** migrating the typing utility to mkdocstrings ([#5996](https://github.com/aws-powertools/powertools-lambda-python/issues/5996))
+* **api:** migrating the validation utility to mkdocstrings ([#5972](https://github.com/aws-powertools/powertools-lambda-python/issues/5972))
+* **layer:** update layer version number - v3.5.0 ([#5952](https://github.com/aws-powertools/powertools-lambda-python/issues/5952))
+
+## Features
+
+* **data-masking:** add custom mask functionalities ([#5837](https://github.com/aws-powertools/powertools-lambda-python/issues/5837))
+* **event_source:** add class APIGatewayAuthorizerResponseWebSocket ([#6058](https://github.com/aws-powertools/powertools-lambda-python/issues/6058))
+* **logger:** add clear_state method ([#5956](https://github.com/aws-powertools/powertools-lambda-python/issues/5956))
+* **metrics:** disable metrics flush via environment variables ([#6046](https://github.com/aws-powertools/powertools-lambda-python/issues/6046))
+* **openapi:** enhance support for tuple return type validation ([#5997](https://github.com/aws-powertools/powertools-lambda-python/issues/5997))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.5.1a9 ([#6069](https://github.com/aws-powertools/powertools-lambda-python/issues/6069))
+* **ci:** new pre-release 3.5.1a0 ([#5945](https://github.com/aws-powertools/powertools-lambda-python/issues/5945))
+* **ci:** new pre-release 3.5.1a1 ([#5954](https://github.com/aws-powertools/powertools-lambda-python/issues/5954))
+* **ci:** new pre-release 3.5.1a8 ([#6061](https://github.com/aws-powertools/powertools-lambda-python/issues/6061))
+* **ci:** install & configure mkdocstrings plugin ([#5959](https://github.com/aws-powertools/powertools-lambda-python/issues/5959))
+* **ci:** new pre-release 3.5.1a2 ([#5970](https://github.com/aws-powertools/powertools-lambda-python/issues/5970))
+* **ci:** new pre-release 3.5.1a3 ([#5998](https://github.com/aws-powertools/powertools-lambda-python/issues/5998))
+* **ci:** new pre-release 3.5.1a7 ([#6044](https://github.com/aws-powertools/powertools-lambda-python/issues/6044))
+* **ci:** new pre-release 3.5.1a4 ([#6018](https://github.com/aws-powertools/powertools-lambda-python/issues/6018))
+* **ci:** remove pdoc3 library ([#6024](https://github.com/aws-powertools/powertools-lambda-python/issues/6024))
+* **ci:** new pre-release 3.5.1a5 ([#6026](https://github.com/aws-powertools/powertools-lambda-python/issues/6026))
+* **ci:** add new script to bump Lambda layer version ([#6001](https://github.com/aws-powertools/powertools-lambda-python/issues/6001))
+* **ci:** new pre-release 3.5.1a6 ([#6033](https://github.com/aws-powertools/powertools-lambda-python/issues/6033))
+* **deps:** bump squidfunk/mkdocs-material from `471695f` to `7e841df` in /docs ([#6012](https://github.com/aws-powertools/powertools-lambda-python/issues/6012))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.20 to 3.0.21 ([#6064](https://github.com/aws-powertools/powertools-lambda-python/issues/6064))
+* **deps:** bump actions/setup-python from 5.3.0 to 5.4.0 ([#5960](https://github.com/aws-powertools/powertools-lambda-python/issues/5960))
+* **deps:** bump docker/setup-qemu-action from 3.2.0 to 3.3.0 ([#5961](https://github.com/aws-powertools/powertools-lambda-python/issues/5961))
+* **deps:** bump codecov/codecov-action from 5.1.2 to 5.3.1 ([#5964](https://github.com/aws-powertools/powertools-lambda-python/issues/5964))
+* **deps:** bump squidfunk/mkdocs-material from `7e841df` to `c62453b` in /docs ([#6052](https://github.com/aws-powertools/powertools-lambda-python/issues/6052))
+* **deps:** bump actions/setup-node from 4.1.0 to 4.2.0 ([#5963](https://github.com/aws-powertools/powertools-lambda-python/issues/5963))
+* **deps:** bump actions/upload-artifact from 4.5.0 to 4.6.0 ([#5962](https://github.com/aws-powertools/powertools-lambda-python/issues/5962))
+* **deps:** bump release-drafter/release-drafter from 6.0.0 to 6.1.0 ([#5976](https://github.com/aws-powertools/powertools-lambda-python/issues/5976))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.18 to 3.0.20 ([#5977](https://github.com/aws-powertools/powertools-lambda-python/issues/5977))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.12.3 to 1.12.4 ([#5980](https://github.com/aws-powertools/powertools-lambda-python/issues/5980))
+* **deps:** bump docker/setup-buildx-action from 3.8.0 to 3.9.0 ([#6042](https://github.com/aws-powertools/powertools-lambda-python/issues/6042))
+* **deps:** bump docker/setup-qemu-action from 3.3.0 to 3.4.0 ([#6043](https://github.com/aws-powertools/powertools-lambda-python/issues/6043))
+* **deps:** bump aws-actions/configure-aws-credentials from 4.0.2 to 4.0.3 ([#5975](https://github.com/aws-powertools/powertools-lambda-python/issues/5975))
+* **deps:** bump squidfunk/mkdocs-material from `41942f7` to `471695f` in /docs ([#5979](https://github.com/aws-powertools/powertools-lambda-python/issues/5979))
+* **deps:** bump actions/setup-go from 5.2.0 to 5.3.0 ([#5978](https://github.com/aws-powertools/powertools-lambda-python/issues/5978))
+* **deps-dev:** bump aws-cdk from 2.178.0 to 2.178.1 ([#6053](https://github.com/aws-powertools/powertools-lambda-python/issues/6053))
+* **deps-dev:** bump mkdocstrings-python from 1.13.0 to 1.14.2 ([#6011](https://github.com/aws-powertools/powertools-lambda-python/issues/6011))
+* **deps-dev:** bump mkdocs-material from 9.6.1 to 9.6.2 ([#6009](https://github.com/aws-powertools/powertools-lambda-python/issues/6009))
+* **deps-dev:** bump aws-cdk-lib from 2.178.0 to 2.178.1 ([#6047](https://github.com/aws-powertools/powertools-lambda-python/issues/6047))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.178.0a0 to 2.178.1a0 ([#6048](https://github.com/aws-powertools/powertools-lambda-python/issues/6048))
+* **deps-dev:** bump boto3-stubs from 1.36.14 to 1.36.15 ([#6049](https://github.com/aws-powertools/powertools-lambda-python/issues/6049))
+* **deps-dev:** bump boto3-stubs from 1.36.10 to 1.36.11 ([#6010](https://github.com/aws-powertools/powertools-lambda-python/issues/6010))
+* **deps-dev:** bump boto3-stubs from 1.36.10 to 1.36.12 ([#6014](https://github.com/aws-powertools/powertools-lambda-python/issues/6014))
+* **deps-dev:** bump ruff from 0.9.5 to 0.9.6 ([#6066](https://github.com/aws-powertools/powertools-lambda-python/issues/6066))
+* **deps-dev:** bump mkdocstrings-python from 1.14.2 to 1.14.4 ([#6025](https://github.com/aws-powertools/powertools-lambda-python/issues/6025))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.177.0a0 to 2.178.0a0 ([#6041](https://github.com/aws-powertools/powertools-lambda-python/issues/6041))
+* **deps-dev:** bump mkdocs-material from 9.5.50 to 9.6.1 ([#5966](https://github.com/aws-powertools/powertools-lambda-python/issues/5966))
+* **deps-dev:** bump black from 24.10.0 to 25.1.0 ([#5968](https://github.com/aws-powertools/powertools-lambda-python/issues/5968))
+* **deps-dev:** bump ruff from 0.9.3 to 0.9.4 ([#5969](https://github.com/aws-powertools/powertools-lambda-python/issues/5969))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.291 to 0.1.292 ([#6051](https://github.com/aws-powertools/powertools-lambda-python/issues/6051))
+* **deps-dev:** bump cfn-lint from 1.22.7 to 1.23.1 ([#5967](https://github.com/aws-powertools/powertools-lambda-python/issues/5967))
+* **deps-dev:** bump mkdocstrings-python from 1.14.5 to 1.14.6 ([#6050](https://github.com/aws-powertools/powertools-lambda-python/issues/6050))
+* **deps-dev:** bump isort from 5.13.2 to 6.0.0 ([#5965](https://github.com/aws-powertools/powertools-lambda-python/issues/5965))
+* **deps-dev:** bump ruff from 0.9.4 to 0.9.5 ([#6039](https://github.com/aws-powertools/powertools-lambda-python/issues/6039))
+* **deps-dev:** bump aws-cdk-lib from 2.177.0 to 2.178.0 ([#6038](https://github.com/aws-powertools/powertools-lambda-python/issues/6038))
+* **deps-dev:** bump mypy from 1.14.1 to 1.15.0 ([#6028](https://github.com/aws-powertools/powertools-lambda-python/issues/6028))
+* **deps-dev:** bump mkdocstrings-python from 1.14.4 to 1.14.5 ([#6032](https://github.com/aws-powertools/powertools-lambda-python/issues/6032))
+* **deps-dev:** bump cfn-lint from 1.23.1 to 1.24.0 ([#6030](https://github.com/aws-powertools/powertools-lambda-python/issues/6030))
+* **deps-dev:** bump boto3-stubs from 1.36.14 to 1.36.16 ([#6057](https://github.com/aws-powertools/powertools-lambda-python/issues/6057))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.290 to 0.1.291 ([#6031](https://github.com/aws-powertools/powertools-lambda-python/issues/6031))
+* **deps-dev:** bump boto3-stubs from 1.36.12 to 1.36.14 ([#6029](https://github.com/aws-powertools/powertools-lambda-python/issues/6029))
+* **deps-dev:** bump mkdocs-material from 9.6.2 to 9.6.3 ([#6065](https://github.com/aws-powertools/powertools-lambda-python/issues/6065))
+* **deps-dev:** bump coverage from 7.6.10 to 7.6.11 ([#6067](https://github.com/aws-powertools/powertools-lambda-python/issues/6067))
+* **deps-dev:** bump aws-cdk from 2.177.0 to 2.178.0 ([#6040](https://github.com/aws-powertools/powertools-lambda-python/issues/6040))
+* **docs:** enable privacy plugin in docs ([#6036](https://github.com/aws-powertools/powertools-lambda-python/issues/6036))
+
+
+<a name="v3.5.0"></a>
+## [v3.5.0] - 2025-01-28
+## Bug Fixes
+
+* **event_handler:** fixes typo in variable name `fronzen_openapi_extensions` ([#5929](https://github.com/aws-powertools/powertools-lambda-python/issues/5929))
+* **event_handler:** add tests for PEP 563 compatibility with OpenAPI ([#5886](https://github.com/aws-powertools/powertools-lambda-python/issues/5886))
+* **event_handler:** fix forward references resolution in OpenAPI ([#5885](https://github.com/aws-powertools/powertools-lambda-python/issues/5885))
+* **parser:** make identitySource optional for ApiGatewayAuthorizerRequestV2 model ([#5880](https://github.com/aws-powertools/powertools-lambda-python/issues/5880))
+
+## Documentation
+
+* **data_classes:** improve Event Source Data Classes documentation ([#5916](https://github.com/aws-powertools/powertools-lambda-python/issues/5916))
+* **event_handler:** demonstrate handling optional security routes ([#5895](https://github.com/aws-powertools/powertools-lambda-python/issues/5895))
+* **layer:** update layer version number - v3.4.1 ([#5869](https://github.com/aws-powertools/powertools-lambda-python/issues/5869))
+* **parser:** improve documentation with Pydantic best practices ([#5925](https://github.com/aws-powertools/powertools-lambda-python/issues/5925))
+
+## Features
+
+* **event_source:** add AWS Transfer Family classes ([#5912](https://github.com/aws-powertools/powertools-lambda-python/issues/5912))
+* **idempotency:** add support for custom Idempotency key prefix ([#5898](https://github.com/aws-powertools/powertools-lambda-python/issues/5898))
+* **logger:** add context manager for logger keys ([#5883](https://github.com/aws-powertools/powertools-lambda-python/issues/5883))
+* **parser:** add AWS Transfer Family model ([#5906](https://github.com/aws-powertools/powertools-lambda-python/issues/5906))
+
+## Maintenance
+
+* version bump
+* **ci:** adding poetry export plugin to support v2 ([#5941](https://github.com/aws-powertools/powertools-lambda-python/issues/5941))
+* **ci:** adding poetry export plugin to support v2 ([#5938](https://github.com/aws-powertools/powertools-lambda-python/issues/5938))
+* **ci:** adjust token permission ([#5867](https://github.com/aws-powertools/powertools-lambda-python/issues/5867))
+* **ci:** new pre-release 3.4.2a0 ([#5873](https://github.com/aws-powertools/powertools-lambda-python/issues/5873))
+* **ci:** make `pyproject.toml` fully compatible with Poetryv2 ([#5902](https://github.com/aws-powertools/powertools-lambda-python/issues/5902))
+* **ci:** drop support for Python 3.8 ([#5896](https://github.com/aws-powertools/powertools-lambda-python/issues/5896))
+* **ci:** update poetry version to v2 ([#5936](https://github.com/aws-powertools/powertools-lambda-python/issues/5936))
+* **ci:** fix permissions for gh pages ([#5866](https://github.com/aws-powertools/powertools-lambda-python/issues/5866))
+* **deps:** bump pydantic from 2.10.5 to 2.10.6 ([#5918](https://github.com/aws-powertools/powertools-lambda-python/issues/5918))
+* **deps:** bump squidfunk/mkdocs-material from `ba73db5` to `41942f7` in /docs ([#5890](https://github.com/aws-powertools/powertools-lambda-python/issues/5890))
+* **deps-dev:** bump boto3-stubs from 1.36.4 to 1.36.5 ([#5919](https://github.com/aws-powertools/powertools-lambda-python/issues/5919))
+* **deps-dev:** bump boto3-stubs from 1.36.4 to 1.36.6 ([#5923](https://github.com/aws-powertools/powertools-lambda-python/issues/5923))
+* **deps-dev:** bump cfn-lint from 1.22.6 to 1.22.7 ([#5910](https://github.com/aws-powertools/powertools-lambda-python/issues/5910))
+* **deps-dev:** bump testcontainers from 3.7.1 to 4.9.1 ([#5907](https://github.com/aws-powertools/powertools-lambda-python/issues/5907))
+* **deps-dev:** bump pytest-benchmark from 4.0.0 to 5.1.0 ([#5909](https://github.com/aws-powertools/powertools-lambda-python/issues/5909))
+* **deps-dev:** bump aws-cdk from 2.176.0 to 2.177.0 ([#5930](https://github.com/aws-powertools/powertools-lambda-python/issues/5930))
+* **deps-dev:** bump pytest-cov from 5.0.0 to 6.0.0 ([#5908](https://github.com/aws-powertools/powertools-lambda-python/issues/5908))
+* **deps-dev:** bump aws-cdk-lib from 2.176.0 to 2.177.0 ([#5931](https://github.com/aws-powertools/powertools-lambda-python/issues/5931))
+* **deps-dev:** bump cfn-lint from 1.22.5 to 1.22.6 ([#5900](https://github.com/aws-powertools/powertools-lambda-python/issues/5900))
+* **deps-dev:** bump boto3-stubs from 1.36.6 to 1.36.7 ([#5932](https://github.com/aws-powertools/powertools-lambda-python/issues/5932))
+* **deps-dev:** bump boto3-stubs from 1.36.2 to 1.36.3 ([#5894](https://github.com/aws-powertools/powertools-lambda-python/issues/5894))
+* **deps-dev:** bump pytest-asyncio from 0.24.0 to 0.25.2 ([#5920](https://github.com/aws-powertools/powertools-lambda-python/issues/5920))
+* **deps-dev:** bump mkdocs-material from 9.5.49 to 9.5.50 ([#5889](https://github.com/aws-powertools/powertools-lambda-python/issues/5889))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.175.1a0 to 2.176.0a0 ([#5882](https://github.com/aws-powertools/powertools-lambda-python/issues/5882))
+* **deps-dev:** bump boto3-stubs from 1.36.1 to 1.36.2 ([#5881](https://github.com/aws-powertools/powertools-lambda-python/issues/5881))
+* **deps-dev:** bump aws-cdk from 2.175.1 to 2.176.0 ([#5878](https://github.com/aws-powertools/powertools-lambda-python/issues/5878))
+* **deps-dev:** bump ruff from 0.9.1 to 0.9.2 ([#5877](https://github.com/aws-powertools/powertools-lambda-python/issues/5877))
+* **deps-dev:** bump aws-cdk-lib from 2.175.1 to 2.176.0 ([#5876](https://github.com/aws-powertools/powertools-lambda-python/issues/5876))
+* **deps-dev:** bump mypy-boto3-appconfigdata from 1.35.93 to 1.36.0 in the boto-typing group ([#5875](https://github.com/aws-powertools/powertools-lambda-python/issues/5875))
+* **deps-dev:** bump sentry-sdk from 2.19.2 to 2.20.0 ([#5870](https://github.com/aws-powertools/powertools-lambda-python/issues/5870))
+* **deps-dev:** bump boto3-stubs from 1.35.97 to 1.35.99 ([#5874](https://github.com/aws-powertools/powertools-lambda-python/issues/5874))
+* **deps-dev:** bump cfn-lint from 1.22.4 to 1.22.5 ([#5872](https://github.com/aws-powertools/powertools-lambda-python/issues/5872))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.176.0a0 to 2.177.0a0 ([#5933](https://github.com/aws-powertools/powertools-lambda-python/issues/5933))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.289 to 0.1.290 ([#5917](https://github.com/aws-powertools/powertools-lambda-python/issues/5917))
+* **deps-dev:** bump ruff from 0.9.2 to 0.9.3 ([#5911](https://github.com/aws-powertools/powertools-lambda-python/issues/5911))
+
+
+<a name="v3.4.1"></a>
+## [v3.4.1] - 2025-01-14
+## Bug Fixes
+
+* **appsync:** enhance consistency for custom resolver field naming in AppSync ([#5801](https://github.com/aws-powertools/powertools-lambda-python/issues/5801))
+* **idempotency:** add support for Optional type when serializing output ([#5590](https://github.com/aws-powertools/powertools-lambda-python/issues/5590))
+
+## Documentation
+
+* **community:** data masking blog post ([#5831](https://github.com/aws-powertools/powertools-lambda-python/issues/5831))
+* **home:** fix date typo and shorten message. ([#5798](https://github.com/aws-powertools/powertools-lambda-python/issues/5798))
+* **layer:** update layer version number - v3.4.0 ([#5785](https://github.com/aws-powertools/powertools-lambda-python/issues/5785))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.4.1a7 ([#5816](https://github.com/aws-powertools/powertools-lambda-python/issues/5816))
+* **ci:** new pre-release 3.4.1a0 ([#5783](https://github.com/aws-powertools/powertools-lambda-python/issues/5783))
+* **ci:** change token permissions ([#5862](https://github.com/aws-powertools/powertools-lambda-python/issues/5862))
+* **ci:** change token permissions / update aws-credentials action ([#5861](https://github.com/aws-powertools/powertools-lambda-python/issues/5861))
+* **ci:** fix dependency resolution ([#5859](https://github.com/aws-powertools/powertools-lambda-python/issues/5859))
+* **ci:** fix dependency resolution ([#5858](https://github.com/aws-powertools/powertools-lambda-python/issues/5858))
+* **ci:** change token permissions ([#5865](https://github.com/aws-powertools/powertools-lambda-python/issues/5865))
+* **ci:** new pre-release 3.4.1a1 ([#5789](https://github.com/aws-powertools/powertools-lambda-python/issues/5789))
+* **ci:** new pre-release 3.4.1a2 ([#5791](https://github.com/aws-powertools/powertools-lambda-python/issues/5791))
+* **ci:** new pre-release 3.4.1a3 ([#5794](https://github.com/aws-powertools/powertools-lambda-python/issues/5794))
+* **ci:** new pre-release 3.4.1a10 ([#5845](https://github.com/aws-powertools/powertools-lambda-python/issues/5845))
+* **ci:** new pre-release 3.4.1a4 ([#5796](https://github.com/aws-powertools/powertools-lambda-python/issues/5796))
+* **ci:** new pre-release 3.4.1a5 ([#5807](https://github.com/aws-powertools/powertools-lambda-python/issues/5807))
+* **ci:** new pre-release 3.4.1a8 ([#5818](https://github.com/aws-powertools/powertools-lambda-python/issues/5818))
+* **ci:** new pre-release 3.4.1a6 ([#5813](https://github.com/aws-powertools/powertools-lambda-python/issues/5813))
+* **ci:** new pre-release 3.4.1a9 ([#5822](https://github.com/aws-powertools/powertools-lambda-python/issues/5822))
+* **deps:** bump pydantic from 2.10.4 to 2.10.5 ([#5848](https://github.com/aws-powertools/powertools-lambda-python/issues/5848))
+* **deps:** bump jinja2 from 3.1.4 to 3.1.5 in /docs ([#5787](https://github.com/aws-powertools/powertools-lambda-python/issues/5787))
+* **deps:** bump pydantic-settings from 2.7.0 to 2.7.1 ([#5815](https://github.com/aws-powertools/powertools-lambda-python/issues/5815))
+* **deps-dev:** bump ruff from 0.8.4 to 0.8.6 ([#5833](https://github.com/aws-powertools/powertools-lambda-python/issues/5833))
+* **deps-dev:** bump boto3-stubs from 1.35.90 to 1.35.92 ([#5827](https://github.com/aws-powertools/powertools-lambda-python/issues/5827))
+* **deps-dev:** bump aws-cdk from 2.173.4 to 2.174.0 ([#5832](https://github.com/aws-powertools/powertools-lambda-python/issues/5832))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.173.2a0 to 2.173.4a0 ([#5811](https://github.com/aws-powertools/powertools-lambda-python/issues/5811))
+* **deps-dev:** bump cfn-lint from 1.22.2 to 1.22.3 ([#5810](https://github.com/aws-powertools/powertools-lambda-python/issues/5810))
+* **deps-dev:** bump boto3-stubs from 1.35.89 to 1.35.90 ([#5809](https://github.com/aws-powertools/powertools-lambda-python/issues/5809))
+* **deps-dev:** bump mypy from 1.14.0 to 1.14.1 ([#5812](https://github.com/aws-powertools/powertools-lambda-python/issues/5812))
+* **deps-dev:** bump boto3-stubs from 1.35.92 to 1.35.93 ([#5835](https://github.com/aws-powertools/powertools-lambda-python/issues/5835))
+* **deps-dev:** bump aws-cdk-lib from 2.173.4 to 2.174.1 ([#5838](https://github.com/aws-powertools/powertools-lambda-python/issues/5838))
+* **deps-dev:** bump mypy-boto3-appconfigdata from 1.35.0 to 1.35.93 in the boto-typing group ([#5840](https://github.com/aws-powertools/powertools-lambda-python/issues/5840))
+* **deps-dev:** bump aws-cdk-lib from 2.173.2 to 2.173.4 ([#5803](https://github.com/aws-powertools/powertools-lambda-python/issues/5803))
+* **deps-dev:** bump aws-cdk from 2.173.2 to 2.173.4 ([#5802](https://github.com/aws-powertools/powertools-lambda-python/issues/5802))
+* **deps-dev:** bump boto3-stubs from 1.35.87 to 1.35.89 ([#5804](https://github.com/aws-powertools/powertools-lambda-python/issues/5804))
+* **deps-dev:** bump jinja2 from 3.1.4 to 3.1.5 ([#5788](https://github.com/aws-powertools/powertools-lambda-python/issues/5788))
+* **deps-dev:** bump aws-cdk from 2.174.0 to 2.174.1 ([#5841](https://github.com/aws-powertools/powertools-lambda-python/issues/5841))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.173.4a0 to 2.174.1a0 ([#5842](https://github.com/aws-powertools/powertools-lambda-python/issues/5842))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.287 to 0.1.288 ([#5793](https://github.com/aws-powertools/powertools-lambda-python/issues/5793))
+* **deps-dev:** bump boto3-stubs from 1.35.93 to 1.35.94 ([#5844](https://github.com/aws-powertools/powertools-lambda-python/issues/5844))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.288 to 0.1.289 ([#5843](https://github.com/aws-powertools/powertools-lambda-python/issues/5843))
+* **deps-dev:** bump boto3-stubs from 1.35.94 to 1.35.95 ([#5847](https://github.com/aws-powertools/powertools-lambda-python/issues/5847))
+* **deps-dev:** bump cfn-lint from 1.22.3 to 1.22.4 ([#5849](https://github.com/aws-powertools/powertools-lambda-python/issues/5849))
+* **deps-dev:** bump boto3-stubs from 1.35.95 to 1.35.96 ([#5850](https://github.com/aws-powertools/powertools-lambda-python/issues/5850))
+* **deps-dev:** bump boto3-stubs from 1.35.96 to 1.35.97 ([#5852](https://github.com/aws-powertools/powertools-lambda-python/issues/5852))
+* **deps-dev:** bump boto3-stubs from 1.35.86 to 1.35.87 ([#5786](https://github.com/aws-powertools/powertools-lambda-python/issues/5786))
+* **deps-dev:** bump aws-cdk from 2.174.1 to 2.175.0 ([#5854](https://github.com/aws-powertools/powertools-lambda-python/issues/5854))
+* **deps-dev:** bump aws-cdk from 2.175.0 to 2.175.1 ([#5863](https://github.com/aws-powertools/powertools-lambda-python/issues/5863))
+* **deps-dev:** bump boto3-stubs from 1.35.85 to 1.35.86 ([#5780](https://github.com/aws-powertools/powertools-lambda-python/issues/5780))
+* **deps-dev:** bump mypy from 1.13.0 to 1.14.0 ([#5779](https://github.com/aws-powertools/powertools-lambda-python/issues/5779))
+* **deps-dev:** bump ruff from 0.8.6 to 0.9.1 ([#5853](https://github.com/aws-powertools/powertools-lambda-python/issues/5853))
+* **deps-dev:** bump aws-cdk-lib from 2.174.1 to 2.175.1 ([#5856](https://github.com/aws-powertools/powertools-lambda-python/issues/5856))
+
+
+<a name="v3.4.0"></a>
+## [v3.4.0] - 2024-12-20
+## Bug Fixes
+
+* **ci:** add overwrite to SSM workflow ([#5775](https://github.com/aws-powertools/powertools-lambda-python/issues/5775))
+* **docs:** typo in homepage extra dependencies command ([#5681](https://github.com/aws-powertools/powertools-lambda-python/issues/5681))
+* **openapi:** Allow values of any type in the examples of the Schema Object. ([#5575](https://github.com/aws-powertools/powertools-lambda-python/issues/5575))
+* **parser:** remove AttributeError validation from event_parser function ([#5742](https://github.com/aws-powertools/powertools-lambda-python/issues/5742))
+* **parser:** remove 'aws:' prefix from SelfManagedKafka model ([#5584](https://github.com/aws-powertools/powertools-lambda-python/issues/5584))
+
+## Code Refactoring
+
+* **event_handler:** add type annotations for router decorators ([#5601](https://github.com/aws-powertools/powertools-lambda-python/issues/5601))
+* **event_handler:** add type annotations for `resolve` function ([#5602](https://github.com/aws-powertools/powertools-lambda-python/issues/5602))
+
+## Documentation
+
+* **layer:** update layer version number - v3.3.0 ([#5562](https://github.com/aws-powertools/powertools-lambda-python/issues/5562))
+
+## Features
+
+* **event_handler:** mark API operation as deprecated for OpenAPI documentation ([#5732](https://github.com/aws-powertools/powertools-lambda-python/issues/5732))
+* **event_handler:** add exception handling mechanism for AppSyncResolver ([#5588](https://github.com/aws-powertools/powertools-lambda-python/issues/5588))
+* **event_source:** Extend CodePipeline Artifact Capabilities ([#5448](https://github.com/aws-powertools/powertools-lambda-python/issues/5448))
+* **layer:** add new ap-southeast-5 region ([#5769](https://github.com/aws-powertools/powertools-lambda-python/issues/5769))
+* **metrics:** warn when overwriting dimension ([#5653](https://github.com/aws-powertools/powertools-lambda-python/issues/5653))
+* **parser:** add models for API GW Websockets events ([#5597](https://github.com/aws-powertools/powertools-lambda-python/issues/5597))
+* **ssm:** Parameters for resolving to versioned layers ([#5754](https://github.com/aws-powertools/powertools-lambda-python/issues/5754))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.3.1a14 ([#5713](https://github.com/aws-powertools/powertools-lambda-python/issues/5713))
+* **ci:** new pre-release 3.3.1a21 ([#5773](https://github.com/aws-powertools/powertools-lambda-python/issues/5773))
+* **ci:** new pre-release 3.3.1a0 ([#5565](https://github.com/aws-powertools/powertools-lambda-python/issues/5565))
+* **ci:** new pre-release 3.3.1a1 ([#5577](https://github.com/aws-powertools/powertools-lambda-python/issues/5577))
+* **ci:** disable dry run in layer balancing workflow ([#5768](https://github.com/aws-powertools/powertools-lambda-python/issues/5768))
+* **ci:** new pre-release 3.3.1a20 ([#5766](https://github.com/aws-powertools/powertools-lambda-python/issues/5766))
+* **ci:** new pre-release 3.3.1a10 ([#5679](https://github.com/aws-powertools/powertools-lambda-python/issues/5679))
+* **ci:** add workflow to balance layers per region ([#5752](https://github.com/aws-powertools/powertools-lambda-python/issues/5752))
+* **ci:** new pre-release 3.3.1a9 ([#5668](https://github.com/aws-powertools/powertools-lambda-python/issues/5668))
+* **ci:** new pre-release 3.3.1a19 ([#5757](https://github.com/aws-powertools/powertools-lambda-python/issues/5757))
+* **ci:** new pre-release 3.3.1a8 ([#5663](https://github.com/aws-powertools/powertools-lambda-python/issues/5663))
+* **ci:** adding missing region in matrix ([#5777](https://github.com/aws-powertools/powertools-lambda-python/issues/5777))
+* **ci:** new pre-release 3.3.1a2 ([#5585](https://github.com/aws-powertools/powertools-lambda-python/issues/5585))
+* **ci:** new pre-release 3.3.1a11 ([#5688](https://github.com/aws-powertools/powertools-lambda-python/issues/5688))
+* **ci:** new pre-release 3.3.1a3 ([#5598](https://github.com/aws-powertools/powertools-lambda-python/issues/5598))
+* **ci:** new pre-release 3.3.1a7 ([#5656](https://github.com/aws-powertools/powertools-lambda-python/issues/5656))
+* **ci:** new pre-release 3.3.1a6 ([#5650](https://github.com/aws-powertools/powertools-lambda-python/issues/5650))
+* **ci:** new pre-release 3.3.1a12 ([#5697](https://github.com/aws-powertools/powertools-lambda-python/issues/5697))
+* **ci:** new pre-release 3.3.1a18 ([#5739](https://github.com/aws-powertools/powertools-lambda-python/issues/5739))
+* **ci:** replace closed-issue-message action with powertools action ([#5641](https://github.com/aws-powertools/powertools-lambda-python/issues/5641))
+* **ci:** new pre-release 3.3.1a17 ([#5733](https://github.com/aws-powertools/powertools-lambda-python/issues/5733))
+* **ci:** new pre-release 3.3.1a4 ([#5612](https://github.com/aws-powertools/powertools-lambda-python/issues/5612))
+* **ci:** new pre-release 3.3.1a13 ([#5707](https://github.com/aws-powertools/powertools-lambda-python/issues/5707))
+* **ci:** new pre-release 3.3.1a16 ([#5725](https://github.com/aws-powertools/powertools-lambda-python/issues/5725))
+* **ci:** remove poetry cache in quality check pipeline ([#5626](https://github.com/aws-powertools/powertools-lambda-python/issues/5626))
+* **ci:** revert closed issue action update ([#5637](https://github.com/aws-powertools/powertools-lambda-python/issues/5637))
+* **ci:** new pre-release 3.3.1a15 ([#5720](https://github.com/aws-powertools/powertools-lambda-python/issues/5720))
+* **ci:** new pre-release 3.3.1a5 ([#5639](https://github.com/aws-powertools/powertools-lambda-python/issues/5639))
+* **deps:** bump squidfunk/mkdocs-material from `ef0b45e` to `d063d84` in /docs ([#5649](https://github.com/aws-powertools/powertools-lambda-python/issues/5649))
+* **deps:** bump pydantic from 2.10.0 to 2.10.1 ([#5632](https://github.com/aws-powertools/powertools-lambda-python/issues/5632))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.12.2 to 1.12.3 ([#5709](https://github.com/aws-powertools/powertools-lambda-python/issues/5709))
+* **deps:** bump codecov/codecov-action from 5.0.3 to 5.0.7 ([#5617](https://github.com/aws-powertools/powertools-lambda-python/issues/5617))
+* **deps:** bump actions/dependency-review-action from 4.4.0 to 4.5.0 ([#5616](https://github.com/aws-powertools/powertools-lambda-python/issues/5616))
+* **deps:** bump squidfunk/mkdocs-material from `ce587cb` to `ef0b45e` in /docs ([#5603](https://github.com/aws-powertools/powertools-lambda-python/issues/5603))
+* **deps:** bump squidfunk/mkdocs-material from `d063d84` to `3f571e7` in /docs ([#5678](https://github.com/aws-powertools/powertools-lambda-python/issues/5678))
+* **deps:** bump redis from 5.2.0 to 5.2.1 ([#5701](https://github.com/aws-powertools/powertools-lambda-python/issues/5701))
+* **deps:** bump pydantic-settings from 2.6.1 to 2.7.0 ([#5735](https://github.com/aws-powertools/powertools-lambda-python/issues/5735))
+* **deps:** bump aws-actions/closed-issue-message from 80edfc24bdf1283400eb04d20a8a605ae8bf7d48 to 37548691e7cc75ba58f85c9f873f9eee43590449 ([#5606](https://github.com/aws-powertools/powertools-lambda-python/issues/5606))
+* **deps:** bump pydantic from 2.9.2 to 2.10.0 ([#5611](https://github.com/aws-powertools/powertools-lambda-python/issues/5611))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.17 to 3.0.18 ([#5743](https://github.com/aws-powertools/powertools-lambda-python/issues/5743))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.16 to 3.0.17 ([#5643](https://github.com/aws-powertools/powertools-lambda-python/issues/5643))
+* **deps:** bump squidfunk/mkdocs-material from `3f571e7` to `d485eb6` in /docs ([#5710](https://github.com/aws-powertools/powertools-lambda-python/issues/5710))
+* **deps:** bump codecov/codecov-action from 5.0.7 to 5.1.0 ([#5692](https://github.com/aws-powertools/powertools-lambda-python/issues/5692))
+* **deps:** bump pydantic from 2.10.1 to 2.10.2 ([#5654](https://github.com/aws-powertools/powertools-lambda-python/issues/5654))
+* **deps:** bump squidfunk/mkdocs-material from `d485eb6` to `ba73db5` in /docs ([#5746](https://github.com/aws-powertools/powertools-lambda-python/issues/5746))
+* **deps:** bump docker/setup-buildx-action from 3.7.1 to 3.8.0 ([#5744](https://github.com/aws-powertools/powertools-lambda-python/issues/5744))
+* **deps:** bump datadog-lambda from 6.101.0 to 6.102.0 ([#5570](https://github.com/aws-powertools/powertools-lambda-python/issues/5570))
+* **deps:** bump pydantic from 2.10.2 to 2.10.3 ([#5682](https://github.com/aws-powertools/powertools-lambda-python/issues/5682))
+* **deps:** bump aws-encryption-sdk from 3.3.0 to 4.0.0 ([#5564](https://github.com/aws-powertools/powertools-lambda-python/issues/5564))
+* **deps:** bump pydantic from 2.10.3 to 2.10.4 ([#5760](https://github.com/aws-powertools/powertools-lambda-python/issues/5760))
+* **deps:** bump actions/upload-artifact from 4.4.3 to 4.5.0 ([#5763](https://github.com/aws-powertools/powertools-lambda-python/issues/5763))
+* **deps:** bump codecov/codecov-action from 5.1.1 to 5.1.2 ([#5764](https://github.com/aws-powertools/powertools-lambda-python/issues/5764))
+* **deps:** bump codecov/codecov-action from 4.6.0 to 5.0.2 ([#5567](https://github.com/aws-powertools/powertools-lambda-python/issues/5567))
+* **deps:** bump fastjsonschema from 2.20.0 to 2.21.1 ([#5676](https://github.com/aws-powertools/powertools-lambda-python/issues/5676))
+* **deps:** bump datadog-lambda from 6.102.0 to 6.104.0 ([#5631](https://github.com/aws-powertools/powertools-lambda-python/issues/5631))
+* **deps:** bump codecov/codecov-action from 5.1.0 to 5.1.1 ([#5703](https://github.com/aws-powertools/powertools-lambda-python/issues/5703))
+* **deps:** bump codecov/codecov-action from 5.0.2 to 5.0.3 ([#5592](https://github.com/aws-powertools/powertools-lambda-python/issues/5592))
+* **deps-dev:** bump httpx from 0.27.2 to 0.28.0 ([#5665](https://github.com/aws-powertools/powertools-lambda-python/issues/5665))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.171.0a0 to 2.171.1a0 ([#5666](https://github.com/aws-powertools/powertools-lambda-python/issues/5666))
+* **deps-dev:** bump aws-cdk from 2.171.0 to 2.171.1 ([#5662](https://github.com/aws-powertools/powertools-lambda-python/issues/5662))
+* **deps-dev:** bump aws-cdk-lib from 2.171.0 to 2.171.1 ([#5661](https://github.com/aws-powertools/powertools-lambda-python/issues/5661))
+* **deps-dev:** bump boto3-stubs from 1.35.69 to 1.35.71 ([#5660](https://github.com/aws-powertools/powertools-lambda-python/issues/5660))
+* **deps-dev:** bump cfn-lint from 1.20.0 to 1.20.1 ([#5659](https://github.com/aws-powertools/powertools-lambda-python/issues/5659))
+* **deps-dev:** bump mkdocs-material from 9.5.46 to 9.5.47 ([#5677](https://github.com/aws-powertools/powertools-lambda-python/issues/5677))
+* **deps-dev:** bump cfn-lint from 1.20.1 to 1.20.2 ([#5686](https://github.com/aws-powertools/powertools-lambda-python/issues/5686))
+* **deps-dev:** bump boto3-stubs from 1.35.71 to 1.35.74 ([#5691](https://github.com/aws-powertools/powertools-lambda-python/issues/5691))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.284 to 0.1.285 ([#5642](https://github.com/aws-powertools/powertools-lambda-python/issues/5642))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.170.0a0 to 2.171.0a0 ([#5655](https://github.com/aws-powertools/powertools-lambda-python/issues/5655))
+* **deps-dev:** bump ruff from 0.8.1 to 0.8.2 ([#5693](https://github.com/aws-powertools/powertools-lambda-python/issues/5693))
+* **deps-dev:** bump pytest from 8.3.3 to 8.3.4 ([#5695](https://github.com/aws-powertools/powertools-lambda-python/issues/5695))
+* **deps-dev:** bump mkdocs-material from 9.5.45 to 9.5.46 ([#5645](https://github.com/aws-powertools/powertools-lambda-python/issues/5645))
+* **deps-dev:** bump sentry-sdk from 2.19.0 to 2.19.1 ([#5694](https://github.com/aws-powertools/powertools-lambda-python/issues/5694))
+* **deps-dev:** bump aws-cdk-lib from 2.170.0 to 2.171.0 ([#5647](https://github.com/aws-powertools/powertools-lambda-python/issues/5647))
+* **deps-dev:** bump aws-cdk from 2.170.0 to 2.171.0 ([#5648](https://github.com/aws-powertools/powertools-lambda-python/issues/5648))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.285 to 0.1.287 ([#5685](https://github.com/aws-powertools/powertools-lambda-python/issues/5685))
+* **deps-dev:** bump boto3-stubs from 1.35.67 to 1.35.69 ([#5652](https://github.com/aws-powertools/powertools-lambda-python/issues/5652))
+* **deps-dev:** bump sentry-sdk from 2.19.1 to 2.19.2 ([#5699](https://github.com/aws-powertools/powertools-lambda-python/issues/5699))
+* **deps-dev:** bump ruff from 0.7.4 to 0.8.0 ([#5630](https://github.com/aws-powertools/powertools-lambda-python/issues/5630))
+* **deps-dev:** bump types-python-dateutil from 2.9.0.20241003 to 2.9.0.20241206 ([#5700](https://github.com/aws-powertools/powertools-lambda-python/issues/5700))
+* **deps-dev:** bump httpx from 0.28.0 to 0.28.1 ([#5702](https://github.com/aws-powertools/powertools-lambda-python/issues/5702))
+* **deps-dev:** bump aws-cdk from 2.171.1 to 2.172.0 ([#5712](https://github.com/aws-powertools/powertools-lambda-python/issues/5712))
+* **deps-dev:** bump cfn-lint from 1.20.2 to 1.21.0 ([#5711](https://github.com/aws-powertools/powertools-lambda-python/issues/5711))
+* **deps-dev:** bump boto3-stubs from 1.35.76 to 1.35.77 ([#5716](https://github.com/aws-powertools/powertools-lambda-python/issues/5716))
+* **deps-dev:** bump aws-cdk-lib from 2.171.1 to 2.172.0 ([#5719](https://github.com/aws-powertools/powertools-lambda-python/issues/5719))
+* **deps-dev:** bump cfn-lint from 1.21.0 to 1.22.0 ([#5718](https://github.com/aws-powertools/powertools-lambda-python/issues/5718))
+* **deps-dev:** bump aws-cdk from 2.169.0 to 2.170.0 ([#5628](https://github.com/aws-powertools/powertools-lambda-python/issues/5628))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.167.2a0 to 2.170.0a0 ([#5629](https://github.com/aws-powertools/powertools-lambda-python/issues/5629))
+* **deps-dev:** bump boto3-stubs from 1.35.77 to 1.35.78 ([#5723](https://github.com/aws-powertools/powertools-lambda-python/issues/5723))
+* **deps-dev:** bump sentry-sdk from 2.18.0 to 2.19.0 ([#5633](https://github.com/aws-powertools/powertools-lambda-python/issues/5633))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.171.1a0 to 2.172.0a0 ([#5724](https://github.com/aws-powertools/powertools-lambda-python/issues/5724))
+* **deps-dev:** bump aws-cdk from 2.172.0 to 2.173.0 ([#5727](https://github.com/aws-powertools/powertools-lambda-python/issues/5727))
+* **deps-dev:** bump mkdocs-material from 9.5.44 to 9.5.45 ([#5610](https://github.com/aws-powertools/powertools-lambda-python/issues/5610))
+* **deps-dev:** bump ruff from 0.8.2 to 0.8.3 ([#5728](https://github.com/aws-powertools/powertools-lambda-python/issues/5728))
+* **deps-dev:** bump boto3-stubs from 1.35.64 to 1.35.67 ([#5621](https://github.com/aws-powertools/powertools-lambda-python/issues/5621))
+* **deps-dev:** bump aws-cdk-lib from 2.167.2 to 2.170.0 ([#5622](https://github.com/aws-powertools/powertools-lambda-python/issues/5622))
+* **deps-dev:** bump cfn-lint from 1.22.0 to 1.22.1 ([#5729](https://github.com/aws-powertools/powertools-lambda-python/issues/5729))
+* **deps-dev:** bump aws-cdk from 2.167.2 to 2.169.0 ([#5618](https://github.com/aws-powertools/powertools-lambda-python/issues/5618))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.282 to 0.1.284 ([#5607](https://github.com/aws-powertools/powertools-lambda-python/issues/5607))
+* **deps-dev:** bump boto3-stubs from 1.35.78 to 1.35.80 ([#5730](https://github.com/aws-powertools/powertools-lambda-python/issues/5730))
+* **deps-dev:** bump aws-cdk-lib from 2.172.0 to 2.173.0 ([#5731](https://github.com/aws-powertools/powertools-lambda-python/issues/5731))
+* **deps-dev:** bump mkdocs-material from 9.5.47 to 9.5.48 ([#5717](https://github.com/aws-powertools/powertools-lambda-python/issues/5717))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.172.0a0 to 2.173.0a0 ([#5736](https://github.com/aws-powertools/powertools-lambda-python/issues/5736))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.167.1a0 to 2.167.2a0 ([#5619](https://github.com/aws-powertools/powertools-lambda-python/issues/5619))
+* **deps-dev:** bump boto3-stubs from 1.35.80 to 1.35.81 ([#5750](https://github.com/aws-powertools/powertools-lambda-python/issues/5750))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.281 to 0.1.282 ([#5594](https://github.com/aws-powertools/powertools-lambda-python/issues/5594))
+* **deps-dev:** bump cfn-lint from 1.19.0 to 1.20.0 ([#5595](https://github.com/aws-powertools/powertools-lambda-python/issues/5595))
+* **deps-dev:** bump aws-cdk from 2.167.1 to 2.167.2 ([#5593](https://github.com/aws-powertools/powertools-lambda-python/issues/5593))
+* **deps-dev:** bump cfn-lint from 1.22.1 to 1.22.2 ([#5749](https://github.com/aws-powertools/powertools-lambda-python/issues/5749))
+* **deps-dev:** bump aws-cdk-lib from 2.167.1 to 2.167.2 ([#5596](https://github.com/aws-powertools/powertools-lambda-python/issues/5596))
+* **deps-dev:** bump aws-cdk from 2.173.0 to 2.173.1 ([#5745](https://github.com/aws-powertools/powertools-lambda-python/issues/5745))
+* **deps-dev:** bump boto3-stubs from 1.35.63 to 1.35.64 ([#5582](https://github.com/aws-powertools/powertools-lambda-python/issues/5582))
+* **deps-dev:** bump mkdocs-material from 9.5.48 to 9.5.49 ([#5748](https://github.com/aws-powertools/powertools-lambda-python/issues/5748))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.167.0a0 to 2.167.1a0 ([#5583](https://github.com/aws-powertools/powertools-lambda-python/issues/5583))
+* **deps-dev:** bump aws-cdk-lib from 2.173.0 to 2.173.1 ([#5747](https://github.com/aws-powertools/powertools-lambda-python/issues/5747))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.173.0a0 to 2.173.1a0 ([#5755](https://github.com/aws-powertools/powertools-lambda-python/issues/5755))
+* **deps-dev:** bump aws-cdk from 2.173.1 to 2.173.2 ([#5762](https://github.com/aws-powertools/powertools-lambda-python/issues/5762))
+* **deps-dev:** bump boto3-stubs from 1.35.81 to 1.35.84 ([#5765](https://github.com/aws-powertools/powertools-lambda-python/issues/5765))
+* **deps-dev:** bump boto3-stubs from 1.35.60 to 1.35.63 ([#5581](https://github.com/aws-powertools/powertools-lambda-python/issues/5581))
+* **deps-dev:** bump ruff from 0.8.0 to 0.8.1 ([#5671](https://github.com/aws-powertools/powertools-lambda-python/issues/5671))
+* **deps-dev:** bump aws-cdk from 2.167.0 to 2.167.1 ([#5572](https://github.com/aws-powertools/powertools-lambda-python/issues/5572))
+* **deps-dev:** bump boto3-stubs from 1.35.84 to 1.35.85 ([#5770](https://github.com/aws-powertools/powertools-lambda-python/issues/5770))
+* **deps-dev:** bump ruff from 0.7.3 to 0.7.4 ([#5569](https://github.com/aws-powertools/powertools-lambda-python/issues/5569))
+* **deps-dev:** bump aws-cdk-lib from 2.167.0 to 2.167.1 ([#5568](https://github.com/aws-powertools/powertools-lambda-python/issues/5568))
+* **deps-dev:** bump ruff from 0.8.3 to 0.8.4 ([#5772](https://github.com/aws-powertools/powertools-lambda-python/issues/5772))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.173.1a0 to 2.173.2a0 ([#5771](https://github.com/aws-powertools/powertools-lambda-python/issues/5771))
+* **deps-dev:** bump aws-cdk-lib from 2.173.1 to 2.173.2 ([#5759](https://github.com/aws-powertools/powertools-lambda-python/issues/5759))
+* **layers:** balance Python 3.13 layers in GovCloud partition ([#5579](https://github.com/aws-powertools/powertools-lambda-python/issues/5579))
+
+
+<a name="v3.3.0"></a>
+## [v3.3.0] - 2024-11-14
+## Bug Fixes
+
+* **appsync:** make contextual data accessible for async functions ([#5317](https://github.com/aws-powertools/powertools-lambda-python/issues/5317))
+* **ci:** Update output to something easily copy/pasteable ([#5435](https://github.com/aws-powertools/powertools-lambda-python/issues/5435))
+* **ci:** remove space ([#5433](https://github.com/aws-powertools/powertools-lambda-python/issues/5433))
+* **metrics:** add warning for invalid dimension values; prevent their addition to EMF blobs ([#5542](https://github.com/aws-powertools/powertools-lambda-python/issues/5542))
+* **parameters:** fix force_fetch feature when working with get_parameters ([#5515](https://github.com/aws-powertools/powertools-lambda-python/issues/5515))
+* **parser:** support TypeAdapter instances as models ([#5535](https://github.com/aws-powertools/powertools-lambda-python/issues/5535))
+
+## Documentation
+
+* **layer:** update layer version number - v3.2.0 ([#5426](https://github.com/aws-powertools/powertools-lambda-python/issues/5426))
+* **parser:** change parser documentation ([#5262](https://github.com/aws-powertools/powertools-lambda-python/issues/5262))
+
+## Features
+
+* **event_handler:** mutualTLS Security Scheme for OpenAPI ([#5484](https://github.com/aws-powertools/powertools-lambda-python/issues/5484))
+* **layers:** introduce new CDK Python constructor for Powertools Lambda Layer ([#5320](https://github.com/aws-powertools/powertools-lambda-python/issues/5320))
+* **runtime:** add Python 3.13 support ([#5527](https://github.com/aws-powertools/powertools-lambda-python/issues/5527))
+
+## Maintenance
+
+* version bump
+* **ci:** Bump CDK version to build layers and fix imports ([#5555](https://github.com/aws-powertools/powertools-lambda-python/issues/5555))
+* **ci:** new pre-release 3.2.1a0 ([#5434](https://github.com/aws-powertools/powertools-lambda-python/issues/5434))
+* **ci:** new pre-release 3.2.1a15 ([#5551](https://github.com/aws-powertools/powertools-lambda-python/issues/5551))
+* **ci:** new pre-release 3.2.1a14 ([#5545](https://github.com/aws-powertools/powertools-lambda-python/issues/5545))
+* **ci:** fix imports to build Lambda layer ([#5557](https://github.com/aws-powertools/powertools-lambda-python/issues/5557))
+* **ci:** new pre-release 3.2.1a1 ([#5443](https://github.com/aws-powertools/powertools-lambda-python/issues/5443))
+* **ci:** bump minimum required pydantic version ([#5446](https://github.com/aws-powertools/powertools-lambda-python/issues/5446))
+* **ci:** new pre-release 3.2.1a2 ([#5456](https://github.com/aws-powertools/powertools-lambda-python/issues/5456))
+* **ci:** new pre-release 3.2.1a12 ([#5524](https://github.com/aws-powertools/powertools-lambda-python/issues/5524))
+* **ci:** new pre-release 3.2.1a3 ([#5465](https://github.com/aws-powertools/powertools-lambda-python/issues/5465))
+* **ci:** new pre-release 3.2.1a4 ([#5470](https://github.com/aws-powertools/powertools-lambda-python/issues/5470))
+* **ci:** new pre-release 3.2.1a5 ([#5473](https://github.com/aws-powertools/powertools-lambda-python/issues/5473))
+* **ci:** new pre-release 3.2.1a11 ([#5517](https://github.com/aws-powertools/powertools-lambda-python/issues/5517))
+* **ci:** new pre-release 3.2.1a6 ([#5480](https://github.com/aws-powertools/powertools-lambda-python/issues/5480))
+* **ci:** new pre-release 3.2.1a7 ([#5488](https://github.com/aws-powertools/powertools-lambda-python/issues/5488))
+* **ci:** new pre-release 3.2.1a10 ([#5509](https://github.com/aws-powertools/powertools-lambda-python/issues/5509))
+* **ci:** new pre-release 3.2.1a8 ([#5497](https://github.com/aws-powertools/powertools-lambda-python/issues/5497))
+* **ci:** new pre-release 3.2.1a9 ([#5504](https://github.com/aws-powertools/powertools-lambda-python/issues/5504))
+* **ci:** new pre-release 3.2.1a13 ([#5537](https://github.com/aws-powertools/powertools-lambda-python/issues/5537))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.10.3 to 1.11.0 ([#5477](https://github.com/aws-powertools/powertools-lambda-python/issues/5477))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.15 to 3.0.16 ([#5499](https://github.com/aws-powertools/powertools-lambda-python/issues/5499))
+* **deps:** bump actions/dependency-review-action from 4.3.4 to 4.3.5 ([#5431](https://github.com/aws-powertools/powertools-lambda-python/issues/5431))
+* **deps:** bump actions/setup-python from 5.2.0 to 5.3.0 ([#5529](https://github.com/aws-powertools/powertools-lambda-python/issues/5529))
+* **deps:** bump datadog-lambda from 6.99.0 to 6.100.0 ([#5491](https://github.com/aws-powertools/powertools-lambda-python/issues/5491))
+* **deps:** bump actions/checkout from 4.2.1 to 4.2.2 ([#5438](https://github.com/aws-powertools/powertools-lambda-python/issues/5438))
+* **deps:** bump actions/checkout from 4.2.0 to 4.2.2 ([#5531](https://github.com/aws-powertools/powertools-lambda-python/issues/5531))
+* **deps:** bump actions/setup-node from 4.0.4 to 4.1.0 ([#5450](https://github.com/aws-powertools/powertools-lambda-python/issues/5450))
+* **deps:** bump squidfunk/mkdocs-material from `2c2802b` to `ce587cb` in /docs ([#5507](https://github.com/aws-powertools/powertools-lambda-python/issues/5507))
+* **deps:** bump actions/setup-python from 5.2.0 to 5.3.0 ([#5449](https://github.com/aws-powertools/powertools-lambda-python/issues/5449))
+* **deps:** bump redis from 5.1.1 to 5.2.0 ([#5454](https://github.com/aws-powertools/powertools-lambda-python/issues/5454))
+* **deps:** bump docker/setup-buildx-action from 2.4.1 to 3.7.1 ([#5530](https://github.com/aws-powertools/powertools-lambda-python/issues/5530))
+* **deps:** bump squidfunk/mkdocs-material from `31eb7f7` to `2c2802b` in /docs ([#5487](https://github.com/aws-powertools/powertools-lambda-python/issues/5487))
+* **deps:** bump docker/setup-qemu-action from 2.1.0 to 3.2.0 ([#5528](https://github.com/aws-powertools/powertools-lambda-python/issues/5528))
+* **deps:** bump actions/dependency-review-action from 4.3.5 to 4.4.0 ([#5469](https://github.com/aws-powertools/powertools-lambda-python/issues/5469))
+* **deps:** bump datadog-lambda from 6.100.0 to 6.101.0 ([#5513](https://github.com/aws-powertools/powertools-lambda-python/issues/5513))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.11.0 to 1.12.1 ([#5514](https://github.com/aws-powertools/powertools-lambda-python/issues/5514))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.12.1 to 1.12.2 ([#5519](https://github.com/aws-powertools/powertools-lambda-python/issues/5519))
+* **deps-dev:** bump sentry-sdk from 2.17.0 to 2.18.0 ([#5502](https://github.com/aws-powertools/powertools-lambda-python/issues/5502))
+* **deps-dev:** bump boto3-stubs from 1.35.51 to 1.35.52 ([#5478](https://github.com/aws-powertools/powertools-lambda-python/issues/5478))
+* **deps-dev:** bump mkdocs-material from 9.5.43 to 9.5.44 ([#5506](https://github.com/aws-powertools/powertools-lambda-python/issues/5506))
+* **deps-dev:** bump cfn-lint from 1.18.2 to 1.18.3 ([#5479](https://github.com/aws-powertools/powertools-lambda-python/issues/5479))
+* **deps-dev:** bump boto3-stubs from 1.35.49 to 1.35.51 ([#5472](https://github.com/aws-powertools/powertools-lambda-python/issues/5472))
+* **deps-dev:** bump aws-cdk from 2.165.0 to 2.166.0 ([#5520](https://github.com/aws-powertools/powertools-lambda-python/issues/5520))
+* **deps-dev:** bump aws-cdk-lib from 2.165.0 to 2.166.0 ([#5522](https://github.com/aws-powertools/powertools-lambda-python/issues/5522))
+* **deps-dev:** bump boto3-stubs from 1.35.52 to 1.35.53 ([#5485](https://github.com/aws-powertools/powertools-lambda-python/issues/5485))
+* **deps-dev:** bump cfn-lint from 1.18.1 to 1.18.2 ([#5468](https://github.com/aws-powertools/powertools-lambda-python/issues/5468))
+* **deps-dev:** bump boto3-stubs from 1.35.54 to 1.35.56 ([#5523](https://github.com/aws-powertools/powertools-lambda-python/issues/5523))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.163.1a0 to 2.164.1a0 ([#5467](https://github.com/aws-powertools/powertools-lambda-python/issues/5467))
+* **deps-dev:** bump mkdocs-material from 9.5.42 to 9.5.43 ([#5486](https://github.com/aws-powertools/powertools-lambda-python/issues/5486))
+* **deps-dev:** bump aws-cdk from 2.164.0 to 2.164.1 ([#5462](https://github.com/aws-powertools/powertools-lambda-python/issues/5462))
+* **deps-dev:** bump boto3-stubs from 1.35.46 to 1.35.49 ([#5460](https://github.com/aws-powertools/powertools-lambda-python/issues/5460))
+* **deps-dev:** bump aws-cdk-lib from 2.164.0 to 2.164.1 ([#5459](https://github.com/aws-powertools/powertools-lambda-python/issues/5459))
+* **deps-dev:** bump ruff from 0.7.0 to 0.7.1 ([#5451](https://github.com/aws-powertools/powertools-lambda-python/issues/5451))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.278 to 0.1.279 ([#5512](https://github.com/aws-powertools/powertools-lambda-python/issues/5512))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.165.0a0 to 2.166.0a0 ([#5533](https://github.com/aws-powertools/powertools-lambda-python/issues/5533))
+* **deps-dev:** bump aws-cdk-lib from 2.163.1 to 2.164.0 ([#5453](https://github.com/aws-powertools/powertools-lambda-python/issues/5453))
+* **deps-dev:** bump aws-cdk from 2.163.1 to 2.164.0 ([#5452](https://github.com/aws-powertools/powertools-lambda-python/issues/5452))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.279 to 0.1.281 ([#5548](https://github.com/aws-powertools/powertools-lambda-python/issues/5548))
+* **deps-dev:** bump aws-cdk-lib from 2.164.1 to 2.165.0 ([#5490](https://github.com/aws-powertools/powertools-lambda-python/issues/5490))
+* **deps-dev:** bump boto3-stubs from 1.35.53 to 1.35.54 ([#5493](https://github.com/aws-powertools/powertools-lambda-python/issues/5493))
+* **deps-dev:** bump aws-cdk from 2.164.1 to 2.165.0 ([#5494](https://github.com/aws-powertools/powertools-lambda-python/issues/5494))
+* **deps-dev:** bump mypy from 1.11.2 to 1.13.0 ([#5440](https://github.com/aws-powertools/powertools-lambda-python/issues/5440))
+* **deps-dev:** bump ruff from 0.7.2 to 0.7.3 ([#5532](https://github.com/aws-powertools/powertools-lambda-python/issues/5532))
+* **deps-dev:** bump boto3-stubs from 1.35.56 to 1.35.58 ([#5540](https://github.com/aws-powertools/powertools-lambda-python/issues/5540))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.162.1a0 to 2.163.1a0 ([#5441](https://github.com/aws-powertools/powertools-lambda-python/issues/5441))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.277 to 0.1.278 ([#5439](https://github.com/aws-powertools/powertools-lambda-python/issues/5439))
+* **deps-dev:** bump cfn-lint from 1.18.3 to 1.18.4 ([#5501](https://github.com/aws-powertools/powertools-lambda-python/issues/5501))
+* **deps-dev:** bump cfn-lint from 1.18.4 to 1.19.0 ([#5544](https://github.com/aws-powertools/powertools-lambda-python/issues/5544))
+* **deps-dev:** bump ruff from 0.7.1 to 0.7.2 ([#5492](https://github.com/aws-powertools/powertools-lambda-python/issues/5492))
+* **deps-dev:** bump aws-cdk-lib from 2.162.1 to 2.163.1 ([#5429](https://github.com/aws-powertools/powertools-lambda-python/issues/5429))
+* **deps-dev:** bump boto3-stubs from 1.35.45 to 1.35.46 ([#5430](https://github.com/aws-powertools/powertools-lambda-python/issues/5430))
+* **deps-dev:** bump aws-cdk from 2.162.1 to 2.163.1 ([#5432](https://github.com/aws-powertools/powertools-lambda-python/issues/5432))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.164.1a0 to 2.165.0a0 ([#5500](https://github.com/aws-powertools/powertools-lambda-python/issues/5500))
+* **deps-dev:** bump xenon from 0.9.1 to 0.9.3 ([#5428](https://github.com/aws-powertools/powertools-lambda-python/issues/5428))
+* **deps-dev:** bump boto3-stubs from 1.35.58 to 1.35.59 ([#5549](https://github.com/aws-powertools/powertools-lambda-python/issues/5549))
+* **layers:** add pydantic-settings package to v3 Layer ([#5516](https://github.com/aws-powertools/powertools-lambda-python/issues/5516))
+
+
+<a name="v3.2.0"></a>
+## [v3.2.0] - 2024-10-22
+## Bug Fixes
+
+* test command in verify step ([#5381](https://github.com/aws-powertools/powertools-lambda-python/issues/5381))
+* **ci:** Tables are nicer ([#5416](https://github.com/aws-powertools/powertools-lambda-python/issues/5416))
+* **ci:** GovCloud layer verification ([#5382](https://github.com/aws-powertools/powertools-lambda-python/issues/5382))
+* **ci:** Update partition name ([#5380](https://github.com/aws-powertools/powertools-lambda-python/issues/5380))
+* **layer:** update partition name in the GovCloud workflow ([#5379](https://github.com/aws-powertools/powertools-lambda-python/issues/5379))
+
+## Documentation
+
+* Add GovCloud layer info ([#5414](https://github.com/aws-powertools/powertools-lambda-python/issues/5414))
+* **event_handler:** add Terraform payload info for API Gateway HTTP API ([#5351](https://github.com/aws-powertools/powertools-lambda-python/issues/5351))
+* **examples:** temporarily fix SAR version to v2.x ([#5360](https://github.com/aws-powertools/powertools-lambda-python/issues/5360))
+* **layer:** update layer version number ([#5344](https://github.com/aws-powertools/powertools-lambda-python/issues/5344))
+* **upgrade_guide:** update Lambda layer name ([#5347](https://github.com/aws-powertools/powertools-lambda-python/issues/5347))
+
+## Features
+
+* **ci:** GovCloud Layer Workflow ([#5261](https://github.com/aws-powertools/powertools-lambda-python/issues/5261))
+* **logger:** add thread safe logging keys ([#5141](https://github.com/aws-powertools/powertools-lambda-python/issues/5141))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.1.1a0 ([#5353](https://github.com/aws-powertools/powertools-lambda-python/issues/5353))
+* **ci:** Add dump of govcloud layer info in verify step ([#5415](https://github.com/aws-powertools/powertools-lambda-python/issues/5415))
+* **deps:** bump squidfunk/mkdocs-material from `f9cb76d` to `0d4e687` in /docs ([#5395](https://github.com/aws-powertools/powertools-lambda-python/issues/5395))
+* **deps:** bump actions/upload-artifact from 4.4.1 to 4.4.3 ([#5357](https://github.com/aws-powertools/powertools-lambda-python/issues/5357))
+* **deps:** bump squidfunk/mkdocs-material from `8e8b333` to `f9cb76d` in /docs ([#5366](https://github.com/aws-powertools/powertools-lambda-python/issues/5366))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.14 to 3.0.15 ([#5418](https://github.com/aws-powertools/powertools-lambda-python/issues/5418))
+* **deps:** bump jsonpath-ng from 1.6.1 to 1.7.0 ([#5369](https://github.com/aws-powertools/powertools-lambda-python/issues/5369))
+* **deps:** bump squidfunk/mkdocs-material from `0d4e687` to `31eb7f7` in /docs ([#5417](https://github.com/aws-powertools/powertools-lambda-python/issues/5417))
+* **deps:** bump actions/upload-artifact from 4.4.0 to 4.4.3 ([#5373](https://github.com/aws-powertools/powertools-lambda-python/issues/5373))
+* **deps-dev:** bump boto3-stubs from 1.35.38 to 1.35.39 ([#5370](https://github.com/aws-powertools/powertools-lambda-python/issues/5370))
+* **deps-dev:** bump boto3-stubs from 1.35.39 to 1.35.41 ([#5392](https://github.com/aws-powertools/powertools-lambda-python/issues/5392))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.161.1a0 to 2.162.1a0 ([#5386](https://github.com/aws-powertools/powertools-lambda-python/issues/5386))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.274 to 0.1.275 ([#5406](https://github.com/aws-powertools/powertools-lambda-python/issues/5406))
+* **deps-dev:** bump boto3-stubs from 1.35.43 to 1.35.44 ([#5407](https://github.com/aws-powertools/powertools-lambda-python/issues/5407))
+* **deps-dev:** bump cfn-lint from 1.17.2 to 1.18.1 ([#5423](https://github.com/aws-powertools/powertools-lambda-python/issues/5423))
+* **deps-dev:** bump cfn-lint from 1.17.1 to 1.17.2 ([#5408](https://github.com/aws-powertools/powertools-lambda-python/issues/5408))
+* **deps-dev:** bump aws-cdk-lib from 2.161.1 to 2.162.1 ([#5371](https://github.com/aws-powertools/powertools-lambda-python/issues/5371))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.273 to 0.1.274 ([#5394](https://github.com/aws-powertools/powertools-lambda-python/issues/5394))
+* **deps-dev:** bump aws-cdk from 2.161.1 to 2.162.1 ([#5372](https://github.com/aws-powertools/powertools-lambda-python/issues/5372))
+* **deps-dev:** bump boto3-stubs from 1.35.41 to 1.35.42 ([#5397](https://github.com/aws-powertools/powertools-lambda-python/issues/5397))
+* **deps-dev:** bump cfn-lint from 1.16.1 to 1.17.1 ([#5404](https://github.com/aws-powertools/powertools-lambda-python/issues/5404))
+* **deps-dev:** bump mkdocs-material from 9.5.40 to 9.5.41 ([#5393](https://github.com/aws-powertools/powertools-lambda-python/issues/5393))
+* **deps-dev:** bump cfn-lint from 1.16.0 to 1.16.1 ([#5363](https://github.com/aws-powertools/powertools-lambda-python/issues/5363))
+* **deps-dev:** bump boto3-stubs from 1.35.37 to 1.35.38 ([#5364](https://github.com/aws-powertools/powertools-lambda-python/issues/5364))
+* **deps-dev:** bump mkdocs-material from 9.5.39 to 9.5.40 ([#5365](https://github.com/aws-powertools/powertools-lambda-python/issues/5365))
+* **deps-dev:** bump ruff from 0.6.9 to 0.7.0 ([#5403](https://github.com/aws-powertools/powertools-lambda-python/issues/5403))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.275 to 0.1.277 ([#5419](https://github.com/aws-powertools/powertools-lambda-python/issues/5419))
+* **deps-dev:** bump boto3-stubs from 1.35.42 to 1.35.43 ([#5402](https://github.com/aws-powertools/powertools-lambda-python/issues/5402))
+* **deps-dev:** bump boto3-stubs from 1.35.36 to 1.35.37 ([#5356](https://github.com/aws-powertools/powertools-lambda-python/issues/5356))
+* **deps-dev:** bump nox from 2024.4.15 to 2024.10.9 ([#5355](https://github.com/aws-powertools/powertools-lambda-python/issues/5355))
+* **deps-dev:** bump mkdocs-material from 9.5.41 to 9.5.42 ([#5420](https://github.com/aws-powertools/powertools-lambda-python/issues/5420))
+* **deps-dev:** bump boto3-stubs from 1.35.44 to 1.35.45 ([#5421](https://github.com/aws-powertools/powertools-lambda-python/issues/5421))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.161.0a0 to 2.161.1a0 ([#5349](https://github.com/aws-powertools/powertools-lambda-python/issues/5349))
+* **deps-dev:** bump boto3-stubs from 1.35.35 to 1.35.36 ([#5350](https://github.com/aws-powertools/powertools-lambda-python/issues/5350))
+* **deps-dev:** bump sentry-sdk from 2.15.0 to 2.16.0 ([#5348](https://github.com/aws-powertools/powertools-lambda-python/issues/5348))
+* **deps-dev:** bump sentry-sdk from 2.16.0 to 2.17.0 ([#5400](https://github.com/aws-powertools/powertools-lambda-python/issues/5400))
+* **docs:** remove layer callout from data masking docs ([#5377](https://github.com/aws-powertools/powertools-lambda-python/issues/5377))
+
+
+<a name="v3.1.0"></a>
+## [v3.1.0] - 2024-10-08
+## Bug Fixes
+
+* **ci:** Layer Rename Fix ([#5291](https://github.com/aws-powertools/powertools-lambda-python/issues/5291))
+* **ci:** layer rename ([#5283](https://github.com/aws-powertools/powertools-lambda-python/issues/5283))
+* **idempotency:** fix response hook invocation when function returns None ([#5251](https://github.com/aws-powertools/powertools-lambda-python/issues/5251))
+* **layer:** reverting SSM parameter name ([#5340](https://github.com/aws-powertools/powertools-lambda-python/issues/5340))
+* **layers:** rename Lambda layer name from x86 to x86_64 ([#5226](https://github.com/aws-powertools/powertools-lambda-python/issues/5226))
+* **parser:** fallback to `validate_python` when using `type[Model]` and nested models ([#5313](https://github.com/aws-powertools/powertools-lambda-python/issues/5313))
+* **parser:** revert a regression in v3 when raising ValidationError ([#5259](https://github.com/aws-powertools/powertools-lambda-python/issues/5259))
+* **parser:** make size and etag optional for LifecycleExpiration events in S3 ([#5250](https://github.com/aws-powertools/powertools-lambda-python/issues/5250))
+
+## Code Refactoring
+
+* **examples:** fix issues reported by SonarCloud and Scorecard ([#5315](https://github.com/aws-powertools/powertools-lambda-python/issues/5315))
+
+## Documentation
+
+* **idempotency:** fix description in `Advanced` table ([#5191](https://github.com/aws-powertools/powertools-lambda-python/issues/5191))
+* **metrics:** fix test references ([#5265](https://github.com/aws-powertools/powertools-lambda-python/issues/5265))
+* **public_reference:** add Flyweight as a public reference ([#5322](https://github.com/aws-powertools/powertools-lambda-python/issues/5322))
+* **upgrade_guide:** update upgrade guide with Pydantic information ([#5316](https://github.com/aws-powertools/powertools-lambda-python/issues/5316))
+* **v3:** fix small things in the documentation ([#5224](https://github.com/aws-powertools/powertools-lambda-python/issues/5224))
+* **versioning:** add v2 maintainance mode banner ([#5240](https://github.com/aws-powertools/powertools-lambda-python/issues/5240))
+
+## Features
+
+* **event_source:** add CodeDeploy Lifecycle Hook event ([#5219](https://github.com/aws-powertools/powertools-lambda-python/issues/5219))
+* **openapi:** enable direct list input in Examples model ([#5318](https://github.com/aws-powertools/powertools-lambda-python/issues/5318))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 3.0.1a7 ([#5299](https://github.com/aws-powertools/powertools-lambda-python/issues/5299))
+* **ci:** new pre-release 3.0.1a3 ([#5270](https://github.com/aws-powertools/powertools-lambda-python/issues/5270))
+* **ci:** new pre-release 3.0.1a4 ([#5277](https://github.com/aws-powertools/powertools-lambda-python/issues/5277))
+* **ci:** new pre-release 3.0.1a2 ([#5258](https://github.com/aws-powertools/powertools-lambda-python/issues/5258))
+* **ci:** new pre-release 3.0.1a5 ([#5288](https://github.com/aws-powertools/powertools-lambda-python/issues/5288))
+* **ci:** new pre-release 3.0.1a9 ([#5337](https://github.com/aws-powertools/powertools-lambda-python/issues/5337))
+* **ci:** new pre-release 3.0.1a8 ([#5323](https://github.com/aws-powertools/powertools-lambda-python/issues/5323))
+* **ci:** new pre-release 3.0.1a0 ([#5220](https://github.com/aws-powertools/powertools-lambda-python/issues/5220))
+* **ci:** new pre-release 3.0.1a1 ([#5247](https://github.com/aws-powertools/powertools-lambda-python/issues/5247))
+* **ci:** new pre-release 3.0.1a6 ([#5293](https://github.com/aws-powertools/powertools-lambda-python/issues/5293))
+* **deps:** bump actions/download-artifact from 4.1.7 to 4.1.8 ([#5203](https://github.com/aws-powertools/powertools-lambda-python/issues/5203))
+* **deps:** bump squidfunk/mkdocs-material from `22a429f` to `08fbf58` in /docs ([#5243](https://github.com/aws-powertools/powertools-lambda-python/issues/5243))
+* **deps:** bump docker/setup-buildx-action from 3.6.1 to 3.7.0 ([#5298](https://github.com/aws-powertools/powertools-lambda-python/issues/5298))
+* **deps:** bump actions/checkout from 4.1.7 to 4.2.0 ([#5244](https://github.com/aws-powertools/powertools-lambda-python/issues/5244))
+* **deps:** bump actions/setup-node from 4.0.3 to 4.0.4 ([#5186](https://github.com/aws-powertools/powertools-lambda-python/issues/5186))
+* **deps:** bump docker/setup-buildx-action from 3.7.0 to 3.7.1 ([#5310](https://github.com/aws-powertools/powertools-lambda-python/issues/5310))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.10.2 to 1.10.3 ([#5311](https://github.com/aws-powertools/powertools-lambda-python/issues/5311))
+* **deps:** bump squidfunk/mkdocs-material from `a2e3a31` to `22a429f` in /docs ([#5201](https://github.com/aws-powertools/powertools-lambda-python/issues/5201))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.10.1 to 1.10.2 ([#5202](https://github.com/aws-powertools/powertools-lambda-python/issues/5202))
+* **deps:** bump actions/checkout from 4.2.0 to 4.2.1 ([#5329](https://github.com/aws-powertools/powertools-lambda-python/issues/5329))
+* **deps:** bump squidfunk/mkdocs-material from `08fbf58` to `7aea359` in /docs ([#5253](https://github.com/aws-powertools/powertools-lambda-python/issues/5253))
+* **deps:** bump actions/setup-python from 5.1.0 to 5.2.0 ([#5204](https://github.com/aws-powertools/powertools-lambda-python/issues/5204))
+* **deps:** bump codecov/codecov-action from 4.5.0 to 4.6.0 ([#5287](https://github.com/aws-powertools/powertools-lambda-python/issues/5287))
+* **deps:** bump redis from 5.1.0 to 5.1.1 ([#5331](https://github.com/aws-powertools/powertools-lambda-python/issues/5331))
+* **deps:** bump actions/checkout from 4.1.6 to 4.1.7 ([#5206](https://github.com/aws-powertools/powertools-lambda-python/issues/5206))
+* **deps:** bump actions/upload-artifact from 4.4.0 to 4.4.1 ([#5328](https://github.com/aws-powertools/powertools-lambda-python/issues/5328))
+* **deps:** bump actions/upload-artifact from 4.3.3 to 4.4.0 ([#5217](https://github.com/aws-powertools/powertools-lambda-python/issues/5217))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.12 to 3.0.13 ([#5276](https://github.com/aws-powertools/powertools-lambda-python/issues/5276))
+* **deps:** bump redis from 5.0.8 to 5.1.0 ([#5264](https://github.com/aws-powertools/powertools-lambda-python/issues/5264))
+* **deps:** bump datadog-lambda from 6.98.0 to 6.99.0 ([#5333](https://github.com/aws-powertools/powertools-lambda-python/issues/5333))
+* **deps:** bump squidfunk/mkdocs-material from `7aea359` to `8e8b333` in /docs ([#5272](https://github.com/aws-powertools/powertools-lambda-python/issues/5272))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.13 to 3.0.14 ([#5330](https://github.com/aws-powertools/powertools-lambda-python/issues/5330))
+* **deps:** bump docker/setup-qemu-action from 3.0.0 to 3.2.0 ([#5205](https://github.com/aws-powertools/powertools-lambda-python/issues/5205))
+* **deps-dev:** bump mkdocs-material from 9.5.38 to 9.5.39 ([#5273](https://github.com/aws-powertools/powertools-lambda-python/issues/5273))
+* **deps-dev:** bump cfn-lint from 1.15.1 to 1.15.2 ([#5274](https://github.com/aws-powertools/powertools-lambda-python/issues/5274))
+* **deps-dev:** bump boto3-stubs from 1.35.28 to 1.35.29 ([#5263](https://github.com/aws-powertools/powertools-lambda-python/issues/5263))
+* **deps-dev:** bump boto3-stubs from 1.35.34 to 1.35.35 ([#5334](https://github.com/aws-powertools/powertools-lambda-python/issues/5334))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.270 to 0.1.271 ([#5284](https://github.com/aws-powertools/powertools-lambda-python/issues/5284))
+* **deps-dev:** bump mkdocs-material from 9.5.37 to 9.5.38 ([#5255](https://github.com/aws-powertools/powertools-lambda-python/issues/5255))
+* **deps-dev:** bump ruff from 0.6.7 to 0.6.8 ([#5254](https://github.com/aws-powertools/powertools-lambda-python/issues/5254))
+* **deps-dev:** bump boto3-stubs from 1.35.27 to 1.35.28 ([#5256](https://github.com/aws-powertools/powertools-lambda-python/issues/5256))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.269 to 0.1.270 ([#5257](https://github.com/aws-powertools/powertools-lambda-python/issues/5257))
+* **deps-dev:** bump sentry-sdk from 2.14.0 to 2.15.0 ([#5285](https://github.com/aws-powertools/powertools-lambda-python/issues/5285))
+* **deps-dev:** bump boto3-stubs from 1.35.29 to 1.35.31 ([#5286](https://github.com/aws-powertools/powertools-lambda-python/issues/5286))
+* **deps-dev:** bump boto3-stubs from 1.35.31 to 1.35.32 ([#5292](https://github.com/aws-powertools/powertools-lambda-python/issues/5292))
+* **deps-dev:** bump aws-cdk-lib from 2.161.0 to 2.161.1 ([#5335](https://github.com/aws-powertools/powertools-lambda-python/issues/5335))
+* **deps-dev:** bump boto3-stubs from 1.35.32 to 1.35.33 ([#5295](https://github.com/aws-powertools/powertools-lambda-python/issues/5295))
+* **deps-dev:** bump types-python-dateutil from 2.9.0.20240906 to 2.9.0.20241003 ([#5296](https://github.com/aws-powertools/powertools-lambda-python/issues/5296))
+* **deps-dev:** bump boto3-stubs from 1.35.26 to 1.35.27 ([#5242](https://github.com/aws-powertools/powertools-lambda-python/issues/5242))
+* **deps-dev:** bump mkdocs-material from 9.5.36 to 9.5.37 ([#5241](https://github.com/aws-powertools/powertools-lambda-python/issues/5241))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.271 to 0.1.272 ([#5297](https://github.com/aws-powertools/powertools-lambda-python/issues/5297))
+* **deps-dev:** bump boto3-stubs from 1.35.25 to 1.35.26 ([#5234](https://github.com/aws-powertools/powertools-lambda-python/issues/5234))
+* **deps-dev:** bump aws-cdk from 2.159.1 to 2.160.0 ([#5233](https://github.com/aws-powertools/powertools-lambda-python/issues/5233))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.159.1a0 to 2.160.0a0 ([#5235](https://github.com/aws-powertools/powertools-lambda-python/issues/5235))
+* **deps-dev:** bump aws-cdk-lib from 2.159.1 to 2.160.0 ([#5230](https://github.com/aws-powertools/powertools-lambda-python/issues/5230))
+* **deps-dev:** bump cfn-lint from 1.15.0 to 1.15.1 ([#5232](https://github.com/aws-powertools/powertools-lambda-python/issues/5232))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.158.0a0 to 2.159.1a0 ([#5231](https://github.com/aws-powertools/powertools-lambda-python/issues/5231))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.268 to 0.1.269 ([#5229](https://github.com/aws-powertools/powertools-lambda-python/issues/5229))
+* **deps-dev:** bump aws-cdk-lib from 2.160.0 to 2.161.0 ([#5304](https://github.com/aws-powertools/powertools-lambda-python/issues/5304))
+* **deps-dev:** bump boto3-stubs from 1.35.33 to 1.35.34 ([#5306](https://github.com/aws-powertools/powertools-lambda-python/issues/5306))
+* **deps-dev:** bump types-redis from 4.6.0.20240903 to 4.6.0.20241004 ([#5307](https://github.com/aws-powertools/powertools-lambda-python/issues/5307))
+* **deps-dev:** bump aws-cdk-lib from 2.158.0 to 2.159.1 ([#5208](https://github.com/aws-powertools/powertools-lambda-python/issues/5208))
+* **deps-dev:** bump ruff from 0.6.4 to 0.6.7 ([#5207](https://github.com/aws-powertools/powertools-lambda-python/issues/5207))
+* **deps-dev:** bump aws-cdk from 2.157.0 to 2.159.1 ([#5194](https://github.com/aws-powertools/powertools-lambda-python/issues/5194))
+* **deps-dev:** bump aws-cdk from 2.160.0 to 2.161.0 ([#5309](https://github.com/aws-powertools/powertools-lambda-python/issues/5309))
+* **deps-dev:** bump ruff from 0.6.8 to 0.6.9 ([#5308](https://github.com/aws-powertools/powertools-lambda-python/issues/5308))
+* **deps-dev:** bump cfn-lint from 1.15.2 to 1.16.0 ([#5305](https://github.com/aws-powertools/powertools-lambda-python/issues/5305))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.160.0a0 to 2.161.0a0 ([#5332](https://github.com/aws-powertools/powertools-lambda-python/issues/5332))
+* **deps-dev:** bump aws-cdk from 2.161.0 to 2.161.1 ([#5327](https://github.com/aws-powertools/powertools-lambda-python/issues/5327))
+* **deps-dev:** bump mkdocs-material from 9.5.34 to 9.5.36 ([#5210](https://github.com/aws-powertools/powertools-lambda-python/issues/5210))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.272 to 0.1.273 ([#5336](https://github.com/aws-powertools/powertools-lambda-python/issues/5336))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.264 to 0.1.268 ([#5216](https://github.com/aws-powertools/powertools-lambda-python/issues/5216))
+* **deps-dev:** bump multiprocess from 0.70.16 to 0.70.17 ([#5275](https://github.com/aws-powertools/powertools-lambda-python/issues/5275))
+* **deps-dev:** bump boto3-stubs from 1.35.17 to 1.35.25 ([#5218](https://github.com/aws-powertools/powertools-lambda-python/issues/5218))
+* **deps-dev:** bump bandit from 1.7.9 to 1.7.10 ([#5214](https://github.com/aws-powertools/powertools-lambda-python/issues/5214))
+* **deps-dev:** bump cfn-lint from 1.12.4 to 1.15.0 ([#5215](https://github.com/aws-powertools/powertools-lambda-python/issues/5215))
+* **docs:** recreate requirements.txt file for mkdocs container ([#5246](https://github.com/aws-powertools/powertools-lambda-python/issues/5246))
+* **tests:** fix e2e tests in Idempotency utility ([#5280](https://github.com/aws-powertools/powertools-lambda-python/issues/5280))
+
+
+<a name="v3.0.0"></a>
+## [v3.0.0] - 2024-09-23
+## Bug Fixes
+
+* **v3:** revert unnecessary changes that impacts v3 ([#5087](https://github.com/aws-powertools/powertools-lambda-python/issues/5087))
+
+## Code Refactoring
+
+* **batch:** add from __future__ import annotations ([#4993](https://github.com/aws-powertools/powertools-lambda-python/issues/4993))
+* **batch_processing:** mark batch_processor and async_batch_processor as deprecated ([#4910](https://github.com/aws-powertools/powertools-lambda-python/issues/4910))
+* **data_classes:** add from __future__ import annotations ([#4939](https://github.com/aws-powertools/powertools-lambda-python/issues/4939))
+* **data_masking:** add from __future__ import annotations ([#4945](https://github.com/aws-powertools/powertools-lambda-python/issues/4945))
+* **event_handler:** add from __future__ import annotations ([#4992](https://github.com/aws-powertools/powertools-lambda-python/issues/4992))
+* **event_handler:** add from __future__ import annotations in the Middlewares ([#4975](https://github.com/aws-powertools/powertools-lambda-python/issues/4975))
+* **feature_flags:** add from __future__ import annotations ([#4960](https://github.com/aws-powertools/powertools-lambda-python/issues/4960))
+* **general:** drop pydantic v1 ([#4305](https://github.com/aws-powertools/powertools-lambda-python/issues/4305))
+* **idempotency:** add from __future__ import annotations ([#4961](https://github.com/aws-powertools/powertools-lambda-python/issues/4961))
+* **jmespath_utils:** deprecate extract_data_from_envelope in favor of query ([#4907](https://github.com/aws-powertools/powertools-lambda-python/issues/4907))
+* **jmespath_utils:** add from __future__ import annotations ([#4962](https://github.com/aws-powertools/powertools-lambda-python/issues/4962))
+* **logging:** add from __future__ import annotations ([#4940](https://github.com/aws-powertools/powertools-lambda-python/issues/4940))
+* **metrics:** add from __future__ import annotations ([#4944](https://github.com/aws-powertools/powertools-lambda-python/issues/4944))
+* **middleware_factory:** add from __future__ import annotations ([#4941](https://github.com/aws-powertools/powertools-lambda-python/issues/4941))
+* **openapi:** add from __future__ import annotations ([#4990](https://github.com/aws-powertools/powertools-lambda-python/issues/4990))
+* **parameters:** deprecate the config parameter in favor of boto_config ([#4893](https://github.com/aws-powertools/powertools-lambda-python/issues/4893))
+* **parameters:** add top-level get_multiple method in SSMProvider class ([#4785](https://github.com/aws-powertools/powertools-lambda-python/issues/4785))
+* **parameters:** add from __future__ import annotations ([#4976](https://github.com/aws-powertools/powertools-lambda-python/issues/4976))
+* **parameters:** increase default max_age (cache) to 5 minutes ([#4279](https://github.com/aws-powertools/powertools-lambda-python/issues/4279))
+* **parser:** add from __future__ import annotations ([#4977](https://github.com/aws-powertools/powertools-lambda-python/issues/4977))
+* **parser:** add from __future__ import annotations ([#4983](https://github.com/aws-powertools/powertools-lambda-python/issues/4983))
+* **shared:** add from __future__ import annotations ([#4942](https://github.com/aws-powertools/powertools-lambda-python/issues/4942))
+* **streaming:** add from __future__ import annotations ([#4987](https://github.com/aws-powertools/powertools-lambda-python/issues/4987))
+* **tracing:** add from __future__ import annotations ([#4943](https://github.com/aws-powertools/powertools-lambda-python/issues/4943))
+* **typing:** add from __future__ import annotations ([#4985](https://github.com/aws-powertools/powertools-lambda-python/issues/4985))
+* **typing:** enable TCH, UP and FA100 ruff rules ([#5017](https://github.com/aws-powertools/powertools-lambda-python/issues/5017))
+* **typing:** reduce aws_lambda_powertools.shared.types usage ([#4896](https://github.com/aws-powertools/powertools-lambda-python/issues/4896))
+* **typing:** enable boto3 implicit type annotations ([#4692](https://github.com/aws-powertools/powertools-lambda-python/issues/4692))
+* **typing:** move more types into TYPE_CHECKING ([#5088](https://github.com/aws-powertools/powertools-lambda-python/issues/5088))
+* **validation:** add from __future__ import annotations ([#4984](https://github.com/aws-powertools/powertools-lambda-python/issues/4984))
+
+## Documentation
+
+* **upgrade_guide:** create upgrade guide from v2 to v3 ([#5028](https://github.com/aws-powertools/powertools-lambda-python/issues/5028))
+
+## Features
+
+* **data_classes:** return empty dict or list instead of None ([#4606](https://github.com/aws-powertools/powertools-lambda-python/issues/4606))
+* **event_handler:** Ensure Bedrock Agents resolver works with Pydantic v2 ([#5156](https://github.com/aws-powertools/powertools-lambda-python/issues/5156))
+* **idempotency:** simplify access to expiration time in `DataRecord` class ([#5082](https://github.com/aws-powertools/powertools-lambda-python/issues/5082))
+* **lambda-layer:** add pipeline to build Lambda layer in v3 ([#4826](https://github.com/aws-powertools/powertools-lambda-python/issues/4826))
+* **parser:** Adds DDB deserialization to DynamoDBStreamChangedRecordModel ([#4401](https://github.com/aws-powertools/powertools-lambda-python/issues/4401))
+* **parser:** Allow primitive data types to be parsed using TypeAdapter ([#4502](https://github.com/aws-powertools/powertools-lambda-python/issues/4502))
+* **v3:** merging develop into v3 ([#5160](https://github.com/aws-powertools/powertools-lambda-python/issues/5160))
+
+## Maintenance
+
+* version bump
+* **ci:** fix bump poetry version ([#5211](https://github.com/aws-powertools/powertools-lambda-python/issues/5211))
+* **ci:** fix working-directory in v3 layer pipeline ([#5199](https://github.com/aws-powertools/powertools-lambda-python/issues/5199))
+* **ci:** fix Redis e2e tests in v3 branch ([#4852](https://github.com/aws-powertools/powertools-lambda-python/issues/4852))
+* **ci:** fix e2e tests in v3 branch ([#4848](https://github.com/aws-powertools/powertools-lambda-python/issues/4848))
+* **ci:** add the aws-encryption-sdk dependency in the Lambda layer ([#4630](https://github.com/aws-powertools/powertools-lambda-python/issues/4630))
+* **ci:** bump pydantic library to 2.0+ and boto3 to 1.34.32 ([#4235](https://github.com/aws-powertools/powertools-lambda-python/issues/4235))
+* **v3:** merging develop into v3 - 15/05/2024 ([#4335](https://github.com/aws-powertools/powertools-lambda-python/issues/4335))
+* **v3:** merging develop into v3 ([#4267](https://github.com/aws-powertools/powertools-lambda-python/issues/4267))
+
+
+<a name="v2.43.1"></a>
+## [v2.43.1] - 2024-08-12
+## Bug Fixes
+
+* **event_source:** fix regression when working with zero numbers in DynamoDBStreamEvent ([#4932](https://github.com/aws-powertools/powertools-lambda-python/issues/4932))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 2.43.1a0 ([#4920](https://github.com/aws-powertools/powertools-lambda-python/issues/4920))
+* **ci:** new pre-release 2.43.1a1 ([#4926](https://github.com/aws-powertools/powertools-lambda-python/issues/4926))
+* **ci:** new pre-release 2.42.1a9 ([#4912](https://github.com/aws-powertools/powertools-lambda-python/issues/4912))
+* **deps-dev:** bump ruff from 0.5.6 to 0.5.7 ([#4918](https://github.com/aws-powertools/powertools-lambda-python/issues/4918))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.234 to 0.1.238 ([#4917](https://github.com/aws-powertools/powertools-lambda-python/issues/4917))
+* **deps-dev:** bump mypy-boto3-ssm from 1.34.132 to 1.34.158 in the boto-typing group ([#4921](https://github.com/aws-powertools/powertools-lambda-python/issues/4921))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.238 to 0.1.242 ([#4922](https://github.com/aws-powertools/powertools-lambda-python/issues/4922))
+* **deps-dev:** bump cfn-lint from 1.9.6 to 1.9.7 ([#4923](https://github.com/aws-powertools/powertools-lambda-python/issues/4923))
+* **deps-dev:** bump cfn-lint from 1.9.5 to 1.9.6 ([#4916](https://github.com/aws-powertools/powertools-lambda-python/issues/4916))
+
+
+<a name="v2.43.0"></a>
+## [v2.43.0] - 2024-08-08
+## Bug Fixes
+
+* **data_class:** ensure DynamoDBStreamEvent conforms to decimal limits ([#4863](https://github.com/aws-powertools/powertools-lambda-python/issues/4863))
+
+## Code Refactoring
+
+* **test:** make CORS test consistent with expected behavior ([#4882](https://github.com/aws-powertools/powertools-lambda-python/issues/4882))
+* **tracer:** make capture_lambda_handler type more generic ([#4796](https://github.com/aws-powertools/powertools-lambda-python/issues/4796))
+
+## Documentation
+
+* fix type vs. field in comment ([#4832](https://github.com/aws-powertools/powertools-lambda-python/issues/4832))
+* **public_reference:** add CHS Inc. as a public reference ([#4885](https://github.com/aws-powertools/powertools-lambda-python/issues/4885))
+* **public_reference:** add LocalStack as a public reference ([#4858](https://github.com/aws-powertools/powertools-lambda-python/issues/4858))
+* **public_reference:** add Caylent as a public reference ([#4822](https://github.com/aws-powertools/powertools-lambda-python/issues/4822))
+
+## Features
+
+* **metrics:** add unit None for CloudWatch EMF Metrics ([#4904](https://github.com/aws-powertools/powertools-lambda-python/issues/4904))
+* **validation:** returns output from validate function ([#4839](https://github.com/aws-powertools/powertools-lambda-python/issues/4839))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 2.42.1a5 ([#4868](https://github.com/aws-powertools/powertools-lambda-python/issues/4868))
+* **ci:** new pre-release 2.42.1a8 ([#4903](https://github.com/aws-powertools/powertools-lambda-python/issues/4903))
+* **ci:** new pre-release 2.42.1a0 ([#4827](https://github.com/aws-powertools/powertools-lambda-python/issues/4827))
+* **ci:** new pre-release 2.42.1a7 ([#4894](https://github.com/aws-powertools/powertools-lambda-python/issues/4894))
+* **ci:** new pre-release 2.42.1a1 ([#4837](https://github.com/aws-powertools/powertools-lambda-python/issues/4837))
+* **ci:** new pre-release 2.42.1a3 ([#4856](https://github.com/aws-powertools/powertools-lambda-python/issues/4856))
+* **ci:** new pre-release 2.42.1a4 ([#4864](https://github.com/aws-powertools/powertools-lambda-python/issues/4864))
+* **ci:** new pre-release 2.42.1a6 ([#4884](https://github.com/aws-powertools/powertools-lambda-python/issues/4884))
+* **ci:** new pre-release 2.42.1a2 ([#4847](https://github.com/aws-powertools/powertools-lambda-python/issues/4847))
+* **deps:** bump golang.org/x/sync from 0.7.0 to 0.8.0 in /layer/scripts/layer-balancer in the layer-balancer group ([#4892](https://github.com/aws-powertools/powertools-lambda-python/issues/4892))
+* **deps:** bump actions/upload-artifact from 4.3.5 to 4.3.6 ([#4901](https://github.com/aws-powertools/powertools-lambda-python/issues/4901))
+* **deps:** bump actions/upload-artifact from 4.3.4 to 4.3.5 ([#4871](https://github.com/aws-powertools/powertools-lambda-python/issues/4871))
+* **deps:** bump ossf/scorecard-action from 2.3.3 to 2.4.0 ([#4829](https://github.com/aws-powertools/powertools-lambda-python/issues/4829))
+* **deps:** bump squidfunk/mkdocs-material from `257eca8` to `9919d6e` in /docs ([#4878](https://github.com/aws-powertools/powertools-lambda-python/issues/4878))
+* **deps:** bump docker/setup-buildx-action from 3.5.0 to 3.6.1 ([#4844](https://github.com/aws-powertools/powertools-lambda-python/issues/4844))
+* **deps:** bump redis from 5.0.7 to 5.0.8 ([#4854](https://github.com/aws-powertools/powertools-lambda-python/issues/4854))
+* **deps-dev:** bump ruff from 0.5.5 to 0.5.6 ([#4874](https://github.com/aws-powertools/powertools-lambda-python/issues/4874))
+* **deps-dev:** bump mypy-boto3-cloudwatch from 1.34.83 to 1.34.153 in the boto-typing group ([#4887](https://github.com/aws-powertools/powertools-lambda-python/issues/4887))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.224 to 0.1.228 ([#4867](https://github.com/aws-powertools/powertools-lambda-python/issues/4867))
+* **deps-dev:** bump cfn-lint from 1.9.1 to 1.9.3 ([#4866](https://github.com/aws-powertools/powertools-lambda-python/issues/4866))
+* **deps-dev:** bump sentry-sdk from 2.11.0 to 2.12.0 ([#4861](https://github.com/aws-powertools/powertools-lambda-python/issues/4861))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.228 to 0.1.230 ([#4876](https://github.com/aws-powertools/powertools-lambda-python/issues/4876))
+* **deps-dev:** bump black from 24.4.2 to 24.8.0 ([#4873](https://github.com/aws-powertools/powertools-lambda-python/issues/4873))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.223 to 0.1.224 ([#4855](https://github.com/aws-powertools/powertools-lambda-python/issues/4855))
+* **deps-dev:** bump mypy-boto3-logs from 1.34.66 to 1.34.151 in the boto-typing group ([#4853](https://github.com/aws-powertools/powertools-lambda-python/issues/4853))
+* **deps-dev:** bump coverage from 7.6.0 to 7.6.1 ([#4888](https://github.com/aws-powertools/powertools-lambda-python/issues/4888))
+* **deps-dev:** bump cfn-lint from 1.8.2 to 1.9.1 ([#4851](https://github.com/aws-powertools/powertools-lambda-python/issues/4851))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.150.0a0 to 2.151.0a0 ([#4889](https://github.com/aws-powertools/powertools-lambda-python/issues/4889))
+* **deps-dev:** bump aws-cdk from 2.150.0 to 2.151.0 ([#4872](https://github.com/aws-powertools/powertools-lambda-python/issues/4872))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.219 to 0.1.222 ([#4836](https://github.com/aws-powertools/powertools-lambda-python/issues/4836))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.222 to 0.1.223 ([#4843](https://github.com/aws-powertools/powertools-lambda-python/issues/4843))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.233 to 0.1.234 ([#4909](https://github.com/aws-powertools/powertools-lambda-python/issues/4909))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.230 to 0.1.231 ([#4891](https://github.com/aws-powertools/powertools-lambda-python/issues/4891))
+* **deps-dev:** bump cfn-lint from 1.9.3 to 1.9.5 ([#4890](https://github.com/aws-powertools/powertools-lambda-python/issues/4890))
+* **deps-dev:** bump pytest from 8.3.1 to 8.3.2 ([#4824](https://github.com/aws-powertools/powertools-lambda-python/issues/4824))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.231 to 0.1.233 ([#4900](https://github.com/aws-powertools/powertools-lambda-python/issues/4900))
+* **deps-dev:** bump mkdocs-material from 9.5.30 to 9.5.31 ([#4877](https://github.com/aws-powertools/powertools-lambda-python/issues/4877))
+* **deps-dev:** bump types-redis from 4.6.0.20240425 to 4.6.0.20240726 ([#4831](https://github.com/aws-powertools/powertools-lambda-python/issues/4831))
+* **deps-dev:** bump ruff from 0.5.4 to 0.5.5 ([#4823](https://github.com/aws-powertools/powertools-lambda-python/issues/4823))
+* **deps-dev:** bump aws-cdk-lib from 2.150.0 to 2.151.0 ([#4875](https://github.com/aws-powertools/powertools-lambda-python/issues/4875))
+* **deps-dev:** bump types-redis from 4.6.0.20240726 to 4.6.0.20240806 ([#4899](https://github.com/aws-powertools/powertools-lambda-python/issues/4899))
+* **maintenance:** add Banxware customer refernece ([#4841](https://github.com/aws-powertools/powertools-lambda-python/issues/4841))
+
+
+<a name="v2.42.0"></a>
+## [v2.42.0] - 2024-07-25
+## Bug Fixes
+
+* **idempotency:** ensure in_progress_expiration field is set on Lambda timeout. ([#4773](https://github.com/aws-powertools/powertools-lambda-python/issues/4773))
+
+## Documentation
+
+* **idempotency:** improve navigation, wording, and new section on guarantees ([#4613](https://github.com/aws-powertools/powertools-lambda-python/issues/4613))
+
+## Features
+
+* **event_handler:** add OpenAPI extensions ([#4703](https://github.com/aws-powertools/powertools-lambda-python/issues/4703))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 2.41.1a4 ([#4772](https://github.com/aws-powertools/powertools-lambda-python/issues/4772))
+* **ci:** new pre-release 2.41.1a0 ([#4749](https://github.com/aws-powertools/powertools-lambda-python/issues/4749))
+* **ci:** new pre-release 2.41.1a1 ([#4756](https://github.com/aws-powertools/powertools-lambda-python/issues/4756))
+* **ci:** new pre-release 2.41.1a2 ([#4758](https://github.com/aws-powertools/powertools-lambda-python/issues/4758))
+* **ci:** new pre-release 2.41.1a9 ([#4808](https://github.com/aws-powertools/powertools-lambda-python/issues/4808))
+* **ci:** new pre-release 2.41.1a3 ([#4766](https://github.com/aws-powertools/powertools-lambda-python/issues/4766))
+* **ci:** new pre-release 2.41.1a8 ([#4802](https://github.com/aws-powertools/powertools-lambda-python/issues/4802))
+* **ci:** new pre-release 2.41.1a5 ([#4777](https://github.com/aws-powertools/powertools-lambda-python/issues/4777))
+* **ci:** new pre-release 2.41.1a6 ([#4783](https://github.com/aws-powertools/powertools-lambda-python/issues/4783))
+* **ci:** new pre-release 2.41.1a7 ([#4792](https://github.com/aws-powertools/powertools-lambda-python/issues/4792))
+* **deps:** bump github.com/aws/aws-sdk-go-v2/config from 1.27.26 to 1.27.27 in /layer/scripts/layer-balancer in the layer-balancer group ([#4779](https://github.com/aws-powertools/powertools-lambda-python/issues/4779))
+* **deps:** bump aws-actions/closed-issue-message from 8b6324312193476beecf11f8e8539d73a3553bf4 to 80edfc24bdf1283400eb04d20a8a605ae8bf7d48 ([#4786](https://github.com/aws-powertools/powertools-lambda-python/issues/4786))
+* **deps:** bump actions/dependency-review-action from 4.3.3 to 4.3.4 ([#4753](https://github.com/aws-powertools/powertools-lambda-python/issues/4753))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#4745](https://github.com/aws-powertools/powertools-lambda-python/issues/4745))
+* **deps:** bump datadog-lambda from 6.96.0 to 6.97.0 ([#4770](https://github.com/aws-powertools/powertools-lambda-python/issues/4770))
+* **deps:** bump docker/setup-buildx-action from 3.4.0 to 3.5.0 ([#4801](https://github.com/aws-powertools/powertools-lambda-python/issues/4801))
+* **deps:** bump docker/setup-qemu-action from 3.1.0 to 3.2.0 ([#4800](https://github.com/aws-powertools/powertools-lambda-python/issues/4800))
+* **deps-dev:** bump cfn-lint from 1.8.1 to 1.8.2 ([#4788](https://github.com/aws-powertools/powertools-lambda-python/issues/4788))
+* **deps-dev:** bump pytest-asyncio from 0.23.7 to 0.23.8 ([#4776](https://github.com/aws-powertools/powertools-lambda-python/issues/4776))
+* **deps-dev:** bump pytest from 8.2.2 to 8.3.1 ([#4799](https://github.com/aws-powertools/powertools-lambda-python/issues/4799))
+* **deps-dev:** bump aws-cdk-lib from 2.148.1 to 2.150.0 ([#4806](https://github.com/aws-powertools/powertools-lambda-python/issues/4806))
+* **deps-dev:** bump ruff from 0.5.3 to 0.5.4 ([#4798](https://github.com/aws-powertools/powertools-lambda-python/issues/4798))
+* **deps-dev:** bump cfn-lint from 1.6.1 to 1.8.1 ([#4780](https://github.com/aws-powertools/powertools-lambda-python/issues/4780))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.211 to 0.1.212 ([#4769](https://github.com/aws-powertools/powertools-lambda-python/issues/4769))
+* **deps-dev:** bump ruff from 0.5.2 to 0.5.3 ([#4781](https://github.com/aws-powertools/powertools-lambda-python/issues/4781))
+* **deps-dev:** bump mkdocs-material from 9.5.28 to 9.5.29 ([#4764](https://github.com/aws-powertools/powertools-lambda-python/issues/4764))
+* **deps-dev:** bump aws-cdk from 2.148.0 to 2.149.0 ([#4765](https://github.com/aws-powertools/powertools-lambda-python/issues/4765))
+* **deps-dev:** bump ruff from 0.5.1 to 0.5.2 ([#4762](https://github.com/aws-powertools/powertools-lambda-python/issues/4762))
+* **deps-dev:** bump sentry-sdk from 2.9.0 to 2.10.0 ([#4763](https://github.com/aws-powertools/powertools-lambda-python/issues/4763))
+* **deps-dev:** bump aws-cdk from 2.149.0 to 2.150.0 ([#4805](https://github.com/aws-powertools/powertools-lambda-python/issues/4805))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.207 to 0.1.211 ([#4760](https://github.com/aws-powertools/powertools-lambda-python/issues/4760))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.34.131 to 1.34.148 in the boto-typing group ([#4812](https://github.com/aws-powertools/powertools-lambda-python/issues/4812))
+* **deps-dev:** bump sentry-sdk from 2.10.0 to 2.11.0 ([#4815](https://github.com/aws-powertools/powertools-lambda-python/issues/4815))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.212 to 0.1.219 ([#4817](https://github.com/aws-powertools/powertools-lambda-python/issues/4817))
+* **deps-dev:** bump cfn-lint from 1.6.0 to 1.6.1 ([#4751](https://github.com/aws-powertools/powertools-lambda-python/issues/4751))
+* **deps-dev:** bump mkdocs-material from 9.5.29 to 9.5.30 ([#4807](https://github.com/aws-powertools/powertools-lambda-python/issues/4807))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.148.1a0 to 2.150.0a0 ([#4813](https://github.com/aws-powertools/powertools-lambda-python/issues/4813))
+* **deps-dev:** bump cfn-lint from 1.5.3 to 1.6.0 ([#4747](https://github.com/aws-powertools/powertools-lambda-python/issues/4747))
+* **deps-dev:** bump coverage from 7.5.4 to 7.6.0 ([#4746](https://github.com/aws-powertools/powertools-lambda-python/issues/4746))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.206 to 0.1.207 ([#4748](https://github.com/aws-powertools/powertools-lambda-python/issues/4748))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.34.128 to 1.34.145 in the boto-typing group ([#4787](https://github.com/aws-powertools/powertools-lambda-python/issues/4787))
+* **docs:** Add lambda layer policy to versioning docs ([#4811](https://github.com/aws-powertools/powertools-lambda-python/issues/4811))
+* **logger:** use package logger over source logger to reduce noise ([#4793](https://github.com/aws-powertools/powertools-lambda-python/issues/4793))
+
+
+<a name="v2.41.0"></a>
+## [v2.41.0] - 2024-07-11
+## Bug Fixes
+
+* **event_handler:** make the max_age attribute comply with RFC specification ([#4731](https://github.com/aws-powertools/powertools-lambda-python/issues/4731))
+* **event_handler:** disable allow-credentials header when origin allow_origin is * ([#4638](https://github.com/aws-powertools/powertools-lambda-python/issues/4638))
+* **event_handler:** convert null body to empty string in ALBResolver to avoid HTTP 502 ([#4683](https://github.com/aws-powertools/powertools-lambda-python/issues/4683))
+* **event_handler:** custom serializer recursive values when using data validation ([#4664](https://github.com/aws-powertools/powertools-lambda-python/issues/4664))
+
+## Documentation
+
+* **i-made-this:** Bedrock agents with Powertools for AWS Lambda ([#4705](https://github.com/aws-powertools/powertools-lambda-python/issues/4705))
+* **public_reference:** add BusPatrol as a public reference ([#4713](https://github.com/aws-powertools/powertools-lambda-python/issues/4713))
+
+## Features
+
+* **batch:** add option to not raise `BatchProcessingError` exception when the entire batch fails ([#4719](https://github.com/aws-powertools/powertools-lambda-python/issues/4719))
+* **feature_flags:** allow customers to bring their own boto3 client and session ([#4717](https://github.com/aws-powertools/powertools-lambda-python/issues/4717))
+* **parser:** add support for API Gateway Lambda authorizer events ([#4718](https://github.com/aws-powertools/powertools-lambda-python/issues/4718))
+
+## Maintenance
+
+* version bump
+* Add token to codecov action ([#4682](https://github.com/aws-powertools/powertools-lambda-python/issues/4682))
+* **ci:** new pre-release 2.40.2a5 ([#4706](https://github.com/aws-powertools/powertools-lambda-python/issues/4706))
+* **ci:** new pre-release 2.40.2a0 ([#4665](https://github.com/aws-powertools/powertools-lambda-python/issues/4665))
+* **ci:** new pre-release 2.40.2a8 ([#4737](https://github.com/aws-powertools/powertools-lambda-python/issues/4737))
+* **ci:** new pre-release 2.40.2a7 ([#4726](https://github.com/aws-powertools/powertools-lambda-python/issues/4726))
+* **ci:** new pre-release 2.40.2a1 ([#4669](https://github.com/aws-powertools/powertools-lambda-python/issues/4669))
+* **ci:** new pre-release 2.40.2a2 ([#4679](https://github.com/aws-powertools/powertools-lambda-python/issues/4679))
+* **ci:** new pre-release 2.40.2a3 ([#4688](https://github.com/aws-powertools/powertools-lambda-python/issues/4688))
+* **ci:** new pre-release 2.40.2a6 ([#4715](https://github.com/aws-powertools/powertools-lambda-python/issues/4715))
+* **ci:** new pre-release 2.40.2a4 ([#4694](https://github.com/aws-powertools/powertools-lambda-python/issues/4694))
+* **deps:** bump docker/setup-qemu-action from 3.0.0 to 3.1.0 ([#4685](https://github.com/aws-powertools/powertools-lambda-python/issues/4685))
+* **deps:** bump actions/setup-python from 5.1.0 to 5.1.1 ([#4732](https://github.com/aws-powertools/powertools-lambda-python/issues/4732))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#4733](https://github.com/aws-powertools/powertools-lambda-python/issues/4733))
+* **deps:** bump actions/upload-artifact from 4.3.3 to 4.3.4 ([#4698](https://github.com/aws-powertools/powertools-lambda-python/issues/4698))
+* **deps:** bump actions/download-artifact from 4.1.7 to 4.1.8 ([#4699](https://github.com/aws-powertools/powertools-lambda-python/issues/4699))
+* **deps:** bump actions/setup-node from 4.0.2 to 4.0.3 ([#4725](https://github.com/aws-powertools/powertools-lambda-python/issues/4725))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.9 to 3.0.10 ([#4678](https://github.com/aws-powertools/powertools-lambda-python/issues/4678))
+* **deps:** bump docker/setup-buildx-action from 3.3.0 to 3.4.0 ([#4693](https://github.com/aws-powertools/powertools-lambda-python/issues/4693))
+* **deps:** bump zipp from 3.17.0 to 3.19.1 in /docs ([#4720](https://github.com/aws-powertools/powertools-lambda-python/issues/4720))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#4659](https://github.com/aws-powertools/powertools-lambda-python/issues/4659))
+* **deps:** bump certifi from 2024.6.2 to 2024.7.4 ([#4700](https://github.com/aws-powertools/powertools-lambda-python/issues/4700))
+* **deps:** bump github.com/aws/aws-sdk-go-v2/config from 1.27.23 to 1.27.24 in /layer/scripts/layer-balancer in the layer-balancer group ([#4684](https://github.com/aws-powertools/powertools-lambda-python/issues/4684))
+* **deps-dev:** bump mkdocs-material from 9.5.27 to 9.5.28 ([#4676](https://github.com/aws-powertools/powertools-lambda-python/issues/4676))
+* **deps-dev:** bump cfn-lint from 1.4.2 to 1.5.0 ([#4675](https://github.com/aws-powertools/powertools-lambda-python/issues/4675))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.147.3a0 to 2.148.0a0 ([#4722](https://github.com/aws-powertools/powertools-lambda-python/issues/4722))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.200 to 0.1.201 ([#4687](https://github.com/aws-powertools/powertools-lambda-python/issues/4687))
+* **deps-dev:** bump aws-cdk-lib from 2.147.2 to 2.147.3 ([#4674](https://github.com/aws-powertools/powertools-lambda-python/issues/4674))
+* **deps-dev:** bump zipp from 3.17.0 to 3.19.1 in /layer ([#4721](https://github.com/aws-powertools/powertools-lambda-python/issues/4721))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.202 to 0.1.205 ([#4723](https://github.com/aws-powertools/powertools-lambda-python/issues/4723))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.147.2a0 to 2.147.3a0 ([#4686](https://github.com/aws-powertools/powertools-lambda-python/issues/4686))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.199 to 0.1.200 ([#4677](https://github.com/aws-powertools/powertools-lambda-python/issues/4677))
+* **deps-dev:** bump aws-cdk-lib from 2.147.3 to 2.148.0 ([#4710](https://github.com/aws-powertools/powertools-lambda-python/issues/4710))
+* **deps-dev:** bump aws-cdk from 2.147.2 to 2.147.3 ([#4672](https://github.com/aws-powertools/powertools-lambda-python/issues/4672))
+* **deps-dev:** bump mypy-boto3-s3 from 1.34.120 to 1.34.138 in the boto-typing group ([#4673](https://github.com/aws-powertools/powertools-lambda-python/issues/4673))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.201 to 0.1.202 ([#4696](https://github.com/aws-powertools/powertools-lambda-python/issues/4696))
+* **deps-dev:** bump cfn-lint from 1.5.1 to 1.5.2 ([#4724](https://github.com/aws-powertools/powertools-lambda-python/issues/4724))
+* **deps-dev:** bump ruff from 0.5.0 to 0.5.1 ([#4697](https://github.com/aws-powertools/powertools-lambda-python/issues/4697))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.198 to 0.1.199 ([#4668](https://github.com/aws-powertools/powertools-lambda-python/issues/4668))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.147.1a0 to 2.147.2a0 ([#4667](https://github.com/aws-powertools/powertools-lambda-python/issues/4667))
+* **deps-dev:** bump aws-cdk from 2.147.3 to 2.148.0 ([#4708](https://github.com/aws-powertools/powertools-lambda-python/issues/4708))
+* **deps-dev:** bump cfn-lint from 1.5.2 to 1.5.3 ([#4734](https://github.com/aws-powertools/powertools-lambda-python/issues/4734))
+* **deps-dev:** bump sentry-sdk from 2.8.0 to 2.9.0 ([#4735](https://github.com/aws-powertools/powertools-lambda-python/issues/4735))
+* **deps-dev:** bump cfn-lint from 1.4.1 to 1.4.2 ([#4660](https://github.com/aws-powertools/powertools-lambda-python/issues/4660))
+* **deps-dev:** bump aws-cdk-lib from 2.147.1 to 2.147.2 ([#4661](https://github.com/aws-powertools/powertools-lambda-python/issues/4661))
+* **deps-dev:** bump cfn-lint from 1.5.0 to 1.5.1 ([#4711](https://github.com/aws-powertools/powertools-lambda-python/issues/4711))
+* **deps-dev:** bump aws-cdk from 2.147.1 to 2.147.2 ([#4657](https://github.com/aws-powertools/powertools-lambda-python/issues/4657))
+* **deps-dev:** bump ruff from 0.4.10 to 0.5.0 ([#4644](https://github.com/aws-powertools/powertools-lambda-python/issues/4644))
+* **deps-dev:** bump sentry-sdk from 2.7.1 to 2.8.0 ([#4712](https://github.com/aws-powertools/powertools-lambda-python/issues/4712))
+* **layers:** downgrade aws cdk to 2.145.0 ([#4739](https://github.com/aws-powertools/powertools-lambda-python/issues/4739))
+
+
+<a name="v2.40.1"></a>
+## [v2.40.1] - 2024-06-28
+## Bug Fixes
+
+* **event_handler:** current_event regression AppSyncResolver Router ([#4652](https://github.com/aws-powertools/powertools-lambda-python/issues/4652))
+
+## Maintenance
+
+* version bump
+* **ci:** new pre-release 2.40.1a1 ([#4653](https://github.com/aws-powertools/powertools-lambda-python/issues/4653))
+* **ci:** new pre-release 2.40.1a0 ([#4648](https://github.com/aws-powertools/powertools-lambda-python/issues/4648))
+* **deps-dev:** bump cfn-lint from 1.3.7 to 1.4.1 ([#4646](https://github.com/aws-powertools/powertools-lambda-python/issues/4646))
+* **deps-dev:** bump sentry-sdk from 2.7.0 to 2.7.1 ([#4645](https://github.com/aws-powertools/powertools-lambda-python/issues/4645))
+
+
+<a name="v2.40.0"></a>
+## [v2.40.0] - 2024-06-27
+## Bug Fixes
+
+* **event_sources:** change partition and offset field types in KafkaEventRecord ([#4515](https://github.com/aws-powertools/powertools-lambda-python/issues/4515))
+
+## Documentation
+
+* **homepage:** Fix homepage link ([#4587](https://github.com/aws-powertools/powertools-lambda-python/issues/4587))
+* **i-made-this:** add new article about best practices for accelerating serverless development ([#4518](https://github.com/aws-powertools/powertools-lambda-python/issues/4518))
+* **public reference:** add Brsk as a public reference ([#4597](https://github.com/aws-powertools/powertools-lambda-python/issues/4597))
+
+## Features
+
+* **event-handler:** add appsync batch resolvers ([#1998](https://github.com/aws-powertools/powertools-lambda-python/issues/1998))
+* **validation:** support JSON Schema referencing in validation utils ([#4508](https://github.com/aws-powertools/powertools-lambda-python/issues/4508))
+
+## Maintenance
+
+* version bump
+* **ci:** add the Metrics feature to nox tests ([#4552](https://github.com/aws-powertools/powertools-lambda-python/issues/4552))
+* **ci:** new pre-release 2.39.2a5 ([#4636](https://github.com/aws-powertools/powertools-lambda-python/issues/4636))
+* **ci:** add the Streaming feature to nox tests ([#4575](https://github.com/aws-powertools/powertools-lambda-python/issues/4575))
+* **ci:** new pre-release 2.39.2a4 ([#4629](https://github.com/aws-powertools/powertools-lambda-python/issues/4629))
+* **ci:** new pre-release 2.39.2a3 ([#4620](https://github.com/aws-powertools/powertools-lambda-python/issues/4620))
+* **ci:** add the Event Handler feature to nox tests ([#4581](https://github.com/aws-powertools/powertools-lambda-python/issues/4581))
+* **ci:** add the Data Class feature to nox tests ([#4583](https://github.com/aws-powertools/powertools-lambda-python/issues/4583))
+* **ci:** add the Parser feature to nox tests ([#4584](https://github.com/aws-powertools/powertools-lambda-python/issues/4584))
+* **ci:** add the Idempotency feature to nox tests ([#4585](https://github.com/aws-powertools/powertools-lambda-python/issues/4585))
+* **ci:** new pre-release 2.39.2a2 ([#4610](https://github.com/aws-powertools/powertools-lambda-python/issues/4610))
+* **ci:** introduce tests with Nox ([#4537](https://github.com/aws-powertools/powertools-lambda-python/issues/4537))
+* **ci:** new pre-release 2.39.2a1 ([#4598](https://github.com/aws-powertools/powertools-lambda-python/issues/4598))
+* **ci:** add the Tracer feature to nox tests ([#4567](https://github.com/aws-powertools/powertools-lambda-python/issues/4567))
+* **ci:** add the Middleware Factory feature to nox tests ([#4568](https://github.com/aws-powertools/powertools-lambda-python/issues/4568))
+* **ci:** add the Parameters feature to nox tests ([#4569](https://github.com/aws-powertools/powertools-lambda-python/issues/4569))
+* **ci:** add the Batch Processor feature to nox tests ([#4586](https://github.com/aws-powertools/powertools-lambda-python/issues/4586))
+* **ci:** add the Feature Flags feature to nox tests ([#4570](https://github.com/aws-powertools/powertools-lambda-python/issues/4570))
+* **ci:** add the Validation feature to nox tests ([#4571](https://github.com/aws-powertools/powertools-lambda-python/issues/4571))
+* **ci:** introduce daily pre-releases ([#4535](https://github.com/aws-powertools/powertools-lambda-python/issues/4535))
+* **ci:** new pre-release 2.39.2a0 ([#4590](https://github.com/aws-powertools/powertools-lambda-python/issues/4590))
+* **ci:** add the Data Masking feature to nox tests ([#4574](https://github.com/aws-powertools/powertools-lambda-python/issues/4574))
+* **ci:** add the Typing feature to nox tests ([#4572](https://github.com/aws-powertools/powertools-lambda-python/issues/4572))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.8.14 to 1.9.0 ([#4592](https://github.com/aws-powertools/powertools-lambda-python/issues/4592))
+* **deps:** bump pydantic from 1.10.16 to 1.10.17 ([#4595](https://github.com/aws-powertools/powertools-lambda-python/issues/4595))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#4565](https://github.com/aws-powertools/powertools-lambda-python/issues/4565))
+* **deps:** bump squidfunk/mkdocs-material from `96abcbb` to `257eca8` in /docs ([#4540](https://github.com/aws-powertools/powertools-lambda-python/issues/4540))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.7 to 3.0.9 ([#4539](https://github.com/aws-powertools/powertools-lambda-python/issues/4539))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#4546](https://github.com/aws-powertools/powertools-lambda-python/issues/4546))
+* **deps:** bump redis from 5.0.5 to 5.0.6 ([#4527](https://github.com/aws-powertools/powertools-lambda-python/issues/4527))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#4580](https://github.com/aws-powertools/powertools-lambda-python/issues/4580))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 2 updates ([#4635](https://github.com/aws-powertools/powertools-lambda-python/issues/4635))
+* **deps:** bump codecov/codecov-action from 4.4.1 to 4.5.0 ([#4514](https://github.com/aws-powertools/powertools-lambda-python/issues/4514))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.8.14 to 1.9.0 ([#4538](https://github.com/aws-powertools/powertools-lambda-python/issues/4538))
+* **deps:** bump fastjsonschema from 2.19.1 to 2.20.0 ([#4543](https://github.com/aws-powertools/powertools-lambda-python/issues/4543))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.189 to 0.1.192 ([#4578](https://github.com/aws-powertools/powertools-lambda-python/issues/4578))
+* **deps-dev:** bump sentry-sdk from 2.5.1 to 2.6.0 ([#4579](https://github.com/aws-powertools/powertools-lambda-python/issues/4579))
+* **deps-dev:** bump cfn-lint from 0.87.7 to 1.3.0 ([#4577](https://github.com/aws-powertools/powertools-lambda-python/issues/4577))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.192 to 0.1.193 ([#4596](https://github.com/aws-powertools/powertools-lambda-python/issues/4596))
+* **deps-dev:** bump ruff from 0.4.9 to 0.4.10 ([#4594](https://github.com/aws-powertools/powertools-lambda-python/issues/4594))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.193 to 0.1.194 ([#4601](https://github.com/aws-powertools/powertools-lambda-python/issues/4601))
+* **deps-dev:** bump aws-cdk from 2.146.0 to 2.147.0 ([#4604](https://github.com/aws-powertools/powertools-lambda-python/issues/4604))
+* **deps-dev:** bump aws-cdk-lib from 2.146.0 to 2.147.0 ([#4603](https://github.com/aws-powertools/powertools-lambda-python/issues/4603))
+* **deps-dev:** bump filelock from 3.15.1 to 3.15.3 ([#4576](https://github.com/aws-powertools/powertools-lambda-python/issues/4576))
+* **deps-dev:** bump hvac from 2.2.0 to 2.3.0 ([#4563](https://github.com/aws-powertools/powertools-lambda-python/issues/4563))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.188 to 0.1.189 ([#4564](https://github.com/aws-powertools/powertools-lambda-python/issues/4564))
+* **deps-dev:** bump cfn-lint from 1.3.0 to 1.3.3 ([#4602](https://github.com/aws-powertools/powertools-lambda-python/issues/4602))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.194 to 0.1.198 ([#4627](https://github.com/aws-powertools/powertools-lambda-python/issues/4627))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.146.0a0 to 2.147.0a0 ([#4619](https://github.com/aws-powertools/powertools-lambda-python/issues/4619))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.184 to 0.1.188 ([#4550](https://github.com/aws-powertools/powertools-lambda-python/issues/4550))
+* **deps-dev:** bump mkdocs-material from 9.5.26 to 9.5.27 ([#4544](https://github.com/aws-powertools/powertools-lambda-python/issues/4544))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.145.0a0 to 2.146.0a0 ([#4542](https://github.com/aws-powertools/powertools-lambda-python/issues/4542))
+* **deps-dev:** bump urllib3 from 1.26.18 to 1.26.19 in /layer ([#4547](https://github.com/aws-powertools/powertools-lambda-python/issues/4547))
+* **deps-dev:** bump aws-cdk-lib from 2.145.0 to 2.146.0 ([#4526](https://github.com/aws-powertools/powertools-lambda-python/issues/4526))
+* **deps-dev:** bump aws-cdk from 2.147.0 to 2.147.1 ([#4614](https://github.com/aws-powertools/powertools-lambda-python/issues/4614))
+* **deps-dev:** bump coverage from 7.5.3 to 7.5.4 ([#4617](https://github.com/aws-powertools/powertools-lambda-python/issues/4617))
+* **deps-dev:** bump aws-cdk-lib from 2.147.0 to 2.147.1 ([#4615](https://github.com/aws-powertools/powertools-lambda-python/issues/4615))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.34.125 to 1.34.128 in the boto-typing group ([#4541](https://github.com/aws-powertools/powertools-lambda-python/issues/4541))
+* **deps-dev:** bump pdoc3 from 0.10.0 to 0.11.0 ([#4618](https://github.com/aws-powertools/powertools-lambda-python/issues/4618))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.34.109 to 1.34.125 in the boto-typing group ([#4509](https://github.com/aws-powertools/powertools-lambda-python/issues/4509))
+* **deps-dev:** bump mike from 2.1.1 to 2.1.2 ([#4616](https://github.com/aws-powertools/powertools-lambda-python/issues/4616))
+* **deps-dev:** bump mypy from 1.10.0 to 1.10.1 ([#4624](https://github.com/aws-powertools/powertools-lambda-python/issues/4624))
+* **deps-dev:** bump filelock from 3.15.3 to 3.15.4 ([#4626](https://github.com/aws-powertools/powertools-lambda-python/issues/4626))
+* **deps-dev:** bump ruff from 0.4.8 to 0.4.9 ([#4528](https://github.com/aws-powertools/powertools-lambda-python/issues/4528))
+* **deps-dev:** bump cfn-lint from 1.3.3 to 1.3.5 ([#4628](https://github.com/aws-powertools/powertools-lambda-python/issues/4628))
+* **deps-dev:** bump mypy-boto3-ssm from 1.34.91 to 1.34.132 in the boto-typing group ([#4623](https://github.com/aws-powertools/powertools-lambda-python/issues/4623))
+* **deps-dev:** bump aws-cdk from 2.145.0 to 2.146.0 ([#4525](https://github.com/aws-powertools/powertools-lambda-python/issues/4525))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.182 to 0.1.184 ([#4529](https://github.com/aws-powertools/powertools-lambda-python/issues/4529))
+* **deps-dev:** bump bandit from 1.7.8 to 1.7.9 ([#4511](https://github.com/aws-powertools/powertools-lambda-python/issues/4511))
+* **deps-dev:** bump cfn-lint from 0.87.6 to 0.87.7 ([#4513](https://github.com/aws-powertools/powertools-lambda-python/issues/4513))
+* **deps-dev:** bump filelock from 3.14.0 to 3.15.1 ([#4512](https://github.com/aws-powertools/powertools-lambda-python/issues/4512))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.179 to 0.1.182 ([#4510](https://github.com/aws-powertools/powertools-lambda-python/issues/4510))
+* **deps-dev:** bump cfn-lint from 1.3.5 to 1.3.7 ([#4634](https://github.com/aws-powertools/powertools-lambda-python/issues/4634))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.34.114 to 1.34.131 in the boto-typing group ([#4593](https://github.com/aws-powertools/powertools-lambda-python/issues/4593))
+* **governance:** fix errors when creating Gitpod environment ([#4532](https://github.com/aws-powertools/powertools-lambda-python/issues/4532))
+* **layers:** downgrade aws cdk to 2.145.0 ([#4640](https://github.com/aws-powertools/powertools-lambda-python/issues/4640))
+
+
+<a name="v2.39.1"></a>
+## [v2.39.1] - 2024-06-13
+## Bug Fixes
+
+* **event_handler:** regression making pydantic required (it should not) ([#4500](https://github.com/aws-powertools/powertools-lambda-python/issues/4500))
+
+## Maintenance
+
+* version bump
+
+
+<a name="v2.39.0"></a>
+## [v2.39.0] - 2024-06-13
+## Bug Fixes
+
+* **event_handler:** do not skip middleware and exception handlers on 404 error ([#4492](https://github.com/aws-powertools/powertools-lambda-python/issues/4492))
+* **event_handler:** raise more specific SerializationError exception for unsupported types in data validation ([#4415](https://github.com/aws-powertools/powertools-lambda-python/issues/4415))
+* **event_handler:** security scheme unhashable list when working with router ([#4421](https://github.com/aws-powertools/powertools-lambda-python/issues/4421))
+* **event_handler:** CORS Origin for ALBResolver multi-headers ([#4385](https://github.com/aws-powertools/powertools-lambda-python/issues/4385))
+* **idempotency:** POWERTOOLS_IDEMPOTENCY_DISABLED should respect truthy values ([#4391](https://github.com/aws-powertools/powertools-lambda-python/issues/4391))
+
+## Documentation
+
+* **homepage:** Change installation to CDK v2 ([#4351](https://github.com/aws-powertools/powertools-lambda-python/issues/4351))
+* **public reference:** add Recast as a public reference ([#4491](https://github.com/aws-powertools/powertools-lambda-python/issues/4491))
+
+## Features
+
+* **event_source:** add CloudFormationCustomResourceEvent data class. ([#4342](https://github.com/aws-powertools/powertools-lambda-python/issues/4342))
+* **events:** Update and Add Cognito User Pool Events ([#4423](https://github.com/aws-powertools/powertools-lambda-python/issues/4423))
+
+## Maintenance
+
+* version bump
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#4369](https://github.com/aws-powertools/powertools-lambda-python/issues/4369))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#4468](https://github.com/aws-powertools/powertools-lambda-python/issues/4468))
+* **deps:** bump datadog-lambda from 5.94.0 to 6.95.0 ([#4471](https://github.com/aws-powertools/powertools-lambda-python/issues/4471))
+* **deps:** bump redis from 5.0.4 to 5.0.5 ([#4464](https://github.com/aws-powertools/powertools-lambda-python/issues/4464))
+* **deps:** bump aws-encryption-sdk from 3.2.0 to 3.3.0 ([#4393](https://github.com/aws-powertools/powertools-lambda-python/issues/4393))
+* **deps:** bump codecov/codecov-action from 4.4.0 to 4.4.1 ([#4376](https://github.com/aws-powertools/powertools-lambda-python/issues/4376))
+* **deps:** bump squidfunk/mkdocs-material from `8a87f05` to `96abcbb` in /docs ([#4461](https://github.com/aws-powertools/powertools-lambda-python/issues/4461))
+* **deps:** bump typing-extensions from 4.12.1 to 4.12.2 ([#4470](https://github.com/aws-powertools/powertools-lambda-python/issues/4470))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 2 updates ([#4396](https://github.com/aws-powertools/powertools-lambda-python/issues/4396))
+* **deps:** bump aws-xray-sdk from 2.13.0 to 2.13.1 ([#4379](https://github.com/aws-powertools/powertools-lambda-python/issues/4379))
+* **deps:** bump actions/dependency-review-action from 4.3.2 to 4.3.3 ([#4456](https://github.com/aws-powertools/powertools-lambda-python/issues/4456))
+* **deps:** bump aws-xray-sdk from 2.13.1 to 2.14.0 ([#4453](https://github.com/aws-powertools/powertools-lambda-python/issues/4453))
+* **deps:** bump typing-extensions from 4.11.0 to 4.12.0 ([#4404](https://github.com/aws-powertools/powertools-lambda-python/issues/4404))
+* **deps:** bump squidfunk/mkdocs-material from `5358893` to `8a87f05` in /docs ([#4408](https://github.com/aws-powertools/powertools-lambda-python/issues/4408))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.6 to 3.0.7 ([#4478](https://github.com/aws-powertools/powertools-lambda-python/issues/4478))
+* **deps:** bump squidfunk/mkdocs-material from `48d1914` to `5358893` in /docs ([#4377](https://github.com/aws-powertools/powertools-lambda-python/issues/4377))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#4444](https://github.com/aws-powertools/powertools-lambda-python/issues/4444))
+* **deps:** bump pydantic from 1.10.15 to 1.10.16 ([#4485](https://github.com/aws-powertools/powertools-lambda-python/issues/4485))
+* **deps:** bump datadog-lambda from 6.95.0 to 6.96.0 ([#4489](https://github.com/aws-powertools/powertools-lambda-python/issues/4489))
+* **deps:** bump actions/checkout from 4.1.6 to 4.1.7 ([#4493](https://github.com/aws-powertools/powertools-lambda-python/issues/4493))
+* **deps:** bump typing-extensions from 4.12.0 to 4.12.1 ([#4440](https://github.com/aws-powertools/powertools-lambda-python/issues/4440))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.5 to 3.0.6 ([#4445](https://github.com/aws-powertools/powertools-lambda-python/issues/4445))
+* **deps:** bump requests from 2.31.0 to 2.32.0 ([#4383](https://github.com/aws-powertools/powertools-lambda-python/issues/4383))
+* **deps-dev:** bump aws-cdk from 2.143.1 to 2.144.0 ([#4443](https://github.com/aws-powertools/powertools-lambda-python/issues/4443))
+* **deps-dev:** bump aws-cdk-lib from 2.143.1 to 2.144.0 ([#4441](https://github.com/aws-powertools/powertools-lambda-python/issues/4441))
+* **deps-dev:** bump ruff from 0.4.6 to 0.4.7 ([#4435](https://github.com/aws-powertools/powertools-lambda-python/issues/4435))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.143.0a0 to 2.143.1a0 ([#4433](https://github.com/aws-powertools/powertools-lambda-python/issues/4433))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.164 to 0.1.169 ([#4442](https://github.com/aws-powertools/powertools-lambda-python/issues/4442))
+* **deps-dev:** bump pytest from 8.2.1 to 8.2.2 ([#4450](https://github.com/aws-powertools/powertools-lambda-python/issues/4450))
+* **deps-dev:** bump aws-cdk from 2.143.0 to 2.143.1 ([#4430](https://github.com/aws-powertools/powertools-lambda-python/issues/4430))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.163 to 0.1.164 ([#4428](https://github.com/aws-powertools/powertools-lambda-python/issues/4428))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.161 to 0.1.163 ([#4425](https://github.com/aws-powertools/powertools-lambda-python/issues/4425))
+* **deps-dev:** bump cfn-lint from 0.87.5 to 0.87.6 ([#4486](https://github.com/aws-powertools/powertools-lambda-python/issues/4486))
+* **deps-dev:** bump sentry-sdk from 2.3.1 to 2.4.0 ([#4449](https://github.com/aws-powertools/powertools-lambda-python/issues/4449))
+* **deps-dev:** bump ruff from 0.4.5 to 0.4.6 ([#4417](https://github.com/aws-powertools/powertools-lambda-python/issues/4417))
+* **deps-dev:** bump cfn-lint from 0.87.3 to 0.87.4 ([#4419](https://github.com/aws-powertools/powertools-lambda-python/issues/4419))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.159 to 0.1.161 ([#4420](https://github.com/aws-powertools/powertools-lambda-python/issues/4420))
+* **deps-dev:** bump coverage from 7.5.2 to 7.5.3 ([#4418](https://github.com/aws-powertools/powertools-lambda-python/issues/4418))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.34.113 to 1.34.114 in the boto-typing group ([#4416](https://github.com/aws-powertools/powertools-lambda-python/issues/4416))
+* **deps-dev:** bump mkdocs-material from 9.5.24 to 9.5.25 ([#4411](https://github.com/aws-powertools/powertools-lambda-python/issues/4411))
+* **deps-dev:** bump aws-cdk-lib from 2.143.0 to 2.143.1 ([#4429](https://github.com/aws-powertools/powertools-lambda-python/issues/4429))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.142.1a0 to 2.143.0a0 ([#4410](https://github.com/aws-powertools/powertools-lambda-python/issues/4410))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.34.97 to 1.34.113 in the boto-typing group ([#4409](https://github.com/aws-powertools/powertools-lambda-python/issues/4409))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.158 to 0.1.159 ([#4412](https://github.com/aws-powertools/powertools-lambda-python/issues/4412))
+* **deps-dev:** bump coverage from 7.5.1 to 7.5.2 ([#4413](https://github.com/aws-powertools/powertools-lambda-python/issues/4413))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.143.1a0 to 2.144.0a0 ([#4448](https://github.com/aws-powertools/powertools-lambda-python/issues/4448))
+* **deps-dev:** bump mypy-boto3-s3 from 1.34.105 to 1.34.120 in the boto-typing group ([#4452](https://github.com/aws-powertools/powertools-lambda-python/issues/4452))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.169 to 0.1.173 ([#4459](https://github.com/aws-powertools/powertools-lambda-python/issues/4459))
+* **deps-dev:** bump aws-cdk-lib from 2.142.1 to 2.143.0 ([#4403](https://github.com/aws-powertools/powertools-lambda-python/issues/4403))
+* **deps-dev:** bump aws-cdk from 2.142.1 to 2.143.0 ([#4402](https://github.com/aws-powertools/powertools-lambda-python/issues/4402))
+* **deps-dev:** bump ruff from 0.4.4 to 0.4.5 ([#4399](https://github.com/aws-powertools/powertools-lambda-python/issues/4399))
+* **deps-dev:** bump sentry-sdk from 2.2.1 to 2.3.1 ([#4398](https://github.com/aws-powertools/powertools-lambda-python/issues/4398))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.157 to 0.1.158 ([#4397](https://github.com/aws-powertools/powertools-lambda-python/issues/4397))
+* **deps-dev:** bump ruff from 0.4.7 to 0.4.8 ([#4455](https://github.com/aws-powertools/powertools-lambda-python/issues/4455))
+* **deps-dev:** bump sentry-sdk from 2.4.0 to 2.5.0 ([#4462](https://github.com/aws-powertools/powertools-lambda-python/issues/4462))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.155 to 0.1.157 ([#4394](https://github.com/aws-powertools/powertools-lambda-python/issues/4394))
+* **deps-dev:** bump mkdocs-material from 9.5.25 to 9.5.26 ([#4463](https://github.com/aws-powertools/powertools-lambda-python/issues/4463))
+* **deps-dev:** bump mypy-boto3-cloudformation from 1.34.84 to 1.34.111 in the boto-typing group ([#4392](https://github.com/aws-powertools/powertools-lambda-python/issues/4392))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.154 to 0.1.155 ([#4386](https://github.com/aws-powertools/powertools-lambda-python/issues/4386))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.173 to 0.1.174 ([#4466](https://github.com/aws-powertools/powertools-lambda-python/issues/4466))
+* **deps-dev:** bump pytest-asyncio from 0.23.6 to 0.23.7 ([#4387](https://github.com/aws-powertools/powertools-lambda-python/issues/4387))
+* **deps-dev:** bump sentry-sdk from 2.2.0 to 2.2.1 ([#4388](https://github.com/aws-powertools/powertools-lambda-python/issues/4388))
+* **deps-dev:** bump ijson from 3.2.3 to 3.3.0 ([#4465](https://github.com/aws-powertools/powertools-lambda-python/issues/4465))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.152 to 0.1.154 ([#4382](https://github.com/aws-powertools/powertools-lambda-python/issues/4382))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.174 to 0.1.175 ([#4472](https://github.com/aws-powertools/powertools-lambda-python/issues/4472))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.34.107 to 1.34.109 in the boto-typing group ([#4378](https://github.com/aws-powertools/powertools-lambda-python/issues/4378))
+* **deps-dev:** bump sentry-sdk from 2.5.0 to 2.5.1 ([#4469](https://github.com/aws-powertools/powertools-lambda-python/issues/4469))
+* **deps-dev:** bump cfn-lint from 0.87.4 to 0.87.5 ([#4479](https://github.com/aws-powertools/powertools-lambda-python/issues/4479))
+* **deps-dev:** bump mkdocs-material from 9.5.23 to 9.5.24 ([#4380](https://github.com/aws-powertools/powertools-lambda-python/issues/4380))
+* **deps-dev:** bump pytest from 8.2.0 to 8.2.1 ([#4381](https://github.com/aws-powertools/powertools-lambda-python/issues/4381))
+* **deps-dev:** bump aws-cdk from 2.144.0 to 2.145.0 ([#4482](https://github.com/aws-powertools/powertools-lambda-python/issues/4482))
+* **deps-dev:** bump aws-cdk-lib from 2.144.0 to 2.145.0 ([#4481](https://github.com/aws-powertools/powertools-lambda-python/issues/4481))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.141.0a0 to 2.142.1a0 ([#4367](https://github.com/aws-powertools/powertools-lambda-python/issues/4367))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.144.0a0 to 2.145.0a0 ([#4487](https://github.com/aws-powertools/powertools-lambda-python/issues/4487))
+* **deps-dev:** bump aws-cdk from 2.142.0 to 2.142.1 ([#4366](https://github.com/aws-powertools/powertools-lambda-python/issues/4366))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.150 to 0.1.152 ([#4368](https://github.com/aws-powertools/powertools-lambda-python/issues/4368))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.176 to 0.1.179 ([#4488](https://github.com/aws-powertools/powertools-lambda-python/issues/4488))
+* **deps-dev:** bump cfn-lint from 0.87.2 to 0.87.3 ([#4370](https://github.com/aws-powertools/powertools-lambda-python/issues/4370))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.175 to 0.1.176 ([#4480](https://github.com/aws-powertools/powertools-lambda-python/issues/4480))
+* **libraries:** add jmespath as a required dependency ([#4422](https://github.com/aws-powertools/powertools-lambda-python/issues/4422))
+
+
+<a name="v2.38.1"></a>
+## [v2.38.1] - 2024-05-17
+## Bug Fixes
+
+* **logger:** reverting logger child modification ([#4363](https://github.com/aws-powertools/powertools-lambda-python/issues/4363))
+
+## Maintenance
+
+* version bump
+
+
+<a name="v2.38.0"></a>
+## [v2.38.0] - 2024-05-17
+## Bug Fixes
+
+* **ci:** apply lessons learned to monthly roadmap reminder cross-repo ([#4078](https://github.com/aws-powertools/powertools-lambda-python/issues/4078))
+* **event-sources:** sane defaults for authorizer v1 and v2 ([#4298](https://github.com/aws-powertools/powertools-lambda-python/issues/4298))
+* **logger:** correctly pick powertools or custom handler in custom environments ([#4295](https://github.com/aws-powertools/powertools-lambda-python/issues/4295))
+* **parser:** make etag optional field on S3 notification events ([#4173](https://github.com/aws-powertools/powertools-lambda-python/issues/4173))
+* **typing:** resolved_headers_field is not Optional ([#4148](https://github.com/aws-powertools/powertools-lambda-python/issues/4148))
+
+## Code Refactoring
+
+* **data-masking:** remove Non-GA comments ([#4334](https://github.com/aws-powertools/powertools-lambda-python/issues/4334))
+* **parser:** only infer type hints when necessary ([#4183](https://github.com/aws-powertools/powertools-lambda-python/issues/4183))
+
+## Documentation
+
+* **general:** update documentation to add info about v3 ([#4234](https://github.com/aws-powertools/powertools-lambda-python/issues/4234))
+* **homepage:** add link to new and official workshop ([#4292](https://github.com/aws-powertools/powertools-lambda-python/issues/4292))
+* **idempotency:** fix highlight and import path ([#4154](https://github.com/aws-powertools/powertools-lambda-python/issues/4154))
+* **roadmap:** april updates ([#4181](https://github.com/aws-powertools/powertools-lambda-python/issues/4181))
+
+## Features
+
+* **event_handler:** add support for persisting authorization session in OpenAPI ([#4312](https://github.com/aws-powertools/powertools-lambda-python/issues/4312))
+* **event_handler:** add decorator for HTTP HEAD verb ([#4275](https://github.com/aws-powertools/powertools-lambda-python/issues/4275))
+* **logger-utils:** preserve log level for discovered third-party top-level loggers ([#4299](https://github.com/aws-powertools/powertools-lambda-python/issues/4299))
+
+## Maintenance
+
+* version bump
+* **ci:** bump upload artifact action to v4 ([#4355](https://github.com/aws-powertools/powertools-lambda-python/issues/4355))
+* **ci:** add branch v3 to quality check and e2e actions ([#4232](https://github.com/aws-powertools/powertools-lambda-python/issues/4232))
+* **ci:** bump download artifact action to v4 ([#4358](https://github.com/aws-powertools/powertools-lambda-python/issues/4358))
+* **deps:** bump actions/download-artifact from 4.1.4 to 4.1.5 ([#4161](https://github.com/aws-powertools/powertools-lambda-python/issues/4161))
+* **deps:** bump actions/checkout from 4.1.3 to 4.1.4 ([#4206](https://github.com/aws-powertools/powertools-lambda-python/issues/4206))
+* **deps:** bump ossf/scorecard-action from 2.3.1 to 2.3.3 ([#4315](https://github.com/aws-powertools/powertools-lambda-python/issues/4315))
+* **deps:** bump github.com/aws/aws-sdk-go-v2/config from 1.27.12 to 1.27.13 in /layer/scripts/layer-balancer in the layer-balancer group ([#4319](https://github.com/aws-powertools/powertools-lambda-python/issues/4319))
+* **deps:** bump actions/download-artifact from 4.1.6 to 4.1.7 ([#4205](https://github.com/aws-powertools/powertools-lambda-python/issues/4205))
+* **deps:** bump squidfunk/mkdocs-material from `521644b` to `e309089` in /docs ([#4216](https://github.com/aws-powertools/powertools-lambda-python/issues/4216))
+* **deps:** bump squidfunk/mkdocs-material from `11d7ec0` to `8ef47d7` in /docs ([#4323](https://github.com/aws-powertools/powertools-lambda-python/issues/4323))
+* **deps:** bump datadog-lambda from 5.92.0 to 5.93.0 ([#4211](https://github.com/aws-powertools/powertools-lambda-python/issues/4211))
+* **deps:** bump redis from 5.0.3 to 5.0.4 ([#4187](https://github.com/aws-powertools/powertools-lambda-python/issues/4187))
+* **deps:** bump actions/upload-artifact from 4.3.2 to 4.3.3 ([#4177](https://github.com/aws-powertools/powertools-lambda-python/issues/4177))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 2 updates ([#4302](https://github.com/aws-powertools/powertools-lambda-python/issues/4302))
+* **deps:** bump squidfunk/mkdocs-material from `8ef47d7` to `48d1914` in /docs ([#4336](https://github.com/aws-powertools/powertools-lambda-python/issues/4336))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#4337](https://github.com/aws-powertools/powertools-lambda-python/issues/4337))
+* **deps:** bump squidfunk/mkdocs-material from `e309089` to `98c9809` in /docs ([#4236](https://github.com/aws-powertools/powertools-lambda-python/issues/4236))
+* **deps:** bump actions/dependency-review-action from 4.3.1 to 4.3.2 ([#4244](https://github.com/aws-powertools/powertools-lambda-python/issues/4244))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.4 to 3.0.5 ([#4281](https://github.com/aws-powertools/powertools-lambda-python/issues/4281))
+* **deps:** bump actions/checkout from 4.1.4 to 4.1.5 ([#4282](https://github.com/aws-powertools/powertools-lambda-python/issues/4282))
+* **deps:** bump jinja2 from 3.1.3 to 3.1.4 in /docs ([#4284](https://github.com/aws-powertools/powertools-lambda-python/issues/4284))
+* **deps:** bump codecov/codecov-action from 4.3.0 to 4.3.1 ([#4252](https://github.com/aws-powertools/powertools-lambda-python/issues/4252))
+* **deps:** bump datadog-lambda from 5.93.0 to 5.94.0 ([#4253](https://github.com/aws-powertools/powertools-lambda-python/issues/4253))
+* **deps:** bump actions/checkout from 4.1.2 to 4.1.3 ([#4168](https://github.com/aws-powertools/powertools-lambda-python/issues/4168))
+* **deps:** bump actions/dependency-review-action from 4.2.5 to 4.3.1 ([#4240](https://github.com/aws-powertools/powertools-lambda-python/issues/4240))
+* **deps:** bump actions/checkout from 4.1.5 to 4.1.6 ([#4344](https://github.com/aws-powertools/powertools-lambda-python/issues/4344))
+* **deps:** bump squidfunk/mkdocs-material from `98c9809` to `11d7ec0` in /docs ([#4269](https://github.com/aws-powertools/powertools-lambda-python/issues/4269))
+* **deps:** bump actions/upload-artifact from 4.3.1 to 4.3.2 ([#4162](https://github.com/aws-powertools/powertools-lambda-python/issues/4162))
+* **deps:** bump codecov/codecov-action from 4.3.1 to 4.4.0 ([#4328](https://github.com/aws-powertools/powertools-lambda-python/issues/4328))
+* **deps:** bump slsa-framework/slsa-github-generator from 1.10.0 to 2.0.0 ([#4179](https://github.com/aws-powertools/powertools-lambda-python/issues/4179))
+* **deps:** bump actions/download-artifact from 4.1.5 to 4.1.6 ([#4178](https://github.com/aws-powertools/powertools-lambda-python/issues/4178))
+* **deps-dev:** bump mkdocs-material from 9.5.20 to 9.5.21 ([#4271](https://github.com/aws-powertools/powertools-lambda-python/issues/4271))
+* **deps-dev:** bump mike from 2.1.0 to 2.1.1 ([#4268](https://github.com/aws-powertools/powertools-lambda-python/issues/4268))
+* **deps-dev:** bump cfn-lint from 0.87.0 to 0.87.1 ([#4272](https://github.com/aws-powertools/powertools-lambda-python/issues/4272))
+* **deps-dev:** bump mike from 1.1.2 to 2.1.0 ([#4258](https://github.com/aws-powertools/powertools-lambda-python/issues/4258))
+* **deps-dev:** bump aws-cdk-lib from 2.139.1 to 2.140.0 ([#4259](https://github.com/aws-powertools/powertools-lambda-python/issues/4259))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.139.1a0 to 2.140.0a0 ([#4270](https://github.com/aws-powertools/powertools-lambda-python/issues/4270))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.139.0a0 to 2.139.1a0 ([#4261](https://github.com/aws-powertools/powertools-lambda-python/issues/4261))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.133 to 0.1.134 ([#4260](https://github.com/aws-powertools/powertools-lambda-python/issues/4260))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.134 to 0.1.135 ([#4273](https://github.com/aws-powertools/powertools-lambda-python/issues/4273))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.34.91 to 1.34.97 in the boto-typing group ([#4257](https://github.com/aws-powertools/powertools-lambda-python/issues/4257))
+* **deps-dev:** bump sentry-sdk from 2.0.1 to 2.1.1 ([#4287](https://github.com/aws-powertools/powertools-lambda-python/issues/4287))
+* **deps-dev:** bump aws-cdk-lib from 2.139.0 to 2.139.1 ([#4248](https://github.com/aws-powertools/powertools-lambda-python/issues/4248))
+* **deps-dev:** bump cfn-lint from 0.86.4 to 0.87.0 ([#4249](https://github.com/aws-powertools/powertools-lambda-python/issues/4249))
+* **deps-dev:** bump pytest-xdist from 3.5.0 to 3.6.1 ([#4247](https://github.com/aws-powertools/powertools-lambda-python/issues/4247))
+* **deps-dev:** bump ruff from 0.4.2 to 0.4.3 ([#4286](https://github.com/aws-powertools/powertools-lambda-python/issues/4286))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.132 to 0.1.133 ([#4246](https://github.com/aws-powertools/powertools-lambda-python/issues/4246))
+* **deps-dev:** bump jinja2 from 3.1.3 to 3.1.4 ([#4283](https://github.com/aws-powertools/powertools-lambda-python/issues/4283))
+* **deps-dev:** bump aws-cdk from 2.139.0 to 2.139.1 ([#4245](https://github.com/aws-powertools/powertools-lambda-python/issues/4245))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.135 to 0.1.136 ([#4285](https://github.com/aws-powertools/powertools-lambda-python/issues/4285))
+* **deps-dev:** bump filelock from 3.13.4 to 3.14.0 ([#4241](https://github.com/aws-powertools/powertools-lambda-python/issues/4241))
+* **deps-dev:** bump hvac from 2.1.0 to 2.2.0 ([#4238](https://github.com/aws-powertools/powertools-lambda-python/issues/4238))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.131 to 0.1.132 ([#4239](https://github.com/aws-powertools/powertools-lambda-python/issues/4239))
+* **deps-dev:** bump mkdocs-material from 9.5.19 to 9.5.20 ([#4242](https://github.com/aws-powertools/powertools-lambda-python/issues/4242))
+* **deps-dev:** bump aws-cdk from 2.139.1 to 2.140.0 ([#4256](https://github.com/aws-powertools/powertools-lambda-python/issues/4256))
+* **deps-dev:** bump pytest from 8.1.1 to 8.2.0 ([#4237](https://github.com/aws-powertools/powertools-lambda-python/issues/4237))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.136 to 0.1.139 ([#4293](https://github.com/aws-powertools/powertools-lambda-python/issues/4293))
+* **deps-dev:** bump aws-cdk-lib from 2.141.0 to 2.142.1 ([#4352](https://github.com/aws-powertools/powertools-lambda-python/issues/4352))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.139 to 0.1.140 ([#4301](https://github.com/aws-powertools/powertools-lambda-python/issues/4301))
+* **deps-dev:** bump sentry-sdk from 1.45.0 to 2.0.1 ([#4223](https://github.com/aws-powertools/powertools-lambda-python/issues/4223))
+* **deps-dev:** bump mkdocs-material from 9.5.18 to 9.5.19 ([#4224](https://github.com/aws-powertools/powertools-lambda-python/issues/4224))
+* **deps-dev:** bump black from 24.4.1 to 24.4.2 ([#4222](https://github.com/aws-powertools/powertools-lambda-python/issues/4222))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.138.0a0 to 2.139.0a0 ([#4225](https://github.com/aws-powertools/powertools-lambda-python/issues/4225))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.130 to 0.1.131 ([#4221](https://github.com/aws-powertools/powertools-lambda-python/issues/4221))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.140 to 0.1.142 ([#4307](https://github.com/aws-powertools/powertools-lambda-python/issues/4307))
+* **deps-dev:** bump ruff from 0.4.1 to 0.4.2 ([#4212](https://github.com/aws-powertools/powertools-lambda-python/issues/4212))
+* **deps-dev:** bump aws-cdk-lib from 2.138.0 to 2.139.0 ([#4213](https://github.com/aws-powertools/powertools-lambda-python/issues/4213))
+* **deps-dev:** bump aws-cdk from 2.138.0 to 2.139.0 ([#4215](https://github.com/aws-powertools/powertools-lambda-python/issues/4215))
+* **deps-dev:** bump aws-cdk from 2.140.0 to 2.141.0 ([#4306](https://github.com/aws-powertools/powertools-lambda-python/issues/4306))
+* **deps-dev:** bump types-redis from 4.6.0.20240423 to 4.6.0.20240425 ([#4214](https://github.com/aws-powertools/powertools-lambda-python/issues/4214))
+* **deps-dev:** bump aws-cdk-lib from 2.140.0 to 2.141.0 ([#4308](https://github.com/aws-powertools/powertools-lambda-python/issues/4308))
+* **deps-dev:** bump the boto-typing group with 2 updates ([#4210](https://github.com/aws-powertools/powertools-lambda-python/issues/4210))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.126 to 0.1.130 ([#4209](https://github.com/aws-powertools/powertools-lambda-python/issues/4209))
+* **deps-dev:** bump ruff from 0.4.3 to 0.4.4 ([#4309](https://github.com/aws-powertools/powertools-lambda-python/issues/4309))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.140.0a0 to 2.141.0a0 ([#4318](https://github.com/aws-powertools/powertools-lambda-python/issues/4318))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.142 to 0.1.144 ([#4316](https://github.com/aws-powertools/powertools-lambda-python/issues/4316))
+* **deps-dev:** bump black from 24.4.0 to 24.4.1 ([#4203](https://github.com/aws-powertools/powertools-lambda-python/issues/4203))
+* **deps-dev:** bump mypy from 1.9.0 to 1.10.0 ([#4202](https://github.com/aws-powertools/powertools-lambda-python/issues/4202))
+* **deps-dev:** bump mypy-boto3-ssm from 1.34.61 to 1.34.91 in the boto-typing group ([#4201](https://github.com/aws-powertools/powertools-lambda-python/issues/4201))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.123 to 0.1.126 ([#4188](https://github.com/aws-powertools/powertools-lambda-python/issues/4188))
+* **deps-dev:** bump cfn-lint from 0.87.1 to 0.87.2 ([#4317](https://github.com/aws-powertools/powertools-lambda-python/issues/4317))
+* **deps-dev:** bump coverage from 7.4.4 to 7.5.0 ([#4186](https://github.com/aws-powertools/powertools-lambda-python/issues/4186))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.144 to 0.1.145 ([#4325](https://github.com/aws-powertools/powertools-lambda-python/issues/4325))
+* **deps-dev:** bump types-redis from 4.6.0.20240417 to 4.6.0.20240423 ([#4185](https://github.com/aws-powertools/powertools-lambda-python/issues/4185))
+* **deps-dev:** bump mkdocs-material from 9.5.21 to 9.5.22 ([#4324](https://github.com/aws-powertools/powertools-lambda-python/issues/4324))
+* **deps-dev:** bump mypy-boto3-s3 from 1.34.91 to 1.34.105 in the boto-typing group ([#4329](https://github.com/aws-powertools/powertools-lambda-python/issues/4329))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.145 to 0.1.146 ([#4330](https://github.com/aws-powertools/powertools-lambda-python/issues/4330))
+* **deps-dev:** bump cfn-lint from 0.86.3 to 0.86.4 ([#4180](https://github.com/aws-powertools/powertools-lambda-python/issues/4180))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.121 to 0.1.123 ([#4176](https://github.com/aws-powertools/powertools-lambda-python/issues/4176))
+* **deps-dev:** bump mkdocs-material from 9.5.22 to 9.5.23 ([#4338](https://github.com/aws-powertools/powertools-lambda-python/issues/4338))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.137.0a0 to 2.138.0a0 ([#4169](https://github.com/aws-powertools/powertools-lambda-python/issues/4169))
+* **deps-dev:** bump aws-cdk from 2.141.0 to 2.142.0 ([#4343](https://github.com/aws-powertools/powertools-lambda-python/issues/4343))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.119 to 0.1.121 ([#4167](https://github.com/aws-powertools/powertools-lambda-python/issues/4167))
+* **deps-dev:** bump ruff from 0.3.7 to 0.4.1 ([#4166](https://github.com/aws-powertools/powertools-lambda-python/issues/4166))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.34.72 to 1.34.107 in the boto-typing group ([#4345](https://github.com/aws-powertools/powertools-lambda-python/issues/4345))
+* **deps-dev:** bump aws-cdk from 2.137.0 to 2.138.0 ([#4157](https://github.com/aws-powertools/powertools-lambda-python/issues/4157))
+* **deps-dev:** bump aws-cdk-lib from 2.137.0 to 2.138.0 ([#4160](https://github.com/aws-powertools/powertools-lambda-python/issues/4160))
+* **deps-dev:** bump sentry-sdk from 2.1.1 to 2.2.0 ([#4348](https://github.com/aws-powertools/powertools-lambda-python/issues/4348))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.146 to 0.1.150 ([#4346](https://github.com/aws-powertools/powertools-lambda-python/issues/4346))
+* **deps-dev:** bump coverage from 7.5.0 to 7.5.1 ([#4288](https://github.com/aws-powertools/powertools-lambda-python/issues/4288))
+* **governance:** add FastAPI third party license attribution ([#4297](https://github.com/aws-powertools/powertools-lambda-python/issues/4297))
+
+
+<a name="v2.37.0"></a>
+## [v2.37.0] - 2024-04-18
+## Bug Fixes
+
+* **docs:** clarified usage of validation with fine grained responses ([#4101](https://github.com/aws-powertools/powertools-lambda-python/issues/4101))
+* **event_source:** fix typo in physicalname attribute for AmazonMQ events ([#4053](https://github.com/aws-powertools/powertools-lambda-python/issues/4053))
+* **typing:** make the case_sensitive field a boolean only ([#4128](https://github.com/aws-powertools/powertools-lambda-python/issues/4128))
+* **typing:** improve overloads to ensure the return type follows the default_value type ([#4114](https://github.com/aws-powertools/powertools-lambda-python/issues/4114))
+
+## Documentation
+
+* **we-made-this:** new article on how to stream data with AWS Lambda & Powertools for AWS Lambda ([#4068](https://github.com/aws-powertools/powertools-lambda-python/issues/4068))
+
+## Features
+
+* **Idempotency:** add feature for manipulating idempotent responses ([#4037](https://github.com/aws-powertools/powertools-lambda-python/issues/4037))
+* **event_handler:** add support for OpenAPI security schemes ([#4103](https://github.com/aws-powertools/powertools-lambda-python/issues/4103))
+* **logger:** add method to return currently configured keys ([#4033](https://github.com/aws-powertools/powertools-lambda-python/issues/4033))
+
+## Maintenance
+
+* version bump
+* **ci:** add monthly roadmap reminder workflow ([#4075](https://github.com/aws-powertools/powertools-lambda-python/issues/4075))
+* **ci:** prevent deprecated custom runner from being used ([#4061](https://github.com/aws-powertools/powertools-lambda-python/issues/4061))
+* **deps:** bump squidfunk/mkdocs-material from `065f3af` to `6b124e1` in /docs ([#4055](https://github.com/aws-powertools/powertools-lambda-python/issues/4055))
+* **deps:** bump squidfunk/mkdocs-material from `3307665` to `065f3af` in /docs ([#4052](https://github.com/aws-powertools/powertools-lambda-python/issues/4052))
+* **deps:** bump idna from 3.6 to 3.7 ([#4121](https://github.com/aws-powertools/powertools-lambda-python/issues/4121))
+* **deps:** bump sqlparse from 0.4.4 to 0.5.0 ([#4138](https://github.com/aws-powertools/powertools-lambda-python/issues/4138))
+* **deps:** bump squidfunk/mkdocs-material from `6b124e1` to `521644b` in /docs ([#4141](https://github.com/aws-powertools/powertools-lambda-python/issues/4141))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#4066](https://github.com/aws-powertools/powertools-lambda-python/issues/4066))
+* **deps:** bump pydantic from 1.10.14 to 1.10.15 ([#4064](https://github.com/aws-powertools/powertools-lambda-python/issues/4064))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#4042](https://github.com/aws-powertools/powertools-lambda-python/issues/4042))
+* **deps:** bump golang.org/x/sync from 0.6.0 to 0.7.0 in /layer/scripts/layer-balancer in the layer-balancer group ([#4071](https://github.com/aws-powertools/powertools-lambda-python/issues/4071))
+* **deps:** bump codecov/codecov-action from 4.1.1 to 4.2.0 ([#4072](https://github.com/aws-powertools/powertools-lambda-python/issues/4072))
+* **deps:** bump datadog-lambda from 5.91.0 to 5.92.0 ([#4038](https://github.com/aws-powertools/powertools-lambda-python/issues/4038))
+* **deps:** bump github.com/aws/aws-sdk-go-v2/config from 1.27.10 to 1.27.11 in /layer/scripts/layer-balancer in the layer-balancer group ([#4079](https://github.com/aws-powertools/powertools-lambda-python/issues/4079))
+* **deps:** bump typing-extensions from 4.10.0 to 4.11.0 ([#4080](https://github.com/aws-powertools/powertools-lambda-python/issues/4080))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.3 to 3.0.4 ([#4099](https://github.com/aws-powertools/powertools-lambda-python/issues/4099))
+* **deps:** bump codecov/codecov-action from 4.2.0 to 4.3.0 ([#4098](https://github.com/aws-powertools/powertools-lambda-python/issues/4098))
+* **deps:** bump docker/setup-buildx-action from 3.2.0 to 3.3.0 ([#4091](https://github.com/aws-powertools/powertools-lambda-python/issues/4091))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.112 to 0.1.113 ([#4136](https://github.com/aws-powertools/powertools-lambda-python/issues/4136))
+* **deps-dev:** bump aws-cdk from 2.135.0 to 2.136.0 ([#4090](https://github.com/aws-powertools/powertools-lambda-python/issues/4090))
+* **deps-dev:** bump types-redis from 4.6.0.20240311 to 4.6.0.20240409 ([#4094](https://github.com/aws-powertools/powertools-lambda-python/issues/4094))
+* **deps-dev:** bump aws-cdk-lib from 2.135.0 to 2.136.0 ([#4092](https://github.com/aws-powertools/powertools-lambda-python/issues/4092))
+* **deps-dev:** bump cfn-lint from 0.86.1 to 0.86.2 ([#4081](https://github.com/aws-powertools/powertools-lambda-python/issues/4081))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.135.0a0 to 2.136.0a0 ([#4095](https://github.com/aws-powertools/powertools-lambda-python/issues/4095))
+* **deps-dev:** bump filelock from 3.13.3 to 3.13.4 ([#4096](https://github.com/aws-powertools/powertools-lambda-python/issues/4096))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.106 to 0.1.107 ([#4082](https://github.com/aws-powertools/powertools-lambda-python/issues/4082))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.107 to 0.1.110 ([#4097](https://github.com/aws-powertools/powertools-lambda-python/issues/4097))
+* **deps-dev:** bump aws-cdk from 2.136.0 to 2.136.1 ([#4106](https://github.com/aws-powertools/powertools-lambda-python/issues/4106))
+* **deps-dev:** bump aws-cdk-lib from 2.136.0 to 2.136.1 ([#4107](https://github.com/aws-powertools/powertools-lambda-python/issues/4107))
+* **deps-dev:** bump sentry-sdk from 1.44.1 to 1.45.0 ([#4108](https://github.com/aws-powertools/powertools-lambda-python/issues/4108))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.110 to 0.1.112 ([#4109](https://github.com/aws-powertools/powertools-lambda-python/issues/4109))
+* **deps-dev:** bump sentry-sdk from 1.44.0 to 1.44.1 ([#4065](https://github.com/aws-powertools/powertools-lambda-python/issues/4065))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.134.0a0 to 2.135.0a0 ([#4063](https://github.com/aws-powertools/powertools-lambda-python/issues/4063))
+* **deps-dev:** bump aws-cdk from 2.136.1 to 2.137.0 ([#4115](https://github.com/aws-powertools/powertools-lambda-python/issues/4115))
+* **deps-dev:** bump the boto-typing group with 2 updates ([#4062](https://github.com/aws-powertools/powertools-lambda-python/issues/4062))
+* **deps-dev:** bump mypy-boto3-cloudwatch from 1.34.75 to 1.34.83 in the boto-typing group ([#4116](https://github.com/aws-powertools/powertools-lambda-python/issues/4116))
+* **deps-dev:** bump ruff from 0.3.5 to 0.3.7 ([#4123](https://github.com/aws-powertools/powertools-lambda-python/issues/4123))
+* **deps-dev:** bump aws-cdk-lib from 2.136.1 to 2.137.0 ([#4119](https://github.com/aws-powertools/powertools-lambda-python/issues/4119))
+* **deps-dev:** bump aws-cdk from 2.134.0 to 2.135.0 ([#4058](https://github.com/aws-powertools/powertools-lambda-python/issues/4058))
+* **deps-dev:** bump aws-cdk-lib from 2.134.0 to 2.135.0 ([#4057](https://github.com/aws-powertools/powertools-lambda-python/issues/4057))
+* **deps-dev:** bump mkdocs-material from 9.5.16 to 9.5.17 ([#4056](https://github.com/aws-powertools/powertools-lambda-python/issues/4056))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.136.0a0 to 2.137.0a0 ([#4124](https://github.com/aws-powertools/powertools-lambda-python/issues/4124))
+* **deps-dev:** bump mypy-boto3-cloudformation from 1.34.77 to 1.34.84 in the boto-typing group ([#4126](https://github.com/aws-powertools/powertools-lambda-python/issues/4126))
+* **deps-dev:** bump ruff from 0.3.4 to 0.3.5 ([#4049](https://github.com/aws-powertools/powertools-lambda-python/issues/4049))
+* **deps-dev:** bump mkdocs-material from 9.5.15 to 9.5.16 ([#4050](https://github.com/aws-powertools/powertools-lambda-python/issues/4050))
+* **deps-dev:** bump the boto-typing group with 1 update ([#4047](https://github.com/aws-powertools/powertools-lambda-python/issues/4047))
+* **deps-dev:** bump black from 24.3.0 to 24.4.0 ([#4135](https://github.com/aws-powertools/powertools-lambda-python/issues/4135))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.105 to 0.1.106 ([#4048](https://github.com/aws-powertools/powertools-lambda-python/issues/4048))
+* **deps-dev:** bump cfn-lint from 0.86.2 to 0.86.3 ([#4137](https://github.com/aws-powertools/powertools-lambda-python/issues/4137))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.113 to 0.1.115 ([#4142](https://github.com/aws-powertools/powertools-lambda-python/issues/4142))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.133.0a0 to 2.134.0a0 ([#4039](https://github.com/aws-powertools/powertools-lambda-python/issues/4039))
+* **deps-dev:** bump mkdocs-material from 9.5.17 to 9.5.18 ([#4143](https://github.com/aws-powertools/powertools-lambda-python/issues/4143))
+* **deps-dev:** bump types-redis from 4.6.0.20240409 to 4.6.0.20240417 ([#4145](https://github.com/aws-powertools/powertools-lambda-python/issues/4145))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.115 to 0.1.119 ([#4150](https://github.com/aws-powertools/powertools-lambda-python/issues/4150))
+* **deps-dev:** bump aws-cdk-lib from 2.133.0 to 2.134.0 ([#4031](https://github.com/aws-powertools/powertools-lambda-python/issues/4031))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.104 to 0.1.105 ([#4030](https://github.com/aws-powertools/powertools-lambda-python/issues/4030))
+* **deps-dev:** bump aws-cdk from 2.133.0 to 2.134.0 ([#4032](https://github.com/aws-powertools/powertools-lambda-python/issues/4032))
+* **deps-dev:** bump the boto-typing group with 1 update ([#4029](https://github.com/aws-powertools/powertools-lambda-python/issues/4029))
+* **deps-dev:** bump sentry-sdk from 1.43.0 to 1.44.0 ([#4040](https://github.com/aws-powertools/powertools-lambda-python/issues/4040))
+* **docs:** update highlighted lines on the Typing examples ([#4131](https://github.com/aws-powertools/powertools-lambda-python/issues/4131))
+
+
+<a name="v2.36.0"></a>
+## [v2.36.0] - 2024-03-27
+## Bug Fixes
+
+* **event_handler:** always add 422 response to the schema ([#3995](https://github.com/aws-powertools/powertools-lambda-python/issues/3995))
+* **event_handler:** make decoded_body field optional in ApiGateway resolver ([#3937](https://github.com/aws-powertools/powertools-lambda-python/issues/3937))
+* **tracer:** add name sanitization for X-Ray subsegments ([#4005](https://github.com/aws-powertools/powertools-lambda-python/issues/4005))
+
+## Code Refactoring
+
+* **logger:** add type annotation for append_keys method ([#3988](https://github.com/aws-powertools/powertools-lambda-python/issues/3988))
+* **parameters:** improve typing for get_secret method ([#3910](https://github.com/aws-powertools/powertools-lambda-python/issues/3910))
+
+## Documentation
+
+* **batch:** improved the example demonstrating how to create a custom partial processor. ([#4024](https://github.com/aws-powertools/powertools-lambda-python/issues/4024))
+* **bedrock-agents:** fix type in Bedrock operation example ([#3948](https://github.com/aws-powertools/powertools-lambda-python/issues/3948))
+* **tutorial:** fix "Simplifying with Tracer" section in the tutorial ([#3962](https://github.com/aws-powertools/powertools-lambda-python/issues/3962))
+
+## Features
+
+* **batch:** add flag in SqsFifoProcessor to enable continuous message processing ([#3954](https://github.com/aws-powertools/powertools-lambda-python/issues/3954))
+* **data_classes:** Add CloudWatchAlarmEvent data class ([#3868](https://github.com/aws-powertools/powertools-lambda-python/issues/3868))
+* **event-handler:** add compress option when serving Swagger HTML ([#3946](https://github.com/aws-powertools/powertools-lambda-python/issues/3946))
+* **event_handler:** define exception_handler directly from the router ([#3979](https://github.com/aws-powertools/powertools-lambda-python/issues/3979))
+* **metrics:** allow custom timestamps for metrics ([#4006](https://github.com/aws-powertools/powertools-lambda-python/issues/4006))
+* **parameters:** add feature for creating and updating Parameters and Secrets ([#2858](https://github.com/aws-powertools/powertools-lambda-python/issues/2858))
+* **tracer:** auto-disable tracer when for AWS SAM and Chalice environments ([#3949](https://github.com/aws-powertools/powertools-lambda-python/issues/3949))
+
+## Maintenance
+
+* version bump
+* **deps:** bump squidfunk/mkdocs-material from `3678304` to `6c81a89` in /docs ([#3973](https://github.com/aws-powertools/powertools-lambda-python/issues/3973))
+* **deps:** bump datadog-lambda from 5.89.0 to 5.90.0 ([#3941](https://github.com/aws-powertools/powertools-lambda-python/issues/3941))
+* **deps:** bump actions/checkout from 4.1.1 to 4.1.2 ([#3939](https://github.com/aws-powertools/powertools-lambda-python/issues/3939))
+* **deps:** bump redis from 5.0.2 to 5.0.3 ([#3929](https://github.com/aws-powertools/powertools-lambda-python/issues/3929))
+* **deps:** bump slsa-framework/slsa-github-generator from 1.9.0 to 1.10.0 ([#3997](https://github.com/aws-powertools/powertools-lambda-python/issues/3997))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#4001](https://github.com/aws-powertools/powertools-lambda-python/issues/4001))
+* **deps:** bump actions/dependency-review-action from 4.2.3 to 4.2.4 ([#4012](https://github.com/aws-powertools/powertools-lambda-python/issues/4012))
+* **deps:** bump docker/setup-buildx-action from 3.1.0 to 3.2.0 ([#3955](https://github.com/aws-powertools/powertools-lambda-python/issues/3955))
+* **deps:** bump actions/dependency-review-action from 4.1.3 to 4.2.3 ([#3993](https://github.com/aws-powertools/powertools-lambda-python/issues/3993))
+* **deps:** bump datadog-lambda from 5.90.0 to 5.91.0 ([#3958](https://github.com/aws-powertools/powertools-lambda-python/issues/3958))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.8.12 to 1.8.14 ([#3918](https://github.com/aws-powertools/powertools-lambda-python/issues/3918))
+* **deps:** bump squidfunk/mkdocs-material from `6c81a89` to `3307665` in /docs ([#4017](https://github.com/aws-powertools/powertools-lambda-python/issues/4017))
+* **deps:** bump actions/dependency-review-action from 4.2.4 to 4.2.5 ([#4023](https://github.com/aws-powertools/powertools-lambda-python/issues/4023))
+* **deps:** bump aws-encryption-sdk from 3.1.1 to 3.2.0 ([#3983](https://github.com/aws-powertools/powertools-lambda-python/issues/3983))
+* **deps:** bump actions/setup-python from 5.0.0 to 5.1.0 ([#4022](https://github.com/aws-powertools/powertools-lambda-python/issues/4022))
+* **deps:** bump codecov/codecov-action from 4.1.0 to 4.1.1 ([#4021](https://github.com/aws-powertools/powertools-lambda-python/issues/4021))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#3972](https://github.com/aws-powertools/powertools-lambda-python/issues/3972))
+* **deps-dev:** bump filelock from 3.13.1 to 3.13.3 ([#4014](https://github.com/aws-powertools/powertools-lambda-python/issues/4014))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.90 to 0.1.91 ([#3975](https://github.com/aws-powertools/powertools-lambda-python/issues/3975))
+* **deps-dev:** bump types-python-dateutil from 2.9.0.20240315 to 2.9.0.20240316 ([#3977](https://github.com/aws-powertools/powertools-lambda-python/issues/3977))
+* **deps-dev:** bump mkdocs-material from 9.5.13 to 9.5.14 ([#3978](https://github.com/aws-powertools/powertools-lambda-python/issues/3978))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.132.1a0 to 2.133.0a0 ([#3976](https://github.com/aws-powertools/powertools-lambda-python/issues/3976))
+* **deps-dev:** bump the boto-typing group with 2 updates ([#3974](https://github.com/aws-powertools/powertools-lambda-python/issues/3974))
+* **deps-dev:** bump the boto-typing group with 2 updates ([#3982](https://github.com/aws-powertools/powertools-lambda-python/issues/3982))
+* **deps-dev:** bump ruff from 0.3.2 to 0.3.3 ([#3967](https://github.com/aws-powertools/powertools-lambda-python/issues/3967))
+* **deps-dev:** bump aws-cdk-lib from 2.132.1 to 2.133.0 ([#3965](https://github.com/aws-powertools/powertools-lambda-python/issues/3965))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.91 to 0.1.94 ([#3985](https://github.com/aws-powertools/powertools-lambda-python/issues/3985))
+* **deps-dev:** bump black from 24.2.0 to 24.3.0 ([#3968](https://github.com/aws-powertools/powertools-lambda-python/issues/3968))
+* **deps-dev:** bump types-python-dateutil from 2.8.19.20240311 to 2.9.0.20240315 ([#3966](https://github.com/aws-powertools/powertools-lambda-python/issues/3966))
+* **deps-dev:** bump aws-cdk from 2.132.1 to 2.133.0 ([#3963](https://github.com/aws-powertools/powertools-lambda-python/issues/3963))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3964](https://github.com/aws-powertools/powertools-lambda-python/issues/3964))
+* **deps-dev:** bump pytest-asyncio from 0.23.5.post1 to 0.23.6 ([#3984](https://github.com/aws-powertools/powertools-lambda-python/issues/3984))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3991](https://github.com/aws-powertools/powertools-lambda-python/issues/3991))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.89 to 0.1.90 ([#3957](https://github.com/aws-powertools/powertools-lambda-python/issues/3957))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3956](https://github.com/aws-powertools/powertools-lambda-python/issues/3956))
+* **deps-dev:** bump sentry-sdk from 1.42.0 to 1.43.0 ([#3992](https://github.com/aws-powertools/powertools-lambda-python/issues/3992))
+* **deps-dev:** bump coverage from 7.4.3 to 7.4.4 ([#3959](https://github.com/aws-powertools/powertools-lambda-python/issues/3959))
+* **deps-dev:** bump ruff from 0.3.3 to 0.3.4 ([#3996](https://github.com/aws-powertools/powertools-lambda-python/issues/3996))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.88 to 0.1.89 ([#3952](https://github.com/aws-powertools/powertools-lambda-python/issues/3952))
+* **deps-dev:** bump sentry-sdk from 1.41.0 to 1.42.0 ([#3951](https://github.com/aws-powertools/powertools-lambda-python/issues/3951))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3950](https://github.com/aws-powertools/powertools-lambda-python/issues/3950))
+* **deps-dev:** bump pytest-mock from 3.12.0 to 3.13.0 ([#3999](https://github.com/aws-powertools/powertools-lambda-python/issues/3999))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.94 to 0.1.96 ([#4002](https://github.com/aws-powertools/powertools-lambda-python/issues/4002))
+* **deps-dev:** bump the boto-typing group with 2 updates ([#3940](https://github.com/aws-powertools/powertools-lambda-python/issues/3940))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.87 to 0.1.88 ([#3942](https://github.com/aws-powertools/powertools-lambda-python/issues/3942))
+* **deps-dev:** bump pytest from 8.0.2 to 8.1.1 ([#3943](https://github.com/aws-powertools/powertools-lambda-python/issues/3943))
+* **deps-dev:** bump aws-cdk-aws-lambda-python-alpha from 2.131.0a0 to 2.132.1a0 ([#3944](https://github.com/aws-powertools/powertools-lambda-python/issues/3944))
+* **deps-dev:** bump cfn-lint from 0.86.0 to 0.86.1 ([#3998](https://github.com/aws-powertools/powertools-lambda-python/issues/3998))
+* **deps-dev:** bump aws-cdk from 2.132.0 to 2.132.1 ([#3938](https://github.com/aws-powertools/powertools-lambda-python/issues/3938))
+* **deps-dev:** bump aws-cdk-lib from 2.131.0 to 2.132.1 ([#3936](https://github.com/aws-powertools/powertools-lambda-python/issues/3936))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.96 to 0.1.99 ([#4008](https://github.com/aws-powertools/powertools-lambda-python/issues/4008))
+* **deps-dev:** bump aws-cdk from 2.131.0 to 2.132.0 ([#3928](https://github.com/aws-powertools/powertools-lambda-python/issues/3928))
+* **deps-dev:** bump types-redis from 4.6.0.20240218 to 4.6.0.20240311 ([#3931](https://github.com/aws-powertools/powertools-lambda-python/issues/3931))
+* **deps-dev:** bump types-python-dateutil from 2.8.19.20240106 to 2.8.19.20240311 ([#3932](https://github.com/aws-powertools/powertools-lambda-python/issues/3932))
+* **deps-dev:** bump pytest-mock from 3.13.0 to 3.14.0 ([#4007](https://github.com/aws-powertools/powertools-lambda-python/issues/4007))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.99 to 0.1.101 ([#4015](https://github.com/aws-powertools/powertools-lambda-python/issues/4015))
+* **deps-dev:** bump ruff from 0.3.0 to 0.3.2 ([#3925](https://github.com/aws-powertools/powertools-lambda-python/issues/3925))
+* **deps-dev:** bump mypy from 1.8.0 to 1.9.0 ([#3921](https://github.com/aws-powertools/powertools-lambda-python/issues/3921))
+* **deps-dev:** bump bandit from 1.7.7 to 1.7.8 ([#3920](https://github.com/aws-powertools/powertools-lambda-python/issues/3920))
+* **deps-dev:** bump pytest-cov from 4.1.0 to 5.0.0 ([#4013](https://github.com/aws-powertools/powertools-lambda-python/issues/4013))
+* **deps-dev:** bump pytest-asyncio from 0.23.5 to 0.23.5.post1 ([#3923](https://github.com/aws-powertools/powertools-lambda-python/issues/3923))
+* **deps-dev:** bump mkdocs-material from 9.5.14 to 9.5.15 ([#4016](https://github.com/aws-powertools/powertools-lambda-python/issues/4016))
+* **deps-dev:** bump the boto-typing group with 2 updates ([#3919](https://github.com/aws-powertools/powertools-lambda-python/issues/3919))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.101 to 0.1.104 ([#4020](https://github.com/aws-powertools/powertools-lambda-python/issues/4020))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.83 to 0.1.87 ([#3930](https://github.com/aws-powertools/powertools-lambda-python/issues/3930))
+
+
+<a name="v2.35.1"></a>
+## [v2.35.1] - 2024-03-08
+## Bug Fixes
+
+* **data_sources:** ensure correct types on SQSMessageAttributes ([#3898](https://github.com/aws-powertools/powertools-lambda-python/issues/3898))
+* **event_handler:** validate POST bodies on BedrockAgentResolver ([#3903](https://github.com/aws-powertools/powertools-lambda-python/issues/3903))
+* **internal:** call ruff with correct args ([#3901](https://github.com/aws-powertools/powertools-lambda-python/issues/3901))
+
+## Features
+
+* **event_handler:** use custom serializer during openapi serialization ([#3900](https://github.com/aws-powertools/powertools-lambda-python/issues/3900))
+
+## Maintenance
+
+* version bump
+* **deps:** bump aws-xray-sdk from 2.12.1 to 2.13.0 ([#3906](https://github.com/aws-powertools/powertools-lambda-python/issues/3906))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#3911](https://github.com/aws-powertools/powertools-lambda-python/issues/3911))
+* **deps:** bump squidfunk/mkdocs-material from `7be068b` to `3678304` in /docs ([#3894](https://github.com/aws-powertools/powertools-lambda-python/issues/3894))
+* **deps:** bump datadog-lambda from 5.88.0 to 5.89.0 ([#3907](https://github.com/aws-powertools/powertools-lambda-python/issues/3907))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.81 to 0.1.82 ([#3896](https://github.com/aws-powertools/powertools-lambda-python/issues/3896))
+* **deps-dev:** bump sentry-sdk from 1.40.6 to 1.41.0 ([#3905](https://github.com/aws-powertools/powertools-lambda-python/issues/3905))
+* **deps-dev:** bump mkdocs-material from 9.5.12 to 9.5.13 ([#3895](https://github.com/aws-powertools/powertools-lambda-python/issues/3895))
+* **deps-dev:** bump cdklabs-generative-ai-cdk-constructs from 0.1.82 to 0.1.83 ([#3908](https://github.com/aws-powertools/powertools-lambda-python/issues/3908))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3904](https://github.com/aws-powertools/powertools-lambda-python/issues/3904))
+
+
+<a name="v2.35.0"></a>
+## [v2.35.0] - 2024-03-06
+## Bug Fixes
+
+* **event_handler:** OpenAPI schema version respects Pydantic version ([#3860](https://github.com/aws-powertools/powertools-lambda-python/issues/3860))
+
+## Code Refactoring
+
+* **logger:** improve typing ([#3869](https://github.com/aws-powertools/powertools-lambda-python/issues/3869))
+
+## Documentation
+
+* **event_handler:** add bedrock agent resolver documentation ([#3602](https://github.com/aws-powertools/powertools-lambda-python/issues/3602))
+
+## Maintenance
+
+* version bump
+* **deps:** bump docker/setup-buildx-action from 3.0.0 to 3.1.0 ([#3864](https://github.com/aws-powertools/powertools-lambda-python/issues/3864))
+* **deps:** bump actions/download-artifact from 4.1.3 to 4.1.4 ([#3875](https://github.com/aws-powertools/powertools-lambda-python/issues/3875))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3884](https://github.com/aws-powertools/powertools-lambda-python/issues/3884))
+* **deps:** bump squidfunk/mkdocs-material from `49d1bfd` to `7be068b` in /docs ([#3872](https://github.com/aws-powertools/powertools-lambda-python/issues/3872))
+* **deps:** bump squidfunk/mkdocs-material from `43b898a` to `49d1bfd` in /docs ([#3857](https://github.com/aws-powertools/powertools-lambda-python/issues/3857))
+* **deps:** bump codecov/codecov-action from 4.0.2 to 4.1.0 ([#3856](https://github.com/aws-powertools/powertools-lambda-python/issues/3856))
+* **deps:** bump redis from 5.0.1 to 5.0.2 ([#3867](https://github.com/aws-powertools/powertools-lambda-python/issues/3867))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3887](https://github.com/aws-powertools/powertools-lambda-python/issues/3887))
+* **deps:** bump actions/download-artifact from 4.1.2 to 4.1.3 ([#3862](https://github.com/aws-powertools/powertools-lambda-python/issues/3862))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.8.11 to 1.8.12 ([#3863](https://github.com/aws-powertools/powertools-lambda-python/issues/3863))
+* **deps-dev:** bump aws-cdk-lib from 2.130.0 to 2.131.0 ([#3881](https://github.com/aws-powertools/powertools-lambda-python/issues/3881))
+* **deps-dev:** bump cfn-lint from 0.85.3 to 0.86.0 ([#3882](https://github.com/aws-powertools/powertools-lambda-python/issues/3882))
+* **deps-dev:** bump black from 24.1.1 to 24.2.0 ([#3760](https://github.com/aws-powertools/powertools-lambda-python/issues/3760))
+* **deps-dev:** bump cfn-lint from 0.85.2 to 0.85.3 ([#3861](https://github.com/aws-powertools/powertools-lambda-python/issues/3861))
+* **deps-dev:** bump aws-cdk from 2.130.0 to 2.131.0 ([#3883](https://github.com/aws-powertools/powertools-lambda-python/issues/3883))
+* **deps-dev:** bump mkdocs-material from 9.5.11 to 9.5.12 ([#3870](https://github.com/aws-powertools/powertools-lambda-python/issues/3870))
+* **deps-dev:** bump ruff from 0.2.2 to 0.3.0 ([#3871](https://github.com/aws-powertools/powertools-lambda-python/issues/3871))
+* **docs:** add Bedrock Agents to feature list ([#3889](https://github.com/aws-powertools/powertools-lambda-python/issues/3889))
+
+
+<a name="v2.34.2"></a>
+## [v2.34.2] - 2024-02-26
+## Bug Fixes
+
+* **typing:** ensure return type is a str when default_value is set ([#3840](https://github.com/aws-powertools/powertools-lambda-python/issues/3840))
+
+## Documentation
+
+* **install:** make minimum install the default option then extra ([#3834](https://github.com/aws-powertools/powertools-lambda-python/issues/3834))
+
+## Features
+
+* **event-source:** add function to get multi-value query string params by name ([#3846](https://github.com/aws-powertools/powertools-lambda-python/issues/3846))
+
+## Maintenance
+
+* version bump
+* **ci:** remove aws-encryption-sdk from Lambda layer due to cffi being tied to python version ([#3853](https://github.com/aws-powertools/powertools-lambda-python/issues/3853))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#3844](https://github.com/aws-powertools/powertools-lambda-python/issues/3844))
+* **deps:** bump cryptography from 42.0.2 to 42.0.4 ([#3827](https://github.com/aws-powertools/powertools-lambda-python/issues/3827))
+* **deps:** bump codecov/codecov-action from 4.0.1 to 4.0.2 ([#3842](https://github.com/aws-powertools/powertools-lambda-python/issues/3842))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#3835](https://github.com/aws-powertools/powertools-lambda-python/issues/3835))
+* **deps-dev:** bump httpx from 0.26.0 to 0.27.0 ([#3828](https://github.com/aws-powertools/powertools-lambda-python/issues/3828))
+* **deps-dev:** bump aws-cdk from 2.128.0 to 2.129.0 ([#3831](https://github.com/aws-powertools/powertools-lambda-python/issues/3831))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3836](https://github.com/aws-powertools/powertools-lambda-python/issues/3836))
+* **deps-dev:** bump aws-cdk from 2.129.0 to 2.130.0 ([#3843](https://github.com/aws-powertools/powertools-lambda-python/issues/3843))
+* **deps-dev:** bump aws-cdk-lib from 2.128.0 to 2.130.0 ([#3838](https://github.com/aws-powertools/powertools-lambda-python/issues/3838))
+
+
+<a name="v2.34.1"></a>
+## [v2.34.1] - 2024-02-21
+## Bug Fixes
+
+* **ci:** inject PR_LABELS env for PR Label automation ([#3819](https://github.com/aws-powertools/powertools-lambda-python/issues/3819))
+* **ci:** revert layer version bump write-only back to append ([#3818](https://github.com/aws-powertools/powertools-lambda-python/issues/3818))
+* **event-handler:** return dict on missing multi_value_headers ([#3824](https://github.com/aws-powertools/powertools-lambda-python/issues/3824))
+* **idempotency:** validate before saving to cache ([#3822](https://github.com/aws-powertools/powertools-lambda-python/issues/3822))
+
+## Maintenance
+
+* version bump
+* **deps-dev:** bump ruff from 0.2.1 to 0.2.2 ([#3802](https://github.com/aws-powertools/powertools-lambda-python/issues/3802))
+* **deps-dev:** bump the boto-typing group with 2 updates ([#3810](https://github.com/aws-powertools/powertools-lambda-python/issues/3810))
+
+
+<a name="v2.34.0"></a>
+## [v2.34.0] - 2024-02-21
+## Bug Fixes
+
+* **ci:** create one layer artifact per region & merge ([#3808](https://github.com/aws-powertools/powertools-lambda-python/issues/3808))
+* **event-handler:** multi-value query string and validation of scalar parameters ([#3795](https://github.com/aws-powertools/powertools-lambda-python/issues/3795))
+* **event-handler:** swagger schema respects api stage ([#3796](https://github.com/aws-powertools/powertools-lambda-python/issues/3796))
+* **event-handler:** handle aliased parameters e.g., Query(alias="categoryType") ([#3766](https://github.com/aws-powertools/powertools-lambda-python/issues/3766))
+
+## Code Refactoring
+
+* **feature-flags:** add intersection tests; structure refinement ([#3775](https://github.com/aws-powertools/powertools-lambda-python/issues/3775))
+
+## Documentation
+
+* **feature_flags:** fix incorrect line markers and envelope name ([#3792](https://github.com/aws-powertools/powertools-lambda-python/issues/3792))
+* **home:** update layer version to 62 for package version 2.33.1 ([#3778](https://github.com/aws-powertools/powertools-lambda-python/issues/3778))
+* **home:** add note about POWERTOOLS_DEV side effects in CloudWatch Logs ([#3770](https://github.com/aws-powertools/powertools-lambda-python/issues/3770))
+* **homepage:** discord flat badge style; remove former devax email ([#3768](https://github.com/aws-powertools/powertools-lambda-python/issues/3768))
+* **homepage:** remove leftover announcement banner ([#3783](https://github.com/aws-powertools/powertools-lambda-python/issues/3783))
+* **roadmap:** latest roadmap update; use new grid to de-clutter homepage ([#3755](https://github.com/aws-powertools/powertools-lambda-python/issues/3755))
+* **we-made-this:** add swagger post ([#3799](https://github.com/aws-powertools/powertools-lambda-python/issues/3799))
+* **we-made-this:** add reinvent 2023 session ([#3790](https://github.com/aws-powertools/powertools-lambda-python/issues/3790))
+
+## Features
+
+* **feature_flags:** add intersect actions for conditions ([#3692](https://github.com/aws-powertools/powertools-lambda-python/issues/3692))
+
+## Maintenance
+
+* version bump
+* **deps:** bump actions/dependency-review-action from 4.1.2 to 4.1.3 ([#3813](https://github.com/aws-powertools/powertools-lambda-python/issues/3813))
+* **deps:** bump actions/dependency-review-action from 4.1.0 to 4.1.2 ([#3800](https://github.com/aws-powertools/powertools-lambda-python/issues/3800))
+* **deps:** bump actions/dependency-review-action from 4.0.0 to 4.1.0 ([#3771](https://github.com/aws-powertools/powertools-lambda-python/issues/3771))
+* **deps:** bump squidfunk/mkdocs-material from `62d3668` to `43b898a` in /docs ([#3801](https://github.com/aws-powertools/powertools-lambda-python/issues/3801))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#3764](https://github.com/aws-powertools/powertools-lambda-python/issues/3764))
+* **deps:** bump squidfunk/mkdocs-material from `6a72238` to `62d3668` in /docs ([#3756](https://github.com/aws-powertools/powertools-lambda-python/issues/3756))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 2 updates ([#3814](https://github.com/aws-powertools/powertools-lambda-python/issues/3814))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3784](https://github.com/aws-powertools/powertools-lambda-python/issues/3784))
+* **deps-dev:** bump pytest from 8.0.0 to 8.0.1 ([#3812](https://github.com/aws-powertools/powertools-lambda-python/issues/3812))
+* **deps-dev:** bump aws-cdk from 2.127.0 to 2.128.0 ([#3776](https://github.com/aws-powertools/powertools-lambda-python/issues/3776))
+* **deps-dev:** bump the boto-typing group with 2 updates ([#3797](https://github.com/aws-powertools/powertools-lambda-python/issues/3797))
+* **deps-dev:** bump cfn-lint from 0.85.1 to 0.85.2 ([#3786](https://github.com/aws-powertools/powertools-lambda-python/issues/3786))
+* **deps-dev:** bump pytest-asyncio from 0.21.1 to 0.23.5 ([#3773](https://github.com/aws-powertools/powertools-lambda-python/issues/3773))
+* **deps-dev:** bump aws-cdk-lib from 2.127.0 to 2.128.0 ([#3777](https://github.com/aws-powertools/powertools-lambda-python/issues/3777))
+* **deps-dev:** bump sentry-sdk from 1.40.3 to 1.40.4 ([#3765](https://github.com/aws-powertools/powertools-lambda-python/issues/3765))
+* **deps-dev:** bump sentry-sdk from 1.40.4 to 1.40.5 ([#3805](https://github.com/aws-powertools/powertools-lambda-python/issues/3805))
+* **deps-dev:** bump mkdocs-material from 9.5.9 to 9.5.10 ([#3803](https://github.com/aws-powertools/powertools-lambda-python/issues/3803))
+* **deps-dev:** bump types-redis from 4.6.0.20240106 to 4.6.0.20240218 ([#3804](https://github.com/aws-powertools/powertools-lambda-python/issues/3804))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3757](https://github.com/aws-powertools/powertools-lambda-python/issues/3757))
+* **deps-dev:** bump aws-cdk-lib from 2.126.0 to 2.127.0 ([#3758](https://github.com/aws-powertools/powertools-lambda-python/issues/3758))
+* **deps-dev:** bump aws-cdk from 2.126.0 to 2.127.0 ([#3761](https://github.com/aws-powertools/powertools-lambda-python/issues/3761))
+* **deps-dev:** bump mkdocs-material from 9.5.8 to 9.5.9 ([#3759](https://github.com/aws-powertools/powertools-lambda-python/issues/3759))
+* **deps-dev:** bump sentry-sdk from 1.40.2 to 1.40.3 ([#3750](https://github.com/aws-powertools/powertools-lambda-python/issues/3750))
+* **deps-dev:** bump cfn-lint from 0.85.0 to 0.85.1 ([#3749](https://github.com/aws-powertools/powertools-lambda-python/issues/3749))
+* **deps-dev:** bump coverage from 7.4.1 to 7.4.2 ([#3811](https://github.com/aws-powertools/powertools-lambda-python/issues/3811))
+* **tests:** increase idempotency coverage with nested payload tampering tests ([#3809](https://github.com/aws-powertools/powertools-lambda-python/issues/3809))
+
+
+<a name="v2.33.1"></a>
+## [v2.33.1] - 2024-02-09
+## Bug Fixes
+
+* **typing:** make Response headers covariant ([#3745](https://github.com/aws-powertools/powertools-lambda-python/issues/3745))
+
+## Documentation
+
+* Add nathan hanks post community ([#3727](https://github.com/aws-powertools/powertools-lambda-python/issues/3727))
+
+## Maintenance
+
+* version bump
+* **ci:** drop support for Python 3.7 ([#3638](https://github.com/aws-powertools/powertools-lambda-python/issues/3638))
+* **ci:** enable Redis e2e tests ([#3718](https://github.com/aws-powertools/powertools-lambda-python/issues/3718))
+* **deps:** bump actions/setup-node from 4.0.1 to 4.0.2 ([#3737](https://github.com/aws-powertools/powertools-lambda-python/issues/3737))
+* **deps:** bump squidfunk/mkdocs-material from `e0d6c67` to `6a72238` in /docs ([#3735](https://github.com/aws-powertools/powertools-lambda-python/issues/3735))
+* **deps:** bump actions/dependency-review-action from 3.1.5 to 4.0.0 ([#3646](https://github.com/aws-powertools/powertools-lambda-python/issues/3646))
+* **deps:** bump release-drafter/release-drafter from 5.25.0 to 6.0.0 ([#3699](https://github.com/aws-powertools/powertools-lambda-python/issues/3699))
+* **deps:** bump actions/download-artifact from 4.1.1 to 4.1.2 ([#3725](https://github.com/aws-powertools/powertools-lambda-python/issues/3725))
+* **deps:** bump squidfunk/mkdocs-material from `a4a2029` to `e0d6c67` in /docs ([#3708](https://github.com/aws-powertools/powertools-lambda-python/issues/3708))
+* **deps:** bump codecov/codecov-action from 3.1.6 to 4.0.1 ([#3700](https://github.com/aws-powertools/powertools-lambda-python/issues/3700))
+* **deps:** bump actions/download-artifact from 3.0.2 to 4.1.1 ([#3612](https://github.com/aws-powertools/powertools-lambda-python/issues/3612))
+* **deps:** revert aws-cdk-lib as a runtime dep ([#3730](https://github.com/aws-powertools/powertools-lambda-python/issues/3730))
+* **deps:** bump actions/upload-artifact from 3.1.3 to 4.3.1 ([#3714](https://github.com/aws-powertools/powertools-lambda-python/issues/3714))
+* **deps-dev:** bump cfn-lint from 0.83.8 to 0.85.0 ([#3724](https://github.com/aws-powertools/powertools-lambda-python/issues/3724))
+* **deps-dev:** bump httpx from 0.24.1 to 0.26.0 ([#3712](https://github.com/aws-powertools/powertools-lambda-python/issues/3712))
+* **deps-dev:** bump pytest from 7.4.4 to 8.0.0 ([#3711](https://github.com/aws-powertools/powertools-lambda-python/issues/3711))
+* **deps-dev:** bump sentry-sdk from 1.40.1 to 1.40.2 ([#3740](https://github.com/aws-powertools/powertools-lambda-python/issues/3740))
+* **deps-dev:** bump coverage from 7.2.7 to 7.4.1 ([#3713](https://github.com/aws-powertools/powertools-lambda-python/issues/3713))
+* **deps-dev:** bump the boto-typing group with 7 updates ([#3709](https://github.com/aws-powertools/powertools-lambda-python/issues/3709))
+* **deps-dev:** bump types-python-dateutil from 2.8.19.14 to 2.8.19.20240106 ([#3720](https://github.com/aws-powertools/powertools-lambda-python/issues/3720))
+* **deps-dev:** bump mypy from 1.4.1 to 1.8.0 ([#3710](https://github.com/aws-powertools/powertools-lambda-python/issues/3710))
+* **deps-dev:** bump ruff from 0.2.0 to 0.2.1 ([#3742](https://github.com/aws-powertools/powertools-lambda-python/issues/3742))
+* **deps-dev:** bump isort from 5.11.5 to 5.13.2 ([#3723](https://github.com/aws-powertools/powertools-lambda-python/issues/3723))
+* **deps-dev:** bump pytest-socket from 0.6.0 to 0.7.0 ([#3721](https://github.com/aws-powertools/powertools-lambda-python/issues/3721))
+* **deps-dev:** bump ruff from 0.1.15 to 0.2.0 ([#3702](https://github.com/aws-powertools/powertools-lambda-python/issues/3702))
+* **deps-dev:** bump aws-cdk from 2.125.0 to 2.126.0 ([#3701](https://github.com/aws-powertools/powertools-lambda-python/issues/3701))
+* **deps-dev:** bump hvac from 1.2.1 to 2.1.0 ([#3738](https://github.com/aws-powertools/powertools-lambda-python/issues/3738))
+* **deps-dev:** bump black from 23.12.1 to 24.1.1 ([#3739](https://github.com/aws-powertools/powertools-lambda-python/issues/3739))
+
+
+<a name="v2.33.0"></a>
+## [v2.33.0] - 2024-02-02
+## Bug Fixes
+
+* **data-masking:** fix and improve e2e tests for DataMasking ([#3695](https://github.com/aws-powertools/powertools-lambda-python/issues/3695))
+* **event-handler:** strip whitespace from Content-Type headers during OpenAPI schema validation ([#3677](https://github.com/aws-powertools/powertools-lambda-python/issues/3677))
+
+## Documentation
+
+* **data-masking:** add docs for data masking utility ([#3186](https://github.com/aws-powertools/powertools-lambda-python/issues/3186))
+* **metrics:** fix empty metric warning filter ([#3660](https://github.com/aws-powertools/powertools-lambda-python/issues/3660))
+* **proccess:** add versioning and maintenance policy ([#3682](https://github.com/aws-powertools/powertools-lambda-python/issues/3682))
+
+## Features
+
+* **event_handler:** support Header parameter validation in OpenAPI schema ([#3687](https://github.com/aws-powertools/powertools-lambda-python/issues/3687))
+* **event_handler:** add support for multiValueQueryStringParameters in OpenAPI schema ([#3667](https://github.com/aws-powertools/powertools-lambda-python/issues/3667))
+
+## Maintenance
+
+* version bump
+* **deps:** bump codecov/codecov-action from 3.1.5 to 3.1.6 ([#3683](https://github.com/aws-powertools/powertools-lambda-python/issues/3683))
+* **deps:** bump codecov/codecov-action from 3.1.4 to 3.1.5 ([#3674](https://github.com/aws-powertools/powertools-lambda-python/issues/3674))
+* **deps:** bump pydantic from 1.10.13 to 1.10.14 ([#3655](https://github.com/aws-powertools/powertools-lambda-python/issues/3655))
+* **deps:** bump squidfunk/mkdocs-material from `58eef6c` to `9aad7af` in /docs ([#3670](https://github.com/aws-powertools/powertools-lambda-python/issues/3670))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3665](https://github.com/aws-powertools/powertools-lambda-python/issues/3665))
+* **deps:** bump squidfunk/mkdocs-material from `9aad7af` to `a4a2029` in /docs ([#3679](https://github.com/aws-powertools/powertools-lambda-python/issues/3679))
+* **deps-dev:** bump sentry-sdk from 1.39.2 to 1.40.0 ([#3684](https://github.com/aws-powertools/powertools-lambda-python/issues/3684))
+* **deps-dev:** bump ruff from 0.1.14 to 0.1.15 ([#3685](https://github.com/aws-powertools/powertools-lambda-python/issues/3685))
+* **deps-dev:** bump ruff from 0.1.13 to 0.1.14 ([#3656](https://github.com/aws-powertools/powertools-lambda-python/issues/3656))
+* **deps-dev:** bump aws-cdk from 2.122.0 to 2.123.0 ([#3673](https://github.com/aws-powertools/powertools-lambda-python/issues/3673))
+* **deps-dev:** bump aws-cdk from 2.124.0 to 2.125.0 ([#3693](https://github.com/aws-powertools/powertools-lambda-python/issues/3693))
+* **deps-dev:** bump aws-cdk from 2.123.0 to 2.124.0 ([#3678](https://github.com/aws-powertools/powertools-lambda-python/issues/3678))
+
+
+<a name="v2.32.0"></a>
+## [v2.32.0] - 2024-01-19
+## Bug Fixes
+
+* **event_handler:** escape OpenAPI schema on Swagger UI ([#3606](https://github.com/aws-powertools/powertools-lambda-python/issues/3606))
+
+## Code Refactoring
+
+* **event-handler:** Inject CSS and JS files into SwaggerUI route when no custom CDN is used. ([#3562](https://github.com/aws-powertools/powertools-lambda-python/issues/3562))
+* **event_handler:** fix BedrockAgentResolver docstring ([#3645](https://github.com/aws-powertools/powertools-lambda-python/issues/3645))
+
+## Documentation
+
+* **homepage:** add banner about Python 3.7 deprecation ([#3618](https://github.com/aws-powertools/powertools-lambda-python/issues/3618))
+* **i-made-this:** added new article on how to create a serverless API with CDK and Powertools ([#3605](https://github.com/aws-powertools/powertools-lambda-python/issues/3605))
+
+## Features
+
+* **event_handler:** add support for additional response models ([#3591](https://github.com/aws-powertools/powertools-lambda-python/issues/3591))
+* **event_handler:** add support to download OpenAPI spec file ([#3571](https://github.com/aws-powertools/powertools-lambda-python/issues/3571))
+* **event_source:** Add support for S3 batch operations ([#3572](https://github.com/aws-powertools/powertools-lambda-python/issues/3572))
+* **event_source:** Add support for policyLevel field in CloudWatch Logs event and parser ([#3624](https://github.com/aws-powertools/powertools-lambda-python/issues/3624))
+* **idempotency:** leverage new DynamoDB Failed conditional writes behavior with ReturnValuesOnConditionCheckFailure ([#3446](https://github.com/aws-powertools/powertools-lambda-python/issues/3446))
+* **idempotency:** adding redis as idempotency backend ([#2567](https://github.com/aws-powertools/powertools-lambda-python/issues/2567))
+
+## Maintenance
+
+* version bump
+* **ci:** Disable Redis e2e until we drop Python 3.7 ([#3652](https://github.com/aws-powertools/powertools-lambda-python/issues/3652))
+* **ci:** update boto3 library version to 1.26.164+ ([#3632](https://github.com/aws-powertools/powertools-lambda-python/issues/3632))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3649](https://github.com/aws-powertools/powertools-lambda-python/issues/3649))
+* **deps:** bump jinja2 from 3.1.2 to 3.1.3 in /docs ([#3620](https://github.com/aws-powertools/powertools-lambda-python/issues/3620))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3639](https://github.com/aws-powertools/powertools-lambda-python/issues/3639))
+* **deps:** bump gitpython from 3.1.37 to 3.1.41 in /docs ([#3610](https://github.com/aws-powertools/powertools-lambda-python/issues/3610))
+* **deps:** bump squidfunk/mkdocs-material from `2f29d71` to `58eef6c` in /docs ([#3633](https://github.com/aws-powertools/powertools-lambda-python/issues/3633))
+* **deps:** bump redis from 4.6.0 to 5.0.1 ([#3613](https://github.com/aws-powertools/powertools-lambda-python/issues/3613))
+* **deps-dev:** bump gitpython from 3.1.40 to 3.1.41 ([#3611](https://github.com/aws-powertools/powertools-lambda-python/issues/3611))
+* **deps-dev:** bump sentry-sdk from 1.39.1 to 1.39.2 ([#3614](https://github.com/aws-powertools/powertools-lambda-python/issues/3614))
+* **deps-dev:** bump aws-cdk from 2.120.0 to 2.121.1 ([#3634](https://github.com/aws-powertools/powertools-lambda-python/issues/3634))
+* **deps-dev:** bump jinja2 from 3.1.2 to 3.1.3 ([#3619](https://github.com/aws-powertools/powertools-lambda-python/issues/3619))
+* **deps-dev:** bump cfn-lint from 0.83.7 to 0.83.8 ([#3603](https://github.com/aws-powertools/powertools-lambda-python/issues/3603))
+* **deps-dev:** bump aws-cdk from 2.121.1 to 2.122.0 ([#3648](https://github.com/aws-powertools/powertools-lambda-python/issues/3648))
+* **deps-dev:** bump ruff from 0.1.11 to 0.1.13 ([#3625](https://github.com/aws-powertools/powertools-lambda-python/issues/3625))
+* **deps-dev:** bump aws-cdk from 2.118.0 to 2.120.0 ([#3627](https://github.com/aws-powertools/powertools-lambda-python/issues/3627))
+
+
+<a name="v2.31.0"></a>
+## [v2.31.0] - 2024-01-05
+## Bug Fixes
+
+* **ci:** fail dispatch analytics job when Lambda call fails ([#3579](https://github.com/aws-powertools/powertools-lambda-python/issues/3579))
+
+## Code Refactoring
+
+* **parameters:** add overload signatures for get_parameter and get_parameters ([#3534](https://github.com/aws-powertools/powertools-lambda-python/issues/3534))
+* **parser:** Improve error message when parsing models and envelopes ([#3587](https://github.com/aws-powertools/powertools-lambda-python/issues/3587))
+
+## Documentation
+
+* **middleware-factory:** Fix and improve typing ([#3569](https://github.com/aws-powertools/powertools-lambda-python/issues/3569))
+
+## Features
+
+* **event-handler:** add description to request body in OpenAPI schema ([#3548](https://github.com/aws-powertools/powertools-lambda-python/issues/3548))
+* **event_handler:** support richer top level Tags ([#3543](https://github.com/aws-powertools/powertools-lambda-python/issues/3543))
+* **layers:** add new comercial region Canada - ca-west-1 ([#3549](https://github.com/aws-powertools/powertools-lambda-python/issues/3549))
+
+## Maintenance
+
+* version bump
+* **ci:** Remove dev dependencies locked to Pydantic v1 within the Pydantic v2 workflow. ([#3582](https://github.com/aws-powertools/powertools-lambda-python/issues/3582))
+* **deps:** bump squidfunk/mkdocs-material from `9af3b7e` to `2f29d71` in /docs ([#3559](https://github.com/aws-powertools/powertools-lambda-python/issues/3559))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 4 updates ([#3593](https://github.com/aws-powertools/powertools-lambda-python/issues/3593))
+* **deps:** bump actions/setup-node from 4.0.0 to 4.0.1 ([#3535](https://github.com/aws-powertools/powertools-lambda-python/issues/3535))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.2 to 3.0.3 ([#3536](https://github.com/aws-powertools/powertools-lambda-python/issues/3536))
+* **deps:** bump actions/dependency-review-action from 3.1.4 to 3.1.5 ([#3592](https://github.com/aws-powertools/powertools-lambda-python/issues/3592))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 2 updates ([#3544](https://github.com/aws-powertools/powertools-lambda-python/issues/3544))
+* **deps:** bump fastjsonschema from 2.19.0 to 2.19.1 ([#3567](https://github.com/aws-powertools/powertools-lambda-python/issues/3567))
+* **deps-dev:** bump ruff from 0.1.8 to 0.1.9 ([#3550](https://github.com/aws-powertools/powertools-lambda-python/issues/3550))
+* **deps-dev:** bump aws-cdk from 2.115.0 to 2.116.1 ([#3553](https://github.com/aws-powertools/powertools-lambda-python/issues/3553))
+* **deps-dev:** bump aws-cdk from 2.117.0 to 2.118.0 ([#3589](https://github.com/aws-powertools/powertools-lambda-python/issues/3589))
+* **deps-dev:** bump cfn-lint from 0.83.6 to 0.83.7 ([#3554](https://github.com/aws-powertools/powertools-lambda-python/issues/3554))
+* **deps-dev:** bump ruff from 0.1.9 to 0.1.10 ([#3583](https://github.com/aws-powertools/powertools-lambda-python/issues/3583))
+* **deps-dev:** bump pytest from 7.4.3 to 7.4.4 ([#3576](https://github.com/aws-powertools/powertools-lambda-python/issues/3576))
+* **deps-dev:** bump aws-cdk from 2.116.1 to 2.117.0 ([#3565](https://github.com/aws-powertools/powertools-lambda-python/issues/3565))
+* **deps-dev:** bump ruff from 0.1.10 to 0.1.11 ([#3588](https://github.com/aws-powertools/powertools-lambda-python/issues/3588))
+
+
+<a name="v2.30.2"></a>
+## [v2.30.2] - 2023-12-18
+## Bug Fixes
+
+* **event-handler:** fix operation tags schema generation ([#3528](https://github.com/aws-powertools/powertools-lambda-python/issues/3528))
+* **event-handler:** set default OpenAPI version to 3.0.0 ([#3527](https://github.com/aws-powertools/powertools-lambda-python/issues/3527))
+* **event-handler:** upgrade Swagger UI to fix regressions ([#3526](https://github.com/aws-powertools/powertools-lambda-python/issues/3526))
+
+## Maintenance
+
+* version bump
+* **deps-dev:** bump cfn-lint from 0.83.5 to 0.83.6 ([#3521](https://github.com/aws-powertools/powertools-lambda-python/issues/3521))
+
+
+<a name="v2.30.1"></a>
+## [v2.30.1] - 2023-12-15
+## Bug Fixes
+
+* **event_handler:** allow responses and metadata when using Router ([#3514](https://github.com/aws-powertools/powertools-lambda-python/issues/3514))
+
+## Maintenance
+
+* version bump
+* **deps-dev:** bump aws-cdk from 2.114.1 to 2.115.0 ([#3508](https://github.com/aws-powertools/powertools-lambda-python/issues/3508))
+* **deps-dev:** bump the boto-typing group with 11 updates ([#3509](https://github.com/aws-powertools/powertools-lambda-python/issues/3509))
+* **deps-dev:** bump sentry-sdk from 1.39.0 to 1.39.1 ([#3512](https://github.com/aws-powertools/powertools-lambda-python/issues/3512))
+
+
+<a name="v2.30.0"></a>
+## [v2.30.0] - 2023-12-14
+## Bug Fixes
+
+* **docs:** make the Lambda Layer version consistent ([#3498](https://github.com/aws-powertools/powertools-lambda-python/issues/3498))
+
+## Documentation
+
+* **customer-reference:** add Transformity as a customer reference ([#3497](https://github.com/aws-powertools/powertools-lambda-python/issues/3497))
+
+## Features
+
+* **general:** add support for Python 3.12 ([#3304](https://github.com/aws-powertools/powertools-lambda-python/issues/3304))
+
+## Maintenance
+
+* version bump
+* **deps:** bump squidfunk/mkdocs-material from `876b39c` to `9af3b7e` in /docs ([#3486](https://github.com/aws-powertools/powertools-lambda-python/issues/3486))
+* **deps-dev:** bump sentry-sdk from 1.38.0 to 1.39.0 ([#3495](https://github.com/aws-powertools/powertools-lambda-python/issues/3495))
+* **deps-dev:** bump cfn-lint from 0.83.4 to 0.83.5 ([#3487](https://github.com/aws-powertools/powertools-lambda-python/issues/3487))
+* **deps-dev:** bump ruff from 0.1.7 to 0.1.8 ([#3501](https://github.com/aws-powertools/powertools-lambda-python/issues/3501))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3500](https://github.com/aws-powertools/powertools-lambda-python/issues/3500))
+* **tests:** temporarily disable E2E parallelism ([#3484](https://github.com/aws-powertools/powertools-lambda-python/issues/3484))
+
+
+<a name="v2.29.1"></a>
+## [v2.29.1] - 2023-12-11
+## Bug Fixes
+
+* **logger:** log non-ascii characters as is when JSON stringifying ([#3475](https://github.com/aws-powertools/powertools-lambda-python/issues/3475))
+
+## Maintenance
+
+* version bump
+* **deps:** bump squidfunk/mkdocs-material from `8c72011` to `20241c6` in /docs ([#3470](https://github.com/aws-powertools/powertools-lambda-python/issues/3470))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 2 updates ([#3476](https://github.com/aws-powertools/powertools-lambda-python/issues/3476))
+* **deps:** bump actions/setup-python from 4.8.0 to 5.0.0 ([#3465](https://github.com/aws-powertools/powertools-lambda-python/issues/3465))
+* **deps:** bump squidfunk/mkdocs-material from `20241c6` to `876b39c` in /docs ([#3477](https://github.com/aws-powertools/powertools-lambda-python/issues/3477))
+* **deps:** bump datadog-lambda from 5.84.0 to 5.85.0 ([#3466](https://github.com/aws-powertools/powertools-lambda-python/issues/3466))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 2 updates ([#3467](https://github.com/aws-powertools/powertools-lambda-python/issues/3467))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#3469](https://github.com/aws-powertools/powertools-lambda-python/issues/3469))
+* **deps-dev:** bump aws-cdk from 2.113.0 to 2.114.1 ([#3464](https://github.com/aws-powertools/powertools-lambda-python/issues/3464))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3478](https://github.com/aws-powertools/powertools-lambda-python/issues/3478))
+
+
+<a name="v2.29.0"></a>
+## [v2.29.0] - 2023-12-06
+## Bug Fixes
+
+* **event_handler:** serialize pydantic/dataclasses in exception handler ([#3455](https://github.com/aws-powertools/powertools-lambda-python/issues/3455))
+* **metrics:** lambda_handler typing, and **kwargs preservation all middlewares ([#3460](https://github.com/aws-powertools/powertools-lambda-python/issues/3460))
+
+## Features
+
+* **event_sources:** add get_context() to standardize API Gateway Lambda Authorizer context in v1 and v2 ([#3454](https://github.com/aws-powertools/powertools-lambda-python/issues/3454))
+
+## Maintenance
+
+* version bump
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#3441](https://github.com/aws-powertools/powertools-lambda-python/issues/3441))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.1 to 3.0.2 ([#3449](https://github.com/aws-powertools/powertools-lambda-python/issues/3449))
+* **deps:** bump datadog-lambda from 5.83.0 to 5.84.0 ([#3438](https://github.com/aws-powertools/powertools-lambda-python/issues/3438))
+* **deps:** bump cryptography from 41.0.4 to 41.0.6 ([#3431](https://github.com/aws-powertools/powertools-lambda-python/issues/3431))
+* **deps:** bump squidfunk/mkdocs-material from `fc42bac` to `8c72011` in /docs ([#3416](https://github.com/aws-powertools/powertools-lambda-python/issues/3416))
+* **deps:** bump actions/dependency-review-action from 3.1.3 to 3.1.4 ([#3426](https://github.com/aws-powertools/powertools-lambda-python/issues/3426))
+* **deps:** bump actions/setup-python from 4.7.1 to 4.8.0 ([#3456](https://github.com/aws-powertools/powertools-lambda-python/issues/3456))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.8.10 to 1.8.11 ([#3433](https://github.com/aws-powertools/powertools-lambda-python/issues/3433))
+* **deps-dev:** bump cfn-lint from 0.83.3 to 0.83.4 ([#3450](https://github.com/aws-powertools/powertools-lambda-python/issues/3450))
+* **deps-dev:** bump ruff from 0.1.6 to 0.1.7 ([#3458](https://github.com/aws-powertools/powertools-lambda-python/issues/3458))
+* **deps-dev:** bump sentry-sdk from 1.36.0 to 1.38.0 ([#3435](https://github.com/aws-powertools/powertools-lambda-python/issues/3435))
+* **deps-dev:** bump aws-cdk-lib from 2.110.1 to 2.111.0 ([#3428](https://github.com/aws-powertools/powertools-lambda-python/issues/3428))
+* **deps-dev:** bump aws-cdk from 2.112.0 to 2.113.0 ([#3448](https://github.com/aws-powertools/powertools-lambda-python/issues/3448))
+* **deps-dev:** bump aws-cdk from 2.110.1 to 2.111.0 ([#3418](https://github.com/aws-powertools/powertools-lambda-python/issues/3418))
+* **deps-dev:** bump the boto-typing group with 11 updates ([#3427](https://github.com/aws-powertools/powertools-lambda-python/issues/3427))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3457](https://github.com/aws-powertools/powertools-lambda-python/issues/3457))
+* **deps-dev:** bump aws-cdk from 2.111.0 to 2.112.0 ([#3440](https://github.com/aws-powertools/powertools-lambda-python/issues/3440))
+* **layers:** Update log retention to 10 years ([#3424](https://github.com/aws-powertools/powertools-lambda-python/issues/3424))
+
+
+<a name="v2.28.1"></a>
+## [v2.28.1] - 2023-11-28
+## Bug Fixes
+
+* **event_handler:** fix compress handling ([#3420](https://github.com/aws-powertools/powertools-lambda-python/issues/3420))
+
+## Maintenance
+
+* version bump
+
+
+<a name="v2.28.0"></a>
+## [v2.28.0] - 2023-11-23
+## Bug Fixes
+
+* **event_handler:** hide error details by default ([#3406](https://github.com/aws-powertools/powertools-lambda-python/issues/3406))
+* **event_handler:** fix format for OpenAPI path templating ([#3399](https://github.com/aws-powertools/powertools-lambda-python/issues/3399))
+* **event_handler:** lazy load Pydantic to improve cold start ([#3397](https://github.com/aws-powertools/powertools-lambda-python/issues/3397))
+* **event_handler:** allow fine grained Response with data validation ([#3394](https://github.com/aws-powertools/powertools-lambda-python/issues/3394))
+* **event_handler:** apply serialization as the last operation for middlewares ([#3392](https://github.com/aws-powertools/powertools-lambda-python/issues/3392))
+
+## Documentation
+
+* **event_handlers:** new data validation and OpenAPI feature ([#3386](https://github.com/aws-powertools/powertools-lambda-python/issues/3386))
+
+## Features
+
+* **event_handler:** allow customers to catch request validation errors ([#3396](https://github.com/aws-powertools/powertools-lambda-python/issues/3396))
+
+## Maintenance
+
+* version bump
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#3389](https://github.com/aws-powertools/powertools-lambda-python/issues/3389))
+* **deps:** bump datadog-lambda from 4.82.0 to 5.83.0 ([#3401](https://github.com/aws-powertools/powertools-lambda-python/issues/3401))
+* **deps-dev:** bump aws-cdk-lib from 2.110.0 to 2.110.1 ([#3402](https://github.com/aws-powertools/powertools-lambda-python/issues/3402))
+* **deps-dev:** bump pytest-xdist from 3.4.0 to 3.5.0 ([#3387](https://github.com/aws-powertools/powertools-lambda-python/issues/3387))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3400](https://github.com/aws-powertools/powertools-lambda-python/issues/3400))
+* **deps-dev:** bump sentry-sdk from 1.35.0 to 1.36.0 ([#3388](https://github.com/aws-powertools/powertools-lambda-python/issues/3388))
+* **deps-dev:** bump aws-cdk from 2.110.0 to 2.110.1 ([#3403](https://github.com/aws-powertools/powertools-lambda-python/issues/3403))
+
+
+<a name="v2.27.1"></a>
+## [v2.27.1] - 2023-11-21
+## Bug Fixes
+
+* **logger:** allow custom JMESPath functions to extract correlation ID ([#3382](https://github.com/aws-powertools/powertools-lambda-python/issues/3382))
+
+## Documentation
+
+* **event_handlers:** note that CORS and */* binary mime type don't work in API Gateway ([#3383](https://github.com/aws-powertools/powertools-lambda-python/issues/3383))
+* **logger:** improve ALC messaging in the PT context ([#3359](https://github.com/aws-powertools/powertools-lambda-python/issues/3359))
+* **logger:** Fix ALC link ([#3352](https://github.com/aws-powertools/powertools-lambda-python/issues/3352))
+
+## Features
+
+* **logger:** implement addFilter/removeFilter to address static typing errors ([#3380](https://github.com/aws-powertools/powertools-lambda-python/issues/3380))
+
+## Maintenance
+
+* version bump
+* **ci:** lint and type checking removal in Pydantic v2 quality check ([#3360](https://github.com/aws-powertools/powertools-lambda-python/issues/3360))
+* **deps:** bump actions/github-script from 7.0.0 to 7.0.1 ([#3377](https://github.com/aws-powertools/powertools-lambda-python/issues/3377))
+* **deps:** bump squidfunk/mkdocs-material from `2c57e4d` to `fc42bac` in /docs ([#3375](https://github.com/aws-powertools/powertools-lambda-python/issues/3375))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 2 updates ([#3353](https://github.com/aws-powertools/powertools-lambda-python/issues/3353))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3374](https://github.com/aws-powertools/powertools-lambda-python/issues/3374))
+* **deps:** bump squidfunk/mkdocs-material from `f486dc9` to `2c57e4d` in /docs ([#3366](https://github.com/aws-powertools/powertools-lambda-python/issues/3366))
+* **deps-dev:** bump cfn-lint from 0.83.2 to 0.83.3 ([#3363](https://github.com/aws-powertools/powertools-lambda-python/issues/3363))
+* **deps-dev:** bump the boto-typing group with 11 updates ([#3362](https://github.com/aws-powertools/powertools-lambda-python/issues/3362))
+* **deps-dev:** bump aws-cdk-lib from 2.108.1 to 2.110.0 ([#3365](https://github.com/aws-powertools/powertools-lambda-python/issues/3365))
+* **deps-dev:** bump aws-cdk from 2.108.1 to 2.109.0 ([#3354](https://github.com/aws-powertools/powertools-lambda-python/issues/3354))
+* **deps-dev:** bump aws-cdk from 2.109.0 to 2.110.0 ([#3361](https://github.com/aws-powertools/powertools-lambda-python/issues/3361))
+* **deps-dev:** bump the boto-typing group with 2 updates ([#3376](https://github.com/aws-powertools/powertools-lambda-python/issues/3376))
+* **deps-dev:** bump ruff from 0.1.5 to 0.1.6 ([#3364](https://github.com/aws-powertools/powertools-lambda-python/issues/3364))
+
+
+<a name="v2.27.0"></a>
+## [v2.27.0] - 2023-11-16
+## Features
+
+* **logger:** Adding support to new env variables ([#3348](https://github.com/aws-powertools/powertools-lambda-python/issues/3348))
+
+## Maintenance
+
+* version bump
+* **deps:** bump actions/github-script from 6.4.1 to 7.0.0 ([#3330](https://github.com/aws-powertools/powertools-lambda-python/issues/3330))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 2 updates ([#3340](https://github.com/aws-powertools/powertools-lambda-python/issues/3340))
+* **deps:** bump fastjsonschema from 2.18.1 to 2.19.0 ([#3337](https://github.com/aws-powertools/powertools-lambda-python/issues/3337))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#3345](https://github.com/aws-powertools/powertools-lambda-python/issues/3345))
+* **deps:** bump actions/dependency-review-action from 3.1.2 to 3.1.3 ([#3331](https://github.com/aws-powertools/powertools-lambda-python/issues/3331))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3329](https://github.com/aws-powertools/powertools-lambda-python/issues/3329))
+* **deps:** bump datadog-lambda from 4.81.0 to 4.82.0 ([#3338](https://github.com/aws-powertools/powertools-lambda-python/issues/3338))
+* **deps-dev:** bump cfn-lint from 0.83.1 to 0.83.2 ([#3335](https://github.com/aws-powertools/powertools-lambda-python/issues/3335))
+* **deps-dev:** bump aws-cdk from 2.108.0 to 2.108.1 ([#3344](https://github.com/aws-powertools/powertools-lambda-python/issues/3344))
+* **deps-dev:** bump sentry-sdk from 1.34.0 to 1.35.0 ([#3334](https://github.com/aws-powertools/powertools-lambda-python/issues/3334))
+* **deps-dev:** bump pytest-xdist from 3.3.1 to 3.4.0 ([#3332](https://github.com/aws-powertools/powertools-lambda-python/issues/3332))
+* **deps-dev:** bump aws-cdk-lib from 2.107.0 to 2.108.1 ([#3343](https://github.com/aws-powertools/powertools-lambda-python/issues/3343))
+* **deps-dev:** bump aws-cdk from 2.106.0 to 2.106.1 ([#3328](https://github.com/aws-powertools/powertools-lambda-python/issues/3328))
+* **deps-dev:** bump aws-cdk-lib from 2.105.0 to 2.106.0 ([#3319](https://github.com/aws-powertools/powertools-lambda-python/issues/3319))
+* **deps-dev:** bump aws-cdk from 2.105.0 to 2.106.0 ([#3320](https://github.com/aws-powertools/powertools-lambda-python/issues/3320))
+* **deps-dev:** bump aws-cdk from 2.106.1 to 2.108.0 ([#3341](https://github.com/aws-powertools/powertools-lambda-python/issues/3341))
+* **deps-dev:** bump aws-cdk-lib from 2.106.0 to 2.107.0 ([#3333](https://github.com/aws-powertools/powertools-lambda-python/issues/3333))
+
+
+<a name="v2.26.1"></a>
+## [v2.26.1] - 2023-11-10
+## Bug Fixes
+
+* **event-handler:** enable path parameters on Bedrock handler ([#3312](https://github.com/aws-powertools/powertools-lambda-python/issues/3312))
+* **event_handler:** Router prefix mismatch regression after Middleware feat ([#3302](https://github.com/aws-powertools/powertools-lambda-python/issues/3302))
+* **event_source:** kinesis subsequenceNumber str type to int ([#3275](https://github.com/aws-powertools/powertools-lambda-python/issues/3275))
+* **parameters:** Respect POWERTOOLS_PARAMETERS_SSM_DECRYPT environment variable when getting multiple ssm parameters. ([#3241](https://github.com/aws-powertools/powertools-lambda-python/issues/3241))
+
+## Documentation
+
+* **customer-reference:** add Vertex Pharmaceuticals as a customer reference ([#3210](https://github.com/aws-powertools/powertools-lambda-python/issues/3210))
+* **event-handler:** fixed SchemaValidationMiddleware link ([#3247](https://github.com/aws-powertools/powertools-lambda-python/issues/3247))
+
+## Features
+
+* **data_classes:** add support for Bedrock Agents event ([#3262](https://github.com/aws-powertools/powertools-lambda-python/issues/3262))
+* **event_handler:** add Bedrock Agent event handler ([#3285](https://github.com/aws-powertools/powertools-lambda-python/issues/3285))
+* **event_handler:** add ability to expose a Swagger UI ([#3254](https://github.com/aws-powertools/powertools-lambda-python/issues/3254))
+* **event_handler:** generate OpenAPI specifications and validate input/output ([#3109](https://github.com/aws-powertools/powertools-lambda-python/issues/3109))
+* **parser:** add BedrockEventModel parser and envelope ([#3286](https://github.com/aws-powertools/powertools-lambda-python/issues/3286))
+
+## Maintenance
+
+* version bump
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 2.1.5 to 3.0.0 ([#3289](https://github.com/aws-powertools/powertools-lambda-python/issues/3289))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3287](https://github.com/aws-powertools/powertools-lambda-python/issues/3287))
+* **deps:** bump actions/checkout from 4.1.0 to 4.1.1 ([#3220](https://github.com/aws-powertools/powertools-lambda-python/issues/3220))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#3282](https://github.com/aws-powertools/powertools-lambda-python/issues/3282))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 2.1.4 to 2.1.5 ([#3281](https://github.com/aws-powertools/powertools-lambda-python/issues/3281))
+* **deps:** bump release-drafter/release-drafter from 5.24.0 to 5.25.0 ([#3219](https://github.com/aws-powertools/powertools-lambda-python/issues/3219))
+* **deps:** bump squidfunk/mkdocs-material from `cb38dc2` to `df9409b` in /docs ([#3216](https://github.com/aws-powertools/powertools-lambda-python/issues/3216))
+* **deps:** bump urllib3 from 1.26.17 to 1.26.18 ([#3222](https://github.com/aws-powertools/powertools-lambda-python/issues/3222))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 2 updates ([#3298](https://github.com/aws-powertools/powertools-lambda-python/issues/3298))
+* **deps:** bump squidfunk/mkdocs-material from `772e14e` to `f486dc9` in /docs ([#3299](https://github.com/aws-powertools/powertools-lambda-python/issues/3299))
+* **deps:** bump datadog-lambda from 4.80.0 to 4.81.0 ([#3228](https://github.com/aws-powertools/powertools-lambda-python/issues/3228))
+* **deps:** bump actions/setup-node from 3.8.1 to 4.0.0 ([#3244](https://github.com/aws-powertools/powertools-lambda-python/issues/3244))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.0 to 3.0.1 ([#3300](https://github.com/aws-powertools/powertools-lambda-python/issues/3300))
+* **deps:** bump actions/dependency-review-action from 3.1.0 to 3.1.1 ([#3301](https://github.com/aws-powertools/powertools-lambda-python/issues/3301))
+* **deps:** bump squidfunk/mkdocs-material from `df9409b` to `772e14e` in /docs ([#3265](https://github.com/aws-powertools/powertools-lambda-python/issues/3265))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3305](https://github.com/aws-powertools/powertools-lambda-python/issues/3305))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 2 updates ([#3248](https://github.com/aws-powertools/powertools-lambda-python/issues/3248))
+* **deps:** bump actions/dependency-review-action from 3.1.1 to 3.1.2 ([#3308](https://github.com/aws-powertools/powertools-lambda-python/issues/3308))
+* **deps:** bump ossf/scorecard-action from 2.3.0 to 2.3.1 ([#3245](https://github.com/aws-powertools/powertools-lambda-python/issues/3245))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3310](https://github.com/aws-powertools/powertools-lambda-python/issues/3310))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3215](https://github.com/aws-powertools/powertools-lambda-python/issues/3215))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#3313](https://github.com/aws-powertools/powertools-lambda-python/issues/3313))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#3278](https://github.com/aws-powertools/powertools-lambda-python/issues/3278))
+* **deps-dev:** bump pytest from 7.4.2 to 7.4.3 ([#3249](https://github.com/aws-powertools/powertools-lambda-python/issues/3249))
+* **deps-dev:** bump ruff from 0.1.1 to 0.1.2 ([#3250](https://github.com/aws-powertools/powertools-lambda-python/issues/3250))
+* **deps-dev:** bump the boto-typing group with 2 updates ([#3242](https://github.com/aws-powertools/powertools-lambda-python/issues/3242))
+* **deps-dev:** bump aws-cdk-lib from 2.102.0 to 2.103.0 ([#3258](https://github.com/aws-powertools/powertools-lambda-python/issues/3258))
+* **deps-dev:** bump cfn-lint from 0.82.2 to 0.83.0 ([#3243](https://github.com/aws-powertools/powertools-lambda-python/issues/3243))
+* **deps-dev:** bump ruff from 0.1.2 to 0.1.3 ([#3257](https://github.com/aws-powertools/powertools-lambda-python/issues/3257))
+* **deps-dev:** bump aws-cdk from 2.102.0 to 2.103.0 ([#3259](https://github.com/aws-powertools/powertools-lambda-python/issues/3259))
+* **deps-dev:** bump ruff from 0.1.0 to 0.1.1 ([#3235](https://github.com/aws-powertools/powertools-lambda-python/issues/3235))
+* **deps-dev:** bump aws-cdk-lib from 2.103.0 to 2.103.1 ([#3263](https://github.com/aws-powertools/powertools-lambda-python/issues/3263))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3231](https://github.com/aws-powertools/powertools-lambda-python/issues/3231))
+* **deps-dev:** bump aws-cdk from 2.101.1 to 2.102.0 ([#3232](https://github.com/aws-powertools/powertools-lambda-python/issues/3232))
+* **deps-dev:** bump aws-cdk from 2.103.0 to 2.103.1 ([#3264](https://github.com/aws-powertools/powertools-lambda-python/issues/3264))
+* **deps-dev:** bump cfn-lint from 0.82.0 to 0.82.2 ([#3229](https://github.com/aws-powertools/powertools-lambda-python/issues/3229))
+* **deps-dev:** bump cfn-lint from 0.83.0 to 0.83.1 ([#3274](https://github.com/aws-powertools/powertools-lambda-python/issues/3274))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3273](https://github.com/aws-powertools/powertools-lambda-python/issues/3273))
+* **deps-dev:** bump cfn-lint from 0.81.0 to 0.82.0 ([#3224](https://github.com/aws-powertools/powertools-lambda-python/issues/3224))
+* **deps-dev:** bump aws-cdk from 2.101.0 to 2.101.1 ([#3223](https://github.com/aws-powertools/powertools-lambda-python/issues/3223))
+* **deps-dev:** bump sentry-sdk from 1.32.0 to 1.33.1 ([#3277](https://github.com/aws-powertools/powertools-lambda-python/issues/3277))
+* **deps-dev:** bump urllib3 from 1.26.17 to 1.26.18 in /layer ([#3221](https://github.com/aws-powertools/powertools-lambda-python/issues/3221))
+* **deps-dev:** bump aws-cdk from 2.103.1 to 2.104.0 ([#3288](https://github.com/aws-powertools/powertools-lambda-python/issues/3288))
+* **deps-dev:** bump sentry-sdk from 1.33.1 to 1.34.0 ([#3290](https://github.com/aws-powertools/powertools-lambda-python/issues/3290))
+* **deps-dev:** bump aws-cdk-lib from 2.103.1 to 2.104.0 ([#3291](https://github.com/aws-powertools/powertools-lambda-python/issues/3291))
+* **deps-dev:** bump aws-cdk-lib from 2.100.0 to 2.101.1 ([#3217](https://github.com/aws-powertools/powertools-lambda-python/issues/3217))
+* **deps-dev:** bump aws-cdk from 2.100.0 to 2.101.0 ([#3214](https://github.com/aws-powertools/powertools-lambda-python/issues/3214))
+* **deps-dev:** bump aws-cdk from 2.104.0 to 2.105.0 ([#3307](https://github.com/aws-powertools/powertools-lambda-python/issues/3307))
+* **deps-dev:** bump ruff from 0.1.3 to 0.1.4 ([#3297](https://github.com/aws-powertools/powertools-lambda-python/issues/3297))
+* **deps-dev:** bump aws-cdk-lib from 2.104.0 to 2.105.0 ([#3309](https://github.com/aws-powertools/powertools-lambda-python/issues/3309))
+* **deps-dev:** bump the boto-typing group with 2 updates ([#3211](https://github.com/aws-powertools/powertools-lambda-python/issues/3211))
+* **deps-dev:** bump the boto-typing group with 3 updates ([#3314](https://github.com/aws-powertools/powertools-lambda-python/issues/3314))
+* **deps-dev:** bump ruff from 0.1.4 to 0.1.5 ([#3315](https://github.com/aws-powertools/powertools-lambda-python/issues/3315))
+* **deps-dev:** bump ruff from 0.0.292 to 0.1.0 ([#3213](https://github.com/aws-powertools/powertools-lambda-python/issues/3213))
+
+
+<a name="v2.26.0"></a>
+## [v2.26.0] - 2023-10-13
+## Bug Fixes
+
+* **logger:** force Logger to use local timezone when UTC flag is not set ([#3168](https://github.com/aws-powertools/powertools-lambda-python/issues/3168))
+* **parameter:** improve AppConfig cached configuration retrieval ([#3195](https://github.com/aws-powertools/powertools-lambda-python/issues/3195))
+
+## Code Refactoring
+
+* **data-masking:** disable e2e tests. ([#3204](https://github.com/aws-powertools/powertools-lambda-python/issues/3204))
+* **data_masking:** move Data Masking utility to a private folder ([#3202](https://github.com/aws-powertools/powertools-lambda-python/issues/3202))
+
+## Documentation
+
+* **contributing:** initial structure for revamped contributing guide ([#3133](https://github.com/aws-powertools/powertools-lambda-python/issues/3133))
+* **event_handler:** add information about case-insensitive header lookup function ([#3183](https://github.com/aws-powertools/powertools-lambda-python/issues/3183))
+
+## Features
+
+* **data_masking:** add new sensitive data masking utility ([#2197](https://github.com/aws-powertools/powertools-lambda-python/issues/2197))
+* **event_handler:** add support to VPC Lattice payload v2 ([#3153](https://github.com/aws-powertools/powertools-lambda-python/issues/3153))
+* **layers:** add arm64 support in more regions ([#3151](https://github.com/aws-powertools/powertools-lambda-python/issues/3151))
+* **logger:** new stack_trace field with rich exception details ([#3147](https://github.com/aws-powertools/powertools-lambda-python/issues/3147))
+* **parser:** infer model from type hint ([#3181](https://github.com/aws-powertools/powertools-lambda-python/issues/3181))
+
+## Maintenance
+
+* version bump
+* **deps:** bump squidfunk/mkdocs-material from `cbfecae` to `a4cfa88` in /docs ([#3175](https://github.com/aws-powertools/powertools-lambda-python/issues/3175))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3174](https://github.com/aws-powertools/powertools-lambda-python/issues/3174))
+* **deps:** bump squidfunk/mkdocs-material from `b41ba6d` to `06673a1` in /docs ([#3124](https://github.com/aws-powertools/powertools-lambda-python/issues/3124))
+* **deps:** bump ossf/scorecard-action from 2.2.0 to 2.3.0 ([#3178](https://github.com/aws-powertools/powertools-lambda-python/issues/3178))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#3198](https://github.com/aws-powertools/powertools-lambda-python/issues/3198))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#3177](https://github.com/aws-powertools/powertools-lambda-python/issues/3177))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3127](https://github.com/aws-powertools/powertools-lambda-python/issues/3127))
+* **deps:** bump urllib3 from 1.26.16 to 1.26.17 ([#3162](https://github.com/aws-powertools/powertools-lambda-python/issues/3162))
+* **deps:** bump aws-xray-sdk from 2.12.0 to 2.12.1 ([#3197](https://github.com/aws-powertools/powertools-lambda-python/issues/3197))
+* **deps:** bump fastjsonschema from 2.18.0 to 2.18.1 ([#3159](https://github.com/aws-powertools/powertools-lambda-python/issues/3159))
+* **deps:** bump actions/setup-python from 4.7.0 to 4.7.1 ([#3158](https://github.com/aws-powertools/powertools-lambda-python/issues/3158))
+* **deps:** bump actions/checkout from 4.0.0 to 4.1.0 ([#3128](https://github.com/aws-powertools/powertools-lambda-python/issues/3128))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3156](https://github.com/aws-powertools/powertools-lambda-python/issues/3156))
+* **deps:** bump squidfunk/mkdocs-material from `e5f28aa` to `cbfecae` in /docs ([#3157](https://github.com/aws-powertools/powertools-lambda-python/issues/3157))
+* **deps:** bump squidfunk/mkdocs-material from `06673a1` to `e5f28aa` in /docs ([#3134](https://github.com/aws-powertools/powertools-lambda-python/issues/3134))
+* **deps:** bump squidfunk/mkdocs-material from `a4cfa88` to `cb38dc2` in /docs ([#3189](https://github.com/aws-powertools/powertools-lambda-python/issues/3189))
+* **deps:** bump pydantic from 1.10.12 to 1.10.13 ([#3144](https://github.com/aws-powertools/powertools-lambda-python/issues/3144))
+* **deps:** bump gitpython from 3.1.35 to 3.1.37 in /docs ([#3188](https://github.com/aws-powertools/powertools-lambda-python/issues/3188))
+* **deps-dev:** bump types-requests from 2.31.0.5 to 2.31.0.6 ([#3145](https://github.com/aws-powertools/powertools-lambda-python/issues/3145))
+* **deps-dev:** bump aws-cdk from 2.98.0 to 2.99.0 ([#3148](https://github.com/aws-powertools/powertools-lambda-python/issues/3148))
+* **deps-dev:** bump the boto-typing group with 2 updates ([#3143](https://github.com/aws-powertools/powertools-lambda-python/issues/3143))
+* **deps-dev:** bump aws-cdk from 2.99.1 to 2.100.0 ([#3185](https://github.com/aws-powertools/powertools-lambda-python/issues/3185))
+* **deps-dev:** bump aws-cdk from 2.97.0 to 2.98.0 ([#3139](https://github.com/aws-powertools/powertools-lambda-python/issues/3139))
+* **deps-dev:** bump aws-cdk from 2.96.2 to 2.97.0 ([#3129](https://github.com/aws-powertools/powertools-lambda-python/issues/3129))
+* **deps-dev:** bump types-requests from 2.31.0.3 to 2.31.0.5 ([#3136](https://github.com/aws-powertools/powertools-lambda-python/issues/3136))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3135](https://github.com/aws-powertools/powertools-lambda-python/issues/3135))
+* **deps-dev:** bump ruff from 0.0.291 to 0.0.292 ([#3161](https://github.com/aws-powertools/powertools-lambda-python/issues/3161))
+* **deps-dev:** bump ruff from 0.0.290 to 0.0.291 ([#3126](https://github.com/aws-powertools/powertools-lambda-python/issues/3126))
+* **deps-dev:** bump aws-cdk from 2.99.0 to 2.99.1 ([#3155](https://github.com/aws-powertools/powertools-lambda-python/issues/3155))
+* **deps-dev:** bump sentry-sdk from 1.31.0 to 1.32.0 ([#3192](https://github.com/aws-powertools/powertools-lambda-python/issues/3192))
+* **deps-dev:** bump urllib3 from 1.26.16 to 1.26.17 in /layer ([#3163](https://github.com/aws-powertools/powertools-lambda-python/issues/3163))
+* **deps-dev:** bump cfn-lint from 0.80.3 to 0.80.4 ([#3166](https://github.com/aws-powertools/powertools-lambda-python/issues/3166))
+* **deps-dev:** bump cfn-lint from 0.80.2 to 0.80.3 ([#3125](https://github.com/aws-powertools/powertools-lambda-python/issues/3125))
+* **deps-dev:** bump cfn-lint from 0.80.4 to 0.81.0 ([#3179](https://github.com/aws-powertools/powertools-lambda-python/issues/3179))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3196](https://github.com/aws-powertools/powertools-lambda-python/issues/3196))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3170](https://github.com/aws-powertools/powertools-lambda-python/issues/3170))
+
+
+<a name="v2.25.1"></a>
+## [v2.25.1] - 2023-09-22
+## Bug Fixes
+
+* **logger:** add explicit None return type annotations ([#3113](https://github.com/aws-powertools/powertools-lambda-python/issues/3113))
+* **metrics:** support additional arguments in functions wrapped with log_metrics decorator ([#3120](https://github.com/aws-powertools/powertools-lambda-python/issues/3120))
+
+## Maintenance
+
+* version bump
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3108](https://github.com/aws-powertools/powertools-lambda-python/issues/3108))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3115](https://github.com/aws-powertools/powertools-lambda-python/issues/3115))
+* **deps:** bump squidfunk/mkdocs-material from `4ff781e` to `b41ba6d` in /docs ([#3117](https://github.com/aws-powertools/powertools-lambda-python/issues/3117))
+* **deps:** bump squidfunk/mkdocs-material from `c4890ab` to `4ff781e` in /docs ([#3110](https://github.com/aws-powertools/powertools-lambda-python/issues/3110))
+* **deps-dev:** bump ruff from 0.0.289 to 0.0.290 ([#3105](https://github.com/aws-powertools/powertools-lambda-python/issues/3105))
+* **deps-dev:** bump aws-cdk from 2.96.1 to 2.96.2 ([#3102](https://github.com/aws-powertools/powertools-lambda-python/issues/3102))
+* **deps-dev:** bump the boto-typing group with 3 updates ([#3118](https://github.com/aws-powertools/powertools-lambda-python/issues/3118))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3101](https://github.com/aws-powertools/powertools-lambda-python/issues/3101))
+* **deps-dev:** bump cfn-lint from 0.79.11 to 0.80.2 ([#3107](https://github.com/aws-powertools/powertools-lambda-python/issues/3107))
+* **deps-dev:** bump types-requests from 2.31.0.2 to 2.31.0.3 ([#3114](https://github.com/aws-powertools/powertools-lambda-python/issues/3114))
+
+
+<a name="v2.25.0"></a>
+## [v2.25.0] - 2023-09-15
+## Code Refactoring
+
+* **parameters:** BaseProvider._get to also support Dict ([#3090](https://github.com/aws-powertools/powertools-lambda-python/issues/3090))
+
+## Documentation
+
+* **event_handler:** fix typing in micro function example ([#3098](https://github.com/aws-powertools/powertools-lambda-python/issues/3098))
+* **event_handler:** add micro function examples ([#3056](https://github.com/aws-powertools/powertools-lambda-python/issues/3056))
+* **we-made-this:** fix broken Twitch video embeds ([#3096](https://github.com/aws-powertools/powertools-lambda-python/issues/3096))
+
+## Features
+
+* **event_source:** add Kinesis Firehose Data Transformation data class ([#3029](https://github.com/aws-powertools/powertools-lambda-python/issues/3029))
+* **event_sources:** add Secrets Manager secret rotation event ([#3061](https://github.com/aws-powertools/powertools-lambda-python/issues/3061))
+
+## Maintenance
+
+* version bump
+* **automation:** remove previous labels when PR is updated ([#3066](https://github.com/aws-powertools/powertools-lambda-python/issues/3066))
+* **deps:** bump actions/dependency-review-action from 3.0.8 to 3.1.0 ([#3071](https://github.com/aws-powertools/powertools-lambda-python/issues/3071))
+* **deps:** bump docker/setup-qemu-action from 2.2.0 to 3.0.0 ([#3081](https://github.com/aws-powertools/powertools-lambda-python/issues/3081))
+* **deps:** bump docker/setup-buildx-action from 2.10.0 to 3.0.0 ([#3083](https://github.com/aws-powertools/powertools-lambda-python/issues/3083))
+* **deps:** bump squidfunk/mkdocs-material from `dd1770c` to `c4890ab` in /docs ([#3078](https://github.com/aws-powertools/powertools-lambda-python/issues/3078))
+* **deps-dev:** bump cfn-lint from 0.79.9 to 0.79.10 ([#3077](https://github.com/aws-powertools/powertools-lambda-python/issues/3077))
+* **deps-dev:** bump hvac from 1.2.0 to 1.2.1 ([#3075](https://github.com/aws-powertools/powertools-lambda-python/issues/3075))
+* **deps-dev:** bump ruff from 0.0.288 to 0.0.289 ([#3080](https://github.com/aws-powertools/powertools-lambda-python/issues/3080))
+* **deps-dev:** bump ruff from 0.0.287 to 0.0.288 ([#3076](https://github.com/aws-powertools/powertools-lambda-python/issues/3076))
+* **deps-dev:** bump aws-cdk from 2.95.0 to 2.95.1 ([#3074](https://github.com/aws-powertools/powertools-lambda-python/issues/3074))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3085](https://github.com/aws-powertools/powertools-lambda-python/issues/3085))
+* **deps-dev:** bump aws-cdk from 2.95.1 to 2.96.0 ([#3087](https://github.com/aws-powertools/powertools-lambda-python/issues/3087))
+* **deps-dev:** bump sentry-sdk from 1.30.0 to 1.31.0 ([#3086](https://github.com/aws-powertools/powertools-lambda-python/issues/3086))
+* **deps-dev:** bump aws-cdk from 2.94.0 to 2.95.0 ([#3070](https://github.com/aws-powertools/powertools-lambda-python/issues/3070))
+* **deps-dev:** bump cfn-lint from 0.79.10 to 0.79.11 ([#3088](https://github.com/aws-powertools/powertools-lambda-python/issues/3088))
+* **deps-dev:** bump aws-cdk from 2.96.0 to 2.96.1 ([#3093](https://github.com/aws-powertools/powertools-lambda-python/issues/3093))
+* **typing:** move backwards compat types to shared types ([#3092](https://github.com/aws-powertools/powertools-lambda-python/issues/3092))
+
+
+<a name="v2.24.0"></a>
+## [v2.24.0] - 2023-09-08
+## Bug Fixes
+
+* **event_handler:** expanding safe URI characters to include +$& ([#3026](https://github.com/aws-powertools/powertools-lambda-python/issues/3026))
+* **parser:** change ApproximateCreationDateTime field to datetime in DynamoDBStreamChangedRecordModel ([#3049](https://github.com/aws-powertools/powertools-lambda-python/issues/3049))
+
+## Code Refactoring
+
+* **batch:** type response() method ([#3023](https://github.com/aws-powertools/powertools-lambda-python/issues/3023))
+
+## Documentation
+
+* **event_handler:** demonstrate how to combine logger correlation ID and middleware ([#3064](https://github.com/aws-powertools/powertools-lambda-python/issues/3064))
+* **event_handler:** use correct correlation_id for logger in middleware example ([#3063](https://github.com/aws-powertools/powertools-lambda-python/issues/3063))
+* **idempotency:** use tab navigation, improves custom serializer example, and additional explanations ([#3067](https://github.com/aws-powertools/powertools-lambda-python/issues/3067))
+
+## Features
+
+* **event_handler:** add Middleware support for REST Event Handler ([#2917](https://github.com/aws-powertools/powertools-lambda-python/issues/2917))
+* **idempotency:** add support to custom serialization/deserialization on idempotency decorator ([#2951](https://github.com/aws-powertools/powertools-lambda-python/issues/2951))
+
+## Maintenance
+
+* version bump
+* **deps:** bump squidfunk/mkdocs-material from `b1f7f94` to `f4764d1` in /docs ([#3031](https://github.com/aws-powertools/powertools-lambda-python/issues/3031))
+* **deps:** bump gitpython from 3.1.32 to 3.1.35 in /docs ([#3059](https://github.com/aws-powertools/powertools-lambda-python/issues/3059))
+* **deps:** bump squidfunk/mkdocs-material from `f4764d1` to `dd1770c` in /docs ([#3044](https://github.com/aws-powertools/powertools-lambda-python/issues/3044))
+* **deps:** bump actions/checkout from 3.6.0 to 4.0.0 ([#3041](https://github.com/aws-powertools/powertools-lambda-python/issues/3041))
+* **deps:** bump squidfunk/mkdocs-material from `97da15b` to `b1f7f94` in /docs ([#3021](https://github.com/aws-powertools/powertools-lambda-python/issues/3021))
+* **deps:** bump docker/setup-buildx-action from 2.9.1 to 2.10.0 ([#3022](https://github.com/aws-powertools/powertools-lambda-python/issues/3022))
+* **deps:** bump actions/upload-artifact from 3.1.2 to 3.1.3 ([#3053](https://github.com/aws-powertools/powertools-lambda-python/issues/3053))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 1 update ([#3052](https://github.com/aws-powertools/powertools-lambda-python/issues/3052))
+* **deps-dev:** bump mkdocs-material from 9.2.6 to 9.2.7 ([#3043](https://github.com/aws-powertools/powertools-lambda-python/issues/3043))
+* **deps-dev:** bump cfn-lint from 0.79.7 to 0.79.8 ([#3033](https://github.com/aws-powertools/powertools-lambda-python/issues/3033))
+* **deps-dev:** bump mkdocs-material from 9.2.5 to 9.2.6 ([#3032](https://github.com/aws-powertools/powertools-lambda-python/issues/3032))
+* **deps-dev:** bump ruff from 0.0.286 to 0.0.287 ([#3035](https://github.com/aws-powertools/powertools-lambda-python/issues/3035))
+* **deps-dev:** bump sentry-sdk from 1.29.2 to 1.30.0 ([#3028](https://github.com/aws-powertools/powertools-lambda-python/issues/3028))
+* **deps-dev:** bump the boto-typing group with 11 updates ([#3027](https://github.com/aws-powertools/powertools-lambda-python/issues/3027))
+* **deps-dev:** bump pytest from 7.4.1 to 7.4.2 ([#3057](https://github.com/aws-powertools/powertools-lambda-python/issues/3057))
+* **deps-dev:** bump hvac from 1.1.1 to 1.2.0 ([#3054](https://github.com/aws-powertools/powertools-lambda-python/issues/3054))
+* **deps-dev:** bump cfn-lint from 0.79.8 to 0.79.9 ([#3046](https://github.com/aws-powertools/powertools-lambda-python/issues/3046))
+* **deps-dev:** bump the boto-typing group with 1 update ([#3013](https://github.com/aws-powertools/powertools-lambda-python/issues/3013))
+* **deps-dev:** bump pytest from 7.4.0 to 7.4.1 ([#3042](https://github.com/aws-powertools/powertools-lambda-python/issues/3042))
+* **deps-dev:** bump ruff from 0.0.285 to 0.0.286 ([#3014](https://github.com/aws-powertools/powertools-lambda-python/issues/3014))
+* **deps-dev:** bump gitpython from 3.1.32 to 3.1.35 ([#3060](https://github.com/aws-powertools/powertools-lambda-python/issues/3060))
+* **deps-dev:** bump aws-cdk from 2.93.0 to 2.94.0 ([#3036](https://github.com/aws-powertools/powertools-lambda-python/issues/3036))
+
+
+<a name="v2.23.1"></a>
+## [v2.23.1] - 2023-08-25
+## Bug Fixes
+
+* **ci:** revert aws credentials action ([#3010](https://github.com/aws-powertools/powertools-lambda-python/issues/3010))
+* **ci:** change SAR assume role options ([#3005](https://github.com/aws-powertools/powertools-lambda-python/issues/3005))
+* **event_handler:** make invalid chars a raw str to fix DeprecationWarning ([#2982](https://github.com/aws-powertools/powertools-lambda-python/issues/2982))
+* **metrics:** preserve default_tags when metric-specific tag is set in Datadog provider ([#2997](https://github.com/aws-powertools/powertools-lambda-python/issues/2997))
+
+## Maintenance
+
+* version bump
+* **deps:** bump squidfunk/mkdocs-material from `cd3a522` to `97da15b` in /docs ([#2987](https://github.com/aws-powertools/powertools-lambda-python/issues/2987))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#2978](https://github.com/aws-powertools/powertools-lambda-python/issues/2978))
+* **deps:** bump aws-actions/configure-aws-credentials from 2.2.0 to 3.0.0 ([#3000](https://github.com/aws-powertools/powertools-lambda-python/issues/3000))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#2983](https://github.com/aws-powertools/powertools-lambda-python/issues/2983))
+* **deps:** bump slsa-framework/slsa-github-generator from 1.8.0 to 1.9.0 ([#2992](https://github.com/aws-powertools/powertools-lambda-python/issues/2992))
+* **deps:** bump actions/checkout from 3.5.3 to 3.6.0 ([#2999](https://github.com/aws-powertools/powertools-lambda-python/issues/2999))
+* **deps-dev:** bump ruff from 0.0.284 to 0.0.285 ([#2977](https://github.com/aws-powertools/powertools-lambda-python/issues/2977))
+* **deps-dev:** bump aws-cdk from 2.92.0 to 2.93.0 ([#2993](https://github.com/aws-powertools/powertools-lambda-python/issues/2993))
+* **deps-dev:** bump mkdocs-material from 9.1.21 to 9.2.0 ([#2984](https://github.com/aws-powertools/powertools-lambda-python/issues/2984))
+* **deps-dev:** bump mkdocs-material from 9.2.0 to 9.2.3 ([#2988](https://github.com/aws-powertools/powertools-lambda-python/issues/2988))
+
+
+<a name="v2.23.0"></a>
+## [v2.23.0] - 2023-08-18
+## Bug Fixes
+
+* **logger:** strip xray_trace_id when explicitly disabled ([#2852](https://github.com/aws-powertools/powertools-lambda-python/issues/2852))
+* **metrics:** proxy service and namespace attrs to provider ([#2910](https://github.com/aws-powertools/powertools-lambda-python/issues/2910))
+* **parser:** API Gateway V2 request context scope field should be optional ([#2961](https://github.com/aws-powertools/powertools-lambda-python/issues/2961))
+
+## Code Refactoring
+
+* **e2e:** support fail fast in get_lambda_response ([#2912](https://github.com/aws-powertools/powertools-lambda-python/issues/2912))
+* **metrics:** move from protocol to ABC; split provider tests ([#2934](https://github.com/aws-powertools/powertools-lambda-python/issues/2934))
+
+## Documentation
+
+* **batch:** new visuals and error handling section ([#2857](https://github.com/aws-powertools/powertools-lambda-python/issues/2857))
+* **batch:** explain record type discrepancy in failure and success handler ([#2868](https://github.com/aws-powertools/powertools-lambda-python/issues/2868))
+* **metrics:** update Datadog integration diagram ([#2954](https://github.com/aws-powertools/powertools-lambda-python/issues/2954))
+* **navigation:** remove nofollow attribute for internal links ([#2867](https://github.com/aws-powertools/powertools-lambda-python/issues/2867))
+* **navigation:** add nofollow attribute ([#2842](https://github.com/aws-powertools/powertools-lambda-python/issues/2842))
+* **roadmap:** update roadmap themes ([#2915](https://github.com/aws-powertools/powertools-lambda-python/issues/2915))
+* **roadmap:** add GovCloud and China region item ([#2960](https://github.com/aws-powertools/powertools-lambda-python/issues/2960))
+* **tutorial:** add support for Python 3.11 ([#2860](https://github.com/aws-powertools/powertools-lambda-python/issues/2860))
+
+## Features
+
+* **event_handler:** allow stripping route prefixes using regexes ([#2521](https://github.com/aws-powertools/powertools-lambda-python/issues/2521))
+* **layers:** add new comercial region Israel(Tel Aviv) ([#2907](https://github.com/aws-powertools/powertools-lambda-python/issues/2907))
+* **metrics:** add Datadog observability provider ([#2906](https://github.com/aws-powertools/powertools-lambda-python/issues/2906))
+* **metrics:** support to bring your own metrics provider ([#2194](https://github.com/aws-powertools/powertools-lambda-python/issues/2194))
+
+## Maintenance
+
+* version bump
+* **ci:** enable protected branch auditing ([#2913](https://github.com/aws-powertools/powertools-lambda-python/issues/2913))
+* **ci:** group dependabot updates ([#2896](https://github.com/aws-powertools/powertools-lambda-python/issues/2896))
+* **deps:** bump github.com/aws/aws-sdk-go-v2 from 1.19.0 to 1.19.1 in /layer/scripts/layer-balancer ([#2877](https://github.com/aws-powertools/powertools-lambda-python/issues/2877))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.8.8 to 1.8.9 ([#2943](https://github.com/aws-powertools/powertools-lambda-python/issues/2943))
+* **deps:** bump github.com/aws/aws-sdk-go-v2/service/lambda from 1.38.0 to 1.38.1 in /layer/scripts/layer-balancer ([#2876](https://github.com/aws-powertools/powertools-lambda-python/issues/2876))
+* **deps:** bump actions/dependency-review-action from 3.0.6 to 3.0.7 ([#2941](https://github.com/aws-powertools/powertools-lambda-python/issues/2941))
+* **deps:** bump github.com/aws/aws-sdk-go-v2/config from 1.18.29 to 1.18.30 in /layer/scripts/layer-balancer ([#2875](https://github.com/aws-powertools/powertools-lambda-python/issues/2875))
+* **deps:** bump actions/dependency-review-action from 3.0.7 to 3.0.8 ([#2963](https://github.com/aws-powertools/powertools-lambda-python/issues/2963))
+* **deps:** bump gitpython from 3.1.31 to 3.1.32 in /docs ([#2948](https://github.com/aws-powertools/powertools-lambda-python/issues/2948))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 2 updates ([#2904](https://github.com/aws-powertools/powertools-lambda-python/issues/2904))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#2933](https://github.com/aws-powertools/powertools-lambda-python/issues/2933))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.8.9 to 1.8.10 ([#2946](https://github.com/aws-powertools/powertools-lambda-python/issues/2946))
+* **deps:** bump actions/setup-node from 3.7.0 to 3.8.0 ([#2957](https://github.com/aws-powertools/powertools-lambda-python/issues/2957))
+* **deps:** bump slsa-framework/slsa-github-generator from 1.7.0 to 1.8.0 ([#2927](https://github.com/aws-powertools/powertools-lambda-python/issues/2927))
+* **deps:** bump github.com/aws/aws-sdk-go-v2/config from 1.18.28 to 1.18.29 in /layer/scripts/layer-balancer ([#2844](https://github.com/aws-powertools/powertools-lambda-python/issues/2844))
+* **deps:** bump github.com/aws/aws-sdk-go-v2/service/lambda from 1.37.1 to 1.38.0 in /layer/scripts/layer-balancer ([#2843](https://github.com/aws-powertools/powertools-lambda-python/issues/2843))
+* **deps:** bump pydantic from 1.10.11 to 1.10.12 ([#2846](https://github.com/aws-powertools/powertools-lambda-python/issues/2846))
+* **deps:** bump the layer-balancer group in /layer/scripts/layer-balancer with 3 updates ([#2971](https://github.com/aws-powertools/powertools-lambda-python/issues/2971))
+* **deps:** bump actions/setup-node from 3.8.0 to 3.8.1 ([#2970](https://github.com/aws-powertools/powertools-lambda-python/issues/2970))
+* **deps:** bump github.com/aws/aws-sdk-go-v2/config from 1.18.30 to 1.18.31 in /layer/scripts/layer-balancer ([#2889](https://github.com/aws-powertools/powertools-lambda-python/issues/2889))
+* **deps:** bump github.com/aws/aws-sdk-go-v2/service/lambda from 1.38.1 to 1.39.0 in /layer/scripts/layer-balancer ([#2890](https://github.com/aws-powertools/powertools-lambda-python/issues/2890))
+* **deps:** bump squidfunk/mkdocs-material from `33e28bd` to `cd3a522` in /docs ([#2859](https://github.com/aws-powertools/powertools-lambda-python/issues/2859))
+* **deps-dev:** bump ruff from 0.0.283 to 0.0.284 ([#2940](https://github.com/aws-powertools/powertools-lambda-python/issues/2940))
+* **deps-dev:** bump cfn-lint from 0.79.5 to 0.79.6 ([#2899](https://github.com/aws-powertools/powertools-lambda-python/issues/2899))
+* **deps-dev:** bump the boto-typing group with 11 updates ([#2901](https://github.com/aws-powertools/powertools-lambda-python/issues/2901))
+* **deps-dev:** bump ruff from 0.0.281 to 0.0.282 ([#2905](https://github.com/aws-powertools/powertools-lambda-python/issues/2905))
+* **deps-dev:** bump aws-cdk from 2.88.0 to 2.89.0 ([#2887](https://github.com/aws-powertools/powertools-lambda-python/issues/2887))
+* **deps-dev:** bump aws-cdk from 2.89.0 to 2.90.0 ([#2932](https://github.com/aws-powertools/powertools-lambda-python/issues/2932))
+* **deps-dev:** bump mkdocs-material from 9.1.19 to 9.1.21 ([#2894](https://github.com/aws-powertools/powertools-lambda-python/issues/2894))
+* **deps-dev:** bump the boto-typing group with 3 updates ([#2967](https://github.com/aws-powertools/powertools-lambda-python/issues/2967))
+* **deps-dev:** bump radon from 5.1.0 to 6.0.1 ([#2964](https://github.com/aws-powertools/powertools-lambda-python/issues/2964))
+* **deps-dev:** bump the boto-typing group with 4 updates ([#2928](https://github.com/aws-powertools/powertools-lambda-python/issues/2928))
+* **deps-dev:** bump mypy-boto3-logs from 1.28.1 to 1.28.15 ([#2880](https://github.com/aws-powertools/powertools-lambda-python/issues/2880))
+* **deps-dev:** bump mypy-boto3-appconfigdata from 1.28.0 to 1.28.15 ([#2879](https://github.com/aws-powertools/powertools-lambda-python/issues/2879))
+* **deps-dev:** bump mypy-boto3-lambda from 1.28.11 to 1.28.15 ([#2878](https://github.com/aws-powertools/powertools-lambda-python/issues/2878))
+* **deps-dev:** bump mypy-boto3-xray from 1.28.0 to 1.28.15 ([#2881](https://github.com/aws-powertools/powertools-lambda-python/issues/2881))
+* **deps-dev:** bump ruff from 0.0.282 to 0.0.283 ([#2937](https://github.com/aws-powertools/powertools-lambda-python/issues/2937))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.28.0 to 1.28.11 ([#2847](https://github.com/aws-powertools/powertools-lambda-python/issues/2847))
+* **deps-dev:** bump sentry-sdk from 1.28.1 to 1.29.0 ([#2900](https://github.com/aws-powertools/powertools-lambda-python/issues/2900))
+* **deps-dev:** bump cfn-lint from 0.79.4 to 0.79.5 ([#2870](https://github.com/aws-powertools/powertools-lambda-python/issues/2870))
+* **deps-dev:** bump the boto-typing group with 1 update ([#2944](https://github.com/aws-powertools/powertools-lambda-python/issues/2944))
+* **deps-dev:** bump mypy-boto3-cloudformation from 1.28.10 to 1.28.12 ([#2864](https://github.com/aws-powertools/powertools-lambda-python/issues/2864))
+* **deps-dev:** bump mypy-boto3-cloudwatch from 1.28.0 to 1.28.12 ([#2865](https://github.com/aws-powertools/powertools-lambda-python/issues/2865))
+* **deps-dev:** bump cfn-lint from 0.79.3 to 0.79.4 ([#2862](https://github.com/aws-powertools/powertools-lambda-python/issues/2862))
+* **deps-dev:** bump mypy-boto3-appconfig from 1.28.0 to 1.28.12 ([#2861](https://github.com/aws-powertools/powertools-lambda-python/issues/2861))
+* **deps-dev:** bump mypy-boto3-ssm from 1.28.0 to 1.28.12 ([#2863](https://github.com/aws-powertools/powertools-lambda-python/issues/2863))
+* **deps-dev:** bump aws-cdk from 2.90.0 to 2.91.0 ([#2947](https://github.com/aws-powertools/powertools-lambda-python/issues/2947))
+* **deps-dev:** bump xenon from 0.9.0 to 0.9.1 ([#2955](https://github.com/aws-powertools/powertools-lambda-python/issues/2955))
+* **deps-dev:** bump cfn-lint from 0.78.2 to 0.79.3 ([#2854](https://github.com/aws-powertools/powertools-lambda-python/issues/2854))
+* **deps-dev:** bump mypy-boto3-lambda from 1.28.0 to 1.28.11 ([#2845](https://github.com/aws-powertools/powertools-lambda-python/issues/2845))
+* **deps-dev:** bump cfn-lint from 0.79.6 to 0.79.7 ([#2956](https://github.com/aws-powertools/powertools-lambda-python/issues/2956))
+* **deps-dev:** bump aws-cdk from 2.91.0 to 2.92.0 ([#2965](https://github.com/aws-powertools/powertools-lambda-python/issues/2965))
+* **deps-dev:** bump ruff from 0.0.280 to 0.0.281 ([#2891](https://github.com/aws-powertools/powertools-lambda-python/issues/2891))
+* **docs:** include the environment variables section in the utilities documentation ([#2925](https://github.com/aws-powertools/powertools-lambda-python/issues/2925))
+* **docs:** disable line length rule using older syntax ([#2920](https://github.com/aws-powertools/powertools-lambda-python/issues/2920))
+* **maintenance:** enables publishing docs and changelog, running e2e tests only in the main repository ([#2924](https://github.com/aws-powertools/powertools-lambda-python/issues/2924))
+
+
+<a name="v2.22.0"></a>
+## [v2.22.0] - 2023-07-25
+## Bug Fixes
+
+* **parameters:** distinct cache key for single vs path with same name ([#2839](https://github.com/aws-powertools/powertools-lambda-python/issues/2839))
+
+## Documentation
+
+* **community:** new batch processing article ([#2828](https://github.com/aws-powertools/powertools-lambda-python/issues/2828))
+* **parameters:** improve readability on error handling get_parameter… ([#2833](https://github.com/aws-powertools/powertools-lambda-python/issues/2833))
+
+## Features
+
+* **general:** add support for Python 3.11 ([#2820](https://github.com/aws-powertools/powertools-lambda-python/issues/2820))
+
+## Maintenance
+
+* version bump
+* **ci:** add baking time for layer build ([#2834](https://github.com/aws-powertools/powertools-lambda-python/issues/2834))
+* **ci:** build changelog on a schedule only ([#2832](https://github.com/aws-powertools/powertools-lambda-python/issues/2832))
+* **deps:** bump actions/setup-python from 4.6.1 to 4.7.0 ([#2821](https://github.com/aws-powertools/powertools-lambda-python/issues/2821))
+* **deps-dev:** bump ruff from 0.0.278 to 0.0.279 ([#2822](https://github.com/aws-powertools/powertools-lambda-python/issues/2822))
+* **deps-dev:** bump cfn-lint from 0.78.1 to 0.78.2 ([#2823](https://github.com/aws-powertools/powertools-lambda-python/issues/2823))
+* **deps-dev:** bump ruff from 0.0.279 to 0.0.280 ([#2836](https://github.com/aws-powertools/powertools-lambda-python/issues/2836))
+* **deps-dev:** bump mypy-boto3-cloudformation from 1.28.0 to 1.28.10 ([#2837](https://github.com/aws-powertools/powertools-lambda-python/issues/2837))
+
+
+<a name="v2.21.0"></a>
+## [v2.21.0] - 2023-07-21
+## Bug Fixes
+
+* **docs:** remove redundant code ([#2796](https://github.com/aws-powertools/powertools-lambda-python/issues/2796))
+
+## Documentation
+
+* **customer-reference:** add Jit Security as a customer reference ([#2801](https://github.com/aws-powertools/powertools-lambda-python/issues/2801))
+
+## Features
+
+* **parser:** add support for Pydantic v2 ([#2733](https://github.com/aws-powertools/powertools-lambda-python/issues/2733))
+
+## Maintenance
+
+* version bump
+* **deps:** bump squidfunk/mkdocs-material from `a28ed81` to `33e28bd` in /docs ([#2797](https://github.com/aws-powertools/powertools-lambda-python/issues/2797))
+* **deps-dev:** bump mypy-boto3-s3 from 1.28.3.post2 to 1.28.8 ([#2808](https://github.com/aws-powertools/powertools-lambda-python/issues/2808))
+* **deps-dev:** bump types-python-dateutil from 2.8.19.13 to 2.8.19.14 ([#2807](https://github.com/aws-powertools/powertools-lambda-python/issues/2807))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.28.3.post1 to 1.28.3.post2 ([#2794](https://github.com/aws-powertools/powertools-lambda-python/issues/2794))
+* **deps-dev:** bump types-requests from 2.31.0.1 to 2.31.0.2 ([#2806](https://github.com/aws-powertools/powertools-lambda-python/issues/2806))
+* **deps-dev:** bump mypy-boto3-s3 from 1.28.3.post1 to 1.28.3.post2 ([#2793](https://github.com/aws-powertools/powertools-lambda-python/issues/2793))
+* **deps-dev:** bump aws-cdk from 2.87.0 to 2.88.0 ([#2812](https://github.com/aws-powertools/powertools-lambda-python/issues/2812))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.28.3 to 1.28.3.post1 ([#2785](https://github.com/aws-powertools/powertools-lambda-python/issues/2785))
+* **deps-dev:** bump mypy-boto3-s3 from 1.28.3 to 1.28.3.post1 ([#2786](https://github.com/aws-powertools/powertools-lambda-python/issues/2786))
+* **deps-dev:** bump mkdocs-material from 9.1.18 to 9.1.19 ([#2798](https://github.com/aws-powertools/powertools-lambda-python/issues/2798))
+* **security:** improve debugging for provenance script ([#2784](https://github.com/aws-powertools/powertools-lambda-python/issues/2784))
+
+
+<a name="v2.20.0"></a>
+## [v2.20.0] - 2023-07-14
+## Bug Fixes
+
+* **docs:** ensure alias is applied to versioned releases ([#2644](https://github.com/aws-powertools/powertools-lambda-python/issues/2644))
+* **docs:** ensure version alias is in an array to prevent "you're not viewing the latest version" incorrect message ([#2629](https://github.com/aws-powertools/powertools-lambda-python/issues/2629))
+* **logger:** ensure logs stream to stdout by default, not stderr ([#2736](https://github.com/aws-powertools/powertools-lambda-python/issues/2736))
+
+## Code Refactoring
+
+* **parser:** convert functional tests to unit tests ([#2656](https://github.com/aws-powertools/powertools-lambda-python/issues/2656))
+
+## Documentation
+
+* **batch:** fix custom batch processor example ([#2714](https://github.com/aws-powertools/powertools-lambda-python/issues/2714))
+* **contributing:** add code integration journey graph ([#2685](https://github.com/aws-powertools/powertools-lambda-python/issues/2685))
+* **maintainers:** add cicd pipeline diagram ([#2692](https://github.com/aws-powertools/powertools-lambda-python/issues/2692))
+* **process:** explain our integration automated checks; revamp navigation ([#2764](https://github.com/aws-powertools/powertools-lambda-python/issues/2764))
+
+## Features
+
+* **metrics:** support to set default dimension in EphemeralMetrics ([#2748](https://github.com/aws-powertools/powertools-lambda-python/issues/2748))
+
+## Maintenance
+
+* version bump
+* **ci:** enforce pip --require-hashes to maybe satistify scorecard ([#2679](https://github.com/aws-powertools/powertools-lambda-python/issues/2679))
+* **ci:** prevent merging PRs that do not meet minimum requirements ([#2639](https://github.com/aws-powertools/powertools-lambda-python/issues/2639))
+* **ci:** enforce top-level permission to minimum fail-safe permission as per openssf ([#2638](https://github.com/aws-powertools/powertools-lambda-python/issues/2638))
+* **ci:** propagate checkout permission to nested workflows ([#2642](https://github.com/aws-powertools/powertools-lambda-python/issues/2642))
+* **ci:** improves dependabot based on ossf scorecard recommendations ([#2647](https://github.com/aws-powertools/powertools-lambda-python/issues/2647))
+* **ci:** use deps sha for docs and gitpod images based on ossf findings ([#2662](https://github.com/aws-powertools/powertools-lambda-python/issues/2662))
+* **ci:** use sast on every commit on any supported language ([#2646](https://github.com/aws-powertools/powertools-lambda-python/issues/2646))
+* **ci:** add gitleaks in pre-commit hooks as an extra safety measure ([#2677](https://github.com/aws-powertools/powertools-lambda-python/issues/2677))
+* **ci:** address ossf scorecard findings on npm, pip, and top-level permission leftover ([#2694](https://github.com/aws-powertools/powertools-lambda-python/issues/2694))
+* **ci:** prevent sast codeql to run in forks ([#2711](https://github.com/aws-powertools/powertools-lambda-python/issues/2711))
+* **ci:** introduce provenance and attestation in release ([#2746](https://github.com/aws-powertools/powertools-lambda-python/issues/2746))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.8.7 to 1.8.8 ([#2754](https://github.com/aws-powertools/powertools-lambda-python/issues/2754))
+* **deps:** bump github.com/aws/aws-sdk-go-v2/service/lambda from 1.37.0 to 1.37.1 in /layer/scripts/layer-balancer ([#2769](https://github.com/aws-powertools/powertools-lambda-python/issues/2769))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 2.1.3 to 2.1.4 ([#2738](https://github.com/aws-powertools/powertools-lambda-python/issues/2738))
+* **deps:** bump github.com/aws/aws-sdk-go-v2/config from 1.18.27 to 1.18.28 in /layer/scripts/layer-balancer ([#2770](https://github.com/aws-powertools/powertools-lambda-python/issues/2770))
+* **deps:** bump actions/setup-python from 4.6.1 to 4.7.0 ([#2768](https://github.com/aws-powertools/powertools-lambda-python/issues/2768))
+* **deps:** bump github.com/aws/aws-sdk-go-v2 from 1.16.16 to 1.18.1 in /layer/scripts/layer-balancer ([#2654](https://github.com/aws-powertools/powertools-lambda-python/issues/2654))
+* **deps:** bump golang.org/x/sync from 0.1.0 to 0.3.0 in /layer/scripts/layer-balancer ([#2649](https://github.com/aws-powertools/powertools-lambda-python/issues/2649))
+* **deps:** bump github.com/aws/aws-sdk-go-v2/service/lambda from 1.24.6 to 1.37.0 in /layer/scripts/layer-balancer ([#2653](https://github.com/aws-powertools/powertools-lambda-python/issues/2653))
+* **deps:** bump docker/setup-buildx-action from 2.8.0 to 2.9.0 ([#2718](https://github.com/aws-powertools/powertools-lambda-python/issues/2718))
+* **deps:** bump github.com/aws/aws-sdk-go-v2/config from 1.17.8 to 1.18.27 in /layer/scripts/layer-balancer ([#2651](https://github.com/aws-powertools/powertools-lambda-python/issues/2651))
+* **deps:** bump github.com/aws/aws-sdk-go-v2 from 1.18.1 to 1.19.0 in /layer/scripts/layer-balancer ([#2771](https://github.com/aws-powertools/powertools-lambda-python/issues/2771))
+* **deps:** migrate from retry to retry2 to address CVE-2022-42969 ([#2665](https://github.com/aws-powertools/powertools-lambda-python/issues/2665))
+* **deps:** bump pydantic from 1.10.9 to 1.10.10 ([#2624](https://github.com/aws-powertools/powertools-lambda-python/issues/2624))
+* **deps:** bump squidfunk/mkdocs-material from `3837c0f` to `a28ed81` in /docs ([#2669](https://github.com/aws-powertools/powertools-lambda-python/issues/2669))
+* **deps:** bump pydantic from 1.10.10 to 1.10.11 ([#2671](https://github.com/aws-powertools/powertools-lambda-python/issues/2671))
+* **deps:** bump docker/setup-buildx-action from 2.9.0 to 2.9.1 ([#2755](https://github.com/aws-powertools/powertools-lambda-python/issues/2755))
+* **deps:** bump actions/dependency-review-action from 2.5.1 to 3.0.6 ([#2650](https://github.com/aws-powertools/powertools-lambda-python/issues/2650))
+* **deps:** bump actions/setup-node from 3.6.0 to 3.7.0 ([#2689](https://github.com/aws-powertools/powertools-lambda-python/issues/2689))
+* **deps-dev:** bump mypy-boto3-lambda from 1.27.0 to 1.28.0 ([#2698](https://github.com/aws-powertools/powertools-lambda-python/issues/2698))
+* **deps-dev:** bump sentry-sdk from 1.27.0 to 1.27.1 ([#2701](https://github.com/aws-powertools/powertools-lambda-python/issues/2701))
+* **deps-dev:** bump mypy-boto3-cloudformation from 1.27.0 to 1.28.0 ([#2700](https://github.com/aws-powertools/powertools-lambda-python/issues/2700))
+* **deps-dev:** bump mypy-boto3-appconfigdata from 1.27.0 to 1.28.0 ([#2699](https://github.com/aws-powertools/powertools-lambda-python/issues/2699))
+* **deps-dev:** bump ruff from 0.0.276 to 0.0.277 ([#2682](https://github.com/aws-powertools/powertools-lambda-python/issues/2682))
+* **deps-dev:** bump pytest-asyncio from 0.21.0 to 0.21.1 ([#2756](https://github.com/aws-powertools/powertools-lambda-python/issues/2756))
+* **deps-dev:** bump cfn-lint from 0.77.10 to 0.78.1 ([#2757](https://github.com/aws-powertools/powertools-lambda-python/issues/2757))
+* **deps-dev:** bump aws-cdk from 2.86.0 to 2.87.0 ([#2696](https://github.com/aws-powertools/powertools-lambda-python/issues/2696))
+* **deps-dev:** bump typed-ast from 1.5.4 to 1.5.5 ([#2670](https://github.com/aws-powertools/powertools-lambda-python/issues/2670))
+* **deps-dev:** bump mypy-boto3-cloudwatch from 1.27.0 to 1.28.0 ([#2697](https://github.com/aws-powertools/powertools-lambda-python/issues/2697))
+* **deps-dev:** bump ruff from 0.0.275 to 0.0.276 ([#2655](https://github.com/aws-powertools/powertools-lambda-python/issues/2655))
+* **deps-dev:** bump sentry-sdk from 1.26.0 to 1.27.0 ([#2652](https://github.com/aws-powertools/powertools-lambda-python/issues/2652))
+* **deps-dev:** bump ruff from 0.0.277 to 0.0.278 ([#2758](https://github.com/aws-powertools/powertools-lambda-python/issues/2758))
+* **deps-dev:** bump mypy-boto3-s3 from 1.28.0 to 1.28.3 ([#2774](https://github.com/aws-powertools/powertools-lambda-python/issues/2774))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.26.158 to 1.26.164 ([#2622](https://github.com/aws-powertools/powertools-lambda-python/issues/2622))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.28.0 to 1.28.3 ([#2773](https://github.com/aws-powertools/powertools-lambda-python/issues/2773))
+* **deps-dev:** bump sentry-sdk from 1.27.1 to 1.28.0 ([#2741](https://github.com/aws-powertools/powertools-lambda-python/issues/2741))
+* **deps-dev:** bump mypy-boto3-s3 from 1.27.0 to 1.28.0 ([#2721](https://github.com/aws-powertools/powertools-lambda-python/issues/2721))
+* **deps-dev:** bump mypy-boto3-appconfig from 1.27.0 to 1.28.0 ([#2722](https://github.com/aws-powertools/powertools-lambda-python/issues/2722))
+* **deps-dev:** bump mypy-boto3-logs from 1.27.0 to 1.28.1 ([#2723](https://github.com/aws-powertools/powertools-lambda-python/issues/2723))
+* **deps-dev:** bump mypy-boto3-ssm from 1.27.0 to 1.28.0 ([#2724](https://github.com/aws-powertools/powertools-lambda-python/issues/2724))
+* **deps-dev:** bump mypy-boto3-xray from 1.27.0 to 1.28.0 ([#2720](https://github.com/aws-powertools/powertools-lambda-python/issues/2720))
+* **deps-dev:** bump sentry-sdk from 1.28.0 to 1.28.1 ([#2772](https://github.com/aws-powertools/powertools-lambda-python/issues/2772))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.27.0 to 1.28.0 ([#2740](https://github.com/aws-powertools/powertools-lambda-python/issues/2740))
+* **deps-dev:** bump mypy-boto3-appconfigdata from 1.26.70 to 1.27.0 ([#2636](https://github.com/aws-powertools/powertools-lambda-python/issues/2636))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.27.0 to 1.28.0 ([#2739](https://github.com/aws-powertools/powertools-lambda-python/issues/2739))
+* **governance:** update active maintainers list ([#2715](https://github.com/aws-powertools/powertools-lambda-python/issues/2715))
+* **streaming:** replace deprecated Version classes from distutils ([#2752](https://github.com/aws-powertools/powertools-lambda-python/issues/2752))
+* **user-agent:** support patching botocore session ([#2614](https://github.com/aws-powertools/powertools-lambda-python/issues/2614))
+
+
+<a name="v2.19.0"></a>
+## [v2.19.0] - 2023-06-30
+## Bug Fixes
+
+* **e2e:** fix idempotency tests ([#2576](https://github.com/aws-powertools/powertools-lambda-python/issues/2576))
+
+## Code Refactoring
+
+* **event_source:** convert functional tests to unit tests ([#2506](https://github.com/aws-powertools/powertools-lambda-python/issues/2506))
+
+## Documentation
+
+* **i-made-this:** added new article on idempotency ([#2582](https://github.com/aws-powertools/powertools-lambda-python/issues/2582))
+* **i-made-this:** article on idempotency w/ CDK and Powertools ([#2569](https://github.com/aws-powertools/powertools-lambda-python/issues/2569))
+* **idempotency:** split snippets, improve wording and lint examples ([#2492](https://github.com/aws-powertools/powertools-lambda-python/issues/2492))
+
+## Features
+
+* **event_handler:** add VPCLatticeResolver ([#2601](https://github.com/aws-powertools/powertools-lambda-python/issues/2601))
+* **event_source:** decode nested messages on SQS events ([#2349](https://github.com/aws-powertools/powertools-lambda-python/issues/2349))
+* **parser:** add support to VpcLatticeModel ([#2584](https://github.com/aws-powertools/powertools-lambda-python/issues/2584))
+
+## Maintenance
+
+* version bump
+* **analytics:** update docs base origin url ([#2560](https://github.com/aws-powertools/powertools-lambda-python/issues/2560))
+* **ci:** replace flake8 with Ruff as a linter ([#2495](https://github.com/aws-powertools/powertools-lambda-python/issues/2495))
+* **ci:** enable Ruff rule E501 and fix errors ([#2587](https://github.com/aws-powertools/powertools-lambda-python/issues/2587))
+* **ci:** enable Ruff rule COM812 and fix the errors ([#2595](https://github.com/aws-powertools/powertools-lambda-python/issues/2595))
+* **ci:** enable Ruff rules PLW, PLR, PLC and PLE and fix the errors ([#2593](https://github.com/aws-powertools/powertools-lambda-python/issues/2593))
+* **ci:** enable Ruff autofix rules ([#2599](https://github.com/aws-powertools/powertools-lambda-python/issues/2599))
+* **ci:** enable Ruff rules ISC, I001, B018 and fix the errors ([#2597](https://github.com/aws-powertools/powertools-lambda-python/issues/2597))
+* **ci:** enable Ruff rule ERA001 and fix errors ([#2591](https://github.com/aws-powertools/powertools-lambda-python/issues/2591))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.8.6 to 1.8.7 ([#2573](https://github.com/aws-powertools/powertools-lambda-python/issues/2573))
+* **deps:** bump docker/setup-buildx-action from 2.7.0 to 2.8.0 ([#2604](https://github.com/aws-powertools/powertools-lambda-python/issues/2604))
+* **deps:** bump ossf/scorecard-action from 2.1.3 to 2.2.0 ([#2563](https://github.com/aws-powertools/powertools-lambda-python/issues/2563))
+* **deps:** bump release-drafter/release-drafter from 5.23.0 to 5.24.0 ([#2603](https://github.com/aws-powertools/powertools-lambda-python/issues/2603))
+* **deps-dev:** bump mypy-boto3-s3 from 1.26.155 to 1.26.163 ([#2608](https://github.com/aws-powertools/powertools-lambda-python/issues/2608))
+* **deps-dev:** bump mypy-boto3-lambda from 1.26.157 to 1.26.163 ([#2607](https://github.com/aws-powertools/powertools-lambda-python/issues/2607))
+* **deps-dev:** bump mkdocs-material from 9.1.16 to 9.1.17 ([#2564](https://github.com/aws-powertools/powertools-lambda-python/issues/2564))
+* **deps-dev:** bump ruff from 0.0.272 to 0.0.275 ([#2586](https://github.com/aws-powertools/powertools-lambda-python/issues/2586))
+* **deps-dev:** bump mypy-boto3-ssm from 1.26.97 to 1.26.162 ([#2606](https://github.com/aws-powertools/powertools-lambda-python/issues/2606))
+* **deps-dev:** bump pytest from 7.3.2 to 7.4.0 ([#2557](https://github.com/aws-powertools/powertools-lambda-python/issues/2557))
+* **deps-dev:** bump aws-cdk from 2.85.0 to 2.86.0 ([#2613](https://github.com/aws-powertools/powertools-lambda-python/issues/2613))
+* **deps-dev:** bump mypy from 1.4.0 to 1.4.1 ([#2574](https://github.com/aws-powertools/powertools-lambda-python/issues/2574))
+
+
+<a name="v2.18.0"></a>
+## [v2.18.0] - 2023-06-23
+## Bug Fixes
+
+* **docs:** ensure versions.json is updated ([#2505](https://github.com/aws-powertools/powertools-lambda-python/issues/2505))
+* **event_source:** centralizing helper functions for query, header and base64 ([#2496](https://github.com/aws-powertools/powertools-lambda-python/issues/2496))
+
+## Documentation
+
+* **homepage:** fix .NET repository link ([#2549](https://github.com/aws-powertools/powertools-lambda-python/issues/2549))
+* **homepage:** add Open Source Security Foundation badge; update links to new url ([#2545](https://github.com/aws-powertools/powertools-lambda-python/issues/2545))
+* **navigation:** make Key Feature the first section ([#2517](https://github.com/aws-powertools/powertools-lambda-python/issues/2517))
+
+## Features
+
+* **event_handler:** support to enable or disable compression in custom responses ([#2544](https://github.com/aws-powertools/powertools-lambda-python/issues/2544))
+* **feature_flags:** add modulo range condition for segmented experimentation support ([#2331](https://github.com/aws-powertools/powertools-lambda-python/issues/2331))
+
+## Maintenance
+
+* version bump
+* **ci:** fix changelog build permissions ([#2519](https://github.com/aws-powertools/powertools-lambda-python/issues/2519))
+* **ci:** remove GH pages action ([#2501](https://github.com/aws-powertools/powertools-lambda-python/issues/2501))
+* **ci:** updates runner names in workflows ([#2510](https://github.com/aws-powertools/powertools-lambda-python/issues/2510))
+* **ci:** introduces OSSF Scorecard ([#2512](https://github.com/aws-powertools/powertools-lambda-python/issues/2512))
+* **ci:** fix codeowners team name ([#2516](https://github.com/aws-powertools/powertools-lambda-python/issues/2516))
+* **deps:** bump actions/upload-artifact from 3.1.0 to 3.1.2 ([#2522](https://github.com/aws-powertools/powertools-lambda-python/issues/2522))
+* **deps:** bump actions/checkout from 3.1.0 to 3.5.3 ([#2523](https://github.com/aws-powertools/powertools-lambda-python/issues/2523))
+* **deps-dev:** bump mypy-boto3-s3 from 1.26.153 to 1.26.155 ([#2498](https://github.com/aws-powertools/powertools-lambda-python/issues/2498))
+* **deps-dev:** bump aws-cdk from 2.84.0 to 2.85.0 ([#2524](https://github.com/aws-powertools/powertools-lambda-python/issues/2524))
+* **deps-dev:** bump mypy-boto3-lambda from 1.26.147 to 1.26.157 ([#2507](https://github.com/aws-powertools/powertools-lambda-python/issues/2507))
+* **deps-dev:** bump cfn-lint from 0.77.9 to 0.77.10 ([#2508](https://github.com/aws-powertools/powertools-lambda-python/issues/2508))
+* **deps-dev:** bump mypy-boto3-cloudformation from 1.26.149 to 1.26.156 ([#2503](https://github.com/aws-powertools/powertools-lambda-python/issues/2503))
+* **deps-dev:** bump sentry-sdk from 1.25.1 to 1.26.0 ([#2527](https://github.com/aws-powertools/powertools-lambda-python/issues/2527))
+* **deps-dev:** bump hvac from 1.1.0 to 1.1.1 ([#2497](https://github.com/aws-powertools/powertools-lambda-python/issues/2497))
+* **deps-dev:** bump flake8-variables-names from 0.0.5 to 0.0.6 ([#2525](https://github.com/aws-powertools/powertools-lambda-python/issues/2525))
+* **deps-dev:** bump ijson from 3.2.1 to 3.2.2 ([#2526](https://github.com/aws-powertools/powertools-lambda-python/issues/2526))
+* **deps-dev:** bump pytest-mock from 3.10.0 to 3.11.1 ([#2485](https://github.com/aws-powertools/powertools-lambda-python/issues/2485))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.26.152 to 1.26.158 ([#2528](https://github.com/aws-powertools/powertools-lambda-python/issues/2528))
+* **deps-dev:** bump mypy from 1.3.0 to 1.4.0 ([#2509](https://github.com/aws-powertools/powertools-lambda-python/issues/2509))
+* **documentation:** updating repository URL and name to the new location ([#2499](https://github.com/aws-powertools/powertools-lambda-python/issues/2499))
+
+
+<a name="v2.17.0"></a>
+## [v2.17.0] - 2023-06-16
+## Bug Fixes
+
+* **event_handler:** prioritize static over dynamic route to prevent order of route registration mismatch ([#2458](https://github.com/aws-powertools/powertools-lambda-python/issues/2458))
+* **idempotency:** treat missing idempotency key as non-idempotent transaction (no-op) when raise_on_no_idempotency_key is False ([#2477](https://github.com/aws-powertools/powertools-lambda-python/issues/2477))
+
+## Documentation
+
+* **event_handler:** improve compress example using Response class ([#2426](https://github.com/aws-powertools/powertools-lambda-python/issues/2426))
+* **event_sources:** fix DynamoDB stream event docstring ([#2468](https://github.com/aws-powertools/powertools-lambda-python/issues/2468))
+* **idempotency:** new sequence flow when idempotency key is optional ([#2480](https://github.com/aws-powertools/powertools-lambda-python/issues/2480))
+* **idempotency:** add CDK example ([#2434](https://github.com/aws-powertools/powertools-lambda-python/issues/2434))
+* **maintainers:** visual representation of release process ([#2399](https://github.com/aws-powertools/powertools-lambda-python/issues/2399))
+* **navigation:** standardize link targets to enhance customer experience ([#2420](https://github.com/aws-powertools/powertools-lambda-python/issues/2420))
+* **we-made-this:** new article about idempotency design ([#2425](https://github.com/aws-powertools/powertools-lambda-python/issues/2425))
+
+## Features
+
+* **event_sources:** add AWS Config Rule event data class ([#2175](https://github.com/aws-powertools/powertools-lambda-python/issues/2175))
+* **event_sources:** add support for VPC Lattice events ([#2358](https://github.com/aws-powertools/powertools-lambda-python/issues/2358))
+* **logger:** type log record in LambdaPowertoolsFormatter with TypedDict ([#2419](https://github.com/aws-powertools/powertools-lambda-python/issues/2419))
+* **parser:** support for CloudFormation Custom Resources ([#2335](https://github.com/aws-powertools/powertools-lambda-python/issues/2335))
+
+## Maintenance
+
+* version bump
+* **ci:** document all github action workflows and enforce least-privilege ([#2395](https://github.com/aws-powertools/powertools-lambda-python/issues/2395))
+* **ci:** fix PR labeling permission scope ([#2396](https://github.com/aws-powertools/powertools-lambda-python/issues/2396))
+* **deps:** bump aws-actions/configure-aws-credentials from 2.1.0 to 2.2.0 ([#2469](https://github.com/aws-powertools/powertools-lambda-python/issues/2469))
+* **deps:** bump docker/setup-buildx-action from 2.5.0 to 2.6.0 ([#2403](https://github.com/aws-powertools/powertools-lambda-python/issues/2403))
+* **deps:** bump docker/setup-qemu-action from 2.1.0 to 2.2.0 ([#2404](https://github.com/aws-powertools/powertools-lambda-python/issues/2404))
+* **deps:** bump docker/setup-buildx-action from 2.6.0 to 2.7.0 ([#2450](https://github.com/aws-powertools/powertools-lambda-python/issues/2450))
+* **deps:** bump pydantic from 1.10.8 to 1.10.9 ([#2405](https://github.com/aws-powertools/powertools-lambda-python/issues/2405))
+* **deps:** bump actions/checkout from 3.5.2 to 3.5.3 ([#2431](https://github.com/aws-powertools/powertools-lambda-python/issues/2431))
+* **deps-dev:** bump ijson from 3.2.0.post0 to 3.2.1 ([#2441](https://github.com/aws-powertools/powertools-lambda-python/issues/2441))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.26.115 to 1.26.152 ([#2444](https://github.com/aws-powertools/powertools-lambda-python/issues/2444))
+* **deps-dev:** bump filelock from 3.12.0 to 3.12.2 ([#2446](https://github.com/aws-powertools/powertools-lambda-python/issues/2446))
+* **deps-dev:** bump aws-cdk from 2.83.0 to 2.83.1 ([#2432](https://github.com/aws-powertools/powertools-lambda-python/issues/2432))
+* **deps-dev:** bump cfn-lint from 0.77.6 to 0.77.7 ([#2414](https://github.com/aws-powertools/powertools-lambda-python/issues/2414))
+* **deps-dev:** bump pytest from 7.3.1 to 7.3.2 ([#2443](https://github.com/aws-powertools/powertools-lambda-python/issues/2443))
+* **deps-dev:** bump sentry-sdk from 1.25.0 to 1.25.1 ([#2408](https://github.com/aws-powertools/powertools-lambda-python/issues/2408))
+* **deps-dev:** bump mypy-boto3-cloudformation from 1.26.147 to 1.26.149 ([#2410](https://github.com/aws-powertools/powertools-lambda-python/issues/2410))
+* **deps-dev:** bump aws-cdk from 2.82.0 to 2.83.0 ([#2406](https://github.com/aws-powertools/powertools-lambda-python/issues/2406))
+* **deps-dev:** bump mypy-boto3-logs from 1.26.53 to 1.26.149 ([#2409](https://github.com/aws-powertools/powertools-lambda-python/issues/2409))
+* **deps-dev:** bump cfn-lint from 0.77.7 to 0.77.8 ([#2451](https://github.com/aws-powertools/powertools-lambda-python/issues/2451))
+* **deps-dev:** bump mypy-boto3-s3 from 1.26.127 to 1.26.153 ([#2452](https://github.com/aws-powertools/powertools-lambda-python/issues/2452))
+* **deps-dev:** bump cfn-lint from 0.77.8 to 0.77.9 ([#2472](https://github.com/aws-powertools/powertools-lambda-python/issues/2472))
+* **deps-dev:** bump flake8-comprehensions from 3.12.0 to 3.13.0 ([#2471](https://github.com/aws-powertools/powertools-lambda-python/issues/2471))
+* **deps-dev:** bump mkdocs-material from 9.1.15 to 9.1.16 ([#2470](https://github.com/aws-powertools/powertools-lambda-python/issues/2470))
+* **deps-dev:** bump aws-cdk from 2.83.1 to 2.84.0 ([#2460](https://github.com/aws-powertools/powertools-lambda-python/issues/2460))
+
+
+<a name="v2.16.2"></a>
+## [v2.16.2] - 2023-06-06
+## Bug Fixes
+
+* **parameters:** AppConfigProvider when retrieving multiple unique configuration names ([#2378](https://github.com/aws-powertools/powertools-lambda-python/issues/2378))
+* **shared:** move to static version bumping to prevent issues with customers custom builds ([#2386](https://github.com/aws-powertools/powertools-lambda-python/issues/2386))
+
+## Maintenance
+
+* version bump
+* **deps-dev:** bump mypy-boto3-cloudformation from 1.26.108 to 1.26.147 ([#2383](https://github.com/aws-powertools/powertools-lambda-python/issues/2383))
+* **deps-dev:** bump mypy-boto3-lambda from 1.26.122 to 1.26.147 ([#2382](https://github.com/aws-powertools/powertools-lambda-python/issues/2382))
+* **deps-dev:** bump sentry-sdk from 1.24.0 to 1.25.0 ([#2374](https://github.com/aws-powertools/powertools-lambda-python/issues/2374))
+* **deps-dev:** bump aws-cdk from 2.81.0 to 2.82.0 ([#2373](https://github.com/aws-powertools/powertools-lambda-python/issues/2373))
+* **typing:** add setLevel and addHandler to Logger for mypy/pyright ([#2388](https://github.com/aws-powertools/powertools-lambda-python/issues/2388))
+
+
+<a name="v2.16.1"></a>
+## [v2.16.1] - 2023-06-02
+## Bug Fixes
+
+* **shared:** skip user agent on much older botocore versions ([#2366](https://github.com/aws-powertools/powertools-lambda-python/issues/2366))
+
+## Maintenance
+
+* version bump
+
+
+<a name="v2.16.0"></a>
+## [v2.16.0] - 2023-06-02
+## Bug Fixes
+
+* **docs:** use concrete secrets from settings ([#2322](https://github.com/aws-powertools/powertools-lambda-python/issues/2322))
+* **event_source:** change the import location of boto3 in CodePipelineJobEvent data class ([#2353](https://github.com/aws-powertools/powertools-lambda-python/issues/2353))
+* **logger:** add setLevel function to set level programmatically ([#2320](https://github.com/aws-powertools/powertools-lambda-python/issues/2320))
+
+## Code Refactoring
+
+* **logger:** remove subclassing and move unnecessary APIs ([#2334](https://github.com/aws-powertools/powertools-lambda-python/issues/2334))
+
+## Documentation
+
+* **batch:** add encryption at rest for SQS ([#2290](https://github.com/aws-powertools/powertools-lambda-python/issues/2290))
+* **batch_processing:** snippets split, improved, and lint ([#2231](https://github.com/aws-powertools/powertools-lambda-python/issues/2231))
+* **feature_flags:** snippets split, improved, and lint ([#2222](https://github.com/aws-powertools/powertools-lambda-python/issues/2222))
+* **project:** rename project to Powertools for AWS Lambda (Python) ([#2313](https://github.com/aws-powertools/powertools-lambda-python/issues/2313))
+
+## Features
+
+* **docs:** Move docs to S3 ([#2277](https://github.com/aws-powertools/powertools-lambda-python/issues/2277))
+* **event_source:** allow multiple CORS origins ([#2279](https://github.com/aws-powertools/powertools-lambda-python/issues/2279))
+* **parser:** add support for parsing SQS events wrapped in Kinesis Firehose ([#2294](https://github.com/aws-powertools/powertools-lambda-python/issues/2294))
+* **user-agent:** add custom header User-Agent to AWS SDK requests ([#2267](https://github.com/aws-powertools/powertools-lambda-python/issues/2267))
+
+## Maintenance
+
+* version bump
+* **ci:** remove auto-merge workflow ([#2214](https://github.com/aws-powertools/powertools-lambda-python/issues/2214))
+* **ci:** schedule changelog to rebuild daily at 8am, and on release only ([#2216](https://github.com/aws-powertools/powertools-lambda-python/issues/2216))
+* **ci:** create pull request on changelog update ([#2224](https://github.com/aws-powertools/powertools-lambda-python/issues/2224))
+* **ci:** skip analytics on forks ([#2225](https://github.com/aws-powertools/powertools-lambda-python/issues/2225))
+* **ci:** enforce zero trust for third party workflows ([#2215](https://github.com/aws-powertools/powertools-lambda-python/issues/2215))
+* **ci:** convert create-pr steps into composite action ([#2238](https://github.com/aws-powertools/powertools-lambda-python/issues/2238))
+* **ci:** bump package version after release via pull request ([#2239](https://github.com/aws-powertools/powertools-lambda-python/issues/2239))
+* **ci:** update layer ARN docs and create PR during release ([#2240](https://github.com/aws-powertools/powertools-lambda-python/issues/2240))
+* **ci:** fail create-pr when branch cannot be created or behind tip
+* **ci:** filter out bot commits from CHANGELOG
+* **ci:** add more permissions to analytics
+* **ci:** source code tampering protection for release ([#2301](https://github.com/aws-powertools/powertools-lambda-python/issues/2301))
+* **deps:** bump fastjsonschema from 2.16.3 to 2.17.1 ([#2307](https://github.com/aws-powertools/powertools-lambda-python/issues/2307))
+* **deps:** bump aws-actions/configure-aws-credentials from 2.0.0 to 2.1.0 ([#2350](https://github.com/aws-powertools/powertools-lambda-python/issues/2350))
+* **deps:** bump typing-extensions from 4.5.0 to 4.6.2 ([#2345](https://github.com/aws-powertools/powertools-lambda-python/issues/2345))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 2.1.2 to 2.1.3 ([#2227](https://github.com/aws-powertools/powertools-lambda-python/issues/2227))
+* **deps:** bump actions/setup-python from 4.6.0 to 4.6.1 ([#2325](https://github.com/aws-powertools/powertools-lambda-python/issues/2325))
+* **deps:** update mkdocs configuration to support pymdown-extensions 10.0 ([#2271](https://github.com/aws-powertools/powertools-lambda-python/issues/2271))
+* **deps:** bump pymdown-extensions from 9.11 to 10.0 ([#2262](https://github.com/aws-powertools/powertools-lambda-python/issues/2262))
+* **deps:** bump pydantic from 1.10.7 to 1.10.8 ([#2316](https://github.com/aws-powertools/powertools-lambda-python/issues/2316))
+* **deps:** bump codecov/codecov-action from 3.1.3 to 3.1.4 ([#2263](https://github.com/aws-powertools/powertools-lambda-python/issues/2263))
+* **deps:** bump requests from 2.28.2 to 2.31.0 ([#2308](https://github.com/aws-powertools/powertools-lambda-python/issues/2308))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.26.116 to 1.26.135 ([#2282](https://github.com/aws-powertools/powertools-lambda-python/issues/2282))
+* **deps-dev:** bump pytest-xdist from 3.2.1 to 3.3.0 ([#2251](https://github.com/aws-powertools/powertools-lambda-python/issues/2251))
+* **deps-dev:** bump aws-cdk from 2.79.0 to 2.79.1 ([#2252](https://github.com/aws-powertools/powertools-lambda-python/issues/2252))
+* **deps-dev:** bump mkdocs-material from 9.1.11 to 9.1.12 ([#2253](https://github.com/aws-powertools/powertools-lambda-python/issues/2253))
+* **deps-dev:** bump aws-cdk from 2.79.1 to 2.80.0 ([#2305](https://github.com/aws-powertools/powertools-lambda-python/issues/2305))
+* **deps-dev:** bump mkdocs-material from 9.1.13 to 9.1.14 ([#2304](https://github.com/aws-powertools/powertools-lambda-python/issues/2304))
+* **deps-dev:** bump mkdocs-material from 9.1.12 to 9.1.13 ([#2280](https://github.com/aws-powertools/powertools-lambda-python/issues/2280))
+* **deps-dev:** bump aws-cdk from 2.80.0 to 2.81.0 ([#2332](https://github.com/aws-powertools/powertools-lambda-python/issues/2332))
+* **deps-dev:** bump sentry-sdk from 1.22.2 to 1.23.0 ([#2264](https://github.com/aws-powertools/powertools-lambda-python/issues/2264))
+* **deps-dev:** bump sentry-sdk from 1.23.1 to 1.24.0 ([#2314](https://github.com/aws-powertools/powertools-lambda-python/issues/2314))
+* **deps-dev:** bump types-requests from 2.30.0.0 to 2.31.0.0 ([#2315](https://github.com/aws-powertools/powertools-lambda-python/issues/2315))
+* **deps-dev:** bump httpx from 0.24.0 to 0.24.1 ([#2298](https://github.com/aws-powertools/powertools-lambda-python/issues/2298))
+* **deps-dev:** bump aws-cdk from 2.78.0 to 2.79.0 ([#2235](https://github.com/aws-powertools/powertools-lambda-python/issues/2235))
+* **deps-dev:** bump mypy from 1.2.0 to 1.3.0 ([#2233](https://github.com/aws-powertools/powertools-lambda-python/issues/2233))
+* **deps-dev:** bump pytest-cov from 4.0.0 to 4.1.0 ([#2327](https://github.com/aws-powertools/powertools-lambda-python/issues/2327))
+* **deps-dev:** bump types-python-dateutil from 2.8.19.12 to 2.8.19.13 ([#2234](https://github.com/aws-powertools/powertools-lambda-python/issues/2234))
+* **deps-dev:** bump coverage from 7.2.5 to 7.2.6 ([#2326](https://github.com/aws-powertools/powertools-lambda-python/issues/2326))
+* **deps-dev:** bump mkdocs-material from 9.1.14 to 9.1.15 ([#2337](https://github.com/aws-powertools/powertools-lambda-python/issues/2337))
+* **deps-dev:** bump mkdocs-material from 9.1.9 to 9.1.11 ([#2229](https://github.com/aws-powertools/powertools-lambda-python/issues/2229))
+* **deps-dev:** bump cfn-lint from 0.77.4 to 0.77.5 ([#2228](https://github.com/aws-powertools/powertools-lambda-python/issues/2228))
+* **deps-dev:** bump cfn-lint from 0.77.5 to 0.77.6 ([#2360](https://github.com/aws-powertools/powertools-lambda-python/issues/2360))
+* **deps-dev:** bump coverage from 7.2.6 to 7.2.7 ([#2338](https://github.com/aws-powertools/powertools-lambda-python/issues/2338))
+* **deps-dev:** bump types-requests from 2.31.0.0 to 2.31.0.1 ([#2339](https://github.com/aws-powertools/powertools-lambda-python/issues/2339))
+* **deps-dev:** bump mypy-boto3-cloudwatch from 1.26.99 to 1.26.127 ([#2219](https://github.com/aws-powertools/powertools-lambda-python/issues/2219))
+* **deps-dev:** bump types-requests from 2.29.0.0 to 2.30.0.0 ([#2220](https://github.com/aws-powertools/powertools-lambda-python/issues/2220))
+* **deps-dev:** bump mypy-boto3-s3 from 1.26.116 to 1.26.127 ([#2218](https://github.com/aws-powertools/powertools-lambda-python/issues/2218))
+* **deps-dev:** bump pytest-xdist from 3.3.0 to 3.3.1 ([#2297](https://github.com/aws-powertools/powertools-lambda-python/issues/2297))
+* **deps-dev:** bump sentry-sdk from 1.23.0 to 1.23.1 ([#2283](https://github.com/aws-powertools/powertools-lambda-python/issues/2283))
+* **deps-dev:** bump aws-cdk from 2.77.0 to 2.78.0 ([#2202](https://github.com/aws-powertools/powertools-lambda-python/issues/2202))
+* **governance:** Fix python version in issue templates ([#2275](https://github.com/aws-powertools/powertools-lambda-python/issues/2275))
+
+
+<a name="v2.15.0"></a>
+## [v2.15.0] - 2023-05-04
+## Bug Fixes
+
+* typo
+* **ci:** pypi publishing was targetting test endpoint
+
+## Documentation
+
+* **batch:** fixed typo in DynamoDB Streams section ([#2189](https://github.com/aws-powertools/powertools-lambda-python/issues/2189))
+* **examples:** standardize lambda handler function name ([#2192](https://github.com/aws-powertools/powertools-lambda-python/issues/2192))
+* **homepage:** add customer references section ([#2159](https://github.com/aws-powertools/powertools-lambda-python/issues/2159))
+* **jmespath:** fix MD037/no-space-in-emphasis
+* **tutorial:** use newer sam cli template; update to py3.10 ([#2167](https://github.com/aws-powertools/powertools-lambda-python/issues/2167))
+* **we-made-this:** add serverless transactional message app ([#2182](https://github.com/aws-powertools/powertools-lambda-python/issues/2182))
+
+## Features
+
+* **ci:** dispatch GitHub analytics action ([#2161](https://github.com/aws-powertools/powertools-lambda-python/issues/2161))
+* **event_source:** support custom json_deserializer; add json_body in SQSEvent ([#2200](https://github.com/aws-powertools/powertools-lambda-python/issues/2200))
+* **event_source:** add support for dynamic partitions in the Api Gateway Authorizer event ([#2176](https://github.com/aws-powertools/powertools-lambda-python/issues/2176))
+* **event_sources:** Add __str__ to Data Classes base DictWrapper ([#2129](https://github.com/aws-powertools/powertools-lambda-python/issues/2129))
+* **jmespath:** new built-in envelopes to unwrap S3 events ([#2169](https://github.com/aws-powertools/powertools-lambda-python/issues/2169))
+* **logger:** add DatadogLogFormatter and observability provider ([#2183](https://github.com/aws-powertools/powertools-lambda-python/issues/2183))
+* **metrics:** add flush_metrics() method to allow manual flushing of metrics ([#2171](https://github.com/aws-powertools/powertools-lambda-python/issues/2171))
+* **parser:** add support for SQS-wrapped S3 event notifications ([#2108](https://github.com/aws-powertools/powertools-lambda-python/issues/2108))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* add dummy reusable dispatch analytics job
+* **ci:** remove build step from release env; no more secrets need
+* **ci:** use new pypi trusted publisher for increase security ([#2198](https://github.com/aws-powertools/powertools-lambda-python/issues/2198))
+* **deps:** bump pypa/gh-action-pypi-publish from 1.8.5 to 1.8.6 ([#2201](https://github.com/aws-powertools/powertools-lambda-python/issues/2201))
+* **deps-dev:** bump cfn-lint from 0.77.3 to 0.77.4 ([#2178](https://github.com/aws-powertools/powertools-lambda-python/issues/2178))
+* **deps-dev:** bump types-requests from 2.28.11.17 to 2.29.0.0 ([#2187](https://github.com/aws-powertools/powertools-lambda-python/issues/2187))
+* **deps-dev:** bump coverage from 7.2.4 to 7.2.5 ([#2186](https://github.com/aws-powertools/powertools-lambda-python/issues/2186))
+* **deps-dev:** bump mkdocs-material from 9.1.8 to 9.1.9 ([#2190](https://github.com/aws-powertools/powertools-lambda-python/issues/2190))
+* **deps-dev:** bump importlib-metadata from 6.5.0 to 6.6.0 ([#2163](https://github.com/aws-powertools/powertools-lambda-python/issues/2163))
+* **deps-dev:** bump mypy-boto3-xray from 1.26.11.post1 to 1.26.122 ([#2173](https://github.com/aws-powertools/powertools-lambda-python/issues/2173))
+* **deps-dev:** bump aws-cdk from 2.76.0 to 2.77.0 ([#2174](https://github.com/aws-powertools/powertools-lambda-python/issues/2174))
+* **deps-dev:** bump mypy-boto3-lambda from 1.26.115 to 1.26.122 ([#2172](https://github.com/aws-powertools/powertools-lambda-python/issues/2172))
+* **deps-dev:** bump cfn-lint from 0.77.2 to 0.77.3 ([#2165](https://github.com/aws-powertools/powertools-lambda-python/issues/2165))
+* **deps-dev:** bump mkdocs-material from 9.1.6 to 9.1.8 ([#2162](https://github.com/aws-powertools/powertools-lambda-python/issues/2162))
+* **deps-dev:** bump coverage from 7.2.3 to 7.2.4 ([#2179](https://github.com/aws-powertools/powertools-lambda-python/issues/2179))
+* **governance:** add Lambda Powertools for .NET in issue templates ([#2196](https://github.com/aws-powertools/powertools-lambda-python/issues/2196))
+
+
+<a name="v2.14.1"></a>
+## [v2.14.1] - 2023-04-21
+## Bug Fixes
+
+* **batch:** resolve use of ValidationError in batch ([#2157](https://github.com/aws-powertools/powertools-lambda-python/issues/2157))
+* **e2e:** fix test brittleness ([#2152](https://github.com/aws-powertools/powertools-lambda-python/issues/2152))
+
+## Documentation
+
+* **readme:** update python version badge to 3.10
+
+## Features
+
+* **event_sources:** add queue_url field in SQS EventSource DataClass ([#2146](https://github.com/aws-powertools/powertools-lambda-python/issues/2146))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* add Python 3.10 PyPi language classifier ([#2144](https://github.com/aws-powertools/powertools-lambda-python/issues/2144))
+* update v2 layer ARN on documentation
+* **batch:** safeguard custom use of BatchProcessingError exception ([#2155](https://github.com/aws-powertools/powertools-lambda-python/issues/2155))
+* **deps:** bump codecov/codecov-action from 3.1.2 to 3.1.3 ([#2153](https://github.com/aws-powertools/powertools-lambda-python/issues/2153))
+* **deps:** bump dependabot/fetch-metadata from 1.3.6 to 1.4.0 ([#2140](https://github.com/aws-powertools/powertools-lambda-python/issues/2140))
+* **deps-dev:** bump aws-cdk from 2.75.0 to 2.75.1 ([#2150](https://github.com/aws-powertools/powertools-lambda-python/issues/2150))
+* **deps-dev:** bump aws-cdk from 2.75.1 to 2.76.0 ([#2154](https://github.com/aws-powertools/powertools-lambda-python/issues/2154))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.26.89 to 1.26.116 ([#2147](https://github.com/aws-powertools/powertools-lambda-python/issues/2147))
+* **deps-dev:** bump importlib-metadata from 6.4.1 to 6.5.0 ([#2141](https://github.com/aws-powertools/powertools-lambda-python/issues/2141))
+* **deps-dev:** bump mypy-boto3-s3 from 1.26.104 to 1.26.116 ([#2149](https://github.com/aws-powertools/powertools-lambda-python/issues/2149))
+* **deps-dev:** bump filelock from 3.11.0 to 3.12.0 ([#2142](https://github.com/aws-powertools/powertools-lambda-python/issues/2142))
+* **deps-dev:** bump cfn-lint from 0.77.1 to 0.77.2 ([#2148](https://github.com/aws-powertools/powertools-lambda-python/issues/2148))
+
+
+<a name="v2.14.0"></a>
+## [v2.14.0] - 2023-04-18
+## Bug Fixes
+
+* enable python 3.10 on SAR template
+* **ci:** fix layer version in tracer, logger and metrics
+* **ci:** typo
+* **docs:** add Layer ARN for new 5 regions
+* **layers:** add debug to update layer arn script
+
+## Features
+
+* **runtime:** add support for python 3.10 ([#2137](https://github.com/aws-powertools/powertools-lambda-python/issues/2137))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* update v2 layer ARN on documentation
+* update v2 layer ARN on documentation
+* **ci:** add support for x86-64 regions only ([#2122](https://github.com/aws-powertools/powertools-lambda-python/issues/2122))
+* **deps-dev:** bump importlib-metadata from 6.3.0 to 6.4.1 ([#2134](https://github.com/aws-powertools/powertools-lambda-python/issues/2134))
+* **deps-dev:** bump cfn-lint from 0.77.0 to 0.77.1 ([#2133](https://github.com/aws-powertools/powertools-lambda-python/issues/2133))
+* **deps-dev:** bump pytest from 7.3.0 to 7.3.1 ([#2127](https://github.com/aws-powertools/powertools-lambda-python/issues/2127))
+* **deps-dev:** bump mypy-boto3-lambda from 1.26.109 to 1.26.114 ([#2126](https://github.com/aws-powertools/powertools-lambda-python/issues/2126))
+* **deps-dev:** bump mypy-boto3-lambda from 1.26.114 to 1.26.115 ([#2135](https://github.com/aws-powertools/powertools-lambda-python/issues/2135))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.26.97.post1 to 1.26.115 ([#2132](https://github.com/aws-powertools/powertools-lambda-python/issues/2132))
+* **github:** new tech debt issue form ([#2131](https://github.com/aws-powertools/powertools-lambda-python/issues/2131))
+* **layer:** change layer-balance script to support new regions
+
+## Reverts
+* chore: update v2 layer ARN on documentation
+
+
+<a name="v2.13.0"></a>
+## [v2.13.0] - 2023-04-14
+## Bug Fixes
+
+* **ci:** replace the correct files for Layer ARN
+* **ci:** fix working directory
+* **ci:** add debug log to NPM install
+* **ci:** use project's CDK version when building layers
+* **ci:** add the rest of the changed docs
+* **ci:** update layer version on logger, tracer and metrics docs ([#2120](https://github.com/aws-powertools/powertools-lambda-python/issues/2120))
+* **event_sources:** Update CodePipeline event source to include optional encryption_key field and make user_parameters field optional ([#2113](https://github.com/aws-powertools/powertools-lambda-python/issues/2113))
+
+## Features
+
+* **parameters:** Configure max_age and decrypt parameters via environment variables ([#2088](https://github.com/aws-powertools/powertools-lambda-python/issues/2088))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* **ci:** bump the cdk-aws-lambda-powertools-layer version ([#2121](https://github.com/aws-powertools/powertools-lambda-python/issues/2121))
+* **deps:** bump codecov/codecov-action from 3.1.1 to 3.1.2 ([#2110](https://github.com/aws-powertools/powertools-lambda-python/issues/2110))
+* **deps-dev:** bump httpx from 0.23.3 to 0.24.0 ([#2111](https://github.com/aws-powertools/powertools-lambda-python/issues/2111))
+* **deps-dev:** bump aws-cdk-lib from 2.73.0 to 2.74.0 ([#2123](https://github.com/aws-powertools/powertools-lambda-python/issues/2123))
+* **deps-dev:** bump mkdocs-material from 9.1.5 to 9.1.6 ([#2104](https://github.com/aws-powertools/powertools-lambda-python/issues/2104))
+* **deps-dev:** bump aws-cdk from 2.73.0 to 2.74.0 ([#2125](https://github.com/aws-powertools/powertools-lambda-python/issues/2125))
+* **deps-dev:** bump flake8-comprehensions from 3.11.1 to 3.12.0 ([#2124](https://github.com/aws-powertools/powertools-lambda-python/issues/2124))
+* **deps-dev:** bump mypy from 1.1.1 to 1.2.0 ([#2096](https://github.com/aws-powertools/powertools-lambda-python/issues/2096))
+* **deps-dev:** bump cfn-lint from 0.76.2 to 0.77.0 ([#2107](https://github.com/aws-powertools/powertools-lambda-python/issues/2107))
+* **deps-dev:** bump pytest from 7.2.2 to 7.3.0 ([#2106](https://github.com/aws-powertools/powertools-lambda-python/issues/2106))
+* **deps-dev:** bump importlib-metadata from 6.1.0 to 6.3.0 ([#2105](https://github.com/aws-powertools/powertools-lambda-python/issues/2105))
+* **deps-dev:** bump mypy-boto3-lambda from 1.26.80 to 1.26.109 ([#2103](https://github.com/aws-powertools/powertools-lambda-python/issues/2103))
+* **maintenance:** validate acknowledgement section is present ([#2112](https://github.com/aws-powertools/powertools-lambda-python/issues/2112))
+
+
+<a name="v2.12.0"></a>
+## [v2.12.0] - 2023-04-07
+## Bug Fixes
+
+* **batch:** handle early validation errors for pydantic models (poison pill) [#2091](https://github.com/aws-powertools/powertools-lambda-python/issues/2091) ([#2099](https://github.com/aws-powertools/powertools-lambda-python/issues/2099))
+
+## Documentation
+
+* **batch:** use newly supported Json model ([#2100](https://github.com/aws-powertools/powertools-lambda-python/issues/2100))
+* **homepage:** remove banner for end-of-support v1 ([#2098](https://github.com/aws-powertools/powertools-lambda-python/issues/2098))
+* **idempotency:** fixes to testing your code section ([#2073](https://github.com/aws-powertools/powertools-lambda-python/issues/2073))
+* **idempotency:** new sequence diagrams, fix idempotency record vs DynamoDB TTL confusion ([#2074](https://github.com/aws-powertools/powertools-lambda-python/issues/2074))
+* **parser:** fix highlighted line ([#2064](https://github.com/aws-powertools/powertools-lambda-python/issues/2064))
+
+## Features
+
+* **batch:** reduce boilerplate with process_partial_response ([#2090](https://github.com/aws-powertools/powertools-lambda-python/issues/2090))
+* **idempotency:** allow custom sdk clients in DynamoDBPersistenceLayer ([#2087](https://github.com/aws-powertools/powertools-lambda-python/issues/2087))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* **deps:** bump peaceiris/actions-gh-pages from 3.9.2 to 3.9.3 ([#2069](https://github.com/aws-powertools/powertools-lambda-python/issues/2069))
+* **deps:** bump aws-xray-sdk from 2.11.0 to 2.12.0 ([#2080](https://github.com/aws-powertools/powertools-lambda-python/issues/2080))
+* **deps-dev:** bump coverage from 7.2.2 to 7.2.3 ([#2092](https://github.com/aws-powertools/powertools-lambda-python/issues/2092))
+* **deps-dev:** bump aws-cdk from 2.72.1 to 2.73.0 ([#2093](https://github.com/aws-powertools/powertools-lambda-python/issues/2093))
+* **deps-dev:** bump mypy-boto3-cloudformation from 1.26.60 to 1.26.108 ([#2095](https://github.com/aws-powertools/powertools-lambda-python/issues/2095))
+* **deps-dev:** bump types-python-dateutil from 2.8.19.11 to 2.8.19.12 ([#2085](https://github.com/aws-powertools/powertools-lambda-python/issues/2085))
+* **deps-dev:** bump cfn-lint from 0.76.1 to 0.76.2 ([#2084](https://github.com/aws-powertools/powertools-lambda-python/issues/2084))
+* **deps-dev:** bump aws-cdk from 2.72.0 to 2.72.1 ([#2081](https://github.com/aws-powertools/powertools-lambda-python/issues/2081))
+* **deps-dev:** bump filelock from 3.10.7 to 3.11.0 ([#2094](https://github.com/aws-powertools/powertools-lambda-python/issues/2094))
+* **deps-dev:** bump mkdocs-material from 9.1.4 to 9.1.5 ([#2077](https://github.com/aws-powertools/powertools-lambda-python/issues/2077))
+* **deps-dev:** bump aws-cdk-lib from 2.72.0 to 2.72.1 ([#2076](https://github.com/aws-powertools/powertools-lambda-python/issues/2076))
+* **deps-dev:** bump mypy-boto3-s3 from 1.26.99 to 1.26.104 ([#2075](https://github.com/aws-powertools/powertools-lambda-python/issues/2075))
+* **deps-dev:** bump aws-cdk from 2.71.0 to 2.72.0 ([#2071](https://github.com/aws-powertools/powertools-lambda-python/issues/2071))
+* **deps-dev:** bump aws-cdk-lib from 2.72.1 to 2.73.0 ([#2097](https://github.com/aws-powertools/powertools-lambda-python/issues/2097))
+* **deps-dev:** bump aws-cdk-lib from 2.71.0 to 2.72.0 ([#2070](https://github.com/aws-powertools/powertools-lambda-python/issues/2070))
+* **deps-dev:** bump black from 23.1.0 to 23.3.0 ([#2066](https://github.com/aws-powertools/powertools-lambda-python/issues/2066))
+* **deps-dev:** bump aws-cdk from 2.70.0 to 2.71.0 ([#2067](https://github.com/aws-powertools/powertools-lambda-python/issues/2067))
+* **deps-dev:** bump aws-cdk-lib from 2.70.0 to 2.71.0 ([#2065](https://github.com/aws-powertools/powertools-lambda-python/issues/2065))
+
+
+<a name="v2.11.0"></a>
+## [v2.11.0] - 2023-03-29
+## Bug Fixes
+
+* **feature_flags:** make test conditions deterministic ([#2059](https://github.com/aws-powertools/powertools-lambda-python/issues/2059))
+* **feature_flags:** handle expected falsy values in conditions ([#2052](https://github.com/aws-powertools/powertools-lambda-python/issues/2052))
+
+## Documentation
+
+* **logger:** warn append_keys on not being thread-safe ([#2046](https://github.com/aws-powertools/powertools-lambda-python/issues/2046))
+
+## Features
+
+* **event_sources:** support for S3 Event Notifications through EventBridge ([#2024](https://github.com/aws-powertools/powertools-lambda-python/issues/2024))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* **deps:** bump pydantic from 1.10.6 to 1.10.7 ([#2034](https://github.com/aws-powertools/powertools-lambda-python/issues/2034))
+* **deps-dev:** bump mypy-boto3-s3 from 1.26.97 to 1.26.97.post2 ([#2043](https://github.com/aws-powertools/powertools-lambda-python/issues/2043))
+* **deps-dev:** bump cfn-lint from 0.75.1 to 0.76.1 ([#2056](https://github.com/aws-powertools/powertools-lambda-python/issues/2056))
+* **deps-dev:** bump types-python-dateutil from 2.8.19.10 to 2.8.19.11 ([#2057](https://github.com/aws-powertools/powertools-lambda-python/issues/2057))
+* **deps-dev:** bump mypy-boto3-s3 from 1.26.97.post2 to 1.26.99 ([#2054](https://github.com/aws-powertools/powertools-lambda-python/issues/2054))
+* **deps-dev:** bump mkdocs-material from 9.1.3 to 9.1.4 ([#2050](https://github.com/aws-powertools/powertools-lambda-python/issues/2050))
+* **deps-dev:** bump filelock from 3.10.2 to 3.10.4 ([#2048](https://github.com/aws-powertools/powertools-lambda-python/issues/2048))
+* **deps-dev:** bump mypy-boto3-cloudwatch from 1.26.52 to 1.26.99 ([#2049](https://github.com/aws-powertools/powertools-lambda-python/issues/2049))
+* **deps-dev:** bump filelock from 3.10.1 to 3.10.2 ([#2045](https://github.com/aws-powertools/powertools-lambda-python/issues/2045))
+* **deps-dev:** bump types-requests from 2.28.11.15 to 2.28.11.16 ([#2044](https://github.com/aws-powertools/powertools-lambda-python/issues/2044))
+* **deps-dev:** bump filelock from 3.10.4 to 3.10.7 ([#2055](https://github.com/aws-powertools/powertools-lambda-python/issues/2055))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.26.97 to 1.26.97.post1 ([#2042](https://github.com/aws-powertools/powertools-lambda-python/issues/2042))
+* **deps-dev:** bump filelock from 3.10.0 to 3.10.1 ([#2036](https://github.com/aws-powertools/powertools-lambda-python/issues/2036))
+* **deps-dev:** bump aws-cdk from 2.69.0 to 2.70.0 ([#2039](https://github.com/aws-powertools/powertools-lambda-python/issues/2039))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.26.87 to 1.26.97 ([#2035](https://github.com/aws-powertools/powertools-lambda-python/issues/2035))
+* **deps-dev:** bump mypy-boto3-s3 from 1.26.62 to 1.26.97 ([#2037](https://github.com/aws-powertools/powertools-lambda-python/issues/2037))
+* **deps-dev:** bump aws-cdk-lib from 2.69.0 to 2.70.0 ([#2038](https://github.com/aws-powertools/powertools-lambda-python/issues/2038))
+* **deps-dev:** bump types-requests from 2.28.11.16 to 2.28.11.17 ([#2061](https://github.com/aws-powertools/powertools-lambda-python/issues/2061))
+* **deps-dev:** bump mypy-boto3-ssm from 1.26.77 to 1.26.97 ([#2033](https://github.com/aws-powertools/powertools-lambda-python/issues/2033))
+* **deps-dev:** bump flake8-comprehensions from 3.11.0 to 3.11.1 ([#2029](https://github.com/aws-powertools/powertools-lambda-python/issues/2029))
+* **deps-dev:** bump cfn-lint from 0.75.0 to 0.75.1 ([#2027](https://github.com/aws-powertools/powertools-lambda-python/issues/2027))
+* **deps-dev:** bump pytest-asyncio from 0.20.3 to 0.21.0 ([#2026](https://github.com/aws-powertools/powertools-lambda-python/issues/2026))
+
+
+<a name="v2.10.0"></a>
+## [v2.10.0] - 2023-03-17
+## Bug Fixes
+
+* only allow one e2e test at a time
+* **build:** auto-generate setup.py for legacy build tools ([#2013](https://github.com/aws-powertools/powertools-lambda-python/issues/2013))
+* **ci:** bump CDK version
+* **typing:** swap NoReturn with None for methods with no return value ([#2004](https://github.com/aws-powertools/powertools-lambda-python/issues/2004))
+
+## Documentation
+
+* **homepage:** revamp install UX & share how we build Lambda Layer ([#1978](https://github.com/aws-powertools/powertools-lambda-python/issues/1978))
+* **metrics:** fix high-resolution metrics announcement link ([#2017](https://github.com/aws-powertools/powertools-lambda-python/issues/2017))
+
+## Features
+
+* **event_sources:** support for custom properties in ActiveMQEvent ([#1999](https://github.com/aws-powertools/powertools-lambda-python/issues/1999))
+* **parser:** support for S3 Event Notifications via EventBridge ([#1982](https://github.com/aws-powertools/powertools-lambda-python/issues/1982))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* **ci:** allow dependabot to upgrade CDK for JS
+* **deps:** bump docker/setup-buildx-action from 2.4.1 to 2.5.0 ([#1995](https://github.com/aws-powertools/powertools-lambda-python/issues/1995))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 2.1.1 to 2.1.2 ([#1979](https://github.com/aws-powertools/powertools-lambda-python/issues/1979))
+* **deps:** bump aws-actions/configure-aws-credentials from 1 to 2 ([#1987](https://github.com/aws-powertools/powertools-lambda-python/issues/1987))
+* **deps:** bump pydantic from 1.10.5 to 1.10.6 ([#1991](https://github.com/aws-powertools/powertools-lambda-python/issues/1991))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.26.49 to 1.26.89 ([#1996](https://github.com/aws-powertools/powertools-lambda-python/issues/1996))
+* **deps-dev:** bump cfn-lint from 0.74.2 to 0.74.3 ([#2008](https://github.com/aws-powertools/powertools-lambda-python/issues/2008))
+* **deps-dev:** bump filelock from 3.9.0 to 3.9.1 ([#2006](https://github.com/aws-powertools/powertools-lambda-python/issues/2006))
+* **deps-dev:** bump aws-cdk-lib from 2.68.0 to 2.69.0 ([#2007](https://github.com/aws-powertools/powertools-lambda-python/issues/2007))
+* **deps-dev:** bump cfn-lint from 0.74.1 to 0.74.2 ([#2005](https://github.com/aws-powertools/powertools-lambda-python/issues/2005))
+* **deps-dev:** bump mypy from 0.982 to 1.1.1 ([#1985](https://github.com/aws-powertools/powertools-lambda-python/issues/1985))
+* **deps-dev:** bump pytest-xdist from 3.2.0 to 3.2.1 ([#2000](https://github.com/aws-powertools/powertools-lambda-python/issues/2000))
+* **deps-dev:** bump flake8-bugbear from 23.2.13 to 23.3.12 ([#2001](https://github.com/aws-powertools/powertools-lambda-python/issues/2001))
+* **deps-dev:** bump bandit from 1.7.4 to 1.7.5 ([#1997](https://github.com/aws-powertools/powertools-lambda-python/issues/1997))
+* **deps-dev:** bump mkdocs-material from 9.1.2 to 9.1.3 ([#2009](https://github.com/aws-powertools/powertools-lambda-python/issues/2009))
+* **deps-dev:** bump aws-cdk from 2.67.0 to 2.69.0 ([#2010](https://github.com/aws-powertools/powertools-lambda-python/issues/2010))
+* **deps-dev:** bump mkdocs-material from 9.1.1 to 9.1.2 ([#1994](https://github.com/aws-powertools/powertools-lambda-python/issues/1994))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.26.84 to 1.26.87 ([#1993](https://github.com/aws-powertools/powertools-lambda-python/issues/1993))
+* **deps-dev:** bump filelock from 3.9.1 to 3.10.0 ([#2019](https://github.com/aws-powertools/powertools-lambda-python/issues/2019))
+* **deps-dev:** bump aws-cdk-lib from 2.67.0 to 2.68.0 ([#1992](https://github.com/aws-powertools/powertools-lambda-python/issues/1992))
+* **deps-dev:** bump cfn-lint from 0.74.0 to 0.74.1 ([#1988](https://github.com/aws-powertools/powertools-lambda-python/issues/1988))
+* **deps-dev:** bump coverage from 7.2.1 to 7.2.2 ([#2021](https://github.com/aws-powertools/powertools-lambda-python/issues/2021))
+* **deps-dev:** bump pytest from 7.2.1 to 7.2.2 ([#1980](https://github.com/aws-powertools/powertools-lambda-python/issues/1980))
+* **deps-dev:** bump cfn-lint from 0.74.3 to 0.75.0 ([#2020](https://github.com/aws-powertools/powertools-lambda-python/issues/2020))
+* **deps-dev:** bump types-python-dateutil from 2.8.19.9 to 2.8.19.10 ([#1973](https://github.com/aws-powertools/powertools-lambda-python/issues/1973))
+* **deps-dev:** bump hvac from 1.0.2 to 1.1.0 ([#1983](https://github.com/aws-powertools/powertools-lambda-python/issues/1983))
+* **deps-dev:** bump mkdocs-material from 9.1.0 to 9.1.1 ([#1984](https://github.com/aws-powertools/powertools-lambda-python/issues/1984))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.26.24 to 1.26.84 ([#1981](https://github.com/aws-powertools/powertools-lambda-python/issues/1981))
+* **deps-dev:** bump mkdocs-material from 9.0.15 to 9.1.0 ([#1976](https://github.com/aws-powertools/powertools-lambda-python/issues/1976))
+* **deps-dev:** bump cfn-lint from 0.67.0 to 0.74.0 ([#1974](https://github.com/aws-powertools/powertools-lambda-python/issues/1974))
+* **deps-dev:** bump aws-cdk-lib from 2.66.1 to 2.67.0 ([#1977](https://github.com/aws-powertools/powertools-lambda-python/issues/1977))
+
+
+<a name="v2.9.1"></a>
+## [v2.9.1] - 2023-03-01
+## Bug Fixes
+
+* **idempotency:** revert dict mutation that impacted static_pk_value feature ([#1970](https://github.com/aws-powertools/powertools-lambda-python/issues/1970))
+
+## Documentation
+
+* **appsync:** add mutation example and infrastructure fix ([#1964](https://github.com/aws-powertools/powertools-lambda-python/issues/1964))
+* **parameters:** fix typos and inconsistencies ([#1966](https://github.com/aws-powertools/powertools-lambda-python/issues/1966))
+
+## Maintenance
+
+* update project description
+* update v2 layer ARN on documentation
+* **ci:** disable pypi test due to maintenance mode
+* **ci:** replace deprecated set-output commands ([#1957](https://github.com/aws-powertools/powertools-lambda-python/issues/1957))
+* **deps:** bump fastjsonschema from 2.16.2 to 2.16.3 ([#1961](https://github.com/aws-powertools/powertools-lambda-python/issues/1961))
+* **deps:** bump release-drafter/release-drafter from 5.22.0 to 5.23.0 ([#1947](https://github.com/aws-powertools/powertools-lambda-python/issues/1947))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 2.1.0 to 2.1.1 ([#1958](https://github.com/aws-powertools/powertools-lambda-python/issues/1958))
+* **deps-dev:** bump coverage from 7.2.0 to 7.2.1 ([#1963](https://github.com/aws-powertools/powertools-lambda-python/issues/1963))
+* **deps-dev:** bump types-python-dateutil from 2.8.19.8 to 2.8.19.9 ([#1960](https://github.com/aws-powertools/powertools-lambda-python/issues/1960))
+* **deps-dev:** bump mkdocs-material from 9.0.14 to 9.0.15 ([#1959](https://github.com/aws-powertools/powertools-lambda-python/issues/1959))
+* **deps-dev:** bump mypy-boto3-lambda from 1.26.55 to 1.26.80 ([#1967](https://github.com/aws-powertools/powertools-lambda-python/issues/1967))
+* **deps-dev:** bump types-requests from 2.28.11.14 to 2.28.11.15 ([#1962](https://github.com/aws-powertools/powertools-lambda-python/issues/1962))
+* **deps-dev:** bump aws-cdk-lib from 2.66.0 to 2.66.1 ([#1954](https://github.com/aws-powertools/powertools-lambda-python/issues/1954))
+* **deps-dev:** bump coverage from 7.1.0 to 7.2.0 ([#1951](https://github.com/aws-powertools/powertools-lambda-python/issues/1951))
+* **deps-dev:** bump mkdocs-material from 9.0.13 to 9.0.14 ([#1952](https://github.com/aws-powertools/powertools-lambda-python/issues/1952))
+* **deps-dev:** bump mypy-boto3-ssm from 1.26.43 to 1.26.77 ([#1949](https://github.com/aws-powertools/powertools-lambda-python/issues/1949))
+* **deps-dev:** bump types-requests from 2.28.11.13 to 2.28.11.14 ([#1946](https://github.com/aws-powertools/powertools-lambda-python/issues/1946))
+* **deps-dev:** bump aws-cdk-lib from 2.65.0 to 2.66.0 ([#1948](https://github.com/aws-powertools/powertools-lambda-python/issues/1948))
+* **deps-dev:** bump types-python-dateutil from 2.8.19.7 to 2.8.19.8 ([#1945](https://github.com/aws-powertools/powertools-lambda-python/issues/1945))
+* **parser:** add workaround to make API GW test button work ([#1971](https://github.com/aws-powertools/powertools-lambda-python/issues/1971))
+
+
+<a name="v2.9.0"></a>
+## [v2.9.0] - 2023-02-21
+## Bug Fixes
+
+* **ci:** upgraded cdk to match the version used on e2e tests
+* **feature-flags:** revert RuleAction Enum inheritance on str ([#1910](https://github.com/aws-powertools/powertools-lambda-python/issues/1910))
+* **logger:** support exception and exception_name fields at any log level ([#1930](https://github.com/aws-powertools/powertools-lambda-python/issues/1930))
+* **metrics:** clarify no-metrics user warning ([#1935](https://github.com/aws-powertools/powertools-lambda-python/issues/1935))
+
+## Documentation
+
+* **event_handlers:** Fix REST API - HTTP Methods documentation ([#1936](https://github.com/aws-powertools/powertools-lambda-python/issues/1936))
+* **home:** update powertools definition
+* **we-made-this:** add CI/CD using Feature Flags video ([#1940](https://github.com/aws-powertools/powertools-lambda-python/issues/1940))
+* **we-made-this:** add Feature Flags post ([#1939](https://github.com/aws-powertools/powertools-lambda-python/issues/1939))
+
+## Features
+
+* **batch:** add support to SQS FIFO queues (SqsFifoPartialProcessor) ([#1934](https://github.com/aws-powertools/powertools-lambda-python/issues/1934))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 2.0.5 to 2.1.0 ([#1943](https://github.com/aws-powertools/powertools-lambda-python/issues/1943))
+* **deps:** bump pydantic from 1.10.4 to 1.10.5 ([#1931](https://github.com/aws-powertools/powertools-lambda-python/issues/1931))
+* **deps-dev:** bump mkdocs-material from 9.0.12 to 9.0.13 ([#1944](https://github.com/aws-powertools/powertools-lambda-python/issues/1944))
+* **deps-dev:** bump aws-cdk-lib from 2.64.0 to 2.65.0 ([#1938](https://github.com/aws-powertools/powertools-lambda-python/issues/1938))
+* **deps-dev:** bump types-python-dateutil from 2.8.19.6 to 2.8.19.7 ([#1932](https://github.com/aws-powertools/powertools-lambda-python/issues/1932))
+* **deps-dev:** bump types-requests from 2.28.11.12 to 2.28.11.13 ([#1933](https://github.com/aws-powertools/powertools-lambda-python/issues/1933))
+* **deps-dev:** bump mypy-boto3-appconfig from 1.26.63 to 1.26.71 ([#1928](https://github.com/aws-powertools/powertools-lambda-python/issues/1928))
+* **deps-dev:** bump flake8-bugbear from 23.1.20 to 23.2.13 ([#1924](https://github.com/aws-powertools/powertools-lambda-python/issues/1924))
+* **deps-dev:** bump mypy-boto3-appconfigdata from 1.26.0.post1 to 1.26.70 ([#1925](https://github.com/aws-powertools/powertools-lambda-python/issues/1925))
+
+
+<a name="v2.8.0"></a>
+## [v2.8.0] - 2023-02-10
+## Bug Fixes
+
+* **idempotency:** make idempotent_function decorator thread safe ([#1899](https://github.com/aws-powertools/powertools-lambda-python/issues/1899))
+
+## Documentation
+
+* **engine:** re-enable clipboard button for code snippets
+* **homepage:** Replace poetry command to add group parameter ([#1917](https://github.com/aws-powertools/powertools-lambda-python/issues/1917))
+* **homepage:** set url for end-of-support in announce block ([#1893](https://github.com/aws-powertools/powertools-lambda-python/issues/1893))
+* **idempotency:** add IAM permissions section ([#1902](https://github.com/aws-powertools/powertools-lambda-python/issues/1902))
+* **metrics:** remove reduntant wording before release
+* **metrics:** fix syntax highlighting for new default_dimensions
+
+## Features
+
+* **batch:** add async_batch_processor for concurrent processing ([#1724](https://github.com/aws-powertools/powertools-lambda-python/issues/1724))
+* **metrics:** add default_dimensions to single_metric ([#1880](https://github.com/aws-powertools/powertools-lambda-python/issues/1880))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* **deps:** bump docker/setup-buildx-action from 2.4.0 to 2.4.1 ([#1903](https://github.com/aws-powertools/powertools-lambda-python/issues/1903))
+* **deps-dev:** bump aws-cdk-lib from 2.63.0 to 2.63.2 ([#1904](https://github.com/aws-powertools/powertools-lambda-python/issues/1904))
+* **deps-dev:** bump black from 22.12.0 to 23.1.0 ([#1886](https://github.com/aws-powertools/powertools-lambda-python/issues/1886))
+* **deps-dev:** bump types-requests from 2.28.11.8 to 2.28.11.12 ([#1906](https://github.com/aws-powertools/powertools-lambda-python/issues/1906))
+* **deps-dev:** bump pytest-xdist from 3.1.0 to 3.2.0 ([#1905](https://github.com/aws-powertools/powertools-lambda-python/issues/1905))
+* **deps-dev:** bump aws-cdk-lib from 2.63.2 to 2.64.0 ([#1918](https://github.com/aws-powertools/powertools-lambda-python/issues/1918))
+* **deps-dev:** bump mkdocs-material from 9.0.11 to 9.0.12 ([#1919](https://github.com/aws-powertools/powertools-lambda-python/issues/1919))
+* **deps-dev:** bump mkdocs-material from 9.0.10 to 9.0.11 ([#1896](https://github.com/aws-powertools/powertools-lambda-python/issues/1896))
+* **deps-dev:** bump mypy-boto3-appconfig from 1.26.0.post1 to 1.26.63 ([#1895](https://github.com/aws-powertools/powertools-lambda-python/issues/1895))
+* **deps-dev:** bump mypy-boto3-s3 from 1.26.58 to 1.26.62 ([#1889](https://github.com/aws-powertools/powertools-lambda-python/issues/1889))
+* **deps-dev:** bump mkdocs-material from 9.0.9 to 9.0.10 ([#1888](https://github.com/aws-powertools/powertools-lambda-python/issues/1888))
+* **deps-dev:** bump aws-cdk-lib from 2.62.2 to 2.63.0 ([#1887](https://github.com/aws-powertools/powertools-lambda-python/issues/1887))
+* **maintainers:** fix release workflow rename
+* **pypi:** add new links to Pypi package homepage ([#1912](https://github.com/aws-powertools/powertools-lambda-python/issues/1912))
+
+
+<a name="v2.7.1"></a>
+## [v2.7.1] - 2023-02-01
+## Bug Fixes
+
+* parallel_run should fail when e2e tests fail
+* bump aws-cdk version
+* **ci:** scope e2e tests by python version
+* **ci:** add auth to API HTTP Gateway and Lambda Function Url ([#1882](https://github.com/aws-powertools/powertools-lambda-python/issues/1882))
+* **license:** correction to MIT + MIT-0 (no proprietary anymore) ([#1883](https://github.com/aws-powertools/powertools-lambda-python/issues/1883))
+* **license:** add MIT-0 license header ([#1871](https://github.com/aws-powertools/powertools-lambda-python/issues/1871))
+* **tests:** make logs fetching more robust ([#1878](https://github.com/aws-powertools/powertools-lambda-python/issues/1878))
+* **tests:** remove custom workers
+* **tests:** make sure multiple e2e tests run concurrently ([#1861](https://github.com/aws-powertools/powertools-lambda-python/issues/1861))
+
+## Documentation
+
+* **event-source:** fix incorrect method in example CloudWatch Logs ([#1857](https://github.com/aws-powertools/powertools-lambda-python/issues/1857))
+* **homepage:** add banner for end-of-support v1 ([#1879](https://github.com/aws-powertools/powertools-lambda-python/issues/1879))
+* **parameters:** snippets split, improved, and lint ([#1564](https://github.com/aws-powertools/powertools-lambda-python/issues/1564))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* **deps:** bump docker/setup-buildx-action from 2.0.0 to 2.4.0 ([#1873](https://github.com/aws-powertools/powertools-lambda-python/issues/1873))
+* **deps:** bump dependabot/fetch-metadata from 1.3.5 to 1.3.6 ([#1855](https://github.com/aws-powertools/powertools-lambda-python/issues/1855))
+* **deps-dev:** bump mypy-boto3-s3 from 1.26.0.post1 to 1.26.58 ([#1868](https://github.com/aws-powertools/powertools-lambda-python/issues/1868))
+* **deps-dev:** bump isort from 5.11.4 to 5.11.5 ([#1875](https://github.com/aws-powertools/powertools-lambda-python/issues/1875))
+* **deps-dev:** bump aws-cdk-lib from 2.62.1 to 2.62.2 ([#1869](https://github.com/aws-powertools/powertools-lambda-python/issues/1869))
+* **deps-dev:** bump mkdocs-material from 9.0.6 to 9.0.8 ([#1874](https://github.com/aws-powertools/powertools-lambda-python/issues/1874))
+* **deps-dev:** bump aws-cdk-lib from 2.62.0 to 2.62.1 ([#1866](https://github.com/aws-powertools/powertools-lambda-python/issues/1866))
+* **deps-dev:** bump mypy-boto3-cloudformation from 1.26.35.post1 to 1.26.57 ([#1865](https://github.com/aws-powertools/powertools-lambda-python/issues/1865))
+* **deps-dev:** bump coverage from 7.0.5 to 7.1.0 ([#1862](https://github.com/aws-powertools/powertools-lambda-python/issues/1862))
+* **deps-dev:** bump aws-cdk-lib from 2.61.1 to 2.62.0 ([#1863](https://github.com/aws-powertools/powertools-lambda-python/issues/1863))
+* **deps-dev:** bump flake8-bugbear from 22.12.6 to 23.1.20 ([#1854](https://github.com/aws-powertools/powertools-lambda-python/issues/1854))
+* **deps-dev:** bump mypy-boto3-lambda from 1.26.49 to 1.26.55 ([#1856](https://github.com/aws-powertools/powertools-lambda-python/issues/1856))
+
+## Reverts
+* fix(tests): remove custom workers
+
+
+<a name="v2.7.0"></a>
+## [v2.7.0] - 2023-01-24
+## Bug Fixes
+
+* git-chlg docker image is broken
+
+## Features
+
+* **feature_flags:** Add Time based feature flags actions ([#1846](https://github.com/aws-powertools/powertools-lambda-python/issues/1846))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* **deps:** bump peaceiris/actions-gh-pages from 3.9.1 to 3.9.2 ([#1841](https://github.com/aws-powertools/powertools-lambda-python/issues/1841))
+* **deps:** bump future from 0.18.2 to 0.18.3 ([#1836](https://github.com/aws-powertools/powertools-lambda-python/issues/1836))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 2.0.4 to 2.0.5 ([#1837](https://github.com/aws-powertools/powertools-lambda-python/issues/1837))
+* **deps-dev:** bump mkdocs-material from 9.0.4 to 9.0.5 ([#1840](https://github.com/aws-powertools/powertools-lambda-python/issues/1840))
+* **deps-dev:** bump types-requests from 2.28.11.7 to 2.28.11.8 ([#1843](https://github.com/aws-powertools/powertools-lambda-python/issues/1843))
+* **deps-dev:** bump mypy-boto3-cloudwatch from 1.26.30 to 1.26.52 ([#1847](https://github.com/aws-powertools/powertools-lambda-python/issues/1847))
+* **deps-dev:** bump pytest from 7.2.0 to 7.2.1 ([#1838](https://github.com/aws-powertools/powertools-lambda-python/issues/1838))
+* **deps-dev:** bump aws-cdk-lib from 2.60.0 to 2.61.1 ([#1849](https://github.com/aws-powertools/powertools-lambda-python/issues/1849))
+* **deps-dev:** bump mypy-boto3-logs from 1.26.49 to 1.26.53 ([#1850](https://github.com/aws-powertools/powertools-lambda-python/issues/1850))
+* **deps-dev:** bump mkdocs-material from 9.0.5 to 9.0.6 ([#1851](https://github.com/aws-powertools/powertools-lambda-python/issues/1851))
+* **deps-dev:** bump mkdocs-material from 9.0.3 to 9.0.4 ([#1833](https://github.com/aws-powertools/powertools-lambda-python/issues/1833))
+* **deps-dev:** bump mypy-boto3-logs from 1.26.43 to 1.26.49 ([#1834](https://github.com/aws-powertools/powertools-lambda-python/issues/1834))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.26.40 to 1.26.49 ([#1835](https://github.com/aws-powertools/powertools-lambda-python/issues/1835))
+* **deps-dev:** bump mypy-boto3-lambda from 1.26.18 to 1.26.49 ([#1832](https://github.com/aws-powertools/powertools-lambda-python/issues/1832))
+* **deps-dev:** bump aws-cdk-lib from 2.59.0 to 2.60.0 ([#1831](https://github.com/aws-powertools/powertools-lambda-python/issues/1831))
+
+
+<a name="v2.6.0"></a>
+## [v2.6.0] - 2023-01-12
+## Bug Fixes
+
+* **api_gateway:** fixed custom metrics issue when using debug mode ([#1827](https://github.com/aws-powertools/powertools-lambda-python/issues/1827))
+
+## Documentation
+
+* **logger:** fix incorrect field names in example structured logs ([#1830](https://github.com/aws-powertools/powertools-lambda-python/issues/1830))
+* **logger:** Add warning of uncaught exceptions ([#1826](https://github.com/aws-powertools/powertools-lambda-python/issues/1826))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* **deps:** bump pydantic from 1.10.2 to 1.10.4 ([#1817](https://github.com/aws-powertools/powertools-lambda-python/issues/1817))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 2.0.1 to 2.0.3 ([#1801](https://github.com/aws-powertools/powertools-lambda-python/issues/1801))
+* **deps:** bump release-drafter/release-drafter from 5.21.1 to 5.22.0 ([#1802](https://github.com/aws-powertools/powertools-lambda-python/issues/1802))
+* **deps:** bump gitpython from 3.1.29 to 3.1.30 ([#1812](https://github.com/aws-powertools/powertools-lambda-python/issues/1812))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 2.0.3 to 2.0.4 ([#1821](https://github.com/aws-powertools/powertools-lambda-python/issues/1821))
+* **deps:** bump peaceiris/actions-gh-pages from 3.9.0 to 3.9.1 ([#1814](https://github.com/aws-powertools/powertools-lambda-python/issues/1814))
+* **deps-dev:** bump mkdocs-material from 8.5.11 to 9.0.2 ([#1808](https://github.com/aws-powertools/powertools-lambda-python/issues/1808))
+* **deps-dev:** bump mypy-boto3-ssm from 1.26.11.post1 to 1.26.43 ([#1819](https://github.com/aws-powertools/powertools-lambda-python/issues/1819))
+* **deps-dev:** bump mypy-boto3-logs from 1.26.27 to 1.26.43 ([#1820](https://github.com/aws-powertools/powertools-lambda-python/issues/1820))
+* **deps-dev:** bump filelock from 3.8.2 to 3.9.0 ([#1816](https://github.com/aws-powertools/powertools-lambda-python/issues/1816))
+* **deps-dev:** bump mypy-boto3-cloudformation from 1.26.11.post1 to 1.26.35.post1 ([#1818](https://github.com/aws-powertools/powertools-lambda-python/issues/1818))
+* **deps-dev:** bump ijson from 3.1.4 to 3.2.0.post0 ([#1815](https://github.com/aws-powertools/powertools-lambda-python/issues/1815))
+* **deps-dev:** bump coverage from 6.5.0 to 7.0.3 ([#1806](https://github.com/aws-powertools/powertools-lambda-python/issues/1806))
+* **deps-dev:** bump flake8-builtins from 2.0.1 to 2.1.0 ([#1799](https://github.com/aws-powertools/powertools-lambda-python/issues/1799))
+* **deps-dev:** bump coverage from 7.0.3 to 7.0.4 ([#1822](https://github.com/aws-powertools/powertools-lambda-python/issues/1822))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.26.12 to 1.26.40 ([#1811](https://github.com/aws-powertools/powertools-lambda-python/issues/1811))
+* **deps-dev:** bump isort from 5.11.3 to 5.11.4 ([#1809](https://github.com/aws-powertools/powertools-lambda-python/issues/1809))
+* **deps-dev:** bump aws-cdk-lib from 2.55.1 to 2.59.0 ([#1810](https://github.com/aws-powertools/powertools-lambda-python/issues/1810))
+* **deps-dev:** bump importlib-metadata from 5.1.0 to 6.0.0 ([#1804](https://github.com/aws-powertools/powertools-lambda-python/issues/1804))
+* **deps-dev:** bump mkdocs-material from 9.0.2 to 9.0.3 ([#1823](https://github.com/aws-powertools/powertools-lambda-python/issues/1823))
+* **deps-dev:** bump black from 22.10.0 to 22.12.0 ([#1770](https://github.com/aws-powertools/powertools-lambda-python/issues/1770))
+* **deps-dev:** bump flake8-black from 0.3.5 to 0.3.6 ([#1792](https://github.com/aws-powertools/powertools-lambda-python/issues/1792))
+* **deps-dev:** bump coverage from 7.0.4 to 7.0.5 ([#1829](https://github.com/aws-powertools/powertools-lambda-python/issues/1829))
+* **deps-dev:** bump types-requests from 2.28.11.5 to 2.28.11.7 ([#1795](https://github.com/aws-powertools/powertools-lambda-python/issues/1795))
+
+
+<a name="v2.5.0"></a>
+## [v2.5.0] - 2022-12-21
+## Bug Fixes
+
+* **event_handlers:** omit explicit None HTTP header values ([#1793](https://github.com/aws-powertools/powertools-lambda-python/issues/1793))
+
+## Documentation
+
+* **idempotency:** fix, improve, and increase visibility for batch integration ([#1776](https://github.com/aws-powertools/powertools-lambda-python/issues/1776))
+* **validation:** fix broken link; enrich built-in jmespath links ([#1777](https://github.com/aws-powertools/powertools-lambda-python/issues/1777))
+
+## Features
+
+* **logger:** unwrap event from common models if asked to log ([#1778](https://github.com/aws-powertools/powertools-lambda-python/issues/1778))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* **common:** reusable function to extract event from models
+* **deps:** bump certifi from 2022.9.24 to 2022.12.7 ([#1768](https://github.com/aws-powertools/powertools-lambda-python/issues/1768))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 1.4.0 to 2.0.1 ([#1752](https://github.com/aws-powertools/powertools-lambda-python/issues/1752))
+* **deps:** bump zgosalvez/github-actions-ensure-sha-pinned-actions from 1.3.0 to 1.4.0 ([#1749](https://github.com/aws-powertools/powertools-lambda-python/issues/1749))
+* **deps-dev:** bump pytest-asyncio from 0.20.2 to 0.20.3 ([#1767](https://github.com/aws-powertools/powertools-lambda-python/issues/1767))
+* **deps-dev:** bump mypy-boto3-cloudwatch from 1.26.0.post1 to 1.26.17 ([#1753](https://github.com/aws-powertools/powertools-lambda-python/issues/1753))
+* **deps-dev:** bump isort from 5.10.1 to 5.11.2 ([#1782](https://github.com/aws-powertools/powertools-lambda-python/issues/1782))
+* **deps-dev:** bump mypy-boto3-cloudwatch from 1.26.17 to 1.26.30 ([#1785](https://github.com/aws-powertools/powertools-lambda-python/issues/1785))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.26.13.post16 to 1.26.24 ([#1765](https://github.com/aws-powertools/powertools-lambda-python/issues/1765))
+* **deps-dev:** bump aws-cdk-lib from 2.54.0 to 2.55.1 ([#1787](https://github.com/aws-powertools/powertools-lambda-python/issues/1787))
+* **deps-dev:** bump aws-cdk-lib from 2.53.0 to 2.54.0 ([#1764](https://github.com/aws-powertools/powertools-lambda-python/issues/1764))
+* **deps-dev:** bump flake8-bugbear from 22.10.27 to 22.12.6 ([#1760](https://github.com/aws-powertools/powertools-lambda-python/issues/1760))
+* **deps-dev:** bump filelock from 3.8.0 to 3.8.2 ([#1759](https://github.com/aws-powertools/powertools-lambda-python/issues/1759))
+* **deps-dev:** bump pytest-xdist from 3.0.2 to 3.1.0 ([#1758](https://github.com/aws-powertools/powertools-lambda-python/issues/1758))
+* **deps-dev:** bump mkdocs-material from 8.5.10 to 8.5.11 ([#1756](https://github.com/aws-powertools/powertools-lambda-python/issues/1756))
+* **deps-dev:** bump importlib-metadata from 4.13.0 to 5.1.0 ([#1750](https://github.com/aws-powertools/powertools-lambda-python/issues/1750))
+* **deps-dev:** bump isort from 5.11.2 to 5.11.3 ([#1788](https://github.com/aws-powertools/powertools-lambda-python/issues/1788))
+* **deps-dev:** bump flake8-black from 0.3.3 to 0.3.5 ([#1738](https://github.com/aws-powertools/powertools-lambda-python/issues/1738))
+* **deps-dev:** bump mypy-boto3-logs from 1.26.17 to 1.26.27 ([#1775](https://github.com/aws-powertools/powertools-lambda-python/issues/1775))
+* **tests:** move shared_functions to unit tests
+
+
+<a name="v2.4.0"></a>
+## [v2.4.0] - 2022-11-24
+## Bug Fixes
+
+* **ci:** use gh-pages env as official docs are wrong
+* **ci:** api docs path
+
+## Documentation
+
+* **idempotency:** fix register_lambda_context order ([#1747](https://github.com/aws-powertools/powertools-lambda-python/issues/1747))
+* **streaming:** fix leftover newline
+
+## Features
+
+* **streaming:** add new s3 streaming utility ([#1719](https://github.com/aws-powertools/powertools-lambda-python/issues/1719))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* **ci:** re-create versioned API docs for new pages deployment
+* **ci:** re-create versioned API docs for new pages deployment
+* **ci:** increase permission in parent job for docs publishing
+* **ci:** attempt gh-pages deployment via beta route
+* **deps:** bump aws-xray-sdk from 2.10.0 to 2.11.0 ([#1730](https://github.com/aws-powertools/powertools-lambda-python/issues/1730))
+* **deps-dev:** bump mypy-boto3-lambda from 1.26.0.post1 to 1.26.12 ([#1742](https://github.com/aws-powertools/powertools-lambda-python/issues/1742))
+* **deps-dev:** bump mypy-boto3-cloudformation from 1.26.0.post1 to 1.26.11.post1 ([#1746](https://github.com/aws-powertools/powertools-lambda-python/issues/1746))
+* **deps-dev:** bump aws-cdk-lib from 2.50.0 to 2.51.1 ([#1741](https://github.com/aws-powertools/powertools-lambda-python/issues/1741))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.26.0.post1 to 1.26.13.post16 ([#1743](https://github.com/aws-powertools/powertools-lambda-python/issues/1743))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.26.0.post1 to 1.26.12 ([#1744](https://github.com/aws-powertools/powertools-lambda-python/issues/1744))
+* **deps-dev:** bump mypy-boto3-ssm from 1.26.4 to 1.26.11.post1 ([#1740](https://github.com/aws-powertools/powertools-lambda-python/issues/1740))
+* **deps-dev:** bump types-requests from 2.28.11.4 to 2.28.11.5 ([#1729](https://github.com/aws-powertools/powertools-lambda-python/issues/1729))
+* **deps-dev:** bump mkdocs-material from 8.5.9 to 8.5.10 ([#1731](https://github.com/aws-powertools/powertools-lambda-python/issues/1731))
+* **governance:** remove markdown rendering from docs issue template
+
+## Regression
+
+* **ci:** new gh-pages beta doesn't work either; reverting as gh-pages is disrupted
+
+
+<a name="v2.3.1"></a>
+## [v2.3.1] - 2022-11-21
+## Bug Fixes
+
+* **apigateway:** support dynamic routes with equal sign (RFC3986) ([#1737](https://github.com/aws-powertools/powertools-lambda-python/issues/1737))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* test build layer hardware to 8 core
+* **deps-dev:** bump mypy-boto3-xray from 1.26.9 to 1.26.11.post1 ([#1734](https://github.com/aws-powertools/powertools-lambda-python/issues/1734))
+
+
+<a name="v2.3.0"></a>
+## [v2.3.0] - 2022-11-17
+## Bug Fixes
+
+* **apigateway:** support nested router decorators ([#1709](https://github.com/aws-powertools/powertools-lambda-python/issues/1709))
+* **ci:** increase permission to allow version sync back to repo
+* **ci:** disable pre-commit hook download from version bump
+* **ci:** setup git client earlier to prevent dirty stash error
+* **parameters:** get_secret correctly return SecretBinary value ([#1717](https://github.com/aws-powertools/powertools-lambda-python/issues/1717))
+
+## Documentation
+
+* project name consistency
+* **apigateway:** add all resolvers in testing your code section for accuracy ([#1688](https://github.com/aws-powertools/powertools-lambda-python/issues/1688))
+* **examples:** linting unnecessary whitespace
+* **homepage:** update default value for `POWERTOOLS_DEV` ([#1695](https://github.com/aws-powertools/powertools-lambda-python/issues/1695))
+* **idempotency:** add missing Lambda Context; note on thread-safe ([#1732](https://github.com/aws-powertools/powertools-lambda-python/issues/1732))
+* **logger:** update uncaught exception message value
+
+## Features
+
+* **apigateway:** multiple exceptions in exception_handler ([#1707](https://github.com/aws-powertools/powertools-lambda-python/issues/1707))
+* **event_sources:** extract CloudWatch Logs in Kinesis streams ([#1710](https://github.com/aws-powertools/powertools-lambda-python/issues/1710))
+* **logger:** log uncaught exceptions via system's exception hook ([#1727](https://github.com/aws-powertools/powertools-lambda-python/issues/1727))
+* **parser:** export Pydantic.errors through escape hatch ([#1728](https://github.com/aws-powertools/powertools-lambda-python/issues/1728))
+* **parser:** extract CloudWatch Logs in Kinesis streams ([#1726](https://github.com/aws-powertools/powertools-lambda-python/issues/1726))
+
+## Maintenance
+
+* apigw test event wrongly set with base64
+* update v2 layer ARN on documentation
+* **ci:** revert custom hw for E2E due to lack of hw
+* **ci:** try bigger hardware for e2e test
+* **ci:** uncomment test pypi, fix version bump sync
+* **ci:** limit to src only to prevent dependabot failures
+* **ci:** use new custom hw for E2E
+* **ci:** prevent dependabot updates to trigger E2E
+* **ci:** bump hardware for build steps
+* **deps:** bump dependabot/fetch-metadata from 1.3.4 to 1.3.5 ([#1689](https://github.com/aws-powertools/powertools-lambda-python/issues/1689))
+* **deps-dev:** bump types-requests from 2.28.11.3 to 2.28.11.4 ([#1701](https://github.com/aws-powertools/powertools-lambda-python/issues/1701))
+* **deps-dev:** bump mypy-boto3-s3 from 1.25.0 to 1.26.0.post1 ([#1716](https://github.com/aws-powertools/powertools-lambda-python/issues/1716))
+* **deps-dev:** bump mypy-boto3-appconfigdata from 1.25.0 to 1.26.0.post1 ([#1704](https://github.com/aws-powertools/powertools-lambda-python/issues/1704))
+* **deps-dev:** bump mypy-boto3-xray from 1.25.0 to 1.26.0.post1 ([#1703](https://github.com/aws-powertools/powertools-lambda-python/issues/1703))
+* **deps-dev:** bump mypy-boto3-cloudwatch from 1.25.0 to 1.26.0.post1 ([#1714](https://github.com/aws-powertools/powertools-lambda-python/issues/1714))
+* **deps-dev:** bump flake8-bugbear from 22.10.25 to 22.10.27 ([#1665](https://github.com/aws-powertools/powertools-lambda-python/issues/1665))
+* **deps-dev:** bump mypy-boto3-lambda from 1.25.0 to 1.26.0.post1 ([#1705](https://github.com/aws-powertools/powertools-lambda-python/issues/1705))
+* **deps-dev:** bump mypy-boto3-xray from 1.26.0.post1 to 1.26.9 ([#1720](https://github.com/aws-powertools/powertools-lambda-python/issues/1720))
+* **deps-dev:** bump mypy-boto3-logs from 1.25.0 to 1.26.3 ([#1702](https://github.com/aws-powertools/powertools-lambda-python/issues/1702))
+* **deps-dev:** bump mypy-boto3-ssm from 1.26.0.post1 to 1.26.4 ([#1721](https://github.com/aws-powertools/powertools-lambda-python/issues/1721))
+* **deps-dev:** bump mypy-boto3-appconfig from 1.25.0 to 1.26.0.post1 ([#1722](https://github.com/aws-powertools/powertools-lambda-python/issues/1722))
+* **deps-dev:** bump pytest-asyncio from 0.20.1 to 0.20.2 ([#1723](https://github.com/aws-powertools/powertools-lambda-python/issues/1723))
+* **deps-dev:** bump flake8-builtins from 2.0.0 to 2.0.1 ([#1715](https://github.com/aws-powertools/powertools-lambda-python/issues/1715))
+* **deps-dev:** bump pytest-xdist from 2.5.0 to 3.0.2 ([#1655](https://github.com/aws-powertools/powertools-lambda-python/issues/1655))
+* **deps-dev:** bump mkdocs-material from 8.5.7 to 8.5.9 ([#1697](https://github.com/aws-powertools/powertools-lambda-python/issues/1697))
+* **deps-dev:** bump flake8-comprehensions from 3.10.0 to 3.10.1 ([#1699](https://github.com/aws-powertools/powertools-lambda-python/issues/1699))
+* **deps-dev:** bump types-requests from 2.28.11.2 to 2.28.11.3 ([#1698](https://github.com/aws-powertools/powertools-lambda-python/issues/1698))
+* **deps-dev:** bump pytest-benchmark from 3.4.1 to 4.0.0 ([#1659](https://github.com/aws-powertools/powertools-lambda-python/issues/1659))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.25.0 to 1.26.0.post1 ([#1691](https://github.com/aws-powertools/powertools-lambda-python/issues/1691))
+* **deps-dev:** bump mypy-boto3-ssm from 1.25.0 to 1.26.0.post1 ([#1690](https://github.com/aws-powertools/powertools-lambda-python/issues/1690))
+* **logger:** uncaught exception to use exception value as message
+* **logger:** overload inject_lambda_context with generics ([#1583](https://github.com/aws-powertools/powertools-lambda-python/issues/1583))
+
+
+<a name="v2.2.0"></a>
+## [v2.2.0] - 2022-11-07
+## Documentation
+
+* **homepage:** remove v1 layer limitation on pydantic not being included
+* **tracer:** add note on why X-Ray SDK over ADOT closes [#1675](https://github.com/aws-powertools/powertools-lambda-python/issues/1675)
+
+## Features
+
+* **metrics:** add EphemeralMetrics as a non-singleton option ([#1676](https://github.com/aws-powertools/powertools-lambda-python/issues/1676))
+* **parameters:** add get_parameters_by_name for SSM params in distinct paths ([#1678](https://github.com/aws-powertools/powertools-lambda-python/issues/1678))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* **deps:** bump package to 2.2.0
+* **deps-dev:** bump aws-cdk-lib from 2.49.0 to 2.50.0 ([#1683](https://github.com/aws-powertools/powertools-lambda-python/issues/1683))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.25.0 to 1.26.0.post1 ([#1682](https://github.com/aws-powertools/powertools-lambda-python/issues/1682))
+* **deps-dev:** bump mypy-boto3-cloudformation from 1.25.0 to 1.26.0.post1 ([#1679](https://github.com/aws-powertools/powertools-lambda-python/issues/1679))
+* **package:** correct pyproject version manually
+
+
+<a name="v2.1.0"></a>
+## [v2.1.0] - 2022-10-31
+## Bug Fixes
+
+* **ci:** linting issues after flake8-blackbear,mypy upgrades
+* **deps:** update build system to poetry-core ([#1651](https://github.com/aws-powertools/powertools-lambda-python/issues/1651))
+* **idempotency:** idempotent_function should support standalone falsy values ([#1669](https://github.com/aws-powertools/powertools-lambda-python/issues/1669))
+* **logger:** fix unknown attributes being ignored by mypy ([#1670](https://github.com/aws-powertools/powertools-lambda-python/issues/1670))
+
+## Documentation
+
+* **community:** fix social handlers for Ran ([#1654](https://github.com/aws-powertools/powertools-lambda-python/issues/1654))
+* **community:** fix twitch parent domain for embedded video
+* **homepage:** remove 3.6 and add hero image
+* **homepage:** add Pulumi code example ([#1652](https://github.com/aws-powertools/powertools-lambda-python/issues/1652))
+* **index:** fold support us banner
+* **index:** add quotes to pip for zsh customers
+* **install:** address early v2 feedback on installation and project support
+* **we-made-this:** new community content section ([#1650](https://github.com/aws-powertools/powertools-lambda-python/issues/1650))
+
+## Features
+
+* **layers:** add layer balancer script ([#1643](https://github.com/aws-powertools/powertools-lambda-python/issues/1643))
+* **logger:** add use_rfc3339 and auto-complete formatter opts in Logger ([#1662](https://github.com/aws-powertools/powertools-lambda-python/issues/1662))
+* **logger:** accept arbitrary keyword=value for ephemeral metadata ([#1658](https://github.com/aws-powertools/powertools-lambda-python/issues/1658))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* **ci:** fix typo on version description
+* **deps:** bump peaceiris/actions-gh-pages from 3.8.0 to 3.9.0 ([#1649](https://github.com/aws-powertools/powertools-lambda-python/issues/1649))
+* **deps:** bump docker/setup-qemu-action from 2.0.0 to 2.1.0 ([#1627](https://github.com/aws-powertools/powertools-lambda-python/issues/1627))
+* **deps-dev:** bump aws-cdk-lib from 2.47.0 to 2.48.0 ([#1664](https://github.com/aws-powertools/powertools-lambda-python/issues/1664))
+* **deps-dev:** bump flake8-variables-names from 0.0.4 to 0.0.5 ([#1628](https://github.com/aws-powertools/powertools-lambda-python/issues/1628))
+* **deps-dev:** bump pytest-asyncio from 0.16.0 to 0.20.1 ([#1635](https://github.com/aws-powertools/powertools-lambda-python/issues/1635))
+* **deps-dev:** bump aws-cdk-lib from 2.48.0 to 2.49.0 ([#1671](https://github.com/aws-powertools/powertools-lambda-python/issues/1671))
+* **docs:** remove v2 banner on top of the docs
+* **governance:** remove 'area/' from PR labels
+
+
+<a name="v2.0.0"></a>
+## [v2.0.0] - 2022-10-24
+## Bug Fixes
+
+* lock dependencies
+* mypy errors
+* lint files
+* **ci:** temporarly remove pypi test deployment
+* **ci:** use docker driver on buildx
+* **ci:** new artifact path, sed gnu/linux syntax, and pypi test
+* **ci:** secret and OIDC inheritance in nested children workflow
+* **ci:** build without buildkit
+* **ci:** fix arm64 layer builds
+* **ci:** remove v2 suffix from SAR apps ([#1633](https://github.com/aws-powertools/powertools-lambda-python/issues/1633))
+* **ci:** workflow should use npx for CDK CLI
+* **parser:** S3Model Object Deleted omits size and eTag attr ([#1638](https://github.com/aws-powertools/powertools-lambda-python/issues/1638))
+
+## Code Refactoring
+
+* **apigateway:** remove POWERTOOLS_EVENT_HANDLER_DEBUG env var ([#1620](https://github.com/aws-powertools/powertools-lambda-python/issues/1620))
+* **batch:** remove legacy sqs_batch_processor ([#1492](https://github.com/aws-powertools/powertools-lambda-python/issues/1492))
+* **e2e:** make table name dynamic
+* **e2e:** fix idempotency typing
+
+## Documentation
+
+* **batch:** remove legacy reference to sqs processor
+* **homepage:** note about v2 version
+* **homepage:** auto-update Layer ARN on every release ([#1610](https://github.com/aws-powertools/powertools-lambda-python/issues/1610))
+* **roadmap:** refresh roadmap post-v2 launch
+* **roadmap:** include observability provider and lambda layer themes before v2
+* **upgrade_guide:** add latest changes and quick summary ([#1623](https://github.com/aws-powertools/powertools-lambda-python/issues/1623))
+* **v2:** document optional dependencies and local dev ([#1574](https://github.com/aws-powertools/powertools-lambda-python/issues/1574))
+
+## Features
+
+* **apigateway:** ignore trailing slashes in routes (APIGatewayRestResolver) ([#1609](https://github.com/aws-powertools/powertools-lambda-python/issues/1609))
+* **ci:** release docs as alpha when doing a pre-release ([#1624](https://github.com/aws-powertools/powertools-lambda-python/issues/1624))
+* **data-classes:** replace AttributeValue in DynamoDBStreamEvent with deserialized Python values ([#1619](https://github.com/aws-powertools/powertools-lambda-python/issues/1619))
+* **data_classes:** add KinesisFirehoseEvent ([#1540](https://github.com/aws-powertools/powertools-lambda-python/issues/1540))
+* **event_handler:** improved support for headers and cookies in v2 ([#1455](https://github.com/aws-powertools/powertools-lambda-python/issues/1455))
+* **event_handler:** add cookies as 1st class citizen in v2 ([#1487](https://github.com/aws-powertools/powertools-lambda-python/issues/1487))
+* **idempotency:** support methods with the same name (ABCs) by including fully qualified name in v2 ([#1535](https://github.com/aws-powertools/powertools-lambda-python/issues/1535))
+* **layer:** publish SAR v2 via Github actions ([#1585](https://github.com/aws-powertools/powertools-lambda-python/issues/1585))
+* **layers:** add support for publishing v2 layer ([#1558](https://github.com/aws-powertools/powertools-lambda-python/issues/1558))
+* **parameters:** migrate AppConfig to new APIs due to API deprecation ([#1553](https://github.com/aws-powertools/powertools-lambda-python/issues/1553))
+* **tracer:** support methods with the same name (ABCs) by including fully qualified name in v2 ([#1486](https://github.com/aws-powertools/powertools-lambda-python/issues/1486))
+
+## Maintenance
+
+* update v2 layer ARN on documentation
+* update v2 layer ARN on documentation
+* update v2 layer ARN on documentation
+* update v2 layer ARN on documentation
+* merge v2 branch
+* bump pyproject version to 2.0
+* **ci:** make release process manual
+* **ci:** migrate E2E tests to CDK CLI and off Docker ([#1501](https://github.com/aws-powertools/powertools-lambda-python/issues/1501))
+* **ci:** remove v1 workflows ([#1617](https://github.com/aws-powertools/powertools-lambda-python/issues/1617))
+* **core:** expose modules in the Top-level package ([#1517](https://github.com/aws-powertools/powertools-lambda-python/issues/1517))
+* **dep:** add cfn-lint as a dev dependency; pre-commit ([#1612](https://github.com/aws-powertools/powertools-lambda-python/issues/1612))
+* **deps:** remove email-validator; use Str over EmailStr in SES model ([#1608](https://github.com/aws-powertools/powertools-lambda-python/issues/1608))
+* **deps:** bump release-drafter/release-drafter from 5.21.0 to 5.21.1 ([#1611](https://github.com/aws-powertools/powertools-lambda-python/issues/1611))
+* **deps:** lock importlib to 4.x
+* **deps-dev:** bump mypy-boto3-s3 from 1.24.76 to 1.24.94 ([#1622](https://github.com/aws-powertools/powertools-lambda-python/issues/1622))
+* **deps-dev:** bump aws-cdk-lib from 2.46.0 to 2.47.0 ([#1629](https://github.com/aws-powertools/powertools-lambda-python/issues/1629))
+* **layer:** bump to 1.31.1 (v39)
+
+
+<a name="v1.31.1"></a>
+## [v1.31.1] - 2022-10-14
+## Bug Fixes
+
+* **parser:** loose validation on SNS fields to support FIFO ([#1606](https://github.com/aws-powertools/powertools-lambda-python/issues/1606))
+
+## Documentation
+
+* **governance:** allow community to suggest feature content ([#1593](https://github.com/aws-powertools/powertools-lambda-python/issues/1593))
+* **governance:** new form to allow customers self-nominate as public reference ([#1589](https://github.com/aws-powertools/powertools-lambda-python/issues/1589))
+* **homepage:** include .NET powertools
+* **idempotency:** "persisntence" typo ([#1596](https://github.com/aws-powertools/powertools-lambda-python/issues/1596))
+* **logger:** fix typo. ([#1587](https://github.com/aws-powertools/powertools-lambda-python/issues/1587))
+
+## Maintenance
+
+* add dummy v2 sar deploy job
+* bump layer version to 38
+* **deps-dev:** bump mypy-boto3-ssm from 1.24.81 to 1.24.90 ([#1594](https://github.com/aws-powertools/powertools-lambda-python/issues/1594))
+* **deps-dev:** bump flake8-builtins from 1.5.3 to 2.0.0 ([#1582](https://github.com/aws-powertools/powertools-lambda-python/issues/1582))
+
+
+<a name="v1.31.0"></a>
+## [v1.31.0] - 2022-10-10
## Bug Fixes
+* **metrics:** ensure dimension_set is reused across instances (pointer) ([#1581](https://github.com/aws-powertools/powertools-lambda-python/issues/1581))
+
+## Documentation
+
+* **readme:** add lambda layer latest version badge
+
+## Features
+
+* **parser:** add KinesisFirehoseModel ([#1556](https://github.com/aws-powertools/powertools-lambda-python/issues/1556))
+
+## Maintenance
+
+* **deps-dev:** bump types-requests from 2.28.11.1 to 2.28.11.2 ([#1576](https://github.com/aws-powertools/powertools-lambda-python/issues/1576))
+* **deps-dev:** bump typing-extensions from 4.3.0 to 4.4.0 ([#1575](https://github.com/aws-powertools/powertools-lambda-python/issues/1575))
+* **layer:** remove unsused GetFunction permission for the canary
+* **layer:** bump to latest version 37
+
+
+<a name="v1.30.0"></a>
+## [v1.30.0] - 2022-10-05
+## Bug Fixes
+
+* **apigateway:** update Response class to require status_code only ([#1560](https://github.com/aws-powertools/powertools-lambda-python/issues/1560))
+* **ci:** integrate isort 5.0 with black to resolve conflicts
+* **event_sources:** implement Mapping protocol on DictWrapper for better interop with existing middlewares ([#1516](https://github.com/aws-powertools/powertools-lambda-python/issues/1516))
* **typing:** fix mypy error
-* **typing:** level arg in copy_config_to_registered_loggers ([#1534](https://github.com/awslabs/aws-lambda-powertools-python/issues/1534))
+* **typing:** level arg in copy_config_to_registered_loggers ([#1534](https://github.com/aws-powertools/powertools-lambda-python/issues/1534))
## Documentation
-* **parser:** add JSON string field extension example ([#1526](https://github.com/awslabs/aws-lambda-powertools-python/issues/1526))
+* **batch:** document the new lambda context feature
+* **homepage:** introduce POWERTOOLS_DEV env var ([#1569](https://github.com/aws-powertools/powertools-lambda-python/issues/1569))
+* **multiple:** fix highlighting after new isort/black integration
+* **parser:** add JSON string field extension example ([#1526](https://github.com/aws-powertools/powertools-lambda-python/issues/1526))
+
+## Features
+
+* **batch:** inject lambda_context if record handler signature accepts it ([#1561](https://github.com/aws-powertools/powertools-lambda-python/issues/1561))
+* **event-handler:** context support to share data between routers ([#1567](https://github.com/aws-powertools/powertools-lambda-python/issues/1567))
+* **logger:** introduce POWERTOOLS_DEBUG for internal debugging ([#1572](https://github.com/aws-powertools/powertools-lambda-python/issues/1572))
+* **logger:** include logger name attribute when copy_config_to_registered_logger is used ([#1568](https://github.com/aws-powertools/powertools-lambda-python/issues/1568))
+* **logger:** pretty-print JSON when POWERTOOLS_DEV is set ([#1548](https://github.com/aws-powertools/powertools-lambda-python/issues/1548))
## Maintenance
-* **deps:** bump fastjsonschema from 2.16.1 to 2.16.2 ([#1530](https://github.com/awslabs/aws-lambda-powertools-python/issues/1530))
-* **deps:** bump codecov/codecov-action from 3.1.0 to 3.1.1 ([#1529](https://github.com/awslabs/aws-lambda-powertools-python/issues/1529))
-* **deps:** bump actions/setup-python from 3 to 4 ([#1528](https://github.com/awslabs/aws-lambda-powertools-python/issues/1528))
-* **deps:** bump email-validator from 1.2.1 to 1.3.0 ([#1533](https://github.com/awslabs/aws-lambda-powertools-python/issues/1533))
-* **deps-dev:** bump mypy-boto3-ssm from 1.24.80 to 1.24.81 ([#1544](https://github.com/awslabs/aws-lambda-powertools-python/issues/1544))
-* **deps-dev:** bump mypy-boto3-s3 from 1.24.36.post1 to 1.24.76 ([#1531](https://github.com/awslabs/aws-lambda-powertools-python/issues/1531))
-* **deps-dev:** bump mkdocs-material from 8.5.1 to 8.5.3 ([#1532](https://github.com/awslabs/aws-lambda-powertools-python/issues/1532))
-* **deps-dev:** bump mypy-boto3-ssm from 1.24.69 to 1.24.80 ([#1542](https://github.com/awslabs/aws-lambda-powertools-python/issues/1542))
-* **deps-dev:** bump mako from 1.2.2 to 1.2.3 ([#1537](https://github.com/awslabs/aws-lambda-powertools-python/issues/1537))
-* **deps-dev:** bump types-requests from 2.28.10 to 2.28.11 ([#1538](https://github.com/awslabs/aws-lambda-powertools-python/issues/1538))
+* **dep:** bump pyproject to pypi sync
+* **deps:** bump fastjsonschema from 2.16.1 to 2.16.2 ([#1530](https://github.com/aws-powertools/powertools-lambda-python/issues/1530))
+* **deps:** bump actions/setup-python from 3 to 4 ([#1528](https://github.com/aws-powertools/powertools-lambda-python/issues/1528))
+* **deps:** bump codecov/codecov-action from 3.1.0 to 3.1.1 ([#1529](https://github.com/aws-powertools/powertools-lambda-python/issues/1529))
+* **deps:** bump dependabot/fetch-metadata from 1.3.3 to 1.3.4 ([#1565](https://github.com/aws-powertools/powertools-lambda-python/issues/1565))
+* **deps:** bump email-validator from 1.2.1 to 1.3.0 ([#1533](https://github.com/aws-powertools/powertools-lambda-python/issues/1533))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.24.54 to 1.24.83 ([#1557](https://github.com/aws-powertools/powertools-lambda-python/issues/1557))
+* **deps-dev:** bump mkdocs-material from 8.5.3 to 8.5.4 ([#1563](https://github.com/aws-powertools/powertools-lambda-python/issues/1563))
+* **deps-dev:** bump pytest-cov from 3.0.0 to 4.0.0 ([#1551](https://github.com/aws-powertools/powertools-lambda-python/issues/1551))
+* **deps-dev:** bump flake8-bugbear from 22.9.11 to 22.9.23 ([#1541](https://github.com/aws-powertools/powertools-lambda-python/issues/1541))
+* **deps-dev:** bump types-requests from 2.28.11 to 2.28.11.1 ([#1571](https://github.com/aws-powertools/powertools-lambda-python/issues/1571))
+* **deps-dev:** bump mypy-boto3-ssm from 1.24.69 to 1.24.80 ([#1542](https://github.com/aws-powertools/powertools-lambda-python/issues/1542))
+* **deps-dev:** bump mako from 1.2.2 to 1.2.3 ([#1537](https://github.com/aws-powertools/powertools-lambda-python/issues/1537))
+* **deps-dev:** bump types-requests from 2.28.10 to 2.28.11 ([#1538](https://github.com/aws-powertools/powertools-lambda-python/issues/1538))
+* **deps-dev:** bump mkdocs-material from 8.5.1 to 8.5.3 ([#1532](https://github.com/aws-powertools/powertools-lambda-python/issues/1532))
+* **deps-dev:** bump mypy-boto3-ssm from 1.24.80 to 1.24.81 ([#1544](https://github.com/aws-powertools/powertools-lambda-python/issues/1544))
+* **deps-dev:** bump mypy-boto3-s3 from 1.24.36.post1 to 1.24.76 ([#1531](https://github.com/aws-powertools/powertools-lambda-python/issues/1531))
* **docs:** bump layer version to 36 (1.29.2)
+* **layers:** add dummy v2 layer automation
+* **lint:** use new isort black integration
+* **multiple:** localize powertools_dev env logic and warning ([#1570](https://github.com/aws-powertools/powertools-lambda-python/issues/1570))
<a name="v1.29.2"></a>
## [v1.29.2] - 2022-09-19
## Bug Fixes
-* **deps:** bump dev dep mako version to address CVE-2022-40023 ([#1524](https://github.com/awslabs/aws-lambda-powertools-python/issues/1524))
+* **deps:** bump dev dep mako version to address CVE-2022-40023 ([#1524](https://github.com/aws-powertools/powertools-lambda-python/issues/1524))
## Maintenance
-* **deps:** bump release-drafter/release-drafter from 5.20.1 to 5.21.0 ([#1520](https://github.com/awslabs/aws-lambda-powertools-python/issues/1520))
-* **deps-dev:** bump mkdocs-material from 8.5.0 to 8.5.1 ([#1521](https://github.com/awslabs/aws-lambda-powertools-python/issues/1521))
-* **deps-dev:** bump mypy-boto3-dynamodb from 1.24.60 to 1.24.74 ([#1522](https://github.com/awslabs/aws-lambda-powertools-python/issues/1522))
+* **deps:** bump release-drafter/release-drafter from 5.20.1 to 5.21.0 ([#1520](https://github.com/aws-powertools/powertools-lambda-python/issues/1520))
+* **deps-dev:** bump mkdocs-material from 8.5.0 to 8.5.1 ([#1521](https://github.com/aws-powertools/powertools-lambda-python/issues/1521))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.24.60 to 1.24.74 ([#1522](https://github.com/aws-powertools/powertools-lambda-python/issues/1522))
<a name="v1.29.1"></a>
@@ -64,13 +5383,13 @@
## Features
* **ci:** add actionlint in pre-commit hook
-* **data-classes:** add KafkaEvent and KafkaEventRecord ([#1485](https://github.com/awslabs/aws-lambda-powertools-python/issues/1485))
-* **event_sources:** add CloudWatch dashboard custom widget event ([#1474](https://github.com/awslabs/aws-lambda-powertools-python/issues/1474))
-* **parser:** add KafkaMskEventModel and KafkaSelfManagedEventModel ([#1499](https://github.com/awslabs/aws-lambda-powertools-python/issues/1499))
+* **data-classes:** add KafkaEvent and KafkaEventRecord ([#1485](https://github.com/aws-powertools/powertools-lambda-python/issues/1485))
+* **event_sources:** add CloudWatch dashboard custom widget event ([#1474](https://github.com/aws-powertools/powertools-lambda-python/issues/1474))
+* **parser:** add KafkaMskEventModel and KafkaSelfManagedEventModel ([#1499](https://github.com/aws-powertools/powertools-lambda-python/issues/1499))
## Maintenance
-* **ci:** add workflow to suggest splitting large PRs ([#1480](https://github.com/awslabs/aws-lambda-powertools-python/issues/1480))
+* **ci:** add workflow to suggest splitting large PRs ([#1480](https://github.com/aws-powertools/powertools-lambda-python/issues/1480))
* **ci:** remove unused and undeclared OS matrix env
* **ci:** disable v2 docs
* **ci:** limit E2E workflow run for source code change
@@ -81,28 +5400,28 @@
* **ci:** create adhoc docs workflow for v2
* **ci:** remove dangling debug step
* **ci:** create docs workflow for v2
-* **ci:** create reusable docs publishing workflow ([#1482](https://github.com/awslabs/aws-lambda-powertools-python/issues/1482))
+* **ci:** create reusable docs publishing workflow ([#1482](https://github.com/aws-powertools/powertools-lambda-python/issues/1482))
* **ci:** format comment on comment_large_pr script
* **ci:** add note for state persistence on comment_large_pr
* **ci:** destructure assignment on comment_large_pr
* **ci:** record pr details upon labeling
-* **ci:** add linter for GitHub Actions as pre-commit hook ([#1479](https://github.com/awslabs/aws-lambda-powertools-python/issues/1479))
+* **ci:** add linter for GitHub Actions as pre-commit hook ([#1479](https://github.com/aws-powertools/powertools-lambda-python/issues/1479))
* **ci:** enable ci checks for v2
-* **deps-dev:** bump black from 21.12b0 to 22.8.0 ([#1515](https://github.com/awslabs/aws-lambda-powertools-python/issues/1515))
-* **deps-dev:** bump mypy-boto3-dynamodb from 1.24.55.post1 to 1.24.60 ([#1481](https://github.com/awslabs/aws-lambda-powertools-python/issues/1481))
-* **deps-dev:** bump mypy-boto3-dynamodb from 1.24.55.post1 to 1.24.60 ([#306](https://github.com/awslabs/aws-lambda-powertools-python/issues/306))
-* **deps-dev:** bump mkdocs-material from 8.4.1 to 8.4.2 ([#1483](https://github.com/awslabs/aws-lambda-powertools-python/issues/1483))
+* **deps-dev:** bump black from 21.12b0 to 22.8.0 ([#1515](https://github.com/aws-powertools/powertools-lambda-python/issues/1515))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.24.55.post1 to 1.24.60 ([#1481](https://github.com/aws-powertools/powertools-lambda-python/issues/1481))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.24.55.post1 to 1.24.60 ([#306](https://github.com/aws-powertools/powertools-lambda-python/issues/306))
+* **deps-dev:** bump mkdocs-material from 8.4.1 to 8.4.2 ([#1483](https://github.com/aws-powertools/powertools-lambda-python/issues/1483))
* **deps-dev:** revert to v1.28.0 dependencies
-* **deps-dev:** bump mkdocs-material from 8.4.4 to 8.5.0 ([#1514](https://github.com/awslabs/aws-lambda-powertools-python/issues/1514))
+* **deps-dev:** bump mkdocs-material from 8.4.4 to 8.5.0 ([#1514](https://github.com/aws-powertools/powertools-lambda-python/issues/1514))
* **maintainers:** update release workflow link
-* **maintenance:** add discord link to first PR and first issue ([#1493](https://github.com/awslabs/aws-lambda-powertools-python/issues/1493))
+* **maintenance:** add discord link to first PR and first issue ([#1493](https://github.com/aws-powertools/powertools-lambda-python/issues/1493))
<a name="v1.28.0"></a>
## [v1.28.0] - 2022-08-25
## Bug Fixes
-* **ci:** calculate parallel jobs based on infrastructure needs ([#1475](https://github.com/awslabs/aws-lambda-powertools-python/issues/1475))
+* **ci:** calculate parallel jobs based on infrastructure needs ([#1475](https://github.com/aws-powertools/powertools-lambda-python/issues/1475))
* **ci:** del flake8 direct dep over py3.6 conflicts and docs failure
* **ci:** move from pip-tools to poetry on layers reusable workflow
* **ci:** move from pip-tools to poetry on layers to fix conflicts
@@ -113,29 +5432,29 @@
* **ci:** move from pip-tools to poetry on layers
* **ci:** temporarily disable changelog upon release
* **ci:** add explicit origin to fix release detached head
-* **jmespath_util:** snappy as dev dep and typing example ([#1446](https://github.com/awslabs/aws-lambda-powertools-python/issues/1446))
+* **jmespath_util:** snappy as dev dep and typing example ([#1446](https://github.com/aws-powertools/powertools-lambda-python/issues/1446))
## Documentation
-* **apigateway:** removes duplicate admonition ([#1426](https://github.com/awslabs/aws-lambda-powertools-python/issues/1426))
+* **apigateway:** removes duplicate admonition ([#1426](https://github.com/aws-powertools/powertools-lambda-python/issues/1426))
* **home:** fix discord syntax and add Discord badge
-* **home:** add discord invitation link ([#1471](https://github.com/awslabs/aws-lambda-powertools-python/issues/1471))
-* **jmespath_util:** snippets split, improved, and lint ([#1419](https://github.com/awslabs/aws-lambda-powertools-python/issues/1419))
+* **home:** add discord invitation link ([#1471](https://github.com/aws-powertools/powertools-lambda-python/issues/1471))
+* **jmespath_util:** snippets split, improved, and lint ([#1419](https://github.com/aws-powertools/powertools-lambda-python/issues/1419))
* **layer:** upgrade to 1.27.0
* **layer:** upgrade to 1.27.0
-* **middleware-factory:** snippets split, improved, and lint ([#1451](https://github.com/awslabs/aws-lambda-powertools-python/issues/1451))
-* **parser:** minor grammar fix ([#1427](https://github.com/awslabs/aws-lambda-powertools-python/issues/1427))
-* **typing:** snippets split, improved, and lint ([#1465](https://github.com/awslabs/aws-lambda-powertools-python/issues/1465))
-* **validation:** snippets split, improved, and lint ([#1449](https://github.com/awslabs/aws-lambda-powertools-python/issues/1449))
+* **middleware-factory:** snippets split, improved, and lint ([#1451](https://github.com/aws-powertools/powertools-lambda-python/issues/1451))
+* **parser:** minor grammar fix ([#1427](https://github.com/aws-powertools/powertools-lambda-python/issues/1427))
+* **typing:** snippets split, improved, and lint ([#1465](https://github.com/aws-powertools/powertools-lambda-python/issues/1465))
+* **validation:** snippets split, improved, and lint ([#1449](https://github.com/aws-powertools/powertools-lambda-python/issues/1449))
## Features
-* **parser:** add support for Lambda Function URL ([#1442](https://github.com/awslabs/aws-lambda-powertools-python/issues/1442))
+* **parser:** add support for Lambda Function URL ([#1442](https://github.com/aws-powertools/powertools-lambda-python/issues/1442))
## Maintenance
-* **batch:** deprecate sqs_batch_processor ([#1463](https://github.com/awslabs/aws-lambda-powertools-python/issues/1463))
-* **ci:** prevent concurrent git update in critical workflows ([#1478](https://github.com/awslabs/aws-lambda-powertools-python/issues/1478))
+* **batch:** deprecate sqs_batch_processor ([#1463](https://github.com/aws-powertools/powertools-lambda-python/issues/1463))
+* **ci:** prevent concurrent git update in critical workflows ([#1478](https://github.com/aws-powertools/powertools-lambda-python/issues/1478))
* **ci:** disable e2e py version matrix due to concurrent locking
* **ci:** revert e2e py version matrix
* **ci:** temp disable e2e matrix
@@ -146,16 +5465,16 @@
* **ci:** include py version in stack and cache lock
* **ci:** remove conventional changelog commit to reduce noise
* **ci:** update changelog with latest changes
-* **deps:** bump release-drafter/release-drafter from 5.20.0 to 5.20.1 ([#1458](https://github.com/awslabs/aws-lambda-powertools-python/issues/1458))
-* **deps:** bump pydantic from 1.9.1 to 1.9.2 ([#1448](https://github.com/awslabs/aws-lambda-powertools-python/issues/1448))
-* **deps-dev:** bump flake8-bugbear from 22.8.22 to 22.8.23 ([#1473](https://github.com/awslabs/aws-lambda-powertools-python/issues/1473))
-* **deps-dev:** bump types-requests from 2.28.7 to 2.28.8 ([#1423](https://github.com/awslabs/aws-lambda-powertools-python/issues/1423))
-* **maintainer:** add Leandro as maintainer ([#1468](https://github.com/awslabs/aws-lambda-powertools-python/issues/1468))
-* **tests:** build and deploy Lambda Layer stack once ([#1466](https://github.com/awslabs/aws-lambda-powertools-python/issues/1466))
-* **tests:** refactor E2E test mechanics to ease maintenance, writing tests and parallelization ([#1444](https://github.com/awslabs/aws-lambda-powertools-python/issues/1444))
-* **tests:** enable end-to-end test workflow ([#1470](https://github.com/awslabs/aws-lambda-powertools-python/issues/1470))
-* **tests:** refactor E2E logger to ease maintenance, writing tests and parallelization ([#1460](https://github.com/awslabs/aws-lambda-powertools-python/issues/1460))
-* **tests:** refactor E2E tracer to ease maintenance, writing tests and parallelization ([#1457](https://github.com/awslabs/aws-lambda-powertools-python/issues/1457))
+* **deps:** bump release-drafter/release-drafter from 5.20.0 to 5.20.1 ([#1458](https://github.com/aws-powertools/powertools-lambda-python/issues/1458))
+* **deps:** bump pydantic from 1.9.1 to 1.9.2 ([#1448](https://github.com/aws-powertools/powertools-lambda-python/issues/1448))
+* **deps-dev:** bump flake8-bugbear from 22.8.22 to 22.8.23 ([#1473](https://github.com/aws-powertools/powertools-lambda-python/issues/1473))
+* **deps-dev:** bump types-requests from 2.28.7 to 2.28.8 ([#1423](https://github.com/aws-powertools/powertools-lambda-python/issues/1423))
+* **maintainer:** add Leandro as maintainer ([#1468](https://github.com/aws-powertools/powertools-lambda-python/issues/1468))
+* **tests:** build and deploy Lambda Layer stack once ([#1466](https://github.com/aws-powertools/powertools-lambda-python/issues/1466))
+* **tests:** refactor E2E test mechanics to ease maintenance, writing tests and parallelization ([#1444](https://github.com/aws-powertools/powertools-lambda-python/issues/1444))
+* **tests:** enable end-to-end test workflow ([#1470](https://github.com/aws-powertools/powertools-lambda-python/issues/1470))
+* **tests:** refactor E2E logger to ease maintenance, writing tests and parallelization ([#1460](https://github.com/aws-powertools/powertools-lambda-python/issues/1460))
+* **tests:** refactor E2E tracer to ease maintenance, writing tests and parallelization ([#1457](https://github.com/aws-powertools/powertools-lambda-python/issues/1457))
## Reverts
* fix(ci): add explicit origin to fix release detached head
@@ -168,7 +5487,7 @@
* **ci:** changelog workflow must receive git tags too
* **ci:** add additional input to accurately describe intent on skip
* **ci:** job permissions
-* **event_sources:** add test for Function URL AuthZ ([#1421](https://github.com/awslabs/aws-lambda-powertools-python/issues/1421))
+* **event_sources:** add test for Function URL AuthZ ([#1421](https://github.com/aws-powertools/powertools-lambda-python/issues/1421))
## Documentation
@@ -176,11 +5495,11 @@
## Features
-* **ci:** create reusable changelog generation ([#1418](https://github.com/awslabs/aws-lambda-powertools-python/issues/1418))
+* **ci:** create reusable changelog generation ([#1418](https://github.com/aws-powertools/powertools-lambda-python/issues/1418))
* **ci:** include changelog generation on docs build
* **ci:** create reusable changelog generation
-* **event_handlers:** Add support for Lambda Function URLs ([#1408](https://github.com/awslabs/aws-lambda-powertools-python/issues/1408))
-* **metrics:** update max user-defined dimensions from 9 to 29 ([#1417](https://github.com/awslabs/aws-lambda-powertools-python/issues/1417))
+* **event_handlers:** Add support for Lambda Function URLs ([#1408](https://github.com/aws-powertools/powertools-lambda-python/issues/1408))
+* **metrics:** update max user-defined dimensions from 9 to 29 ([#1417](https://github.com/aws-powertools/powertools-lambda-python/issues/1417))
## Maintenance
@@ -197,21 +5516,21 @@
* **ci:** readd changelog step on release
* **ci:** move changelog generation to rebuild_latest_doc workflow
* **ci:** drop 3.6 from workflows
-* **deps:** bump constructs from 10.1.1 to 10.1.60 ([#1399](https://github.com/awslabs/aws-lambda-powertools-python/issues/1399))
-* **deps:** bump constructs from 10.1.1 to 10.1.66 ([#1414](https://github.com/awslabs/aws-lambda-powertools-python/issues/1414))
-* **deps:** bump jsii from 1.57.0 to 1.63.2 ([#1400](https://github.com/awslabs/aws-lambda-powertools-python/issues/1400))
-* **deps:** bump constructs from 10.1.1 to 10.1.64 ([#1405](https://github.com/awslabs/aws-lambda-powertools-python/issues/1405))
-* **deps:** bump attrs from 21.4.0 to 22.1.0 ([#1397](https://github.com/awslabs/aws-lambda-powertools-python/issues/1397))
-* **deps:** bump constructs from 10.1.1 to 10.1.63 ([#1402](https://github.com/awslabs/aws-lambda-powertools-python/issues/1402))
-* **deps:** bump constructs from 10.1.1 to 10.1.65 ([#1407](https://github.com/awslabs/aws-lambda-powertools-python/issues/1407))
-* **deps-dev:** bump types-requests from 2.28.5 to 2.28.6 ([#1401](https://github.com/awslabs/aws-lambda-powertools-python/issues/1401))
-* **deps-dev:** bump types-requests from 2.28.6 to 2.28.7 ([#1406](https://github.com/awslabs/aws-lambda-powertools-python/issues/1406))
-* **docs:** remove pause sentence from roadmap ([#1409](https://github.com/awslabs/aws-lambda-powertools-python/issues/1409))
+* **deps:** bump constructs from 10.1.1 to 10.1.60 ([#1399](https://github.com/aws-powertools/powertools-lambda-python/issues/1399))
+* **deps:** bump constructs from 10.1.1 to 10.1.66 ([#1414](https://github.com/aws-powertools/powertools-lambda-python/issues/1414))
+* **deps:** bump jsii from 1.57.0 to 1.63.2 ([#1400](https://github.com/aws-powertools/powertools-lambda-python/issues/1400))
+* **deps:** bump constructs from 10.1.1 to 10.1.64 ([#1405](https://github.com/aws-powertools/powertools-lambda-python/issues/1405))
+* **deps:** bump attrs from 21.4.0 to 22.1.0 ([#1397](https://github.com/aws-powertools/powertools-lambda-python/issues/1397))
+* **deps:** bump constructs from 10.1.1 to 10.1.63 ([#1402](https://github.com/aws-powertools/powertools-lambda-python/issues/1402))
+* **deps:** bump constructs from 10.1.1 to 10.1.65 ([#1407](https://github.com/aws-powertools/powertools-lambda-python/issues/1407))
+* **deps-dev:** bump types-requests from 2.28.5 to 2.28.6 ([#1401](https://github.com/aws-powertools/powertools-lambda-python/issues/1401))
+* **deps-dev:** bump types-requests from 2.28.6 to 2.28.7 ([#1406](https://github.com/aws-powertools/powertools-lambda-python/issues/1406))
+* **docs:** remove pause sentence from roadmap ([#1409](https://github.com/aws-powertools/powertools-lambda-python/issues/1409))
* **docs:** update site name to test ci changelog
* **docs:** update CHANGELOG for v1.26.7
* **docs:** update description to trigger changelog generation
-* **governance:** remove devcontainer in favour of gitpod.io ([#1411](https://github.com/awslabs/aws-lambda-powertools-python/issues/1411))
-* **governance:** add pre-configured dev environment with GitPod.io to ease contributions ([#1403](https://github.com/awslabs/aws-lambda-powertools-python/issues/1403))
+* **governance:** remove devcontainer in favour of gitpod.io ([#1411](https://github.com/aws-powertools/powertools-lambda-python/issues/1411))
+* **governance:** add pre-configured dev environment with GitPod.io to ease contributions ([#1403](https://github.com/aws-powertools/powertools-lambda-python/issues/1403))
* **layers:** upgrade cdk dep hashes to prevent ci fail
@@ -220,30 +5539,30 @@
## Bug Fixes
* **ci:** add missing oidc token generation permission
-* **event_handlers:** ImportError when importing Response from top-level event_handler ([#1388](https://github.com/awslabs/aws-lambda-powertools-python/issues/1388))
+* **event_handlers:** ImportError when importing Response from top-level event_handler ([#1388](https://github.com/aws-powertools/powertools-lambda-python/issues/1388))
## Documentation
-* **examples:** enforce and fix all mypy errors ([#1393](https://github.com/awslabs/aws-lambda-powertools-python/issues/1393))
+* **examples:** enforce and fix all mypy errors ([#1393](https://github.com/aws-powertools/powertools-lambda-python/issues/1393))
## Features
-* **idempotency:** handle lambda timeout scenarios for INPROGRESS records ([#1387](https://github.com/awslabs/aws-lambda-powertools-python/issues/1387))
+* **idempotency:** handle lambda timeout scenarios for INPROGRESS records ([#1387](https://github.com/aws-powertools/powertools-lambda-python/issues/1387))
## Maintenance
* **ci:** increase skip_pypi logic to cover tests/changelog on re-run failures
* **ci:** update project with version 1.26.6
-* **ci:** drop 3.6 from workflows ([#1395](https://github.com/awslabs/aws-lambda-powertools-python/issues/1395))
-* **ci:** add conditional to skip pypi release ([#1366](https://github.com/awslabs/aws-lambda-powertools-python/issues/1366))
+* **ci:** drop 3.6 from workflows ([#1395](https://github.com/aws-powertools/powertools-lambda-python/issues/1395))
+* **ci:** add conditional to skip pypi release ([#1366](https://github.com/aws-powertools/powertools-lambda-python/issues/1366))
* **ci:** remove leftover logic from on_merged_pr workflow
* **ci:** update project with version 1.26.6
* **ci:** update project with version 1.26.6
-* **deps:** bump jsii from 1.57.0 to 1.63.1 ([#1390](https://github.com/awslabs/aws-lambda-powertools-python/issues/1390))
-* **deps:** bump constructs from 10.1.1 to 10.1.59 ([#1396](https://github.com/awslabs/aws-lambda-powertools-python/issues/1396))
-* **deps-dev:** bump flake8-isort from 4.1.1 to 4.1.2.post0 ([#1384](https://github.com/awslabs/aws-lambda-powertools-python/issues/1384))
+* **deps:** bump jsii from 1.57.0 to 1.63.1 ([#1390](https://github.com/aws-powertools/powertools-lambda-python/issues/1390))
+* **deps:** bump constructs from 10.1.1 to 10.1.59 ([#1396](https://github.com/aws-powertools/powertools-lambda-python/issues/1396))
+* **deps-dev:** bump flake8-isort from 4.1.1 to 4.1.2.post0 ([#1384](https://github.com/aws-powertools/powertools-lambda-python/issues/1384))
* **layers:** bump to 1.26.6 using layer v26
-* **maintainers:** add Ruben as a maintainer ([#1392](https://github.com/awslabs/aws-lambda-powertools-python/issues/1392))
+* **maintainers:** add Ruben as a maintainer ([#1392](https://github.com/aws-powertools/powertools-lambda-python/issues/1392))
<a name="v1.26.6"></a>
@@ -257,7 +5576,7 @@
* **ci:** cond doesnt support two expr w/ env
* **ci:** only event is resolved in cond
* **ci:** unexpected symbol due to double quotes...
-* **event_handlers:** handle lack of headers when using auto-compression feature ([#1325](https://github.com/awslabs/aws-lambda-powertools-python/issues/1325))
+* **event_handlers:** handle lack of headers when using auto-compression feature ([#1325](https://github.com/aws-powertools/powertools-lambda-python/issues/1325))
## Maintenance
@@ -268,29 +5587,29 @@
* remove leftover from fork one more time
* **ci:** test env expr
* **ci:** test upstream job skip
-* **ci:** lockdown workflow_run by origin ([#1350](https://github.com/awslabs/aws-lambda-powertools-python/issues/1350))
+* **ci:** lockdown workflow_run by origin ([#1350](https://github.com/aws-powertools/powertools-lambda-python/issues/1350))
* **ci:** test default env
* **ci:** experiment hardening origin
* **ci:** experiment hardening origin
-* **ci:** introduce codeowners ([#1352](https://github.com/awslabs/aws-lambda-powertools-python/issues/1352))
-* **ci:** use OIDC and encrypt release secrets ([#1355](https://github.com/awslabs/aws-lambda-powertools-python/issues/1355))
-* **ci:** remove core group from codeowners ([#1358](https://github.com/awslabs/aws-lambda-powertools-python/issues/1358))
+* **ci:** introduce codeowners ([#1352](https://github.com/aws-powertools/powertools-lambda-python/issues/1352))
+* **ci:** use OIDC and encrypt release secrets ([#1355](https://github.com/aws-powertools/powertools-lambda-python/issues/1355))
+* **ci:** remove core group from codeowners ([#1358](https://github.com/aws-powertools/powertools-lambda-python/issues/1358))
* **ci:** confirm workflow_run event
-* **ci:** use gh environment for beta and prod layer deploy ([#1356](https://github.com/awslabs/aws-lambda-powertools-python/issues/1356))
+* **ci:** use gh environment for beta and prod layer deploy ([#1356](https://github.com/aws-powertools/powertools-lambda-python/issues/1356))
* **ci:** update project with version 1.26.5
-* **deps:** bump constructs from 10.1.1 to 10.1.52 ([#1343](https://github.com/awslabs/aws-lambda-powertools-python/issues/1343))
-* **deps-dev:** bump mypy-boto3-cloudwatch from 1.24.0 to 1.24.35 ([#1342](https://github.com/awslabs/aws-lambda-powertools-python/issues/1342))
+* **deps:** bump constructs from 10.1.1 to 10.1.52 ([#1343](https://github.com/aws-powertools/powertools-lambda-python/issues/1343))
+* **deps-dev:** bump mypy-boto3-cloudwatch from 1.24.0 to 1.24.35 ([#1342](https://github.com/aws-powertools/powertools-lambda-python/issues/1342))
* **governance:** update wording tech debt to summary in maintenance template
-* **governance:** add new maintenance issue template for tech debt ([#1326](https://github.com/awslabs/aws-lambda-powertools-python/issues/1326))
+* **governance:** add new maintenance issue template for tech debt ([#1326](https://github.com/aws-powertools/powertools-lambda-python/issues/1326))
* **layers:** layer canary stack should not hardcode resource name
-* **layers:** replace layers account secret ([#1329](https://github.com/awslabs/aws-lambda-powertools-python/issues/1329))
-* **layers:** expand to all aws commercial regions ([#1324](https://github.com/awslabs/aws-lambda-powertools-python/issues/1324))
+* **layers:** replace layers account secret ([#1329](https://github.com/aws-powertools/powertools-lambda-python/issues/1329))
+* **layers:** expand to all aws commercial regions ([#1324](https://github.com/aws-powertools/powertools-lambda-python/issues/1324))
* **layers:** bump to 1.26.5
## Pull Requests
-* Merge pull request [#285](https://github.com/awslabs/aws-lambda-powertools-python/issues/285) from heitorlessa/chore/skip-dep-workflow
-* Merge pull request [#284](https://github.com/awslabs/aws-lambda-powertools-python/issues/284) from heitorlessa/chore/dummy
+* Merge pull request [#285](https://github.com/aws-powertools/powertools-lambda-python/issues/285) from heitorlessa/chore/skip-dep-workflow
+* Merge pull request [#284](https://github.com/aws-powertools/powertools-lambda-python/issues/284) from heitorlessa/chore/dummy
<a name="v1.26.5"></a>
@@ -306,32 +5625,32 @@
* download artefact into the layer dir
* sight, yes a whitespace character breaks the build
* **ci:** checkout project before validating related issue workflow
-* **ci:** install poetry before calling setup/python with cache ([#1315](https://github.com/awslabs/aws-lambda-powertools-python/issues/1315))
-* **ci:** remove additional quotes in PR action ([#1317](https://github.com/awslabs/aws-lambda-powertools-python/issues/1317))
-* **ci:** lambda layer workflow release version and conditionals ([#1316](https://github.com/awslabs/aws-lambda-powertools-python/issues/1316))
+* **ci:** install poetry before calling setup/python with cache ([#1315](https://github.com/aws-powertools/powertools-lambda-python/issues/1315))
+* **ci:** remove additional quotes in PR action ([#1317](https://github.com/aws-powertools/powertools-lambda-python/issues/1317))
+* **ci:** lambda layer workflow release version and conditionals ([#1316](https://github.com/aws-powertools/powertools-lambda-python/issues/1316))
* **ci:** fetch all git info so we can check tags
-* **ci:** lambda layer workflow release version and conditionals ([#1316](https://github.com/awslabs/aws-lambda-powertools-python/issues/1316))
-* **ci:** keep layer version permission ([#1318](https://github.com/awslabs/aws-lambda-powertools-python/issues/1318))
+* **ci:** lambda layer workflow release version and conditionals ([#1316](https://github.com/aws-powertools/powertools-lambda-python/issues/1316))
+* **ci:** keep layer version permission ([#1318](https://github.com/aws-powertools/powertools-lambda-python/issues/1318))
* **ci:** regex to catch combination of related issues workflow
-* **deps:** correct mypy types as dev dependency ([#1322](https://github.com/awslabs/aws-lambda-powertools-python/issues/1322))
-* **logger:** preserve std keys when using custom formatters ([#1264](https://github.com/awslabs/aws-lambda-powertools-python/issues/1264))
+* **deps:** correct mypy types as dev dependency ([#1322](https://github.com/aws-powertools/powertools-lambda-python/issues/1322))
+* **logger:** preserve std keys when using custom formatters ([#1264](https://github.com/aws-powertools/powertools-lambda-python/issues/1264))
## Documentation
-* **event-handler:** snippets split, improved, and lint ([#1279](https://github.com/awslabs/aws-lambda-powertools-python/issues/1279))
-* **governance:** typos on PR template fixes [#1314](https://github.com/awslabs/aws-lambda-powertools-python/issues/1314)
+* **event-handler:** snippets split, improved, and lint ([#1279](https://github.com/aws-powertools/powertools-lambda-python/issues/1279))
+* **governance:** typos on PR template fixes [#1314](https://github.com/aws-powertools/powertools-lambda-python/issues/1314)
* **governance:** add security doc to the root
## Maintenance
* **ci:** limits concurrency for docs workflow
-* **ci:** adds caching when installing python dependencies ([#1311](https://github.com/awslabs/aws-lambda-powertools-python/issues/1311))
+* **ci:** adds caching when installing python dependencies ([#1311](https://github.com/aws-powertools/powertools-lambda-python/issues/1311))
* **ci:** update project with version 1.26.4
* **ci:** fix reference error in related_issue
-* **deps:** bump constructs from 10.1.1 to 10.1.51 ([#1323](https://github.com/awslabs/aws-lambda-powertools-python/issues/1323))
-* **deps-dev:** bump mypy from 0.961 to 0.971 ([#1320](https://github.com/awslabs/aws-lambda-powertools-python/issues/1320))
-* **governance:** fix typo on semantic commit link introduced in [#1](https://github.com/awslabs/aws-lambda-powertools-python/issues/1)aef4
-* **layers:** add release pipeline in GitHub Actions ([#1278](https://github.com/awslabs/aws-lambda-powertools-python/issues/1278))
+* **deps:** bump constructs from 10.1.1 to 10.1.51 ([#1323](https://github.com/aws-powertools/powertools-lambda-python/issues/1323))
+* **deps-dev:** bump mypy from 0.961 to 0.971 ([#1320](https://github.com/aws-powertools/powertools-lambda-python/issues/1320))
+* **governance:** fix typo on semantic commit link introduced in [#1](https://github.com/aws-powertools/powertools-lambda-python/issues/1)aef4
+* **layers:** add release pipeline in GitHub Actions ([#1278](https://github.com/aws-powertools/powertools-lambda-python/issues/1278))
* **layers:** bump to 22 for 1.26.3
@@ -340,7 +5659,7 @@
## Bug Fixes
* **ci:** checkout project before validating related issue workflow
-* **ci:** fixes typos and small issues on github scripts ([#1302](https://github.com/awslabs/aws-lambda-powertools-python/issues/1302))
+* **ci:** fixes typos and small issues on github scripts ([#1302](https://github.com/aws-powertools/powertools-lambda-python/issues/1302))
* **ci:** address conditional type on_merge
* **ci:** address pr title semantic not found logic
* **ci:** address gh-actions additional quotes; remove debug
@@ -351,45 +5670,45 @@
* **ci:** accept core arg in label related issue workflow
* **ci:** match the name of the cdk synth from the build phase
* **ci:** regex to catch combination of related issues workflow
-* **logger:** preserve std keys when using custom formatters ([#1264](https://github.com/awslabs/aws-lambda-powertools-python/issues/1264))
-* **parser:** raise ValidationError when SNS->SQS keys are intentionally missing ([#1299](https://github.com/awslabs/aws-lambda-powertools-python/issues/1299))
+* **logger:** preserve std keys when using custom formatters ([#1264](https://github.com/aws-powertools/powertools-lambda-python/issues/1264))
+* **parser:** raise ValidationError when SNS->SQS keys are intentionally missing ([#1299](https://github.com/aws-powertools/powertools-lambda-python/issues/1299))
## Documentation
-* **event-handler:** snippets split, improved, and lint ([#1279](https://github.com/awslabs/aws-lambda-powertools-python/issues/1279))
-* **graphql:** snippets split, improved, and lint ([#1287](https://github.com/awslabs/aws-lambda-powertools-python/issues/1287))
-* **homepage:** emphasize additional powertools languages ([#1292](https://github.com/awslabs/aws-lambda-powertools-python/issues/1292))
+* **event-handler:** snippets split, improved, and lint ([#1279](https://github.com/aws-powertools/powertools-lambda-python/issues/1279))
+* **graphql:** snippets split, improved, and lint ([#1287](https://github.com/aws-powertools/powertools-lambda-python/issues/1287))
+* **homepage:** emphasize additional powertools languages ([#1292](https://github.com/aws-powertools/powertools-lambda-python/issues/1292))
* **metrics:** snippets split, improved, and lint
## Maintenance
-* **ci:** increase release automation and limit to one manual step ([#1297](https://github.com/awslabs/aws-lambda-powertools-python/issues/1297))
+* **ci:** increase release automation and limit to one manual step ([#1297](https://github.com/aws-powertools/powertools-lambda-python/issues/1297))
* **ci:** make export PR reusable
* **ci:** auto-merge cdk lib and lambda layer construct
* **ci:** convert inline gh-script to file
-* **ci:** lockdown 3rd party workflows to pin sha ([#1301](https://github.com/awslabs/aws-lambda-powertools-python/issues/1301))
-* **ci:** automatically add area label based on title ([#1300](https://github.com/awslabs/aws-lambda-powertools-python/issues/1300))
+* **ci:** lockdown 3rd party workflows to pin sha ([#1301](https://github.com/aws-powertools/powertools-lambda-python/issues/1301))
+* **ci:** automatically add area label based on title ([#1300](https://github.com/aws-powertools/powertools-lambda-python/issues/1300))
* **ci:** disable output debugging as pr body isnt accepted
* **ci:** experiment with conditional on outputs
* **ci:** improve error handling for non-issue numbers
-* **ci:** add end to end testing mechanism ([#1247](https://github.com/awslabs/aws-lambda-powertools-python/issues/1247))
+* **ci:** add end to end testing mechanism ([#1247](https://github.com/aws-powertools/powertools-lambda-python/issues/1247))
* **ci:** limits concurrency for docs workflow
* **ci:** fix reference error in related_issue
* **ci:** move error prone env to code as constants
* **ci:** move all scripts under .github/scripts
-* **deps:** bump cdk-lambda-powertools-python-layer ([#1284](https://github.com/awslabs/aws-lambda-powertools-python/issues/1284))
-* **deps:** bump jsii from 1.61.0 to 1.62.0 ([#1294](https://github.com/awslabs/aws-lambda-powertools-python/issues/1294))
-* **deps:** bump constructs from 10.1.1 to 10.1.46 ([#1306](https://github.com/awslabs/aws-lambda-powertools-python/issues/1306))
-* **deps:** bump actions/setup-node from 2 to 3 ([#1281](https://github.com/awslabs/aws-lambda-powertools-python/issues/1281))
-* **deps:** bump fastjsonschema from 2.15.3 to 2.16.1 ([#1309](https://github.com/awslabs/aws-lambda-powertools-python/issues/1309))
-* **deps:** bump constructs from 10.1.1 to 10.1.49 ([#1308](https://github.com/awslabs/aws-lambda-powertools-python/issues/1308))
-* **deps:** bump attrs from 21.2.0 to 21.4.0 ([#1282](https://github.com/awslabs/aws-lambda-powertools-python/issues/1282))
-* **deps:** bump aws-cdk-lib from 2.29.0 to 2.31.1 ([#1290](https://github.com/awslabs/aws-lambda-powertools-python/issues/1290))
-* **deps-dev:** bump mypy-boto3-dynamodb from 1.24.12 to 1.24.27 ([#1293](https://github.com/awslabs/aws-lambda-powertools-python/issues/1293))
-* **deps-dev:** bump mypy-boto3-appconfig from 1.24.0 to 1.24.29 ([#1295](https://github.com/awslabs/aws-lambda-powertools-python/issues/1295))
+* **deps:** bump cdk-lambda-powertools-python-layer ([#1284](https://github.com/aws-powertools/powertools-lambda-python/issues/1284))
+* **deps:** bump jsii from 1.61.0 to 1.62.0 ([#1294](https://github.com/aws-powertools/powertools-lambda-python/issues/1294))
+* **deps:** bump constructs from 10.1.1 to 10.1.46 ([#1306](https://github.com/aws-powertools/powertools-lambda-python/issues/1306))
+* **deps:** bump actions/setup-node from 2 to 3 ([#1281](https://github.com/aws-powertools/powertools-lambda-python/issues/1281))
+* **deps:** bump fastjsonschema from 2.15.3 to 2.16.1 ([#1309](https://github.com/aws-powertools/powertools-lambda-python/issues/1309))
+* **deps:** bump constructs from 10.1.1 to 10.1.49 ([#1308](https://github.com/aws-powertools/powertools-lambda-python/issues/1308))
+* **deps:** bump attrs from 21.2.0 to 21.4.0 ([#1282](https://github.com/aws-powertools/powertools-lambda-python/issues/1282))
+* **deps:** bump aws-cdk-lib from 2.29.0 to 2.31.1 ([#1290](https://github.com/aws-powertools/powertools-lambda-python/issues/1290))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.24.12 to 1.24.27 ([#1293](https://github.com/aws-powertools/powertools-lambda-python/issues/1293))
+* **deps-dev:** bump mypy-boto3-appconfig from 1.24.0 to 1.24.29 ([#1295](https://github.com/aws-powertools/powertools-lambda-python/issues/1295))
* **governance:** remove any step relying on master branch
* **governance:** update emeritus affiliation
-* **layers:** add release pipeline in GitHub Actions ([#1278](https://github.com/awslabs/aws-lambda-powertools-python/issues/1278))
+* **layers:** add release pipeline in GitHub Actions ([#1278](https://github.com/aws-powertools/powertools-lambda-python/issues/1278))
* **layers:** bump to 22 for 1.26.3
@@ -403,17 +5722,17 @@
* **ci:** merged_pr add issues write access
* **ci:** quote prBody GH expr on_opened_pr
* **ci:** reusable workflow secrets param
-* **logger:** support additional args for handlers when injecting lambda context ([#1276](https://github.com/awslabs/aws-lambda-powertools-python/issues/1276))
-* **logger:** preserve std keys when using custom formatters ([#1264](https://github.com/awslabs/aws-lambda-powertools-python/issues/1264))
+* **logger:** support additional args for handlers when injecting lambda context ([#1276](https://github.com/aws-powertools/powertools-lambda-python/issues/1276))
+* **logger:** preserve std keys when using custom formatters ([#1264](https://github.com/aws-powertools/powertools-lambda-python/issues/1264))
## Documentation
-* **lint:** add markdownlint rules and automation ([#1256](https://github.com/awslabs/aws-lambda-powertools-python/issues/1256))
-* **logger:** document enriching logs with logrecord attributes ([#1271](https://github.com/awslabs/aws-lambda-powertools-python/issues/1271))
-* **logger:** snippets split, improved, and lint ([#1262](https://github.com/awslabs/aws-lambda-powertools-python/issues/1262))
-* **metrics:** snippets split, improved, and lint ([#1272](https://github.com/awslabs/aws-lambda-powertools-python/issues/1272))
-* **tracer:** snippets split, improved, and lint ([#1261](https://github.com/awslabs/aws-lambda-powertools-python/issues/1261))
-* **tracer:** split and lint code snippets ([#1260](https://github.com/awslabs/aws-lambda-powertools-python/issues/1260))
+* **lint:** add markdownlint rules and automation ([#1256](https://github.com/aws-powertools/powertools-lambda-python/issues/1256))
+* **logger:** document enriching logs with logrecord attributes ([#1271](https://github.com/aws-powertools/powertools-lambda-python/issues/1271))
+* **logger:** snippets split, improved, and lint ([#1262](https://github.com/aws-powertools/powertools-lambda-python/issues/1262))
+* **metrics:** snippets split, improved, and lint ([#1272](https://github.com/aws-powertools/powertools-lambda-python/issues/1272))
+* **tracer:** snippets split, improved, and lint ([#1261](https://github.com/aws-powertools/powertools-lambda-python/issues/1261))
+* **tracer:** split and lint code snippets ([#1260](https://github.com/aws-powertools/powertools-lambda-python/issues/1260))
## Maintenance
@@ -423,24 +5742,24 @@
* **ci:** reactivate on_merged_pr workflow
* **ci:** improve wording on closed issues action
* **ci:** deactivate on_merged_pr workflow
-* **deps:** bump aws-xray-sdk from 2.9.0 to 2.10.0 ([#1270](https://github.com/awslabs/aws-lambda-powertools-python/issues/1270))
-* **deps:** bump dependabot/fetch-metadata from 1.1.1 to 1.3.2 ([#1269](https://github.com/awslabs/aws-lambda-powertools-python/issues/1269))
-* **deps:** bump dependabot/fetch-metadata from 1.3.2 to 1.3.3 ([#1273](https://github.com/awslabs/aws-lambda-powertools-python/issues/1273))
-* **deps-dev:** bump flake8-bugbear from 22.6.22 to 22.7.1 ([#1274](https://github.com/awslabs/aws-lambda-powertools-python/issues/1274))
-* **deps-dev:** bump flake8-bugbear from 22.4.25 to 22.6.22 ([#1258](https://github.com/awslabs/aws-lambda-powertools-python/issues/1258))
-* **deps-dev:** bump mypy-boto3-dynamodb from 1.24.0 to 1.24.12 ([#1255](https://github.com/awslabs/aws-lambda-powertools-python/issues/1255))
-* **deps-dev:** bump mypy-boto3-secretsmanager ([#1252](https://github.com/awslabs/aws-lambda-powertools-python/issues/1252))
+* **deps:** bump aws-xray-sdk from 2.9.0 to 2.10.0 ([#1270](https://github.com/aws-powertools/powertools-lambda-python/issues/1270))
+* **deps:** bump dependabot/fetch-metadata from 1.1.1 to 1.3.2 ([#1269](https://github.com/aws-powertools/powertools-lambda-python/issues/1269))
+* **deps:** bump dependabot/fetch-metadata from 1.3.2 to 1.3.3 ([#1273](https://github.com/aws-powertools/powertools-lambda-python/issues/1273))
+* **deps-dev:** bump flake8-bugbear from 22.6.22 to 22.7.1 ([#1274](https://github.com/aws-powertools/powertools-lambda-python/issues/1274))
+* **deps-dev:** bump flake8-bugbear from 22.4.25 to 22.6.22 ([#1258](https://github.com/aws-powertools/powertools-lambda-python/issues/1258))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.24.0 to 1.24.12 ([#1255](https://github.com/aws-powertools/powertools-lambda-python/issues/1255))
+* **deps-dev:** bump mypy-boto3-secretsmanager ([#1252](https://github.com/aws-powertools/powertools-lambda-python/issues/1252))
* **governance:** fix on_merged_pr workflow syntax
* **governance:** warn message on closed issues
* **layers:** bump to 21 for 1.26.2
-* **test-perf:** use pytest-benchmark to improve reliability ([#1250](https://github.com/awslabs/aws-lambda-powertools-python/issues/1250))
+* **test-perf:** use pytest-benchmark to improve reliability ([#1250](https://github.com/aws-powertools/powertools-lambda-python/issues/1250))
<a name="v1.26.2"></a>
## [v1.26.2] - 2022-06-16
## Bug Fixes
-* **event-handler:** body to empty string in CORS preflight (ALB non-compliant) ([#1249](https://github.com/awslabs/aws-lambda-powertools-python/issues/1249))
+* **event-handler:** body to empty string in CORS preflight (ALB non-compliant) ([#1249](https://github.com/aws-powertools/powertools-lambda-python/issues/1249))
## Code Refactoring
@@ -458,12 +5777,12 @@
## Maintenance
* bump to 1.26.2
-* **deps:** bump actions/setup-python from 3 to 4 ([#1244](https://github.com/awslabs/aws-lambda-powertools-python/issues/1244))
-* **deps-dev:** bump mypy from 0.960 to 0.961 ([#1241](https://github.com/awslabs/aws-lambda-powertools-python/issues/1241))
-* **deps-dev:** bump mypy-boto3-ssm from 1.23.0.post1 to 1.24.0 ([#1231](https://github.com/awslabs/aws-lambda-powertools-python/issues/1231))
-* **deps-dev:** bump mypy-boto3-secretsmanager from 1.23.8 to 1.24.0 ([#1232](https://github.com/awslabs/aws-lambda-powertools-python/issues/1232))
-* **deps-dev:** bump mypy-boto3-dynamodb from 1.23.0.post1 to 1.24.0 ([#1234](https://github.com/awslabs/aws-lambda-powertools-python/issues/1234))
-* **deps-dev:** bump mypy-boto3-appconfig from 1.23.0.post1 to 1.24.0 ([#1233](https://github.com/awslabs/aws-lambda-powertools-python/issues/1233))
+* **deps:** bump actions/setup-python from 3 to 4 ([#1244](https://github.com/aws-powertools/powertools-lambda-python/issues/1244))
+* **deps-dev:** bump mypy from 0.960 to 0.961 ([#1241](https://github.com/aws-powertools/powertools-lambda-python/issues/1241))
+* **deps-dev:** bump mypy-boto3-ssm from 1.23.0.post1 to 1.24.0 ([#1231](https://github.com/aws-powertools/powertools-lambda-python/issues/1231))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.23.8 to 1.24.0 ([#1232](https://github.com/aws-powertools/powertools-lambda-python/issues/1232))
+* **deps-dev:** bump mypy-boto3-dynamodb from 1.23.0.post1 to 1.24.0 ([#1234](https://github.com/aws-powertools/powertools-lambda-python/issues/1234))
+* **deps-dev:** bump mypy-boto3-appconfig from 1.23.0.post1 to 1.24.0 ([#1233](https://github.com/aws-powertools/powertools-lambda-python/issues/1233))
* **governance:** auto-merge on all PR events
* **governance:** add release label on pr merge
* **governance:** enforce safe scope on pr merge labelling
@@ -475,65 +5794,65 @@
* **governance:** address gh reusable workflow limitation
* **governance:** fix workflow action requirements & syntax
* **governance:** warn message on closed issues
-* **metrics:** revert dimensions test before splitting ([#1243](https://github.com/awslabs/aws-lambda-powertools-python/issues/1243))
+* **metrics:** revert dimensions test before splitting ([#1243](https://github.com/aws-powertools/powertools-lambda-python/issues/1243))
<a name="v1.26.1"></a>
## [v1.26.1] - 2022-06-07
## Bug Fixes
-* **metrics:** raise SchemaValidationError for >8 metric dimensions ([#1240](https://github.com/awslabs/aws-lambda-powertools-python/issues/1240))
+* **metrics:** raise SchemaValidationError for >8 metric dimensions ([#1240](https://github.com/aws-powertools/powertools-lambda-python/issues/1240))
## Documentation
* **governance:** link roadmap and maintainers doc
-* **maintainers:** initial maintainers playbook ([#1222](https://github.com/awslabs/aws-lambda-powertools-python/issues/1222))
+* **maintainers:** initial maintainers playbook ([#1222](https://github.com/aws-powertools/powertools-lambda-python/issues/1222))
* **roadmap:** use pinned pause issue instead
## Maintenance
* bump version 1.26.1
-* **deps-dev:** bump mypy from 0.950 to 0.960 ([#1224](https://github.com/awslabs/aws-lambda-powertools-python/issues/1224))
-* **deps-dev:** bump mypy-boto3-secretsmanager from 1.23.0.post1 to 1.23.8 ([#1225](https://github.com/awslabs/aws-lambda-powertools-python/issues/1225))
+* **deps-dev:** bump mypy from 0.950 to 0.960 ([#1224](https://github.com/aws-powertools/powertools-lambda-python/issues/1224))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.23.0.post1 to 1.23.8 ([#1225](https://github.com/aws-powertools/powertools-lambda-python/issues/1225))
<a name="v1.26.0"></a>
## [v1.26.0] - 2022-05-20
## Bug Fixes
-* **batch:** missing space in BatchProcessingError message ([#1201](https://github.com/awslabs/aws-lambda-powertools-python/issues/1201))
-* **batch:** docstring fix for success_handler() record parameter ([#1202](https://github.com/awslabs/aws-lambda-powertools-python/issues/1202))
-* **docs:** remove Slack link ([#1210](https://github.com/awslabs/aws-lambda-powertools-python/issues/1210))
+* **batch:** missing space in BatchProcessingError message ([#1201](https://github.com/aws-powertools/powertools-lambda-python/issues/1201))
+* **batch:** docstring fix for success_handler() record parameter ([#1202](https://github.com/aws-powertools/powertools-lambda-python/issues/1202))
+* **docs:** remove Slack link ([#1210](https://github.com/aws-powertools/powertools-lambda-python/issues/1210))
## Documentation
* **layer:** upgrade to 1.25.10
-* **roadmap:** add new roadmap section ([#1204](https://github.com/awslabs/aws-lambda-powertools-python/issues/1204))
+* **roadmap:** add new roadmap section ([#1204](https://github.com/aws-powertools/powertools-lambda-python/issues/1204))
## Features
-* **parameters:** accept boto3_client to support private endpoints and ease testing ([#1096](https://github.com/awslabs/aws-lambda-powertools-python/issues/1096))
+* **parameters:** accept boto3_client to support private endpoints and ease testing ([#1096](https://github.com/aws-powertools/powertools-lambda-python/issues/1096))
## Maintenance
* bump to 1.26.0
-* **deps:** bump pydantic from 1.9.0 to 1.9.1 ([#1221](https://github.com/awslabs/aws-lambda-powertools-python/issues/1221))
-* **deps:** bump email-validator from 1.1.3 to 1.2.1 ([#1199](https://github.com/awslabs/aws-lambda-powertools-python/issues/1199))
-* **deps-dev:** bump mypy-boto3-secretsmanager from 1.21.34 to 1.23.0.post1 ([#1218](https://github.com/awslabs/aws-lambda-powertools-python/issues/1218))
-* **deps-dev:** bump mypy-boto3-appconfig from 1.21.34 to 1.23.0.post1 ([#1219](https://github.com/awslabs/aws-lambda-powertools-python/issues/1219))
-* **deps-dev:** bump mypy-boto3-ssm from 1.21.34 to 1.23.0.post1 ([#1220](https://github.com/awslabs/aws-lambda-powertools-python/issues/1220))
+* **deps:** bump pydantic from 1.9.0 to 1.9.1 ([#1221](https://github.com/aws-powertools/powertools-lambda-python/issues/1221))
+* **deps:** bump email-validator from 1.1.3 to 1.2.1 ([#1199](https://github.com/aws-powertools/powertools-lambda-python/issues/1199))
+* **deps-dev:** bump mypy-boto3-secretsmanager from 1.21.34 to 1.23.0.post1 ([#1218](https://github.com/aws-powertools/powertools-lambda-python/issues/1218))
+* **deps-dev:** bump mypy-boto3-appconfig from 1.21.34 to 1.23.0.post1 ([#1219](https://github.com/aws-powertools/powertools-lambda-python/issues/1219))
+* **deps-dev:** bump mypy-boto3-ssm from 1.21.34 to 1.23.0.post1 ([#1220](https://github.com/aws-powertools/powertools-lambda-python/issues/1220))
<a name="v1.25.10"></a>
## [v1.25.10] - 2022-04-29
## Bug Fixes
-* **data-classes:** Add missing SES fields and ([#1045](https://github.com/awslabs/aws-lambda-powertools-python/issues/1045))
-* **deps:** Ignore boto3 changes until needed ([#1151](https://github.com/awslabs/aws-lambda-powertools-python/issues/1151))
-* **deps-dev:** remove jmespath due to dev deps conflict ([#1148](https://github.com/awslabs/aws-lambda-powertools-python/issues/1148))
-* **event_handler:** exception_handler to handle ServiceError exceptions ([#1160](https://github.com/awslabs/aws-lambda-powertools-python/issues/1160))
-* **event_handler:** Allow for event_source support ([#1159](https://github.com/awslabs/aws-lambda-powertools-python/issues/1159))
-* **parser:** Add missing fields for SESEvent ([#1027](https://github.com/awslabs/aws-lambda-powertools-python/issues/1027))
+* **data-classes:** Add missing SES fields and ([#1045](https://github.com/aws-powertools/powertools-lambda-python/issues/1045))
+* **deps:** Ignore boto3 changes until needed ([#1151](https://github.com/aws-powertools/powertools-lambda-python/issues/1151))
+* **deps-dev:** remove jmespath due to dev deps conflict ([#1148](https://github.com/aws-powertools/powertools-lambda-python/issues/1148))
+* **event_handler:** exception_handler to handle ServiceError exceptions ([#1160](https://github.com/aws-powertools/powertools-lambda-python/issues/1160))
+* **event_handler:** Allow for event_source support ([#1159](https://github.com/aws-powertools/powertools-lambda-python/issues/1159))
+* **parser:** Add missing fields for SESEvent ([#1027](https://github.com/aws-powertools/powertools-lambda-python/issues/1027))
## Documentation
@@ -541,27 +5860,27 @@
## Features
-* **parameters:** add clear_cache method for providers ([#1194](https://github.com/awslabs/aws-lambda-powertools-python/issues/1194))
+* **parameters:** add clear_cache method for providers ([#1194](https://github.com/aws-powertools/powertools-lambda-python/issues/1194))
## Maintenance
* include regression in changelog
* bump to 1.25.10
* **ci:** changelog pre-generation to fetch tags from origin
-* **ci:** disable mergify configuration after breaking changes ([#1188](https://github.com/awslabs/aws-lambda-powertools-python/issues/1188))
+* **ci:** disable mergify configuration after breaking changes ([#1188](https://github.com/aws-powertools/powertools-lambda-python/issues/1188))
* **ci:** post release on tagged issues too
-* **deps:** bump codecov/codecov-action from 3.0.0 to 3.1.0 ([#1143](https://github.com/awslabs/aws-lambda-powertools-python/issues/1143))
-* **deps:** bump github/codeql-action from 1 to 2 ([#1154](https://github.com/awslabs/aws-lambda-powertools-python/issues/1154))
-* **deps-dev:** bump flake8-eradicate from 1.2.0 to 1.2.1 ([#1158](https://github.com/awslabs/aws-lambda-powertools-python/issues/1158))
-* **deps-dev:** bump mypy from 0.942 to 0.950 ([#1162](https://github.com/awslabs/aws-lambda-powertools-python/issues/1162))
-* **deps-dev:** bump mkdocs-git-revision-date-plugin ([#1146](https://github.com/awslabs/aws-lambda-powertools-python/issues/1146))
-* **deps-dev:** bump flake8-bugbear from 22.1.11 to 22.4.25 ([#1156](https://github.com/awslabs/aws-lambda-powertools-python/issues/1156))
-* **deps-dev:** bump xenon from 0.8.0 to 0.9.0 ([#1145](https://github.com/awslabs/aws-lambda-powertools-python/issues/1145))
-* **deps-dev:** bump mypy from 0.931 to 0.942 ([#1133](https://github.com/awslabs/aws-lambda-powertools-python/issues/1133))
+* **deps:** bump codecov/codecov-action from 3.0.0 to 3.1.0 ([#1143](https://github.com/aws-powertools/powertools-lambda-python/issues/1143))
+* **deps:** bump github/codeql-action from 1 to 2 ([#1154](https://github.com/aws-powertools/powertools-lambda-python/issues/1154))
+* **deps-dev:** bump flake8-eradicate from 1.2.0 to 1.2.1 ([#1158](https://github.com/aws-powertools/powertools-lambda-python/issues/1158))
+* **deps-dev:** bump mypy from 0.942 to 0.950 ([#1162](https://github.com/aws-powertools/powertools-lambda-python/issues/1162))
+* **deps-dev:** bump mkdocs-git-revision-date-plugin ([#1146](https://github.com/aws-powertools/powertools-lambda-python/issues/1146))
+* **deps-dev:** bump flake8-bugbear from 22.1.11 to 22.4.25 ([#1156](https://github.com/aws-powertools/powertools-lambda-python/issues/1156))
+* **deps-dev:** bump xenon from 0.8.0 to 0.9.0 ([#1145](https://github.com/aws-powertools/powertools-lambda-python/issues/1145))
+* **deps-dev:** bump mypy from 0.931 to 0.942 ([#1133](https://github.com/aws-powertools/powertools-lambda-python/issues/1133))
## Regression
-* **parser:** Add missing fields for SESEvent ([#1027](https://github.com/awslabs/aws-lambda-powertools-python/issues/1027)) ([#1190](https://github.com/awslabs/aws-lambda-powertools-python/issues/1190))
+* **parser:** Add missing fields for SESEvent ([#1027](https://github.com/aws-powertools/powertools-lambda-python/issues/1027)) ([#1190](https://github.com/aws-powertools/powertools-lambda-python/issues/1190))
<a name="v1.25.9"></a>
@@ -580,33 +5899,33 @@
## Bug Fixes
* removed ambiguous quotes from labels.
-* **deps:** update jmespath marker to support 1.0 and py3.6 ([#1139](https://github.com/awslabs/aws-lambda-powertools-python/issues/1139))
+* **deps:** update jmespath marker to support 1.0 and py3.6 ([#1139](https://github.com/aws-powertools/powertools-lambda-python/issues/1139))
* **governance:** update label in names in issues
## Documentation
-* **install:** instructions to reduce pydantic package size ([#1077](https://github.com/awslabs/aws-lambda-powertools-python/issues/1077))
-* **layer:** remove link from clipboard button ([#1135](https://github.com/awslabs/aws-lambda-powertools-python/issues/1135))
+* **install:** instructions to reduce pydantic package size ([#1077](https://github.com/aws-powertools/powertools-lambda-python/issues/1077))
+* **layer:** remove link from clipboard button ([#1135](https://github.com/aws-powertools/powertools-lambda-python/issues/1135))
* **layer:** update to 1.25.7
## Maintenance
* bump to 1.25.8
-* **deps:** bump codecov/codecov-action from 2.1.0 to 3.0.0 ([#1102](https://github.com/awslabs/aws-lambda-powertools-python/issues/1102))
-* **deps:** bump actions/upload-artifact from 2 to 3 ([#1103](https://github.com/awslabs/aws-lambda-powertools-python/issues/1103))
-* **deps-dev:** bump mkdocs-material from 8.2.4 to 8.2.7 ([#1131](https://github.com/awslabs/aws-lambda-powertools-python/issues/1131))
-* **deps-dev:** bump pytest from 6.2.5 to 7.0.1 ([#1063](https://github.com/awslabs/aws-lambda-powertools-python/issues/1063))
+* **deps:** bump codecov/codecov-action from 2.1.0 to 3.0.0 ([#1102](https://github.com/aws-powertools/powertools-lambda-python/issues/1102))
+* **deps:** bump actions/upload-artifact from 2 to 3 ([#1103](https://github.com/aws-powertools/powertools-lambda-python/issues/1103))
+* **deps-dev:** bump mkdocs-material from 8.2.4 to 8.2.7 ([#1131](https://github.com/aws-powertools/powertools-lambda-python/issues/1131))
+* **deps-dev:** bump pytest from 6.2.5 to 7.0.1 ([#1063](https://github.com/aws-powertools/powertools-lambda-python/issues/1063))
<a name="v1.25.7"></a>
## [v1.25.7] - 2022-04-08
## Bug Fixes
-* **api_gateway:** allow whitespace in routes' path parameter ([#1099](https://github.com/awslabs/aws-lambda-powertools-python/issues/1099))
-* **api_gateway:** allow whitespace in routes' path parameter ([#1099](https://github.com/awslabs/aws-lambda-powertools-python/issues/1099))
-* **idempotency:** pass by value on idem key to guard inadvert mutations ([#1090](https://github.com/awslabs/aws-lambda-powertools-python/issues/1090))
-* **logger:** clear_state should keep custom key formats ([#1095](https://github.com/awslabs/aws-lambda-powertools-python/issues/1095))
-* **middleware_factory:** ret type annotation for handler dec ([#1066](https://github.com/awslabs/aws-lambda-powertools-python/issues/1066))
+* **api_gateway:** allow whitespace in routes' path parameter ([#1099](https://github.com/aws-powertools/powertools-lambda-python/issues/1099))
+* **api_gateway:** allow whitespace in routes' path parameter ([#1099](https://github.com/aws-powertools/powertools-lambda-python/issues/1099))
+* **idempotency:** pass by value on idem key to guard inadvert mutations ([#1090](https://github.com/aws-powertools/powertools-lambda-python/issues/1090))
+* **logger:** clear_state should keep custom key formats ([#1095](https://github.com/aws-powertools/powertools-lambda-python/issues/1095))
+* **middleware_factory:** ret type annotation for handler dec ([#1066](https://github.com/aws-powertools/powertools-lambda-python/issues/1066))
## Documentation
@@ -631,7 +5950,7 @@
## [v1.25.6] - 2022-04-01
## Bug Fixes
-* **logger:** clear_state regression on absent standard keys ([#1088](https://github.com/awslabs/aws-lambda-powertools-python/issues/1088))
+* **logger:** clear_state regression on absent standard keys ([#1088](https://github.com/aws-powertools/powertools-lambda-python/issues/1088))
## Documentation
@@ -646,7 +5965,7 @@
## [v1.25.5] - 2022-03-18
## Bug Fixes
-* **logger-utils:** regression on exclude set leading to no formatter ([#1080](https://github.com/awslabs/aws-lambda-powertools-python/issues/1080))
+* **logger-utils:** regression on exclude set leading to no formatter ([#1080](https://github.com/aws-powertools/powertools-lambda-python/issues/1080))
## Maintenance
@@ -681,18 +6000,18 @@
## Pull Requests
-* Merge pull request [#1075](https://github.com/awslabs/aws-lambda-powertools-python/issues/1075) from mploski/fix/existing-loggers-duplicated-logs
+* Merge pull request [#1075](https://github.com/aws-powertools/powertools-lambda-python/issues/1075) from mploski/fix/existing-loggers-duplicated-logs
<a name="v1.25.3"></a>
## [v1.25.3] - 2022-03-09
## Bug Fixes
-* **logger:** ensure state is cleared for custom formatters ([#1072](https://github.com/awslabs/aws-lambda-powertools-python/issues/1072))
+* **logger:** ensure state is cleared for custom formatters ([#1072](https://github.com/aws-powertools/powertools-lambda-python/issues/1072))
## Documentation
-* **plugin:** add mermaid to create diagram as code ([#1070](https://github.com/awslabs/aws-lambda-powertools-python/issues/1070))
+* **plugin:** add mermaid to create diagram as code ([#1070](https://github.com/aws-powertools/powertools-lambda-python/issues/1070))
## Maintenance
@@ -703,30 +6022,30 @@
## [v1.25.2] - 2022-03-07
## Bug Fixes
-* **event_handler:** docs snippets, high-level import CorsConfig ([#1019](https://github.com/awslabs/aws-lambda-powertools-python/issues/1019))
-* **lambda-authorizer:** allow proxy resources path in arn ([#1051](https://github.com/awslabs/aws-lambda-powertools-python/issues/1051))
-* **metrics:** flush upon a single metric 100th data point ([#1046](https://github.com/awslabs/aws-lambda-powertools-python/issues/1046))
+* **event_handler:** docs snippets, high-level import CorsConfig ([#1019](https://github.com/aws-powertools/powertools-lambda-python/issues/1019))
+* **lambda-authorizer:** allow proxy resources path in arn ([#1051](https://github.com/aws-powertools/powertools-lambda-python/issues/1051))
+* **metrics:** flush upon a single metric 100th data point ([#1046](https://github.com/aws-powertools/powertools-lambda-python/issues/1046))
## Documentation
* **layer:** update to 1.25.1
-* **parser:** APIGatewayProxyEvent to APIGatewayProxyEventModel ([#1061](https://github.com/awslabs/aws-lambda-powertools-python/issues/1061))
+* **parser:** APIGatewayProxyEvent to APIGatewayProxyEventModel ([#1061](https://github.com/aws-powertools/powertools-lambda-python/issues/1061))
## Maintenance
* bump to 1.25.2
-* **deps:** bump actions/setup-python from 2.3.1 to 3 ([#1048](https://github.com/awslabs/aws-lambda-powertools-python/issues/1048))
-* **deps:** bump actions/checkout from 2 to 3 ([#1052](https://github.com/awslabs/aws-lambda-powertools-python/issues/1052))
-* **deps:** bump actions/github-script from 5 to 6 ([#1023](https://github.com/awslabs/aws-lambda-powertools-python/issues/1023))
-* **deps:** bump fastjsonschema from 2.15.2 to 2.15.3 ([#949](https://github.com/awslabs/aws-lambda-powertools-python/issues/949))
-* **deps-dev:** bump mkdocs-material from 8.1.9 to 8.2.4 ([#1054](https://github.com/awslabs/aws-lambda-powertools-python/issues/1054))
+* **deps:** bump actions/setup-python from 2.3.1 to 3 ([#1048](https://github.com/aws-powertools/powertools-lambda-python/issues/1048))
+* **deps:** bump actions/checkout from 2 to 3 ([#1052](https://github.com/aws-powertools/powertools-lambda-python/issues/1052))
+* **deps:** bump actions/github-script from 5 to 6 ([#1023](https://github.com/aws-powertools/powertools-lambda-python/issues/1023))
+* **deps:** bump fastjsonschema from 2.15.2 to 2.15.3 ([#949](https://github.com/aws-powertools/powertools-lambda-python/issues/949))
+* **deps-dev:** bump mkdocs-material from 8.1.9 to 8.2.4 ([#1054](https://github.com/aws-powertools/powertools-lambda-python/issues/1054))
<a name="v1.25.1"></a>
## [v1.25.1] - 2022-02-14
## Bug Fixes
-* **batch:** bugfix to clear exceptions between executions ([#1022](https://github.com/awslabs/aws-lambda-powertools-python/issues/1022))
+* **batch:** bugfix to clear exceptions between executions ([#1022](https://github.com/aws-powertools/powertools-lambda-python/issues/1022))
## Maintenance
@@ -738,27 +6057,27 @@
## [v1.25.0] - 2022-02-09
## Bug Fixes
-* **apigateway:** remove indentation in debug_mode ([#987](https://github.com/awslabs/aws-lambda-powertools-python/issues/987))
-* **batch:** delete >10 messages in legacy sqs processor ([#818](https://github.com/awslabs/aws-lambda-powertools-python/issues/818))
+* **apigateway:** remove indentation in debug_mode ([#987](https://github.com/aws-powertools/powertools-lambda-python/issues/987))
+* **batch:** delete >10 messages in legacy sqs processor ([#818](https://github.com/aws-powertools/powertools-lambda-python/issues/818))
* **ci:** pr label regex for special chars in title
-* **logger:** exclude source_logger in copy_config_to_registered_loggers ([#1001](https://github.com/awslabs/aws-lambda-powertools-python/issues/1001))
+* **logger:** exclude source_logger in copy_config_to_registered_loggers ([#1001](https://github.com/aws-powertools/powertools-lambda-python/issues/1001))
* **logger:** test generates logfile
## Documentation
-* fix syntax errors and line highlights ([#1004](https://github.com/awslabs/aws-lambda-powertools-python/issues/1004))
+* fix syntax errors and line highlights ([#1004](https://github.com/aws-powertools/powertools-lambda-python/issues/1004))
* add better BDD coments
-* **event-handler:** improve testing section for graphql ([#996](https://github.com/awslabs/aws-lambda-powertools-python/issues/996))
+* **event-handler:** improve testing section for graphql ([#996](https://github.com/aws-powertools/powertools-lambda-python/issues/996))
* **layer:** update to 1.24.2
-* **parameters:** add testing your code section ([#1017](https://github.com/awslabs/aws-lambda-powertools-python/issues/1017))
-* **theme:** upgrade mkdocs-material to 8.x ([#1002](https://github.com/awslabs/aws-lambda-powertools-python/issues/1002))
-* **tutorial:** fix broken internal links ([#1000](https://github.com/awslabs/aws-lambda-powertools-python/issues/1000))
+* **parameters:** add testing your code section ([#1017](https://github.com/aws-powertools/powertools-lambda-python/issues/1017))
+* **theme:** upgrade mkdocs-material to 8.x ([#1002](https://github.com/aws-powertools/powertools-lambda-python/issues/1002))
+* **tutorial:** fix broken internal links ([#1000](https://github.com/aws-powertools/powertools-lambda-python/issues/1000))
## Features
-* **event-handler:** new resolvers to fix current_event typing ([#978](https://github.com/awslabs/aws-lambda-powertools-python/issues/978))
-* **logger:** log_event support event data classes (e.g. S3Event) ([#984](https://github.com/awslabs/aws-lambda-powertools-python/issues/984))
-* **mypy:** complete mypy support for the entire codebase ([#943](https://github.com/awslabs/aws-lambda-powertools-python/issues/943))
+* **event-handler:** new resolvers to fix current_event typing ([#978](https://github.com/aws-powertools/powertools-lambda-python/issues/978))
+* **logger:** log_event support event data classes (e.g. S3Event) ([#984](https://github.com/aws-powertools/powertools-lambda-python/issues/984))
+* **mypy:** complete mypy support for the entire codebase ([#943](https://github.com/aws-powertools/powertools-lambda-python/issues/943))
## Maintenance
@@ -766,19 +6085,19 @@
* correct docs
* correct docs
* use isinstance over type
-* **deps-dev:** bump flake8-bugbear from 21.11.29 to 22.1.11 ([#955](https://github.com/awslabs/aws-lambda-powertools-python/issues/955))
-* **metrics:** fix tests when warnings are disabled ([#994](https://github.com/awslabs/aws-lambda-powertools-python/issues/994))
+* **deps-dev:** bump flake8-bugbear from 21.11.29 to 22.1.11 ([#955](https://github.com/aws-powertools/powertools-lambda-python/issues/955))
+* **metrics:** fix tests when warnings are disabled ([#994](https://github.com/aws-powertools/powertools-lambda-python/issues/994))
## Pull Requests
-* Merge pull request [#971](https://github.com/awslabs/aws-lambda-powertools-python/issues/971) from gyft/fix-logger-util-tests
+* Merge pull request [#971](https://github.com/aws-powertools/powertools-lambda-python/issues/971) from gyft/fix-logger-util-tests
<a name="v1.24.2"></a>
## [v1.24.2] - 2022-01-21
## Bug Fixes
-* **data-classes:** underscore support in api gateway authorizer resource name ([#969](https://github.com/awslabs/aws-lambda-powertools-python/issues/969))
+* **data-classes:** underscore support in api gateway authorizer resource name ([#969](https://github.com/aws-powertools/powertools-lambda-python/issues/969))
## Documentation
@@ -798,21 +6117,21 @@
* use decorators, split cold start to ease reading
* incorrect log keys, indentation, snippet consistency
* remove f-strings that doesn't evaluate expr
-* **batch:** report multiple failures ([#967](https://github.com/awslabs/aws-lambda-powertools-python/issues/967))
-* **data-classes:** docstring typos and clean up ([#937](https://github.com/awslabs/aws-lambda-powertools-python/issues/937))
-* **parameters:** appconfig internal _get docstrings ([#934](https://github.com/awslabs/aws-lambda-powertools-python/issues/934))
+* **batch:** report multiple failures ([#967](https://github.com/aws-powertools/powertools-lambda-python/issues/967))
+* **data-classes:** docstring typos and clean up ([#937](https://github.com/aws-powertools/powertools-lambda-python/issues/937))
+* **parameters:** appconfig internal _get docstrings ([#934](https://github.com/aws-powertools/powertools-lambda-python/issues/934))
## Documentation
* rename quickstart to tutorial in readme
* rename to tutorial given the size
* add final consideration section
-* **batch:** snippet typo on batch processed messages iteration ([#951](https://github.com/awslabs/aws-lambda-powertools-python/issues/951))
-* **batch:** fix typo in context manager keyword ([#938](https://github.com/awslabs/aws-lambda-powertools-python/issues/938))
-* **homepage:** link to typescript version ([#950](https://github.com/awslabs/aws-lambda-powertools-python/issues/950))
+* **batch:** snippet typo on batch processed messages iteration ([#951](https://github.com/aws-powertools/powertools-lambda-python/issues/951))
+* **batch:** fix typo in context manager keyword ([#938](https://github.com/aws-powertools/powertools-lambda-python/issues/938))
+* **homepage:** link to typescript version ([#950](https://github.com/aws-powertools/powertools-lambda-python/issues/950))
* **install:** new lambda layer for 1.24.0 release
* **metrics:** keep it consistent with other sections, update metric names
-* **nav:** make REST and GraphQL event handlers more explicit ([#959](https://github.com/awslabs/aws-lambda-powertools-python/issues/959))
+* **nav:** make REST and GraphQL event handlers more explicit ([#959](https://github.com/aws-powertools/powertools-lambda-python/issues/959))
* **quickstart:** expand on intro line
* **quickstart:** tidy requirements up
* **quickstart:** make section agnostic to json lib
@@ -824,12 +6143,12 @@
* **tracer:** add initial image, requirements
* **tracer:** add annotation, metadata, and image
* **tracer:** update ServiceLens image w/ API GW, copywriting
-* **tutorial:** fix path to images ([#963](https://github.com/awslabs/aws-lambda-powertools-python/issues/963))
+* **tutorial:** fix path to images ([#963](https://github.com/aws-powertools/powertools-lambda-python/issues/963))
## Features
* **ci:** auto-notify & close issues on release
-* **logger:** clone powertools logger config to any Python logger ([#927](https://github.com/awslabs/aws-lambda-powertools-python/issues/927))
+* **logger:** clone powertools logger config to any Python logger ([#927](https://github.com/aws-powertools/powertools-lambda-python/issues/927))
## Maintenance
@@ -841,8 +6160,8 @@
* **ci:** remove mergify legacy key
* **ci:** update mergify bot breaking change
* **ci:** safely label PR based on title
-* **deps:** bump pydantic from 1.8.2 to 1.9.0 ([#933](https://github.com/awslabs/aws-lambda-powertools-python/issues/933))
-* **deps-dev:** bump mypy from 0.930 to 0.931 ([#941](https://github.com/awslabs/aws-lambda-powertools-python/issues/941))
+* **deps:** bump pydantic from 1.8.2 to 1.9.0 ([#933](https://github.com/aws-powertools/powertools-lambda-python/issues/933))
+* **deps-dev:** bump mypy from 0.930 to 0.931 ([#941](https://github.com/aws-powertools/powertools-lambda-python/issues/941))
## Regression
@@ -850,124 +6169,124 @@
## Pull Requests
-* Merge pull request [#769](https://github.com/awslabs/aws-lambda-powertools-python/issues/769) from mploski/docs/quick-start
+* Merge pull request [#769](https://github.com/aws-powertools/powertools-lambda-python/issues/769) from mploski/docs/quick-start
<a name="v1.24.0"></a>
## [v1.24.0] - 2021-12-31
## Bug Fixes
-* **apigateway:** support [@app](https://github.com/app).not_found() syntax & housekeeping ([#926](https://github.com/awslabs/aws-lambda-powertools-python/issues/926))
-* **event-sources:** handle dynamodb null type as none, not bool ([#929](https://github.com/awslabs/aws-lambda-powertools-python/issues/929))
-* **warning:** future distutils deprecation ([#921](https://github.com/awslabs/aws-lambda-powertools-python/issues/921))
+* **apigateway:** support [@app](https://github.com/app).not_found() syntax & housekeeping ([#926](https://github.com/aws-powertools/powertools-lambda-python/issues/926))
+* **event-sources:** handle dynamodb null type as none, not bool ([#929](https://github.com/aws-powertools/powertools-lambda-python/issues/929))
+* **warning:** future distutils deprecation ([#921](https://github.com/aws-powertools/powertools-lambda-python/issues/921))
## Documentation
-* consistency around admonitions and snippets ([#919](https://github.com/awslabs/aws-lambda-powertools-python/issues/919))
-* Added GraphQL Sample API to Examples section of README.md ([#930](https://github.com/awslabs/aws-lambda-powertools-python/issues/930))
+* consistency around admonitions and snippets ([#919](https://github.com/aws-powertools/powertools-lambda-python/issues/919))
+* Added GraphQL Sample API to Examples section of README.md ([#930](https://github.com/aws-powertools/powertools-lambda-python/issues/930))
* **batch:** remove leftover from legacy
* **layer:** bump Lambda Layer to version 6
-* **tracer:** new ignore_endpoint feature ([#931](https://github.com/awslabs/aws-lambda-powertools-python/issues/931))
+* **tracer:** new ignore_endpoint feature ([#931](https://github.com/aws-powertools/powertools-lambda-python/issues/931))
## Features
-* **event-sources:** cache parsed json in data class ([#909](https://github.com/awslabs/aws-lambda-powertools-python/issues/909))
-* **feature_flags:** support beyond boolean values (JSON values) ([#804](https://github.com/awslabs/aws-lambda-powertools-python/issues/804))
-* **idempotency:** support dataclasses & pydantic models payloads ([#908](https://github.com/awslabs/aws-lambda-powertools-python/issues/908))
-* **logger:** support use_datetime_directive for timestamps ([#920](https://github.com/awslabs/aws-lambda-powertools-python/issues/920))
-* **tracer:** ignore tracing for certain hostname(s) or url(s) ([#910](https://github.com/awslabs/aws-lambda-powertools-python/issues/910))
+* **event-sources:** cache parsed json in data class ([#909](https://github.com/aws-powertools/powertools-lambda-python/issues/909))
+* **feature_flags:** support beyond boolean values (JSON values) ([#804](https://github.com/aws-powertools/powertools-lambda-python/issues/804))
+* **idempotency:** support dataclasses & pydantic models payloads ([#908](https://github.com/aws-powertools/powertools-lambda-python/issues/908))
+* **logger:** support use_datetime_directive for timestamps ([#920](https://github.com/aws-powertools/powertools-lambda-python/issues/920))
+* **tracer:** ignore tracing for certain hostname(s) or url(s) ([#910](https://github.com/aws-powertools/powertools-lambda-python/issues/910))
## Maintenance
* bump to 1.24.0
-* **deps-dev:** bump mypy from 0.920 to 0.930 ([#925](https://github.com/awslabs/aws-lambda-powertools-python/issues/925))
+* **deps-dev:** bump mypy from 0.920 to 0.930 ([#925](https://github.com/aws-powertools/powertools-lambda-python/issues/925))
<a name="v1.23.0"></a>
## [v1.23.0] - 2021-12-20
## Bug Fixes
-* **apigateway:** allow list of HTTP methods in route method ([#838](https://github.com/awslabs/aws-lambda-powertools-python/issues/838))
-* **event-sources:** Pass authorizer data to APIGatewayEventAuthorizer ([#897](https://github.com/awslabs/aws-lambda-powertools-python/issues/897))
-* **event-sources:** handle claimsOverrideDetails set to null ([#878](https://github.com/awslabs/aws-lambda-powertools-python/issues/878))
-* **idempotency:** include decorated fn name in hash ([#869](https://github.com/awslabs/aws-lambda-powertools-python/issues/869))
-* **metrics:** explicit type to single_metric ctx manager ([#865](https://github.com/awslabs/aws-lambda-powertools-python/issues/865))
-* **parameters:** appconfig transform and return types ([#877](https://github.com/awslabs/aws-lambda-powertools-python/issues/877))
-* **parser:** overload parse when using envelope ([#885](https://github.com/awslabs/aws-lambda-powertools-python/issues/885))
-* **parser:** kinesis sequence number is str, not int ([#907](https://github.com/awslabs/aws-lambda-powertools-python/issues/907))
-* **parser:** mypy support for payload type override as models ([#883](https://github.com/awslabs/aws-lambda-powertools-python/issues/883))
-* **tracer:** add warm start annotation (ColdStart=False) ([#851](https://github.com/awslabs/aws-lambda-powertools-python/issues/851))
+* **apigateway:** allow list of HTTP methods in route method ([#838](https://github.com/aws-powertools/powertools-lambda-python/issues/838))
+* **event-sources:** Pass authorizer data to APIGatewayEventAuthorizer ([#897](https://github.com/aws-powertools/powertools-lambda-python/issues/897))
+* **event-sources:** handle claimsOverrideDetails set to null ([#878](https://github.com/aws-powertools/powertools-lambda-python/issues/878))
+* **idempotency:** include decorated fn name in hash ([#869](https://github.com/aws-powertools/powertools-lambda-python/issues/869))
+* **metrics:** explicit type to single_metric ctx manager ([#865](https://github.com/aws-powertools/powertools-lambda-python/issues/865))
+* **parameters:** appconfig transform and return types ([#877](https://github.com/aws-powertools/powertools-lambda-python/issues/877))
+* **parser:** overload parse when using envelope ([#885](https://github.com/aws-powertools/powertools-lambda-python/issues/885))
+* **parser:** kinesis sequence number is str, not int ([#907](https://github.com/aws-powertools/powertools-lambda-python/issues/907))
+* **parser:** mypy support for payload type override as models ([#883](https://github.com/aws-powertools/powertools-lambda-python/issues/883))
+* **tracer:** add warm start annotation (ColdStart=False) ([#851](https://github.com/aws-powertools/powertools-lambda-python/issues/851))
## Documentation
-* external reference to cloudformation custom resource helper ([#914](https://github.com/awslabs/aws-lambda-powertools-python/issues/914))
+* external reference to cloudformation custom resource helper ([#914](https://github.com/aws-powertools/powertools-lambda-python/issues/914))
* add new public Slack invite
* disable search blur in non-prod env
* update Lambda Layers version
-* **apigateway:** add new not_found feature ([#915](https://github.com/awslabs/aws-lambda-powertools-python/issues/915))
-* **apigateway:** fix sample layout provided ([#864](https://github.com/awslabs/aws-lambda-powertools-python/issues/864))
-* **appsync:** fix users.py typo to locations [#830](https://github.com/awslabs/aws-lambda-powertools-python/issues/830)
+* **apigateway:** add new not_found feature ([#915](https://github.com/aws-powertools/powertools-lambda-python/issues/915))
+* **apigateway:** fix sample layout provided ([#864](https://github.com/aws-powertools/powertools-lambda-python/issues/864))
+* **appsync:** fix users.py typo to locations [#830](https://github.com/aws-powertools/powertools-lambda-python/issues/830)
* **lambda_layer:** fix CDK layer syntax
## Features
-* **apigateway:** add exception_handler support ([#898](https://github.com/awslabs/aws-lambda-powertools-python/issues/898))
-* **apigateway:** access parent api resolver from router ([#842](https://github.com/awslabs/aws-lambda-powertools-python/issues/842))
-* **batch:** new BatchProcessor for SQS, DynamoDB, Kinesis ([#886](https://github.com/awslabs/aws-lambda-powertools-python/issues/886))
-* **logger:** allow handler with custom kwargs signature ([#913](https://github.com/awslabs/aws-lambda-powertools-python/issues/913))
-* **tracer:** add service annotation when service is set ([#861](https://github.com/awslabs/aws-lambda-powertools-python/issues/861))
+* **apigateway:** add exception_handler support ([#898](https://github.com/aws-powertools/powertools-lambda-python/issues/898))
+* **apigateway:** access parent api resolver from router ([#842](https://github.com/aws-powertools/powertools-lambda-python/issues/842))
+* **batch:** new BatchProcessor for SQS, DynamoDB, Kinesis ([#886](https://github.com/aws-powertools/powertools-lambda-python/issues/886))
+* **logger:** allow handler with custom kwargs signature ([#913](https://github.com/aws-powertools/powertools-lambda-python/issues/913))
+* **tracer:** add service annotation when service is set ([#861](https://github.com/aws-powertools/powertools-lambda-python/issues/861))
## Maintenance
* correct pr label order
-* minor housekeeping before release ([#912](https://github.com/awslabs/aws-lambda-powertools-python/issues/912))
+* minor housekeeping before release ([#912](https://github.com/aws-powertools/powertools-lambda-python/issues/912))
* bump to 1.23.0
* **ci:** split latest docs workflow
-* **deps:** bump fastjsonschema from 2.15.1 to 2.15.2 ([#891](https://github.com/awslabs/aws-lambda-powertools-python/issues/891))
-* **deps:** bump actions/setup-python from 2.2.2 to 2.3.0 ([#831](https://github.com/awslabs/aws-lambda-powertools-python/issues/831))
-* **deps:** bump aws-xray-sdk from 2.8.0 to 2.9.0 ([#876](https://github.com/awslabs/aws-lambda-powertools-python/issues/876))
-* **deps:** support arm64 when developing locally ([#862](https://github.com/awslabs/aws-lambda-powertools-python/issues/862))
-* **deps:** bump actions/setup-python from 2.3.0 to 2.3.1 ([#852](https://github.com/awslabs/aws-lambda-powertools-python/issues/852))
-* **deps-dev:** bump flake8 from 3.9.2 to 4.0.1 ([#789](https://github.com/awslabs/aws-lambda-powertools-python/issues/789))
-* **deps-dev:** bump black from 21.10b0 to 21.11b1 ([#839](https://github.com/awslabs/aws-lambda-powertools-python/issues/839))
-* **deps-dev:** bump black from 21.11b1 to 21.12b0 ([#872](https://github.com/awslabs/aws-lambda-powertools-python/issues/872))
-* **deps-dev:** bump mypy from 0.910 to 0.920 ([#903](https://github.com/awslabs/aws-lambda-powertools-python/issues/903))
+* **deps:** bump fastjsonschema from 2.15.1 to 2.15.2 ([#891](https://github.com/aws-powertools/powertools-lambda-python/issues/891))
+* **deps:** bump actions/setup-python from 2.2.2 to 2.3.0 ([#831](https://github.com/aws-powertools/powertools-lambda-python/issues/831))
+* **deps:** bump aws-xray-sdk from 2.8.0 to 2.9.0 ([#876](https://github.com/aws-powertools/powertools-lambda-python/issues/876))
+* **deps:** support arm64 when developing locally ([#862](https://github.com/aws-powertools/powertools-lambda-python/issues/862))
+* **deps:** bump actions/setup-python from 2.3.0 to 2.3.1 ([#852](https://github.com/aws-powertools/powertools-lambda-python/issues/852))
+* **deps-dev:** bump flake8 from 3.9.2 to 4.0.1 ([#789](https://github.com/aws-powertools/powertools-lambda-python/issues/789))
+* **deps-dev:** bump black from 21.10b0 to 21.11b1 ([#839](https://github.com/aws-powertools/powertools-lambda-python/issues/839))
+* **deps-dev:** bump black from 21.11b1 to 21.12b0 ([#872](https://github.com/aws-powertools/powertools-lambda-python/issues/872))
+* **deps-dev:** bump mypy from 0.910 to 0.920 ([#903](https://github.com/aws-powertools/powertools-lambda-python/issues/903))
<a name="v1.22.0"></a>
## [v1.22.0] - 2021-11-17
## Bug Fixes
-* change supported python version from 3.6.1 to 3.6.2, bump black ([#807](https://github.com/awslabs/aws-lambda-powertools-python/issues/807))
+* change supported python version from 3.6.1 to 3.6.2, bump black ([#807](https://github.com/aws-powertools/powertools-lambda-python/issues/807))
* **ci:** comment custom publish version checker
* **ci:** skip sync master on docs hotfix
-* **parser:** body/QS can be null or omitted in apigw v1/v2 ([#820](https://github.com/awslabs/aws-lambda-powertools-python/issues/820))
+* **parser:** body/QS can be null or omitted in apigw v1/v2 ([#820](https://github.com/aws-powertools/powertools-lambda-python/issues/820))
## Code Refactoring
-* **apigateway:** Add BaseRouter and duplicate route check ([#757](https://github.com/awslabs/aws-lambda-powertools-python/issues/757))
+* **apigateway:** Add BaseRouter and duplicate route check ([#757](https://github.com/aws-powertools/powertools-lambda-python/issues/757))
## Documentation
-* updated Lambda Layers definition & limitations. ([#775](https://github.com/awslabs/aws-lambda-powertools-python/issues/775))
+* updated Lambda Layers definition & limitations. ([#775](https://github.com/aws-powertools/powertools-lambda-python/issues/775))
* Idiomatic tenet updated to Progressive
-* use higher contrast font ([#822](https://github.com/awslabs/aws-lambda-powertools-python/issues/822))
+* use higher contrast font ([#822](https://github.com/aws-powertools/powertools-lambda-python/issues/822))
* use higher contrast font
-* fix indentation of SAM snippets in install section ([#778](https://github.com/awslabs/aws-lambda-powertools-python/issues/778))
-* improve public lambda layer wording, clipboard buttons ([#762](https://github.com/awslabs/aws-lambda-powertools-python/issues/762))
-* add amplify-cli instructions for public layer ([#754](https://github.com/awslabs/aws-lambda-powertools-python/issues/754))
-* **api-gateway:** add support for new router feature ([#767](https://github.com/awslabs/aws-lambda-powertools-python/issues/767))
-* **apigateway:** re-add sample layout, add considerations ([#826](https://github.com/awslabs/aws-lambda-powertools-python/issues/826))
-* **appsync:** add new router feature ([#821](https://github.com/awslabs/aws-lambda-powertools-python/issues/821))
-* **idempotency:** add support for DynamoDB composite keys ([#808](https://github.com/awslabs/aws-lambda-powertools-python/issues/808))
-* **tenets:** update Idiomatic tenet to Progressive ([#823](https://github.com/awslabs/aws-lambda-powertools-python/issues/823))
+* fix indentation of SAM snippets in install section ([#778](https://github.com/aws-powertools/powertools-lambda-python/issues/778))
+* improve public lambda layer wording, clipboard buttons ([#762](https://github.com/aws-powertools/powertools-lambda-python/issues/762))
+* add amplify-cli instructions for public layer ([#754](https://github.com/aws-powertools/powertools-lambda-python/issues/754))
+* **api-gateway:** add support for new router feature ([#767](https://github.com/aws-powertools/powertools-lambda-python/issues/767))
+* **apigateway:** re-add sample layout, add considerations ([#826](https://github.com/aws-powertools/powertools-lambda-python/issues/826))
+* **appsync:** add new router feature ([#821](https://github.com/aws-powertools/powertools-lambda-python/issues/821))
+* **idempotency:** add support for DynamoDB composite keys ([#808](https://github.com/aws-powertools/powertools-lambda-python/issues/808))
+* **tenets:** update Idiomatic tenet to Progressive ([#823](https://github.com/aws-powertools/powertools-lambda-python/issues/823))
## Features
-* **apigateway:** add Router to allow large routing composition ([#645](https://github.com/awslabs/aws-lambda-powertools-python/issues/645))
-* **appsync:** add Router to allow large resolver composition ([#776](https://github.com/awslabs/aws-lambda-powertools-python/issues/776))
-* **data-classes:** ActiveMQ and RabbitMQ support ([#770](https://github.com/awslabs/aws-lambda-powertools-python/issues/770))
-* **logger:** add ALB correlation ID support ([#816](https://github.com/awslabs/aws-lambda-powertools-python/issues/816))
+* **apigateway:** add Router to allow large routing composition ([#645](https://github.com/aws-powertools/powertools-lambda-python/issues/645))
+* **appsync:** add Router to allow large resolver composition ([#776](https://github.com/aws-powertools/powertools-lambda-python/issues/776))
+* **data-classes:** ActiveMQ and RabbitMQ support ([#770](https://github.com/aws-powertools/powertools-lambda-python/issues/770))
+* **logger:** add ALB correlation ID support ([#816](https://github.com/aws-powertools/powertools-lambda-python/issues/816))
## Maintenance
@@ -977,159 +6296,159 @@
* conditional to publish docs only attempt 3
* conditional to publish docs only attempt 2
* conditional to publish docs only
-* **deps:** bump boto3 from 1.18.58 to 1.18.59 ([#760](https://github.com/awslabs/aws-lambda-powertools-python/issues/760))
-* **deps:** bump boto3 from 1.18.56 to 1.18.58 ([#755](https://github.com/awslabs/aws-lambda-powertools-python/issues/755))
-* **deps:** bump urllib3 from 1.26.4 to 1.26.5 ([#787](https://github.com/awslabs/aws-lambda-powertools-python/issues/787))
-* **deps:** bump boto3 from 1.19.6 to 1.20.3 ([#809](https://github.com/awslabs/aws-lambda-powertools-python/issues/809))
-* **deps:** bump boto3 from 1.18.61 to 1.19.6 ([#783](https://github.com/awslabs/aws-lambda-powertools-python/issues/783))
-* **deps:** bump boto3 from 1.20.3 to 1.20.5 ([#817](https://github.com/awslabs/aws-lambda-powertools-python/issues/817))
-* **deps:** bump boto3 from 1.18.59 to 1.18.61 ([#766](https://github.com/awslabs/aws-lambda-powertools-python/issues/766))
-* **deps-dev:** bump coverage from 6.0.1 to 6.0.2 ([#764](https://github.com/awslabs/aws-lambda-powertools-python/issues/764))
-* **deps-dev:** bump pytest-asyncio from 0.15.1 to 0.16.0 ([#782](https://github.com/awslabs/aws-lambda-powertools-python/issues/782))
-* **deps-dev:** bump flake8-eradicate from 1.1.0 to 1.2.0 ([#784](https://github.com/awslabs/aws-lambda-powertools-python/issues/784))
-* **deps-dev:** bump flake8-isort from 4.0.0 to 4.1.1 ([#785](https://github.com/awslabs/aws-lambda-powertools-python/issues/785))
-* **deps-dev:** bump mkdocs-material from 7.3.2 to 7.3.3 ([#758](https://github.com/awslabs/aws-lambda-powertools-python/issues/758))
-* **deps-dev:** bump flake8-comprehensions from 3.6.1 to 3.7.0 ([#759](https://github.com/awslabs/aws-lambda-powertools-python/issues/759))
-* **deps-dev:** bump mkdocs-material from 7.3.3 to 7.3.5 ([#781](https://github.com/awslabs/aws-lambda-powertools-python/issues/781))
-* **deps-dev:** bump coverage from 6.0 to 6.0.1 ([#751](https://github.com/awslabs/aws-lambda-powertools-python/issues/751))
-* **deps-dev:** bump mkdocs-material from 7.3.5 to 7.3.6 ([#791](https://github.com/awslabs/aws-lambda-powertools-python/issues/791))
-* **deps-dev:** bump coverage from 6.0.2 to 6.1.2 ([#810](https://github.com/awslabs/aws-lambda-powertools-python/issues/810))
-* **deps-dev:** bump isort from 5.9.3 to 5.10.1 ([#811](https://github.com/awslabs/aws-lambda-powertools-python/issues/811))
+* **deps:** bump boto3 from 1.18.58 to 1.18.59 ([#760](https://github.com/aws-powertools/powertools-lambda-python/issues/760))
+* **deps:** bump boto3 from 1.18.56 to 1.18.58 ([#755](https://github.com/aws-powertools/powertools-lambda-python/issues/755))
+* **deps:** bump urllib3 from 1.26.4 to 1.26.5 ([#787](https://github.com/aws-powertools/powertools-lambda-python/issues/787))
+* **deps:** bump boto3 from 1.19.6 to 1.20.3 ([#809](https://github.com/aws-powertools/powertools-lambda-python/issues/809))
+* **deps:** bump boto3 from 1.18.61 to 1.19.6 ([#783](https://github.com/aws-powertools/powertools-lambda-python/issues/783))
+* **deps:** bump boto3 from 1.20.3 to 1.20.5 ([#817](https://github.com/aws-powertools/powertools-lambda-python/issues/817))
+* **deps:** bump boto3 from 1.18.59 to 1.18.61 ([#766](https://github.com/aws-powertools/powertools-lambda-python/issues/766))
+* **deps-dev:** bump coverage from 6.0.1 to 6.0.2 ([#764](https://github.com/aws-powertools/powertools-lambda-python/issues/764))
+* **deps-dev:** bump pytest-asyncio from 0.15.1 to 0.16.0 ([#782](https://github.com/aws-powertools/powertools-lambda-python/issues/782))
+* **deps-dev:** bump flake8-eradicate from 1.1.0 to 1.2.0 ([#784](https://github.com/aws-powertools/powertools-lambda-python/issues/784))
+* **deps-dev:** bump flake8-isort from 4.0.0 to 4.1.1 ([#785](https://github.com/aws-powertools/powertools-lambda-python/issues/785))
+* **deps-dev:** bump mkdocs-material from 7.3.2 to 7.3.3 ([#758](https://github.com/aws-powertools/powertools-lambda-python/issues/758))
+* **deps-dev:** bump flake8-comprehensions from 3.6.1 to 3.7.0 ([#759](https://github.com/aws-powertools/powertools-lambda-python/issues/759))
+* **deps-dev:** bump mkdocs-material from 7.3.3 to 7.3.5 ([#781](https://github.com/aws-powertools/powertools-lambda-python/issues/781))
+* **deps-dev:** bump coverage from 6.0 to 6.0.1 ([#751](https://github.com/aws-powertools/powertools-lambda-python/issues/751))
+* **deps-dev:** bump mkdocs-material from 7.3.5 to 7.3.6 ([#791](https://github.com/aws-powertools/powertools-lambda-python/issues/791))
+* **deps-dev:** bump coverage from 6.0.2 to 6.1.2 ([#810](https://github.com/aws-powertools/powertools-lambda-python/issues/810))
+* **deps-dev:** bump isort from 5.9.3 to 5.10.1 ([#811](https://github.com/aws-powertools/powertools-lambda-python/issues/811))
<a name="v1.21.1"></a>
## [v1.21.1] - 2021-10-07
## Documentation
-* add new public layer ARNs ([#746](https://github.com/awslabs/aws-lambda-powertools-python/issues/746))
+* add new public layer ARNs ([#746](https://github.com/aws-powertools/powertools-lambda-python/issues/746))
## Maintenance
* include public layers changelog
* bump to 1.21.1
* include regression in changelog
-* ignore constants in test cov ([#745](https://github.com/awslabs/aws-lambda-powertools-python/issues/745))
+* ignore constants in test cov ([#745](https://github.com/aws-powertools/powertools-lambda-python/issues/745))
* ignore constants in tests cov
* add support for publishing fallback
-* **deps:** bump boto3 from 1.18.54 to 1.18.56 ([#742](https://github.com/awslabs/aws-lambda-powertools-python/issues/742))
-* **deps-dev:** bump mkdocs-material from 7.3.1 to 7.3.2 ([#741](https://github.com/awslabs/aws-lambda-powertools-python/issues/741))
+* **deps:** bump boto3 from 1.18.54 to 1.18.56 ([#742](https://github.com/aws-powertools/powertools-lambda-python/issues/742))
+* **deps-dev:** bump mkdocs-material from 7.3.1 to 7.3.2 ([#741](https://github.com/aws-powertools/powertools-lambda-python/issues/741))
## Regression
-* **metrics:** typing regression on log_metrics callable ([#744](https://github.com/awslabs/aws-lambda-powertools-python/issues/744))
+* **metrics:** typing regression on log_metrics callable ([#744](https://github.com/aws-powertools/powertools-lambda-python/issues/744))
<a name="v1.21.0"></a>
## [v1.21.0] - 2021-10-05
## Bug Fixes
-* **data-classes:** use correct asdict funciton ([#666](https://github.com/awslabs/aws-lambda-powertools-python/issues/666))
-* **feature-flags:** rules should evaluate with an AND op ([#724](https://github.com/awslabs/aws-lambda-powertools-python/issues/724))
-* **idempotency:** sorting keys before hashing ([#722](https://github.com/awslabs/aws-lambda-powertools-python/issues/722))
+* **data-classes:** use correct asdict funciton ([#666](https://github.com/aws-powertools/powertools-lambda-python/issues/666))
+* **feature-flags:** rules should evaluate with an AND op ([#724](https://github.com/aws-powertools/powertools-lambda-python/issues/724))
+* **idempotency:** sorting keys before hashing ([#722](https://github.com/aws-powertools/powertools-lambda-python/issues/722))
* **idempotency:** sorting keys before hashing
-* **logger:** push extra keys to the end ([#722](https://github.com/awslabs/aws-lambda-powertools-python/issues/722))
-* **mypy:** a few return types, type signatures, and untyped areas ([#718](https://github.com/awslabs/aws-lambda-powertools-python/issues/718))
+* **logger:** push extra keys to the end ([#722](https://github.com/aws-powertools/powertools-lambda-python/issues/722))
+* **mypy:** a few return types, type signatures, and untyped areas ([#718](https://github.com/aws-powertools/powertools-lambda-python/issues/718))
## Code Refactoring
-* **data-classes:** clean up internal logic for APIGatewayAuthorizerResponse ([#643](https://github.com/awslabs/aws-lambda-powertools-python/issues/643))
+* **data-classes:** clean up internal logic for APIGatewayAuthorizerResponse ([#643](https://github.com/aws-powertools/powertools-lambda-python/issues/643))
## Documentation
-* Terraform reference for SAR Lambda Layer ([#716](https://github.com/awslabs/aws-lambda-powertools-python/issues/716))
+* Terraform reference for SAR Lambda Layer ([#716](https://github.com/aws-powertools/powertools-lambda-python/issues/716))
* add team behind it and email
-* **event-handler:** document catch-all routes ([#705](https://github.com/awslabs/aws-lambda-powertools-python/issues/705))
-* **idempotency:** fix misleading idempotent examples ([#661](https://github.com/awslabs/aws-lambda-powertools-python/issues/661))
+* **event-handler:** document catch-all routes ([#705](https://github.com/aws-powertools/powertools-lambda-python/issues/705))
+* **idempotency:** fix misleading idempotent examples ([#661](https://github.com/aws-powertools/powertools-lambda-python/issues/661))
* **jmespath:** clarify envelope terminology
-* **parser:** fix incorrect import in root_validator example ([#735](https://github.com/awslabs/aws-lambda-powertools-python/issues/735))
+* **parser:** fix incorrect import in root_validator example ([#735](https://github.com/aws-powertools/powertools-lambda-python/issues/735))
## Features
-* expose jmespath powertools functions ([#736](https://github.com/awslabs/aws-lambda-powertools-python/issues/736))
+* expose jmespath powertools functions ([#736](https://github.com/aws-powertools/powertools-lambda-python/issues/736))
* add get_raw_configuration property in store; expose store
-* boto3 sessions in batch, parameters & idempotency ([#717](https://github.com/awslabs/aws-lambda-powertools-python/issues/717))
-* **feature-flags:** Bring your own logger for debug ([#709](https://github.com/awslabs/aws-lambda-powertools-python/issues/709))
-* **feature-flags:** improve "IN/NOT_IN"; new rule actions ([#710](https://github.com/awslabs/aws-lambda-powertools-python/issues/710))
-* **feature-flags:** get_raw_configuration property in Store ([#720](https://github.com/awslabs/aws-lambda-powertools-python/issues/720))
-* **feature_flags:** Added inequality conditions ([#721](https://github.com/awslabs/aws-lambda-powertools-python/issues/721))
-* **idempotency:** makes customers unit testing easier ([#719](https://github.com/awslabs/aws-lambda-powertools-python/issues/719))
-* **validator:** include missing data elements from a validation error ([#686](https://github.com/awslabs/aws-lambda-powertools-python/issues/686))
+* boto3 sessions in batch, parameters & idempotency ([#717](https://github.com/aws-powertools/powertools-lambda-python/issues/717))
+* **feature-flags:** Bring your own logger for debug ([#709](https://github.com/aws-powertools/powertools-lambda-python/issues/709))
+* **feature-flags:** improve "IN/NOT_IN"; new rule actions ([#710](https://github.com/aws-powertools/powertools-lambda-python/issues/710))
+* **feature-flags:** get_raw_configuration property in Store ([#720](https://github.com/aws-powertools/powertools-lambda-python/issues/720))
+* **feature_flags:** Added inequality conditions ([#721](https://github.com/aws-powertools/powertools-lambda-python/issues/721))
+* **idempotency:** makes customers unit testing easier ([#719](https://github.com/aws-powertools/powertools-lambda-python/issues/719))
+* **validator:** include missing data elements from a validation error ([#686](https://github.com/aws-powertools/powertools-lambda-python/issues/686))
## Maintenance
* add python 3.9 support
* bump to 1.21.0
-* **deps:** bump boto3 from 1.18.41 to 1.18.49 ([#703](https://github.com/awslabs/aws-lambda-powertools-python/issues/703))
-* **deps:** bump boto3 from 1.18.32 to 1.18.38 ([#671](https://github.com/awslabs/aws-lambda-powertools-python/issues/671))
-* **deps:** bump boto3 from 1.18.38 to 1.18.41 ([#677](https://github.com/awslabs/aws-lambda-powertools-python/issues/677))
-* **deps:** bump boto3 from 1.18.51 to 1.18.54 ([#733](https://github.com/awslabs/aws-lambda-powertools-python/issues/733))
-* **deps:** bump boto3 from 1.18.49 to 1.18.51 ([#713](https://github.com/awslabs/aws-lambda-powertools-python/issues/713))
-* **deps:** bump codecov/codecov-action from 2.0.2 to 2.1.0 ([#675](https://github.com/awslabs/aws-lambda-powertools-python/issues/675))
-* **deps-dev:** bump flake8-bugbear from 21.9.1 to 21.9.2 ([#712](https://github.com/awslabs/aws-lambda-powertools-python/issues/712))
-* **deps-dev:** bump mkdocs-material from 7.3.0 to 7.3.1 ([#731](https://github.com/awslabs/aws-lambda-powertools-python/issues/731))
-* **deps-dev:** bump mkdocs-material from 7.2.8 to 7.3.0 ([#695](https://github.com/awslabs/aws-lambda-powertools-python/issues/695))
-* **deps-dev:** bump mkdocs-material from 7.2.6 to 7.2.8 ([#682](https://github.com/awslabs/aws-lambda-powertools-python/issues/682))
-* **deps-dev:** bump flake8-bugbear from 21.4.3 to 21.9.1 ([#676](https://github.com/awslabs/aws-lambda-powertools-python/issues/676))
-* **deps-dev:** bump coverage from 5.5 to 6.0 ([#732](https://github.com/awslabs/aws-lambda-powertools-python/issues/732))
-* **deps-dev:** bump radon from 4.5.2 to 5.1.0 ([#673](https://github.com/awslabs/aws-lambda-powertools-python/issues/673))
-* **deps-dev:** bump pytest-cov from 2.12.1 to 3.0.0 ([#730](https://github.com/awslabs/aws-lambda-powertools-python/issues/730))
-* **deps-dev:** bump xenon from 0.7.3 to 0.8.0 ([#669](https://github.com/awslabs/aws-lambda-powertools-python/issues/669))
+* **deps:** bump boto3 from 1.18.41 to 1.18.49 ([#703](https://github.com/aws-powertools/powertools-lambda-python/issues/703))
+* **deps:** bump boto3 from 1.18.32 to 1.18.38 ([#671](https://github.com/aws-powertools/powertools-lambda-python/issues/671))
+* **deps:** bump boto3 from 1.18.38 to 1.18.41 ([#677](https://github.com/aws-powertools/powertools-lambda-python/issues/677))
+* **deps:** bump boto3 from 1.18.51 to 1.18.54 ([#733](https://github.com/aws-powertools/powertools-lambda-python/issues/733))
+* **deps:** bump boto3 from 1.18.49 to 1.18.51 ([#713](https://github.com/aws-powertools/powertools-lambda-python/issues/713))
+* **deps:** bump codecov/codecov-action from 2.0.2 to 2.1.0 ([#675](https://github.com/aws-powertools/powertools-lambda-python/issues/675))
+* **deps-dev:** bump flake8-bugbear from 21.9.1 to 21.9.2 ([#712](https://github.com/aws-powertools/powertools-lambda-python/issues/712))
+* **deps-dev:** bump mkdocs-material from 7.3.0 to 7.3.1 ([#731](https://github.com/aws-powertools/powertools-lambda-python/issues/731))
+* **deps-dev:** bump mkdocs-material from 7.2.8 to 7.3.0 ([#695](https://github.com/aws-powertools/powertools-lambda-python/issues/695))
+* **deps-dev:** bump mkdocs-material from 7.2.6 to 7.2.8 ([#682](https://github.com/aws-powertools/powertools-lambda-python/issues/682))
+* **deps-dev:** bump flake8-bugbear from 21.4.3 to 21.9.1 ([#676](https://github.com/aws-powertools/powertools-lambda-python/issues/676))
+* **deps-dev:** bump coverage from 5.5 to 6.0 ([#732](https://github.com/aws-powertools/powertools-lambda-python/issues/732))
+* **deps-dev:** bump radon from 4.5.2 to 5.1.0 ([#673](https://github.com/aws-powertools/powertools-lambda-python/issues/673))
+* **deps-dev:** bump pytest-cov from 2.12.1 to 3.0.0 ([#730](https://github.com/aws-powertools/powertools-lambda-python/issues/730))
+* **deps-dev:** bump xenon from 0.7.3 to 0.8.0 ([#669](https://github.com/aws-powertools/powertools-lambda-python/issues/669))
<a name="v1.20.2"></a>
## [v1.20.2] - 2021-09-02
## Bug Fixes
-* Fix issue with strip_prefixes ([#647](https://github.com/awslabs/aws-lambda-powertools-python/issues/647))
+* Fix issue with strip_prefixes ([#647](https://github.com/aws-powertools/powertools-lambda-python/issues/647))
## Maintenance
* bump to 1.20.2
-* **deps:** bump boto3 from 1.18.26 to 1.18.32 ([#663](https://github.com/awslabs/aws-lambda-powertools-python/issues/663))
-* **deps-dev:** bump mkdocs-material from 7.2.4 to 7.2.6 ([#665](https://github.com/awslabs/aws-lambda-powertools-python/issues/665))
-* **deps-dev:** bump pytest from 6.2.4 to 6.2.5 ([#662](https://github.com/awslabs/aws-lambda-powertools-python/issues/662))
-* **license:** Add THIRD-PARTY-LICENSES ([#641](https://github.com/awslabs/aws-lambda-powertools-python/issues/641))
+* **deps:** bump boto3 from 1.18.26 to 1.18.32 ([#663](https://github.com/aws-powertools/powertools-lambda-python/issues/663))
+* **deps-dev:** bump mkdocs-material from 7.2.4 to 7.2.6 ([#665](https://github.com/aws-powertools/powertools-lambda-python/issues/665))
+* **deps-dev:** bump pytest from 6.2.4 to 6.2.5 ([#662](https://github.com/aws-powertools/powertools-lambda-python/issues/662))
+* **license:** Add THIRD-PARTY-LICENSES ([#641](https://github.com/aws-powertools/powertools-lambda-python/issues/641))
<a name="v1.20.1"></a>
## [v1.20.1] - 2021-08-22
## Bug Fixes
-* **idempotency:** sorting keys before hashing ([#639](https://github.com/awslabs/aws-lambda-powertools-python/issues/639))
+* **idempotency:** sorting keys before hashing ([#639](https://github.com/aws-powertools/powertools-lambda-python/issues/639))
## Maintenance
* bump to 1.20.1
-* markdown linter fixes ([#636](https://github.com/awslabs/aws-lambda-powertools-python/issues/636))
-* setup codespaces ([#637](https://github.com/awslabs/aws-lambda-powertools-python/issues/637))
-* **license:** add third party license ([#635](https://github.com/awslabs/aws-lambda-powertools-python/issues/635))
+* markdown linter fixes ([#636](https://github.com/aws-powertools/powertools-lambda-python/issues/636))
+* setup codespaces ([#637](https://github.com/aws-powertools/powertools-lambda-python/issues/637))
+* **license:** add third party license ([#635](https://github.com/aws-powertools/powertools-lambda-python/issues/635))
<a name="v1.20.0"></a>
## [v1.20.0] - 2021-08-21
## Bug Fixes
-* **api-gateway:** HTTP API strip stage name from request path ([#622](https://github.com/awslabs/aws-lambda-powertools-python/issues/622))
-* **docs:** correct feature_flags link and json exmaples ([#605](https://github.com/awslabs/aws-lambda-powertools-python/issues/605))
+* **api-gateway:** HTTP API strip stage name from request path ([#622](https://github.com/aws-powertools/powertools-lambda-python/issues/622))
+* **docs:** correct feature_flags link and json exmaples ([#605](https://github.com/aws-powertools/powertools-lambda-python/issues/605))
## Code Refactoring
-* **event_handler:** match to match_results; 3.10 new keyword ([#616](https://github.com/awslabs/aws-lambda-powertools-python/issues/616))
+* **event_handler:** match to match_results; 3.10 new keyword ([#616](https://github.com/aws-powertools/powertools-lambda-python/issues/616))
## Documentation
* **api-gateway:** add new API mapping support
* **data-class:** fix invalid syntax in new AppSync Authorizer
-* **data-classes:** make authorizer concise; use enum ([#630](https://github.com/awslabs/aws-lambda-powertools-python/issues/630))
+* **data-classes:** make authorizer concise; use enum ([#630](https://github.com/aws-powertools/powertools-lambda-python/issues/630))
## Features
-* **data-classes:** authorizer for http api and rest api ([#620](https://github.com/awslabs/aws-lambda-powertools-python/issues/620))
-* **data-classes:** data_as_bytes prop KinesisStreamRecordPayload ([#628](https://github.com/awslabs/aws-lambda-powertools-python/issues/628))
-* **data-classes:** AppSync Lambda authorizer event ([#610](https://github.com/awslabs/aws-lambda-powertools-python/issues/610))
-* **event-handler:** prefixes to strip for custom mappings ([#579](https://github.com/awslabs/aws-lambda-powertools-python/issues/579))
-* **general:** support for Python 3.9 ([#626](https://github.com/awslabs/aws-lambda-powertools-python/issues/626))
-* **idempotency:** support for any synchronous function ([#625](https://github.com/awslabs/aws-lambda-powertools-python/issues/625))
+* **data-classes:** authorizer for http api and rest api ([#620](https://github.com/aws-powertools/powertools-lambda-python/issues/620))
+* **data-classes:** data_as_bytes prop KinesisStreamRecordPayload ([#628](https://github.com/aws-powertools/powertools-lambda-python/issues/628))
+* **data-classes:** AppSync Lambda authorizer event ([#610](https://github.com/aws-powertools/powertools-lambda-python/issues/610))
+* **event-handler:** prefixes to strip for custom mappings ([#579](https://github.com/aws-powertools/powertools-lambda-python/issues/579))
+* **general:** support for Python 3.9 ([#626](https://github.com/aws-powertools/powertools-lambda-python/issues/626))
+* **idempotency:** support for any synchronous function ([#625](https://github.com/aws-powertools/powertools-lambda-python/issues/625))
## Maintenance
@@ -1137,52 +6456,52 @@
* bump to 1.20.0
* update new changelog version tag
* **actions:** include new labels
-* **api-docs:** enable allow_reuse to fix the docs ([#612](https://github.com/awslabs/aws-lambda-powertools-python/issues/612))
-* **deps:** bump boto3 from 1.18.25 to 1.18.26 ([#627](https://github.com/awslabs/aws-lambda-powertools-python/issues/627))
-* **deps:** bump boto3 from 1.18.24 to 1.18.25 ([#623](https://github.com/awslabs/aws-lambda-powertools-python/issues/623))
-* **deps:** bump boto3 from 1.18.22 to 1.18.24 ([#619](https://github.com/awslabs/aws-lambda-powertools-python/issues/619))
-* **deps:** bump boto3 from 1.18.21 to 1.18.22 ([#614](https://github.com/awslabs/aws-lambda-powertools-python/issues/614))
-* **deps:** bump boto3 from 1.18.17 to 1.18.21 ([#608](https://github.com/awslabs/aws-lambda-powertools-python/issues/608))
-* **deps-dev:** bump flake8-comprehensions from 3.6.0 to 3.6.1 ([#615](https://github.com/awslabs/aws-lambda-powertools-python/issues/615))
-* **deps-dev:** bump flake8-comprehensions from 3.5.0 to 3.6.0 ([#609](https://github.com/awslabs/aws-lambda-powertools-python/issues/609))
-* **deps-dev:** bump mkdocs-material from 7.2.3 to 7.2.4 ([#607](https://github.com/awslabs/aws-lambda-powertools-python/issues/607))
-* **docs:** correct markdown based on markdown lint ([#603](https://github.com/awslabs/aws-lambda-powertools-python/issues/603))
-* **shared:** fix cyclic import & refactor data extraction fn ([#613](https://github.com/awslabs/aws-lambda-powertools-python/issues/613))
+* **api-docs:** enable allow_reuse to fix the docs ([#612](https://github.com/aws-powertools/powertools-lambda-python/issues/612))
+* **deps:** bump boto3 from 1.18.25 to 1.18.26 ([#627](https://github.com/aws-powertools/powertools-lambda-python/issues/627))
+* **deps:** bump boto3 from 1.18.24 to 1.18.25 ([#623](https://github.com/aws-powertools/powertools-lambda-python/issues/623))
+* **deps:** bump boto3 from 1.18.22 to 1.18.24 ([#619](https://github.com/aws-powertools/powertools-lambda-python/issues/619))
+* **deps:** bump boto3 from 1.18.21 to 1.18.22 ([#614](https://github.com/aws-powertools/powertools-lambda-python/issues/614))
+* **deps:** bump boto3 from 1.18.17 to 1.18.21 ([#608](https://github.com/aws-powertools/powertools-lambda-python/issues/608))
+* **deps-dev:** bump flake8-comprehensions from 3.6.0 to 3.6.1 ([#615](https://github.com/aws-powertools/powertools-lambda-python/issues/615))
+* **deps-dev:** bump flake8-comprehensions from 3.5.0 to 3.6.0 ([#609](https://github.com/aws-powertools/powertools-lambda-python/issues/609))
+* **deps-dev:** bump mkdocs-material from 7.2.3 to 7.2.4 ([#607](https://github.com/aws-powertools/powertools-lambda-python/issues/607))
+* **docs:** correct markdown based on markdown lint ([#603](https://github.com/aws-powertools/powertools-lambda-python/issues/603))
+* **shared:** fix cyclic import & refactor data extraction fn ([#613](https://github.com/aws-powertools/powertools-lambda-python/issues/613))
<a name="v1.19.0"></a>
## [v1.19.0] - 2021-08-11
## Bug Fixes
-* **deps:** bump poetry to latest ([#592](https://github.com/awslabs/aws-lambda-powertools-python/issues/592))
-* **feature-flags:** bug handling multiple conditions ([#599](https://github.com/awslabs/aws-lambda-powertools-python/issues/599))
-* **feature-toggles:** correct cdk example ([#601](https://github.com/awslabs/aws-lambda-powertools-python/issues/601))
-* **parser:** apigw wss validation check_message_id; housekeeping ([#553](https://github.com/awslabs/aws-lambda-powertools-python/issues/553))
+* **deps:** bump poetry to latest ([#592](https://github.com/aws-powertools/powertools-lambda-python/issues/592))
+* **feature-flags:** bug handling multiple conditions ([#599](https://github.com/aws-powertools/powertools-lambda-python/issues/599))
+* **feature-toggles:** correct cdk example ([#601](https://github.com/aws-powertools/powertools-lambda-python/issues/601))
+* **parser:** apigw wss validation check_message_id; housekeeping ([#553](https://github.com/aws-powertools/powertools-lambda-python/issues/553))
## Code Refactoring
-* **feature-flags:** add debug for all features evaluation" ([#590](https://github.com/awslabs/aws-lambda-powertools-python/issues/590))
-* **feature_flags:** optimize UX and maintenance ([#563](https://github.com/awslabs/aws-lambda-powertools-python/issues/563))
+* **feature-flags:** add debug for all features evaluation" ([#590](https://github.com/aws-powertools/powertools-lambda-python/issues/590))
+* **feature_flags:** optimize UX and maintenance ([#563](https://github.com/aws-powertools/powertools-lambda-python/issues/563))
## Documentation
* **event-handler:** new custom serializer option
* **feature-flags:** add guidance when to use vs env vars vs parameters
* **feature-flags:** fix sample feature name in evaluate
-* **feature-flags:** create concrete documentation ([#594](https://github.com/awslabs/aws-lambda-powertools-python/issues/594))
-* **feature-toggles:** correct docs and typing ([#588](https://github.com/awslabs/aws-lambda-powertools-python/issues/588))
+* **feature-flags:** create concrete documentation ([#594](https://github.com/aws-powertools/powertools-lambda-python/issues/594))
+* **feature-toggles:** correct docs and typing ([#588](https://github.com/aws-powertools/powertools-lambda-python/issues/588))
* **feature_flags:** fix SAM infra, convert CDK to Python
-* **parameters:** auto-transforming values based on suffix ([#573](https://github.com/awslabs/aws-lambda-powertools-python/issues/573))
-* **readme:** add code coverage badge ([#577](https://github.com/awslabs/aws-lambda-powertools-python/issues/577))
+* **parameters:** auto-transforming values based on suffix ([#573](https://github.com/aws-powertools/powertools-lambda-python/issues/573))
+* **readme:** add code coverage badge ([#577](https://github.com/aws-powertools/powertools-lambda-python/issues/577))
* **tracer:** update wording that it auto-disables on non-Lambda env
## Features
-* **api-gateway:** add support for custom serializer ([#568](https://github.com/awslabs/aws-lambda-powertools-python/issues/568))
-* **data-classes:** decode json_body if based64 encoded ([#560](https://github.com/awslabs/aws-lambda-powertools-python/issues/560))
-* **feature flags:** Add not_in action and rename contains to in ([#589](https://github.com/awslabs/aws-lambda-powertools-python/issues/589))
-* **params:** expose high level max_age, raise_on_transform_error ([#567](https://github.com/awslabs/aws-lambda-powertools-python/issues/567))
-* **tracer:** disable tracer when for non-Lambda envs ([#598](https://github.com/awslabs/aws-lambda-powertools-python/issues/598))
+* **api-gateway:** add support for custom serializer ([#568](https://github.com/aws-powertools/powertools-lambda-python/issues/568))
+* **data-classes:** decode json_body if based64 encoded ([#560](https://github.com/aws-powertools/powertools-lambda-python/issues/560))
+* **feature flags:** Add not_in action and rename contains to in ([#589](https://github.com/aws-powertools/powertools-lambda-python/issues/589))
+* **params:** expose high level max_age, raise_on_transform_error ([#567](https://github.com/aws-powertools/powertools-lambda-python/issues/567))
+* **tracer:** disable tracer when for non-Lambda envs ([#598](https://github.com/aws-powertools/powertools-lambda-python/issues/598))
## Maintenance
@@ -1191,23 +6510,23 @@
* bump to 1.19.0
* enable autolabel based on PR title
* include feature-flags docs hotfix
-* **deps:** bump boto3 from 1.18.15 to 1.18.17 ([#597](https://github.com/awslabs/aws-lambda-powertools-python/issues/597))
-* **deps:** bump boto3 from 1.18.1 to 1.18.15 ([#591](https://github.com/awslabs/aws-lambda-powertools-python/issues/591))
-* **deps:** bump codecov/codecov-action from 2.0.1 to 2.0.2 ([#558](https://github.com/awslabs/aws-lambda-powertools-python/issues/558))
-* **deps-dev:** bump mkdocs-material from 7.2.1 to 7.2.2 ([#582](https://github.com/awslabs/aws-lambda-powertools-python/issues/582))
-* **deps-dev:** bump mkdocs-material from 7.2.2 to 7.2.3 ([#596](https://github.com/awslabs/aws-lambda-powertools-python/issues/596))
-* **deps-dev:** bump pdoc3 from 0.9.2 to 0.10.0 ([#584](https://github.com/awslabs/aws-lambda-powertools-python/issues/584))
-* **deps-dev:** bump isort from 5.9.2 to 5.9.3 ([#574](https://github.com/awslabs/aws-lambda-powertools-python/issues/574))
-* **deps-dev:** bump mkdocs-material from 7.2.0 to 7.2.1 ([#566](https://github.com/awslabs/aws-lambda-powertools-python/issues/566))
-* **deps-dev:** bump mkdocs-material from 7.1.11 to 7.2.0 ([#551](https://github.com/awslabs/aws-lambda-powertools-python/issues/551))
-* **deps-dev:** bump flake8-black from 0.2.1 to 0.2.3 ([#541](https://github.com/awslabs/aws-lambda-powertools-python/issues/541))
+* **deps:** bump boto3 from 1.18.15 to 1.18.17 ([#597](https://github.com/aws-powertools/powertools-lambda-python/issues/597))
+* **deps:** bump boto3 from 1.18.1 to 1.18.15 ([#591](https://github.com/aws-powertools/powertools-lambda-python/issues/591))
+* **deps:** bump codecov/codecov-action from 2.0.1 to 2.0.2 ([#558](https://github.com/aws-powertools/powertools-lambda-python/issues/558))
+* **deps-dev:** bump mkdocs-material from 7.2.1 to 7.2.2 ([#582](https://github.com/aws-powertools/powertools-lambda-python/issues/582))
+* **deps-dev:** bump mkdocs-material from 7.2.2 to 7.2.3 ([#596](https://github.com/aws-powertools/powertools-lambda-python/issues/596))
+* **deps-dev:** bump pdoc3 from 0.9.2 to 0.10.0 ([#584](https://github.com/aws-powertools/powertools-lambda-python/issues/584))
+* **deps-dev:** bump isort from 5.9.2 to 5.9.3 ([#574](https://github.com/aws-powertools/powertools-lambda-python/issues/574))
+* **deps-dev:** bump mkdocs-material from 7.2.0 to 7.2.1 ([#566](https://github.com/aws-powertools/powertools-lambda-python/issues/566))
+* **deps-dev:** bump mkdocs-material from 7.1.11 to 7.2.0 ([#551](https://github.com/aws-powertools/powertools-lambda-python/issues/551))
+* **deps-dev:** bump flake8-black from 0.2.1 to 0.2.3 ([#541](https://github.com/aws-powertools/powertools-lambda-python/issues/541))
<a name="v1.18.1"></a>
## [v1.18.1] - 2021-07-23
## Bug Fixes
-* **api-gateway:** route regression non-word and unsafe URI chars ([#556](https://github.com/awslabs/aws-lambda-powertools-python/issues/556))
+* **api-gateway:** route regression non-word and unsafe URI chars ([#556](https://github.com/aws-powertools/powertools-lambda-python/issues/556))
## Maintenance
@@ -1218,41 +6537,41 @@
## [v1.18.0] - 2021-07-20
## Bug Fixes
-* **api-gateway:** non-greedy route pattern regex ([#533](https://github.com/awslabs/aws-lambda-powertools-python/issues/533))
-* **api-gateway:** incorrect plain text mimetype [#506](https://github.com/awslabs/aws-lambda-powertools-python/issues/506)
-* **data-classes:** include milliseconds in scalar types ([#504](https://github.com/awslabs/aws-lambda-powertools-python/issues/504))
-* **mypy:** fixes to resolve no implicit optional errors ([#521](https://github.com/awslabs/aws-lambda-powertools-python/issues/521))
-* **parser:** Make ApiGateway version, authorizer fields optional ([#532](https://github.com/awslabs/aws-lambda-powertools-python/issues/532))
-* **tracer:** mypy generic to preserve decorated method signature ([#529](https://github.com/awslabs/aws-lambda-powertools-python/issues/529))
+* **api-gateway:** non-greedy route pattern regex ([#533](https://github.com/aws-powertools/powertools-lambda-python/issues/533))
+* **api-gateway:** incorrect plain text mimetype [#506](https://github.com/aws-powertools/powertools-lambda-python/issues/506)
+* **data-classes:** include milliseconds in scalar types ([#504](https://github.com/aws-powertools/powertools-lambda-python/issues/504))
+* **mypy:** fixes to resolve no implicit optional errors ([#521](https://github.com/aws-powertools/powertools-lambda-python/issues/521))
+* **parser:** Make ApiGateway version, authorizer fields optional ([#532](https://github.com/aws-powertools/powertools-lambda-python/issues/532))
+* **tracer:** mypy generic to preserve decorated method signature ([#529](https://github.com/aws-powertools/powertools-lambda-python/issues/529))
## Code Refactoring
-* **feature-toggles:** Code coverage and housekeeping ([#530](https://github.com/awslabs/aws-lambda-powertools-python/issues/530))
+* **feature-toggles:** Code coverage and housekeeping ([#530](https://github.com/aws-powertools/powertools-lambda-python/issues/530))
## Documentation
-* **api-gateway:** document new HTTP service error exceptions ([#546](https://github.com/awslabs/aws-lambda-powertools-python/issues/546))
-* **logger:** document new get_correlation_id method ([#545](https://github.com/awslabs/aws-lambda-powertools-python/issues/545))
+* **api-gateway:** document new HTTP service error exceptions ([#546](https://github.com/aws-powertools/powertools-lambda-python/issues/546))
+* **logger:** document new get_correlation_id method ([#545](https://github.com/aws-powertools/powertools-lambda-python/issues/545))
## Features
-* **api-gateway:** add debug mode ([#507](https://github.com/awslabs/aws-lambda-powertools-python/issues/507))
-* **api-gateway:** add common service errors ([#506](https://github.com/awslabs/aws-lambda-powertools-python/issues/506))
-* **event-handler:** Support AppSyncResolverEvent subclassing ([#526](https://github.com/awslabs/aws-lambda-powertools-python/issues/526))
-* **feat-toggle:** New simple feature toggles rule engine (WIP) ([#494](https://github.com/awslabs/aws-lambda-powertools-python/issues/494))
-* **logger:** add get_correlation_id method ([#516](https://github.com/awslabs/aws-lambda-powertools-python/issues/516))
-* **mypy:** add mypy support to makefile ([#508](https://github.com/awslabs/aws-lambda-powertools-python/issues/508))
+* **api-gateway:** add debug mode ([#507](https://github.com/aws-powertools/powertools-lambda-python/issues/507))
+* **api-gateway:** add common service errors ([#506](https://github.com/aws-powertools/powertools-lambda-python/issues/506))
+* **event-handler:** Support AppSyncResolverEvent subclassing ([#526](https://github.com/aws-powertools/powertools-lambda-python/issues/526))
+* **feat-toggle:** New simple feature toggles rule engine (WIP) ([#494](https://github.com/aws-powertools/powertools-lambda-python/issues/494))
+* **logger:** add get_correlation_id method ([#516](https://github.com/aws-powertools/powertools-lambda-python/issues/516))
+* **mypy:** add mypy support to makefile ([#508](https://github.com/aws-powertools/powertools-lambda-python/issues/508))
## Maintenance
-* bump 1.18.0 ([#547](https://github.com/awslabs/aws-lambda-powertools-python/issues/547))
-* **deps:** bump codecov/codecov-action from 1 to 2.0.1 ([#539](https://github.com/awslabs/aws-lambda-powertools-python/issues/539))
-* **deps:** bump boto3 from 1.18.0 to 1.18.1 ([#528](https://github.com/awslabs/aws-lambda-powertools-python/issues/528))
-* **deps:** bump boto3 from 1.17.110 to 1.18.0 ([#527](https://github.com/awslabs/aws-lambda-powertools-python/issues/527))
-* **deps:** bump boto3 from 1.17.102 to 1.17.110 ([#523](https://github.com/awslabs/aws-lambda-powertools-python/issues/523))
-* **deps-dev:** bump mkdocs-material from 7.1.10 to 7.1.11 ([#542](https://github.com/awslabs/aws-lambda-powertools-python/issues/542))
-* **deps-dev:** bump mkdocs-material from 7.1.9 to 7.1.10 ([#522](https://github.com/awslabs/aws-lambda-powertools-python/issues/522))
-* **deps-dev:** bump isort from 5.9.1 to 5.9.2 ([#514](https://github.com/awslabs/aws-lambda-powertools-python/issues/514))
+* bump 1.18.0 ([#547](https://github.com/aws-powertools/powertools-lambda-python/issues/547))
+* **deps:** bump codecov/codecov-action from 1 to 2.0.1 ([#539](https://github.com/aws-powertools/powertools-lambda-python/issues/539))
+* **deps:** bump boto3 from 1.18.0 to 1.18.1 ([#528](https://github.com/aws-powertools/powertools-lambda-python/issues/528))
+* **deps:** bump boto3 from 1.17.110 to 1.18.0 ([#527](https://github.com/aws-powertools/powertools-lambda-python/issues/527))
+* **deps:** bump boto3 from 1.17.102 to 1.17.110 ([#523](https://github.com/aws-powertools/powertools-lambda-python/issues/523))
+* **deps-dev:** bump mkdocs-material from 7.1.10 to 7.1.11 ([#542](https://github.com/aws-powertools/powertools-lambda-python/issues/542))
+* **deps-dev:** bump mkdocs-material from 7.1.9 to 7.1.10 ([#522](https://github.com/aws-powertools/powertools-lambda-python/issues/522))
+* **deps-dev:** bump isort from 5.9.1 to 5.9.2 ([#514](https://github.com/aws-powertools/powertools-lambda-python/issues/514))
* **event-handler:** adjusts exception docstrings to not confuse AppSync customers
@@ -1260,69 +6579,68 @@
## [v1.17.1] - 2021-07-02
## Bug Fixes
-* **validator:** handle built-in custom formats correctly ([#498](https://github.com/awslabs/aws-lambda-powertools-python/issues/498))
+* **validator:** handle built-in custom formats correctly ([#498](https://github.com/aws-powertools/powertools-lambda-python/issues/498))
## Documentation
-* add Layers example for Serverless framework & CDK ([#500](https://github.com/awslabs/aws-lambda-powertools-python/issues/500))
-* enable dark mode switch ([#471](https://github.com/awslabs/aws-lambda-powertools-python/issues/471))
-* **logger:** add FAQ for cross-account searches ([#501](https://github.com/awslabs/aws-lambda-powertools-python/issues/501))
-* **tracer:** additional scenario when to disable auto-capture ([#499](https://github.com/awslabs/aws-lambda-powertools-python/issues/499))
+* add Layers example for Serverless framework & CDK ([#500](https://github.com/aws-powertools/powertools-lambda-python/issues/500))
+* enable dark mode switch ([#471](https://github.com/aws-powertools/powertools-lambda-python/issues/471))
+* **logger:** add FAQ for cross-account searches ([#501](https://github.com/aws-powertools/powertools-lambda-python/issues/501))
+* **tracer:** additional scenario when to disable auto-capture ([#499](https://github.com/aws-powertools/powertools-lambda-python/issues/499))
## Maintenance
-* bump 1.17.1 ([#502](https://github.com/awslabs/aws-lambda-powertools-python/issues/502))
-* **deps:** bump boto3 from 1.17.101 to 1.17.102 ([#493](https://github.com/awslabs/aws-lambda-powertools-python/issues/493))
-* **deps:** bump boto3 from 1.17.91 to 1.17.101 ([#490](https://github.com/awslabs/aws-lambda-powertools-python/issues/490))
-* **deps:** bump email-validator from 1.1.2 to 1.1.3 ([#478](https://github.com/awslabs/aws-lambda-powertools-python/issues/478))
-* **deps:** bump boto3 from 1.17.89 to 1.17.91 ([#473](https://github.com/awslabs/aws-lambda-powertools-python/issues/473))
-* **deps-dev:** bump flake8-eradicate from 1.0.0 to 1.1.0 ([#492](https://github.com/awslabs/aws-lambda-powertools-python/issues/492))
-* **deps-dev:** bump isort from 5.8.0 to 5.9.1 ([#487](https://github.com/awslabs/aws-lambda-powertools-python/issues/487))
-* **deps-dev:** bump mkdocs-material from 7.1.7 to 7.1.9 ([#491](https://github.com/awslabs/aws-lambda-powertools-python/issues/491))
+* bump 1.17.1 ([#502](https://github.com/aws-powertools/powertools-lambda-python/issues/502))
+* **deps:** bump boto3 from 1.17.101 to 1.17.102 ([#493](https://github.com/aws-powertools/powertools-lambda-python/issues/493))
+* **deps:** bump boto3 from 1.17.91 to 1.17.101 ([#490](https://github.com/aws-powertools/powertools-lambda-python/issues/490))
+* **deps:** bump email-validator from 1.1.2 to 1.1.3 ([#478](https://github.com/aws-powertools/powertools-lambda-python/issues/478))
+* **deps:** bump boto3 from 1.17.89 to 1.17.91 ([#473](https://github.com/aws-powertools/powertools-lambda-python/issues/473))
+* **deps-dev:** bump flake8-eradicate from 1.0.0 to 1.1.0 ([#492](https://github.com/aws-powertools/powertools-lambda-python/issues/492))
+* **deps-dev:** bump isort from 5.8.0 to 5.9.1 ([#487](https://github.com/aws-powertools/powertools-lambda-python/issues/487))
+* **deps-dev:** bump mkdocs-material from 7.1.7 to 7.1.9 ([#491](https://github.com/aws-powertools/powertools-lambda-python/issues/491))
<a name="v1.17.0"></a>
## [v1.17.0] - 2021-06-08
## Documentation
-* include new public roadmap ([#452](https://github.com/awslabs/aws-lambda-powertools-python/issues/452))
+* include new public roadmap ([#452](https://github.com/aws-powertools/powertools-lambda-python/issues/452))
* **data_classes:** fix missing dynamodb stream get_type/value
* **idempotency:** remove old todo
## Features
-* **data-classes:** add AttributeValueType to DynamoDBStreamEvent ([#462](https://github.com/awslabs/aws-lambda-powertools-python/issues/462))
-* **data-classes:** decorator to instantiate data_classes and docs updates ([#442](https://github.com/awslabs/aws-lambda-powertools-python/issues/442))
-* **logger:** add option to clear state per invocation ([#467](https://github.com/awslabs/aws-lambda-powertools-python/issues/467))
-* **parser:** add support for API Gateway HTTP API [#434](https://github.com/awslabs/aws-lambda-powertools-python/issues/434) ([#441](https://github.com/awslabs/aws-lambda-powertools-python/issues/441))
+* **data-classes:** add AttributeValueType to DynamoDBStreamEvent ([#462](https://github.com/aws-powertools/powertools-lambda-python/issues/462))
+* **data-classes:** decorator to instantiate data_classes and docs updates ([#442](https://github.com/aws-powertools/powertools-lambda-python/issues/442))
+* **logger:** add option to clear state per invocation ([#467](https://github.com/aws-powertools/powertools-lambda-python/issues/467))
+* **parser:** add support for API Gateway HTTP API [#434](https://github.com/aws-powertools/powertools-lambda-python/issues/434) ([#441](https://github.com/aws-powertools/powertools-lambda-python/issues/441))
## Maintenance
-* bump xenon from 0.7.1 to 0.7.3 ([#446](https://github.com/awslabs/aws-lambda-powertools-python/issues/446))
+* bump xenon from 0.7.1 to 0.7.3 ([#446](https://github.com/aws-powertools/powertools-lambda-python/issues/446))
* fix changelog file redirection
* include dependencies label under maintenance
* ignore codecov upload
* reintroduce codecov token
* fix path for PR auto-labelling
-* assited changelog pre-generation, auto-label PR ([#443](https://github.com/awslabs/aws-lambda-powertools-python/issues/443))
-* enable dependabot for dep upgrades ([#444](https://github.com/awslabs/aws-lambda-powertools-python/issues/444))
-* enable mergify ([#450](https://github.com/awslabs/aws-lambda-powertools-python/issues/450))
+* assited changelog pre-generation, auto-label PR ([#443](https://github.com/aws-powertools/powertools-lambda-python/issues/443))
+* enable dependabot for dep upgrades ([#444](https://github.com/aws-powertools/powertools-lambda-python/issues/444))
+* enable mergify ([#450](https://github.com/aws-powertools/powertools-lambda-python/issues/450))
* dependabot/mergify guardrail for major versions
* fix dependabot commit messages prefix
* fix dependabot unique set config
-* bump mkdocs-material from 7.1.5 to 7.1.6 ([#451](https://github.com/awslabs/aws-lambda-powertools-python/issues/451))
-* bump version to 1.17.0
-* bump boto3 from 1.17.78 to 1.17.84 ([#449](https://github.com/awslabs/aws-lambda-powertools-python/issues/449))
-* update mergify to require approval on dependabot ([#456](https://github.com/awslabs/aws-lambda-powertools-python/issues/456))
-* bump actions/setup-python from 1 to 2.2.2 ([#445](https://github.com/awslabs/aws-lambda-powertools-python/issues/445))
+* bump mkdocs-material from 7.1.5 to 7.1.6 ([#451](https://github.com/aws-powertools/powertools-lambda-python/issues/451))
+* bump boto3 from 1.17.78 to 1.17.84 ([#449](https://github.com/aws-powertools/powertools-lambda-python/issues/449))
+* update mergify to require approval on dependabot ([#456](https://github.com/aws-powertools/powertools-lambda-python/issues/456))
+* bump actions/setup-python from 1 to 2.2.2 ([#445](https://github.com/aws-powertools/powertools-lambda-python/issues/445))
* trial boring cyborg automation
-* **deps:** bump boto3 from 1.17.87 to 1.17.88 ([#463](https://github.com/awslabs/aws-lambda-powertools-python/issues/463))
-* **deps:** bump boto3 from 1.17.88 to 1.17.89 ([#466](https://github.com/awslabs/aws-lambda-powertools-python/issues/466))
-* **deps:** bump boto3 from 1.17.84 to 1.17.85 ([#455](https://github.com/awslabs/aws-lambda-powertools-python/issues/455))
-* **deps:** bump boto3 from 1.17.85 to 1.17.86 ([#458](https://github.com/awslabs/aws-lambda-powertools-python/issues/458))
-* **deps:** bump boto3 from 1.17.86 to 1.17.87 ([#459](https://github.com/awslabs/aws-lambda-powertools-python/issues/459))
-* **deps-dev:** bump mkdocs-material from 7.1.6 to 7.1.7 ([#464](https://github.com/awslabs/aws-lambda-powertools-python/issues/464))
-* **deps-dev:** bump pytest-cov from 2.12.0 to 2.12.1 ([#454](https://github.com/awslabs/aws-lambda-powertools-python/issues/454))
+* **deps:** bump boto3 from 1.17.87 to 1.17.88 ([#463](https://github.com/aws-powertools/powertools-lambda-python/issues/463))
+* **deps:** bump boto3 from 1.17.88 to 1.17.89 ([#466](https://github.com/aws-powertools/powertools-lambda-python/issues/466))
+* **deps:** bump boto3 from 1.17.84 to 1.17.85 ([#455](https://github.com/aws-powertools/powertools-lambda-python/issues/455))
+* **deps:** bump boto3 from 1.17.85 to 1.17.86 ([#458](https://github.com/aws-powertools/powertools-lambda-python/issues/458))
+* **deps:** bump boto3 from 1.17.86 to 1.17.87 ([#459](https://github.com/aws-powertools/powertools-lambda-python/issues/459))
+* **deps-dev:** bump mkdocs-material from 7.1.6 to 7.1.7 ([#464](https://github.com/aws-powertools/powertools-lambda-python/issues/464))
+* **deps-dev:** bump pytest-cov from 2.12.0 to 2.12.1 ([#454](https://github.com/aws-powertools/powertools-lambda-python/issues/454))
* **mergify:** use job name to match GH Actions
* **mergify:** disable check for matrix jobs
@@ -1331,7 +6649,7 @@
## [v1.16.1] - 2021-05-23
## Features
-* **parser:** security issue in Pydantic [#436](https://github.com/awslabs/aws-lambda-powertools-python/issues/436) ([#437](https://github.com/awslabs/aws-lambda-powertools-python/issues/437))
+* **parser:** security issue in Pydantic [#436](https://github.com/aws-powertools/powertools-lambda-python/issues/436) ([#437](https://github.com/aws-powertools/powertools-lambda-python/issues/437))
## Maintenance
@@ -1342,8 +6660,8 @@
## [v1.16.0] - 2021-05-17
## Features
-* **data-classes:** decode base64 encoded body ([#425](https://github.com/awslabs/aws-lambda-powertools-python/issues/425))
-* **data-classes:** support for code pipeline job event ([#416](https://github.com/awslabs/aws-lambda-powertools-python/issues/416))
+* **data-classes:** decode base64 encoded body ([#425](https://github.com/aws-powertools/powertools-lambda-python/issues/425))
+* **data-classes:** support for code pipeline job event ([#416](https://github.com/aws-powertools/powertools-lambda-python/issues/416))
## Maintenance
@@ -1354,7 +6672,7 @@
## [v1.15.1] - 2021-05-13
## Bug Fixes
-* **docs:** Use updated names for ProxyEventType ([#424](https://github.com/awslabs/aws-lambda-powertools-python/issues/424))
+* **docs:** Use updated names for ProxyEventType ([#424](https://github.com/aws-powertools/powertools-lambda-python/issues/424))
## Documentation
@@ -1370,38 +6688,38 @@
## [v1.15.0] - 2021-05-06
## Bug Fixes
-* **deps:** Bump aws-xray-sdk from 2.6.0 to 2.8.0 ([#413](https://github.com/awslabs/aws-lambda-powertools-python/issues/413))
-* **docs:** workflow to include api ref in latest alias ([#408](https://github.com/awslabs/aws-lambda-powertools-python/issues/408))
-* **parser:** Improve types for parser.py ([#419](https://github.com/awslabs/aws-lambda-powertools-python/issues/419))
-* **validator:** event type annotation as any in validate fn ([#405](https://github.com/awslabs/aws-lambda-powertools-python/issues/405))
+* **deps:** Bump aws-xray-sdk from 2.6.0 to 2.8.0 ([#413](https://github.com/aws-powertools/powertools-lambda-python/issues/413))
+* **docs:** workflow to include api ref in latest alias ([#408](https://github.com/aws-powertools/powertools-lambda-python/issues/408))
+* **parser:** Improve types for parser.py ([#419](https://github.com/aws-powertools/powertools-lambda-python/issues/419))
+* **validator:** event type annotation as any in validate fn ([#405](https://github.com/aws-powertools/powertools-lambda-python/issues/405))
## Code Refactoring
-* simplify custom formatter for minor changes ([#417](https://github.com/awslabs/aws-lambda-powertools-python/issues/417))
-* **event-handler:** api gateway handler review changes ([#420](https://github.com/awslabs/aws-lambda-powertools-python/issues/420))
-* **event-handler:** Add ResponseBuilder and more docs ([#412](https://github.com/awslabs/aws-lambda-powertools-python/issues/412))
-* **logger:** BYOFormatter and Handler, UTC support, and more ([#404](https://github.com/awslabs/aws-lambda-powertools-python/issues/404))
+* simplify custom formatter for minor changes ([#417](https://github.com/aws-powertools/powertools-lambda-python/issues/417))
+* **event-handler:** api gateway handler review changes ([#420](https://github.com/aws-powertools/powertools-lambda-python/issues/420))
+* **event-handler:** Add ResponseBuilder and more docs ([#412](https://github.com/aws-powertools/powertools-lambda-python/issues/412))
+* **logger:** BYOFormatter and Handler, UTC support, and more ([#404](https://github.com/aws-powertools/powertools-lambda-python/issues/404))
## Documentation
-* **api_gateway:** new event handler for API Gateway and ALB ([#418](https://github.com/awslabs/aws-lambda-powertools-python/issues/418))
+* **api_gateway:** new event handler for API Gateway and ALB ([#418](https://github.com/aws-powertools/powertools-lambda-python/issues/418))
* **event_handler:** fix closing brackets in CORS sample
* **event_handler:** remove beta flag from new HTTP utility
* **idempotency:** remove beta flag
-* **logger:** improvements extensibility & new features ([#415](https://github.com/awslabs/aws-lambda-powertools-python/issues/415))
+* **logger:** improvements extensibility & new features ([#415](https://github.com/aws-powertools/powertools-lambda-python/issues/415))
* **parser:** fix table and heading syntax
-* **tracer:** Fix line highlighting ([#395](https://github.com/awslabs/aws-lambda-powertools-python/issues/395))
+* **tracer:** Fix line highlighting ([#395](https://github.com/aws-powertools/powertools-lambda-python/issues/395))
## Features
-* add support to persist default dimensions ([#410](https://github.com/awslabs/aws-lambda-powertools-python/issues/410))
-* **event-handle:** allow for cors=None setting ([#421](https://github.com/awslabs/aws-lambda-powertools-python/issues/421))
-* **event-handler:** add http ProxyEvent handler ([#369](https://github.com/awslabs/aws-lambda-powertools-python/issues/369))
-* **parser:** Support for API GW v1 proxy schema & envelope ([#403](https://github.com/awslabs/aws-lambda-powertools-python/issues/403))
+* add support to persist default dimensions ([#410](https://github.com/aws-powertools/powertools-lambda-python/issues/410))
+* **event-handle:** allow for cors=None setting ([#421](https://github.com/aws-powertools/powertools-lambda-python/issues/421))
+* **event-handler:** add http ProxyEvent handler ([#369](https://github.com/aws-powertools/powertools-lambda-python/issues/369))
+* **parser:** Support for API GW v1 proxy schema & envelope ([#403](https://github.com/aws-powertools/powertools-lambda-python/issues/403))
## Maintenance
-* bump to 1.15.0 ([#422](https://github.com/awslabs/aws-lambda-powertools-python/issues/422))
+* bump to 1.15.0 ([#422](https://github.com/aws-powertools/powertools-lambda-python/issues/422))
<a name="v1.14.0"></a>
@@ -1409,33 +6727,33 @@
## Bug Fixes
* perf tests for Logger and fail str msgs
-* downgrade poetry to 1.1.4 ([#385](https://github.com/awslabs/aws-lambda-powertools-python/issues/385))
-* lock X-Ray SDK to 2.6.0 ([#384](https://github.com/awslabs/aws-lambda-powertools-python/issues/384))
-* **data-classes:** Add missing operationName ([#373](https://github.com/awslabs/aws-lambda-powertools-python/issues/373))
-* **idempotent:** Correctly raise IdempotencyKeyError ([#378](https://github.com/awslabs/aws-lambda-powertools-python/issues/378))
-* **metrics:** AttributeError raised by MediaManager and Typing and docs ([#357](https://github.com/awslabs/aws-lambda-powertools-python/issues/357))
-* **parser:** S3Model support empty keys ([#375](https://github.com/awslabs/aws-lambda-powertools-python/issues/375))
-* **tracer:** Correct type hint for MyPy ([#365](https://github.com/awslabs/aws-lambda-powertools-python/issues/365))
+* downgrade poetry to 1.1.4 ([#385](https://github.com/aws-powertools/powertools-lambda-python/issues/385))
+* lock X-Ray SDK to 2.6.0 ([#384](https://github.com/aws-powertools/powertools-lambda-python/issues/384))
+* **data-classes:** Add missing operationName ([#373](https://github.com/aws-powertools/powertools-lambda-python/issues/373))
+* **idempotent:** Correctly raise IdempotencyKeyError ([#378](https://github.com/aws-powertools/powertools-lambda-python/issues/378))
+* **metrics:** AttributeError raised by MediaManager and Typing and docs ([#357](https://github.com/aws-powertools/powertools-lambda-python/issues/357))
+* **parser:** S3Model support empty keys ([#375](https://github.com/aws-powertools/powertools-lambda-python/issues/375))
+* **tracer:** Correct type hint for MyPy ([#365](https://github.com/aws-powertools/powertools-lambda-python/issues/365))
* **workflow:** github actions depends on for release
## Documentation
-* Fix doc links and line highlights ([#380](https://github.com/awslabs/aws-lambda-powertools-python/issues/380))
+* Fix doc links and line highlights ([#380](https://github.com/aws-powertools/powertools-lambda-python/issues/380))
* fix extra key for versioning
* update mkdocs-material to 7.1.0
-* Correct link targets and line highlights ([#390](https://github.com/awslabs/aws-lambda-powertools-python/issues/390))
-* introduce event handlers utility section ([#388](https://github.com/awslabs/aws-lambda-powertools-python/issues/388))
-* enable versioning feature ([#374](https://github.com/awslabs/aws-lambda-powertools-python/issues/374))
-* **idempotency:** add default configuration for those not using CFN ([#391](https://github.com/awslabs/aws-lambda-powertools-python/issues/391))
+* Correct link targets and line highlights ([#390](https://github.com/aws-powertools/powertools-lambda-python/issues/390))
+* introduce event handlers utility section ([#388](https://github.com/aws-powertools/powertools-lambda-python/issues/388))
+* enable versioning feature ([#374](https://github.com/aws-powertools/powertools-lambda-python/issues/374))
+* **idempotency:** add default configuration for those not using CFN ([#391](https://github.com/aws-powertools/powertools-lambda-python/issues/391))
* **index:** fix link to event handler
-* **logger:** add example on how to set UTC timestamp ([#392](https://github.com/awslabs/aws-lambda-powertools-python/issues/392))
-* **validator:** include more complete examples & intro to JSON Schema ([#389](https://github.com/awslabs/aws-lambda-powertools-python/issues/389))
+* **logger:** add example on how to set UTC timestamp ([#392](https://github.com/aws-powertools/powertools-lambda-python/issues/392))
+* **validator:** include more complete examples & intro to JSON Schema ([#389](https://github.com/aws-powertools/powertools-lambda-python/issues/389))
## Features
-* **event-handler:** Add AppSync handler decorator ([#363](https://github.com/awslabs/aws-lambda-powertools-python/issues/363))
-* **parameter:** add dynamodb_endpoint_url for local_testing ([#376](https://github.com/awslabs/aws-lambda-powertools-python/issues/376))
-* **parser:** Add S3 Object Lambda Event ([#362](https://github.com/awslabs/aws-lambda-powertools-python/issues/362))
+* **event-handler:** Add AppSync handler decorator ([#363](https://github.com/aws-powertools/powertools-lambda-python/issues/363))
+* **parameter:** add dynamodb_endpoint_url for local_testing ([#376](https://github.com/aws-powertools/powertools-lambda-python/issues/376))
+* **parser:** Add S3 Object Lambda Event ([#362](https://github.com/aws-powertools/powertools-lambda-python/issues/362))
## Maintenance
@@ -1449,12 +6767,12 @@
## [v1.13.0] - 2021-03-23
## Bug Fixes
-* **deps:** Bump dependencies and fix some of the dev tooling ([#354](https://github.com/awslabs/aws-lambda-powertools-python/issues/354))
-* **lint:** Move `tests/THIRD-PARTY-LICENSES` to root ([#352](https://github.com/awslabs/aws-lambda-powertools-python/issues/352))
+* **deps:** Bump dependencies and fix some of the dev tooling ([#354](https://github.com/aws-powertools/powertools-lambda-python/issues/354))
+* **lint:** Move `tests/THIRD-PARTY-LICENSES` to root ([#352](https://github.com/aws-powertools/powertools-lambda-python/issues/352))
## Features
-* **data-classes:** Add S3 Object Lambda Event ([#353](https://github.com/awslabs/aws-lambda-powertools-python/issues/353))
+* **data-classes:** Add S3 Object Lambda Event ([#353](https://github.com/aws-powertools/powertools-lambda-python/issues/353))
## Maintenance
@@ -1467,32 +6785,32 @@
## [v1.12.0] - 2021-03-17
## Bug Fixes
-* **idempotency:** TypeError when calling is_missing_idempotency_key with an int ([#315](https://github.com/awslabs/aws-lambda-powertools-python/issues/315))
-* **idempotency:** Correctly handle save_inprogress errors ([#313](https://github.com/awslabs/aws-lambda-powertools-python/issues/313))
+* **idempotency:** TypeError when calling is_missing_idempotency_key with an int ([#315](https://github.com/aws-powertools/powertools-lambda-python/issues/315))
+* **idempotency:** Correctly handle save_inprogress errors ([#313](https://github.com/aws-powertools/powertools-lambda-python/issues/313))
## Code Refactoring
-* **parameters:** Consistently reference env ([#319](https://github.com/awslabs/aws-lambda-powertools-python/issues/319))
+* **parameters:** Consistently reference env ([#319](https://github.com/aws-powertools/powertools-lambda-python/issues/319))
## Documentation
-* surface new 1.12.0 features and enhancements ([#344](https://github.com/awslabs/aws-lambda-powertools-python/issues/344))
-* Correct code examples ([#317](https://github.com/awslabs/aws-lambda-powertools-python/issues/317))
-* **data-classes:** Add more cognito code examples ([#340](https://github.com/awslabs/aws-lambda-powertools-python/issues/340))
-* **idempotency:** Correct examples and line highlights ([#312](https://github.com/awslabs/aws-lambda-powertools-python/issues/312))
-* **metrics:** Corrections to the code examples ([#314](https://github.com/awslabs/aws-lambda-powertools-python/issues/314))
+* surface new 1.12.0 features and enhancements ([#344](https://github.com/aws-powertools/powertools-lambda-python/issues/344))
+* Correct code examples ([#317](https://github.com/aws-powertools/powertools-lambda-python/issues/317))
+* **data-classes:** Add more cognito code examples ([#340](https://github.com/aws-powertools/powertools-lambda-python/issues/340))
+* **idempotency:** Correct examples and line highlights ([#312](https://github.com/aws-powertools/powertools-lambda-python/issues/312))
+* **metrics:** Corrections to the code examples ([#314](https://github.com/aws-powertools/powertools-lambda-python/issues/314))
* **metrics:** remove minimum dimensions
-* **metrics:** Correct code examples in markdown ([#316](https://github.com/awslabs/aws-lambda-powertools-python/issues/316))
-* **tracer:** Fix Tracer typing hinting for Pycharm ([#345](https://github.com/awslabs/aws-lambda-powertools-python/issues/345))
+* **metrics:** Correct code examples in markdown ([#316](https://github.com/aws-powertools/powertools-lambda-python/issues/316))
+* **tracer:** Fix Tracer typing hinting for Pycharm ([#345](https://github.com/aws-powertools/powertools-lambda-python/issues/345))
## Features
-* **data-classes:** Add appsync scalar_types_utils ([#339](https://github.com/awslabs/aws-lambda-powertools-python/issues/339))
-* **data-classes:** AppSync Resolver Event ([#323](https://github.com/awslabs/aws-lambda-powertools-python/issues/323))
-* **idempotent:** Include function name in the idempotent key ([#326](https://github.com/awslabs/aws-lambda-powertools-python/issues/326))
-* **logging:** Add correlation_id support ([#321](https://github.com/awslabs/aws-lambda-powertools-python/issues/321))
-* **logging:** Include exception_name ([#320](https://github.com/awslabs/aws-lambda-powertools-python/issues/320))
-* **parameters:** Add force_fetch option ([#341](https://github.com/awslabs/aws-lambda-powertools-python/issues/341))
+* **data-classes:** Add appsync scalar_types_utils ([#339](https://github.com/aws-powertools/powertools-lambda-python/issues/339))
+* **data-classes:** AppSync Resolver Event ([#323](https://github.com/aws-powertools/powertools-lambda-python/issues/323))
+* **idempotent:** Include function name in the idempotent key ([#326](https://github.com/aws-powertools/powertools-lambda-python/issues/326))
+* **logging:** Add correlation_id support ([#321](https://github.com/aws-powertools/powertools-lambda-python/issues/321))
+* **logging:** Include exception_name ([#320](https://github.com/aws-powertools/powertools-lambda-python/issues/320))
+* **parameters:** Add force_fetch option ([#341](https://github.com/aws-powertools/powertools-lambda-python/issues/341))
## Maintenance
@@ -1509,34 +6827,34 @@
## [v1.11.0] - 2021-03-05
## Bug Fixes
-* import time latency by lazily loading high level modules ([#301](https://github.com/awslabs/aws-lambda-powertools-python/issues/301))
-* correct behaviour to avoid caching "INPROGRESS" records ([#295](https://github.com/awslabs/aws-lambda-powertools-python/issues/295))
+* import time latency by lazily loading high level modules ([#301](https://github.com/aws-powertools/powertools-lambda-python/issues/301))
+* correct behaviour to avoid caching "INPROGRESS" records ([#295](https://github.com/aws-powertools/powertools-lambda-python/issues/295))
* **idempotency:** PR feedback on config and kwargs
## Code Refactoring
-* **idempotent:** Change UX to use a config class for non-persistence related features ([#306](https://github.com/awslabs/aws-lambda-powertools-python/issues/306))
-* **metrics:** optimize validation and serialization ([#307](https://github.com/awslabs/aws-lambda-powertools-python/issues/307))
+* **idempotent:** Change UX to use a config class for non-persistence related features ([#306](https://github.com/aws-powertools/powertools-lambda-python/issues/306))
+* **metrics:** optimize validation and serialization ([#307](https://github.com/aws-powertools/powertools-lambda-python/issues/307))
## Documentation
-* **batch:** add example on how to integrate with sentry.io ([#308](https://github.com/awslabs/aws-lambda-powertools-python/issues/308))
-* **data-classes:** Correct import for DynamoDBRecordEventName ([#299](https://github.com/awslabs/aws-lambda-powertools-python/issues/299))
-* **dataclasses:** new Connect Contact Flow ([#310](https://github.com/awslabs/aws-lambda-powertools-python/issues/310))
-* **idempotency:** tidy up doc before release ([#309](https://github.com/awslabs/aws-lambda-powertools-python/issues/309))
-* **idempotent:** Fix typos and code formatting ([#305](https://github.com/awslabs/aws-lambda-powertools-python/issues/305))
+* **batch:** add example on how to integrate with sentry.io ([#308](https://github.com/aws-powertools/powertools-lambda-python/issues/308))
+* **data-classes:** Correct import for DynamoDBRecordEventName ([#299](https://github.com/aws-powertools/powertools-lambda-python/issues/299))
+* **dataclasses:** new Connect Contact Flow ([#310](https://github.com/aws-powertools/powertools-lambda-python/issues/310))
+* **idempotency:** tidy up doc before release ([#309](https://github.com/aws-powertools/powertools-lambda-python/issues/309))
+* **idempotent:** Fix typos and code formatting ([#305](https://github.com/aws-powertools/powertools-lambda-python/issues/305))
## Features
-* Idempotency helper utility ([#245](https://github.com/awslabs/aws-lambda-powertools-python/issues/245))
-* **data-classes:** Add connect contact flow event ([#304](https://github.com/awslabs/aws-lambda-powertools-python/issues/304))
-* **idempotency:** Add raise_on_no_idempotency_key flag ([#297](https://github.com/awslabs/aws-lambda-powertools-python/issues/297))
-* **idempotency:** Fix KeyError when local_cache is True and an error is raised in the lambda handler ([#300](https://github.com/awslabs/aws-lambda-powertools-python/issues/300))
-* **idempotent:** Add support for jmespath_options ([#302](https://github.com/awslabs/aws-lambda-powertools-python/issues/302))
+* Idempotency helper utility ([#245](https://github.com/aws-powertools/powertools-lambda-python/issues/245))
+* **data-classes:** Add connect contact flow event ([#304](https://github.com/aws-powertools/powertools-lambda-python/issues/304))
+* **idempotency:** Add raise_on_no_idempotency_key flag ([#297](https://github.com/aws-powertools/powertools-lambda-python/issues/297))
+* **idempotency:** Fix KeyError when local_cache is True and an error is raised in the lambda handler ([#300](https://github.com/aws-powertools/powertools-lambda-python/issues/300))
+* **idempotent:** Add support for jmespath_options ([#302](https://github.com/aws-powertools/powertools-lambda-python/issues/302))
## Maintenance
-* update changelog ([#311](https://github.com/awslabs/aws-lambda-powertools-python/issues/311))
+* update changelog ([#311](https://github.com/aws-powertools/powertools-lambda-python/issues/311))
* adjusts Metrics SLA for slow py36 interpreters
* remove unsuccessful labeler bot
* update labeler bot to sync upon PR changes
@@ -1547,7 +6865,7 @@
## [v1.10.5] - 2021-02-17
## Maintenance
-* version bump to 1.10.5 ([#292](https://github.com/awslabs/aws-lambda-powertools-python/issues/292))
+* version bump to 1.10.5 ([#292](https://github.com/aws-powertools/powertools-lambda-python/issues/292))
<a name="v1.10.4"></a>
@@ -1559,13 +6877,13 @@
## Documentation
-* **data-classes:** Fix anchor tags to be lower case ([#288](https://github.com/awslabs/aws-lambda-powertools-python/issues/288))
+* **data-classes:** Fix anchor tags to be lower case ([#288](https://github.com/aws-powertools/powertools-lambda-python/issues/288))
## Maintenance
-* version bump to 1.10.4 ([#291](https://github.com/awslabs/aws-lambda-powertools-python/issues/291))
+* version bump to 1.10.4 ([#291](https://github.com/aws-powertools/powertools-lambda-python/issues/291))
* add default runtime key
-* Correct the docs location ([#289](https://github.com/awslabs/aws-lambda-powertools-python/issues/289))
+* Correct the docs location ([#289](https://github.com/aws-powertools/powertools-lambda-python/issues/289))
* enable PR labeler workflow
* add auto-label for known files
@@ -1578,33 +6896,33 @@
## [v1.10.3] - 2021-02-12
## Bug Fixes
-* sfix typing hit for envelope parse model ([#286](https://github.com/awslabs/aws-lambda-powertools-python/issues/286))
-* disable batching of X-Ray subsegments ([#284](https://github.com/awslabs/aws-lambda-powertools-python/issues/284))
+* sfix typing hit for envelope parse model ([#286](https://github.com/aws-powertools/powertools-lambda-python/issues/286))
+* disable batching of X-Ray subsegments ([#284](https://github.com/aws-powertools/powertools-lambda-python/issues/284))
## Documentation
-* migrate documentation from Gatsby to MkDocs material ([#279](https://github.com/awslabs/aws-lambda-powertools-python/issues/279))
+* migrate documentation from Gatsby to MkDocs material ([#279](https://github.com/aws-powertools/powertools-lambda-python/issues/279))
## Maintenance
-* bump to 1.10.3 ([#287](https://github.com/awslabs/aws-lambda-powertools-python/issues/287))
+* bump to 1.10.3 ([#287](https://github.com/aws-powertools/powertools-lambda-python/issues/287))
<a name="v1.10.2"></a>
## [v1.10.2] - 2021-02-04
## Bug Fixes
-* remove unnecessary typing-extensions for py3.8 ([#281](https://github.com/awslabs/aws-lambda-powertools-python/issues/281))
-* batch processing exceptions ([#276](https://github.com/awslabs/aws-lambda-powertools-python/issues/276))
+* remove unnecessary typing-extensions for py3.8 ([#281](https://github.com/aws-powertools/powertools-lambda-python/issues/281))
+* batch processing exceptions ([#276](https://github.com/aws-powertools/powertools-lambda-python/issues/276))
## Documentation
-* **appconfig:** Use correct import for docstring ([#271](https://github.com/awslabs/aws-lambda-powertools-python/issues/271))
+* **appconfig:** Use correct import for docstring ([#271](https://github.com/aws-powertools/powertools-lambda-python/issues/271))
## Maintenance
-* bump to 1.10.2 ([#282](https://github.com/awslabs/aws-lambda-powertools-python/issues/282))
-* fix immer and socket.io CVEs ([#278](https://github.com/awslabs/aws-lambda-powertools-python/issues/278))
+* bump to 1.10.2 ([#282](https://github.com/aws-powertools/powertools-lambda-python/issues/282))
+* fix immer and socket.io CVEs ([#278](https://github.com/aws-powertools/powertools-lambda-python/issues/278))
* typo in parser docs
@@ -1612,36 +6930,36 @@
## [v1.10.1] - 2021-01-19
## Features
-* add support for SNS->SQS protocol ([#272](https://github.com/awslabs/aws-lambda-powertools-python/issues/272))
+* add support for SNS->SQS protocol ([#272](https://github.com/aws-powertools/powertools-lambda-python/issues/272))
## Maintenance
-* bump to 1.10.1 ([#273](https://github.com/awslabs/aws-lambda-powertools-python/issues/273))
+* bump to 1.10.1 ([#273](https://github.com/aws-powertools/powertools-lambda-python/issues/273))
<a name="v1.10.0"></a>
## [v1.10.0] - 2021-01-18
## Documentation
-* fix import ([#267](https://github.com/awslabs/aws-lambda-powertools-python/issues/267))
-* add info about extras layer ([#260](https://github.com/awslabs/aws-lambda-powertools-python/issues/260))
+* fix import ([#267](https://github.com/aws-powertools/powertools-lambda-python/issues/267))
+* add info about extras layer ([#260](https://github.com/aws-powertools/powertools-lambda-python/issues/260))
* fix note whitespace
-* add missing parser models ([#254](https://github.com/awslabs/aws-lambda-powertools-python/issues/254))
+* add missing parser models ([#254](https://github.com/aws-powertools/powertools-lambda-python/issues/254))
## Features
-* toggle to disable log deduplication locally for pytest live log [#262](https://github.com/awslabs/aws-lambda-powertools-python/issues/262) ([#268](https://github.com/awslabs/aws-lambda-powertools-python/issues/268))
-* Add AppConfig parameter provider ([#236](https://github.com/awslabs/aws-lambda-powertools-python/issues/236))
-* support extra parameter in Logger messages ([#257](https://github.com/awslabs/aws-lambda-powertools-python/issues/257))
-* support custom formats in JSON Schema validation ([#247](https://github.com/awslabs/aws-lambda-powertools-python/issues/247))
+* toggle to disable log deduplication locally for pytest live log [#262](https://github.com/aws-powertools/powertools-lambda-python/issues/262) ([#268](https://github.com/aws-powertools/powertools-lambda-python/issues/268))
+* Add AppConfig parameter provider ([#236](https://github.com/aws-powertools/powertools-lambda-python/issues/236))
+* support extra parameter in Logger messages ([#257](https://github.com/aws-powertools/powertools-lambda-python/issues/257))
+* support custom formats in JSON Schema validation ([#247](https://github.com/aws-powertools/powertools-lambda-python/issues/247))
## Maintenance
-* bump to 1.10.0 ([#270](https://github.com/awslabs/aws-lambda-powertools-python/issues/270))
-* move env names to constant file ([#264](https://github.com/awslabs/aws-lambda-powertools-python/issues/264))
+* bump to 1.10.0 ([#270](https://github.com/aws-powertools/powertools-lambda-python/issues/270))
+* move env names to constant file ([#264](https://github.com/aws-powertools/powertools-lambda-python/issues/264))
* update stale bot
-* general simplifications and cleanup ([#255](https://github.com/awslabs/aws-lambda-powertools-python/issues/255))
-* hardcode axios transitive resolution ([#256](https://github.com/awslabs/aws-lambda-powertools-python/issues/256))
+* general simplifications and cleanup ([#255](https://github.com/aws-powertools/powertools-lambda-python/issues/255))
+* hardcode axios transitive resolution ([#256](https://github.com/aws-powertools/powertools-lambda-python/issues/256))
<a name="v1.9.1"></a>
@@ -1664,21 +6982,21 @@
## Maintenance
-* bump to 1.9.1 ([#252](https://github.com/awslabs/aws-lambda-powertools-python/issues/252))
+* bump to 1.9.1 ([#252](https://github.com/aws-powertools/powertools-lambda-python/issues/252))
* add changelog
* implement phony targets correctly
* **deps:** bump ini from 1.3.5 to 1.3.8 in /docs
## Pull Requests
-* Merge pull request [#250](https://github.com/awslabs/aws-lambda-powertools-python/issues/250) from heitorlessa/fix/[#249](https://github.com/awslabs/aws-lambda-powertools-python/issues/249)
-* Merge pull request [#235](https://github.com/awslabs/aws-lambda-powertools-python/issues/235) from Nr18/phony
-* Merge pull request [#244](https://github.com/awslabs/aws-lambda-powertools-python/issues/244) from awslabs/docs/capture_method_clarification
-* Merge pull request [#241](https://github.com/awslabs/aws-lambda-powertools-python/issues/241) from awslabs/dependabot/npm_and_yarn/docs/ini-1.3.8
-* Merge pull request [#237](https://github.com/awslabs/aws-lambda-powertools-python/issues/237) from gmcrocetti/pep-561
-* Merge pull request [#234](https://github.com/awslabs/aws-lambda-powertools-python/issues/234) from Nr18/test-equal
-* Merge pull request [#233](https://github.com/awslabs/aws-lambda-powertools-python/issues/233) from GroovyDan/improv/add_equality_check_to_dict_wrapper
-* Merge pull request [#232](https://github.com/awslabs/aws-lambda-powertools-python/issues/232) from gyft/add-missing-tests
+* Merge pull request [#250](https://github.com/aws-powertools/powertools-lambda-python/issues/250) from heitorlessa/fix/[#249](https://github.com/aws-powertools/powertools-lambda-python/issues/249)
+* Merge pull request [#235](https://github.com/aws-powertools/powertools-lambda-python/issues/235) from Nr18/phony
+* Merge pull request [#244](https://github.com/aws-powertools/powertools-lambda-python/issues/244) from awslabs/docs/capture_method_clarification
+* Merge pull request [#241](https://github.com/aws-powertools/powertools-lambda-python/issues/241) from awslabs/dependabot/npm_and_yarn/docs/ini-1.3.8
+* Merge pull request [#237](https://github.com/aws-powertools/powertools-lambda-python/issues/237) from gmcrocetti/pep-561
+* Merge pull request [#234](https://github.com/aws-powertools/powertools-lambda-python/issues/234) from Nr18/test-equal
+* Merge pull request [#233](https://github.com/aws-powertools/powertools-lambda-python/issues/233) from GroovyDan/improv/add_equality_check_to_dict_wrapper
+* Merge pull request [#232](https://github.com/aws-powertools/powertools-lambda-python/issues/232) from gyft/add-missing-tests
<a name="v1.9.0"></a>
@@ -1703,25 +7021,24 @@
* Add Kinesis lambda event support to Parser utility
* Add cloudwatch lambda event support to Parser utility
-* Add alb lambda event support to Parser utility [#228](https://github.com/awslabs/aws-lambda-powertools-python/issues/228)
+* Add alb lambda event support to Parser utility [#228](https://github.com/aws-powertools/powertools-lambda-python/issues/228)
* Add Kinesis lambda event support to Parser utility
-* Add S3 lambda event support to Parser utility [#224](https://github.com/awslabs/aws-lambda-powertools-python/issues/224)
-* Add Ses lambda event support to Parser utility [#213](https://github.com/awslabs/aws-lambda-powertools-python/issues/213)
+* Add S3 lambda event support to Parser utility [#224](https://github.com/aws-powertools/powertools-lambda-python/issues/224)
+* Add Ses lambda event support to Parser utility [#213](https://github.com/aws-powertools/powertools-lambda-python/issues/213)
## Maintenance
-* bump version to 1.9.0
## Pull Requests
-* Merge pull request [#227](https://github.com/awslabs/aws-lambda-powertools-python/issues/227) from risenberg-cyberark/kinesis
-* Merge pull request [#225](https://github.com/awslabs/aws-lambda-powertools-python/issues/225) from risenberg-cyberark/s3
-* Merge pull request [#231](https://github.com/awslabs/aws-lambda-powertools-python/issues/231) from risenberg-cyberark/cloudwatch
-* Merge pull request [#229](https://github.com/awslabs/aws-lambda-powertools-python/issues/229) from risenberg-cyberark/alb
-* Merge pull request [#223](https://github.com/awslabs/aws-lambda-powertools-python/issues/223) from heitorlessa/docs/add-source-code-link
-* Merge pull request [#222](https://github.com/awslabs/aws-lambda-powertools-python/issues/222) from awslabs/docs-fix-broken-link
-* Merge pull request [#219](https://github.com/awslabs/aws-lambda-powertools-python/issues/219) from igorlg/docs/logger-supress-clarify
-* Merge pull request [#214](https://github.com/awslabs/aws-lambda-powertools-python/issues/214) from risenberg-cyberark/ses
+* Merge pull request [#227](https://github.com/aws-powertools/powertools-lambda-python/issues/227) from risenberg-cyberark/kinesis
+* Merge pull request [#225](https://github.com/aws-powertools/powertools-lambda-python/issues/225) from risenberg-cyberark/s3
+* Merge pull request [#231](https://github.com/aws-powertools/powertools-lambda-python/issues/231) from risenberg-cyberark/cloudwatch
+* Merge pull request [#229](https://github.com/aws-powertools/powertools-lambda-python/issues/229) from risenberg-cyberark/alb
+* Merge pull request [#223](https://github.com/aws-powertools/powertools-lambda-python/issues/223) from heitorlessa/docs/add-source-code-link
+* Merge pull request [#222](https://github.com/aws-powertools/powertools-lambda-python/issues/222) from awslabs/docs-fix-broken-link
+* Merge pull request [#219](https://github.com/aws-powertools/powertools-lambda-python/issues/219) from igorlg/docs/logger-supress-clarify
+* Merge pull request [#214](https://github.com/aws-powertools/powertools-lambda-python/issues/214) from risenberg-cyberark/ses
<a name="v1.8.0"></a>
@@ -1750,14 +7067,14 @@
## Pull Requests
-* Merge pull request [#212](https://github.com/awslabs/aws-lambda-powertools-python/issues/212) from heitorlessa/chore/bump-1.8.0
-* Merge pull request [#211](https://github.com/awslabs/aws-lambda-powertools-python/issues/211) from heitorlessa/feat/eventbridge-replay-support
-* Merge pull request [#209](https://github.com/awslabs/aws-lambda-powertools-python/issues/209) from awslabs/docs/correct_ses_dataclass_example
-* Merge pull request [#207](https://github.com/awslabs/aws-lambda-powertools-python/issues/207) from risenberg-cyberark/sns
-* Merge pull request [#205](https://github.com/awslabs/aws-lambda-powertools-python/issues/205) from heitorlessa/chore/update-docs-dep
-* Merge pull request [#202](https://github.com/awslabs/aws-lambda-powertools-python/issues/202) from Nr18/logger-faq
-* Merge pull request [#204](https://github.com/awslabs/aws-lambda-powertools-python/issues/204) from am29d/docs/add-iam-permissions-for-layer
-* Merge pull request [#201](https://github.com/awslabs/aws-lambda-powertools-python/issues/201) from gyft/feat-data-classes-event-updates
+* Merge pull request [#212](https://github.com/aws-powertools/powertools-lambda-python/issues/212) from heitorlessa/chore/bump-1.8.0
+* Merge pull request [#211](https://github.com/aws-powertools/powertools-lambda-python/issues/211) from heitorlessa/feat/eventbridge-replay-support
+* Merge pull request [#209](https://github.com/aws-powertools/powertools-lambda-python/issues/209) from awslabs/docs/correct_ses_dataclass_example
+* Merge pull request [#207](https://github.com/aws-powertools/powertools-lambda-python/issues/207) from risenberg-cyberark/sns
+* Merge pull request [#205](https://github.com/aws-powertools/powertools-lambda-python/issues/205) from heitorlessa/chore/update-docs-dep
+* Merge pull request [#202](https://github.com/aws-powertools/powertools-lambda-python/issues/202) from Nr18/logger-faq
+* Merge pull request [#204](https://github.com/aws-powertools/powertools-lambda-python/issues/204) from am29d/docs/add-iam-permissions-for-layer
+* Merge pull request [#201](https://github.com/aws-powertools/powertools-lambda-python/issues/201) from gyft/feat-data-classes-event-updates
<a name="v1.7.0"></a>
@@ -1775,7 +7092,7 @@
* code inspect issues
* unnecessary return; better error handling
* snake_case
-* comment out validators [#118](https://github.com/awslabs/aws-lambda-powertools-python/issues/118)
+* comment out validators [#118](https://github.com/aws-powertools/powertools-lambda-python/issues/118)
* CR fixes Merge branch 'develop' of https://github.com/awslabs/aws-lambda-powertools-python into pydantic
* reduce complexity of dynamo envelope
* poetry update + pydantic, typing_extensions as optional
@@ -1792,7 +7109,7 @@
## Documentation
* reorder parser's payload sample position
-* add more info on conditional keys [#195](https://github.com/awslabs/aws-lambda-powertools-python/issues/195)
+* add more info on conditional keys [#195](https://github.com/aws-powertools/powertools-lambda-python/issues/195)
* add a note that decorator will replace the event
* address Ran's feedback
* reorder data validation; improve envelopes section
@@ -1815,14 +7132,13 @@
* experiment with codeQL over LGTM
* add standalone parse function
* Advanced parser utility (pydantic)
-* RFC: Validate incoming and outgoing events utility [#95](https://github.com/awslabs/aws-lambda-powertools-python/issues/95)
+* RFC: Validate incoming and outgoing events utility [#95](https://github.com/aws-powertools/powertools-lambda-python/issues/95)
* **data_classes:** case insensitive header lookup
* **data_classes:** Cognito custom auth triggers
## Maintenance
* fix repository URL
-* bump version to 1.7.0
* spacing
* typo in list
* typo on code generation tool
@@ -1847,25 +7163,25 @@
## Pull Requests
-* Merge pull request [#200](https://github.com/awslabs/aws-lambda-powertools-python/issues/200) from heitorlessa/chore/bump-1.7.0
-* Merge pull request [#199](https://github.com/awslabs/aws-lambda-powertools-python/issues/199) from heitorlessa/docs/clarify-dynamic-log-keys
-* Merge pull request [#198](https://github.com/awslabs/aws-lambda-powertools-python/issues/198) from awslabs/improv/suppress-logger-propagation
-* Merge pull request [#192](https://github.com/awslabs/aws-lambda-powertools-python/issues/192) from heitorlessa/docs/parser
-* Merge pull request [#196](https://github.com/awslabs/aws-lambda-powertools-python/issues/196) from awslabs/dependabot/npm_and_yarn/docs/object-path-0.11.5
-* Merge pull request [#189](https://github.com/awslabs/aws-lambda-powertools-python/issues/189) from heitorlessa/improv/parser[#118](https://github.com/awslabs/aws-lambda-powertools-python/issues/118)
-* Merge pull request [#186](https://github.com/awslabs/aws-lambda-powertools-python/issues/186) from gyft/feat-case-insensitive-dict
-* Merge pull request [#188](https://github.com/awslabs/aws-lambda-powertools-python/issues/188) from gyft/tests-pydantic
-* Merge pull request [#178](https://github.com/awslabs/aws-lambda-powertools-python/issues/178) from gyft/cognito-custom-auth
-* Merge pull request [#118](https://github.com/awslabs/aws-lambda-powertools-python/issues/118) from risenberg-cyberark/pydantic
-* Merge pull request [#181](https://github.com/awslabs/aws-lambda-powertools-python/issues/181) from awslabs/fix/docs-sec-vuln
-* Merge pull request [#180](https://github.com/awslabs/aws-lambda-powertools-python/issues/180) from heitorlessa/chore/remove-example
+* Merge pull request [#200](https://github.com/aws-powertools/powertools-lambda-python/issues/200) from heitorlessa/chore/bump-1.7.0
+* Merge pull request [#199](https://github.com/aws-powertools/powertools-lambda-python/issues/199) from heitorlessa/docs/clarify-dynamic-log-keys
+* Merge pull request [#198](https://github.com/aws-powertools/powertools-lambda-python/issues/198) from awslabs/improv/suppress-logger-propagation
+* Merge pull request [#192](https://github.com/aws-powertools/powertools-lambda-python/issues/192) from heitorlessa/docs/parser
+* Merge pull request [#196](https://github.com/aws-powertools/powertools-lambda-python/issues/196) from awslabs/dependabot/npm_and_yarn/docs/object-path-0.11.5
+* Merge pull request [#189](https://github.com/aws-powertools/powertools-lambda-python/issues/189) from heitorlessa/improv/parser[#118](https://github.com/aws-powertools/powertools-lambda-python/issues/118)
+* Merge pull request [#186](https://github.com/aws-powertools/powertools-lambda-python/issues/186) from gyft/feat-case-insensitive-dict
+* Merge pull request [#188](https://github.com/aws-powertools/powertools-lambda-python/issues/188) from gyft/tests-pydantic
+* Merge pull request [#178](https://github.com/aws-powertools/powertools-lambda-python/issues/178) from gyft/cognito-custom-auth
+* Merge pull request [#118](https://github.com/aws-powertools/powertools-lambda-python/issues/118) from risenberg-cyberark/pydantic
+* Merge pull request [#181](https://github.com/aws-powertools/powertools-lambda-python/issues/181) from awslabs/fix/docs-sec-vuln
+* Merge pull request [#180](https://github.com/aws-powertools/powertools-lambda-python/issues/180) from heitorlessa/chore/remove-example
<a name="v1.6.1"></a>
## [v1.6.1] - 2020-09-23
## Maintenance
-* bump to 1.6.1 ([#177](https://github.com/awslabs/aws-lambda-powertools-python/issues/177))
+* bump to 1.6.1 ([#177](https://github.com/aws-powertools/powertools-lambda-python/issues/177))
<a name="v1.6.0"></a>
@@ -1877,7 +7193,7 @@
* Correct description for data classes util
* duplicate features content
* navigation, branding
-* remove DeleteMessageBatch call to SQS api if there are no messages to delete ([#170](https://github.com/awslabs/aws-lambda-powertools-python/issues/170))
+* remove DeleteMessageBatch call to SQS api if there are no messages to delete ([#170](https://github.com/aws-powertools/powertools-lambda-python/issues/170))
* correct type hint Dict instead of dict
## Code Refactoring
@@ -1895,14 +7211,14 @@
## Features
* add custom jmespath functions support
-* emf multiple metric values ([#167](https://github.com/awslabs/aws-lambda-powertools-python/issues/167))
+* emf multiple metric values ([#167](https://github.com/aws-powertools/powertools-lambda-python/issues/167))
* add initial validator tests
* add cloudwatch_logs based on Bryan's feedback
* add powertools_base64 custom fn
* add built-in envelopes
* add jmespath as optional dependency
* add initial draft simple validator
-* **trigger:** data class and helper functions for lambda trigger events ([#159](https://github.com/awslabs/aws-lambda-powertools-python/issues/159))
+* **trigger:** data class and helper functions for lambda trigger events ([#159](https://github.com/aws-powertools/powertools-lambda-python/issues/159))
## Maintenance
@@ -1914,11 +7230,11 @@
## Pull Requests
-* Merge pull request [#175](https://github.com/awslabs/aws-lambda-powertools-python/issues/175) from heitorlessa/chore/bump-1.6.0
-* Merge pull request [#171](https://github.com/awslabs/aws-lambda-powertools-python/issues/171) from awslabs/docs/data_classes
-* Merge pull request [#174](https://github.com/awslabs/aws-lambda-powertools-python/issues/174) from heitorlessa/improv/docs-logger-metrics-testing
-* Merge pull request [#168](https://github.com/awslabs/aws-lambda-powertools-python/issues/168) from gyft/tests-missing
-* Merge pull request [#153](https://github.com/awslabs/aws-lambda-powertools-python/issues/153) from heitorlessa/feat/validator-utility
+* Merge pull request [#175](https://github.com/aws-powertools/powertools-lambda-python/issues/175) from heitorlessa/chore/bump-1.6.0
+* Merge pull request [#171](https://github.com/aws-powertools/powertools-lambda-python/issues/171) from awslabs/docs/data_classes
+* Merge pull request [#174](https://github.com/aws-powertools/powertools-lambda-python/issues/174) from heitorlessa/improv/docs-logger-metrics-testing
+* Merge pull request [#168](https://github.com/aws-powertools/powertools-lambda-python/issues/168) from gyft/tests-missing
+* Merge pull request [#153](https://github.com/aws-powertools/powertools-lambda-python/issues/153) from heitorlessa/feat/validator-utility
<a name="v1.5.0"></a>
@@ -1933,7 +7249,7 @@
* typo in example
* include proposed suggestions
* **base-partial:** append record instead of entry
-* **logging:** Don't include `json_default` in logs ([#132](https://github.com/awslabs/aws-lambda-powertools-python/issues/132))
+* **logging:** Don't include `json_default` in logs ([#132](https://github.com/aws-powertools/powertools-lambda-python/issues/132))
## Code Refactoring
@@ -1965,18 +7281,18 @@
* add troubleshooting section
* add xray_trace_id key
* fix suggestions made by [@heitorlessa](https://github.com/heitorlessa)
-* add description where to find the layer arn ([#145](https://github.com/awslabs/aws-lambda-powertools-python/issues/145))
-* new section "Migrating from other Loggers" ([#148](https://github.com/awslabs/aws-lambda-powertools-python/issues/148))
+* add description where to find the layer arn ([#145](https://github.com/aws-powertools/powertools-lambda-python/issues/145))
+* new section "Migrating from other Loggers" ([#148](https://github.com/aws-powertools/powertools-lambda-python/issues/148))
* minor edit to letter case part 2
* user specific documentation
-* Fix doc for log sampling ([#135](https://github.com/awslabs/aws-lambda-powertools-python/issues/135))
+* Fix doc for log sampling ([#135](https://github.com/aws-powertools/powertools-lambda-python/issues/135))
* **partial-processor:** add simple docstrings to success/failure handlers
* **sqs:** docstrings for PartialSQS
* **sqs-base:** docstring for base class
## Features
-* add xray_trace_id key when tracing is active [#137](https://github.com/awslabs/aws-lambda-powertools-python/issues/137)
+* add xray_trace_id key when tracing is active [#137](https://github.com/aws-powertools/powertools-lambda-python/issues/137)
* initial implementation as the proposed gist is
* add sqs failure processors
* include base processors
@@ -1985,31 +7301,30 @@
* **logger:** readable log_dict seq
* **logging:** suppress some log keys
* **logging:** allow for custom json order
-* **parameters:** transform = "auto" ([#133](https://github.com/awslabs/aws-lambda-powertools-python/issues/133))
+* **parameters:** transform = "auto" ([#133](https://github.com/aws-powertools/powertools-lambda-python/issues/133))
* **sqs:** add optional config parameter
* **sqs:** improve validation for queue_url
## Maintenance
-* bump version to 1.5.0 ([#158](https://github.com/awslabs/aws-lambda-powertools-python/issues/158))
* tiny changes for readability
* add debug logging for sqs batch processing
* remove middlewares module, moving decorator functionality to base and sqs
* add test for sqs_batch_processor interface
* add sqs_batch_processor decorator to simplify interface
-* fix typos, docstrings and type hints ([#154](https://github.com/awslabs/aws-lambda-powertools-python/issues/154))
+* fix typos, docstrings and type hints ([#154](https://github.com/aws-powertools/powertools-lambda-python/issues/154))
* doc typo
-* **batch:** Housekeeping for recent changes ([#157](https://github.com/awslabs/aws-lambda-powertools-python/issues/157))
+* **batch:** Housekeeping for recent changes ([#157](https://github.com/aws-powertools/powertools-lambda-python/issues/157))
## Pull Requests
-* Merge pull request [#149](https://github.com/awslabs/aws-lambda-powertools-python/issues/149) from Nr18/static-types
-* Merge pull request [#155](https://github.com/awslabs/aws-lambda-powertools-python/issues/155) from awslabs/docs/batch_processing_util
-* Merge pull request [#100](https://github.com/awslabs/aws-lambda-powertools-python/issues/100) from gmcrocetti/partial-sqs-batch
-* Merge pull request [#151](https://github.com/awslabs/aws-lambda-powertools-python/issues/151) from Nr18/troubleshooting
-* Merge pull request [#150](https://github.com/awslabs/aws-lambda-powertools-python/issues/150) from heitorlessa/feat/logger-add-xray-trace-id
-* Merge pull request [#140](https://github.com/awslabs/aws-lambda-powertools-python/issues/140) from gyft/fix-log-key-order
-* Merge pull request [#142](https://github.com/awslabs/aws-lambda-powertools-python/issues/142) from gyft/fix-letter-case
+* Merge pull request [#149](https://github.com/aws-powertools/powertools-lambda-python/issues/149) from Nr18/static-types
+* Merge pull request [#155](https://github.com/aws-powertools/powertools-lambda-python/issues/155) from awslabs/docs/batch_processing_util
+* Merge pull request [#100](https://github.com/aws-powertools/powertools-lambda-python/issues/100) from gmcrocetti/partial-sqs-batch
+* Merge pull request [#151](https://github.com/aws-powertools/powertools-lambda-python/issues/151) from Nr18/troubleshooting
+* Merge pull request [#150](https://github.com/aws-powertools/powertools-lambda-python/issues/150) from heitorlessa/feat/logger-add-xray-trace-id
+* Merge pull request [#140](https://github.com/aws-powertools/powertools-lambda-python/issues/140) from gyft/fix-log-key-order
+* Merge pull request [#142](https://github.com/aws-powertools/powertools-lambda-python/issues/142) from gyft/fix-letter-case
<a name="v1.4.0"></a>
@@ -2020,9 +7335,9 @@
* remove actual response from debug logs
* naming and staticmethod consistency
* correct in_subsegment assertion
-* update cold_start doc to reflect [#125](https://github.com/awslabs/aws-lambda-powertools-python/issues/125)
-* split ColdStart metric to its own EMF blob [#125](https://github.com/awslabs/aws-lambda-powertools-python/issues/125)
-* **ssm:** Make decrypt an explicit option and refactoring ([#123](https://github.com/awslabs/aws-lambda-powertools-python/issues/123))
+* update cold_start doc to reflect [#125](https://github.com/aws-powertools/powertools-lambda-python/issues/125)
+* split ColdStart metric to its own EMF blob [#125](https://github.com/aws-powertools/powertools-lambda-python/issues/125)
+* **ssm:** Make decrypt an explicit option and refactoring ([#123](https://github.com/aws-powertools/powertools-lambda-python/issues/123))
## Documentation
@@ -2040,7 +7355,7 @@
## Features
-* capture_response as metadata option [#127](https://github.com/awslabs/aws-lambda-powertools-python/issues/127)
+* capture_response as metadata option [#127](https://github.com/aws-powertools/powertools-lambda-python/issues/127)
## Maintenance
@@ -2056,17 +7371,17 @@
## Pull Requests
-* Merge pull request [#129](https://github.com/awslabs/aws-lambda-powertools-python/issues/129) from am29d/feat/lambda-layers
-* Merge pull request [#130](https://github.com/awslabs/aws-lambda-powertools-python/issues/130) from heitorlessa/docs/readability-improvements
-* Merge pull request [#128](https://github.com/awslabs/aws-lambda-powertools-python/issues/128) from heitorlessa/feat/tracer-disallow-response-metadata
-* Merge pull request [#126](https://github.com/awslabs/aws-lambda-powertools-python/issues/126) from heitorlessa/fix/metrics-cold-start-split
+* Merge pull request [#129](https://github.com/aws-powertools/powertools-lambda-python/issues/129) from am29d/feat/lambda-layers
+* Merge pull request [#130](https://github.com/aws-powertools/powertools-lambda-python/issues/130) from heitorlessa/docs/readability-improvements
+* Merge pull request [#128](https://github.com/aws-powertools/powertools-lambda-python/issues/128) from heitorlessa/feat/tracer-disallow-response-metadata
+* Merge pull request [#126](https://github.com/aws-powertools/powertools-lambda-python/issues/126) from heitorlessa/fix/metrics-cold-start-split
<a name="v1.3.1"></a>
## [v1.3.1] - 2020-08-22
## Bug Fixes
-* **capture_method:** should yield inside with ([#124](https://github.com/awslabs/aws-lambda-powertools-python/issues/124))
+* **capture_method:** should yield inside with ([#124](https://github.com/aws-powertools/powertools-lambda-python/issues/124))
## Maintenance
@@ -2076,37 +7391,35 @@
## Pull Requests
-* Merge pull request [#120](https://github.com/awslabs/aws-lambda-powertools-python/issues/120) from awslabs/dependabot/npm_and_yarn/docs/elliptic-6.5.3
-* Merge pull request [#121](https://github.com/awslabs/aws-lambda-powertools-python/issues/121) from awslabs/dependabot/npm_and_yarn/docs/prismjs-1.21.0
+* Merge pull request [#120](https://github.com/aws-powertools/powertools-lambda-python/issues/120) from awslabs/dependabot/npm_and_yarn/docs/elliptic-6.5.3
+* Merge pull request [#121](https://github.com/aws-powertools/powertools-lambda-python/issues/121) from awslabs/dependabot/npm_and_yarn/docs/prismjs-1.21.0
<a name="v1.3.0"></a>
## [v1.3.0] - 2020-08-21
## Features
-* add parameter utility ([#96](https://github.com/awslabs/aws-lambda-powertools-python/issues/96))
+* add parameter utility ([#96](https://github.com/aws-powertools/powertools-lambda-python/issues/96))
## Maintenance
-* bump version to 1.3.0 ([#122](https://github.com/awslabs/aws-lambda-powertools-python/issues/122))
<a name="v1.2.0"></a>
## [v1.2.0] - 2020-08-20
## Features
-* add support for tracing of generators using capture_method decorator ([#113](https://github.com/awslabs/aws-lambda-powertools-python/issues/113))
+* add support for tracing of generators using capture_method decorator ([#113](https://github.com/aws-powertools/powertools-lambda-python/issues/113))
## Maintenance
-* bump version to 1.2.0 ([#119](https://github.com/awslabs/aws-lambda-powertools-python/issues/119))
<a name="v1.1.3"></a>
## [v1.1.3] - 2020-08-18
## Bug Fixes
-* remove root logger handler set by Lambda [#115](https://github.com/awslabs/aws-lambda-powertools-python/issues/115)
+* remove root logger handler set by Lambda [#115](https://github.com/aws-powertools/powertools-lambda-python/issues/115)
## Maintenance
@@ -2114,40 +7427,39 @@
## Pull Requests
-* Merge pull request [#117](https://github.com/awslabs/aws-lambda-powertools-python/issues/117) from heitorlessa/chore/bump-1.1.3
-* Merge pull request [#116](https://github.com/awslabs/aws-lambda-powertools-python/issues/116) from heitorlessa/fix/remove-root-logger-handler
+* Merge pull request [#117](https://github.com/aws-powertools/powertools-lambda-python/issues/117) from heitorlessa/chore/bump-1.1.3
+* Merge pull request [#116](https://github.com/aws-powertools/powertools-lambda-python/issues/116) from heitorlessa/fix/remove-root-logger-handler
<a name="v1.1.2"></a>
## [v1.1.2] - 2020-08-16
## Bug Fixes
-* return subclass [#107](https://github.com/awslabs/aws-lambda-powertools-python/issues/107)
+* return subclass [#107](https://github.com/aws-powertools/powertools-lambda-python/issues/107)
## Documentation
-* clarify auto_patch as per [#108](https://github.com/awslabs/aws-lambda-powertools-python/issues/108)
+* clarify auto_patch as per [#108](https://github.com/aws-powertools/powertools-lambda-python/issues/108)
## Maintenance
-* bump version to 1.1.2
* suppress LGTM alert
* add autocomplete as unreleased
* remove unused stdout fixture
-* update Tracer docs as per [#108](https://github.com/awslabs/aws-lambda-powertools-python/issues/108)
+* update Tracer docs as per [#108](https://github.com/aws-powertools/powertools-lambda-python/issues/108)
## Pull Requests
-* Merge pull request [#111](https://github.com/awslabs/aws-lambda-powertools-python/issues/111) from heitorlessa/chore/bump-1.1.2
-* Merge pull request [#110](https://github.com/awslabs/aws-lambda-powertools-python/issues/110) from heitorlessa/improv/logger-auto-complete
-* Merge pull request [#109](https://github.com/awslabs/aws-lambda-powertools-python/issues/109) from heitorlessa/docs/tracer-reuse
+* Merge pull request [#111](https://github.com/aws-powertools/powertools-lambda-python/issues/111) from heitorlessa/chore/bump-1.1.2
+* Merge pull request [#110](https://github.com/aws-powertools/powertools-lambda-python/issues/110) from heitorlessa/improv/logger-auto-complete
+* Merge pull request [#109](https://github.com/aws-powertools/powertools-lambda-python/issues/109) from heitorlessa/docs/tracer-reuse
<a name="v1.1.1"></a>
## [v1.1.1] - 2020-08-14
## Bug Fixes
-* regression 104 ([#105](https://github.com/awslabs/aws-lambda-powertools-python/issues/105))
+* regression 104 ([#105](https://github.com/aws-powertools/powertools-lambda-python/issues/105))
* return log level int immediately
* add test covering logging constant
@@ -2157,8 +7469,8 @@
* fix unused fixture
* fix docstring on level [str,int] consistency
* fix test level typo
-* trigger docs on new release ([#102](https://github.com/awslabs/aws-lambda-powertools-python/issues/102)) ([#103](https://github.com/awslabs/aws-lambda-powertools-python/issues/103))
-* trigger docs on new release ([#102](https://github.com/awslabs/aws-lambda-powertools-python/issues/102))
+* trigger docs on new release ([#102](https://github.com/aws-powertools/powertools-lambda-python/issues/102)) ([#103](https://github.com/aws-powertools/powertools-lambda-python/issues/103))
+* trigger docs on new release ([#102](https://github.com/aws-powertools/powertools-lambda-python/issues/102))
* trigger docs on new release
## Regression
@@ -2167,7 +7479,7 @@
## Pull Requests
-* Merge pull request [#106](https://github.com/awslabs/aws-lambda-powertools-python/issues/106) from heitorlessa/fix/regression-104
+* Merge pull request [#106](https://github.com/aws-powertools/powertools-lambda-python/issues/106) from heitorlessa/fix/regression-104
<a name="v1.1.0"></a>
@@ -2178,28 +7490,28 @@
## Features
-* add support for logger inheritance ([#99](https://github.com/awslabs/aws-lambda-powertools-python/issues/99))
+* add support for logger inheritance ([#99](https://github.com/aws-powertools/powertools-lambda-python/issues/99))
* enable issue auto-assigner to core team
## Maintenance
-* bump to 1.1.0 ([#101](https://github.com/awslabs/aws-lambda-powertools-python/issues/101))
-* **deps:** bump lodash from 4.17.15 to 4.17.19 in /docs ([#93](https://github.com/awslabs/aws-lambda-powertools-python/issues/93))
+* bump to 1.1.0 ([#101](https://github.com/aws-powertools/powertools-lambda-python/issues/101))
+* **deps:** bump lodash from 4.17.15 to 4.17.19 in /docs ([#93](https://github.com/aws-powertools/powertools-lambda-python/issues/93))
<a name="v1.0.2"></a>
## [v1.0.2] - 2020-07-16
## Maintenance
-* bump to 1.0.2 ([#90](https://github.com/awslabs/aws-lambda-powertools-python/issues/90))
-* support aws-xray-sdk >=2.5.0 till <3.0.0 ([#89](https://github.com/awslabs/aws-lambda-powertools-python/issues/89))
+* bump to 1.0.2 ([#90](https://github.com/aws-powertools/powertools-lambda-python/issues/90))
+* support aws-xray-sdk >=2.5.0 till <3.0.0 ([#89](https://github.com/aws-powertools/powertools-lambda-python/issues/89))
<a name="v1.0.1"></a>
## [v1.0.1] - 2020-07-05
## Bug Fixes
-* append structured logs when injecting lambda context ([#86](https://github.com/awslabs/aws-lambda-powertools-python/issues/86))
+* append structured logs when injecting lambda context ([#86](https://github.com/aws-powertools/powertools-lambda-python/issues/86))
## Documentation
@@ -2210,19 +7522,19 @@
## [v1.0.0] - 2020-06-18
## Documentation
-* customize contributing guide ([#77](https://github.com/awslabs/aws-lambda-powertools-python/issues/77))
+* customize contributing guide ([#77](https://github.com/aws-powertools/powertools-lambda-python/issues/77))
## Features
-* docs anonymized page view ([#82](https://github.com/awslabs/aws-lambda-powertools-python/issues/82))
-* add metrics metadata ([#81](https://github.com/awslabs/aws-lambda-powertools-python/issues/81))
+* docs anonymized page view ([#82](https://github.com/aws-powertools/powertools-lambda-python/issues/82))
+* add metrics metadata ([#81](https://github.com/aws-powertools/powertools-lambda-python/issues/81))
## Maintenance
-* bump to 1.0.0 GA ([#83](https://github.com/awslabs/aws-lambda-powertools-python/issues/83))
+* bump to 1.0.0 GA ([#83](https://github.com/aws-powertools/powertools-lambda-python/issues/83))
* add missing ':' and identation in examples
-* cleanup tests ([#79](https://github.com/awslabs/aws-lambda-powertools-python/issues/79))
-* remove deprecated code before GA ([#78](https://github.com/awslabs/aws-lambda-powertools-python/issues/78))
+* cleanup tests ([#79](https://github.com/aws-powertools/powertools-lambda-python/issues/79))
+* remove deprecated code before GA ([#78](https://github.com/aws-powertools/powertools-lambda-python/issues/78))
* move blockquotes as hidden comments
@@ -2230,28 +7542,27 @@
## [v0.11.0] - 2020-06-10
## Bug Fixes
-* default dimension creation now happens when metrics are serialized instead of on metrics constructor ([#74](https://github.com/awslabs/aws-lambda-powertools-python/issues/74))
+* default dimension creation now happens when metrics are serialized instead of on metrics constructor ([#74](https://github.com/aws-powertools/powertools-lambda-python/issues/74))
## Maintenance
* update CHANGELOG
-* bump version to 0.11.0 ([#76](https://github.com/awslabs/aws-lambda-powertools-python/issues/76))
<a name="v0.10.1"></a>
## [v0.10.1] - 2020-06-10
## Bug Fixes
-* default dimension creation now happens when metrics are serialized instead of on metrics constructor ([#74](https://github.com/awslabs/aws-lambda-powertools-python/issues/74))
+* default dimension creation now happens when metrics are serialized instead of on metrics constructor ([#74](https://github.com/aws-powertools/powertools-lambda-python/issues/74))
## Documentation
-* fix contrast on highlighted code text ([#73](https://github.com/awslabs/aws-lambda-powertools-python/issues/73))
+* fix contrast on highlighted code text ([#73](https://github.com/aws-powertools/powertools-lambda-python/issues/73))
## Features
-* improve error handling for log_metrics decorator ([#71](https://github.com/awslabs/aws-lambda-powertools-python/issues/71))
-* add high level imports ([#70](https://github.com/awslabs/aws-lambda-powertools-python/issues/70))
+* improve error handling for log_metrics decorator ([#71](https://github.com/aws-powertools/powertools-lambda-python/issues/71))
+* add high level imports ([#70](https://github.com/aws-powertools/powertools-lambda-python/issues/70))
## Maintenance
@@ -2260,22 +7571,22 @@
## Pull Requests
-* Merge pull request [#72](https://github.com/awslabs/aws-lambda-powertools-python/issues/72) from awslabs/dependabot/npm_and_yarn/docs/graphql-playground-html-1.6.25
+* Merge pull request [#72](https://github.com/aws-powertools/powertools-lambda-python/issues/72) from awslabs/dependabot/npm_and_yarn/docs/graphql-playground-html-1.6.25
<a name="v0.10.0"></a>
## v0.10.0 - 2020-06-08
## Bug Fixes
-* correct env var name for publish to pypi test ([#69](https://github.com/awslabs/aws-lambda-powertools-python/issues/69))
+* correct env var name for publish to pypi test ([#69](https://github.com/aws-powertools/powertools-lambda-python/issues/69))
* release-drafter action syntax
* release-drafter label for new feature/major non-breaking changes
-* cast dimension value to str to avoid issue where EMF silently fails ([#52](https://github.com/awslabs/aws-lambda-powertools-python/issues/52))
-* ignore path that might seem a broken link [#49](https://github.com/awslabs/aws-lambda-powertools-python/issues/49)
-* open api ref in a new tab [#48](https://github.com/awslabs/aws-lambda-powertools-python/issues/48)
-* metrics not being flushed on every invocation ([#45](https://github.com/awslabs/aws-lambda-powertools-python/issues/45))
-* [#35](https://github.com/awslabs/aws-lambda-powertools-python/issues/35) duplicate changelog to project root
-* [#24](https://github.com/awslabs/aws-lambda-powertools-python/issues/24) correct example test and docs
+* cast dimension value to str to avoid issue where EMF silently fails ([#52](https://github.com/aws-powertools/powertools-lambda-python/issues/52))
+* ignore path that might seem a broken link [#49](https://github.com/aws-powertools/powertools-lambda-python/issues/49)
+* open api ref in a new tab [#48](https://github.com/aws-powertools/powertools-lambda-python/issues/48)
+* metrics not being flushed on every invocation ([#45](https://github.com/aws-powertools/powertools-lambda-python/issues/45))
+* [#35](https://github.com/aws-powertools/powertools-lambda-python/issues/35) duplicate changelog to project root
+* [#24](https://github.com/aws-powertools/powertools-lambda-python/issues/24) correct example test and docs
* CI attempt 4
* CI attempt 3
* CI attempt 3
@@ -2297,21 +7608,21 @@
## Features
-* add capture_cold_start_metric for log_metrics ([#67](https://github.com/awslabs/aws-lambda-powertools-python/issues/67))
-* automate publishing to pypi ([#58](https://github.com/awslabs/aws-lambda-powertools-python/issues/58))
-* add pre-commit hooks ([#64](https://github.com/awslabs/aws-lambda-powertools-python/issues/64))
+* add capture_cold_start_metric for log_metrics ([#67](https://github.com/aws-powertools/powertools-lambda-python/issues/67))
+* automate publishing to pypi ([#58](https://github.com/aws-powertools/powertools-lambda-python/issues/58))
+* add pre-commit hooks ([#64](https://github.com/aws-powertools/powertools-lambda-python/issues/64))
* update Metrics interface to resemble tracer & logger: use "service" as its namespace.
-* add codecov service ([#59](https://github.com/awslabs/aws-lambda-powertools-python/issues/59))
-* add security and complexity baseline [#33](https://github.com/awslabs/aws-lambda-powertools-python/issues/33) ([#57](https://github.com/awslabs/aws-lambda-powertools-python/issues/57))
-* add pull request template [#33](https://github.com/awslabs/aws-lambda-powertools-python/issues/33)
+* add codecov service ([#59](https://github.com/aws-powertools/powertools-lambda-python/issues/59))
+* add security and complexity baseline [#33](https://github.com/aws-powertools/powertools-lambda-python/issues/33) ([#57](https://github.com/aws-powertools/powertools-lambda-python/issues/57))
+* add pull request template [#33](https://github.com/aws-powertools/powertools-lambda-python/issues/33)
* add RFC template for proposals
* create issue templates
-* readd release drafter action [#33](https://github.com/awslabs/aws-lambda-powertools-python/issues/33)
-* add release drafter ([#56](https://github.com/awslabs/aws-lambda-powertools-python/issues/56))
-* add stale issues config [#33](https://github.com/awslabs/aws-lambda-powertools-python/issues/33) ([#55](https://github.com/awslabs/aws-lambda-powertools-python/issues/55))
-* enforce semantic PR titles ([#54](https://github.com/awslabs/aws-lambda-powertools-python/issues/54))
-* add algolia search for docs and api ref ([#39](https://github.com/awslabs/aws-lambda-powertools-python/issues/39))
-* add documentation website ([#37](https://github.com/awslabs/aws-lambda-powertools-python/issues/37))
+* readd release drafter action [#33](https://github.com/aws-powertools/powertools-lambda-python/issues/33)
+* add release drafter ([#56](https://github.com/aws-powertools/powertools-lambda-python/issues/56))
+* add stale issues config [#33](https://github.com/aws-powertools/powertools-lambda-python/issues/33) ([#55](https://github.com/aws-powertools/powertools-lambda-python/issues/55))
+* enforce semantic PR titles ([#54](https://github.com/aws-powertools/powertools-lambda-python/issues/54))
+* add algolia search for docs and api ref ([#39](https://github.com/aws-powertools/powertools-lambda-python/issues/39))
+* add documentation website ([#37](https://github.com/aws-powertools/powertools-lambda-python/issues/37))
* add docs to CI
* Add Python3.8 support
* **logger:** add log sampling
@@ -2320,16 +7631,16 @@
## Maintenance
-* version bump ([#68](https://github.com/awslabs/aws-lambda-powertools-python/issues/68))
+* version bump ([#68](https://github.com/aws-powertools/powertools-lambda-python/issues/68))
* public beta version
-* rename Makefile target docs-dev to docs-local ([#65](https://github.com/awslabs/aws-lambda-powertools-python/issues/65))
+* rename Makefile target docs-dev to docs-local ([#65](https://github.com/aws-powertools/powertools-lambda-python/issues/65))
* correct docstring for log_metrics
* fix typo in metrics doc
* Correct test comment
* remove unused import
* formatting
* plat wheels are not needed
-* reformat changelog to follow KeepAChangelog standard ([#50](https://github.com/awslabs/aws-lambda-powertools-python/issues/50))
+* reformat changelog to follow KeepAChangelog standard ([#50](https://github.com/aws-powertools/powertools-lambda-python/issues/50))
* bump to release candidate
* renamed history to changelog dependabot
* grammar issues
@@ -2345,87 +7656,190 @@
* CI badge
* public beta version
* **deps:** bump bleach from 3.1.0 to 3.1.1 in /python
-* **deps:** bump websocket-extensions from 0.1.3 to 0.1.4 in /docs ([#66](https://github.com/awslabs/aws-lambda-powertools-python/issues/66))
+* **deps:** bump websocket-extensions from 0.1.3 to 0.1.4 in /docs ([#66](https://github.com/aws-powertools/powertools-lambda-python/issues/66))
## Pull Requests
-* Merge pull request [#60](https://github.com/awslabs/aws-lambda-powertools-python/issues/60) from awslabs/improv/metrics_interface
-* Merge pull request [#8](https://github.com/awslabs/aws-lambda-powertools-python/issues/8) from awslabs/dependabot/pip/python/bleach-3.1.1
-* Merge pull request [#7](https://github.com/awslabs/aws-lambda-powertools-python/issues/7) from danilohgds/sampling_feature
-* Merge pull request [#5](https://github.com/awslabs/aws-lambda-powertools-python/issues/5) from jfuss/feat/python38
-
-
-[Unreleased]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.29.2...HEAD
-[v1.29.2]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.29.1...v1.29.2
-[v1.29.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.29.0...v1.29.1
-[v1.29.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.28.0...v1.29.0
-[v1.28.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.27.0...v1.28.0
-[v1.27.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.26.7...v1.27.0
-[v1.26.7]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.26.6...v1.26.7
-[v1.26.6]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.26.5...v1.26.6
-[v1.26.5]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.26.4...v1.26.5
-[v1.26.4]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.26.3...v1.26.4
-[v1.26.3]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.26.2...v1.26.3
-[v1.26.2]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.26.1...v1.26.2
-[v1.26.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.26.0...v1.26.1
-[v1.26.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.25.10...v1.26.0
-[v1.25.10]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.25.9...v1.25.10
-[v1.25.9]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.25.8...v1.25.9
-[v1.25.8]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.25.7...v1.25.8
-[v1.25.7]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.25.6...v1.25.7
-[v1.25.6]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.25.5...v1.25.6
-[v1.25.5]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.25.4...v1.25.5
-[v1.25.4]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.25.3...v1.25.4
-[v1.25.3]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.25.2...v1.25.3
-[v1.25.2]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.25.1...v1.25.2
-[v1.25.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.25.0...v1.25.1
-[v1.25.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.24.2...v1.25.0
-[v1.24.2]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.24.1...v1.24.2
-[v1.24.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.24.0...v1.24.1
-[v1.24.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.23.0...v1.24.0
-[v1.23.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.22.0...v1.23.0
-[v1.22.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.21.1...v1.22.0
-[v1.21.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.21.0...v1.21.1
-[v1.21.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.20.2...v1.21.0
-[v1.20.2]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.20.1...v1.20.2
-[v1.20.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.20.0...v1.20.1
-[v1.20.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.19.0...v1.20.0
-[v1.19.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.18.1...v1.19.0
-[v1.18.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.18.0...v1.18.1
-[v1.18.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.17.1...v1.18.0
-[v1.17.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.17.0...v1.17.1
-[v1.17.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.16.1...v1.17.0
-[v1.16.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.16.0...v1.16.1
-[v1.16.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.15.1...v1.16.0
-[v1.15.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.15.0...v1.15.1
-[v1.15.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.14.0...v1.15.0
-[v1.14.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.13.0...v1.14.0
-[v1.13.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.12.0...v1.13.0
-[v1.12.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.11.0...v1.12.0
-[v1.11.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.10.5...v1.11.0
-[v1.10.5]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.10.4...v1.10.5
-[v1.10.4]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.10.3...v1.10.4
-[v1.10.3]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.10.2...v1.10.3
-[v1.10.2]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.10.1...v1.10.2
-[v1.10.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.10.0...v1.10.1
-[v1.10.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.9.1...v1.10.0
-[v1.9.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.9.0...v1.9.1
-[v1.9.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.8.0...v1.9.0
-[v1.8.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.7.0...v1.8.0
-[v1.7.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.6.1...v1.7.0
-[v1.6.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.6.0...v1.6.1
-[v1.6.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.5.0...v1.6.0
-[v1.5.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.4.0...v1.5.0
-[v1.4.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.3.1...v1.4.0
-[v1.3.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.3.0...v1.3.1
-[v1.3.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.2.0...v1.3.0
-[v1.2.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.1.3...v1.2.0
-[v1.1.3]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.1.2...v1.1.3
-[v1.1.2]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.1.1...v1.1.2
-[v1.1.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.1.0...v1.1.1
-[v1.1.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.0.2...v1.1.0
-[v1.0.2]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.0.1...v1.0.2
-[v1.0.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v1.0.0...v1.0.1
-[v1.0.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v0.11.0...v1.0.0
-[v0.11.0]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v0.10.1...v0.11.0
-[v0.10.1]: https://github.com/awslabs/aws-lambda-powertools-python/compare/v0.10.0...v0.10.1
+* Merge pull request [#60](https://github.com/aws-powertools/powertools-lambda-python/issues/60) from awslabs/improv/metrics_interface
+* Merge pull request [#8](https://github.com/aws-powertools/powertools-lambda-python/issues/8) from awslabs/dependabot/pip/python/bleach-3.1.1
+* Merge pull request [#7](https://github.com/aws-powertools/powertools-lambda-python/issues/7) from danilohgds/sampling_feature
+* Merge pull request [#5](https://github.com/aws-powertools/powertools-lambda-python/issues/5) from jfuss/feat/python38
+
+
+[Unreleased]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.29.0...HEAD
+[v3.29.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.28.0...v3.29.0
+[v3.28.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.27.0...v3.28.0
+[v3.27.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.26.0...v3.27.0
+[v3.26.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.25.0...v3.26.0
+[v3.25.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.24.0...v3.25.0
+[v3.24.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.23.0...v3.24.0
+[v3.23.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.22.1...v3.23.0
+[v3.22.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.22.0...v3.22.1
+[v3.22.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.21.0...v3.22.0
+[v3.21.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.20.0...v3.21.0
+[v3.20.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.19.0...v3.20.0
+[v3.19.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.17.1...v3.19.0
+[v3.17.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.18.0...v3.17.1
+[v3.18.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.17.0...v3.18.0
+[v3.17.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.16.0...v3.17.0
+[v3.16.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.15.1...v3.16.0
+[v3.15.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.15.0...v3.15.1
+[v3.15.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.14.0...v3.15.0
+[v3.14.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.13.0...v3.14.0
+[v3.13.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.12.0...v3.13.0
+[v3.12.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.11.0...v3.12.0
+[v3.11.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.10.0...v3.11.0
+[v3.10.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.9.0...v3.10.0
+[v3.9.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.8.0...v3.9.0
+[v3.8.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.7.0...v3.8.0
+[v3.7.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.6.0...v3.7.0
+[v3.6.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.5.0...v3.6.0
+[v3.5.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.4.1...v3.5.0
+[v3.4.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.4.0...v3.4.1
+[v3.4.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.3.0...v3.4.0
+[v3.3.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.2.0...v3.3.0
+[v3.2.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.1.0...v3.2.0
+[v3.1.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v3.0.0...v3.1.0
+[v3.0.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.43.1...v3.0.0
+[v2.43.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.43.0...v2.43.1
+[v2.43.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.42.0...v2.43.0
+[v2.42.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.41.0...v2.42.0
+[v2.41.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.40.1...v2.41.0
+[v2.40.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.40.0...v2.40.1
+[v2.40.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.39.1...v2.40.0
+[v2.39.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.39.0...v2.39.1
+[v2.39.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.38.1...v2.39.0
+[v2.38.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.38.0...v2.38.1
+[v2.38.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.37.0...v2.38.0
+[v2.37.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.36.0...v2.37.0
+[v2.36.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.35.1...v2.36.0
+[v2.35.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.35.0...v2.35.1
+[v2.35.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.34.2...v2.35.0
+[v2.34.2]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.34.1...v2.34.2
+[v2.34.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.34.0...v2.34.1
+[v2.34.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.33.1...v2.34.0
+[v2.33.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.33.0...v2.33.1
+[v2.33.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.32.0...v2.33.0
+[v2.32.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.31.0...v2.32.0
+[v2.31.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.30.2...v2.31.0
+[v2.30.2]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.30.1...v2.30.2
+[v2.30.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.30.0...v2.30.1
+[v2.30.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.29.1...v2.30.0
+[v2.29.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.29.0...v2.29.1
+[v2.29.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.28.1...v2.29.0
+[v2.28.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.28.0...v2.28.1
+[v2.28.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.27.1...v2.28.0
+[v2.27.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.27.0...v2.27.1
+[v2.27.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.26.1...v2.27.0
+[v2.26.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.26.0...v2.26.1
+[v2.26.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.25.1...v2.26.0
+[v2.25.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.25.0...v2.25.1
+[v2.25.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.24.0...v2.25.0
+[v2.24.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.23.1...v2.24.0
+[v2.23.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.23.0...v2.23.1
+[v2.23.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.22.0...v2.23.0
+[v2.22.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.21.0...v2.22.0
+[v2.21.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.20.0...v2.21.0
+[v2.20.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.19.0...v2.20.0
+[v2.19.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.18.0...v2.19.0
+[v2.18.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.17.0...v2.18.0
+[v2.17.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.16.2...v2.17.0
+[v2.16.2]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.16.1...v2.16.2
+[v2.16.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.16.0...v2.16.1
+[v2.16.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.15.0...v2.16.0
+[v2.15.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.14.1...v2.15.0
+[v2.14.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.14.0...v2.14.1
+[v2.14.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.13.0...v2.14.0
+[v2.13.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.12.0...v2.13.0
+[v2.12.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.11.0...v2.12.0
+[v2.11.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.10.0...v2.11.0
+[v2.10.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.9.1...v2.10.0
+[v2.9.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.9.0...v2.9.1
+[v2.9.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.8.0...v2.9.0
+[v2.8.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.7.1...v2.8.0
+[v2.7.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.7.0...v2.7.1
+[v2.7.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.6.0...v2.7.0
+[v2.6.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.5.0...v2.6.0
+[v2.5.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.4.0...v2.5.0
+[v2.4.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.3.1...v2.4.0
+[v2.3.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.3.0...v2.3.1
+[v2.3.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.2.0...v2.3.0
+[v2.2.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.1.0...v2.2.0
+[v2.1.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v2.0.0...v2.1.0
+[v2.0.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.31.1...v2.0.0
+[v1.31.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.31.0...v1.31.1
+[v1.31.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.30.0...v1.31.0
+[v1.30.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.29.2...v1.30.0
+[v1.29.2]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.29.1...v1.29.2
+[v1.29.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.29.0...v1.29.1
+[v1.29.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.28.0...v1.29.0
+[v1.28.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.27.0...v1.28.0
+[v1.27.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.26.7...v1.27.0
+[v1.26.7]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.26.6...v1.26.7
+[v1.26.6]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.26.5...v1.26.6
+[v1.26.5]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.26.4...v1.26.5
+[v1.26.4]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.26.3...v1.26.4
+[v1.26.3]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.26.2...v1.26.3
+[v1.26.2]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.26.1...v1.26.2
+[v1.26.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.26.0...v1.26.1
+[v1.26.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.25.10...v1.26.0
+[v1.25.10]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.25.9...v1.25.10
+[v1.25.9]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.25.8...v1.25.9
+[v1.25.8]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.25.7...v1.25.8
+[v1.25.7]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.25.6...v1.25.7
+[v1.25.6]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.25.5...v1.25.6
+[v1.25.5]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.25.4...v1.25.5
+[v1.25.4]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.25.3...v1.25.4
+[v1.25.3]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.25.2...v1.25.3
+[v1.25.2]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.25.1...v1.25.2
+[v1.25.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.25.0...v1.25.1
+[v1.25.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.24.2...v1.25.0
+[v1.24.2]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.24.1...v1.24.2
+[v1.24.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.24.0...v1.24.1
+[v1.24.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.23.0...v1.24.0
+[v1.23.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.22.0...v1.23.0
+[v1.22.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.21.1...v1.22.0
+[v1.21.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.21.0...v1.21.1
+[v1.21.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.20.2...v1.21.0
+[v1.20.2]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.20.1...v1.20.2
+[v1.20.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.20.0...v1.20.1
+[v1.20.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.19.0...v1.20.0
+[v1.19.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.18.1...v1.19.0
+[v1.18.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.18.0...v1.18.1
+[v1.18.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.17.1...v1.18.0
+[v1.17.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.17.0...v1.17.1
+[v1.17.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.16.1...v1.17.0
+[v1.16.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.16.0...v1.16.1
+[v1.16.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.15.1...v1.16.0
+[v1.15.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.15.0...v1.15.1
+[v1.15.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.14.0...v1.15.0
+[v1.14.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.13.0...v1.14.0
+[v1.13.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.12.0...v1.13.0
+[v1.12.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.11.0...v1.12.0
+[v1.11.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.10.5...v1.11.0
+[v1.10.5]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.10.4...v1.10.5
+[v1.10.4]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.10.3...v1.10.4
+[v1.10.3]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.10.2...v1.10.3
+[v1.10.2]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.10.1...v1.10.2
+[v1.10.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.10.0...v1.10.1
+[v1.10.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.9.1...v1.10.0
+[v1.9.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.9.0...v1.9.1
+[v1.9.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.8.0...v1.9.0
+[v1.8.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.7.0...v1.8.0
+[v1.7.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.6.1...v1.7.0
+[v1.6.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.6.0...v1.6.1
+[v1.6.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.5.0...v1.6.0
+[v1.5.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.4.0...v1.5.0
+[v1.4.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.3.1...v1.4.0
+[v1.3.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.3.0...v1.3.1
+[v1.3.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.2.0...v1.3.0
+[v1.2.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.1.3...v1.2.0
+[v1.1.3]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.1.2...v1.1.3
+[v1.1.2]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.1.1...v1.1.2
+[v1.1.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.1.0...v1.1.1
+[v1.1.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.0.2...v1.1.0
+[v1.0.2]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.0.1...v1.0.2
+[v1.0.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v1.0.0...v1.0.1
+[v1.0.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v0.11.0...v1.0.0
+[v0.11.0]: https://github.com/aws-powertools/powertools-lambda-python/compare/v0.10.1...v0.11.0
+[v0.10.1]: https://github.com/aws-powertools/powertools-lambda-python/compare/v0.10.0...v0.10.1
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index b6d29d7b00a..e42ce8ec09a 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -16,10 +16,16 @@
- [API reference documentation](#api-reference-documentation)
- [Licensing](#licensing)
+<!-- markdownlint-disable MD025 -->
# Contributing Guidelines
+<!-- markdownlint-disable MD025 -->
-Thank you for your interest in contributing to our project. Whether it's a bug report, new feature, correction, or additional
-documentation, we greatly value feedback and contributions from our community.
+<!-- markdownlint-disable MD013 -->
+Thank you for your interest in contributing to our project. Whether it's a [bug report](https://github.com/aws-powertools/powertools-lambda-python/issues/new?assignees=&labels=bug%2Ctriage&projects=&template=bug_report.yml&title=Bug%3A+TITLE), [new feature](https://github.com/aws-powertools/powertools-lambda-python/issues/new?assignees=&labels=feature-request%2Ctriage&projects=&template=feature_request.yml&title=Feature+request%3A+TITLE), [correction](https://github.com/aws-powertools/powertools-lambda-python/issues/new/choose), or [additional documentation](https://github.com/aws-powertools/powertools-lambda-python/issues/new?assignees=&labels=documentation%2Ctriage&projects=&template=documentation_improvements.yml&title=Docs%3A+TITLE), we greatly value feedback and contributions from our community.
+<!-- markdownlint-enable MD013 -->
+
+We encourage contributions from the community and we will work with contributors to merge their pull requests.
+Rarely, we may close pull requests that do not meet our guidelines specified in CONTRIBUTING.md, or will require unreasonable effort to meet our quality bar.
Please read through this document before submitting any issues or pull requests to ensure we have all the necessary
information to effectively respond to your bug report or contribution.
@@ -28,8 +34,9 @@ information to effectively respond to your bug report or contribution.
We welcome you to use the GitHub issue tracker to report bugs, suggest features, or documentation improvements.
-When filing an issue, please check existing open, or recently closed, issues to make sure somebody else hasn't already
-reported the issue. Please try to include as much information as you can.
+<!-- markdownlint-disable MD013 -->
+[When filing an issue](https://github.com/aws-powertools/powertools-lambda-python/issues/new/choose), please check [existing open](https://github.com/aws-powertools/powertools-lambda-python/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc), or [recently closed](https://github.com/aws-powertools/powertools-lambda-python/issues?q=is%3Aissue+sort%3Aupdated-desc+is%3Aclosed), issues to make sure somebody else hasn't already reported the issue. Please try to include as much information as you can.
+<!-- markdownlint-enable MD013 -->
## Contributing via Pull Requests
@@ -37,17 +44,63 @@ Contributions via pull requests are much appreciated. Before sending us a pull r
1. You are working against the latest source on the **develop** branch.
2. You check existing open, and recently merged pull requests to make sure someone else hasn't addressed the problem already.
-3. You open an [issue](https://github.com/awslabs/aws-lambda-powertools-python/issues/new/choose) before you begin any implementation. We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.
+3. You open an [issue](https://github.com/aws-powertools/powertools-lambda-python/issues/new/choose) before you begin any implementation. We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.
+
+At a high level, these are the steps to get code merged in the repository - don't worry, nearly all of them are automated.
+
+```mermaid
+timeline
+ title Code integration journey (CI)
+ Project setup <br> (make dev) : Code checkout
+ : Virtual environment
+ : Dependencies
+ : Git pre-commit hooks
+ : Local branch
+ : Local changes
+ : Local tests
+
+ Pre-commit checks <br> (git commit) : Merge conflict check
+ : Trailing whitespaces
+ : TOML checks
+ : Code linting (standards)
+ : Markdown linting
+ : CloudFormation linting
+ : GitHub Actions linting
+ : Terraform linting
+ : Secrets linting
+
+ Pre-Pull Request <br> (make pr) : Code linting
+ : Docs linting
+ : Static typing analysis
+ : Tests (unit|functional|perf|dependencies)
+ : Security baseline
+ : Complexity baseline
+ : +pre-commit checks
+
+ Pull Request <br> (CI checks) : Semantic PR title check
+ : Related issue check
+ : Acknowledgment check
+ : Code coverage diff
+ : Contribution size check
+ : Contribution category check
+ : Dependency vulnerability check
+ : GitHub Actions security check
+ : +pre-pull request checks
+
+ After merge <br> (CI checks) : End-to-end tests
+ : Longer SAST check
+ : Security posture check (scorecard)
+ : GitHub Actions security check
+ : Rebuild Changelog
+ : Deploy staging docs
+ : Update draft release
+```
### Dev setup
-[](https://gitpod.io/from-referrer/)
-
-Firstly, [fork the repository](https://github.com/awslabs/aws-lambda-powertools-python/fork).
-
-To setup your development environment, we recommend using our pre-configured Cloud environment: <https://gitpod.io/#https://github.com/YOUR_USERNAME/aws-lambda-powertools-python>. Replace YOUR_USERNAME with your GitHub username or organization so the Cloud environment can target your fork accordingly.
+Firstly, [fork the repository](https://github.com/aws-powertools/powertools-lambda-python/fork).
-Alternatively, you can use `make dev` within your local virtual environment.
+You can use `make dev` within your local virtual environment to setup your development environment.
To send us a pull request, please follow these steps:
@@ -55,7 +108,7 @@ To send us a pull request, please follow these steps:
2. Run all tests, and code baseline checks: `make pr`
- Git hooks will run linting and formatting while `make pr` run deep checks that also run in the CI process
3. Commit to your fork using clear commit messages.
-4. Send us a pull request with a [conventional semantic title](https://github.com/awslabs/aws-lambda-powertools-python/pull/67), and answering any default questions in the pull request interface.
+4. Send us a pull request with a [conventional semantic title](https://github.com/aws-powertools/powertools-lambda-python/pull/67), and answering any default questions in the pull request interface.
5. Pay attention to any automated CI failures reported in the pull request, and stay involved in the conversation.
GitHub provides additional document on [forking a repository](https://help.github.com/articles/fork-a-repo/) and
@@ -76,9 +129,9 @@ You might find useful to run both the documentation website and the API referenc
| Category | Convention |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Docstring** | We use a slight variation of Numpy convention with markdown to help generate more readable API references. |
-| **Style guide** | We use black as well as flake8 extensions to enforce beyond good practices [PEP8](https://pep8.org/). We use type annotations and enforce static type checking at CI (mypy). |
+| **Style guide** | We use black as well as [Ruff](https://beta.ruff.rs/docs/) to enforce beyond good practices [PEP8](https://pep8.org/). We use type annotations and enforce static type checking at CI (mypy). |
| **Core utilities** | Core utilities use a Class, always accept `service` as a constructor parameter, can work in isolation, and are also available in other languages implementation. |
-| **Utilities** | Utilities are not as strict as core and focus on solving a developer experience problem while following the project [Tenets](https://awslabs.github.io/aws-lambda-powertools-python/#tenets). |
+| **Utilities** | Utilities are not as strict as core and focus on solving a developer experience problem while following the project [Tenets](https://docs.powertools.aws.dev/lambda/python/#tenets). |
| **Exceptions** | Specific exceptions live within utilities themselves and use `Error` suffix e.g. `MetricUnitError`. |
| **Git commits** | We follow [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/). We do not enforce conventional commits on contributors to lower the entry bar. Instead, we enforce a conventional PR title so our label automation and changelog are generated correctly. |
| **API documentation** | API reference docs are generated from docstrings which should have Examples section to allow developers to have what they need within their own IDE. Documentation website covers the wider usage, tips, and strive to be concise. |
@@ -100,13 +153,13 @@ We group tests in different categories
## Finding contributions to work on
-Looking at the existing issues is a great way to find something to contribute on. As our projects, by default, use the default GitHub issue labels (enhancement/bug/help wanted/invalid/question/documentation), looking at any 'help wanted' issues is a great place to start.
+Looking at the existing issues is a great way to find something to contribute on. As our projects, by default, use the default GitHub issue labels (enhancement/bug/help wanted/invalid/question/documentation), [looking at any 'help wanted' issues is a great place to start](https://github.com/orgs/aws-powertools/projects/3/views/5?query=is%3Aopen+sort%3Aupdated-desc).
## Code of Conduct
This project has adopted the [Amazon Open Source Code of Conduct](https://aws.github.io/code-of-conduct).
For more information see the [Code of Conduct FAQ](https://aws.github.io/code-of-conduct-faq) or contact
-opensource-codeofconduct@amazon.com with any additional questions or comments.
+<opensource-codeofconduct@amazon.com> with any additional questions or comments.
## Security issue notifications
diff --git a/LICENSE b/LICENSE
index 9e30e05ab6d..fcdede53dc8 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,3 +1,5 @@
+MIT No Attribution
+
Copyright 2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.
Permission is hereby granted, free of charge, to any person obtaining a copy of
diff --git a/MAINTAINERS.md b/MAINTAINERS.md
index fb94090f762..2fa7b2eed23 100644
--- a/MAINTAINERS.md
+++ b/MAINTAINERS.md
@@ -1,365 +1,3 @@
-<!-- markdownlint-disable MD043 -->
-## Table of contents <!-- omit in toc -->
+<!-- markdownlint-disable -->
-- [Overview](#overview)
-- [Current Maintainers](#current-maintainers)
-- [Emeritus](#emeritus)
-- [Labels](#labels)
-- [Maintainer Responsibilities](#maintainer-responsibilities)
- - [Uphold Code of Conduct](#uphold-code-of-conduct)
- - [Prioritize Security](#prioritize-security)
- - [Review Pull Requests](#review-pull-requests)
- - [Triage New Issues](#triage-new-issues)
- - [Triage Bug Reports](#triage-bug-reports)
- - [Triage RFCs](#triage-rfcs)
- - [Releasing a new version](#releasing-a-new-version)
- - [Drafting release notes](#drafting-release-notes)
- - [Run end to end tests](#run-end-to-end-tests)
- - [Structure](#structure)
- - [Workflow](#workflow)
- - [Releasing a documentation hotfix](#releasing-a-documentation-hotfix)
- - [Maintain Overall Health of the Repo](#maintain-overall-health-of-the-repo)
- - [Manage Roadmap](#manage-roadmap)
- - [Add Continuous Integration Checks](#add-continuous-integration-checks)
- - [Negative Impact on the Project](#negative-impact-on-the-project)
- - [Becoming a maintainer](#becoming-a-maintainer)
-- [Common scenarios](#common-scenarios)
- - [Contribution is stuck](#contribution-is-stuck)
- - [Insufficient feedback or information](#insufficient-feedback-or-information)
- - [Crediting contributions](#crediting-contributions)
- - [Is that a bug?](#is-that-a-bug)
- - [Mentoring contributions](#mentoring-contributions)
- - [Long running issues or PRs](#long-running-issues-or-prs)
-
-## Overview
-
-> **Please treat this content as a living document.**
-
-This is document explains who the maintainers are (see below), what they do in this repo, and how they should be doing it. If you're interested in contributing, see [CONTRIBUTING](CONTRIBUTING.md).
-
-## Current Maintainers
-
-| Maintainer | GitHub ID | Affiliation |
-| ----------------- | ------------------------------------------------------- | ----------- |
-| Heitor Lessa | [heitorlessa](https://github.com/heitorlessa) | Amazon |
-| Alexander Melnyk | [am29d](https://github.com/am29d) | Amazon |
-| Michal Ploski | [mploski](https://github.com/mploski) | Amazon |
-| Simon Thulbourn | [sthulb](https://github.com/sthulb) | Amazon |
-| Ruben Fonseca | [rubenfonseca](https://github.com/rubenfonseca) | Amazon |
-| Leandro Damascena | [leandrodamascena](https://github.com/leandrodamascena) | Amazon |
-
-## Emeritus
-
-Previous active maintainers who contributed to this project.
-
-| Maintainer | GitHub ID | Affiliation |
-| ----------------- | ----------------------------------------------- | ----------- |
-| Tom McCarthy | [cakepietoast](https://github.com/cakepietoast) | MongoDB |
-| Nicolas Moutschen | [nmoutschen](https://github.com/nmoutschen) | Apollo |
-
-## Labels
-
-These are the most common labels used by maintainers to triage issues, pull requests (PR), and for project management:
-
-| Label | Usage | Notes |
-| ---------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------- |
-| triage | New issues that require maintainers review | Issue template |
-| bug | Unexpected, reproducible and unintended software behavior | PR/Release automation; Doc snippets are excluded; |
-| not-a-bug | New and existing bug reports incorrectly submitted as bug | Analytics |
-| documentation | Documentation improvements | PR/Release automation; Doc additions, fixes, etc.; |
-| feature-request | New or enhancements to existing features | Issue template |
-| typing | New or enhancements to static typing | Issue template |
-| RFC | Technical design documents related to a feature request | Issue template |
-| bug-upstream | Bug caused by upstream dependency | |
-| help wanted | Tasks you want help from anyone to move forward | Bandwidth, complex topics, etc. |
-| need-customer-feedback | Tasks that need more feedback before proceeding | 80/20% rule, uncertain, etc. |
-| need-more-information | Missing information before making any calls | |
-| need-documentation | PR is missing or has incomplete documentation | |
-| need-issue | PR is missing a related issue for tracking change | Needs to be automated |
-| need-rfc | Feature request requires a RFC to improve discussion | |
-| pending-release | Merged changes that will be available soon | Release automation auto-closes/notifies it |
-| revisit-in-3-months | Blocked issues/PRs that need to be revisited | Often related to `need-customer-feedback`, prioritization, etc. |
-| breaking-change | Changes that will cause customer impact and need careful triage | |
-| do-not-merge | PRs that are blocked for varying reasons | Timeline is uncertain |
-| size/XS | PRs between 0-9 LOC | PR automation |
-| size/S | PRs between 10-29 LOC | PR automation |
-| size/M | PRs between 30-99 LOC | PR automation |
-| size/L | PRs between 100-499 LOC | PR automation |
-| size/XL | PRs between 500-999 LOC, often PRs that grown with feedback | PR automation |
-| size/XXL | PRs with 1K+ LOC, largely documentation related | PR automation |
-| tests | PRs that add or change tests | PR automation |
-| `<utility>` | PRs related to a Powertools utility, e.g. `parameters`, `tracer` | PR automation |
-| feature | New features or minor changes | PR/Release automation |
-| dependencies | Changes that touch dependencies, e.g. Dependabot, etc. | PR/ automation |
-| github-actions | Changes in GitHub workflows | PR automation |
-| github-templates | Changes in GitHub issue/PR templates | PR automation |
-| internal | Changes in governance, tech debt and chores (linting setup, baseline, etc.) | PR automation |
-
-## Maintainer Responsibilities
-
-Maintainers are active and visible members of the community, and have [maintain-level permissions on a repository](https://docs.github.com/en/organizations/managing-access-to-your-organizations-repositories/repository-permission-levels-for-an-organization). Use those privileges to serve the community and evolve code as follows.
-
-Be aware of recurring ambiguous situations and [document them](#common-scenarios) to help your fellow maintainers.
-
-### Uphold Code of Conduct
-
-Model the behavior set forward by the [Code of Conduct](CODE_OF_CONDUCT.md) and raise any violations to other maintainers and admins. There could be unusual circumstances where inappropriate behavior does not immediately fall within the [Code of Conduct](CODE_OF_CONDUCT.md).
-
-These might be nuanced and should be handled with extra care - when in doubt, do not engage and reach out to other maintainers and admins.
-
-### Prioritize Security
-
-Security is your number one priority. Maintainer's Github keys must be password protected securely and any reported security vulnerabilities are addressed before features or bugs.
-
-Note that this repository is monitored and supported 24/7 by Amazon Security, see [Reporting a Vulnerability](SECURITY.md) for details.
-
-### Review Pull Requests
-
-Review pull requests regularly, comment, suggest, reject, merge and close. Accept only high quality pull-requests. Provide code reviews and guidance on incoming pull requests.
-
-PRs are [labeled](#labels) based on file changes and semantic title. Pay attention to whether labels reflect the current state of the PR and correct accordingly.
-
-Use and enforce [semantic versioning](https://semver.org/) pull request titles, as these will be used for [CHANGELOG](CHANGELOG.md) and [Release notes](https://github.com/awslabs/aws-lambda-powertools-python/releases) - make sure they communicate their intent at the human level.
-
-> TODO: This is an area we want to automate using the new GitHub GraphQL API.
-
-For issues linked to a PR, make sure `pending release` label is applied to them when merging. [Upon release](#releasing-a-new-version), these issues will be notified which release version contains their change.
-
-See [Common scenarios](#common-scenarios) section for additional guidance.
-
-### Triage New Issues
-
-Manage [labels](#labels), review issues regularly, and create new labels as needed by the project. Remove `triage` label when you're able to confirm the validity of a request, a bug can be reproduced, etc. Give priority to the original author for implementation, unless it is a sensitive task that is best handled by maintainers.
-
-> TODO: This is an area we want to automate using the new GitHub GraphQL API.
-
-Make sure issues are assigned to our [board of activities](https://github.com/orgs/awslabs/projects/51/) and have the right [status](https://awslabs.github.io/aws-lambda-powertools-python/latest/roadmap/#roadmap-status-definition).
-
-Use our [labels](#labels) to signal good first issues to new community members, and to set expectation that this might need additional feedback from the author, other customers, experienced community members and/or maintainers.
-
-Be aware of [casual contributors](https://opensource.com/article/17/10/managing-casual-contributors) and recurring contributors. Provide the experience and attention you wish you had if you were starting in open source.
-
-See [Common scenarios](#common-scenarios) section for additional guidance.
-
-### Triage Bug Reports
-
-Be familiar with [our definition of bug](#is-that-a-bug). If it's not a bug, you can close it or adjust its title and labels - always communicate the reason accordingly.
-
-For bugs caused by upstream dependencies, replace `bug` with `bug-upstream` label. Ask the author whether they'd like to raise the issue upstream or if they prefer us to do so.
-
-Assess the impact and make the call on whether we need an emergency release. Contact other [maintainers](#current-maintainers) when in doubt.
-
-See [Common scenarios](#common-scenarios) section for additional guidance.
-
-### Triage RFCs
-
-RFC is a collaborative process to help us get to the most optimal solution given the context. Their purpose is to ensure everyone understands what this context is, their trade-offs, and alternative solutions that were part of the research before implementation begins.
-
-Make sure you ask these questions in mind when reviewing:
-
-- Does it use our [RFC template](https://github.com/awslabs/aws-lambda-powertools-python/issues/new?assignees=&labels=RFC%2Ctriage&template=rfc.yml&title=RFC%3A+TITLE)?
-- Does the match our [Tenets](https://awslabs.github.io/aws-lambda-powertools-python/latest/#tenets)?
-- Does the proposal address the use case? If so, is the recommended usage explicit?
-- Does it focus on the mechanics to solve the use case over fine-grained implementation details?
-- Can anyone familiar with the code base implement it?
-- If approved, are they interested in contributing? Do they need any guidance?
-- Does this significantly increase the overall project maintenance? Do we have the skills to maintain it?
-- If we can't take this use case, are there alternative projects we could recommend? Or does it call for a new project altogether?
-
-When necessary, be upfront that the time to review, approve, and implement a RFC can vary - see [Contribution is stuck](#contribution-is-stuck). Some RFCs may be further updated after implementation, as certain areas become clearer.
-
-Some examples using our initial and new RFC templates: #92, #94, #95, #991, #1226
-
-### Releasing a new version
-
-Firstly, make sure the commit history in the `develop` branch **(1)** it's up to date, **(2)** commit messages are semantic, and **(3)** commit messages have their respective area, for example `feat(logger): <change>`, `chore(ci): ...`).
-
-**Found typos or unclear commit messages?**
-
-Reword through rebase and push with `--force-with-lease` once you're confident. This will ensure [CHANGELOG](./CHANGELOG.md) is always clear for customers looking to understand what changed in between releases - was that a bug? what new features and for which utility?
-
-**Looks good, what's next?**
-
-The only step is to draft and publish a good release notes, everything else is automated.
-
-#### Drafting release notes
-
-Visit the [Releases page](https://github.com/awslabs/aws-lambda-powertools-python/releases) and choose the edit pencil button.
-
-Make sure the `tag` field reflects the new version you're releasing, the target branch field is set to `develop`, and `release title` matches your tag e.g., `v1.26.0`.
-
-You'll notice we group all changes based on their [labels](#labels) like `feature`, `bug`, `documentation`, etc.
-
-**I spotted a typo or incorrect grouping - how do I fix it?**
-
-Edit the respective PR title and update their [labels](#labels). Then run the [Release Drafter workflow](https://github.com/awslabs/aws-lambda-powertools-python/actions/workflows/release-drafter.yml) to update the Draft release.
-
-**All looking good, what's next?**
-
-The best part comes now. Replace the placeholder `[Human readable summary of changes]` with what you'd like to communicate to customers what this release is all about. Rule of thumb: always put yourself in the customers shoes.
-
-These are some questions to keep in mind when drafting your first or future release notes:
-
-- Can customers understand at a high level what changed in this release?
-- Is there a link to the documentation where they can read more about each main change?
-- Are there any graphics or [code snippets](carbon.now.sh/) that can enhance readability?
-- Are we calling out any key contributor(s) to this release?
- - All contributors are automatically credited, use this as an exceptional case to feature them
-
-Once you're happy, hit `Publish release` 🎉🎉🎉.
-
-This will kick off the [Publishing workflow](https://github.com/awslabs/aws-lambda-powertools-python/actions/workflows/on_release_notes.yml) and within a few minutes you should see the latest version in PyPi, and all issues labeled as `pending-release` will be closed and notified.
-
-> TODO: Include information to verify SAR and Lambda Layers deployment; we're still finalizing Lambda Layer automated deployment in GitHub Actions - ping @am29d when in doubt.
-
-### Run end to end tests
-
-E2E tests are run on every push to `develop` or manually via [run-e2e-tests workflow](https://github.com/awslabs/aws-lambda-powertools-python/actions/workflows/run-e2e-tests.yml).
-
-To run locally, you need [AWS CDK CLI](https://docs.aws.amazon.com/cdk/v2/guide/getting_started.html#getting_started_prerequisites) and an [account bootstrapped](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html) (`cdk bootstrap`). With a default AWS CLI profile configured, or `AWS_PROFILE` environment variable set, run `make e2e tests`.
-
-#### Structure
-
-Our E2E framework relies on pytest fixtures to coordinate infrastructure and test parallelization (see [Workflow](#workflow)). You'll notice multiple `conftest.py`, `infrastructure.py`, and `handlers`.
-
-- **`infrastructure`**. Uses CDK to define what a Stack for a given feature should look like. It inherits from `BaseInfrastructure` to handle all boilerplate and deployment logic necessary.
-- **`conftest.py`**. Imports and deploys a given feature Infrastructure. Hierarchy matters. Top-level `conftest` deploys stacks only once and blocks I/O across all CPUs. Feature-level `conftest` deploys stacks in parallel, and once complete run all tests in parallel.
-- **`handlers`**. Lambda function handlers that will be automatically deployed and exported as PascalCase for later use.
-
-```shell
-.
-├── __init__.py
-├── conftest.py # deploys Lambda Layer stack
-├── logger
-│ ├── __init__.py
-│ ├── conftest.py # deploys LoggerStack
-│ ├── handlers
-│ │ └── basic_handler.py
-│ ├── infrastructure.py # LoggerStack definition
-│ └── test_logger.py
-├── metrics
-│ ├── __init__.py
-│ ├── conftest.py # deploys MetricsStack
-│ ├── handlers
-│ │ ├── basic_handler.py
-│ │ └── cold_start.py
-│ ├── infrastructure.py # MetricsStack definition
-│ └── test_metrics.py
-├── tracer
-│ ├── __init__.py
-│ ├── conftest.py # deploys TracerStack
-│ ├── handlers
-│ │ ├── async_capture.py
-│ │ └── basic_handler.py
-│ ├── infrastructure.py # TracerStack definition
-│ └── test_tracer.py
-└── utils
- ├── Dockerfile
- ├── __init__.py
- ├── data_builder # build_service_name(), build_add_dimensions_input, etc.
- ├── data_fetcher # get_traces(), get_logs(), get_lambda_response(), etc.
- ├── infrastructure.py # base infrastructure like deploy logic, Layer Stack, etc.
-```
-
-#### Workflow
-
-We parallelize our end-to-end tests to benefit from speed and isolate Lambda functions to ease assessing side effects (e.g., traces, logs, etc.). The following diagram demonstrates the process we take every time you use `make e2e`:
-
-```mermaid
-graph TD
- A[make e2e test] -->Spawn{"Split and group tests <br>by feature and CPU"}
-
- Spawn -->|Worker0| Worker0_Start["Load tests"]
- Spawn -->|Worker1| Worker1_Start["Load tests"]
- Spawn -->|WorkerN| WorkerN_Start["Load tests"]
-
- Worker0_Start -->|Wait| LambdaLayerStack["Lambda Layer Stack Deployment"]
- Worker1_Start -->|Wait| LambdaLayerStack["Lambda Layer Stack Deployment"]
- WorkerN_Start -->|Wait| LambdaLayerStack["Lambda Layer Stack Deployment"]
-
- LambdaLayerStack -->|Worker0| Worker0_Deploy["Launch feature stack"]
- LambdaLayerStack -->|Worker1| Worker1_Deploy["Launch feature stack"]
- LambdaLayerStack -->|WorkerN| WorkerN_Deploy["Launch feature stack"]
-
- Worker0_Deploy -->|Worker0| Worker0_Tests["Run tests"]
- Worker1_Deploy -->|Worker1| Worker1_Tests["Run tests"]
- WorkerN_Deploy -->|WorkerN| WorkerN_Tests["Run tests"]
-
- Worker0_Tests --> ResultCollection
- Worker1_Tests --> ResultCollection
- WorkerN_Tests --> ResultCollection
-
- ResultCollection{"Wait for workers<br/>Collect test results"}
- ResultCollection --> TestEnd["Report results"]
- ResultCollection --> DeployEnd["Delete Stacks"]
-```
-
-### Releasing a documentation hotfix
-
-You can rebuild the latest documentation without a full release via this [GitHub Actions Workflow](https://github.com/awslabs/aws-lambda-powertools-python/actions/workflows/rebuild_latest_docs.yml). Choose `Run workflow`, keep `develop` as the branch, and input the latest Powertools version available.
-
-This workflow will update both user guide and API documentation.
-
-### Maintain Overall Health of the Repo
-
-> TODO: Coordinate renaming `develop` to `main`
-
-Keep the `develop` branch at production quality at all times. Backport features as needed. Cut release branches and tags to enable future patches.
-
-### Manage Roadmap
-
-See [Roadmap section](https://awslabs.github.io/aws-lambda-powertools-python/latest/roadmap/)
-
-Ensure the repo highlights features that should be elevated to the project roadmap. Be clear about the feature’s status, priority, target version, and whether or not it should be elevated to the roadmap.
-
-### Add Continuous Integration Checks
-
-Add integration checks that validate pull requests and pushes to ease the burden on Pull Request reviewers. Continuously revisit areas of improvement to reduce operational burden in all parties involved.
-
-### Negative Impact on the Project
-
-Actions that negatively impact the project will be handled by the admins, in coordination with other maintainers, in balance with the urgency of the issue. Examples would be [Code of Conduct](CODE_OF_CONDUCT.md) violations, deliberate harmful or malicious actions, spam, monopolization, and security risks.
-
-### Becoming a maintainer
-
-In 2023, we will revisit this. We need to improve our understanding of how other projects are doing, their mechanisms to promote key contributors, and how they interact daily.
-
-We suspect this process might look similar to the [OpenSearch project](https://github.com/opensearch-project/.github/blob/main/MAINTAINERS.md#becoming-a-maintainer).
-
-## Common scenarios
-
-These are recurring ambiguous situations that new and existing maintainers may encounter. They serve as guidance. It is up to each maintainer to follow, adjust, or handle in a different manner as long as [our conduct is consistent](#uphold-code-of-conduct)
-
-### Contribution is stuck
-
-A contribution can get stuck often due to lack of bandwidth and language barrier. For bandwidth issues, check whether the author needs help. Make sure you get their permission before pushing code into their existing PR - do not create a new PR unless strictly necessary.
-
-For language barrier and others, offer a 1:1 chat to get them unblocked. Often times, English might not be their primary language, and writing in public might put them off, or come across not the way they intended to be.
-
-In other cases, you may have constrained capacity. Use `help wanted` label when you want to signal other maintainers and external contributors that you could use a hand to move it forward.
-
-### Insufficient feedback or information
-
-When in doubt, use `need-more-information` or `need-customer-feedback` labels to signal more context and feedback are necessary before proceeding. You can also use `revisit-in-3-months` label when you expect it might take a while to gather enough information before you can decide.
-
-### Crediting contributions
-
-We credit all contributions as part of each [release note](https://github.com/awslabs/aws-lambda-powertools-python/releases) as an automated process. If you find contributors are missing from the release note you're producing, please add them manually.
-
-### Is that a bug?
-
-A bug produces incorrect or unexpected results at runtime that differ from its intended behavior. Bugs must be reproducible. They directly affect customers experience at runtime despite following its recommended usage.
-
-Documentation snippets, use of internal components, or unadvertised functionalities are not considered bugs.
-
-### Mentoring contributions
-
-Always favor mentoring issue authors to contribute, unless they're not interested or the implementation is sensitive (_e.g., complexity, time to release, etc._).
-
-Make use of `help wanted` and `good first issue` to signal additional contributions the community can help.
-
-### Long running issues or PRs
-
-Try offering a 1:1 call in the attempt to get to a mutual understanding and clarify areas that maintainers could help.
-
-In the rare cases where both parties don't have the bandwidth or expertise to continue, it's best to use the `revisit-in-3-months` label. By then, see if it's possible to break the PR or issue in smaller chunks, and eventually close if there is no progress.
+Maintainers' playbook moved: https://docs.powertools.aws.dev/lambda/python/latest/maintainers/
diff --git a/Makefile b/Makefile
index 7a212738c53..5c0125090a2 100644
--- a/Makefile
+++ b/Makefile
@@ -1,25 +1,29 @@
-.PHONY: target dev format lint test coverage-html pr build build-docs build-docs-api build-docs-website
-.PHONY: docs-local docs-api-local security-baseline complexity-baseline release-prod release-test release
+.PHONY: target dev format lint test coverage-html pr build build-docs build-docs-website
+.PHONY: docs-local security-baseline complexity-baseline release-prod release-test release
target:
@$(MAKE) pr
dev:
pip install --upgrade pip pre-commit poetry
- poetry install --extras "pydantic"
+ @$(MAKE) dev-version-plugin
+ poetry install --extras "all redis datamasking valkey"
pre-commit install
-dev-gitpod:
- pip install --upgrade pip poetry
- poetry install --extras "pydantic"
+dev-quality-code:
+ pip install --upgrade pip pre-commit poetry
+ @$(MAKE) dev-version-plugin
+ poetry install --extras "all redis datamasking valkey"
pre-commit install
+format-check:
+ poetry run ruff format aws_lambda_powertools tests examples --check
+
format:
- poetry run isort aws_lambda_powertools tests examples
- poetry run black aws_lambda_powertools tests examples
+ poetry run ruff format aws_lambda_powertools tests examples
lint: format
- poetry run flake8 aws_lambda_powertools tests examples
+ poetry run ruff check aws_lambda_powertools tests examples
lint-docs:
docker run -v ${PWD}:/markdown 06kellyjac/markdownlint-cli "docs"
@@ -31,11 +35,17 @@ test:
poetry run pytest -m "not perf" --ignore tests/e2e --cov=aws_lambda_powertools --cov-report=xml
poetry run pytest --cache-clear tests/performance
+test-dependencies:
+ poetry run nox --error-on-external-run --reuse-venv=yes --non-interactive
+
+test-pydanticv2:
+ poetry run pytest -m "not perf" --ignore tests/e2e
+
unit-test:
poetry run pytest tests/unit
e2e-test:
- python parallel_run_e2e.py
+ poetry run pytest tests/e2e
coverage-html:
poetry run pytest -m "not perf" --ignore tests/e2e --cov=aws_lambda_powertools --cov-report=html
@@ -48,19 +58,6 @@ pr: lint lint-docs mypy pre-commit test security-baseline complexity-baseline
build: pr
poetry build
-release-docs:
- @echo "Rebuilding docs"
- rm -rf site api
- @echo "Updating website docs"
- poetry run mike deploy --push --update-aliases ${VERSION} ${ALIAS}
- @echo "Building API docs"
- @$(MAKE) build-docs-api
-
-build-docs-api:
- poetry run pdoc --html --output-dir ./api/ ./aws_lambda_powertools --force
- mv -f ./api/aws_lambda_powertools/* ./api/
- rm -rf ./api/aws_lambda_powertools
-
docs-local:
poetry run mkdocs serve
@@ -68,9 +65,6 @@ docs-local-docker:
docker build -t squidfunk/mkdocs-material ./docs/
docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material
-docs-api-local:
- poetry run pdoc --http : aws_lambda_powertools
-
security-baseline:
poetry run bandit --baseline bandit.baseline -r aws_lambda_powertools
@@ -78,7 +72,7 @@ complexity-baseline:
$(info Maintenability index)
poetry run radon mi aws_lambda_powertools
$(info Cyclomatic complexity index)
- poetry run xenon --max-absolute C --max-modules A --max-average A aws_lambda_powertools
+ poetry run xenon --max-absolute C --max-modules A --max-average A aws_lambda_powertools --exclude aws_lambda_powertools/shared/json_encoder.py,aws_lambda_powertools/utilities/validation/base.py,aws_lambda_powertools/event_handler/api_gateway.py
#
# Use `poetry version <major>/<minor></patch>` for version bump
@@ -101,7 +95,13 @@ changelog:
git fetch --tags origin
CURRENT_VERSION=$(shell git describe --abbrev=0 --tag) ;\
echo "[+] Pre-generating CHANGELOG for tag: $$CURRENT_VERSION" ;\
- docker run -v "${PWD}":/workdir quay.io/git-chglog/git-chglog > CHANGELOG.md
+ docker run -v "${PWD}":/workdir quay.io/git-chglog/git-chglog:0.15.1 > CHANGELOG.md
mypy:
poetry run mypy --pretty aws_lambda_powertools examples
+
+ty:
+ poetry run ty check .
+
+dev-version-plugin:
+ poetry self add git+https://github.com/monim67/poetry-bumpversion@348de6f247222e2953d649932426e63492e0a6bf
diff --git a/README.md b/README.md
index 2065a983342..34d3cac965c 100644
--- a/README.md
+++ b/README.md
@@ -1,32 +1,43 @@
-# AWS Lambda Powertools for Python
+<!-- markdownlint-disable MD013 MD041 MD043 -->
+# Powertools for AWS Lambda (Python)
-[](https://github.com/awslabs/aws-lambda-powertools-python/actions/workflows/python_build.yml)
-[](https://app.codecov.io/gh/awslabs/aws-lambda-powertools-python)
-  
-[](https://discord.gg/B8zZKbbyET)
+[](https://github.com/aws-powertools/powertools-lambda-python/actions/workflows/python_build.yml)
+[](https://app.codecov.io/gh/aws-powertools/powertools-lambda-python)
+   [](https://scorecard.dev/viewer/?uri=github.com/aws-powertools/powertools-lambda-python)
+[](https://discord.gg/B8zZKbbyET)
-A suite of Python utilities for AWS Lambda functions to ease adopting best practices such as tracing, structured logging, custom metrics, and more. (AWS Lambda Powertools [Java](https://github.com/awslabs/aws-lambda-powertools-java) and [Typescript](https://github.com/awslabs/aws-lambda-powertools-typescript) is also available).
+Powertools for AWS Lambda (Python) is a developer toolkit to implement Serverless [best practices and increase developer velocity](https://docs.powertools.aws.dev/lambda/python/latest/#features).
-**[📜Documentation](https://awslabs.github.io/aws-lambda-powertools-python/)** | **[🐍PyPi](https://pypi.org/project/aws-lambda-powertools/)** | **[Roadmap](https://awslabs.github.io/aws-lambda-powertools-python/latest/roadmap/)** | **[Detailed blog post](https://aws.amazon.com/blogs/opensource/simplifying-serverless-best-practices-with-lambda-powertools/)**
+Also available in [Java](https://github.com/aws-powertools/powertools-lambda-java), [TypeScript](https://github.com/aws-powertools/powertools-lambda-typescript), and [.NET](https://github.com/aws-powertools/powertools-lambda-dotnet).
-> **An AWS Developer Acceleration (DevAx) initiative by Specialist Solution Architects | aws-devax-open-source@amazon.com**
+[� Doccumentation](https://docs.powertools.aws.dev/lambda/python/) | [🐍 PyPi](https://pypi.org/project/aws-lambda-powertools/) | [🗺️ Roadmap](https://docs.powertools.aws.dev/lambda/python/latest/roadmap/) | [📰 Blog](https://aws.amazon.com/blogs/opensource/simplifying-serverless-best-practices-with-lambda-powertools/)
+
+
## Features
-* **[Tracing](https://awslabs.github.io/aws-lambda-powertools-python/latest/core/tracer/)** - Decorators and utilities to trace Lambda function handlers, and both synchronous and asynchronous functions
-* **[Logging](https://awslabs.github.io/aws-lambda-powertools-python/latest/core/logger/)** - Structured logging made easier, and decorator to enrich structured logging with key Lambda context details
-* **[Metrics](https://awslabs.github.io/aws-lambda-powertools-python/latest/core/metrics/)** - Custom Metrics created asynchronously via CloudWatch Embedded Metric Format (EMF)
-* **[Event handler: AppSync](https://awslabs.github.io/aws-lambda-powertools-python/latest/core/event_handler/appsync/)** - AWS AppSync event handler for Lambda Direct Resolver and Amplify GraphQL Transformer function
-* **[Event handler: API Gateway and ALB](https://awslabs.github.io/aws-lambda-powertools-python/latest/core/event_handler/api_gateway/)** - Amazon API Gateway REST/HTTP API and ALB event handler for Lambda functions invoked using Proxy integration
-* **[Bring your own middleware](https://awslabs.github.io/aws-lambda-powertools-python/latest/utilities/middleware_factory/)** - Decorator factory to create your own middleware to run logic before, and after each Lambda invocation
-* **[Parameters utility](https://awslabs.github.io/aws-lambda-powertools-python/latest/utilities/parameters/)** - Retrieve and cache parameter values from Parameter Store, Secrets Manager, or DynamoDB
-* **[Batch processing](https://awslabs.github.io/aws-lambda-powertools-python/latest/utilities/batch/)** - Handle partial failures for AWS SQS batch processing
-* **[Typing](https://awslabs.github.io/aws-lambda-powertools-python/latest/utilities/typing/)** - Static typing classes to speedup development in your IDE
-* **[Validation](https://awslabs.github.io/aws-lambda-powertools-python/latest/utilities/validation/)** - JSON Schema validator for inbound events and responses
-* **[Event source data classes](https://awslabs.github.io/aws-lambda-powertools-python/latest/utilities/data_classes/)** - Data classes describing the schema of common Lambda event triggers
-* **[Parser](https://awslabs.github.io/aws-lambda-powertools-python/latest/utilities/parser/)** - Data parsing and deep validation using Pydantic
-* **[Idempotency](https://awslabs.github.io/aws-lambda-powertools-python/latest/utilities/idempotency/)** - Convert your Lambda functions into idempotent operations which are safe to retry
-* **[Feature Flags](https://awslabs.github.io/aws-lambda-powertools-python/latest/utilities/feature_flags/)** - A simple rule engine to evaluate when one or multiple features should be enabled depending on the input
+Core utilities such as Tracing, Logging, Metrics, and Event Handler are available across all Powertools for AWS Lambda languages. Additional utilities are subjective to each language ecosystem and customer demand.
+
+* **[Tracing](https://docs.powertools.aws.dev/lambda/python/latest/core/tracer/)** - Decorators and utilities to trace Lambda function handlers, and both synchronous and asynchronous functions
+* **[Logging](https://docs.powertools.aws.dev/lambda/python/latest/core/logger/)** - Structured logging made easier, and target to enrich structured logging with key Lambda context details
+* **[Metrics](https://docs.powertools.aws.dev/lambda/python/latest/core/metrics/)** - Custom Metrics created asynchronously via CloudWatch Embedded Metric Format (EMF)
+* **[Event handler: AppSync](https://docs.powertools.aws.dev/lambda/python/latest/core/event_handler/appsync/)** - AppSync event handler for Lambda Direct Resolver and Amplify GraphQL Transformer function
+* **[Event handler: AppSync Events](https://docs.powertools.aws.dev/lambda/python/latest/core/event_handler/appsync_events/)** - AppSync Events handler for real-time WebSocket APIs with pub/sub pattern
+* **[Event handler: API Gateway, ALB, Lambda Function URL, VPC Lattice](https://docs.powertools.aws.dev/lambda/python/latest/core/event_handler/api_gateway/)** - REST/HTTP API event handler for Lambda functions invoked via Amazon API Gateway, ALB, Lambda Function URL, and VPC Lattice
+* **[Event handler: Agents for Amazon Bedrock](https://docs.powertools.aws.dev/lambda/python/latest/core/event_handler/bedrock_agents/)** - Create Agents for Amazon Bedrock, automatically generating OpenAPI schemas
+* **[Middleware factory](https://docs.powertools.aws.dev/lambda/python/latest/utilities/middleware_factory/)** - Decorator factory to create your own middleware to run logic before, and after each Lambda invocation
+* **[Parameters](https://docs.powertools.aws.dev/lambda/python/latest/utilities/parameters/)** - Retrieve and cache parameter values from Parameter Store, Secrets Manager, AppConfig, or DynamoDB
+* **[Batch processing](https://docs.powertools.aws.dev/lambda/python/latest/utilities/batch/)** - Handle partial failures for AWS SQS, Kinesis Data Streams, and DynamoDB Streams batch processing
+* **[Typing](https://docs.powertools.aws.dev/lambda/python/latest/utilities/typing/)** - Static typing classes to speedup development in your IDE
+* **[Validation](https://docs.powertools.aws.dev/lambda/python/latest/utilities/validation/)** - JSON Schema validator for inbound events and responses
+* **[Event source data classes](https://docs.powertools.aws.dev/lambda/python/latest/utilities/data_classes/)** - Data classes describing the schema of common Lambda event triggers
+* **[Parser](https://docs.powertools.aws.dev/lambda/python/latest/utilities/parser/)** - Data parsing and deep validation using Pydantic
+* **[Idempotency](https://docs.powertools.aws.dev/lambda/python/latest/utilities/idempotency/)** - Convert your Lambda functions into idempotent operations which are safe to retry
+* **[Data Masking](https://docs.powertools.aws.dev/lambda/python/latest/utilities/data_masking/)** - Protect confidential data with easy removal or encryption
+* **[Feature Flags](https://docs.powertools.aws.dev/lambda/python/latest/utilities/feature_flags/)** - A simple rule engine to evaluate when one or multiple features should be enabled depending on the input
+* **[Streaming](https://docs.powertools.aws.dev/lambda/python/latest/utilities/streaming/)** - Streams datasets larger than the available memory as streaming data
+* **[Kafka](https://docs.powertools.aws.dev/lambda/python/latest/utilities/kafka/)** - Deserialize and validate Kafka events with support for Avro, Protocol Buffers, and JSON Schema
+* **[JMESPath Functions](https://docs.powertools.aws.dev/lambda/python/latest/utilities/jmespath_functions/)** - Built-in JMESPath functions to easily deserialize common encoded JSON payloads in Lambda functions
### Installation
@@ -34,25 +45,68 @@ With [pip](https://pip.pypa.io/en/latest/index.html) installed, run: ``pip insta
## Tutorial and Examples
-* [Tutorial](https://awslabs.github.io/aws-lambda-powertools-python/latest/tutorial)
+* [Tutorial](https://docs.powertools.aws.dev/lambda/python/latest/tutorial)
* [Serverless Shopping cart](https://github.com/aws-samples/aws-serverless-shopping-cart)
* [Serverless Airline](https://github.com/aws-samples/aws-serverless-airline-booking)
* [Serverless E-commerce platform](https://github.com/aws-samples/aws-serverless-ecommerce-platform)
* [Serverless GraphQL Nanny Booking Api](https://github.com/trey-rosius/babysitter_api)
+## How to support Powertools for AWS Lambda (Python)?
+
+### Becoming a reference customer
+
+Knowing which companies are using this library is important to help prioritize the project internally. If your company is using Powertools for AWS Lambda (Python), you can request to have your name and logo added to the README file by raising a [Support Powertools for AWS Lambda (Python) (become a reference)](https://github.com/aws-powertools/powertools-lambda-python/issues/new?assignees=&labels=customer-reference&template=support_powertools.yml&title=%5BSupport+Lambda+Powertools%5D%3A+%3Cyour+organization+name%3E) issue.
+
+The following companies, among others, use Powertools:
+
+* [Alma Media](https://www.almamedia.fi/en/)
+* [Banxware](https://www.banxware.com/)
+* [Brsk](https://www.brsk.co.uk/)
+* [BusPatrol](https://buspatrol.com/)
+* [Capital One](https://www.capitalone.com/)
+* [Caylent](https://caylent.com/)
+* [CHS Inc.](https://www.chsinc.com/)
+* [CPQi (Exadel Financial Services)](https://cpqi.com/)
+* [CloudZero](https://www.cloudzero.com/)
+* [CyberArk](https://www.cyberark.com/)
+* [EF Education First](https://www.ef.com/)
+* [Flyweight](https://flyweight.io/)
+* [globaldatanet](https://globaldatanet.com/)
+* [Guild](https://guild.com/)
+* [IMS](https://ims.tech/)
+* [Instil](https://instil.co/)
+* [Jit Security](https://www.jit.io/)
+* [LocalStack](https://www.localstack.cloud/)
+* [Propellor.ai](https://www.propellor.ai/)
+* [Pushpay](https://pushpay.com/)
+* [QuasiScience Limited](https://quasiscience.com/)
+* [Recast](https://getrecast.com/)
+* [TopSport](https://www.topsport.com.au/)
+* [Transformity](https://transformity.tech/)
+* [Trek10](https://www.trek10.com/)
+* [Vertex Pharmaceuticals](https://www.vrtx.com/)
+
+### Sharing your work
+
+Share what you did with Powertools for AWS Lambda (Python) 💞💞. Blog post, workshops, presentation, sample apps and others. Check out what the community has already shared about Powertools for AWS Lambda (Python) [in this link](https://docs.powertools.aws.dev/lambda/python/latest/we_made_this/).
+
+### Using Lambda Layer or SAR
+
+This helps us understand who uses Powertools for AWS Lambda (Python) in a non-intrusive way, and helps us gain future investments for other Powertools for AWS Lambda languages. When [using Layers](https://docs.powertools.aws.dev/lambda/python/latest/#lambda-layer), you can add Powertools for AWS Lambda (Python) as a dev dependency (or as part of your virtual env) to not impact the development process.
+
## Credits
* Structured logging initial implementation from [aws-lambda-logging](https://gitlab.com/hadrien/aws_lambda_logging)
-* Powertools idea [DAZN Powertools](https://github.com/getndazn/dazn-lambda-powertools/)
+* Powertools for AWS Lambda (Python) idea [DAZN Powertools](https://github.com/getndazn/dazn-lambda-powertools/)
## Connect
-* **AWS Lambda Powertools on Discord**: `#python` - **[Invite link](https://discord.gg/B8zZKbbyET)**
-* **Email**: aws-lambda-powertools-feedback@amazon.com
+* **Powertools for AWS Lambda on Discord**: `#python` - **[Invite link](https://discord.gg/B8zZKbbyET)**
+* **Email**: <aws-powertools-maintainers@amazon.com>
## Security disclosures
-If you think you’ve found a potential security issue, please do not post it in the Issues. Instead, please follow the instructions [here](https://aws.amazon.com/security/vulnerability-reporting/) or [email AWS security directly](mailto:aws-security@amazon.com).
+If you think you’ve found a potential security issue, please do not post it in the Issues. Instead, please follow the instructions [in this link](https://aws.amazon.com/security/vulnerability-reporting/) or [email AWS security directly](mailto:aws-security@amazon.com).
## License
diff --git a/SECURITY.md b/SECURITY.md
index 9ac1494b13d..885ffb18f2c 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -1,8 +1,7 @@
<!-- markdownlint-disable MD043 -->
-## Reporting a Vulnerability
+## Reporting a vulnerability
-If you discover a potential security issue in this project we ask that you notify AWS/Amazon Security
-via our [vulnerability reporting page](http://aws.amazon.com/security/vulnerability-reporting/) or directly via email to aws-security@amazon.com.
+If you discover a potential security issue in this project, we ask that you notify AWS/Amazon Security via our [vulnerability reporting page](http://aws.amazon.com/security/vulnerability-reporting/) or directly via email to <aws-security@amazon.com>.
Please do **not** create a public GitHub issue.
diff --git a/THIRD-PARTY-LICENSES b/THIRD-PARTY-LICENSES
index 3712eac88cf..f6d647c54a7 100644
--- a/THIRD-PARTY-LICENSES
+++ b/THIRD-PARTY-LICENSES
@@ -1,3 +1,27 @@
+** FastAPI - https://github.com/tiangolo/fastapi/ - Used in the OpenAPI feature
+
+ The MIT License (MIT)
+
+ Copyright (c) 2018 Sebastián Ramírez
+
+ Permission is hereby granted, free of charge, to any person obtaining a copy
+ of this software and associated documentation files (the "Software"), to deal
+ in the Software without restriction, including without limitation the rights
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ copies of the Software, and to permit persons to whom the Software is
+ furnished to do so, subject to the following conditions:
+
+ The above copyright notice and this permission notice shall be included in
+ all copies or substantial portions of the Software.
+
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ THE SOFTWARE.
+
** Tensorflow - https://github.com/tensorflow/tensorflow/
Apache License
diff --git a/aws_lambda_powertools/__init__.py b/aws_lambda_powertools/__init__.py
index 65b5eb86730..dbec3d35635 100644
--- a/aws_lambda_powertools/__init__.py
+++ b/aws_lambda_powertools/__init__.py
@@ -1,13 +1,25 @@
-# -*- coding: utf-8 -*-
-
"""Top-level package for Lambda Python Powertools."""
+from pathlib import Path
-from .logging import Logger # noqa: F401
-from .metrics import Metrics, single_metric # noqa: F401
-from .package_logger import set_package_logger_handler
-from .tracing import Tracer # noqa: F401
+from aws_lambda_powertools.logging import Logger
+from aws_lambda_powertools.metrics import Metrics, single_metric
+from aws_lambda_powertools.package_logger import set_package_logger_handler
+from aws_lambda_powertools.shared.user_agent import inject_user_agent
+from aws_lambda_powertools.shared.version import VERSION
+from aws_lambda_powertools.tracing import Tracer
+__version__ = VERSION
__author__ = """Amazon Web Services"""
+__all__ = [
+ "Logger",
+ "Metrics",
+ "single_metric",
+ "Tracer",
+]
+
+PACKAGE_PATH = Path(__file__).parent
set_package_logger_handler()
+
+inject_user_agent()
diff --git a/aws_lambda_powertools/event_handler/__init__.py b/aws_lambda_powertools/event_handler/__init__.py
index 75d03d771e0..98433b2e29b 100644
--- a/aws_lambda_powertools/event_handler/__init__.py
+++ b/aws_lambda_powertools/event_handler/__init__.py
@@ -2,7 +2,7 @@
Event handler decorators for common Lambda events
"""
-from .api_gateway import (
+from aws_lambda_powertools.event_handler.api_gateway import (
ALBResolver,
APIGatewayHttpResolver,
ApiGatewayResolver,
@@ -10,16 +10,39 @@
CORSConfig,
Response,
)
-from .appsync import AppSyncResolver
-from .lambda_function_url import LambdaFunctionUrlResolver
+from aws_lambda_powertools.event_handler.appsync import AppSyncResolver
+from aws_lambda_powertools.event_handler.bedrock_agent import BedrockAgentResolver, BedrockResponse
+from aws_lambda_powertools.event_handler.bedrock_agent_function import (
+ BedrockAgentFunctionResolver,
+ BedrockFunctionResponse,
+)
+from aws_lambda_powertools.event_handler.depends import DependencyResolutionError, Depends
+from aws_lambda_powertools.event_handler.events_appsync.appsync_events import AppSyncEventsResolver
+from aws_lambda_powertools.event_handler.http_resolver import HttpResolverLocal
+from aws_lambda_powertools.event_handler.lambda_function_url import (
+ LambdaFunctionUrlResolver,
+)
+from aws_lambda_powertools.event_handler.request import Request
+from aws_lambda_powertools.event_handler.vpc_lattice import VPCLatticeResolver, VPCLatticeV2Resolver
__all__ = [
"AppSyncResolver",
+ "AppSyncEventsResolver",
"APIGatewayRestResolver",
"APIGatewayHttpResolver",
"ALBResolver",
"ApiGatewayResolver",
+ "BedrockAgentResolver",
+ "BedrockAgentFunctionResolver",
+ "BedrockResponse",
+ "BedrockFunctionResponse",
"CORSConfig",
+ "Depends",
+ "DependencyResolutionError",
+ "HttpResolverLocal",
"LambdaFunctionUrlResolver",
+ "Request",
"Response",
+ "VPCLatticeResolver",
+ "VPCLatticeV2Resolver",
]
diff --git a/aws_lambda_powertools/event_handler/api_gateway.py b/aws_lambda_powertools/event_handler/api_gateway.py
index ae02a659359..a323cf67d56 100644
--- a/aws_lambda_powertools/event_handler/api_gateway.py
+++ b/aws_lambda_powertools/event_handler/api_gateway.py
@@ -1,7 +1,8 @@
+from __future__ import annotations
+
import base64
import json
import logging
-import os
import re
import traceback
import warnings
@@ -10,29 +11,95 @@
from enum import Enum
from functools import partial
from http import HTTPStatus
-from typing import Any, Callable, Dict, List, Match, Optional, Pattern, Set, Tuple, Type, Union
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Generic, Literal, Match, Pattern, TypeVar, cast
+
+from typing_extensions import override
from aws_lambda_powertools.event_handler import content_types
+from aws_lambda_powertools.event_handler.exception_handling import ExceptionHandlerManager
from aws_lambda_powertools.event_handler.exceptions import NotFoundError, ServiceError
-from aws_lambda_powertools.shared import constants
-from aws_lambda_powertools.shared.functions import resolve_truthy_env_var_choice
+from aws_lambda_powertools.event_handler.openapi.config import OpenAPIConfig
+from aws_lambda_powertools.event_handler.openapi.constants import (
+ DEFAULT_API_VERSION,
+ DEFAULT_CONTENT_TYPE,
+ DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ DEFAULT_OPENAPI_TITLE,
+ DEFAULT_OPENAPI_VERSION,
+ DEFAULT_STATUS_CODE,
+)
+from aws_lambda_powertools.event_handler.openapi.exceptions import (
+ RequestUnsupportedContentType,
+ RequestValidationError,
+ ResponseValidationError,
+ SchemaValidationError,
+)
+from aws_lambda_powertools.event_handler.openapi.types import (
+ COMPONENT_REF_PREFIX,
+ OpenAPIResponse,
+ response_validation_error_response_definition,
+)
+from aws_lambda_powertools.event_handler.request import Request
+from aws_lambda_powertools.event_handler.util import (
+ _FrozenDict,
+ _FrozenListDict,
+ _validate_openapi_security_parameters,
+ extract_origin_header,
+)
+from aws_lambda_powertools.shared.cookies import Cookie
+from aws_lambda_powertools.shared.functions import powertools_dev_is_set
from aws_lambda_powertools.shared.json_encoder import Encoder
from aws_lambda_powertools.utilities.data_classes import (
ALBEvent,
APIGatewayProxyEvent,
APIGatewayProxyEventV2,
+ BedrockAgentEvent,
LambdaFunctionUrlEvent,
+ VPCLatticeEvent,
+ VPCLatticeEventV2,
)
from aws_lambda_powertools.utilities.data_classes.common import BaseProxyEvent
-from aws_lambda_powertools.utilities.typing import LambdaContext
+
+if TYPE_CHECKING:
+ from collections.abc import Callable, Mapping, Sequence
logger = logging.getLogger(__name__)
_DYNAMIC_ROUTE_PATTERN = r"(<\w+>)"
-_SAFE_URI = "-._~()'!*:@,;" # https://www.ietf.org/rfc/rfc3986.txt
+_SAFE_URI = "-._~()'!*:@,;=+&$" # https://www.ietf.org/rfc/rfc3986.txt
# API GW/ALB decode non-safe URI chars; we must support them too
-_UNSAFE_URI = "%<> \[\]{}|^" # noqa: W605
+_UNSAFE_URI = r"%<> \[\]{}|^"
_NAMED_GROUP_BOUNDARY_PATTERN = rf"(?P\1[{_SAFE_URI}{_UNSAFE_URI}\\w]+)"
+_ROUTE_REGEX = "^{}$"
+_JSON_DUMP_CALL = partial(json.dumps, separators=(",", ":"), cls=Encoder)
+
+ResponseEventT = TypeVar("ResponseEventT", bound=BaseProxyEvent)
+ResponseT = TypeVar("ResponseT")
+
+if TYPE_CHECKING:
+ from aws_lambda_powertools.event_handler.openapi.compat import (
+ JsonSchemaValue,
+ ModelField,
+ )
+ from aws_lambda_powertools.event_handler.openapi.models import (
+ Contact,
+ ExternalDocumentation,
+ License,
+ OpenAPI,
+ SecurityScheme,
+ Server,
+ Tag,
+ )
+ from aws_lambda_powertools.event_handler.openapi.params import Dependant
+ from aws_lambda_powertools.event_handler.openapi.swagger_ui.oauth2 import (
+ OAuth2Config,
+ )
+ from aws_lambda_powertools.event_handler.openapi.types import (
+ TypeModelOrEnum,
+ )
+ from aws_lambda_powertools.shared.cookies import Cookie
+ from aws_lambda_powertools.shared.types import AnyCallableT
+ from aws_lambda_powertools.utilities.typing import LambdaContext
class ProxyEventType(Enum):
@@ -41,29 +108,45 @@ class ProxyEventType(Enum):
APIGatewayProxyEvent = "APIGatewayProxyEvent"
APIGatewayProxyEventV2 = "APIGatewayProxyEventV2"
ALBEvent = "ALBEvent"
+ BedrockAgentEvent = "BedrockAgentEvent"
+ VPCLatticeEvent = "VPCLatticeEvent"
+ VPCLatticeEventV2 = "VPCLatticeEventV2"
LambdaFunctionUrlEvent = "LambdaFunctionUrlEvent"
+_PROXY_EVENT_MAP: dict[Enum, tuple[type[BaseProxyEvent], str]] = {
+ ProxyEventType.APIGatewayProxyEvent: (APIGatewayProxyEvent, "API Gateway REST API"),
+ ProxyEventType.APIGatewayProxyEventV2: (APIGatewayProxyEventV2, "API Gateway HTTP API"),
+ ProxyEventType.BedrockAgentEvent: (BedrockAgentEvent, "Bedrock Agent"),
+ ProxyEventType.LambdaFunctionUrlEvent: (LambdaFunctionUrlEvent, "Lambda Function URL"),
+ ProxyEventType.VPCLatticeEvent: (VPCLatticeEvent, "VPC Lattice"),
+ ProxyEventType.VPCLatticeEventV2: (VPCLatticeEventV2, "VPC LatticeV2"),
+ ProxyEventType.ALBEvent: (ALBEvent, "ALB"),
+}
+
+
class CORSConfig:
"""CORS Config
Examples
--------
- Simple cors example using the default permissive cors, not this should only be used during early prototyping
+ Simple CORS example using the default permissive CORS, note that this should only be used during early prototyping.
```python
- from aws_lambda_powertools.event_handler import APIGatewayRestResolver
+ from aws_lambda_powertools.event_handler.api_gateway import (
+ APIGatewayRestResolver, CORSConfig
+ )
- app = APIGatewayRestResolver()
+ app = APIGatewayRestResolver(cors=CORSConfig())
- @app.get("/my/path", cors=True)
+ @app.get("/my/path")
def with_cors():
return {"message": "Foo"}
```
Using a custom CORSConfig where `with_cors` used the custom provided CORSConfig and `without_cors`
- do not include any cors headers.
+ do not include any CORS headers.
```python
from aws_lambda_powertools.event_handler.api_gateway import (
@@ -72,6 +155,7 @@ def with_cors():
cors_config = CORSConfig(
allow_origin="https://wwww.example.com/",
+ extra_origins=["https://dev.example.com/"],
expose_headers=["x-exposed-response-header"],
allow_headers=["x-custom-request-header"],
max_age=100,
@@ -94,9 +178,10 @@ def without_cors():
def __init__(
self,
allow_origin: str = "*",
- allow_headers: Optional[List[str]] = None,
- expose_headers: Optional[List[str]] = None,
- max_age: Optional[int] = None,
+ extra_origins: list[str] | None = None,
+ allow_headers: list[str] | None = None,
+ expose_headers: list[str] | None = None,
+ max_age: int | None = None,
allow_credentials: bool = False,
):
"""
@@ -105,47 +190,143 @@ def __init__(
allow_origin: str
The value of the `Access-Control-Allow-Origin` to send in the response. Defaults to "*", but should
only be used during development.
- allow_headers: Optional[List[str]]
+ extra_origins: list[str] | None
+ The list of additional allowed origins.
+ allow_headers: list[str] | None
The list of additional allowed headers. This list is added to list of
built-in allowed headers: `Authorization`, `Content-Type`, `X-Amz-Date`,
`X-Api-Key`, `X-Amz-Security-Token`.
- expose_headers: Optional[List[str]]
+ expose_headers: list[str] | None
A list of values to return for the Access-Control-Expose-Headers
- max_age: Optional[int]
+ max_age: int | None
The value for the `Access-Control-Max-Age`
allow_credentials: bool
A boolean value that sets the value of `Access-Control-Allow-Credentials`
"""
- self.allow_origin = allow_origin
+
+ self._allowed_origins = [allow_origin]
+
+ if extra_origins:
+ self._allowed_origins.extend(extra_origins)
+
self.allow_headers = set(self._REQUIRED_HEADERS + (allow_headers or []))
self.expose_headers = expose_headers or []
self.max_age = max_age
self.allow_credentials = allow_credentials
- def to_dict(self) -> Dict[str, str]:
+ def to_dict(self, origin: str | None) -> dict[str, str]:
"""Builds the configured Access-Control http headers"""
+
+ # If there's no Origin, don't add any CORS headers
+ if not origin:
+ return {}
+
+ # If the origin doesn't match any of the allowed origins, and we don't allow all origins ("*"),
+ # don't add any CORS headers
+ if origin not in self._allowed_origins and "*" not in self._allowed_origins:
+ return {}
+
+ # The origin matched an allowed origin, so return the CORS headers
headers = {
- "Access-Control-Allow-Origin": self.allow_origin,
- "Access-Control-Allow-Headers": ",".join(sorted(self.allow_headers)),
+ "Access-Control-Allow-Origin": origin,
+ "Access-Control-Allow-Headers": CORSConfig.build_allow_methods(self.allow_headers),
}
+
if self.expose_headers:
headers["Access-Control-Expose-Headers"] = ",".join(self.expose_headers)
if self.max_age is not None:
headers["Access-Control-Max-Age"] = str(self.max_age)
- if self.allow_credentials is True:
+ if origin != "*" and self.allow_credentials is True:
headers["Access-Control-Allow-Credentials"] = "true"
return headers
+ def allowed_origin(self, extracted_origin: str) -> str | None:
+ if extracted_origin in self._allowed_origins:
+ return extracted_origin
+ if extracted_origin is not None and "*" in self._allowed_origins:
+ return "*"
+
+ return None
+
+ @staticmethod
+ def build_allow_methods(methods: set[str]) -> str:
+ """Build sorted comma delimited methods for Access-Control-Allow-Methods header
+
+ Parameters
+ ----------
+ methods : set[str]
+ Set of HTTP Methods
+
+ Returns
+ -------
+ set[str]
+ Formatted string with all HTTP Methods allowed for CORS e.g., `GET, OPTIONS`
+
+ """
+ return ",".join(sorted(methods))
+
+
+class BedrockResponse(Generic[ResponseT]):
+ """
+ Contains the response body, status code, content type, and optional attributes
+ for session management and knowledge base configuration.
+
+ Note
+ ----
+ Amazon Bedrock Agents only support TEXT content type in the responseBody according to the
+ Lambda integration documentation. As a result, all response bodies are automatically serialized
+ as JSON strings regardless of the content_type parameter. The content_type parameter is maintained
+ for API consistency but does not affect the actual format sent to Bedrock Agents.
+
+ See: https://docs.aws.amazon.com/bedrock/latest/userguide/agents-lambda.html
+ """
+
+ def __init__(
+ self,
+ body: Any = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ content_type: str = DEFAULT_CONTENT_TYPE,
+ session_attributes: dict[str, Any] | None = None,
+ prompt_session_attributes: dict[str, Any] | None = None,
+ knowledge_bases_configuration: list[dict[str, Any]] | None = None,
+ ) -> None:
+ self.body = body
+ self.status_code = status_code
+ self.content_type = content_type
+ self.session_attributes = session_attributes
+ self.prompt_session_attributes = prompt_session_attributes
+ self.knowledge_bases_configuration = knowledge_bases_configuration
+
+ def is_json(self) -> bool:
+ """
+ Returns True if the response is JSON, based on the Content-Type.
+
+ Note
+ ----
+ This method always returns True for BedrockResponse regardless of the content_type parameter.
+ This is because Amazon Bedrock Agents only support TEXT content type in the responseBody,
+ and the event handler automatically serializes all response bodies as JSON strings when
+ sending to Bedrock Agents.
+
+ See: https://docs.aws.amazon.com/bedrock/latest/userguide/agents-lambda.html
+
+ The content_type parameter in BedrockResponse is maintained for API consistency but does not
+ affect the actual response format sent to Bedrock Agents.
+ """
+ return True
+
-class Response:
+class Response(Generic[ResponseT]):
"""Response data class that provides greater control over what is returned from the proxy event"""
def __init__(
self,
status_code: int,
- content_type: Optional[str],
- body: Union[str, bytes, None],
- headers: Optional[Dict] = None,
+ content_type: str | None = None,
+ body: ResponseT | None = None,
+ headers: Mapping[str, str | list[str]] | None = None,
+ cookies: list[Cookie] | None = None,
+ compress: bool | None = None,
):
"""
@@ -156,47 +337,476 @@ def __init__(
content_type: str
Optionally set the Content-Type header, example "application/json". Note this will be merged into any
provided http headers
- body: Union[str, bytes, None]
+ body: str | bytes | None
Optionally set the response body. Note: bytes body will be automatically base64 encoded
- headers: dict
- Optionally set specific http headers. Setting "Content-Type" hear would override the `content_type` value.
+ headers: Mapping[str, str | list[str]]
+ Optionally set specific http headers. Setting "Content-Type" here would override the `content_type` value.
+ cookies: list[Cookie]
+ Optionally set cookies.
"""
self.status_code = status_code
self.body = body
self.base64_encoded = False
- self.headers: Dict = headers or {}
+ self.headers: dict[str, str | list[str]] = dict(headers) if headers else {}
+ self.cookies = cookies or []
+ self.compress = compress
+ self.content_type = content_type
if content_type:
self.headers.setdefault("Content-Type", content_type)
+ def is_json(self) -> bool:
+ """
+ Returns True if the response is JSON, based on the Content-Type.
+ """
+ content_type = self.headers.get("Content-Type", "")
+ if isinstance(content_type, list):
+ content_type = content_type[0]
+ return content_type.startswith(DEFAULT_CONTENT_TYPE)
+
class Route:
"""Internally used Route Configuration"""
def __init__(
- self, method: str, rule: Pattern, func: Callable, cors: bool, compress: bool, cache_control: Optional[str]
+ self,
+ method: str,
+ path: str,
+ rule: Pattern,
+ func: Callable,
+ cors: bool,
+ compress: bool,
+ cache_control: str | None = None,
+ summary: str | None = None,
+ description: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+ response_description: str | None = None,
+ tags: list[str] | None = None,
+ operation_id: str | None = None,
+ include_in_schema: bool = True,
+ security: list[dict[str, list[str]]] | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ deprecated: bool = False,
+ enable_validation: bool | None = None,
+ custom_response_validation_http_code: HTTPStatus | None = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ middlewares: list[Callable[..., Response]] | None = None,
):
+ """
+ Internally used Route Configuration
+
+ Parameters
+ ----------
+ method: str
+ The HTTP method, example "GET"
+ path: str
+ The path of the route
+ rule: Pattern
+ The route rule, example "/my/path"
+ func: Callable
+ The route handler function
+ cors: bool
+ Whether or not to enable CORS for this route
+ compress: bool
+ Whether or not to enable gzip compression for this route
+ cache_control: str | None
+ The cache control header value, example "max-age=3600"
+ summary: str | None
+ The OpenAPI summary for this route
+ description: str | None
+ The OpenAPI description for this route
+ responses: dict[int, OpenAPIResponse] | None
+ The OpenAPI responses for this route
+ response_description: str | None
+ The OpenAPI response description for this route
+ tags: list[str] | None
+ The list of OpenAPI tags to be used for this route
+ operation_id: str | None
+ The OpenAPI operationId for this route
+ include_in_schema: bool
+ Whether or not to include this route in the OpenAPI schema
+ security: list[dict[str, list[str]]], optional
+ The OpenAPI security for this route
+ openapi_extensions: dict[str, Any], optional
+ Additional OpenAPI extensions as a dictionary.
+ deprecated: bool
+ Whether or not to mark this route as deprecated in the OpenAPI schema
+ enable_validation: bool | None, optional
+ Enable or disable validation for this specific route. If None, inherits from resolver setting.
+ custom_response_validation_http_code: int | HTTPStatus | None, optional
+ Whether to have custom http status code for this route if response validation fails
+ status_code: int
+ The default HTTP status code for successful responses. Used in both the OpenAPI schema
+ and the actual response when the handler returns a dict. Defaults to 200.
+ middlewares: list[Callable[..., Response]] | None
+ The list of route middlewares to be called in order.
+ """
self.method = method.upper()
+ self.path = path if path.strip() else "/"
+
+ # OpenAPI spec only understands paths with { }. So we'll have to convert Powertools' < >.
+ # https://swagger.io/specification/#path-templating
+ self.openapi_path = re.sub(r"<(.*?)>", lambda m: f"{{{''.join(m.group(1))}}}", self.path) # type: ignore[arg-type]
+
self.rule = rule
self.func = func
+ self._middleware_stack = func
self.cors = cors
self.compress = compress
self.cache_control = cache_control
+ self.summary = summary
+ self.description = description
+ self.responses = responses
+ self.response_description = response_description
+ self.tags = tags or []
+ self.include_in_schema = include_in_schema
+ self.security = security
+ self.openapi_extensions = openapi_extensions
+ self.middlewares = middlewares or []
+ self.operation_id = operation_id or self._generate_operation_id()
+ self.deprecated = deprecated
+ self.enable_validation = enable_validation
+
+ # _middleware_stack_built is used to ensure the middleware stack is only built once.
+ self._middleware_stack_built = False
+
+ # _dependant is used to cache the dependant model for the handler function
+ self._dependant: Dependant | None = None
+
+ # _body_field is used to cache the dependant model for the body field
+ self._body_field: ModelField | None = None
+
+ self.custom_response_validation_http_code = custom_response_validation_http_code
+ self.status_code = status_code
+
+ # Cache whether this route's handler declares Depends() parameters
+ self._has_dependencies: bool | None = None
+
+ # Caches the name of any Request-typed parameter in the handler.
+ # Avoids re-scanning the signature on every invocation.
+ self.request_param_name: str | None = None
+ self.request_param_name_checked: bool = False
+
+ def __call__(
+ self,
+ router_middlewares: list[Callable],
+ app: ApiGatewayResolver,
+ route_arguments: dict[str, str],
+ ) -> dict | tuple | Response:
+ """Calling the Router class instance will trigger the following actions:
+ 1. If Route Middleware stack has not been built, build it
+ 2. Call the Route Middleware stack wrapping the original function
+ handler with the app and route arguments.
+
+ Parameters
+ ----------
+ router_middlewares: list[Callable]
+ The list of Router Middlewares (assigned to ALL routes)
+ app: "ApiGatewayResolver"
+ The ApiGatewayResolver instance to pass into the middleware stack
+ route_arguments: dict[str, str]
+ The route arguments to pass to the app function (extracted from the Api Gateway
+ Lambda Message structure from AWS)
+
+ Returns
+ -------
+ dict | tuple | Response
+ API Response object in ALL cases, except when the original API route
+ handler is called which may also return a dict, tuple, or Response.
+ """
+
+ # Save CPU cycles by building middleware stack once
+ if not self._middleware_stack_built:
+ self._build_middleware_stack(router_middlewares=router_middlewares, app=app)
+
+ # If debug is turned on then output the middleware stack to the console
+ if app._debug:
+ print(f"\nProcessing Route:::{self.func.__name__} ({app.context['_path']})")
+ # Collect ALL middleware for debug printing - include internal _registered_api_adapter
+ all_middlewares = router_middlewares + self.middlewares + [_registered_api_adapter]
+ print("\nMiddleware Stack:")
+ print("=================")
+ print("\n".join(getattr(item, "__name__", "Unknown") for item in all_middlewares))
+ print("=================")
+
+ # Add Route Arguments to app context
+ app.append_context(_route_args=route_arguments)
+
+ # Call the Middleware Wrapped _call_stack function handler with the app
+ return self._middleware_stack(app)
+
+ def _build_middleware_stack(self, router_middlewares: list[Callable[..., Any]], app) -> None:
+ """
+ Builds the middleware stack for the handler by wrapping each
+ handler in an instance of MiddlewareWrapper which is used to contain the state
+ of each middleware step.
+
+ Middleware is represented by a standard Python Callable construct. Any Middleware
+ handler wanting to short-circuit the middlware call chain can raise an exception
+ to force the Python call stack created by the handler call-chain to naturally un-wind.
+
+ This becomes a simple concept for developers to understand and reason with - no additional
+ gymnastics other than plain old try ... except.
+
+ Notes
+ -----
+ The Route Middleware stack is processed in reverse order. This is so the stack of
+ middleware handlers is applied in the order of being added to the handler.
+ """
+ # Build middleware stack in the correct order for validation:
+ # 1. Request validation middleware (first)
+ # 2. Router middlewares + user middlewares (middle)
+ # 3. Response validation middleware (before route handler)
+ # 4. Route handler adapter (last)
+
+ all_middlewares = []
+
+ # Determine if validation should be enabled for this route
+ # If route has explicit enable_validation setting, use it; otherwise, use resolver's global setting
+ route_validation_enabled = (
+ self.enable_validation if self.enable_validation is not None else app._enable_validation
+ )
+
+ # If route needs validation but resolver didn't create the middlewares, create them now
+ if route_validation_enabled and not hasattr(app, "_request_validation_middleware"):
+ from aws_lambda_powertools.event_handler.middlewares.openapi_validation import (
+ OpenAPIRequestValidationMiddleware,
+ OpenAPIResponseValidationMiddleware,
+ )
+
+ app._request_validation_middleware = OpenAPIRequestValidationMiddleware()
+ app._response_validation_middleware = OpenAPIResponseValidationMiddleware(
+ validation_serializer=app._serializer,
+ has_response_validation_error=app._has_response_validation_error,
+ )
+
+ # Add request validation middleware first if validation is enabled
+ if route_validation_enabled and hasattr(app, "_request_validation_middleware"):
+ all_middlewares.append(app._request_validation_middleware)
+
+ # Add user middlewares in the middle
+ all_middlewares.extend(router_middlewares + self.middlewares)
+
+ # Add response validation middleware before the route handler if validation is enabled
+ if route_validation_enabled and hasattr(app, "_response_validation_middleware"):
+ all_middlewares.append(app._response_validation_middleware)
+
+ logger.debug(f"Building middleware stack: {all_middlewares}")
+
+ # IMPORTANT:
+ # this must be the last middleware in the stack (tech debt for backward
+ # compatibility purposes)
+ #
+ # This adapter will:
+ # 1. Call the registered API passing only the expected route arguments extracted from the path
+ # and not the middleware.
+ # 2. Adapt the response type of the route handler (dict | tuple | Response)
+ # and normalise into a Response object so middleware will always have a constant signature
+ all_middlewares.append(_registered_api_adapter)
+
+ # Wrap the original route handler function in the middleware handlers
+ # using the MiddlewareWrapper class callable construct in reverse order to
+ # ensure middleware is applied in the order the user defined.
+ #
+ # Start with the route function and wrap from last to the first Middleware handler.
+ for handler in reversed(all_middlewares):
+ self._middleware_stack = MiddlewareFrame(current_middleware=handler, next_middleware=self._middleware_stack)
+
+ self._middleware_stack_built = True
+
+ async def call_async(
+ self,
+ router_middlewares: list[Callable],
+ app: ApiGatewayResolver,
+ route_arguments: dict[str, str],
+ ) -> dict | tuple | Response:
+ from aws_lambda_powertools.event_handler.middlewares.async_utils import (
+ AsyncMiddlewareFrame,
+ _registered_api_adapter_async,
+ )
+
+ all_middlewares: list[Callable[..., Any]] = []
+
+ route_validation_enabled = (
+ self.enable_validation if self.enable_validation is not None else app._enable_validation
+ )
+
+ if route_validation_enabled and not hasattr(app, "_request_validation_middleware"):
+ from aws_lambda_powertools.event_handler.middlewares.openapi_validation import (
+ OpenAPIRequestValidationMiddleware,
+ OpenAPIResponseValidationMiddleware,
+ )
+
+ app._request_validation_middleware = OpenAPIRequestValidationMiddleware()
+ app._response_validation_middleware = OpenAPIResponseValidationMiddleware(
+ validation_serializer=app._serializer,
+ has_response_validation_error=app._has_response_validation_error,
+ )
+
+ if route_validation_enabled and hasattr(app, "_request_validation_middleware"):
+ all_middlewares.append(app._request_validation_middleware)
+
+ all_middlewares.extend(router_middlewares + self.middlewares)
+
+ if route_validation_enabled and hasattr(app, "_response_validation_middleware"):
+ all_middlewares.append(app._response_validation_middleware)
+
+ all_middlewares.append(_registered_api_adapter_async)
+
+ logger.debug(f"Building async middleware stack: {all_middlewares}")
+
+ if app._debug:
+ print(f"\nProcessing Route (async):::{self.func.__name__} ({app.context['_path']})")
+ print("\nAsync Middleware Stack:")
+ print("=================")
+ print("\n".join(getattr(item, "__name__", "Unknown") for item in all_middlewares))
+ print("=================")
+
+ app.append_context(_route_args=route_arguments)
+
+ # Build async chain from inside-out (not cached, avoids state conflicts with sync cache)
+ next_handler: Callable = self.func
+ for handler in reversed(all_middlewares):
+ next_handler = AsyncMiddlewareFrame(current_middleware=handler, next_middleware=next_handler)
+
+ return await next_handler(app)
+
+ @property
+ def dependant(self) -> Dependant:
+ if self._dependant is None:
+ from aws_lambda_powertools.event_handler.openapi.dependant import get_dependant
+
+ self._dependant = get_dependant(path=self.openapi_path, call=self.func, responses=self.responses)
+
+ return self._dependant
+
+ @property
+ def has_dependencies(self) -> bool:
+ """Check if handler declares Depends() parameters without triggering full dependant computation."""
+ if self._has_dependencies is None:
+ from aws_lambda_powertools.event_handler.depends import _has_depends
+
+ self._has_dependencies = _has_depends(self.func)
+ return self._has_dependencies
+
+ @property
+ def body_field(self) -> ModelField | None:
+ if self._body_field is None:
+ from aws_lambda_powertools.event_handler.openapi.dependant import get_body_field
+
+ self._body_field = get_body_field(dependant=self.dependant, name=self.operation_id)
+
+ return self._body_field
+
+ def _get_openapi_path(
+ self,
+ *,
+ dependant: Dependant,
+ operation_ids: set[str],
+ model_name_map: dict[TypeModelOrEnum, str],
+ field_mapping: dict[tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue],
+ enable_validation: bool = False,
+ ) -> tuple[dict[str, Any], dict[str, Any]]:
+ """
+ Returns the OpenAPI path and definitions for the route.
+
+ Delegates to openapi.schema_generator for the actual generation logic.
+ """
+ from aws_lambda_powertools.event_handler.openapi.schema_generator import generate_openapi_path
+
+ return generate_openapi_path(
+ method=self.method,
+ operation_id=self.operation_id,
+ summary=self.summary,
+ description=self.description,
+ openapi_path=self.openapi_path,
+ tags=self.tags,
+ deprecated=self.deprecated,
+ security=self.security,
+ openapi_extensions=self.openapi_extensions,
+ responses=self.responses,
+ response_description=self.response_description,
+ body_field=self.body_field,
+ custom_response_validation_http_code=self.custom_response_validation_http_code,
+ status_code=self.status_code,
+ dependant=dependant,
+ operation_ids=operation_ids,
+ model_name_map=model_name_map,
+ field_mapping=field_mapping,
+ enable_validation=enable_validation,
+ )
+ def _generate_operation_id(self) -> str:
+ operation_id = self.func.__name__ + self.openapi_path
+ operation_id = re.sub(r"\W", "_", operation_id)
+ operation_id = operation_id + "_" + self.method.lower()
+ return operation_id
-class ResponseBuilder:
+
+class ResponseBuilder(Generic[ResponseEventT]):
"""Internally used Response builder"""
- def __init__(self, response: Response, route: Optional[Route] = None):
+ def __init__(
+ self,
+ response: Response,
+ serializer: Callable[[Any], str] = _JSON_DUMP_CALL,
+ route: Route | None = None,
+ ):
self.response = response
+ self.serializer = serializer
self.route = route
- def _add_cors(self, cors: CORSConfig):
+ def _add_cors(self, event: ResponseEventT, cors: CORSConfig):
"""Update headers to include the configured Access-Control headers"""
- self.response.headers.update(cors.to_dict())
+ extracted_origin_header = extract_origin_header(event.resolved_headers_field)
+
+ origin = cors.allowed_origin(extracted_origin_header)
+ if origin is not None:
+ self.response.headers.update(cors.to_dict(origin))
def _add_cache_control(self, cache_control: str):
"""Set the specified cache control headers for 200 http responses. For non-200 `no-cache` is used."""
- self.response.headers["Cache-Control"] = cache_control if self.response.status_code == 200 else "no-cache"
+ cache_control = cache_control if self.response.status_code == 200 else "no-cache"
+ self.response.headers["Cache-Control"] = cache_control
+
+ @staticmethod
+ def _has_compression_enabled(
+ route_compression: bool,
+ response_compression: bool | None,
+ event: ResponseEventT,
+ ) -> bool:
+ """
+ Checks if compression is enabled.
+
+ NOTE: Response compression takes precedence.
+
+ Parameters
+ ----------
+ route_compression: bool, optional
+ A boolean indicating whether compression is enabled or not in the route setting.
+ response_compression: bool, optional
+ A boolean indicating whether compression is enabled or not in the response setting.
+ event: ResponseEventT
+ The event object containing the request details.
+
+ Returns
+ -------
+ bool
+ True if compression is enabled and the "gzip" encoding is accepted, False otherwise.
+ """
+ encoding = event.resolved_headers_field.get("accept-encoding", "")
+ gzip_accepted = False
+ if isinstance(encoding, str):
+ gzip_accepted = "gzip" in encoding
+ elif isinstance(encoding, list):
+ gzip_accepted = "gzip" in ",".join(encoding)
+
+ if gzip_accepted:
+ if response_compression is not None:
+ return response_compression # e.g., Response(compress=False/True))
+ if route_compression:
+ return True # e.g., @app.get(compress=True)
+
+ return False
def _compress(self):
"""Compress the response body, but only if `Accept-Encoding` headers includes gzip."""
@@ -207,49 +817,140 @@ def _compress(self):
gzip = zlib.compressobj(9, zlib.DEFLATED, zlib.MAX_WBITS | 16)
self.response.body = gzip.compress(self.response.body) + gzip.flush()
- def _route(self, event: BaseProxyEvent, cors: Optional[CORSConfig]):
+ def _route(self, event: ResponseEventT, cors: CORSConfig | None):
"""Optionally handle any of the route's configure response handling"""
if self.route is None:
return
if self.route.cors:
- self._add_cors(cors or CORSConfig())
+ self._add_cors(event, cors or CORSConfig())
if self.route.cache_control:
self._add_cache_control(self.route.cache_control)
- if self.route.compress and "gzip" in (event.get_header_value("accept-encoding", "") or ""):
+ if self._has_compression_enabled(
+ route_compression=self.route.compress,
+ response_compression=self.response.compress,
+ event=event,
+ ):
self._compress()
- def build(self, event: BaseProxyEvent, cors: Optional[CORSConfig] = None) -> Dict[str, Any]:
+ def build(self, event: ResponseEventT, cors: CORSConfig | None = None) -> dict[str, Any]:
"""Build the full response dict to be returned by the lambda"""
+
+ # We only apply the serializer when the content type is JSON and the
+ # body is not a str, to avoid double encoding
+ if self.response.is_json() and not isinstance(self.response.body, str):
+ self.response.body = self.serializer(self.response.body)
+
self._route(event, cors)
if isinstance(self.response.body, bytes):
logger.debug("Encoding bytes response with base64")
self.response.base64_encoded = True
self.response.body = base64.b64encode(self.response.body).decode()
+
return {
"statusCode": self.response.status_code,
- "headers": self.response.headers,
"body": self.response.body,
"isBase64Encoded": self.response.base64_encoded,
+ **event.header_serializer().serialize(headers=self.response.headers, cookies=self.response.cookies),
}
class BaseRouter(ABC):
+ """Base class for Routing"""
+
current_event: BaseProxyEvent
lambda_context: LambdaContext
+ context: dict
+ _router_middlewares: list[Callable] = []
+ processed_stack_frames: list[str] = []
@abstractmethod
def route(
self,
rule: str,
method: Any,
- cors: Optional[bool] = None,
+ cors: bool | None = None,
compress: bool = False,
- cache_control: Optional[str] = None,
- ):
+ cache_control: str | None = None,
+ summary: str | None = None,
+ description: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+ response_description: str = DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ tags: list[str] | None = None,
+ operation_id: str | None = None,
+ include_in_schema: bool = True,
+ security: list[dict[str, list[str]]] | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ deprecated: bool = False,
+ enable_validation: bool | None = None,
+ custom_response_validation_http_code: int | HTTPStatus | None = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ middlewares: list[Callable[..., Any]] | None = None,
+ ) -> Callable[[AnyCallableT], AnyCallableT]:
raise NotImplementedError()
- def get(self, rule: str, cors: Optional[bool] = None, compress: bool = False, cache_control: Optional[str] = None):
+ def use(self, middlewares: list[Callable[..., Response]]) -> None:
+ """
+ Add one or more global middlewares that run before/after route specific middleware.
+
+ NOTE: Middlewares are called in insertion order.
+
+ Parameters
+ ----------
+ middlewares: list[Callable[..., Response]]
+ List of global middlewares to be used
+
+ Examples
+ --------
+
+ Add middlewares to be used for every request processed by the Router.
+
+ ```python
+ from aws_lambda_powertools import Logger
+ from aws_lambda_powertools.event_handler import APIGatewayRestResolver, Response
+ from aws_lambda_powertools.event_handler.middlewares import NextMiddleware
+
+ logger = Logger()
+ app = APIGatewayRestResolver()
+
+ def log_request_response(app: APIGatewayRestResolver, next_middleware: NextMiddleware) -> Response:
+ logger.info("Incoming request", path=app.current_event.path, request=app.current_event.raw_event)
+
+ result = next_middleware(app)
+ logger.info("Response received", response=result.__dict__)
+
+ return result
+
+ app.use(middlewares=[log_request_response])
+
+
+ def lambda_handler(event, context):
+ return app.resolve(event, context)
+ ```
+ """
+ self._router_middlewares = self._router_middlewares + middlewares
+
+ def get(
+ self,
+ rule: str,
+ cors: bool | None = None,
+ compress: bool = False,
+ cache_control: str | None = None,
+ summary: str | None = None,
+ description: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+ response_description: str = DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ tags: list[str] | None = None,
+ operation_id: str | None = None,
+ include_in_schema: bool = True,
+ security: list[dict[str, list[str]]] | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ deprecated: bool = False,
+ enable_validation: bool | None = None,
+ custom_response_validation_http_code: int | HTTPStatus | None = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ middlewares: list[Callable[..., Any]] | None = None,
+ ) -> Callable[[AnyCallableT], AnyCallableT]:
"""Get route decorator with GET `method`
Examples
@@ -272,9 +973,49 @@ def lambda_handler(event, context):
return app.resolve(event, context)
```
"""
- return self.route(rule, "GET", cors, compress, cache_control)
+ return self.route(
+ rule,
+ "GET",
+ cors,
+ compress,
+ cache_control,
+ summary,
+ description,
+ responses,
+ response_description,
+ tags,
+ operation_id,
+ include_in_schema,
+ security,
+ openapi_extensions,
+ deprecated,
+ enable_validation,
+ custom_response_validation_http_code,
+ status_code,
+ middlewares,
+ )
- def post(self, rule: str, cors: Optional[bool] = None, compress: bool = False, cache_control: Optional[str] = None):
+ def post(
+ self,
+ rule: str,
+ cors: bool | None = None,
+ compress: bool = False,
+ cache_control: str | None = None,
+ summary: str | None = None,
+ description: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+ response_description: str = DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ tags: list[str] | None = None,
+ operation_id: str | None = None,
+ include_in_schema: bool = True,
+ security: list[dict[str, list[str]]] | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ deprecated: bool = False,
+ enable_validation: bool | None = None,
+ custom_response_validation_http_code: int | HTTPStatus | None = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ middlewares: list[Callable[..., Any]] | None = None,
+ ) -> Callable[[AnyCallableT], AnyCallableT]:
"""Post route decorator with POST `method`
Examples
@@ -298,9 +1039,49 @@ def lambda_handler(event, context):
return app.resolve(event, context)
```
"""
- return self.route(rule, "POST", cors, compress, cache_control)
+ return self.route(
+ rule,
+ "POST",
+ cors,
+ compress,
+ cache_control,
+ summary,
+ description,
+ responses,
+ response_description,
+ tags,
+ operation_id,
+ include_in_schema,
+ security,
+ openapi_extensions,
+ deprecated,
+ enable_validation,
+ custom_response_validation_http_code,
+ status_code,
+ middlewares,
+ )
- def put(self, rule: str, cors: Optional[bool] = None, compress: bool = False, cache_control: Optional[str] = None):
+ def put(
+ self,
+ rule: str,
+ cors: bool | None = None,
+ compress: bool = False,
+ cache_control: str | None = None,
+ summary: str | None = None,
+ description: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+ response_description: str = DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ tags: list[str] | None = None,
+ operation_id: str | None = None,
+ include_in_schema: bool = True,
+ security: list[dict[str, list[str]]] | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ deprecated: bool = False,
+ enable_validation: bool | None = None,
+ custom_response_validation_http_code: int | HTTPStatus | None = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ middlewares: list[Callable[..., Any]] | None = None,
+ ) -> Callable[[AnyCallableT], AnyCallableT]:
"""Put route decorator with PUT `method`
Examples
@@ -324,11 +1105,49 @@ def lambda_handler(event, context):
return app.resolve(event, context)
```
"""
- return self.route(rule, "PUT", cors, compress, cache_control)
+ return self.route(
+ rule,
+ "PUT",
+ cors,
+ compress,
+ cache_control,
+ summary,
+ description,
+ responses,
+ response_description,
+ tags,
+ operation_id,
+ include_in_schema,
+ security,
+ openapi_extensions,
+ deprecated,
+ enable_validation,
+ custom_response_validation_http_code,
+ status_code,
+ middlewares,
+ )
def delete(
- self, rule: str, cors: Optional[bool] = None, compress: bool = False, cache_control: Optional[str] = None
- ):
+ self,
+ rule: str,
+ cors: bool | None = None,
+ compress: bool = False,
+ cache_control: str | None = None,
+ summary: str | None = None,
+ description: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+ response_description: str = DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ tags: list[str] | None = None,
+ operation_id: str | None = None,
+ include_in_schema: bool = True,
+ security: list[dict[str, list[str]]] | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ deprecated: bool = False,
+ enable_validation: bool | None = None,
+ custom_response_validation_http_code: int | HTTPStatus | None = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ middlewares: list[Callable[..., Any]] | None = None,
+ ) -> Callable[[AnyCallableT], AnyCallableT]:
"""Delete route decorator with DELETE `method`
Examples
@@ -351,11 +1170,49 @@ def lambda_handler(event, context):
return app.resolve(event, context)
```
"""
- return self.route(rule, "DELETE", cors, compress, cache_control)
+ return self.route(
+ rule,
+ "DELETE",
+ cors,
+ compress,
+ cache_control,
+ summary,
+ description,
+ responses,
+ response_description,
+ tags,
+ operation_id,
+ include_in_schema,
+ security,
+ openapi_extensions,
+ deprecated,
+ enable_validation,
+ custom_response_validation_http_code,
+ status_code,
+ middlewares,
+ )
def patch(
- self, rule: str, cors: Optional[bool] = None, compress: bool = False, cache_control: Optional[str] = None
- ):
+ self,
+ rule: str,
+ cors: bool | None = None,
+ compress: bool = False,
+ cache_control: str | None = None,
+ summary: str | None = None,
+ description: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+ response_description: str = DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ tags: list[str] | None = None,
+ operation_id: str | None = None,
+ include_in_schema: bool = True,
+ security: list[dict[str, list[str]]] | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ deprecated: bool = False,
+ enable_validation: bool | None = None,
+ custom_response_validation_http_code: int | HTTPStatus | None = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ middlewares: list[Callable] | None = None,
+ ) -> Callable[[AnyCallableT], AnyCallableT]:
"""Patch route decorator with PATCH `method`
Examples
@@ -381,114 +1238,1298 @@ def lambda_handler(event, context):
return app.resolve(event, context)
```
"""
- return self.route(rule, "PATCH", cors, compress, cache_control)
+ return self.route(
+ rule,
+ "PATCH",
+ cors,
+ compress,
+ cache_control,
+ summary,
+ description,
+ responses,
+ response_description,
+ tags,
+ operation_id,
+ include_in_schema,
+ security,
+ openapi_extensions,
+ deprecated,
+ enable_validation,
+ custom_response_validation_http_code,
+ status_code,
+ middlewares,
+ )
+ def head(
+ self,
+ rule: str,
+ cors: bool | None = None,
+ compress: bool = False,
+ cache_control: str | None = None,
+ summary: str | None = None,
+ description: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+ response_description: str = DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ tags: list[str] | None = None,
+ operation_id: str | None = None,
+ include_in_schema: bool = True,
+ security: list[dict[str, list[str]]] | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ deprecated: bool = False,
+ enable_validation: bool | None = None,
+ custom_response_validation_http_code: int | HTTPStatus | None = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ middlewares: list[Callable] | None = None,
+ ) -> Callable[[AnyCallableT], AnyCallableT]:
+ """Head route decorator with HEAD `method`
-class ApiGatewayResolver(BaseRouter):
- """API Gateway and ALB proxy resolver
+ Examples
+ --------
+ Simple example with a custom lambda handler using the Tracer capture_lambda_handler decorator
- Examples
- --------
- Simple example with a custom lambda handler using the Tracer capture_lambda_handler decorator
+ ```python
+ from aws_lambda_powertools import Tracer
+ from aws_lambda_powertools.event_handler import APIGatewayRestResolver, Response, content_types
- ```python
- from aws_lambda_powertools import Tracer
- from aws_lambda_powertools.event_handler import APIGatewayRestResolver
+ tracer = Tracer()
+ app = APIGatewayRestResolver()
- tracer = Tracer()
- app = APIGatewayRestResolver()
+ @app.head("/head-call")
+ def simple_head():
+ return Response(status_code=200,
+ content_type=content_types.APPLICATION_JSON,
+ headers={"Content-Length": "123"})
- @app.get("/get-call")
- def simple_get():
- return {"message": "Foo"}
+ @tracer.capture_lambda_handler
+ def lambda_handler(event, context):
+ return app.resolve(event, context)
+ ```
+ """
+ return self.route(
+ rule,
+ "HEAD",
+ cors,
+ compress,
+ cache_control,
+ summary,
+ description,
+ responses,
+ response_description,
+ tags,
+ operation_id,
+ include_in_schema,
+ security,
+ openapi_extensions,
+ deprecated,
+ enable_validation,
+ custom_response_validation_http_code,
+ status_code,
+ middlewares,
+ )
- @app.post("/post-call")
- def simple_post():
- post_data: dict = app.current_event.json_body
- return {"message": post_data["value"]}
+ def _push_processed_stack_frame(self, frame: str):
+ """
+ Add Current Middleware to the Middleware Stack Frames
+ The stack frames will be used when exceptions are thrown and Powertools
+ debug is enabled by developers.
+ """
+ self.processed_stack_frames.append(frame)
- @tracer.capture_lambda_handler
- def lambda_handler(event, context):
- return app.resolve(event, context)
- ```
- """
+ def _reset_processed_stack(self):
+ """Reset the Processed Stack Frames"""
+ self.processed_stack_frames.clear()
- def __init__(
- self,
- proxy_type: Enum = ProxyEventType.APIGatewayProxyEvent,
- cors: Optional[CORSConfig] = None,
- debug: Optional[bool] = None,
- serializer: Optional[Callable[[Dict], str]] = None,
- strip_prefixes: Optional[List[str]] = None,
- ):
+ def append_context(self, **additional_context):
+ """Append key=value data as routing context"""
+ self.context.update(**additional_context)
+
+ def clear_context(self):
+ """Resets routing context"""
+ self.context.clear()
+
+ @property
+ def request(self) -> Request:
+ """Current resolved :class:`Request` object.
+
+ Available inside middleware and in route handlers that declare a parameter
+ typed as :class:`Request <aws_lambda_powertools.event_handler.request.Request>`.
+
+ Raises
+ ------
+ RuntimeError
+ When accessed before route resolution (i.e. outside of middleware / handler scope).
+
+ Examples
+ --------
+ **Middleware**
+
+ ```python
+ def my_middleware(app, next_middleware):
+ req = app.request
+ print(req.route, req.method, req.path_parameters)
+ return next_middleware(app)
+ ```
"""
- Parameters
- ----------
+ cached: Request | None = self.context.get("_request")
+ if cached is not None:
+ return cached
+
+ route: Route | None = self.context.get("_route")
+ if route is None:
+ raise RuntimeError(
+ "app.request is only available after route resolution. Use it inside middleware or a route handler.",
+ )
+
+ request = Request(
+ route_path=route.openapi_path,
+ path_parameters=self.context.get("_route_args", {}),
+ current_event=self.current_event,
+ context=self.context,
+ )
+ self.context["_request"] = request
+ return request
+
+
+class MiddlewareFrame:
+ """
+ Creates a Middle Stack Wrapper instance to be used as a "Frame" in the overall stack of
+ middleware functions. Each instance contains the current middleware and the next
+ middleware function to be called in the stack.
+
+ In this way the middleware stack is constructed in a recursive fashion, with each middleware
+ calling the next as a simple function call. The actual Python call-stack will contain
+ each MiddlewareStackWrapper "Frame", meaning any Middleware function can cause the
+ entire Middleware call chain to be exited early (short-circuited) by raising an exception
+ or by simply returning early with a custom Response. The decision to short-circuit the middleware
+ chain is at the user's discretion but instantly available due to the Wrapped nature of the
+ callable constructs in the Middleware stack and each Middleware function having complete control over
+ whether the "Next" handler in the stack is called or not.
+
+ Parameters
+ ----------
+ current_middleware : Callable
+ The current middleware function to be called as a request is processed.
+ next_middleware : Callable
+ The next middleware in the middleware stack.
+ """
+
+ def __init__(
+ self,
+ current_middleware: Callable[..., Any],
+ next_middleware: Callable[..., Any],
+ ) -> None:
+ self.current_middleware: Callable[..., Any] = current_middleware
+ self.next_middleware: Callable[..., Any] = next_middleware
+ self._next_middleware_name = next_middleware.__name__
+
+ @property
+ def __name__(self) -> str: # noqa: A003
+ """Current middleware name
+
+ It ensures backward compatibility with view functions being callable. This
+ improves debugging since we need both current and next middlewares/callable names.
+ """
+ return self.current_middleware.__name__
+
+ def __str__(self) -> str:
+ """Identify current middleware identity and call chain for debugging purposes."""
+ middleware_name = self.__name__
+ return f"[{middleware_name}] next call chain is {middleware_name} -> {self._next_middleware_name}"
+
+ def __call__(self, app: ApiGatewayResolver) -> dict | tuple | Response:
+ """
+ Call the middleware Frame to process the request.
+
+ Parameters
+ ----------
+ app: BaseRouter
+ The router instance
+
+ Returns
+ -------
+ dict | tuple | Response
+ (tech-debt for backward compatibility). The response type should be a
+ Response object in all cases excepting when the original API route handler
+ is called which will return one of 3 outputs.
+
+ """
+ # Do debug printing and push processed stack frame AFTER calling middleware
+ # else the stack frame text of `current calling next` is confusing.
+ logger.debug("MiddlewareFrame: %s", self)
+ app._push_processed_stack_frame(str(self))
+
+ return self.current_middleware(app, self.next_middleware)
+
+
+def _find_request_param_name(func: Callable) -> str | None:
+ """Return the name of the first parameter annotated as ``Request``, or ``None``."""
+ from typing import get_type_hints
+
+ try:
+ # get_type_hints resolves string annotations from ``from __future__ import annotations``
+ # using the function's own module globals.
+ hints = get_type_hints(func)
+ except Exception:
+ hints = {}
+
+ for param_name, annotation in hints.items():
+ if annotation is Request:
+ return param_name
+
+ return None
+
+
+def _registered_api_adapter(
+ app: ApiGatewayResolver,
+ next_middleware: Callable[..., Any],
+) -> dict | tuple | Response | BedrockResponse:
+ """
+ Calls the registered API using the "_route_args" from the Resolver context to ensure the last call
+ in the chain will match the API route function signature and ensure that Powertools passes the API
+ route handler the expected arguments.
+
+ **IMPORTANT: This internal middleware ensures the actual API route is called with the correct call signature
+ and it MUST be the final frame in the middleware stack. This can only be removed when the API Route
+ function accepts `app: BaseRouter` as the first argument - which is the breaking change.
+
+ Parameters
+ ----------
+ app: ApiGatewayResolver
+ The API Gateway resolver
+ next_middleware: Callable[..., Any]
+ The function to handle the API
+
+ Returns
+ -------
+ Response
+ The API Response Object
+
+ """
+ route_args: dict = app.context.get("_route_args", {})
+ logger.debug(f"Calling API Route Handler: {route_args}")
+
+ # Inject a Request object when the handler declares a parameter typed as Request.
+ # Lookup is cached on the Route object to avoid repeated signature inspection.
+ route: Route | None = app.context.get("_route")
+ if route is not None:
+ if not route.request_param_name_checked:
+ route.request_param_name = _find_request_param_name(next_middleware)
+ route.request_param_name_checked = True
+ if route.request_param_name:
+ route_args = {**route_args, route.request_param_name: app.request}
+
+ # Resolve Depends() parameters
+ if route.has_dependencies:
+ from aws_lambda_powertools.event_handler.depends import build_dependency_tree, solve_dependencies
+
+ dep_values = solve_dependencies(
+ dependant=build_dependency_tree(route.func),
+ request=app.request,
+ dependency_overrides=app.dependency_overrides or None,
+ )
+ route_args.update(dep_values)
+
+ return app._to_response(next_middleware(**route_args))
+
+
+class ApiGatewayResolver(BaseRouter):
+ """API Gateway, VPC Lattice, Bedrock and ALB proxy resolver
+
+ Examples
+ --------
+ Simple example with a custom lambda handler using the Tracer capture_lambda_handler decorator
+
+ ```python
+ from aws_lambda_powertools import Tracer
+ from aws_lambda_powertools.event_handler import APIGatewayRestResolver
+
+ tracer = Tracer()
+ app = APIGatewayRestResolver()
+
+ @app.get("/get-call")
+ def simple_get():
+ return {"message": "Foo"}
+
+ @app.post("/post-call")
+ def simple_post():
+ post_data: dict = app.current_event.json_body
+ return {"message": post_data["value"]}
+
+ @tracer.capture_lambda_handler
+ def lambda_handler(event, context):
+ return app.resolve(event, context)
+ ```
+ """
+
+ _proxy_event_type: Enum = ProxyEventType.APIGatewayProxyEvent
+
+ def __init__(
+ self,
+ proxy_type: Enum | None = None,
+ cors: CORSConfig | None = None,
+ debug: bool | None = None,
+ serializer: Callable[[dict], str] | None = None,
+ strip_prefixes: list[str | Pattern] | None = None,
+ enable_validation: bool = False,
+ response_validation_error_http_code: HTTPStatus | int | None = None,
+ json_body_deserializer: Callable[[str], dict] | None = None,
+ ):
+ """
+ Parameters
+ ----------
proxy_type: ProxyEventType
Proxy request type, defaults to API Gateway V1
cors: CORSConfig
Optionally configure and enabled CORS. Not each route will need to have to cors=True
- debug: Optional[bool]
- Enables debug mode, by default False. Can be also be enabled by "POWERTOOLS_EVENT_HANDLER_DEBUG"
+ debug: bool | None
+ Enables debug mode, by default False. Can be also be enabled by "POWERTOOLS_DEV"
environment variable
- serializer : Callable, optional
+ serializer: Callable, optional
function to serialize `obj` to a JSON formatted `str`, by default json.dumps
- strip_prefixes: List[str], optional
- optional list of prefixes to be removed from the request path before doing the routing. This is often used
- with api gateways with multiple custom mappings.
- """
- self._proxy_type = proxy_type
- self._routes: List[Route] = []
- self._route_keys: List[str] = []
- self._exception_handlers: Dict[Type, Callable] = {}
+ strip_prefixes: list[str | Pattern], optional
+ optional list of prefixes to be removed from the request path before doing the routing.
+ This is often used with api gateways with multiple custom mappings.
+ Each prefix can be a static string or a compiled regex pattern
+ enable_validation: bool | None
+ Enables validation of the request body against the route schema, by default False.
+ response_validation_error_http_code
+ Sets the returned status code if response is not validated. enable_validation must be True.
+ json_body_deserializer: Callable[[str], dict], optional
+ function to deserialize `str`, `bytes`, `bytearray` containing a JSON document to a Python `dict`,
+ by default json.loads when integrating with EventSource data class
+ """
+ self.dependency_overrides: dict[Callable, Callable] = {}
+ self._proxy_type = proxy_type or self._proxy_event_type
+ self._dynamic_routes: list[Route] = []
+ self._static_routes: list[Route] = []
+ self._route_keys: list[str] = []
+ self._exception_handlers: dict[type, Callable] = {}
self._cors = cors
self._cors_enabled: bool = cors is not None
- self._cors_methods: Set[str] = {"OPTIONS"}
- self._debug = resolve_truthy_env_var_choice(
- env=os.getenv(constants.EVENT_HANDLER_DEBUG_ENV, "false"), choice=debug
- )
+ self._cors_methods: set[str] = {"OPTIONS"}
+ self._debug = self._has_debug(debug)
+ self._enable_validation = enable_validation
self._strip_prefixes = strip_prefixes
+ self.context: dict = {} # early init as customers might add context before event resolution
+ self.processed_stack_frames = []
+ self._response_builder_class = ResponseBuilder[BaseProxyEvent]
+ self.openapi_config = OpenAPIConfig() # starting an empty dataclass
+ self.exception_handler_manager = ExceptionHandlerManager()
+ self._has_response_validation_error = response_validation_error_http_code is not None
+ self._response_validation_error_http_code = self._validate_response_validation_error_http_code(
+ response_validation_error_http_code,
+ enable_validation,
+ )
# Allow for a custom serializer or a concise json serialization
self._serializer = serializer or partial(json.dumps, separators=(",", ":"), cls=Encoder)
+ self._json_body_deserializer = json_body_deserializer
+
+ if self._enable_validation:
+ from aws_lambda_powertools.event_handler.middlewares.openapi_validation import (
+ OpenAPIRequestValidationMiddleware,
+ OpenAPIResponseValidationMiddleware,
+ )
+
+ # Store validation middlewares to be added in the correct order later
+ self._request_validation_middleware = OpenAPIRequestValidationMiddleware()
+ self._response_validation_middleware = OpenAPIResponseValidationMiddleware(
+ validation_serializer=serializer,
+ has_response_validation_error=self._has_response_validation_error,
+ )
+
+ def _validate_response_validation_error_http_code(
+ self,
+ response_validation_error_http_code: HTTPStatus | int | None,
+ enable_validation: bool,
+ ) -> HTTPStatus:
+ if response_validation_error_http_code and not enable_validation:
+ msg = "'response_validation_error_http_code' cannot be set when enable_validation is False."
+ raise ValueError(msg)
+
+ if (
+ not isinstance(response_validation_error_http_code, HTTPStatus)
+ and response_validation_error_http_code is not None
+ ):
+ try:
+ response_validation_error_http_code = HTTPStatus(response_validation_error_http_code)
+ except ValueError:
+ msg = f"'{response_validation_error_http_code}' must be an integer representing an HTTP status code."
+ raise ValueError(msg) from None
+
+ return response_validation_error_http_code or HTTPStatus.UNPROCESSABLE_ENTITY
+
+ def _add_resolver_response_validation_error_response_to_route(
+ self,
+ route_openapi_path: tuple[dict[str, Any], dict[str, Any]],
+ ) -> tuple[dict[str, Any], dict[str, Any]]:
+ """Adds resolver response validation error response to route's operations."""
+ path, path_definitions = route_openapi_path
+ if self._has_response_validation_error and "ResponseValidationError" not in path_definitions:
+ response_validation_error_response = {
+ "description": "Response Validation Error",
+ "content": {
+ DEFAULT_CONTENT_TYPE: {
+ "schema": {"$ref": f"{COMPONENT_REF_PREFIX}ResponseValidationError"},
+ },
+ },
+ }
+ http_code = self._response_validation_error_http_code.value
+ for operation in path.values():
+ operation["responses"][http_code] = response_validation_error_response
+ return path, path_definitions
+
+ def _generate_schemas(self, definitions: dict[str, dict[str, Any]]) -> dict[str, dict[str, Any]]:
+ schemas = {k: definitions[k] for k in sorted(definitions)}
+ # add response validation error definition
+ if self._response_validation_error_http_code:
+ schemas.setdefault("ResponseValidationError", response_validation_error_response_definition)
+ return schemas
+
+ def get_openapi_schema(
+ self,
+ *,
+ title: str = DEFAULT_OPENAPI_TITLE,
+ version: str = DEFAULT_API_VERSION,
+ openapi_version: str = DEFAULT_OPENAPI_VERSION,
+ summary: str | None = None,
+ description: str | None = None,
+ tags: list[Tag | str] | None = None,
+ servers: list[Server] | None = None,
+ terms_of_service: str | None = None,
+ contact: Contact | None = None,
+ license_info: License | None = None,
+ security_schemes: dict[str, SecurityScheme] | None = None,
+ security: list[dict[str, list[str]]] | None = None,
+ external_documentation: ExternalDocumentation | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ ) -> OpenAPI:
+ """
+ Returns the OpenAPI schema as a pydantic model.
+
+ Parameters
+ ----------
+ title: str
+ The title of the application.
+ version: str
+ The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API
+ openapi_version: str, default = "3.1.0"
+ The version of the OpenAPI Specification (which the document uses).
+ summary: str, optional
+ A short summary of what the application does.
+ description: str, optional
+ A verbose explanation of the application behavior.
+ tags: list[Tag | str], optional
+ A list of tags used by the specification with additional metadata.
+ servers: list[Server], optional
+ An array of Server Objects, which provide connectivity information to a target server.
+ terms_of_service: str, optional
+ A URL to the Terms of Service for the API. MUST be in the format of a URL.
+ contact: Contact, optional
+ The contact information for the exposed API.
+ license_info: License, optional
+ The license information for the exposed API.
+ security_schemes: dict[str, SecurityScheme]], optional
+ A declaration of the security schemes available to be used in the specification.
+ security: list[dict[str, list[str]]], optional
+ A declaration of which security mechanisms are applied globally across the API.
+ external_documentation: ExternalDocumentation, optional
+ Additional external documentation for the API.
+ openapi_extensions: Dict[str, Any], optional
+ Additional OpenAPI extensions as a dictionary.
+
+ Returns
+ -------
+ OpenAPI: pydantic model
+ The OpenAPI schema as a pydantic model.
+ """
+
+ # DEPRECATION: Will be removed in v4.0.0. Use configure_api() instead.
+ # Maintained for backwards compatibility.
+ # See: https://github.com/aws-powertools/powertools-lambda-python/issues/6122
+ if title == DEFAULT_OPENAPI_TITLE and self.openapi_config.title:
+ title = self.openapi_config.title
+
+ if version == DEFAULT_API_VERSION and self.openapi_config.version:
+ version = self.openapi_config.version
+
+ if openapi_version == DEFAULT_OPENAPI_VERSION and self.openapi_config.openapi_version:
+ openapi_version = self.openapi_config.openapi_version
+
+ summary = summary or self.openapi_config.summary
+ description = description or self.openapi_config.description
+ tags = tags or self.openapi_config.tags
+ servers = servers or self.openapi_config.servers
+ terms_of_service = terms_of_service or self.openapi_config.terms_of_service
+ contact = contact or self.openapi_config.contact
+ license_info = license_info or self.openapi_config.license_info
+ security_schemes = security_schemes or self.openapi_config.security_schemes
+ security = security or self.openapi_config.security
+ external_documentation = external_documentation or self.openapi_config.external_documentation
+ openapi_extensions = openapi_extensions or self.openapi_config.openapi_extensions
+
+ from pydantic.json_schema import GenerateJsonSchema
+
+ from aws_lambda_powertools.event_handler.openapi.compat import (
+ get_compat_model_name_map,
+ get_definitions,
+ )
+ from aws_lambda_powertools.event_handler.openapi.models import OpenAPI, PathItem, Tag
+ from aws_lambda_powertools.event_handler.openapi.types import (
+ COMPONENT_REF_TEMPLATE,
+ )
+
+ openapi_version = self._determine_openapi_version(openapi_version)
+
+ # Start with the bare minimum required for a valid OpenAPI schema
+ info: dict[str, Any] = {"title": title, "version": version}
+
+ optional_fields = {
+ "summary": summary,
+ "description": description,
+ "termsOfService": terms_of_service,
+ "contact": contact,
+ "license": license_info,
+ }
+
+ info.update({field: value for field, value in optional_fields.items() if value})
+
+ if not isinstance(openapi_extensions, dict):
+ openapi_extensions = {}
+
+ output: dict[str, Any] = {
+ "openapi": openapi_version,
+ "info": info,
+ "servers": self._get_openapi_servers(servers),
+ "security": self._get_openapi_security(security, security_schemes),
+ **openapi_extensions,
+ }
+
+ if external_documentation:
+ output["externalDocs"] = external_documentation
+
+ components: dict[str, dict[str, Any]] = {}
+ paths: dict[str, dict[str, Any]] = {}
+ operation_ids: set[str] = set()
+
+ all_routes = self._dynamic_routes + self._static_routes
+ all_fields = self._get_fields_from_routes(all_routes)
+ model_name_map = get_compat_model_name_map(all_fields)
+
+ # Collect all models and definitions
+ schema_generator = GenerateJsonSchema(ref_template=COMPONENT_REF_TEMPLATE)
+ field_mapping, definitions = get_definitions(
+ fields=all_fields,
+ schema_generator=schema_generator,
+ model_name_map=model_name_map,
+ )
+
+ # Add routes to the OpenAPI schema
+ for route in all_routes:
+ if route.security and not _validate_openapi_security_parameters(
+ security=route.security,
+ security_schemes=security_schemes,
+ ):
+ raise SchemaValidationError(
+ "Security configuration was not found in security_schemas or security_schema was not defined. "
+ "See: https://docs.powertools.aws.dev/lambda/python/latest/core/event_handler/api_gateway/#security-schemes",
+ )
+
+ if not route.include_in_schema:
+ continue
+
+ result = route._get_openapi_path(
+ dependant=route.dependant,
+ operation_ids=operation_ids,
+ model_name_map=model_name_map,
+ field_mapping=field_mapping,
+ enable_validation=self._enable_validation,
+ )
+ if result:
+ path, path_definitions = self._add_resolver_response_validation_error_response_to_route(result)
+ if path:
+ paths.setdefault(route.openapi_path, {}).update(path)
+ if path_definitions:
+ definitions.update(path_definitions)
+
+ if definitions:
+ components["schemas"] = self._generate_schemas(definitions)
+ if security_schemes:
+ components["securitySchemes"] = security_schemes
+ if components:
+ output["components"] = components
+ if tags:
+ output["tags"] = [Tag(name=tag) if isinstance(tag, str) else tag for tag in tags]
+
+ output["paths"] = {k: PathItem(**v) for k, v in paths.items()}
+
+ return OpenAPI(**output)
+
+ @staticmethod
+ def _get_openapi_servers(servers: list[Server] | None) -> list[Server]:
+ from aws_lambda_powertools.event_handler.openapi.models import Server
+
+ # If the 'servers' property is not provided or is an empty array,
+ # the default behavior is to return a Server Object with a URL value of "/".
+ return servers or [Server(url="/")]
+
+ @staticmethod
+ def _get_openapi_security(
+ security: list[dict[str, list[str]]] | None,
+ security_schemes: dict[str, SecurityScheme] | None,
+ ) -> list[dict[str, list[str]]] | None:
+ if not security:
+ return None
+
+ if not _validate_openapi_security_parameters(security=security, security_schemes=security_schemes):
+ raise SchemaValidationError(
+ "Security configuration was not found in security_schemas or security_schema was not defined. "
+ "See: https://docs.powertools.aws.dev/lambda/python/latest/core/event_handler/api_gateway/#security-schemes",
+ )
+
+ return security
+
+ @staticmethod
+ def _determine_openapi_version(openapi_version: str):
+ # Pydantic V2 has no support for OpenAPI schema 3.0
+ if not openapi_version.startswith("3.1"):
+ warnings.warn(
+ "You are using Pydantic v2, which is incompatible with OpenAPI schema 3.0. Forcing OpenAPI 3.1",
+ stacklevel=2,
+ )
+ openapi_version = "3.1.0"
+ return openapi_version
+
+ def get_openapi_json_schema(
+ self,
+ *,
+ title: str = DEFAULT_OPENAPI_TITLE,
+ version: str = DEFAULT_API_VERSION,
+ openapi_version: str = DEFAULT_OPENAPI_VERSION,
+ summary: str | None = None,
+ description: str | None = None,
+ tags: list[Tag | str] | None = None,
+ servers: list[Server] | None = None,
+ terms_of_service: str | None = None,
+ contact: Contact | None = None,
+ license_info: License | None = None,
+ security_schemes: dict[str, SecurityScheme] | None = None,
+ security: list[dict[str, list[str]]] | None = None,
+ external_documentation: ExternalDocumentation | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ ) -> str:
+ """
+ Returns the OpenAPI schema as a JSON serializable dict
+
+ Parameters
+ ----------
+ title: str
+ The title of the application.
+ version: str
+ The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API
+ openapi_version: str, default = "3.1.0"
+ The version of the OpenAPI Specification (which the document uses).
+ summary: str, optional
+ A short summary of what the application does.
+ description: str, optional
+ A verbose explanation of the application behavior.
+ tags: list[Tag, str], optional
+ A list of tags used by the specification with additional metadata.
+ servers: list[Server], optional
+ An array of Server Objects, which provide connectivity information to a target server.
+ terms_of_service: str, optional
+ A URL to the Terms of Service for the API. MUST be in the format of a URL.
+ contact: Contact, optional
+ The contact information for the exposed API.
+ license_info: License, optional
+ The license information for the exposed API.
+ security_schemes: dict[str, SecurityScheme]], optional
+ A declaration of the security schemes available to be used in the specification.
+ security: list[dict[str, list[str]]], optional
+ A declaration of which security mechanisms are applied globally across the API.
+ external_documentation: ExternalDocumentation, optional
+ Additional external documentation for the API.
+ openapi_extensions: Dict[str, Any], optional
+ Additional OpenAPI extensions as a dictionary.
+
+ Returns
+ -------
+ str
+ The OpenAPI schema as a JSON serializable dict.
+ """
+
+ from aws_lambda_powertools.event_handler.openapi.compat import model_json
+
+ return model_json(
+ self.get_openapi_schema(
+ title=title,
+ version=version,
+ openapi_version=openapi_version,
+ summary=summary,
+ description=description,
+ tags=tags,
+ servers=servers,
+ terms_of_service=terms_of_service,
+ contact=contact,
+ license_info=license_info,
+ security_schemes=security_schemes,
+ security=security,
+ external_documentation=external_documentation,
+ openapi_extensions=openapi_extensions,
+ ),
+ by_alias=True,
+ exclude_none=True,
+ indent=2,
+ )
+
+ def configure_openapi(
+ self,
+ title: str = DEFAULT_OPENAPI_TITLE,
+ version: str = DEFAULT_API_VERSION,
+ openapi_version: str = DEFAULT_OPENAPI_VERSION,
+ summary: str | None = None,
+ description: str | None = None,
+ tags: list[Tag | str] | None = None,
+ servers: list[Server] | None = None,
+ terms_of_service: str | None = None,
+ contact: Contact | None = None,
+ license_info: License | None = None,
+ security_schemes: dict[str, SecurityScheme] | None = None,
+ security: list[dict[str, list[str]]] | None = None,
+ external_documentation: ExternalDocumentation | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ ):
+ """Configure OpenAPI specification settings for the API.
+
+ Sets up the OpenAPI documentation configuration that can be later used
+ when enabling Swagger UI or generating OpenAPI specifications.
+
+ Parameters
+ ----------
+ title: str
+ The title of the application.
+ version: str
+ The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API
+ openapi_version: str, default = "3.1.0"
+ The version of the OpenAPI Specification (which the document uses).
+ summary: str, optional
+ A short summary of what the application does.
+ description: str, optional
+ A verbose explanation of the application behavior.
+ tags: list[Tag, str], optional
+ A list of tags used by the specification with additional metadata.
+ servers: list[Server], optional
+ An array of Server Objects, which provide connectivity information to a target server.
+ terms_of_service: str, optional
+ A URL to the Terms of Service for the API. MUST be in the format of a URL.
+ contact: Contact, optional
+ The contact information for the exposed API.
+ license_info: License, optional
+ The license information for the exposed API.
+ security_schemes: dict[str, SecurityScheme]], optional
+ A declaration of the security schemes available to be used in the specification.
+ security: list[dict[str, list[str]]], optional
+ A declaration of which security mechanisms are applied globally across the API.
+ external_documentation: ExternalDocumentation, optional
+ A link to external documentation for the API.
+ openapi_extensions: Dict[str, Any], optional
+ Additional OpenAPI extensions as a dictionary.
+
+ Example
+ --------
+ >>> api.configure_openapi(
+ ... title="My API",
+ ... version="1.0.0",
+ ... description="API for managing resources",
+ ... contact=Contact(
+ ... name="API Support",
+ ... email="support@example.com"
+ ... )
+ ... )
+
+ See Also
+ --------
+ enable_swagger : Method to enable Swagger UI using these configurations
+ OpenAPIConfig : Data class containing all OpenAPI configuration options
+ """
+ self.openapi_config = OpenAPIConfig(
+ title=title,
+ version=version,
+ openapi_version=openapi_version,
+ summary=summary,
+ description=description,
+ tags=tags,
+ servers=servers,
+ terms_of_service=terms_of_service,
+ contact=contact,
+ license_info=license_info,
+ security_schemes=security_schemes,
+ security=security,
+ external_documentation=external_documentation,
+ openapi_extensions=openapi_extensions,
+ )
+
+ def configure_openapi_merge(
+ self,
+ path: str,
+ pattern: str | list[str] = "handler.py",
+ exclude: list[str] | None = None,
+ resolver_name: str = "app",
+ recursive: bool = False,
+ title: str = DEFAULT_OPENAPI_TITLE,
+ version: str = DEFAULT_API_VERSION,
+ openapi_version: str = DEFAULT_OPENAPI_VERSION,
+ summary: str | None = None,
+ description: str | None = None,
+ tags: list[Tag | str] | None = None,
+ servers: list[Server] | None = None,
+ terms_of_service: str | None = None,
+ contact: Contact | None = None,
+ license_info: License | None = None,
+ security_schemes: dict[str, SecurityScheme] | None = None,
+ security: list[dict[str, list[str]]] | None = None,
+ external_documentation: ExternalDocumentation | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ on_conflict: Literal["warn", "error", "first", "last"] = "warn",
+ ):
+ """Configure OpenAPI merge to generate a unified schema from multiple Lambda handlers.
+
+ This method discovers resolver instances across multiple Python files and merges
+ their OpenAPI schemas into a single unified specification. Useful for micro-function
+ architectures where each Lambda has its own resolver.
+
+ Parameters
+ ----------
+ path : str
+ Root directory path to search for resolver files.
+ pattern : str | list[str], optional
+ Glob pattern(s) to match handler files. Default is "handler.py".
+ exclude : list[str], optional
+ Patterns to exclude from search. Default excludes tests, __pycache__, and .venv.
+ resolver_name : str, optional
+ Name of the resolver variable in handler files. Default is "app".
+ recursive : bool, optional
+ Whether to search recursively in subdirectories. Default is False.
+ title : str
+ The title of the unified API.
+ version : str
+ The version of the OpenAPI document.
+ openapi_version : str, default = "3.1.0"
+ The version of the OpenAPI Specification.
+ summary : str, optional
+ A short summary of what the application does.
+ description : str, optional
+ A verbose explanation of the application behavior.
+ tags : list[Tag | str], optional
+ A list of tags used by the specification with additional metadata.
+ servers : list[Server], optional
+ An array of Server Objects for connectivity information.
+ terms_of_service : str, optional
+ A URL to the Terms of Service for the API.
+ contact : Contact, optional
+ The contact information for the exposed API.
+ license_info : License, optional
+ The license information for the exposed API.
+ security_schemes : dict[str, SecurityScheme], optional
+ Security schemes available in the specification.
+ security : list[dict[str, list[str]]], optional
+ Security mechanisms applied globally across the API.
+ external_documentation : ExternalDocumentation, optional
+ A link to external documentation for the API.
+ openapi_extensions : dict[str, Any], optional
+ Additional OpenAPI extensions as a dictionary.
+ on_conflict : str, optional
+ Strategy for handling conflicts when the same path+method is defined
+ in multiple schemas. Options: "warn" (default), "error", "first", "last".
+
+ Example
+ -------
+ >>> from aws_lambda_powertools.event_handler import APIGatewayRestResolver
+ >>>
+ >>> app = APIGatewayRestResolver()
+ >>> app.configure_openapi_merge(
+ ... path="./functions",
+ ... pattern="handler.py",
+ ... exclude=["**/tests/**"],
+ ... resolver_name="app",
+ ... title="My Unified API",
+ ... version="1.0.0",
+ ... )
+
+ See Also
+ --------
+ configure_openapi : Configure OpenAPI for a single resolver
+ enable_swagger : Enable Swagger UI
+ """
+ from aws_lambda_powertools.event_handler.openapi.merge import OpenAPIMerge
+
+ if exclude is None:
+ exclude = ["**/tests/**", "**/__pycache__/**", "**/.venv/**"]
+
+ self._openapi_merge = OpenAPIMerge(
+ title=title,
+ version=version,
+ openapi_version=openapi_version,
+ summary=summary,
+ description=description,
+ tags=tags,
+ servers=servers,
+ terms_of_service=terms_of_service,
+ contact=contact,
+ license_info=license_info,
+ security_schemes=security_schemes,
+ security=security,
+ external_documentation=external_documentation,
+ openapi_extensions=openapi_extensions,
+ on_conflict=on_conflict,
+ )
+ self._openapi_merge.discover(
+ path=path,
+ pattern=pattern,
+ exclude=exclude,
+ resolver_name=resolver_name,
+ recursive=recursive,
+ )
+
+ def get_openapi_merge_schema(self) -> dict[str, Any]:
+ """Get the merged OpenAPI schema from multiple Lambda handlers.
+
+ Returns
+ -------
+ dict[str, Any]
+ The merged OpenAPI schema.
+
+ Raises
+ ------
+ RuntimeError
+ If configure_openapi_merge has not been called.
+ """
+ if not hasattr(self, "_openapi_merge") or self._openapi_merge is None:
+ raise RuntimeError("configure_openapi_merge must be called before get_openapi_merge_schema")
+ return self._openapi_merge.get_openapi_schema()
+
+ def get_openapi_merge_json_schema(self) -> str:
+ """Get the merged OpenAPI schema as JSON from multiple Lambda handlers.
+
+ Returns
+ -------
+ str
+ The merged OpenAPI schema as a JSON string.
+
+ Raises
+ ------
+ RuntimeError
+ If configure_openapi_merge has not been called.
+ """
+ if not hasattr(self, "_openapi_merge") or self._openapi_merge is None:
+ raise RuntimeError("configure_openapi_merge must be called before get_openapi_merge_json_schema")
+ return self._openapi_merge.get_openapi_json_schema()
+
+ def enable_swagger(
+ self,
+ *,
+ path: str = "/swagger",
+ title: str = DEFAULT_OPENAPI_TITLE,
+ version: str = DEFAULT_API_VERSION,
+ openapi_version: str = DEFAULT_OPENAPI_VERSION,
+ summary: str | None = None,
+ description: str | None = None,
+ tags: list[Tag | str] | None = None,
+ servers: list[Server] | None = None,
+ terms_of_service: str | None = None,
+ contact: Contact | None = None,
+ license_info: License | None = None,
+ swagger_base_url: str | None = None,
+ middlewares: list[Callable[..., Response]] | None = None,
+ compress: bool = False,
+ security_schemes: dict[str, SecurityScheme] | None = None,
+ security: list[dict[str, list[str]]] | None = None,
+ oauth2_config: OAuth2Config | None = None,
+ persist_authorization: bool = False,
+ external_documentation: ExternalDocumentation | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ ):
+ """
+ Returns the OpenAPI schema as a JSON serializable dict
+
+ Parameters
+ ----------
+ path: str, default = "/swagger"
+ The path to the swagger UI.
+ title: str
+ The title of the application.
+ version: str
+ The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API
+ openapi_version: str, default = "3.1.0"
+ The version of the OpenAPI Specification (which the document uses).
+ summary: str, optional
+ A short summary of what the application does.
+ description: str, optional
+ A verbose explanation of the application behavior.
+ tags: list[Tag, str], optional
+ A list of tags used by the specification with additional metadata.
+ servers: list[Server], optional
+ An array of Server Objects, which provide connectivity information to a target server.
+ terms_of_service: str, optional
+ A URL to the Terms of Service for the API. MUST be in the format of a URL.
+ contact: Contact, optional
+ The contact information for the exposed API.
+ license_info: License, optional
+ The license information for the exposed API.
+ swagger_base_url: str, optional
+ The base url for the swagger UI. If not provided, we will serve a recent version of the Swagger UI.
+ middlewares: list[Callable[..., Response]], optional
+ List of middlewares to be used for the swagger route.
+ compress: bool, default = False
+ Whether or not to enable gzip compression swagger route.
+ security_schemes: dict[str, "SecurityScheme"], optional
+ A declaration of the security schemes available to be used in the specification.
+ security: list[dict[str, list[str]]], optional
+ A declaration of which security mechanisms are applied globally across the API.
+ oauth2_config: OAuth2Config, optional
+ The OAuth2 configuration for the Swagger UI.
+ persist_authorization: bool, optional
+ Whether to persist authorization data on browser close/refresh.
+ external_documentation: ExternalDocumentation, optional
+ A link to external documentation for the API.
+ openapi_extensions: dict[str, Any], optional
+ Additional OpenAPI extensions as a dictionary.
+ """
+
+ from aws_lambda_powertools.event_handler.openapi.compat import model_json
+ from aws_lambda_powertools.event_handler.openapi.models import Server
+ from aws_lambda_powertools.event_handler.openapi.swagger_ui import (
+ generate_oauth2_redirect_html,
+ generate_swagger_html,
+ )
+
+ @self.get(path, middlewares=middlewares, include_in_schema=False, compress=compress)
+ def swagger_handler():
+ query_params = self.current_event.query_string_parameters or {}
+
+ # Check for query parameters; if "format" is specified as "oauth2-redirect",
+ # send the oauth2-redirect HTML stanza so OAuth2 can be used
+ # Source: https://github.com/swagger-api/swagger-ui/blob/master/dist/oauth2-redirect.html
+ if query_params.get("format") == "oauth2-redirect":
+ return Response(
+ status_code=200,
+ content_type="text/html",
+ body=generate_oauth2_redirect_html(),
+ )
+
+ base_path = self._get_base_path()
+
+ if swagger_base_url:
+ swagger_js = f"{swagger_base_url}/swagger-ui-bundle.min.js"
+ swagger_css = f"{swagger_base_url}/swagger-ui.min.css"
+ else:
+ # We now inject CSS and JS into the SwaggerUI file
+ swagger_js = Path.open(
+ Path(__file__).parent / "openapi" / "swagger_ui" / "swagger-ui-bundle.min.js",
+ encoding="utf-8",
+ ).read()
+ swagger_css = Path.open(
+ Path(__file__).parent / "openapi" / "swagger_ui" / "swagger-ui.min.css",
+ encoding="utf-8",
+ ).read()
+
+ openapi_servers = servers or [Server(url=(base_path or "/"))]
+
+ # Use merged schema if configure_openapi_merge was called, otherwise use regular schema
+ if hasattr(self, "_openapi_merge") and self._openapi_merge is not None:
+ # Get merged schema as JSON string (already properly serialized)
+ escaped_spec = self._openapi_merge.get_openapi_json_schema().replace("</", "<\\/")
+ else:
+ spec = self.get_openapi_schema(
+ title=title,
+ version=version,
+ openapi_version=openapi_version,
+ summary=summary,
+ description=description,
+ tags=tags,
+ servers=openapi_servers,
+ terms_of_service=terms_of_service,
+ contact=contact,
+ license_info=license_info,
+ security_schemes=security_schemes,
+ security=security,
+ external_documentation=external_documentation,
+ openapi_extensions=openapi_extensions,
+ )
+
+ # The .replace('</', '<\\/') part is necessary to prevent a potential issue where the JSON
+ # string contains </script> or similar tags. Escaping the forward slash in </ as <\/ ensures
+ # that the JSON does not inadvertently close the script tag, and the JSON remains a valid
+ # string within the JavaScript code.
+ escaped_spec = model_json(
+ spec,
+ by_alias=True,
+ exclude_none=True,
+ indent=2,
+ ).replace("</", "<\\/")
+
+ # Check for query parameters; if "format" is specified as "json",
+ # respond with the JSON used in the OpenAPI spec
+ # Example: https://www.example.com/swagger?format=json
+ if query_params.get("format") == "json":
+ return Response(
+ status_code=200,
+ content_type=DEFAULT_CONTENT_TYPE,
+ body=escaped_spec,
+ )
+
+ body = generate_swagger_html(
+ escaped_spec,
+ swagger_js,
+ swagger_css,
+ swagger_base_url,
+ oauth2_config,
+ persist_authorization,
+ )
+
+ return Response(
+ status_code=200,
+ content_type="text/html",
+ body=body,
+ )
+
+ def _validate_route_response_validation_error_http_code(
+ self,
+ custom_response_validation_http_code: int | HTTPStatus | None,
+ ) -> HTTPStatus | None:
+ if custom_response_validation_http_code and not self._enable_validation:
+ msg = (
+ "'custom_response_validation_http_code' cannot be set for route when enable_validation is False "
+ "on resolver."
+ )
+ raise ValueError(msg)
+
+ if (
+ not isinstance(custom_response_validation_http_code, HTTPStatus)
+ and custom_response_validation_http_code is not None
+ ):
+ try:
+ custom_response_validation_http_code = HTTPStatus(custom_response_validation_http_code)
+ except ValueError:
+ msg = f"'{custom_response_validation_http_code}' must be an integer representing an HTTP status code or an enum of type HTTPStatus." # noqa: E501
+ raise ValueError(msg) from None
+
+ return custom_response_validation_http_code
def route(
self,
rule: str,
- method: Union[str, Union[List[str], Tuple[str]]],
- cors: Optional[bool] = None,
+ method: str | list[str] | tuple[str],
+ cors: bool | None = None,
compress: bool = False,
- cache_control: Optional[str] = None,
- ):
+ cache_control: str | None = None,
+ summary: str | None = None,
+ description: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+ response_description: str = DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ tags: list[str] | None = None,
+ operation_id: str | None = None,
+ include_in_schema: bool = True,
+ security: list[dict[str, list[str]]] | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ deprecated: bool = False,
+ enable_validation: bool | None = None,
+ custom_response_validation_http_code: int | HTTPStatus | None = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ middlewares: list[Callable[..., Any]] | None = None,
+ ) -> Callable[[AnyCallableT], AnyCallableT]:
"""Route decorator includes parameter `method`"""
- def register_resolver(func: Callable):
+ custom_response_validation_http_code = self._validate_route_response_validation_error_http_code(
+ custom_response_validation_http_code,
+ )
+
+ def register_resolver(func: AnyCallableT) -> AnyCallableT:
methods = (method,) if isinstance(method, str) else method
- logger.debug(f"Adding route using rule {rule} and methods: {','.join((m.upper() for m in methods))}")
- if cors is None:
- cors_enabled = self._cors_enabled
- else:
- cors_enabled = cors
+ logger.debug(f"Adding route using rule {rule} and methods: {','.join(m.upper() for m in methods)}")
+
+ cors_enabled = self._cors_enabled if cors is None else cors
for item in methods:
- self._routes.append(Route(item, self._compile_regex(rule), func, cors_enabled, compress, cache_control))
- route_key = item + rule
- if route_key in self._route_keys:
- warnings.warn(f"A route like this was already registered. method: '{item}' rule: '{rule}'")
- self._route_keys.append(route_key)
+ _route = Route(
+ item,
+ rule,
+ self._compile_regex(rule),
+ func,
+ cors_enabled,
+ compress,
+ cache_control,
+ summary,
+ description,
+ responses,
+ response_description,
+ tags,
+ operation_id,
+ include_in_schema,
+ security,
+ openapi_extensions,
+ deprecated,
+ enable_validation,
+ custom_response_validation_http_code,
+ status_code,
+ middlewares,
+ )
+
+ # The more specific route wins.
+ # We store dynamic (/studies/{studyid}) and static routes (/studies/fetch) separately.
+ # Then attempt a match for static routes before dynamic routes.
+ # This ensures that the most specific route is prioritized and processed first (studies/fetch).
+ if _route.rule.groups > 0:
+ self._dynamic_routes.append(_route)
+ else:
+ self._static_routes.append(_route)
+
+ self._create_route_key(item, rule)
+
if cors_enabled:
logger.debug(f"Registering method {item.upper()} to Allow Methods in CORS")
self._cors_methods.add(item.upper())
+
return func
return register_resolver
- def resolve(self, event, context) -> Dict[str, Any]:
+ def resolve(self, event: Mapping[str, Any], context: LambdaContext) -> dict[str, Any]:
"""Resolves the response based on the provide event and decorator routes
+ ## Internals
+
+ Request processing chain is triggered by a Route object being called _(`_call_route` -> `__call__`)_:
+
+ 1. **When a route is matched**
+ 1.1. Exception handlers _(if any exception bubbled up and caught)_
+ 1.2. Global middlewares _(before, and after on the way back)_
+ 1.3. Path level middleware _(before, and after on the way back)_
+ 1.4. Middleware adapter to ensure Response is homogenous (_registered_api_adapter)
+ 1.5. Run actual route
+ 2. **When a route is NOT matched**
+ 2.1. Exception handlers _(if any exception bubbled up and caught)_
+ 2.2. Global middlewares _(before, and after on the way back)_
+ 2.3. Path level middleware _(before, and after on the way back)_
+ 2.4. Middleware adapter to ensure Response is homogenous (_registered_api_adapter)
+ 2.5. Run 404 route handler
+ 3. **When a route is a pre-flight CORS (often not matched)**
+ 3.1. Exception handlers _(if any exception bubbled up and caught)_
+ 3.2. Global middlewares _(before, and after on the way back)_
+ 3.3. Path level middleware _(before, and after on the way back)_
+ 3.4. Middleware adapter to ensure Response is homogenous (_registered_api_adapter)
+ 3.5. Return 204 with appropriate CORS headers
+ 4. **When a route is matched with Data Validation enabled**
+ 4.1. Exception handlers _(if any exception bubbled up and caught)_
+ 4.2. Data Validation middleware _(before, and after on the way back)_
+ 4.3. Global middlewares _(before, and after on the way back)_
+ 4.4. Path level middleware _(before, and after on the way back)_
+ 4.5. Middleware adapter to ensure Response is homogenous (_registered_api_adapter)
+ 4.6. Run actual route
+
Parameters
----------
- event: Dict[str, Any]
+ event: dict[str, Any]
Event
context: LambdaContext
Lambda context
@@ -499,20 +2540,202 @@ def resolve(self, event, context) -> Dict[str, Any]:
"""
if isinstance(event, BaseProxyEvent):
warnings.warn(
- "You don't need to serialize event to Event Source Data Class when using Event Handler; see issue #1152"
+ "You don't need to serialize event to Event Source Data Class when using Event Handler; "
+ "see issue #1152",
+ stacklevel=2,
)
event = event.raw_event
+
if self._debug:
- print(self._json_dump(event), end="")
- BaseRouter.current_event = self._to_proxy_event(event)
+ print(self._serializer(cast(dict, event)))
+
+ # Populate router(s) dependencies without keeping a reference to each registered router
+ BaseRouter.current_event = self._to_proxy_event(cast(dict, event))
BaseRouter.lambda_context = context
- return self._resolve().build(self.current_event, self._cors)
+
+ response = self._resolve().build(self.current_event, self._cors)
+
+ # Debug print Processed Middlewares
+ if self._debug:
+ print("\nProcessed Middlewares:")
+ print("======================")
+ print("\n".join(self.processed_stack_frames))
+ print("======================")
+
+ self.clear_context()
+
+ return response
+
+ async def resolve_async(self, event: Mapping[str, Any], context: LambdaContext) -> dict[str, Any]:
+ """Async version of resolve() for native async handler support.
+
+ Use this method when your route handlers use async/await. The resolution
+ pipeline supports both sync and async handlers transparently.
+
+ Parameters
+ ----------
+ event: dict[str, Any]
+ Event
+ context: LambdaContext
+ Lambda context
+ Returns
+ -------
+ dict
+ Returns the dict response
+
+ Example
+ -------
+
+ ```python
+ import asyncio
+ from aws_lambda_powertools.event_handler import APIGatewayHttpResolver
+
+ app = APIGatewayHttpResolver()
+
+ @app.get("/async")
+ async def async_handler():
+ return {"message": "async works"}
+
+ def lambda_handler(event, context):
+ return asyncio.run(app.resolve_async(event, context))
+ ```
+ """
+ if isinstance(event, BaseProxyEvent):
+ warnings.warn(
+ "You don't need to serialize event to Event Source Data Class when using Event Handler; "
+ "see issue #1152",
+ stacklevel=2,
+ )
+ event = event.raw_event
+
+ if self._debug:
+ print(self._serializer(cast(dict, event)))
+
+ BaseRouter.current_event = self._to_proxy_event(cast(dict, event))
+ BaseRouter.lambda_context = context
+
+ response = (await self._resolve_async()).build(self.current_event, self._cors)
+
+ if self._debug:
+ print("\nProcessed Middlewares:")
+ print("======================")
+ print("\n".join(self.processed_stack_frames))
+ print("======================")
+
+ self.clear_context()
+
+ return response
+
+ async def _resolve_async(self) -> ResponseBuilder:
+ method = self.current_event.http_method.upper()
+ path = self._remove_prefix(self.current_event.path)
+
+ registered_routes = self._static_routes + self._dynamic_routes
+
+ for route in registered_routes:
+ if method != route.method:
+ continue
+ match_results: Match | None = route.rule.match(path)
+ if match_results:
+ logger.debug("Found a registered route. Calling async function")
+ self.append_context(_route=route, _path=path)
+
+ route_keys = self._convert_matches_into_route_keys(match_results)
+ return await self._call_route_async(route, route_keys)
+
+ return await self._handle_not_found_async(method=method, path=path)
+
+ async def _call_route_async(self, route: Route, route_arguments: dict[str, str]) -> ResponseBuilder:
+ try:
+ self._reset_processed_stack()
+
+ response = await route.call_async(
+ router_middlewares=self._router_middlewares,
+ app=self,
+ route_arguments=route_arguments,
+ )
+
+ return self._response_builder_class(
+ response=self._to_response(response), # type: ignore[arg-type]
+ serializer=self._serializer,
+ route=route,
+ )
+ except Exception as exc:
+ response_builder = self._call_exception_handler(exc, route)
+ if response_builder:
+ return response_builder
+
+ logger.exception(exc)
+ if self._debug:
+ return self._response_builder_class(
+ response=Response(
+ status_code=500,
+ content_type=content_types.TEXT_PLAIN,
+ body="".join(traceback.format_exc()),
+ ),
+ serializer=self._serializer,
+ route=route,
+ )
+
+ raise
+
+ async def _handle_not_found_async(self, method: str, path: str) -> ResponseBuilder:
+ logger.debug(f"No match found for path {path} and method {method}")
+
+ def not_found_handler():
+ _headers: dict[str, Any] = {}
+
+ if self._cors and method == "OPTIONS":
+ logger.debug("Pre-flight request detected. Returning CORS with empty response")
+ _headers["Access-Control-Allow-Methods"] = CORSConfig.build_allow_methods(self._cors_methods)
+ return Response(status_code=204, content_type=None, headers=_headers, body="")
+
+ custom_not_found_handler = self.exception_handler_manager.lookup_exception_handler(NotFoundError)
+ if custom_not_found_handler:
+ return custom_not_found_handler(NotFoundError())
+
+ return Response(
+ status_code=HTTPStatus.NOT_FOUND.value,
+ content_type=content_types.APPLICATION_JSON,
+ headers=_headers,
+ body={"statusCode": HTTPStatus.NOT_FOUND.value, "message": "Not found"},
+ )
+
+ route = Route(
+ rule=self._compile_regex(r".*"),
+ method=method,
+ path=path,
+ func=not_found_handler,
+ cors=self._cors_enabled,
+ compress=False,
+ )
+
+ self.append_context(_route=route, _path=path)
+
+ return await self._call_route_async(route=route, route_arguments={})
def __call__(self, event, context) -> Any:
return self.resolve(event, context)
+ def _create_route_key(self, item: str, rule: str):
+ route_key = item + rule
+ if route_key in self._route_keys:
+ warnings.warn(
+ f"A route like this was already registered. method: '{item}' rule: '{rule}'",
+ stacklevel=2,
+ )
+ self._route_keys.append(route_key)
+
+ def _get_base_path(self) -> str:
+ raise NotImplementedError()
+
@staticmethod
- def _compile_regex(rule: str):
+ def _has_debug(debug: bool | None = None) -> bool:
+ # It might have been explicitly switched off (debug=False)
+ return debug if debug is not None else powertools_dev_is_set()
+
+ @staticmethod
+ def _compile_regex(rule: str, base_regex: str = _ROUTE_REGEX):
"""Precompile regex pattern
Logic
@@ -542,36 +2765,34 @@ def _compile_regex(rule: str):
NOTE: See #520 for context
"""
rule_regex: str = re.sub(_DYNAMIC_ROUTE_PATTERN, _NAMED_GROUP_BOUNDARY_PATTERN, rule)
- return re.compile("^{}$".format(rule_regex))
+ return re.compile(base_regex.format(rule_regex))
- def _to_proxy_event(self, event: Dict) -> BaseProxyEvent:
+ def _to_proxy_event(self, event: dict) -> BaseProxyEvent:
"""Convert the event dict to the corresponding data class"""
- if self._proxy_type == ProxyEventType.APIGatewayProxyEvent:
- logger.debug("Converting event to API Gateway REST API contract")
- return APIGatewayProxyEvent(event)
- if self._proxy_type == ProxyEventType.APIGatewayProxyEventV2:
- logger.debug("Converting event to API Gateway HTTP API contract")
- return APIGatewayProxyEventV2(event)
- if self._proxy_type == ProxyEventType.LambdaFunctionUrlEvent:
- logger.debug("Converting event to Lambda Function URL contract")
- return LambdaFunctionUrlEvent(event)
- logger.debug("Converting event to ALB contract")
- return ALBEvent(event)
+ event_class, label = _PROXY_EVENT_MAP.get(self._proxy_type, (ALBEvent, "ALB"))
+ logger.debug("Converting event to %s contract", label)
+ return event_class(event, self._json_body_deserializer)
def _resolve(self) -> ResponseBuilder:
"""Resolves the response or return the not found response"""
method = self.current_event.http_method.upper()
path = self._remove_prefix(self.current_event.path)
- for route in self._routes:
+
+ registered_routes = self._static_routes + self._dynamic_routes
+
+ for route in registered_routes:
if method != route.method:
continue
- match_results: Optional[Match] = route.rule.match(path)
+ match_results: Match | None = route.rule.match(path)
if match_results:
logger.debug("Found a registered route. Calling function")
- return self._call_route(route, match_results.groupdict()) # pass fn args
+ # Add matched Route reference into the Resolver context
+ self.append_context(_route=route, _path=path)
- logger.debug(f"No match found for path {path} and method {method}")
- return self._not_found(method)
+ route_keys = self._convert_matches_into_route_keys(match_results)
+ return self._call_route(route, route_keys) # pass fn args
+
+ return self._handle_not_found(method=method, path=path)
def _remove_prefix(self, path: str) -> str:
"""Remove the configured prefix from the path"""
@@ -579,133 +2800,232 @@ def _remove_prefix(self, path: str) -> str:
return path
for prefix in self._strip_prefixes:
- if path == prefix:
- return "/"
- if self._path_starts_with(path, prefix):
- return path[len(prefix) :]
+ if isinstance(prefix, str):
+ if path == prefix:
+ return "/"
+
+ if self._path_starts_with(path, prefix):
+ return path[len(prefix) :]
+
+ if isinstance(prefix, Pattern):
+ path = re.sub(prefix, "", path)
+
+ # When using regexes, we might get into a point where everything is removed
+ # from the string, so we check if it's empty and return /, since there's nothing
+ # else to strip anymore.
+ if not path:
+ return "/"
return path
+ def _convert_matches_into_route_keys(self, match: Match) -> dict[str, str]:
+ """Converts the regex match into a dict of route keys"""
+ return match.groupdict()
+
@staticmethod
def _path_starts_with(path: str, prefix: str):
"""Returns true if the `path` starts with a prefix plus a `/`"""
if not isinstance(prefix, str) or prefix == "":
return False
- return path.startswith(prefix + "/")
+ return path.startswith(f"{prefix}/")
- def _not_found(self, method: str) -> ResponseBuilder:
+ def _handle_not_found(self, method: str, path: str) -> ResponseBuilder:
"""Called when no matching route was found and includes support for the cors preflight response"""
- headers = {}
- if self._cors:
- logger.debug("CORS is enabled, updating headers.")
- headers.update(self._cors.to_dict())
+ logger.debug(f"No match found for path {path} and method {method}")
- if method == "OPTIONS":
- logger.debug("Pre-flight request detected. Returning CORS with null response")
- headers["Access-Control-Allow-Methods"] = ",".join(sorted(self._cors_methods))
- return ResponseBuilder(Response(status_code=204, content_type=None, headers=headers, body=""))
+ def not_found_handler():
+ """Route handler for 404s
- handler = self._lookup_exception_handler(NotFoundError)
- if handler:
- return ResponseBuilder(handler(NotFoundError()))
+ It handles in the following order:
+
+ 1. Pre-flight CORS requests (OPTIONS)
+ 2. Detects and calls custom HTTP 404 handler
+ 3. Returns standard 404 along with CORS headers
+
+ Returns
+ -------
+ Response
+ HTTP 404 response
+ """
+ _headers: dict[str, Any] = {}
+
+ # Pre-flight request? Return immediately to avoid browser error
+ if self._cors and method == "OPTIONS":
+ logger.debug("Pre-flight request detected. Returning CORS with empty response")
+ _headers["Access-Control-Allow-Methods"] = CORSConfig.build_allow_methods(self._cors_methods)
+
+ return Response(status_code=204, content_type=None, headers=_headers, body="")
- return ResponseBuilder(
- Response(
+ # Customer registered 404 route? Call it.
+ custom_not_found_handler = self.exception_handler_manager.lookup_exception_handler(NotFoundError)
+ if custom_not_found_handler:
+ return custom_not_found_handler(NotFoundError())
+
+ # No CORS and no custom 404 fn? Default response
+ return Response(
status_code=HTTPStatus.NOT_FOUND.value,
content_type=content_types.APPLICATION_JSON,
- headers=headers,
- body=self._json_dump({"statusCode": HTTPStatus.NOT_FOUND.value, "message": "Not found"}),
+ headers=_headers,
+ body={"statusCode": HTTPStatus.NOT_FOUND.value, "message": "Not found"},
)
+
+ # We create a route to trigger entire request chain (middleware+exception handlers)
+ route = Route(
+ rule=self._compile_regex(r".*"),
+ method=method,
+ path=path,
+ func=not_found_handler,
+ cors=self._cors_enabled,
+ compress=False,
)
- def _call_route(self, route: Route, args: Dict[str, str]) -> ResponseBuilder:
+ # Add matched Route reference into the Resolver context
+ self.append_context(_route=route, _path=path)
+
+ # Kick-off request chain:
+ # -> exception_handlers()
+ # --> middlewares()
+ # ---> not_found_route()
+ return self._call_route(route=route, route_arguments={})
+
+ def _call_route(self, route: Route, route_arguments: dict[str, str]) -> ResponseBuilder:
"""Actually call the matching route with any provided keyword arguments."""
try:
- return ResponseBuilder(self._to_response(route.func(**args)), route)
+ # Reset Processed stack for Middleware (for debugging purposes)
+ self._reset_processed_stack()
+
+ return self._response_builder_class(
+ response=self._to_response( # type: ignore[arg-type]
+ route(router_middlewares=self._router_middlewares, app=self, route_arguments=route_arguments),
+ ),
+ serializer=self._serializer,
+ route=route,
+ )
except Exception as exc:
+ # If exception is handled then return the response builder to reduce noise
response_builder = self._call_exception_handler(exc, route)
if response_builder:
return response_builder
+ logger.exception(exc)
if self._debug:
# If the user has turned on debug mode,
- # we'll let the original exception propagate so
+ # we'll let the original exception propagate, so
# they get more information about what went wrong.
- return ResponseBuilder(
- Response(
+ return self._response_builder_class(
+ response=Response(
status_code=500,
content_type=content_types.TEXT_PLAIN,
body="".join(traceback.format_exc()),
),
- route,
+ serializer=self._serializer,
+ route=route,
)
raise
- def not_found(self, func: Optional[Callable] = None):
+ def not_found(self, func: Callable | None = None):
if func is None:
return self.exception_handler(NotFoundError)
return self.exception_handler(NotFoundError)(func)
- def exception_handler(self, exc_class: Type[Exception]):
- def register_exception_handler(func: Callable):
- self._exception_handlers[exc_class] = func
-
- return register_exception_handler
+ def exception_handler(self, exc_class: type[Exception] | list[type[Exception]]):
+ return self.exception_handler_manager.exception_handler(exc_class=exc_class)
- def _lookup_exception_handler(self, exp_type: Type) -> Optional[Callable]:
- # Use "Method Resolution Order" to allow for matching against a base class
- # of an exception
- for cls in exp_type.__mro__:
- if cls in self._exception_handlers:
- return self._exception_handlers[cls]
- return None
-
- def _call_exception_handler(self, exp: Exception, route: Route) -> Optional[ResponseBuilder]:
- handler = self._lookup_exception_handler(type(exp))
+ def _call_exception_handler(self, exp: Exception, route: Route) -> ResponseBuilder | None:
+ handler = self.exception_handler_manager.lookup_exception_handler(type(exp))
if handler:
try:
- return ResponseBuilder(handler(exp), route)
+ return self._response_builder_class(response=handler(exp), serializer=self._serializer, route=route)
except ServiceError as service_error:
exp = service_error
+ if isinstance(exp, RequestValidationError):
+ # For security reasons, we hide msg details (don't leak Python, Pydantic or file names)
+ errors = [{"loc": e["loc"], "type": e["type"]} for e in exp.errors()]
+
+ return self._response_builder_class(
+ response=Response(
+ status_code=HTTPStatus.UNPROCESSABLE_ENTITY,
+ content_type=content_types.APPLICATION_JSON,
+ body={"statusCode": HTTPStatus.UNPROCESSABLE_ENTITY, "detail": errors},
+ ),
+ serializer=self._serializer,
+ route=route,
+ )
+
+ # OpenAPIResponseValidationMiddleware will only raise ResponseValidationError when
+ # 'self._response_validation_error_http_code' is not None or
+ # when route has custom_response_validation_http_code
+ if isinstance(exp, ResponseValidationError):
+ # route validation must take precedence over app validation
+ http_code = route.custom_response_validation_http_code or self._response_validation_error_http_code
+ errors = [{"loc": e["loc"], "type": e["type"]} for e in exp.errors()]
+ return self._response_builder_class(
+ response=Response(
+ status_code=http_code.value,
+ content_type=content_types.APPLICATION_JSON,
+ body={"statusCode": http_code, "detail": errors},
+ ),
+ serializer=self._serializer,
+ route=route,
+ )
+
+ if isinstance(exp, RequestUnsupportedContentType):
+ errors = [{"loc": e["loc"], "type": e["type"]} for e in exp.errors()]
+ return self._response_builder_class(
+ response=Response(
+ status_code=HTTPStatus.UNSUPPORTED_MEDIA_TYPE,
+ content_type=content_types.APPLICATION_JSON,
+ body={"statusCode": HTTPStatus.UNSUPPORTED_MEDIA_TYPE, "detail": errors},
+ ),
+ serializer=self._serializer,
+ route=route,
+ )
+
if isinstance(exp, ServiceError):
- return ResponseBuilder(
- Response(
+ return self._response_builder_class(
+ response=Response(
status_code=exp.status_code,
content_type=content_types.APPLICATION_JSON,
- body=self._json_dump({"statusCode": exp.status_code, "message": exp.msg}),
+ body={"statusCode": exp.status_code, "message": exp.msg},
),
- route,
+ serializer=self._serializer,
+ route=route,
)
return None
- def _to_response(self, result: Union[Dict, Response]) -> Response:
+ def _to_response(self, result: dict | tuple | Response | BedrockResponse) -> Response | BedrockResponse:
"""Convert the route's result to a Response
- 2 main result types are supported:
+ 3 main result types are supported:
- - Dict[str, Any]: Rest api response with just the Dict to json stringify and content-type is set to
+ - dict[str, Any]: Rest api response with just the dict to json stringify and content-type is set to
application/json
+ - tuple[dict, int]: Same dict handling as above but with the option of including a status code
- Response: returned as is, and allows for more flexibility
"""
- if isinstance(result, Response):
+ if isinstance(result, (Response, BedrockResponse)):
return result
+ elif isinstance(result, tuple) and len(result) == 2:
+ # Unpack result dict and status code from tuple
+ result, status_code = result
+ else:
+ # Use the route's status_code if available, otherwise default to 200
+ route: Route | None = self.context.get("_route")
+ status_code = route.status_code if route else HTTPStatus.OK
logger.debug("Simple response detected, serializing return before constructing final response")
return Response(
- status_code=200,
+ status_code=status_code,
content_type=content_types.APPLICATION_JSON,
- body=self._json_dump(result),
+ body=result,
)
- def _json_dump(self, obj: Any) -> str:
- return self._serializer(obj)
-
- def include_router(self, router: "Router", prefix: Optional[str] = None) -> None:
- """Adds all routes defined in a router
+ def include_router(self, router: Router, prefix: str | None = None) -> None:
+ """Adds all routes and context defined in a router
Parameters
----------
@@ -718,75 +3038,327 @@ def include_router(self, router: "Router", prefix: Optional[str] = None) -> None
# Add reference to parent ApiGatewayResolver to support use cases where people subclass it to add custom logic
router.api_resolver = self
+ logger.debug("Merging App context with Router context")
+ self.context.update(**router.context)
+
+ logger.debug("Appending Router middlewares into App middlewares.")
+ self._router_middlewares = self._router_middlewares + router._router_middlewares
+
+ logger.debug("Appending Router exception_handler into App exception_handler.")
+ self.exception_handler_manager.update_exception_handlers(router._exception_handlers)
+
+ # use pointer to allow context clearance after event is processed e.g., resolve(evt, ctx)
+ router.context = self.context
+
+ # Iterate through the routes defined in the router to configure and apply middlewares for each route
for route, func in router._routes.items():
+ new_route = route
+
if prefix:
rule = route[0]
rule = prefix if rule == "/" else f"{prefix}{rule}"
- route = (rule, *route[1:])
+ new_route = (rule, *route[1:])
+
+ # Middlewares are stored by route separately - must grab them to include
+ # Middleware store the route without prefix, so we must not include prefix when grabbing
+ middlewares = router._routes_with_middleware.get(route)
+
+ # Need to use "type: ignore" here since mypy does not like a named parameter after
+ # tuple expansion since may cause duplicate named parameters in the function signature.
+ # In this case this is not possible since the tuple expansion is from a hashable source
+ # and the `middlewares` list is a non-hashable structure so will never be included.
+ # Still need to ignore for mypy checks or will cause failures (false-positive)
+ self.route(*new_route, middlewares=middlewares)(func) # type: ignore
+
+ @staticmethod
+ def _get_fields_from_routes(routes: Sequence[Route]) -> list[ModelField]:
+ """
+ Returns a list of fields from the routes
+ """
+
+ from aws_lambda_powertools.event_handler.openapi.compat import ModelField
+ from aws_lambda_powertools.event_handler.openapi.dependant import (
+ get_flat_params,
+ )
+
+ body_fields_from_routes: list[ModelField] = []
+ responses_from_routes: list[ModelField] = []
+ request_fields_from_routes: list[ModelField] = []
+
+ for route in routes:
+ if route.body_field:
+ if not isinstance(route.body_field, ModelField):
+ raise AssertionError("A request body must be a Pydantic Field")
+ body_fields_from_routes.append(route.body_field)
+
+ params = get_flat_params(route.dependant)
+ request_fields_from_routes.extend(params)
- self.route(*route)(func)
+ if route.dependant.return_param:
+ responses_from_routes.append(route.dependant.return_param)
+
+ if route.dependant.response_extra_models:
+ responses_from_routes.extend(route.dependant.response_extra_models)
+
+ return list(
+ responses_from_routes + request_fields_from_routes + body_fields_from_routes,
+ )
class Router(BaseRouter):
"""Router helper class to allow splitting ApiGatewayResolver into multiple files"""
def __init__(self):
- self._routes: Dict[tuple, Callable] = {}
- self.api_resolver: Optional[BaseRouter] = None
+ self._routes: dict[tuple, Callable] = {}
+ self._routes_with_middleware: dict[tuple, list[Callable]] = {}
+ self.api_resolver: BaseRouter | None = None
+ self.context = {} # early init as customers might add context before event resolution
+ self._exception_handlers: dict[type, Callable] = {}
def route(
self,
rule: str,
- method: Union[str, Union[List[str], Tuple[str]]],
- cors: Optional[bool] = None,
+ method: str | list[str] | tuple[str],
+ cors: bool | None = None,
compress: bool = False,
- cache_control: Optional[str] = None,
- ):
- def register_route(func: Callable):
- # Convert methods to tuple. It needs to be hashable as its part of the self._routes dict key
+ cache_control: str | None = None,
+ summary: str | None = None,
+ description: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+ response_description: str | None = DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ tags: list[str] | None = None,
+ operation_id: str | None = None,
+ include_in_schema: bool = True,
+ security: list[dict[str, list[str]]] | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ deprecated: bool = False,
+ enable_validation: bool | None = None,
+ custom_response_validation_http_code: int | HTTPStatus | None = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ middlewares: list[Callable[..., Any]] | None = None,
+ ) -> Callable[[AnyCallableT], AnyCallableT]:
+ def register_route(func: AnyCallableT) -> AnyCallableT:
+ # All dict keys needs to be hashable. So we'll need to do some conversions:
methods = (method,) if isinstance(method, str) else tuple(method)
- self._routes[(rule, methods, cors, compress, cache_control)] = func
+ frozen_responses = _FrozenDict(responses) if responses else None
+ frozen_tags = frozenset(tags) if tags else None
+ frozen_security = _FrozenListDict(security) if security else None
+ frozen_openapi_extensions = _FrozenDict(openapi_extensions) if openapi_extensions else None
+
+ route_key = (
+ rule,
+ methods,
+ cors,
+ compress,
+ cache_control,
+ summary,
+ description,
+ frozen_responses,
+ response_description,
+ frozen_tags,
+ operation_id,
+ include_in_schema,
+ frozen_security,
+ frozen_openapi_extensions,
+ deprecated,
+ enable_validation,
+ custom_response_validation_http_code,
+ status_code,
+ )
+
+ # Collate Middleware for routes
+ if middlewares is not None:
+ for handler in middlewares:
+ if self._routes_with_middleware.get(route_key) is None:
+ self._routes_with_middleware[route_key] = [handler]
+ else:
+ self._routes_with_middleware[route_key].append(handler)
+ else:
+ self._routes_with_middleware[route_key] = []
+
+ self._routes[route_key] = func
+
+ return func
return register_route
+ def exception_handler(self, exc_class: type[Exception] | list[type[Exception]]):
+ def register_exception_handler(func: Callable):
+ if isinstance(exc_class, list):
+ for exp in exc_class:
+ self._exception_handlers[exp] = func
+ else:
+ self._exception_handlers[exc_class] = func
+ return func
+
+ return register_exception_handler
+
class APIGatewayRestResolver(ApiGatewayResolver):
- current_event: APIGatewayProxyEvent
+ """Amazon API Gateway REST and HTTP API v1 payload resolver"""
- def __init__(
+ current_event: APIGatewayProxyEvent
+ _proxy_event_type = ProxyEventType.APIGatewayProxyEvent
+
+ def _get_base_path(self) -> str:
+ # 3 different scenarios:
+ #
+ # 1. SAM local: even though a stage variable is sent to the Lambda function, it's not used in the path
+ # 2. API Gateway REST API: stage variable is used in the path
+ # 3. API Gateway REST Custom Domain: stage variable is not used in the path
+ #
+ # To solve the 3 scenarios, we try to match the beginning of the path with the stage variable
+ stage = self.current_event.request_context.stage
+ if stage and stage != "$default" and self.current_event.request_context.path.startswith(f"/{stage}"):
+ return f"/{stage}"
+ return ""
+
+ # override route to ignore trailing "/" in routes for REST API
+ def route(
self,
- cors: Optional[CORSConfig] = None,
- debug: Optional[bool] = None,
- serializer: Optional[Callable[[Dict], str]] = None,
- strip_prefixes: Optional[List[str]] = None,
- ):
- """Amazon API Gateway REST and HTTP API v1 payload resolver"""
- super().__init__(ProxyEventType.APIGatewayProxyEvent, cors, debug, serializer, strip_prefixes)
+ rule: str,
+ method: str | list[str] | tuple[str],
+ cors: bool | None = None,
+ compress: bool = False,
+ cache_control: str | None = None,
+ summary: str | None = None,
+ description: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+ response_description: str = DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ tags: list[str] | None = None,
+ operation_id: str | None = None,
+ include_in_schema: bool = True,
+ security: list[dict[str, list[str]]] | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ deprecated: bool = False,
+ enable_validation: bool | None = None,
+ custom_response_validation_http_code: int | HTTPStatus | None = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ middlewares: list[Callable[..., Any]] | None = None,
+ ) -> Callable[[AnyCallableT], AnyCallableT]:
+ # NOTE: see #1552 for more context.
+ return super().route(
+ rule.rstrip("/"),
+ method,
+ cors,
+ compress,
+ cache_control,
+ summary,
+ description,
+ responses,
+ response_description,
+ tags,
+ operation_id,
+ include_in_schema,
+ security,
+ openapi_extensions,
+ deprecated,
+ enable_validation,
+ custom_response_validation_http_code,
+ status_code,
+ middlewares,
+ )
+
+ # Override _compile_regex to exclude trailing slashes for route resolution
+ @staticmethod
+ def _compile_regex(rule: str, base_regex: str = _ROUTE_REGEX):
+ return super(APIGatewayRestResolver, APIGatewayRestResolver)._compile_regex(rule, "^{}/*$")
class APIGatewayHttpResolver(ApiGatewayResolver):
- current_event: APIGatewayProxyEventV2
+ """Amazon API Gateway HTTP API v2 payload resolver"""
- def __init__(
- self,
- cors: Optional[CORSConfig] = None,
- debug: Optional[bool] = None,
- serializer: Optional[Callable[[Dict], str]] = None,
- strip_prefixes: Optional[List[str]] = None,
- ):
- """Amazon API Gateway HTTP API v2 payload resolver"""
- super().__init__(ProxyEventType.APIGatewayProxyEventV2, cors, debug, serializer, strip_prefixes)
+ current_event: APIGatewayProxyEventV2
+ _proxy_event_type = ProxyEventType.APIGatewayProxyEventV2
+
+ def _get_base_path(self) -> str:
+ # 3 different scenarios:
+ #
+ # 1. SAM local: even though a stage variable is sent to the Lambda function, it's not used in the path
+ # 2. API Gateway HTTP API: stage variable is used in the path
+ # 3. API Gateway HTTP Custom Domain: stage variable is not used in the path
+ #
+ # To solve the 3 scenarios, we try to match the beginning of the path with the stage variable
+ stage = self.current_event.request_context.stage
+ if stage and stage != "$default" and self.current_event.request_context.http.path.startswith(f"/{stage}"):
+ return f"/{stage}"
+ return ""
class ALBResolver(ApiGatewayResolver):
+ """Amazon Application Load Balancer (ALB) resolver"""
+
current_event: ALBEvent
+ _proxy_event_type = ProxyEventType.ALBEvent
def __init__(
self,
- cors: Optional[CORSConfig] = None,
- debug: Optional[bool] = None,
- serializer: Optional[Callable[[Dict], str]] = None,
- strip_prefixes: Optional[List[str]] = None,
+ cors: CORSConfig | None = None,
+ debug: bool | None = None,
+ serializer: Callable[[dict], str] | None = None,
+ strip_prefixes: list[str | Pattern] | None = None,
+ enable_validation: bool = False,
+ response_validation_error_http_code: HTTPStatus | int | None = None,
+ json_body_deserializer: Callable[[str], dict] | None = None,
+ decode_query_parameters: bool = False,
):
- """Amazon Application Load Balancer (ALB) resolver"""
- super().__init__(ProxyEventType.ALBEvent, cors, debug, serializer, strip_prefixes)
+ """Amazon Application Load Balancer (ALB) resolver
+
+
+ Parameters
+ ----------
+ cors: CORSConfig
+ Optionally configure and enabled CORS. Not each route will need to have to cors=True
+ debug: bool | None
+ Enables debug mode, by default False. Can be also be enabled by "POWERTOOLS_DEV"
+ environment variable
+ serializer: Callable, optional
+ function to serialize `obj` to a JSON formatted `str`, by default json.dumps
+ strip_prefixes: list[str | Pattern], optional
+ optional list of prefixes to be removed from the request path before doing the routing.
+ This is often used with api gateways with multiple custom mappings.
+ Each prefix can be a static string or a compiled regex pattern
+ enable_validation: bool | None
+ Enables validation of the request body against the route schema, by default False.
+ response_validation_error_http_code
+ Sets the returned status code if response is not validated. enable_validation must be True.
+ json_body_deserializer: Callable[[str], dict], optional
+ function to deserialize `str`, `bytes`, `bytearray` containing a JSON document to a Python `dict`,
+ by default json.loads when integrating with EventSource data class
+ decode_query_parameters: bool | None
+ Enables URL-decoding of query parameters (both keys and values), by default False.
+ """
+ super().__init__(
+ cors=cors,
+ debug=debug,
+ serializer=serializer,
+ strip_prefixes=strip_prefixes,
+ enable_validation=enable_validation,
+ response_validation_error_http_code=response_validation_error_http_code,
+ json_body_deserializer=json_body_deserializer,
+ )
+ self.decode_query_parameters = decode_query_parameters
+
+ def _get_base_path(self) -> str:
+ # ALB doesn't have a stage variable, so we just return an empty string
+ return ""
+
+ @override
+ def _to_response(self, result: dict | tuple | Response | BedrockResponse) -> Response | BedrockResponse:
+ """Convert the route's result to a Response
+
+ ALB requires a non-null body otherwise it converts as HTTP 5xx
+ """
+ # ALB doesn't support null body - convert before building the final response
+ if isinstance(result, Response) and result.body is None:
+ logger.debug("ALB doesn't allow None responses; converting to empty string")
+ result.body = ""
+
+ return super()._to_response(result)
+
+ @override
+ def _to_proxy_event(self, event: dict) -> BaseProxyEvent:
+ proxy_event = super()._to_proxy_event(event)
+ if isinstance(proxy_event, ALBEvent):
+ proxy_event.decode_query_parameters = self.decode_query_parameters
+ return proxy_event
diff --git a/aws_lambda_powertools/event_handler/appsync.py b/aws_lambda_powertools/event_handler/appsync.py
index 4ddc51cd102..29c48d71cb1 100644
--- a/aws_lambda_powertools/event_handler/appsync.py
+++ b/aws_lambda_powertools/event_handler/appsync.py
@@ -1,83 +1,85 @@
+from __future__ import annotations
+
+import asyncio
import logging
-from typing import Any, Callable, Optional, Type, TypeVar
+import warnings
+from typing import TYPE_CHECKING, Any
+from aws_lambda_powertools.event_handler.exception_handling import ExceptionHandlerManager
+from aws_lambda_powertools.event_handler.graphql_appsync.exceptions import InvalidBatchResponse, ResolverNotFoundError
+from aws_lambda_powertools.event_handler.graphql_appsync.router import Router
from aws_lambda_powertools.utilities.data_classes import AppSyncResolverEvent
-from aws_lambda_powertools.utilities.typing import LambdaContext
-
-logger = logging.getLogger(__name__)
-
-AppSyncResolverEventT = TypeVar("AppSyncResolverEventT", bound=AppSyncResolverEvent)
+if TYPE_CHECKING:
+ from collections.abc import Callable
-class BaseRouter:
- current_event: AppSyncResolverEventT # type: ignore[valid-type]
- lambda_context: LambdaContext
+ from aws_lambda_powertools.utilities.typing import LambdaContext
- def __init__(self):
- self._resolvers: dict = {}
-
- def resolver(self, type_name: str = "*", field_name: Optional[str] = None):
- """Registers the resolver for field_name
+from aws_lambda_powertools.warnings import PowertoolsUserWarning
- Parameters
- ----------
- type_name : str
- Type name
- field_name : str
- Field name
- """
-
- def register_resolver(func):
- logger.debug(f"Adding resolver `{func.__name__}` for field `{type_name}.{field_name}`")
- self._resolvers[f"{type_name}.{field_name}"] = {"func": func}
- return func
-
- return register_resolver
+logger = logging.getLogger(__name__)
-class AppSyncResolver(BaseRouter):
+class AppSyncResolver(Router):
"""
- AppSync resolver decorator
+ AppSync GraphQL API Resolver
Example
-------
-
- **Sample usage**
-
- from aws_lambda_powertools.event_handler import AppSyncResolver
-
- app = AppSyncResolver()
-
- @app.resolver(type_name="Query", field_name="listLocations")
- def list_locations(page: int = 0, size: int = 10) -> list:
- # Your logic to fetch locations with arguments passed in
- return [{"id": 100, "name": "Smooth Grooves"}]
-
- @app.resolver(type_name="Merchant", field_name="extraInfo")
- def get_extra_info() -> dict:
- # Can use "app.current_event.source" to filter within the parent context
- account_type = app.current_event.source["accountType"]
- method = "BTC" if account_type == "NEW" else "USD"
- return {"preferredPaymentMethod": method}
-
- @app.resolver(field_name="commonField")
- def common_field() -> str:
- # Would match all fieldNames matching 'commonField'
- return str(uuid.uuid4())
+ ```python
+ from aws_lambda_powertools.event_handler import AppSyncResolver
+
+ app = AppSyncResolver()
+
+ @app.resolver(type_name="Query", field_name="listLocations")
+ def list_locations(page: int = 0, size: int = 10) -> list:
+ # Your logic to fetch locations with arguments passed in
+ return [{"id": 100, "name": "Smooth Grooves"}]
+
+ @app.resolver(type_name="Merchant", field_name="extraInfo")
+ def get_extra_info() -> dict:
+ # Can use "app.current_event.source" to filter within the parent context
+ account_type = app.current_event.source["accountType"]
+ method = "BTC" if account_type == "NEW" else "USD"
+ return {"preferredPaymentMethod": method}
+
+ @app.resolver(field_name="commonField")
+ def common_field() -> str:
+ # Would match all fieldNames matching 'commonField'
+ return str(uuid.uuid4())
+ ```
"""
def __init__(self):
+ """
+ Initialize a new instance of the AppSyncResolver.
+ """
super().__init__()
+ self.context = {} # early init as customers might add context before event resolution
+ self.exception_handler_manager = ExceptionHandlerManager()
+ self._exception_handlers: dict[type, Callable] = {}
+
+ def __call__(
+ self,
+ event: dict,
+ context: LambdaContext,
+ data_model: type[AppSyncResolverEvent] = AppSyncResolverEvent,
+ ) -> Any:
+ """Implicit lambda handler which internally calls `resolve`"""
+ return self.resolve(event, context, data_model)
def resolve(
- self, event: dict, context: LambdaContext, data_model: Type[AppSyncResolverEvent] = AppSyncResolverEvent
+ self,
+ event: dict | list[dict],
+ context: LambdaContext,
+ data_model: type[AppSyncResolverEvent] = AppSyncResolverEvent,
) -> Any:
- """Resolve field_name
+ """Resolves the response based on the provide event and decorator routes
Parameters
----------
- event : dict
- Lambda event
+ event : dict | list[Dict]
+ Lambda event either coming from batch processing endpoint or from standard processing endpoint
context : LambdaContext
Lambda context
data_model:
@@ -114,7 +116,7 @@ def handler(event, context: LambdaContext):
class MyCustomModel(AppSyncResolverEvent):
@property
def country_viewer(self) -> str:
- return self.request_headers.get("cloudfront-viewer-country")
+ return self.request_headers.get("cloudfront-viewer-country", "")
@app.resolver(field_name="listLocations")
@@ -141,40 +143,228 @@ def lambda_handler(event, context):
ValueError
If we could not find a field resolver
"""
- # Maintenance: revisit generics/overload to fix [attr-defined] in mypy usage
- BaseRouter.current_event = data_model(event)
- BaseRouter.lambda_context = context
- resolver = self._get_resolver(BaseRouter.current_event.type_name, BaseRouter.current_event.field_name)
- return resolver(**BaseRouter.current_event.arguments)
- def _get_resolver(self, type_name: str, field_name: str) -> Callable:
- """Get resolver for field_name
+ self.lambda_context = context
+ Router.lambda_context = context
+
+ try:
+ if isinstance(event, list):
+ Router.current_batch_event = [data_model(e) for e in event]
+ response = self._call_batch_resolver(event=event, data_model=data_model)
+ else:
+ Router.current_event = data_model(event)
+ response = self._call_single_resolver(event=event, data_model=data_model)
+ except Exception as exp:
+ response_builder = self.exception_handler_manager.lookup_exception_handler(type(exp))
+ if response_builder:
+ return response_builder(exp)
+ raise
+
+ # We don't clear the context for coroutines because we don't have control over the event loop.
+ # If we clean the context immediately, it might not be available when the coroutine is actually executed.
+ # For single async operations, the context should be cleaned up manually after the coroutine completes.
+ # See: https://github.com/aws-powertools/powertools-lambda-python/issues/5290
+ # REVIEW: Review this support in Powertools V4
+ if not asyncio.iscoroutine(response):
+ self.clear_context()
+
+ return response
+
+ def _call_single_resolver(self, event: dict, data_model: type[AppSyncResolverEvent]) -> Any:
+ """Call single event resolver
Parameters
----------
- type_name : str
- Type name
- field_name : str
- Field name
+ event : dict
+ Event
+ data_model : type[AppSyncResolverEvent]
+ Data_model to decode AppSync event, by default it is of AppSyncResolverEvent type or subclass of it
+ """
+
+ logger.debug("Processing direct resolver event")
+
+ self.current_event = data_model(event)
+ resolver = self._resolver_registry.find_resolver(self.current_event.type_name, self.current_event.field_name)
+ if not resolver:
+ raise ValueError(f"No resolver found for '{self.current_event.type_name}.{self.current_event.field_name}'")
+ return resolver["func"](**self.current_event.arguments)
+
+ def _call_sync_batch_resolver(
+ self,
+ resolver: Callable,
+ raise_on_error: bool = False,
+ aggregate: bool = True,
+ ) -> list[Any]:
+ """
+ Calls a synchronous batch resolver function for each event in the current batch.
+
+ Parameters
+ ----------
+ resolver: Callable
+ The callable function to resolve events.
+ raise_on_error: bool
+ A flag indicating whether to raise an error when processing batches
+ with failed items. Defaults to False, which means errors are handled without raising exceptions.
+ aggregate: bool
+ A flag indicating whether the batch items should be processed at once or individually.
+ If True (default), the batch resolver will process all items in the batch as a single event.
+ If False, the batch resolver will process each item in the batch individually.
Returns
-------
- Callable
- callable function and configuration
+ list[Any]
+ A list of results corresponding to the resolved events.
"""
- full_name = f"{type_name}.{field_name}"
- resolver = self._resolvers.get(full_name, self._resolvers.get(f"*.{field_name}"))
- if not resolver:
- raise ValueError(f"No resolver found for '{full_name}'")
- return resolver["func"]
- def __call__(
- self, event: dict, context: LambdaContext, data_model: Type[AppSyncResolverEvent] = AppSyncResolverEvent
- ) -> Any:
- """Implicit lambda handler which internally calls `resolve`"""
- return self.resolve(event, context, data_model)
+ logger.debug(f"Graceful error handling flag {raise_on_error=}")
+
+ # Checks whether the entire batch should be processed at once
+ if aggregate:
+ # Process the entire batch
+ response = resolver(event=self.current_batch_event)
+
+ if not isinstance(response, list):
+ raise InvalidBatchResponse("The response must be a List when using batch resolvers")
+
+ return response
+
+ # Non aggregated events, so we call this event list x times
+ # Stop on first exception we encounter
+ if raise_on_error:
+ return [
+ resolver(event=appconfig_event, **appconfig_event.arguments)
+ for appconfig_event in self.current_batch_event
+ ]
+
+ # By default, we gracefully append `None` for any records that failed processing
+ results = []
+ for idx, event in enumerate(self.current_batch_event):
+ try:
+ results.append(resolver(event=event, **event.arguments))
+ except Exception:
+ logger.debug(f"Failed to process event number {idx} from field '{event.info.field_name}'")
+ results.append(None)
+
+ return results
+
+ async def _call_async_batch_resolver(
+ self,
+ resolver: Callable,
+ raise_on_error: bool = False,
+ aggregate: bool = True,
+ ) -> list[Any]:
+ """
+ Asynchronously call a batch resolver for each event in the current batch.
+
+ Parameters
+ ----------
+ resolver: Callable
+ The asynchronous resolver function.
+ raise_on_error: bool
+ A flag indicating whether to raise an error when processing batches
+ with failed items. Defaults to False, which means errors are handled without raising exceptions.
+ aggregate: bool
+ A flag indicating whether the batch items should be processed at once or individually.
+ If True (default), the batch resolver will process all items in the batch as a single event.
+ If False, the batch resolver will process each item in the batch individually.
+
+ Returns
+ -------
+ list[Any]
+ A list of results corresponding to the resolved events.
+ """
+
+ logger.debug(f"Graceful error handling flag {raise_on_error=}")
+
+ # Checks whether the entire batch should be processed at once
+ if aggregate:
+ # Process the entire batch
+ ret = await resolver(event=self.current_batch_event)
+ if not isinstance(ret, list):
+ raise InvalidBatchResponse("The response must be a List when using batch resolvers")
+
+ return ret
+
+ response: list = []
+
+ # Prime coroutines
+ tasks = [resolver(event=e, **e.arguments) for e in self.current_batch_event]
+
+ # Aggregate results or raise at first error
+ if raise_on_error:
+ response.extend(await asyncio.gather(*tasks))
+ return response
+
+ # Aggregate results and exceptions, then filter them out
+ # Use `None` upon exception for graceful error handling at GraphQL engine level
+ #
+ # NOTE: asyncio.gather(return_exceptions=True) catches and includes exceptions in the results
+ # this will become useful when we support exception handling in AppSync resolver
+ results = await asyncio.gather(*tasks, return_exceptions=True)
+ response.extend(None if isinstance(ret, Exception) else ret for ret in results)
+
+ return response
- def include_router(self, router: "Router") -> None:
+ def _call_batch_resolver(self, event: list[dict], data_model: type[AppSyncResolverEvent]) -> list[Any]:
+ """Call batch event resolver for sync and async methods
+
+ Parameters
+ ----------
+ event : list[dict]
+ Batch event
+ data_model : type[AppSyncResolverEvent]
+ Data_model to decode AppSync event, by default AppSyncResolverEvent or a subclass
+
+ Returns
+ -------
+ list[Any]
+ Results of the resolver execution.
+
+ Raises
+ ------
+ InconsistentPayloadError:
+ When all events in the batch do not have the same fieldName.
+
+ ResolverNotFoundError:
+ When no resolver is found for the specified type and field.
+ """
+ logger.debug("Processing batch resolver event")
+
+ self.current_batch_event = [data_model(e) for e in event]
+ type_name, field_name = self.current_batch_event[0].type_name, self.current_batch_event[0].field_name
+
+ resolver = self._batch_resolver_registry.find_resolver(type_name, field_name)
+ async_resolver = self._async_batch_resolver_registry.find_resolver(type_name, field_name)
+
+ if resolver and async_resolver:
+ warnings.warn(
+ f"Both synchronous and asynchronous resolvers found for the same event and field."
+ f"The synchronous resolver takes precedence. Executing: {resolver['func'].__name__}",
+ stacklevel=2,
+ category=PowertoolsUserWarning,
+ )
+
+ if resolver:
+ logger.debug(f"Found sync resolver. {resolver=}, {field_name=}")
+ return self._call_sync_batch_resolver(
+ resolver=resolver["func"],
+ raise_on_error=resolver["raise_on_error"],
+ aggregate=resolver["aggregate"],
+ )
+
+ if async_resolver:
+ logger.debug(f"Found async resolver. {resolver=}, {field_name=}")
+ return asyncio.run(
+ self._call_async_batch_resolver(
+ resolver=async_resolver["func"],
+ raise_on_error=async_resolver["raise_on_error"],
+ aggregate=async_resolver["aggregate"],
+ ),
+ )
+
+ raise ResolverNotFoundError(f"No resolver found for '{type_name}.{field_name}'")
+
+ def include_router(self, router: Router) -> None:
"""Adds all resolvers defined in a router
Parameters
@@ -182,9 +372,129 @@ def include_router(self, router: "Router") -> None:
router : Router
A router containing a dict of field resolvers
"""
- self._resolvers.update(router._resolvers)
+ # Merge app and router context
+ logger.debug("Merging router and app context")
+ self.context.update(**router.context)
-class Router(BaseRouter):
- def __init__(self):
- super().__init__()
+ # use pointer to allow context clearance after event is processed e.g., resolve(evt, ctx)
+ router.context = self.context
+
+ logger.debug("Merging router resolver registries")
+ self._resolver_registry.merge(router._resolver_registry)
+ self._batch_resolver_registry.merge(router._batch_resolver_registry)
+ self._async_batch_resolver_registry.merge(router._async_batch_resolver_registry)
+
+ def resolver(self, type_name: str = "*", field_name: str | None = None) -> Callable:
+ """Registers direct resolver function for GraphQL type and field name.
+
+ Parameters
+ ----------
+ type_name : str, optional
+ GraphQL type e.g., Query, Mutation, by default "*" meaning any
+ field_name : Optional[str], optional
+ GraphQL field e.g., getTodo, createTodo, by default None
+
+ Returns
+ -------
+ Callable
+ Registered resolver
+
+ Example
+ -------
+
+ ```python
+ from aws_lambda_powertools.event_handler import AppSyncResolver
+
+ from typing import TypedDict
+
+ app = AppSyncResolver()
+
+ class Todo(TypedDict, total=False):
+ id: str
+ userId: str
+ title: str
+ completed: bool
+
+ # resolve any GraphQL `getTodo` queries
+ # arguments are injected as function arguments as-is
+ @app.resolver(type_name="Query", field_name="getTodo")
+ def get_todo(id: str = "", status: str = "open") -> Todo:
+ todos: Response = requests.get(f"https://jsonplaceholder.typicode.com/todos/{id}")
+ todos.raise_for_status()
+
+ return todos.json()
+
+ def lambda_handler(event, context):
+ return app.resolve(event, context)
+ ```
+ """
+ return self._resolver_registry.register(field_name=field_name, type_name=type_name)
+
+ def batch_resolver(
+ self,
+ type_name: str = "*",
+ field_name: str | None = None,
+ raise_on_error: bool = False,
+ aggregate: bool = True,
+ ) -> Callable:
+ """Registers batch resolver function for GraphQL type and field name.
+
+ By default, we handle errors gracefully by returning `None`. If you want
+ to short-circuit and fail the entire batch use `raise_on_error=True`.
+
+ Parameters
+ ----------
+ type_name : str, optional
+ GraphQL type e.g., Query, Mutation, by default "*" meaning any
+ field_name : Optional[str], optional
+ GraphQL field e.g., getTodo, createTodo, by default None
+ raise_on_error : bool, optional
+ Whether to fail entire batch upon error, or handle errors gracefully (None), by default False
+ aggregate: bool
+ A flag indicating whether the batch items should be processed at once or individually.
+ If True (default), the batch resolver will process all items in the batch as a single event.
+ If False, the batch resolver will process each item in the batch individually.
+
+ Returns
+ -------
+ Callable
+ Registered resolver
+ """
+ return self._batch_resolver_registry.register(
+ field_name=field_name,
+ type_name=type_name,
+ raise_on_error=raise_on_error,
+ aggregate=aggregate,
+ )
+
+ def async_batch_resolver(
+ self,
+ type_name: str = "*",
+ field_name: str | None = None,
+ raise_on_error: bool = False,
+ aggregate: bool = True,
+ ) -> Callable:
+ return self._async_batch_resolver_registry.register(
+ field_name=field_name,
+ type_name=type_name,
+ raise_on_error=raise_on_error,
+ aggregate=aggregate,
+ )
+
+ def exception_handler(self, exc_class: type[Exception] | list[type[Exception]]):
+ """
+ A decorator function that registers a handler for one or more exception types.
+
+ Parameters
+ ----------
+ exc_class (type[Exception] | list[type[Exception]])
+ A single exception type or a list of exception types.
+
+ Returns
+ -------
+ Callable:
+ A decorator function that registers the exception handler.
+ """
+
+ return self.exception_handler_manager.exception_handler(exc_class=exc_class)
diff --git a/aws_lambda_powertools/event_handler/bedrock_agent.py b/aws_lambda_powertools/event_handler/bedrock_agent.py
new file mode 100644
index 00000000000..a49ba38c214
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/bedrock_agent.py
@@ -0,0 +1,447 @@
+from __future__ import annotations
+
+import json
+from typing import TYPE_CHECKING, Any
+
+from typing_extensions import override
+
+from aws_lambda_powertools.event_handler import ApiGatewayResolver
+from aws_lambda_powertools.event_handler.api_gateway import (
+ BedrockResponse,
+ ProxyEventType,
+ ResponseBuilder,
+)
+from aws_lambda_powertools.event_handler.openapi.constants import (
+ DEFAULT_API_VERSION,
+ DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ DEFAULT_OPENAPI_VERSION,
+ DEFAULT_STATUS_CODE,
+)
+
+if TYPE_CHECKING:
+ from collections.abc import Callable
+ from http import HTTPStatus
+ from re import Match
+
+ from aws_lambda_powertools.event_handler.openapi.models import Contact, License, SecurityScheme, Server, Tag
+ from aws_lambda_powertools.event_handler.openapi.types import OpenAPIResponse
+ from aws_lambda_powertools.utilities.data_classes import BedrockAgentEvent
+
+
+class BedrockResponseBuilder(ResponseBuilder):
+ """
+ Bedrock Response Builder. This builds the response dict to be returned by Lambda when using Bedrock Agents.
+
+ Since the payload format is different from the standard API Gateway Proxy event, we override the build method.
+ """
+
+ @override
+ def build(self, event: BedrockAgentEvent, *args) -> dict[str, Any]:
+ body = self.response.body
+ if self.response.is_json() and not isinstance(self.response.body, str):
+ body = self.serializer(self.response.body)
+
+ response = {
+ "messageVersion": "1.0",
+ "response": {
+ "actionGroup": event.action_group,
+ "apiPath": event.api_path,
+ "httpMethod": event.http_method,
+ "httpStatusCode": self.response.status_code,
+ "responseBody": {
+ self.response.content_type: {
+ "body": body,
+ },
+ },
+ },
+ }
+
+ # Add Bedrock-specific attributes
+ if isinstance(self.response, BedrockResponse):
+ if self.response.session_attributes:
+ response["sessionAttributes"] = self.response.session_attributes
+
+ if self.response.prompt_session_attributes:
+ response["promptSessionAttributes"] = self.response.prompt_session_attributes
+
+ if self.response.knowledge_bases_configuration:
+ response["knowledgeBasesConfiguration"] = self.response.knowledge_bases_configuration
+
+ return response
+
+
+class BedrockAgentResolver(ApiGatewayResolver):
+ """Bedrock Agent Resolver
+
+ See https://aws.amazon.com/bedrock/agents/ for more information.
+
+ Examples
+ --------
+ Simple example with a custom lambda handler using the Tracer capture_lambda_handler decorator
+
+ ```python
+ from aws_lambda_powertools import Tracer
+ from aws_lambda_powertools.event_handler import BedrockAgentResolver
+
+ tracer = Tracer()
+ app = BedrockAgentResolver()
+
+ @app.get("/claims")
+ def simple_get():
+ return "You have 3 claims"
+
+ @tracer.capture_lambda_handler
+ def lambda_handler(event, context):
+ return app.resolve(event, context)
+ ```
+
+ """
+
+ current_event: BedrockAgentEvent
+
+ def __init__(self, debug: bool = False, enable_validation: bool = True):
+ super().__init__(
+ proxy_type=ProxyEventType.BedrockAgentEvent,
+ cors=None,
+ debug=debug,
+ serializer=None,
+ strip_prefixes=None,
+ enable_validation=enable_validation,
+ json_body_deserializer=None,
+ )
+ self._response_builder_class = BedrockResponseBuilder
+
+ # Note: we need ignore[override] because we are making the optional `description` field required.
+ @override
+ def get( # type: ignore[override]
+ self,
+ rule: str,
+ description: str,
+ cors: bool | None = None,
+ compress: bool = False,
+ cache_control: str | None = None,
+ summary: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+ response_description: str = DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ tags: list[str] | None = None,
+ operation_id: str | None = None,
+ include_in_schema: bool = True,
+ openapi_extensions: dict[str, Any] | None = None,
+ deprecated: bool = False,
+ enable_validation: bool | None = None,
+ custom_response_validation_http_code: int | HTTPStatus | None = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ middlewares: list[Callable[..., Any]] | None = None,
+ ) -> Callable[[Callable[..., Any]], Callable[..., Any]]:
+ security = None
+
+ return super().get(
+ rule,
+ cors,
+ compress,
+ cache_control,
+ summary,
+ description,
+ responses,
+ response_description,
+ tags,
+ operation_id,
+ include_in_schema,
+ security,
+ openapi_extensions,
+ deprecated,
+ enable_validation,
+ custom_response_validation_http_code,
+ status_code,
+ middlewares,
+ )
+
+ # Note: we need ignore[override] because we are making the optional `description` field required.
+ @override
+ def post( # type: ignore[override]
+ self,
+ rule: str,
+ description: str,
+ cors: bool | None = None,
+ compress: bool = False,
+ cache_control: str | None = None,
+ summary: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+ response_description: str = DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ tags: list[str] | None = None,
+ operation_id: str | None = None,
+ include_in_schema: bool = True,
+ openapi_extensions: dict[str, Any] | None = None,
+ deprecated: bool = False,
+ enable_validation: bool | None = None,
+ custom_response_validation_http_code: int | HTTPStatus | None = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ middlewares: list[Callable[..., Any]] | None = None,
+ ):
+ security = None
+
+ return super().post(
+ rule,
+ cors,
+ compress,
+ cache_control,
+ summary,
+ description,
+ responses,
+ response_description,
+ tags,
+ operation_id,
+ include_in_schema,
+ security,
+ openapi_extensions,
+ deprecated,
+ enable_validation,
+ custom_response_validation_http_code,
+ status_code,
+ middlewares,
+ )
+
+ # Note: we need ignore[override] because we are making the optional `description` field required.
+ @override
+ def put( # type: ignore[override]
+ self,
+ rule: str,
+ description: str,
+ cors: bool | None = None,
+ compress: bool = False,
+ cache_control: str | None = None,
+ summary: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+ response_description: str = DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ tags: list[str] | None = None,
+ operation_id: str | None = None,
+ include_in_schema: bool = True,
+ openapi_extensions: dict[str, Any] | None = None,
+ deprecated: bool = False,
+ enable_validation: bool | None = None,
+ custom_response_validation_http_code: int | HTTPStatus | None = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ middlewares: list[Callable[..., Any]] | None = None,
+ ):
+ security = None
+
+ return super().put(
+ rule,
+ cors,
+ compress,
+ cache_control,
+ summary,
+ description,
+ responses,
+ response_description,
+ tags,
+ operation_id,
+ include_in_schema,
+ security,
+ openapi_extensions,
+ deprecated,
+ enable_validation,
+ custom_response_validation_http_code,
+ status_code,
+ middlewares,
+ )
+
+ # Note: we need ignore[override] because we are making the optional `description` field required.
+ @override
+ def patch( # type: ignore[override]
+ self,
+ rule: str,
+ description: str,
+ cors: bool | None = None,
+ compress: bool = False,
+ cache_control: str | None = None,
+ summary: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+ response_description: str = DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ tags: list[str] | None = None,
+ operation_id: str | None = None,
+ include_in_schema: bool = True,
+ openapi_extensions: dict[str, Any] | None = None,
+ deprecated: bool = False,
+ enable_validation: bool | None = None,
+ custom_response_validation_http_code: int | HTTPStatus | None = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ middlewares: list[Callable] | None = None,
+ ):
+ security = None
+
+ return super().patch(
+ rule,
+ cors,
+ compress,
+ cache_control,
+ summary,
+ description,
+ responses,
+ response_description,
+ tags,
+ operation_id,
+ include_in_schema,
+ security,
+ openapi_extensions,
+ deprecated,
+ enable_validation,
+ custom_response_validation_http_code,
+ status_code,
+ middlewares,
+ )
+
+ # Note: we need ignore[override] because we are making the optional `description` field required.
+ @override
+ def delete( # type: ignore[override]
+ self,
+ rule: str,
+ description: str,
+ cors: bool | None = None,
+ compress: bool = False,
+ cache_control: str | None = None,
+ summary: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+ response_description: str = DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ tags: list[str] | None = None,
+ operation_id: str | None = None,
+ include_in_schema: bool = True,
+ openapi_extensions: dict[str, Any] | None = None,
+ deprecated: bool = False,
+ enable_validation: bool | None = None,
+ custom_response_validation_http_code: int | HTTPStatus | None = None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ middlewares: list[Callable[..., Any]] | None = None,
+ ):
+ security = None
+
+ return super().delete(
+ rule,
+ cors,
+ compress,
+ cache_control,
+ summary,
+ description,
+ responses,
+ response_description,
+ tags,
+ operation_id,
+ include_in_schema,
+ security,
+ openapi_extensions,
+ deprecated,
+ enable_validation,
+ custom_response_validation_http_code,
+ status_code,
+ middlewares,
+ )
+
+ @override
+ def _convert_matches_into_route_keys(self, match: Match) -> dict[str, str]:
+ # In Bedrock Agents, all the parameters come inside the "parameters" key, not on the apiPath
+ # So we have to search for route parameters in the parameters key
+ parameters: dict[str, str] = {}
+ if match.groupdict() and self.current_event.parameters:
+ parameters = {parameter["name"]: parameter["value"] for parameter in self.current_event.parameters}
+ return parameters
+
+ @override
+ def get_openapi_json_schema( # type: ignore[override]
+ self,
+ *,
+ title: str = "Powertools API",
+ version: str = DEFAULT_API_VERSION,
+ openapi_version: str = DEFAULT_OPENAPI_VERSION,
+ summary: str | None = None,
+ description: str | None = None,
+ tags: list[Tag | str] | None = None,
+ servers: list[Server] | None = None,
+ terms_of_service: str | None = None,
+ contact: Contact | None = None,
+ license_info: License | None = None,
+ security_schemes: dict[str, SecurityScheme] | None = None,
+ security: list[dict[str, list[str]]] | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ ) -> str:
+ """
+ Returns the OpenAPI schema as a JSON serializable dict.
+ Since Bedrock Agents only support OpenAPI 3.0.0, we convert OpenAPI 3.1.0 schemas
+ and enforce 3.0.0 compatibility for seamless integration.
+
+ Parameters
+ ----------
+ title: str
+ The title of the application.
+ version: str
+ The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API
+ openapi_version: str, default = "3.0.0"
+ The version of the OpenAPI Specification (which the document uses).
+ summary: str, optional
+ A short summary of what the application does.
+ description: str, optional
+ A verbose explanation of the application behavior.
+ tags: list[Tag, str], optional
+ A list of tags used by the specification with additional metadata.
+ servers: list[Server], optional
+ An array of Server Objects, which provide connectivity information to a target server.
+ terms_of_service: str, optional
+ A URL to the Terms of Service for the API. MUST be in the format of a URL.
+ contact: Contact, optional
+ The contact information for the exposed API.
+ license_info: License, optional
+ The license information for the exposed API.
+ security_schemes: dict[str, SecurityScheme]], optional
+ A declaration of the security schemes available to be used in the specification.
+ security: list[dict[str, list[str]]], optional
+ A declaration of which security mechanisms are applied globally across the API.
+
+ Returns
+ -------
+ str
+ The OpenAPI schema as a JSON serializable dict.
+ """
+ from aws_lambda_powertools.event_handler.openapi.compat import model_json
+
+ schema = super().get_openapi_schema(
+ title=title,
+ version=version,
+ openapi_version=openapi_version,
+ summary=summary,
+ description=description,
+ tags=tags,
+ servers=servers,
+ terms_of_service=terms_of_service,
+ contact=contact,
+ license_info=license_info,
+ security_schemes=security_schemes,
+ security=security,
+ openapi_extensions=openapi_extensions,
+ )
+ schema.openapi = "3.0.3"
+
+ # Transform OpenAPI 3.1 into 3.0
+ def inner(yaml_dict):
+ if isinstance(yaml_dict, dict):
+ if "anyOf" in yaml_dict and isinstance((anyOf := yaml_dict["anyOf"]), list):
+ for i, item in enumerate(anyOf):
+ if isinstance(item, dict) and item.get("type") == "null":
+ anyOf.pop(i)
+ yaml_dict["nullable"] = True
+ for value in yaml_dict.values():
+ inner(value)
+ elif isinstance(yaml_dict, list):
+ for item in yaml_dict:
+ inner(item)
+
+ model = json.loads(
+ model_json(
+ schema,
+ by_alias=True,
+ exclude_none=True,
+ indent=2,
+ ),
+ )
+
+ inner(model)
+
+ return json.dumps(model)
diff --git a/aws_lambda_powertools/event_handler/bedrock_agent_function.py b/aws_lambda_powertools/event_handler/bedrock_agent_function.py
new file mode 100644
index 00000000000..7f51f2b9b1b
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/bedrock_agent_function.py
@@ -0,0 +1,254 @@
+from __future__ import annotations
+
+import inspect
+import json
+import logging
+import warnings
+from collections.abc import Callable
+from typing import Any, Literal, TypeVar
+
+from aws_lambda_powertools.utilities.data_classes import BedrockAgentFunctionEvent
+from aws_lambda_powertools.warnings import PowertoolsUserWarning
+
+# Define a generic type for the function
+T = TypeVar("T", bound=Callable[..., Any])
+
+logger = logging.getLogger(__name__)
+
+
+class BedrockFunctionResponse:
+ """Response class for Bedrock Agent Functions.
+
+ Parameters
+ ----------
+ body : Any, optional
+ Response body to be returned to the caller.
+ session_attributes : dict[str, str] or None, optional
+ Session attributes to include in the response for maintaining state.
+ prompt_session_attributes : dict[str, str] or None, optional
+ Prompt session attributes to include in the response.
+ knowledge_bases : list[dict[str, Any]] or None, optional
+ Knowledge bases to include in the response.
+ response_state : {"FAILURE", "REPROMPT"} or None, optional
+ Response state indicating if the function failed or needs reprompting.
+
+ Examples
+ --------
+ >>> @app.tool(description="Function that uses session attributes")
+ >>> def test_function():
+ ... return BedrockFunctionResponse(
+ ... body="Hello",
+ ... session_attributes={"userId": "123"},
+ ... prompt_session_attributes={"lastAction": "login"}
+ ... )
+
+ Notes
+ -----
+ The `response_state` parameter can only be set to "FAILURE" or "REPROMPT".
+ """
+
+ def __init__(
+ self,
+ body: Any = None,
+ session_attributes: dict[str, str] | None = None,
+ prompt_session_attributes: dict[str, str] | None = None,
+ knowledge_bases: list[dict[str, Any]] | None = None,
+ response_state: Literal["FAILURE", "REPROMPT"] | None = None,
+ ) -> None:
+ if response_state and response_state not in ["FAILURE", "REPROMPT"]:
+ raise ValueError("responseState must be 'FAILURE' or 'REPROMPT'")
+
+ self.body = body
+ self.session_attributes = session_attributes
+ self.prompt_session_attributes = prompt_session_attributes
+ self.knowledge_bases = knowledge_bases
+ self.response_state = response_state
+
+
+class BedrockFunctionsResponseBuilder:
+ """
+ Bedrock Functions Response Builder. This builds the response dict to be returned by Lambda
+ when using Bedrock Agent Functions.
+ """
+
+ def __init__(self, result: BedrockFunctionResponse | Any) -> None:
+ self.result = result
+
+ def build(self, event: BedrockAgentFunctionEvent, serializer: Callable) -> dict[str, Any]:
+ result_obj = self.result
+
+ # Extract attributes from BedrockFunctionResponse or use defaults
+ body = getattr(result_obj, "body", result_obj)
+ session_attributes = getattr(result_obj, "session_attributes", None)
+ prompt_session_attributes = getattr(result_obj, "prompt_session_attributes", None)
+ knowledge_bases = getattr(result_obj, "knowledge_bases", None)
+ response_state = getattr(result_obj, "response_state", None)
+
+ # Build base response structure
+ # Per AWS Bedrock documentation, currently only "TEXT" is supported as the responseBody content type
+ # https://docs.aws.amazon.com/bedrock/latest/userguide/agents-lambda.html
+ response: dict[str, Any] = {
+ "messageVersion": "1.0",
+ "response": {
+ "actionGroup": event.action_group,
+ "function": event.function,
+ "functionResponse": {
+ "responseBody": {"TEXT": {"body": serializer(body if body is not None else "")}},
+ },
+ },
+ "sessionAttributes": session_attributes or event.session_attributes or {},
+ "promptSessionAttributes": prompt_session_attributes or event.prompt_session_attributes or {},
+ }
+
+ # Add optional fields when present
+ if response_state:
+ response["response"]["functionResponse"]["responseState"] = response_state
+
+ if knowledge_bases:
+ response["knowledgeBasesConfiguration"] = knowledge_bases
+
+ return response
+
+
+class BedrockAgentFunctionResolver:
+ """Bedrock Agent Function resolver that handles function definitions
+
+ Examples
+ --------
+ ```python
+ from aws_lambda_powertools.event_handler import BedrockAgentFunctionResolver
+
+ app = BedrockAgentFunctionResolver()
+
+ @app.tool(name="get_current_time", description="Gets the current UTC time")
+ def get_current_time():
+ from datetime import datetime
+ return datetime.utcnow().isoformat()
+
+ def lambda_handler(event, context):
+ return app.resolve(event, context)
+ ```
+ """
+
+ context: dict
+
+ def __init__(self, serializer: Callable | None = None) -> None:
+ """
+ Parameters
+ ----------
+ serializer: Callable, optional
+ function to serialize `obj` to a JSON formatted `str`, by default json.dumps
+ """
+ self._tools: dict[str, dict[str, Any]] = {}
+ self.current_event: BedrockAgentFunctionEvent | None = None
+ self.context = {}
+ self._response_builder_class = BedrockFunctionsResponseBuilder
+ self.serializer = serializer or json.dumps
+
+ def tool(
+ self,
+ name: str | None = None,
+ description: str | None = None,
+ ) -> Callable[[T], T]:
+ """Decorator to register a tool function
+
+ Parameters
+ ----------
+ name : str | None
+ Custom name for the tool. If not provided, uses the function name
+ description : str | None
+ Description of what the tool does
+
+ Returns
+ -------
+ Callable
+ Decorator function that registers and returns the original function
+ """
+
+ def decorator(func: T) -> T:
+ function_name = name or func.__name__
+
+ logger.debug(f"Registering {function_name} tool")
+
+ if function_name in self._tools:
+ warnings.warn(
+ f"Tool '{function_name}' already registered. Overwriting with new definition.",
+ PowertoolsUserWarning,
+ stacklevel=2,
+ )
+
+ self._tools[function_name] = {
+ "function": func,
+ "description": description,
+ }
+ return func
+
+ return decorator
+
+ def resolve(self, event: dict[str, Any], context: Any) -> dict[str, Any]:
+ """Resolves the function call from Bedrock Agent event"""
+ try:
+ self.current_event = BedrockAgentFunctionEvent(event)
+ return self._resolve()
+ except KeyError as e:
+ raise ValueError(f"Missing required field: {str(e)}") from e
+
+ def _resolve(self) -> dict[str, Any]:
+ """Internal resolution logic"""
+ if self.current_event is None:
+ raise ValueError("No event to process")
+
+ function_name = self.current_event.function
+
+ logger.debug(f"Resolving {function_name} tool")
+
+ try:
+ parameters: dict[str, Any] = {}
+ # Extract parameters from the event
+ for param in getattr(self.current_event, "parameters", []):
+ param_type = getattr(param, "type", None)
+ if param_type == "string":
+ parameters[param.name] = str(param.value)
+ elif param_type == "integer":
+ try:
+ parameters[param.name] = int(param.value)
+ except (ValueError, TypeError):
+ parameters[param.name] = param.value
+ elif param_type == "number":
+ try:
+ parameters[param.name] = float(param.value)
+ except (ValueError, TypeError):
+ parameters[param.name] = param.value
+ elif param_type == "boolean":
+ if isinstance(param.value, str):
+ parameters[param.name] = param.value.lower() == "true"
+ else:
+ parameters[param.name] = bool(param.value)
+ else: # "array" or any other type
+ parameters[param.name] = param.value
+
+ func = self._tools[function_name]["function"]
+ # Filter parameters to only include those expected by the function
+ sig = inspect.signature(func)
+ valid_params = {name: value for name, value in parameters.items() if name in sig.parameters}
+
+ # Call the function with the filtered parameters
+ result = func(**valid_params)
+
+ self.clear_context()
+
+ # Build and return the response
+ return BedrockFunctionsResponseBuilder(result).build(self.current_event, serializer=self.serializer)
+ except Exception as error:
+ # Return a formatted error response
+ logger.error(f"Error processing function: {function_name}", exc_info=True)
+ error_response = BedrockFunctionResponse(body=f"Error: {error.__class__.__name__}: {str(error)}")
+ return BedrockFunctionsResponseBuilder(error_response).build(self.current_event, serializer=self.serializer)
+
+ def append_context(self, **additional_context):
+ """Append key=value data as routing context"""
+ self.context.update(**additional_context)
+
+ def clear_context(self):
+ """Resets routing context"""
+ self.context.clear()
diff --git a/aws_lambda_powertools/event_handler/depends.py b/aws_lambda_powertools/event_handler/depends.py
new file mode 100644
index 00000000000..f05167c63d9
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/depends.py
@@ -0,0 +1,222 @@
+"""Lightweight dependency injection primitives — no pydantic import."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Annotated, Any, get_args, get_origin, get_type_hints
+
+if TYPE_CHECKING:
+ from collections.abc import Callable
+
+ from aws_lambda_powertools.event_handler.openapi.params import Dependant
+ from aws_lambda_powertools.event_handler.request import Request
+
+
+class DependencyResolutionError(Exception):
+ """Raised when a dependency cannot be resolved."""
+
+
+class Depends:
+ """
+ Declares a dependency for a route handler parameter.
+
+ Dependencies are resolved automatically before the handler is called. The return value
+ of the dependency callable is injected as the parameter value.
+
+ Parameters
+ ----------
+ dependency: Callable[..., Any]
+ A callable whose return value will be injected into the handler parameter.
+ The callable can itself declare ``Depends()`` parameters to form a dependency tree.
+ use_cache: bool
+ If ``True`` (default), the dependency result is cached per invocation so that
+ the same dependency used multiple times is only called once.
+
+ Examples
+ --------
+
+ ```python
+ from typing import Annotated
+
+ from aws_lambda_powertools.event_handler import APIGatewayHttpResolver, Depends
+
+ app = APIGatewayHttpResolver()
+
+ def get_tenant() -> str:
+ return "default-tenant"
+
+ @app.get("/orders")
+ def list_orders(tenant_id: Annotated[str, Depends(get_tenant)]):
+ return {"tenant": tenant_id}
+ ```
+ """
+
+ def __init__(self, dependency: Callable[..., Any], *, use_cache: bool = True) -> None:
+ if not callable(dependency):
+ raise DependencyResolutionError(
+ f"Depends() requires a callable, got {type(dependency).__name__}: {dependency!r}",
+ )
+ self.dependency = dependency
+ self.use_cache = use_cache
+
+
+class _DependencyNode:
+ """Lightweight node in a dependency tree — used by ``build_dependency_tree``."""
+
+ def __init__(self, *, param_name: str, depends: Depends, sub_tree: DependencyTree) -> None:
+ self.param_name = param_name
+ self.depends = depends
+ self.dependant = sub_tree
+
+
+class DependencyTree:
+ """Lightweight dependency tree — no pydantic required.
+
+ This mirrors the shape that ``solve_dependencies`` expects (a ``.dependencies``
+ attribute containing nodes with ``.param_name``, ``.depends``, and ``.dependant``),
+ but can be built without importing pydantic.
+ """
+
+ def __init__(self, *, dependencies: list[_DependencyNode] | None = None) -> None:
+ self.dependencies: list[_DependencyNode] = dependencies or []
+
+
+class DependencyParam:
+ """Holds a dependency's parameter name and its resolved Dependant sub-tree (OpenAPI path)."""
+
+ def __init__(self, *, param_name: str, depends: Depends, dependant: Dependant) -> None:
+ self.param_name = param_name
+ self.depends = depends
+ self.dependant = dependant
+
+
+def _get_depends_from_annotation(annotation: Any) -> Depends | None:
+ """Extract a Depends instance from an Annotated[Type, Depends(...)] annotation."""
+ if get_origin(annotation) is Annotated:
+ for arg in get_args(annotation)[1:]:
+ if isinstance(arg, Depends):
+ return arg
+ return None
+
+
+def _has_depends(func: Callable[..., Any]) -> bool:
+ """Check if a callable has any Depends() parameters, without importing pydantic."""
+ try:
+ hints = get_type_hints(func, include_extras=True)
+ except Exception:
+ return False
+
+ for annotation in hints.values():
+ if _get_depends_from_annotation(annotation) is not None:
+ return True
+ return False
+
+
+def build_dependency_tree(func: Callable[..., Any]) -> DependencyTree:
+ """Build a lightweight dependency tree from a callable's signature.
+
+ This inspects the function parameters for ``Annotated[Type, Depends(...)]``
+ annotations and recursively builds the tree — all without importing pydantic.
+ """
+ try:
+ hints = get_type_hints(func, include_extras=True)
+ except Exception:
+ return DependencyTree()
+
+ dependencies: list[_DependencyNode] = []
+
+ for param_name, annotation in hints.items():
+ if param_name == "return":
+ continue
+
+ depends_instance = _get_depends_from_annotation(annotation)
+ if depends_instance is not None:
+ sub_tree = build_dependency_tree(depends_instance.dependency)
+ dependencies.append(
+ _DependencyNode(
+ param_name=param_name,
+ depends=depends_instance,
+ sub_tree=sub_tree,
+ ),
+ )
+
+ return DependencyTree(dependencies=dependencies)
+
+
+def solve_dependencies(
+ *,
+ dependant: Dependant | DependencyTree,
+ request: Request | None = None,
+ dependency_overrides: dict[Callable[..., Any], Callable[..., Any]] | None = None,
+ dependency_cache: dict[Callable[..., Any], Any] | None = None,
+) -> dict[str, Any]:
+ """
+ Recursively resolve all ``Depends()`` parameters for a given dependant.
+
+ Parameters
+ ----------
+ dependant: Dependant
+ The dependant model containing dependency declarations
+ request: Request, optional
+ The current request object, injected into dependencies that declare a Request parameter
+ dependency_overrides: dict, optional
+ Mapping of original dependency callable to override callable (for testing)
+ dependency_cache: dict, optional
+ Per-invocation cache of resolved dependency values
+
+ Returns
+ -------
+ dict[str, Any]
+ Mapping of parameter name to resolved dependency value
+ """
+ from aws_lambda_powertools.event_handler.request import Request as RequestClass
+
+ if dependency_cache is None:
+ dependency_cache = {}
+
+ values: dict[str, Any] = {}
+
+ for dep in dependant.dependencies:
+ use_fn = dep.depends.dependency
+
+ # Apply overrides (for testing)
+ if dependency_overrides and use_fn in dependency_overrides:
+ use_fn = dependency_overrides[use_fn]
+
+ # Check cache
+ if dep.depends.use_cache and use_fn in dependency_cache:
+ values[dep.param_name] = dependency_cache[use_fn]
+ continue
+
+ # Recursively resolve sub-dependencies
+ sub_values = solve_dependencies(
+ dependant=dep.dependant,
+ request=request,
+ dependency_overrides=dependency_overrides,
+ dependency_cache=dependency_cache,
+ )
+
+ # Inject Request if the dependency declares it
+ if request is not None:
+ try:
+ hints = get_type_hints(use_fn)
+ except Exception: # pragma: no cover - defensive for broken annotations
+ hints = {}
+ for param_name, annotation in hints.items():
+ if annotation is RequestClass:
+ sub_values[param_name] = request
+
+ try:
+ solved = use_fn(**sub_values)
+ except Exception as exc:
+ dep_name = getattr(use_fn, "__name__", repr(use_fn))
+ raise DependencyResolutionError(
+ f"Failed to resolve dependency '{dep_name}' for parameter '{dep.param_name}': {exc}",
+ ) from exc
+
+ # Cache result
+ if dep.depends.use_cache:
+ dependency_cache[use_fn] = solved
+
+ values[dep.param_name] = solved
+
+ return values
diff --git a/aws_lambda_powertools/event_handler/events_appsync/__init__.py b/aws_lambda_powertools/event_handler/events_appsync/__init__.py
new file mode 100644
index 00000000000..64387723526
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/events_appsync/__init__.py
@@ -0,0 +1,5 @@
+from aws_lambda_powertools.event_handler.events_appsync.appsync_events import AppSyncEventsResolver
+
+__all__ = [
+ "AppSyncEventsResolver",
+]
diff --git a/aws_lambda_powertools/event_handler/events_appsync/_registry.py b/aws_lambda_powertools/event_handler/events_appsync/_registry.py
new file mode 100644
index 00000000000..8c682327706
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/events_appsync/_registry.py
@@ -0,0 +1,92 @@
+from __future__ import annotations
+
+import logging
+import warnings
+from typing import TYPE_CHECKING
+
+from aws_lambda_powertools.event_handler.events_appsync.functions import find_best_route, is_valid_path
+from aws_lambda_powertools.warnings import PowertoolsUserWarning
+
+if TYPE_CHECKING:
+ from collections.abc import Callable
+
+ from aws_lambda_powertools.event_handler.events_appsync.types import ResolverTypeDef
+
+
+logger = logging.getLogger(__name__)
+
+
+class ResolverEventsRegistry:
+ def __init__(self, kind_resolver: str):
+ self.resolvers: dict[str, ResolverTypeDef] = {}
+ self.kind_resolver = kind_resolver
+
+ def register(
+ self,
+ path: str = "/default/*",
+ aggregate: bool = False,
+ ) -> Callable | None:
+ """Registers the resolver for path that includes namespace + channel
+
+ Parameters
+ ----------
+ path : str
+ Path including namespace + channel
+ aggregate: bool
+ A flag indicating whether the batch items should be processed at once or individually.
+ If True, the resolver will process all items as a single event.
+ If False (default), the resolver will process each item individually.
+
+ Return
+ ----------
+ Callable
+ A Callable
+ """
+
+ def _register(func) -> Callable | None:
+ if not is_valid_path(path):
+ warnings.warn(
+ f"The path `{path}` registered for `{self.kind_resolver}` is not valid and will be skipped."
+ f"A path should always have a namespace starting with '/'"
+ "A path can have multiple namespaces, all separated by '/'."
+ "Wildcards are allowed only at the end of the path.",
+ stacklevel=2,
+ category=PowertoolsUserWarning,
+ )
+ return None
+
+ logger.debug(
+ f"Adding resolver `{func.__name__}` for path `{path}` and kind_resolver `{self.kind_resolver}`",
+ )
+ self.resolvers[f"{path}"] = {
+ "func": func,
+ "aggregate": aggregate,
+ }
+ return func
+
+ return _register
+
+ def find_resolver(self, path: str) -> ResolverTypeDef | None:
+ """Find resolver based on type_name and field_name
+
+ Parameters
+ ----------
+ path : str
+ Type name
+ Return
+ ----------
+ dict | None
+ A dictionary with the resolver and if this is aggregated or not
+ """
+ logger.debug(f"Looking for resolver for path `{path}` and kind_resolver `{self.kind_resolver}`")
+ return self.resolvers.get(find_best_route(self.resolvers, path))
+
+ def merge(self, other_registry: ResolverEventsRegistry):
+ """Update current registry with incoming registry
+
+ Parameters
+ ----------
+ other_registry : ResolverRegistry
+ Registry to merge from
+ """
+ self.resolvers.update(**other_registry.resolvers)
diff --git a/aws_lambda_powertools/event_handler/events_appsync/appsync_events.py b/aws_lambda_powertools/event_handler/events_appsync/appsync_events.py
new file mode 100644
index 00000000000..ee03db5c625
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/events_appsync/appsync_events.py
@@ -0,0 +1,422 @@
+from __future__ import annotations
+
+import asyncio
+import logging
+import warnings
+from typing import TYPE_CHECKING, Any
+
+from aws_lambda_powertools.event_handler.events_appsync.exceptions import UnauthorizedException
+from aws_lambda_powertools.event_handler.events_appsync.router import Router
+from aws_lambda_powertools.utilities.data_classes.appsync_resolver_events_event import AppSyncResolverEventsEvent
+from aws_lambda_powertools.warnings import PowertoolsUserWarning
+
+if TYPE_CHECKING:
+ from collections.abc import Callable
+
+ from aws_lambda_powertools.event_handler.events_appsync.types import ResolverTypeDef
+ from aws_lambda_powertools.utilities.typing.lambda_context import LambdaContext
+
+
+logger = logging.getLogger(__name__)
+
+
+class AppSyncEventsResolver(Router):
+ """
+ AppSync Events API Resolver for handling publish and subscribe operations.
+
+ This class extends the Router to process AppSync real-time API events, managing
+ both synchronous and asynchronous resolvers for event publishing and subscribing.
+
+ Attributes
+ ----------
+ context: dict
+ Dictionary to store context information accessible across resolvers
+ lambda_context: LambdaContext
+ Lambda context from the AWS Lambda function
+ current_event: AppSyncResolverEventsEvent
+ Current event being processed
+
+ Examples
+ --------
+ Define a simple AppSync events resolver for a chat application:
+
+ >>> from aws_lambda_powertools.event_handler import AppSyncEventsResolver
+ >>> app = AppSyncEventsResolver()
+ >>>
+ >>> # Using aggregate mode to process multiple messages at once
+ >>> @app.on_publish(channel_path="/default/*", aggregate=True)
+ >>> def handle_batch_messages(payload):
+ >>> processed_messages = []
+ >>> for message in payload:
+ >>> # Process each message
+ >>> processed_messages.append({
+ >>> "messageId": f"msg-{message.get('id')}",
+ >>> "processed": True
+ >>> })
+ >>> return processed_messages
+ >>>
+ >>> # Asynchronous resolver
+ >>> @app.async_on_publish(channel_path="/default/*")
+ >>> async def handle_async_messages(event):
+ >>> # Perform async operations (e.g., DB queries, HTTP calls)
+ >>> await asyncio.sleep(0.1) # Simulate async work
+ >>> return {
+ >>> "messageId": f"async-{event.get('id')}",
+ >>> "processed": True
+ >>> }
+ >>>
+ >>> # Lambda handler
+ >>> def lambda_handler(event, context):
+ >>> return events.resolve(event, context)
+ """
+
+ def __init__(self):
+ """Initialize the AppSyncEventsResolver."""
+ super().__init__()
+ self.context = {} # early init as customers might add context before event resolution
+ self._exception_handlers: dict[type, Callable] = {}
+
+ def __call__(
+ self,
+ event: dict | AppSyncResolverEventsEvent,
+ context: LambdaContext,
+ ) -> Any:
+ """
+ Implicit lambda handler which internally calls `resolve`.
+
+ Parameters
+ ----------
+ event: dict or AppSyncResolverEventsEvent
+ The AppSync event to process
+ context: LambdaContext
+ The Lambda context
+
+ Returns
+ -------
+ Any
+ The resolver's response
+ """
+ return self.resolve(event, context)
+
+ def resolve(
+ self,
+ event: dict | AppSyncResolverEventsEvent,
+ context: LambdaContext,
+ ) -> Any:
+ """
+ Resolves the response based on the provided event and decorator operation.
+
+ Parameters
+ ----------
+ event: dict or AppSyncResolverEventsEvent
+ The AppSync event to process
+ context: LambdaContext
+ The Lambda context
+
+ Returns
+ -------
+ Any
+ The resolver's response based on the operation type
+
+ Examples
+ --------
+ >>> events = AppSyncEventsResolver()
+ >>>
+ >>> # Explicit call to resolve in Lambda handler
+ >>> def lambda_handler(event, context):
+ >>> return events.resolve(event, context)
+ """
+
+ self._setup_context(event, context)
+
+ if self.current_event.info.operation == "PUBLISH":
+ response = self._publish_events(payload=self.current_event.events)
+ else:
+ response = self._subscribe_events()
+
+ self.clear_context()
+
+ return response
+
+ def _subscribe_events(self) -> Any:
+ """
+ Handle subscribe events.
+
+ Returns
+ -------
+ Any
+ Any response
+ """
+ channel_path = self.current_event.info.channel_path
+ logger.debug(f"Processing subscribe events for path {channel_path}")
+
+ resolver = self._subscribe_registry.find_resolver(channel_path)
+ if resolver:
+ try:
+ resolver["func"]()
+ return None # Must return None in subscribe events
+ except UnauthorizedException:
+ raise
+ except Exception as error:
+ return {"error": self._format_error_response(error)}
+
+ self._warn_no_resolver("subscribe", channel_path)
+ return None
+
+ def _publish_events(self, payload: list[dict[str, Any]]) -> list[dict[str, Any]] | dict[str, Any]:
+ """
+ Handle publish events.
+
+ Parameters
+ ----------
+ payload: list[dict[str, Any]]
+ The events payload to process
+
+ Returns
+ -------
+ list[dict[str, Any]] or dict[str, Any]
+ Processed events or error response
+ """
+
+ channel_path = self.current_event.info.channel_path
+
+ logger.debug(f"Processing publish events for path {channel_path}")
+
+ resolver = self._publish_registry.find_resolver(channel_path)
+ async_resolver = self._async_publish_registry.find_resolver(channel_path)
+
+ if resolver and async_resolver:
+ warnings.warn(
+ f"Both synchronous and asynchronous resolvers found for the same event and field."
+ f"The synchronous resolver takes precedence. Executing: {resolver['func'].__name__}",
+ stacklevel=2,
+ category=PowertoolsUserWarning,
+ )
+
+ if resolver:
+ logger.debug(f"Found sync resolver: {resolver}")
+ return self._process_publish_event_sync_resolver(resolver)
+
+ if async_resolver:
+ logger.debug(f"Found async resolver: {async_resolver}")
+ return asyncio.run(self._call_publish_event_async_resolver(async_resolver))
+
+ # No resolver found
+ # Warning and returning AS IS
+ self._warn_no_resolver("publish", channel_path, return_as_is=True)
+ return {"events": payload}
+
+ def _process_publish_event_sync_resolver(
+ self,
+ resolver: ResolverTypeDef,
+ ) -> list[dict[str, Any]] | dict[str, Any]:
+ """
+ Process events using a synchronous resolver.
+
+ Parameters
+ ----------
+ resolver : ResolverTypeDef
+ The resolver to use for processing events
+
+ Returns
+ -------
+ list[dict[str, Any]] or dict[str, Any]
+ Processed events or error response
+
+ Notes
+ -----
+ If the resolver is configured with aggregate=True, all events are processed
+ as a batch. Otherwise, each event is processed individually.
+ """
+
+ # Checks whether the entire batch should be processed at once
+ if resolver["aggregate"]:
+ try:
+ # Process the entire batch
+ response = resolver["func"](payload=self.current_event.events)
+
+ if not isinstance(response, list):
+ warnings.warn(
+ "Response must be a list when using aggregate, AppSync will drop those events.",
+ stacklevel=2,
+ category=PowertoolsUserWarning,
+ )
+
+ return {"events": response}
+ except UnauthorizedException:
+ raise
+ except Exception as error:
+ return {"error": self._format_error_response(error)}
+
+ # By default, we gracefully append `None` for any records that failed processing
+ results = []
+ for idx, event in enumerate(self.current_event.events):
+ try:
+ result_return = resolver["func"](payload=event.get("payload"))
+ results.append({"id": event.get("id"), "payload": result_return})
+ except Exception as error:
+ logger.debug(f"Failed to process event number {idx}")
+ error_return = {"id": event.get("id"), "error": self._format_error_response(error)}
+ results.append(error_return)
+
+ return {"events": results}
+
+ async def _call_publish_event_async_resolver(
+ self,
+ resolver: ResolverTypeDef,
+ ) -> list[dict[str, Any]] | dict[str, Any]:
+ """
+ Process events using an asynchronous resolver.
+
+ Parameters
+ ----------
+ resolver: ResolverTypeDef
+ The async resolver to use for processing events
+
+ Returns
+ -------
+ list[Any]
+ Processed events or error responses
+
+ Notes
+ -----
+ If the resolver is configured with aggregate=True, all events are processed
+ as a batch. Otherwise, each event is processed individually and in parallel.
+ """
+
+ # Checks whether the entire batch should be processed at once
+ if resolver["aggregate"]:
+ try:
+ # Process the entire batch
+ response = await resolver["func"](payload=self.current_event.events)
+ if not isinstance(response, list):
+ warnings.warn(
+ "Response must be a list when using aggregate, AppSync will drop those events.",
+ stacklevel=2,
+ category=PowertoolsUserWarning,
+ )
+
+ return {"events": response}
+ except UnauthorizedException:
+ raise
+ except Exception as error:
+ return {"error": self._format_error_response(error)}
+
+ response_async: list = []
+
+ # Prime coroutines
+ tasks = [resolver["func"](payload=e.get("payload")) for e in self.current_event.events]
+
+ # Aggregate results and exceptions, then filter them out
+ # Use `None` upon exception for graceful error handling at GraphQL engine level
+ #
+ # NOTE: asyncio.gather(return_exceptions=True) catches and includes exceptions in the results
+ # this will become useful when we support exception handling in AppSync resolver
+ # Aggregate results and exceptions, then filter them out
+ results = await asyncio.gather(*tasks, return_exceptions=True)
+ response_async.extend(
+ [
+ (
+ {"id": e.get("id"), "error": self._format_error_response(ret)}
+ if isinstance(ret, Exception)
+ else {"id": e.get("id"), "payload": ret}
+ )
+ for e, ret in zip(self.current_event.events, results)
+ ],
+ )
+
+ return {"events": response_async}
+
+ def include_router(self, router: Router) -> None:
+ """
+ Add all resolvers defined in a router to this resolver.
+
+ Parameters
+ ----------
+ router : Router
+ A router containing resolvers to include
+
+ Examples
+ --------
+ >>> # Create main resolver and a router
+ >>> app = AppSyncEventsResolver()
+ >>> router = Router()
+ >>>
+ >>> # Define resolvers in the router
+ >>> @router.publish(path="/chat/message")
+ >>> def handle_chat_message(payload):
+ >>> return {"processed": True, "messageId": payload.get("id")}
+ >>>
+ >>> # Include the router in the main resolver
+ >>> app.include_router(chat_router)
+ >>>
+ >>> # Now events can handle "/chat/message" channel_path
+ """
+
+ # Merge app and router context
+ logger.debug("Merging router and app context")
+ self.context.update(**router.context)
+
+ # use pointer to allow context clearance after event is processed e.g., resolve(evt, ctx)
+ router.context = self.context
+
+ logger.debug("Merging router resolver registries")
+ self._publish_registry.merge(router._publish_registry)
+ self._async_publish_registry.merge(router._async_publish_registry)
+ self._subscribe_registry.merge(router._subscribe_registry)
+
+ def _format_error_response(self, error=None) -> str:
+ """
+ Format error responses consistently.
+
+ Parameters
+ ----------
+ error: Exception or None
+ The error to format
+
+ Returns
+ -------
+ str
+ Formatted error message
+ """
+ if isinstance(error, Exception):
+ return f"{error.__class__.__name__} - {str(error)}"
+ return "An unknown error occurred"
+
+ def _warn_no_resolver(self, operation_type: str, path: str, return_as_is: bool = False) -> None:
+ """
+ Generate consistent warning messages for missing resolvers.
+
+ Parameters
+ ----------
+ operation_type : str
+ Type of operation (e.g., "publish", "subscribe")
+ path : str
+ The channel path that's missing a resolver
+ return_as_is : bool, optional
+ Whether payload will be returned as is, by default False
+ """
+ message = (
+ f"No resolvers were found for {operation_type} operations with path {path}"
+ f"{'. We will return the entire payload as is' if return_as_is else ''}"
+ )
+ warnings.warn(message, stacklevel=3, category=PowertoolsUserWarning)
+
+ def _setup_context(self, event: dict | AppSyncResolverEventsEvent, context: LambdaContext) -> None:
+ """
+ Set up the context and event for processing.
+
+ Parameters
+ ----------
+ event : dict or AppSyncResolverEventsEvent
+ The AppSync event to process
+ context : LambdaContext
+ The Lambda context
+ """
+ self.lambda_context = context
+ Router.lambda_context = context
+
+ Router.current_event = (
+ event if isinstance(event, AppSyncResolverEventsEvent) else AppSyncResolverEventsEvent(event)
+ )
+ self.current_event = Router.current_event
diff --git a/aws_lambda_powertools/event_handler/events_appsync/base.py b/aws_lambda_powertools/event_handler/events_appsync/base.py
new file mode 100644
index 00000000000..86a1e140d5d
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/events_appsync/base.py
@@ -0,0 +1,44 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import Callable
+
+DEFAULT_ROUTE = "/default/*"
+
+
+class BaseRouter(ABC):
+ """Abstract base class for Router (resolvers)"""
+
+ @abstractmethod
+ def on_publish(
+ self,
+ path: str = DEFAULT_ROUTE,
+ aggregate: bool = True,
+ ) -> Callable:
+ raise NotImplementedError
+
+ @abstractmethod
+ def async_on_publish(
+ self,
+ path: str = DEFAULT_ROUTE,
+ aggregate: bool = True,
+ ) -> Callable:
+ raise NotImplementedError
+
+ @abstractmethod
+ def on_subscribe(
+ self,
+ path: str = DEFAULT_ROUTE,
+ ) -> Callable:
+ raise NotImplementedError
+
+ def append_context(self, **additional_context) -> None:
+ """
+ Appends context information available under any route.
+
+ Parameters
+ -----------
+ **additional_context: dict
+ Additional context key-value pairs to append.
+ """
+ raise NotImplementedError
diff --git a/aws_lambda_powertools/event_handler/events_appsync/exceptions.py b/aws_lambda_powertools/event_handler/events_appsync/exceptions.py
new file mode 100644
index 00000000000..89c6adcaf27
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/events_appsync/exceptions.py
@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+
+class UnauthorizedException(Exception):
+ """
+ Error to be thrown to communicate the subscription is unauthorized.
+
+ When this error is raised, the client will receive a 40x error code
+ and the subscription will be closed.
+
+ Attributes:
+ message (str): The error message describing the unauthorized access.
+ """
+
+ def __init__(self, message: str | None = None, *args):
+ """
+ Initialize the UnauthorizedException.
+
+ Args:
+ message (str): A descriptive error message.
+ *args: Variable positional arguments.
+ """
+ super().__init__(message, *args)
+ self.name = "UnauthorizedException"
diff --git a/aws_lambda_powertools/event_handler/events_appsync/functions.py b/aws_lambda_powertools/event_handler/events_appsync/functions.py
new file mode 100644
index 00000000000..0d7ddf2518f
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/events_appsync/functions.py
@@ -0,0 +1,106 @@
+from __future__ import annotations
+
+import re
+from functools import lru_cache
+from typing import Any
+
+PATH_REGEX = re.compile(r"^\/([^\/\*]+)(\/[^\/\*]+)*(\/\*)?$")
+
+
+def is_valid_path(path: str) -> bool:
+ """
+ Checks if a given path is valid based on specific rules.
+
+ Parameters
+ ----------
+ path: str
+ The path to validate
+
+ Returns:
+ --------
+ bool:
+ True if the path is valid, False otherwise
+
+ Examples:
+ >>> is_valid_path('/*')
+ True
+ >>> is_valid_path('/users')
+ True
+ >>> is_valid_path('/users/profile')
+ True
+ >>> is_valid_path('/users/*/details')
+ False
+ >>> is_valid_path('/users/*')
+ True
+ >>> is_valid_path('users')
+ False
+ """
+ return True if path == "/*" else bool(PATH_REGEX.fullmatch(path))
+
+
+def find_best_route(routes: dict[str, Any], path: str):
+ """
+ Find the most specific matching route for a given path.
+
+ Examples of matches:
+ Route: /default/v1/* Path: /default/v1/users -> MATCH
+ Route: /default/v1/* Path: /default/v1/users/students -> MATCH
+ Route: /default/v1/users/* Path: /default/v1/users/123 -> MATCH (this wins over /default/v1/*)
+ Route: /* Path: /anything/here -> MATCH (lowest priority)
+
+ Parameters
+ ----------
+ routes: dict[str, Any]
+ Dictionary containing routes and their handlers
+ Format: {
+ 'resolvers': {
+ '/path/*': {'func': callable, 'aggregate': bool},
+ '/path/specific/*': {'func': callable, 'aggregate': bool}
+ }
+ }
+ path: str
+ Actual path to match (e.g., '/default/v1/users')
+
+ Returns
+ -------
+ str: Most specific matching route or None if no match
+ """
+
+ @lru_cache(maxsize=1024)
+ def pattern_to_regex(route):
+ """
+ Convert a route pattern to a regex pattern with caching.
+ Examples:
+ /default/v1/* -> ^/default/v1/[^/]+$
+ /default/v1/users/* -> ^/default/v1/users/.*$
+
+ Parameters
+ ----------
+ route: str
+ Route pattern with wildcards
+
+ Returns
+ -------
+ Pattern:
+ Compiled regex pattern
+ """
+ # Escape special regex chars but convert * to regex pattern
+ pattern = re.escape(route).replace("\\*", "[^/]+")
+
+ # If pattern ends with [^/]+, replace with .* for multi-segment match
+ if pattern.endswith("[^/]+"):
+ pattern = pattern[:-6] + ".*"
+
+ # Compile and return the regex pattern
+ return re.compile(f"^{pattern}$")
+
+ # Find all matching routes
+ matches = [route for route in routes.keys() if pattern_to_regex(route).match(path)]
+
+ # Return the most specific route (longest length minus wildcards)
+ # Examples of specificity:
+ # - '/default/v1/users' -> score: 14 (len=14, wildcards=0)
+ # - '/default/v1/users/*' -> score: 14 (len=15, wildcards=1)
+ # - '/default/v1/*' -> score: 8 (len=9, wildcards=1)
+ # - '/*' -> score: 0 (len=2, wildcards=1)
+ return max(matches, key=lambda x: len(x) - x.count("*"), default=None)
diff --git a/aws_lambda_powertools/event_handler/events_appsync/router.py b/aws_lambda_powertools/event_handler/events_appsync/router.py
new file mode 100644
index 00000000000..167403e30fe
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/events_appsync/router.py
@@ -0,0 +1,199 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from aws_lambda_powertools.event_handler.events_appsync._registry import ResolverEventsRegistry
+from aws_lambda_powertools.event_handler.events_appsync.base import DEFAULT_ROUTE, BaseRouter
+
+if TYPE_CHECKING:
+ from collections.abc import Callable
+
+ from aws_lambda_powertools.utilities.data_classes.appsync_resolver_events_event import AppSyncResolverEventsEvent
+ from aws_lambda_powertools.utilities.typing.lambda_context import LambdaContext
+
+
+class Router(BaseRouter):
+ """
+ Router for AppSync real-time API event handling.
+
+ This class provides decorators to register resolver functions for publish and subscribe
+ operations in AppSync real-time APIs.
+
+ Parameters
+ ----------
+ context : dict
+ Dictionary to store context information accessible across resolvers
+ current_event : AppSyncResolverEventsEvent
+ Current event being processed
+ lambda_context : LambdaContext
+ Lambda context from the AWS Lambda function
+
+ Examples
+ --------
+ Create a router and define resolvers:
+
+ >>> chat_router = Router()
+ >>>
+ >>> # Register a resolver for publish operations
+ >>> @chat_router.on_publish(path="/chat/message")
+ >>> def handle_message(payload):
+ >>> # Process message
+ >>> return {"success": True, "messageId": payload.get("id")}
+ >>>
+ >>> # Register an async resolver for publish operations
+ >>> @chat_router.async_on_publish(path="/chat/typing")
+ >>> async def handle_typing(event):
+ >>> # Process typing indicator
+ >>> await some_async_operation()
+ >>> return {"processed": True}
+ >>>
+ >>> # Register a resolver for subscribe operations
+ >>> @chat_router.on_subscribe(path="/chat/room/*")
+ >>> def handle_subscribe(event):
+ >>> # Handle subscription setup
+ >>> return {"allowed": True}
+ """
+
+ context: dict
+ current_event: AppSyncResolverEventsEvent
+ lambda_context: LambdaContext
+
+ def __init__(self):
+ """
+ Initialize a new Router instance.
+
+ Sets up empty context and registry containers for different types of resolvers.
+ """
+ self.context = {} # early init as customers might add context before event resolution
+ self._publish_registry = ResolverEventsRegistry(kind_resolver="on_publish")
+ self._async_publish_registry = ResolverEventsRegistry(kind_resolver="async_on_publish")
+ self._subscribe_registry = ResolverEventsRegistry(kind_resolver="on_subscribe")
+
+ def on_publish(
+ self,
+ path: str = DEFAULT_ROUTE,
+ aggregate: bool = False,
+ ) -> Callable:
+ """
+ Register a resolver function for publish operations.
+
+ Parameters
+ ----------
+ path : str, optional
+ The channel path pattern to match for this resolver, by default "/default/*"
+ aggregate : bool, optional
+ Whether to process events in aggregate (batch) mode, by default False
+
+ Returns
+ -------
+ Callable
+ Decorator function that registers the resolver
+
+ Examples
+ --------
+ >>> router = Router()
+ >>>
+ >>> # Basic usage
+ >>> @router.on_publish(path="/notifications/new")
+ >>> def handle_notification(payload):
+ >>> # Process a single notification
+ >>> return {"processed": True, "notificationId": payload.get("id")}
+ >>>
+ >>> # Aggregate mode for batch processing
+ >>> @router.on_publish(path="/notifications/batch", aggregate=True)
+ >>> def handle_batch_notifications(payload):
+ >>> # Process multiple notifications at once
+ >>> results = []
+ >>> for item in payload:
+ >>> # Process each item
+ >>> results.append({"processed": True, "id": item.get("id")})
+ >>> return results
+ """
+ return self._publish_registry.register(path=path, aggregate=aggregate)
+
+ def async_on_publish(
+ self,
+ path: str = DEFAULT_ROUTE,
+ aggregate: bool = False,
+ ) -> Callable:
+ """
+ Register an asynchronous resolver function for publish operations.
+
+ Parameters
+ ----------
+ path : str, optional
+ The channel path pattern to match for this resolver, by default "/default/*"
+ aggregate : bool, optional
+ Whether to process events in aggregate (batch) mode, by default False
+
+ Returns
+ -------
+ Callable
+ Decorator function that registers the async resolver
+
+ Examples
+ --------
+ >>> router = Router()
+ >>>
+ >>> # Basic async usage
+ >>> @router.async_on_publish(path="/messages/send")
+ >>> async def handle_message(event):
+ >>> # Perform async operations
+ >>> result = await database.save_message(event)
+ >>> return {"saved": True, "messageId": result.id}
+ >>>
+ >>> # Aggregate mode for batch processing
+ >>> @router.async_on_publish(path="/messages/batch", aggregate=True)
+ >>> async def handle_batch_messages(events):
+ >>> # Process multiple messages asynchronously
+ >>> tasks = [database.save_message(e) for e in events]
+ >>> results = await asyncio.gather(*tasks)
+ >>> return [{"saved": True, "id": r.id} for r in results]
+ """
+ return self._async_publish_registry.register(path=path, aggregate=aggregate)
+
+ def on_subscribe(
+ self,
+ path: str = DEFAULT_ROUTE,
+ ) -> Callable:
+ """
+ Register a resolver function for subscribe operations.
+
+ Parameters
+ ----------
+ path : str, optional
+ The channel path pattern to match for this resolver, by default "/default/*"
+
+ Returns
+ -------
+ Callable
+ Decorator function that registers the resolver
+
+ Examples
+ --------
+ >>> router = Router()
+ >>>
+ >>> # Handle subscription request
+ >>> @router.on_subscribe(path="/chat/room/*")
+ >>> def authorize_subscription(event):
+ >>> # Verify if the client can subscribe to this room
+ >>> room_id = event.info.channel_path.split('/')[-1]
+ >>> user_id = event.identity.username
+ >>>
+ >>> # Check if user is allowed in this room
+ >>> is_allowed = check_permission(user_id, room_id)
+ >>>
+ >>> return {
+ >>> "allowed": is_allowed,
+ >>> "roomId": room_id
+ >>> }
+ """
+ return self._subscribe_registry.register(path=path)
+
+ def append_context(self, **additional_context):
+ """Append key=value data as routing context"""
+ self.context.update(**additional_context)
+
+ def clear_context(self):
+ """Resets routing context"""
+ self.context.clear()
diff --git a/aws_lambda_powertools/event_handler/events_appsync/types.py b/aws_lambda_powertools/event_handler/events_appsync/types.py
new file mode 100644
index 00000000000..708e8df8a8c
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/events_appsync/types.py
@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, TypedDict
+
+if TYPE_CHECKING:
+ from collections.abc import Callable
+
+
+class ResolverTypeDef(TypedDict):
+ """
+ Type definition for resolver dictionary
+ Parameters
+ ----------
+ func: Callable[..., Any]
+ Resolver function
+ aggregate: bool
+ Aggregation flag or method
+ """
+
+ func: Callable[..., Any]
+ aggregate: bool
diff --git a/aws_lambda_powertools/event_handler/exception_handling.py b/aws_lambda_powertools/event_handler/exception_handling.py
new file mode 100644
index 00000000000..acd8eb95bc6
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/exception_handling.py
@@ -0,0 +1,118 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Mapping
+
+if TYPE_CHECKING:
+ from collections.abc import Callable
+
+
+class ExceptionHandlerManager:
+ """
+ A class to manage exception handlers for different exception types.
+ This class allows registering handler functions for specific exception types
+ and looking up the appropriate handler when an exception occurs.
+ Example usage:
+ -------------
+ handler_manager = ExceptionHandlerManager()
+ @handler_manager.exception_handler(ValueError)
+ def handle_value_error(e):
+ print(f"Handling ValueError: {e}")
+ return "Error handled"
+ # To handle multiple exception types with the same handler:
+ @handler_manager.exception_handler([KeyError, TypeError])
+ def handle_multiple_errors(e):
+ print(f"Handling {type(e).__name__}: {e}")
+ return "Multiple error types handled"
+ # To find and execute a handler:
+ try:
+ # some code that might raise an exception
+ raise ValueError("Invalid value")
+ except Exception as e:
+ handler = handler_manager.lookup_exception_handler(type(e))
+ if handler:
+ result = handler(e)
+ """
+
+ def __init__(self):
+ """Initialize an empty dictionary to store exception handlers."""
+ self._exception_handlers: dict[type[Exception], Callable] = {}
+
+ def exception_handler(self, exc_class: type[Exception] | list[type[Exception]]):
+ """
+ A decorator function that registers a handler for one or more exception types.
+ Parameters
+ ----------
+ exc_class : type[Exception] | list[type[Exception]]
+ A single exception type or a list of exception types.
+ Returns
+ -------
+ Callable
+ A decorator function that registers the exception handler.
+ """
+
+ def register_exception_handler(func: Callable):
+ if isinstance(exc_class, list):
+ for exp in exc_class:
+ self._exception_handlers[exp] = func
+ else:
+ self._exception_handlers[exc_class] = func
+ return func
+
+ return register_exception_handler
+
+ def lookup_exception_handler(self, exp_type: type) -> Callable | None:
+ """
+ Looks up the registered exception handler for the given exception type or its base classes.
+ Parameters
+ ----------
+ exp_type : type
+ The exception type to look up the handler for.
+ Returns
+ -------
+ Callable | None
+ The registered exception handler function if found, otherwise None.
+ """
+ for cls in exp_type.__mro__:
+ if cls in self._exception_handlers:
+ return self._exception_handlers[cls]
+ return None
+
+ def update_exception_handlers(self, handlers: Mapping[type[Exception], Callable]) -> None:
+ """
+ Updates the exception handlers dictionary with new handler mappings.
+ This method allows bulk updates of exception handlers by providing a dictionary
+ mapping exception types to handler functions.
+ Parameters
+ ----------
+ handlers : Mapping[Type[Exception], Callable]
+ A dictionary mapping exception types to handler functions.
+ Example
+ -------
+ >>> def handle_value_error(e):
+ ... print(f"Value error: {e}")
+ ...
+ >>> def handle_key_error(e):
+ ... print(f"Key error: {e}")
+ ...
+ >>> handler_manager.update_exception_handlers({
+ ... ValueError: handle_value_error,
+ ... KeyError: handle_key_error
+ ... })
+ """
+ self._exception_handlers.update(handlers)
+
+ def get_registered_handlers(self) -> dict[type[Exception], Callable]:
+ """
+ Returns all registered exception handlers.
+ Returns
+ -------
+ Dict[Type[Exception], Callable]
+ A dictionary mapping exception types to their handler functions.
+ """
+ return self._exception_handlers.copy()
+
+ def clear_handlers(self) -> None:
+ """
+ Clears all registered exception handlers.
+ """
+ self._exception_handlers.clear()
diff --git a/aws_lambda_powertools/event_handler/exceptions.py b/aws_lambda_powertools/event_handler/exceptions.py
index 4a2838275b1..e870727cfba 100644
--- a/aws_lambda_powertools/event_handler/exceptions.py
+++ b/aws_lambda_powertools/event_handler/exceptions.py
@@ -1,45 +1,123 @@
+from __future__ import annotations
+
from http import HTTPStatus
class ServiceError(Exception):
- """API Gateway and ALB HTTP Service Error"""
+ """Powertools class HTTP Service Error"""
- def __init__(self, status_code: int, msg: str):
+ def __init__(self, status_code: int, msg: str | dict):
"""
Parameters
----------
status_code: int
Http status code
- msg: str
- Error message
+ msg: str | dict
+ Error message. Can be a string or a dictionary
"""
self.status_code = status_code
self.msg = msg
class BadRequestError(ServiceError):
- """API Gateway and ALB Bad Request Error (400)"""
+ """Powertools class Bad Request Error (400)"""
- def __init__(self, msg: str):
+ def __init__(self, msg: str | dict):
+ """
+ Parameters
+ ----------
+ msg : str | dict
+ Error message. Can be a string or a dictionary.
+ """
super().__init__(HTTPStatus.BAD_REQUEST, msg)
class UnauthorizedError(ServiceError):
- """API Gateway and ALB Unauthorized Error (401)"""
+ """Powertools class Unauthorized Error (401)"""
- def __init__(self, msg: str):
+ def __init__(self, msg: str | dict):
+ """
+ Parameters
+ ----------
+ msg : str | dict
+ Error message. Can be a string or a dictionary.
+ """
super().__init__(HTTPStatus.UNAUTHORIZED, msg)
+class ForbiddenError(ServiceError):
+ """Powertools class Forbidden Error (403)"""
+
+ def __init__(self, msg: str | dict):
+ """
+ Parameters
+ ----------
+ msg : str | dict
+ Error message. Can be a string or a dictionary.
+ """
+ super().__init__(HTTPStatus.FORBIDDEN, msg)
+
+
class NotFoundError(ServiceError):
- """API Gateway and ALB Not Found Error (404)"""
+ """Powertools class Not Found Error (404)"""
- def __init__(self, msg: str = "Not found"):
+ def __init__(self, msg: str | dict = "Not found"):
+ """
+ Parameters
+ ----------
+ msg : str | dict
+ Error message. Can be a string or a dictionary.
+ """
super().__init__(HTTPStatus.NOT_FOUND, msg)
+class RequestTimeoutError(ServiceError):
+ """Powertools class Request Timeout Error (408)"""
+
+ def __init__(self, msg: str | dict):
+ """
+ Parameters
+ ----------
+ msg : str | dict
+ Error message. Can be a string or a dictionary.
+ """
+ super().__init__(HTTPStatus.REQUEST_TIMEOUT, msg)
+
+
+class RequestEntityTooLargeError(ServiceError):
+ """Powertools class Request Entity Too Large Error (413)"""
+
+ def __init__(self, msg: str | dict):
+ """
+ Parameters
+ ----------
+ msg : str | dict
+ Error message. Can be a string or a dictionary.
+ """
+ super().__init__(HTTPStatus.REQUEST_ENTITY_TOO_LARGE, msg)
+
+
class InternalServerError(ServiceError):
- """API Gateway and ALB Not Found Internal Server Error (500)"""
+ """Powertools class Internal Server Error (500)"""
- def __init__(self, message: str):
+ def __init__(self, message: str | dict):
+ """
+ Parameters
+ ----------
+ msg : str | dict
+ Error message. Can be a string or a dictionary.
+ """
super().__init__(HTTPStatus.INTERNAL_SERVER_ERROR, message)
+
+
+class ServiceUnavailableError(ServiceError):
+ """Powertools class Service Unavailable Error (503)"""
+
+ def __init__(self, msg: str | dict):
+ """
+ Parameters
+ ----------
+ msg : str | dict
+ Error message. Can be a string or a dictionary.
+ """
+ super().__init__(HTTPStatus.SERVICE_UNAVAILABLE, msg)
diff --git a/layer/layer/__init__.py b/aws_lambda_powertools/event_handler/graphql_appsync/__init__.py
similarity index 100%
rename from layer/layer/__init__.py
rename to aws_lambda_powertools/event_handler/graphql_appsync/__init__.py
diff --git a/aws_lambda_powertools/event_handler/graphql_appsync/_registry.py b/aws_lambda_powertools/event_handler/graphql_appsync/_registry.py
new file mode 100644
index 00000000000..dc88d904c25
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/graphql_appsync/_registry.py
@@ -0,0 +1,81 @@
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+ from collections.abc import Callable
+
+logger = logging.getLogger(__name__)
+
+
+class ResolverRegistry:
+ def __init__(self):
+ self.resolvers: dict[str, dict[str, Any]] = {}
+
+ def register(
+ self,
+ type_name: str = "*",
+ field_name: str | None = None,
+ raise_on_error: bool = False,
+ aggregate: bool = True,
+ ) -> Callable:
+ """Registers the resolver for field_name
+
+ Parameters
+ ----------
+ type_name : str
+ Type name
+ field_name : str
+ Field name
+ raise_on_error: bool
+ A flag indicating whether to raise an error when processing batches
+ with failed items. Defaults to False, which means errors are handled without raising exceptions.
+ aggregate: bool
+ A flag indicating whether the batch items should be processed at once or individually.
+ If True (default), the batch resolver will process all items in the batch as a single event.
+ If False, the batch resolver will process each item in the batch individually.
+
+ Return
+ ----------
+ Callable
+ A Callable
+ """
+
+ def _register(func) -> Callable:
+ logger.debug(f"Adding resolver `{func.__name__}` for field `{type_name}.{field_name}`")
+ self.resolvers[f"{type_name}.{field_name}"] = {
+ "func": func,
+ "raise_on_error": raise_on_error,
+ "aggregate": aggregate,
+ }
+ return func
+
+ return _register
+
+ def find_resolver(self, type_name: str, field_name: str) -> dict | None:
+ """Find resolver based on type_name and field_name
+
+ Parameters
+ ----------
+ type_name : str
+ Type name
+ field_name : str
+ Field name
+ Return
+ ----------
+ Optional[Dict]
+ A dictionary with the resolver and if raise exception on error
+ """
+ logger.debug(f"Looking for resolver for type={type_name}, field={field_name}.")
+ return self.resolvers.get(f"{type_name}.{field_name}", self.resolvers.get(f"*.{field_name}"))
+
+ def merge(self, other_registry: ResolverRegistry):
+ """Update current registry with incoming registry
+
+ Parameters
+ ----------
+ other_registry : ResolverRegistry
+ Registry to merge from
+ """
+ self.resolvers.update(**other_registry.resolvers)
diff --git a/aws_lambda_powertools/event_handler/graphql_appsync/base.py b/aws_lambda_powertools/event_handler/graphql_appsync/base.py
new file mode 100644
index 00000000000..ea03c44a3b0
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/graphql_appsync/base.py
@@ -0,0 +1,163 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+ from collections.abc import Callable
+
+
+class BaseRouter(ABC):
+ """Abstract base class for Router (resolvers)"""
+
+ @abstractmethod
+ def resolver(self, type_name: str = "*", field_name: str | None = None) -> Callable:
+ """
+ Retrieve a resolver function for a specific type and field.
+
+ Parameters
+ -----------
+ type_name: str
+ The name of the type.
+ field_name: str, optional
+ The name of the field (default is None).
+
+ Examples
+ --------
+ ```python
+ from typing import Optional
+
+ from aws_lambda_powertools.event_handler import AppSyncResolver
+ from aws_lambda_powertools.utilities.data_classes import AppSyncResolverEvent
+ from aws_lambda_powertools.utilities.typing import LambdaContext
+
+ app = AppSyncResolver()
+
+ @app.resolver(type_name="Query", field_name="getPost")
+ def related_posts(event: AppSyncResolverEvent) -> Optional[list]:
+ return {"success": "ok"}
+
+ def lambda_handler(event, context: LambdaContext) -> dict:
+ return app.resolve(event, context)
+ ```
+
+ Returns
+ -------
+ Callable
+ The resolver function.
+ """
+ raise NotImplementedError
+
+ @abstractmethod
+ def batch_resolver(
+ self,
+ type_name: str = "*",
+ field_name: str | None = None,
+ raise_on_error: bool = False,
+ aggregate: bool = True,
+ ) -> Callable:
+ """
+ Retrieve a batch resolver function for a specific type and field.
+
+ Parameters
+ -----------
+ type_name: str
+ The name of the type.
+ field_name: str, optional
+ The name of the field (default is None).
+ raise_on_error: bool
+ A flag indicating whether to raise an error when processing batches
+ with failed items. Defaults to False, which means errors are handled without raising exceptions.
+ aggregate: bool
+ A flag indicating whether the batch items should be processed at once or individually.
+ If True (default), the batch resolver will process all items in the batch as a single event.
+ If False, the batch resolver will process each item in the batch individually.
+
+ Examples
+ --------
+ ```python
+ from typing import Optional
+
+ from aws_lambda_powertools.event_handler import AppSyncResolver
+ from aws_lambda_powertools.utilities.data_classes import AppSyncResolverEvent
+ from aws_lambda_powertools.utilities.typing import LambdaContext
+
+ app = AppSyncResolver()
+
+ @app.batch_resolver(type_name="Query", field_name="getPost")
+ def related_posts(event: AppSyncResolverEvent, id) -> Optional[list]:
+ return {"post_id": id}
+
+ def lambda_handler(event, context: LambdaContext) -> dict:
+ return app.resolve(event, context)
+ ```
+
+ Returns
+ -------
+ Callable
+ The batch resolver function.
+ """
+ raise NotImplementedError
+
+ @abstractmethod
+ def async_batch_resolver(
+ self,
+ type_name: str = "*",
+ field_name: str | None = None,
+ raise_on_error: bool = False,
+ aggregate: bool = True,
+ ) -> Callable:
+ """
+ Retrieve a batch resolver function for a specific type and field and runs async.
+
+ Parameters
+ -----------
+ type_name: str
+ The name of the type.
+ field_name: str, optional
+ The name of the field (default is None).
+ raise_on_error: bool
+ A flag indicating whether to raise an error when processing batches
+ with failed items. Defaults to False, which means errors are handled without raising exceptions.
+ aggregate: bool
+ A flag indicating whether the batch items should be processed at once or individually.
+ If True (default), the batch resolver will process all items in the batch as a single event.
+ If False, the batch resolver will process each item in the batch individually.
+
+ Examples
+ --------
+ ```python
+ from typing import Optional
+
+ from aws_lambda_powertools.event_handler import AppSyncResolver
+ from aws_lambda_powertools.utilities.data_classes import AppSyncResolverEvent
+ from aws_lambda_powertools.utilities.typing import LambdaContext
+
+ app = AppSyncResolver()
+
+ @app.async_batch_resolver(type_name="Query", field_name="getPost")
+ async def related_posts(event: AppSyncResolverEvent, id) -> Optional[list]:
+ return {"post_id": id}
+
+ def lambda_handler(event, context: LambdaContext) -> dict:
+ return app.resolve(event, context)
+ ```
+
+ Returns
+ -------
+ Callable
+ The batch resolver function.
+ """
+ raise NotImplementedError
+
+ @abstractmethod
+ def append_context(self, **additional_context) -> None:
+ """
+ Appends context information available under any route.
+
+ Parameters
+ -----------
+ **additional_context: dict
+ Additional context key-value pairs to append.
+ """
+ raise NotImplementedError
diff --git a/aws_lambda_powertools/event_handler/graphql_appsync/exceptions.py b/aws_lambda_powertools/event_handler/graphql_appsync/exceptions.py
new file mode 100644
index 00000000000..f98a75b6f17
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/graphql_appsync/exceptions.py
@@ -0,0 +1,10 @@
+class ResolverNotFoundError(Exception):
+ """
+ When a resolver is not found during a lookup.
+ """
+
+
+class InvalidBatchResponse(Exception):
+ """
+ When a batch response something different from a List
+ """
diff --git a/aws_lambda_powertools/event_handler/graphql_appsync/router.py b/aws_lambda_powertools/event_handler/graphql_appsync/router.py
new file mode 100644
index 00000000000..b05e6f276f5
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/graphql_appsync/router.py
@@ -0,0 +1,64 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from aws_lambda_powertools.event_handler.graphql_appsync._registry import ResolverRegistry
+from aws_lambda_powertools.event_handler.graphql_appsync.base import BaseRouter
+
+if TYPE_CHECKING:
+ from collections.abc import Callable
+
+ from aws_lambda_powertools.utilities.data_classes.appsync_resolver_event import AppSyncResolverEvent
+ from aws_lambda_powertools.utilities.typing.lambda_context import LambdaContext
+
+
+class Router(BaseRouter):
+ context: dict
+ current_batch_event: list[AppSyncResolverEvent] = []
+ current_event: AppSyncResolverEvent | None = None
+ lambda_context: LambdaContext | None = None
+
+ def __init__(self):
+ self.context = {} # early init as customers might add context before event resolution
+ self._resolver_registry = ResolverRegistry()
+ self._batch_resolver_registry = ResolverRegistry()
+ self._async_batch_resolver_registry = ResolverRegistry()
+
+ def resolver(self, type_name: str = "*", field_name: str | None = None) -> Callable:
+ return self._resolver_registry.register(field_name=field_name, type_name=type_name)
+
+ def batch_resolver(
+ self,
+ type_name: str = "*",
+ field_name: str | None = None,
+ raise_on_error: bool = False,
+ aggregate: bool = True,
+ ) -> Callable:
+ return self._batch_resolver_registry.register(
+ field_name=field_name,
+ type_name=type_name,
+ raise_on_error=raise_on_error,
+ aggregate=aggregate,
+ )
+
+ def async_batch_resolver(
+ self,
+ type_name: str = "*",
+ field_name: str | None = None,
+ raise_on_error: bool = False,
+ aggregate: bool = True,
+ ) -> Callable:
+ return self._async_batch_resolver_registry.register(
+ field_name=field_name,
+ type_name=type_name,
+ raise_on_error=raise_on_error,
+ aggregate=aggregate,
+ )
+
+ def append_context(self, **additional_context):
+ """Append key=value data as routing context"""
+ self.context.update(**additional_context)
+
+ def clear_context(self):
+ """Resets routing context"""
+ self.context.clear()
diff --git a/aws_lambda_powertools/event_handler/http_resolver.py b/aws_lambda_powertools/event_handler/http_resolver.py
new file mode 100644
index 00000000000..da72f6fca4d
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/http_resolver.py
@@ -0,0 +1,457 @@
+from __future__ import annotations
+
+import base64
+import inspect
+import warnings
+from typing import TYPE_CHECKING, Any, Callable
+from urllib.parse import parse_qs
+
+from aws_lambda_powertools.event_handler.api_gateway import (
+ ApiGatewayResolver,
+ BaseRouter,
+ ProxyEventType,
+ Response,
+ Route,
+)
+from aws_lambda_powertools.event_handler.middlewares.async_utils import wrap_middleware_async
+from aws_lambda_powertools.shared.headers_serializer import BaseHeadersSerializer
+from aws_lambda_powertools.utilities.data_classes.common import BaseProxyEvent
+
+if TYPE_CHECKING:
+ from aws_lambda_powertools.shared.cookies import Cookie
+
+
+class HttpHeadersSerializer(BaseHeadersSerializer):
+ """Headers serializer for native HTTP responses."""
+
+ def serialize(self, headers: dict[str, str | list[str]], cookies: list[Cookie]) -> dict[str, Any]:
+ """Serialize headers for HTTP response format."""
+ combined_headers: dict[str, str] = {}
+ for key, values in headers.items():
+ if values is None: # pragma: no cover
+ continue
+ if isinstance(values, str):
+ combined_headers[key] = values
+ else:
+ combined_headers[key] = ", ".join(values)
+
+ # Add cookies as Set-Cookie headers
+ cookie_headers = [str(cookie) for cookie in cookies] if cookies else []
+
+ return {"headers": combined_headers, "cookies": cookie_headers}
+
+
+class HttpProxyEvent(BaseProxyEvent):
+ """
+ A proxy event that wraps native HTTP request data.
+
+ This allows the same route handlers to work with both Lambda and native HTTP servers.
+ """
+
+ def __init__(
+ self,
+ method: str,
+ path: str,
+ headers: dict[str, str] | None = None,
+ body: str | bytes | None = None,
+ query_string: str | None = None,
+ path_parameters: dict[str, str] | None = None,
+ request_context: dict[str, Any] | None = None,
+ ):
+ # Parse query string
+ query_params: dict[str, str] = {}
+ multi_query_params: dict[str, list[str]] = {}
+
+ if query_string:
+ parsed = parse_qs(query_string, keep_blank_values=True)
+ multi_query_params = parsed
+ query_params = {k: v[-1] for k, v in parsed.items()}
+
+ # Normalize body to string
+ body_str = None
+ if body is not None:
+ body_str = body.decode("utf-8") if isinstance(body, bytes) else body
+
+ # Build the internal dict structure that BaseProxyEvent expects
+ data = {
+ "httpMethod": method.upper(),
+ "path": path,
+ "headers": headers or {},
+ "body": body_str,
+ "isBase64Encoded": False,
+ "queryStringParameters": query_params,
+ "multiValueQueryStringParameters": multi_query_params,
+ "pathParameters": path_parameters or {},
+ "requestContext": request_context
+ or {
+ "stage": "local",
+ "requestId": "local-request-id",
+ "http": {"method": method.upper(), "path": path},
+ },
+ }
+
+ super().__init__(data)
+
+ @classmethod
+ def _from_dict(cls, data: dict[str, Any]) -> HttpProxyEvent:
+ """Create HttpProxyEvent directly from a dict (used internally)."""
+ instance = object.__new__(cls)
+ BaseProxyEvent.__init__(instance, data)
+ return instance
+
+ @classmethod
+ def from_asgi(cls, scope: dict[str, Any], body: bytes | None = None) -> HttpProxyEvent:
+ """
+ Create an HttpProxyEvent from an ASGI scope dict.
+
+ Parameters
+ ----------
+ scope : dict
+ ASGI scope dictionary
+ body : bytes, optional
+ Request body
+
+ Returns
+ -------
+ HttpProxyEvent
+ Event object compatible with Powertools resolvers
+ """
+ # Extract headers from ASGI format [(b"key", b"value"), ...]
+ headers: dict[str, str] = {}
+ for key, value in scope.get("headers", []):
+ header_name = key.decode("utf-8").lower()
+ header_value = value.decode("utf-8")
+ # Handle duplicate headers by joining with comma
+ if header_name in headers:
+ headers[header_name] = f"{headers[header_name]}, {header_value}"
+ else:
+ headers[header_name] = header_value
+
+ return cls(
+ method=scope["method"],
+ path=scope["path"],
+ headers=headers,
+ body=body,
+ query_string=scope.get("query_string", b"").decode("utf-8"),
+ )
+
+ def header_serializer(self) -> BaseHeadersSerializer:
+ """Return the HTTP headers serializer."""
+ return HttpHeadersSerializer()
+
+ @property
+ def resolved_query_string_parameters(self) -> dict[str, list[str]]:
+ """Return query parameters in the format expected by OpenAPI validation."""
+ return self.multi_value_query_string_parameters
+
+ @property
+ def resolved_headers_field(self) -> dict[str, str]:
+ """Return headers in the format expected by OpenAPI validation."""
+ return self.headers
+
+
+class MockLambdaContext:
+ """Minimal Lambda context for HTTP adapter."""
+
+ function_name = "http-resolver"
+ memory_limit_in_mb = 128
+ invoked_function_arn = "arn:aws:lambda:local:000000000000:function:http-resolver"
+ aws_request_id = "local-request-id"
+ log_group_name = "/aws/lambda/http-resolver"
+ log_stream_name = "local"
+
+ def get_remaining_time_in_millis(self) -> int: # pragma: no cover
+ return 300000 # 5 minutes
+
+
+class HttpResolverLocal(ApiGatewayResolver):
+ """
+ ASGI-compatible HTTP resolver for local development and testing.
+
+ This resolver is designed specifically for local development workflows.
+ It allows you to run your Powertools application locally with any ASGI server
+ (uvicorn, hypercorn, daphne, etc.) while maintaining full compatibility with Lambda.
+
+ The same code works in both environments - locally via ASGI and in Lambda via the handler.
+
+ Supports both sync and async route handlers.
+
+ WARNING
+ -------
+ This is intended for local development and testing only.
+ The API may change in future releases. Do not use in production environments.
+
+ Example
+ -------
+ ```python
+ from aws_lambda_powertools.event_handler import HttpResolverLocal
+
+ app = HttpResolverLocal()
+
+ @app.get("/hello/<name>")
+ async def hello(name: str):
+ # Async handler - can use await
+ return {"message": f"Hello, {name}!"}
+
+ @app.get("/sync")
+ def sync_handler():
+ # Sync handlers also work
+ return {"sync": True}
+
+ # Run locally with uvicorn:
+ # uvicorn app:app --reload
+
+ # Deploy to Lambda (sync only):
+ # handler = app
+ ```
+ """
+
+ def __init__(
+ self,
+ cors: Any = None,
+ debug: bool | None = None,
+ serializer: Callable[[dict], str] | None = None,
+ strip_prefixes: list[str | Any] | None = None,
+ enable_validation: bool = False,
+ ):
+ warnings.warn(
+ "HttpResolverLocal is intended for local development and testing only. "
+ "The API may change in future releases. Do not use in production environments.",
+ stacklevel=2,
+ )
+ super().__init__(
+ proxy_type=ProxyEventType.APIGatewayProxyEvent, # Use REST API format internally
+ cors=cors,
+ debug=debug,
+ serializer=serializer,
+ strip_prefixes=strip_prefixes,
+ enable_validation=enable_validation,
+ )
+ self._is_async_mode = False
+
+ def _to_proxy_event(self, event: dict) -> BaseProxyEvent:
+ """Convert event dict to HttpProxyEvent."""
+ # Create HttpProxyEvent directly from the dict data
+ # The dict already has queryStringParameters and multiValueQueryStringParameters
+ return HttpProxyEvent._from_dict(event)
+
+ def _get_base_path(self) -> str:
+ """Return the base path for HTTP resolver (no stage prefix)."""
+ return ""
+
+ async def _resolve_async(self) -> dict: # type: ignore[override]
+ """Async version of resolve that supports async handlers."""
+ method = self.current_event.http_method.upper()
+ path = self._remove_prefix(self.current_event.path)
+
+ registered_routes = self._static_routes + self._dynamic_routes
+
+ for route in registered_routes:
+ if method != route.method:
+ continue
+ match_results = route.rule.match(path)
+ if match_results:
+ self.append_context(_route=route, _path=path)
+ route_keys = self._convert_matches_into_route_keys(match_results)
+ return await self._call_route_async(route, route_keys)
+
+ # Handle not found
+ return await self._handle_not_found_async()
+
+ async def _call_route_async(self, route: Route, route_arguments: dict[str, str]) -> dict: # type: ignore[override]
+ """Call route handler, supporting both sync and async handlers."""
+ from aws_lambda_powertools.event_handler.api_gateway import ResponseBuilder
+
+ try:
+ self._reset_processed_stack()
+
+ # Get the route args (may be modified by validation middleware)
+ self.append_context(_route_args=route_arguments)
+
+ # Run middleware chain (sync for now, handlers can be async)
+ response = await self._run_middleware_chain_async(route)
+
+ response_builder: ResponseBuilder = ResponseBuilder(
+ response=response,
+ serializer=self._serializer,
+ route=route,
+ )
+
+ return response_builder.build(self.current_event, self._cors)
+
+ except Exception as exc:
+ exc_response_builder = self._call_exception_handler(exc, route)
+ if exc_response_builder:
+ return exc_response_builder.build(self.current_event, self._cors)
+ raise
+
+ async def _run_middleware_chain_async(self, route: Route) -> Response:
+ """Run the middleware chain, awaiting async handlers."""
+ # Build middleware list
+ all_middlewares: list[Callable[..., Any]] = []
+
+ # Determine if validation should be enabled for this route
+ # If route has explicit enable_validation setting, use it; otherwise, use resolver's global setting
+ route_validation_enabled = (
+ route.enable_validation if route.enable_validation is not None else self._enable_validation
+ )
+
+ if route_validation_enabled and hasattr(self, "_request_validation_middleware"):
+ all_middlewares.append(self._request_validation_middleware)
+
+ all_middlewares.extend(self._router_middlewares + route.middlewares)
+
+ if route_validation_enabled and hasattr(self, "_response_validation_middleware"):
+ all_middlewares.append(self._response_validation_middleware)
+
+ # Create the final handler that calls the route function
+ async def final_handler(app):
+ route_args = app.context.get("_route_args", {})
+ result = route.func(**route_args)
+
+ # Await if coroutine
+ if inspect.iscoroutine(result):
+ result = await result
+
+ return self._to_response(result)
+
+ # Build middleware chain from end to start
+ next_handler = final_handler
+
+ for middleware in reversed(all_middlewares):
+ next_handler = wrap_middleware_async(middleware, next_handler)
+
+ return await next_handler(self)
+
+ async def _handle_not_found_async(self, method: str = "", path: str = "") -> dict: # type: ignore[override]
+ """Handle 404 responses, using custom not_found handler if registered."""
+ from http import HTTPStatus
+
+ from aws_lambda_powertools.event_handler.api_gateway import ResponseBuilder
+ from aws_lambda_powertools.event_handler.exceptions import NotFoundError
+
+ # Check for custom not_found handler
+ custom_not_found_handler = self.exception_handler_manager.lookup_exception_handler(NotFoundError)
+ if custom_not_found_handler:
+ response = custom_not_found_handler(NotFoundError())
+ else:
+ response = Response(
+ status_code=HTTPStatus.NOT_FOUND.value,
+ content_type="application/json",
+ body={"statusCode": HTTPStatus.NOT_FOUND.value, "message": "Not found"},
+ )
+
+ response_builder: ResponseBuilder = ResponseBuilder(
+ response=response,
+ serializer=self._serializer,
+ route=None,
+ )
+
+ return response_builder.build(self.current_event, self._cors)
+
+ async def asgi_handler(self, scope: dict, receive: Callable, send: Callable) -> None:
+ """
+ ASGI interface - allows running with uvicorn/hypercorn/etc.
+
+ Parameters
+ ----------
+ scope : dict
+ ASGI connection scope
+ receive : Callable
+ ASGI receive function
+ send : Callable
+ ASGI send function
+ """
+ if scope["type"] == "lifespan":
+ # Handle lifespan events (startup/shutdown)
+ while True:
+ message = await receive()
+ if message["type"] == "lifespan.startup":
+ await send({"type": "lifespan.startup.complete"})
+ elif message["type"] == "lifespan.shutdown":
+ await send({"type": "lifespan.shutdown.complete"})
+ return
+
+ if scope["type"] != "http":
+ return
+
+ # Read request body
+ body = b""
+ while True:
+ message = await receive()
+ body += message.get("body", b"")
+ if not message.get("more_body", False):
+ break
+
+ # Convert ASGI scope to HttpProxyEvent
+ event = HttpProxyEvent.from_asgi(scope, body)
+
+ # Create mock Lambda context
+ context: Any = MockLambdaContext()
+
+ # Set up resolver state (similar to resolve())
+ BaseRouter.current_event = self._to_proxy_event(event._data)
+ BaseRouter.lambda_context = context
+
+ self._is_async_mode = True
+
+ try:
+ # Use async resolve
+ response = await self._resolve_async()
+ finally:
+ self._is_async_mode = False
+ self.clear_context()
+
+ # Send HTTP response
+ await self._send_response(send, response)
+
+ async def __call__( # type: ignore[override]
+ self,
+ scope: dict,
+ receive: Callable,
+ send: Callable,
+ ) -> None:
+ """ASGI interface - allows running with uvicorn/hypercorn/etc."""
+ await self.asgi_handler(scope, receive, send)
+
+ async def _send_response(self, send: Callable, response: dict) -> None:
+ """Send the response via ASGI."""
+ status_code = response.get("statusCode", 200)
+ headers = response.get("headers", {})
+ cookies = response.get("cookies", [])
+ body = response.get("body", "")
+ is_base64 = response.get("isBase64Encoded", False)
+
+ # Build headers list for ASGI
+ header_list: list[tuple[bytes, bytes]] = []
+ for key, value in headers.items():
+ header_list.append((key.lower().encode(), str(value).encode()))
+
+ # Add Set-Cookie headers
+ for cookie in cookies:
+ header_list.append((b"set-cookie", str(cookie).encode()))
+
+ # Send response start
+ await send(
+ {
+ "type": "http.response.start",
+ "status": status_code,
+ "headers": header_list,
+ },
+ )
+
+ # Prepare body
+ if is_base64:
+ body_bytes = base64.b64decode(body)
+ elif isinstance(body, str):
+ body_bytes = body.encode("utf-8")
+ else: # pragma: no cover
+ body_bytes = body
+
+ # Send response body
+ await send(
+ {
+ "type": "http.response.body",
+ "body": body_bytes,
+ },
+ )
diff --git a/aws_lambda_powertools/event_handler/lambda_function_url.py b/aws_lambda_powertools/event_handler/lambda_function_url.py
index 6d5924e79b9..cbd92a00b6e 100644
--- a/aws_lambda_powertools/event_handler/lambda_function_url.py
+++ b/aws_lambda_powertools/event_handler/lambda_function_url.py
@@ -1,8 +1,14 @@
-from typing import Callable, Dict, List, Optional
+from __future__ import annotations
-from aws_lambda_powertools.event_handler import CORSConfig
-from aws_lambda_powertools.event_handler.api_gateway import ApiGatewayResolver, ProxyEventType
-from aws_lambda_powertools.utilities.data_classes import LambdaFunctionUrlEvent
+from typing import TYPE_CHECKING
+
+from aws_lambda_powertools.event_handler.api_gateway import (
+ ApiGatewayResolver,
+ ProxyEventType,
+)
+
+if TYPE_CHECKING:
+ from aws_lambda_powertools.utilities.data_classes import LambdaFunctionUrlEvent
class LambdaFunctionUrlResolver(ApiGatewayResolver):
@@ -42,12 +48,10 @@ def lambda_handler(event, context):
"""
current_event: LambdaFunctionUrlEvent
+ _proxy_event_type = ProxyEventType.LambdaFunctionUrlEvent
- def __init__(
- self,
- cors: Optional[CORSConfig] = None,
- debug: Optional[bool] = None,
- serializer: Optional[Callable[[Dict], str]] = None,
- strip_prefixes: Optional[List[str]] = None,
- ):
- super().__init__(ProxyEventType.LambdaFunctionUrlEvent, cors, debug, serializer, strip_prefixes)
+ def _get_base_path(self) -> str:
+ stage = self.current_event.request_context.stage
+ if stage and stage != "$default" and self.current_event.request_context.http.method.startswith(f"/{stage}"):
+ return f"/{stage}"
+ return ""
diff --git a/aws_lambda_powertools/event_handler/middlewares/__init__.py b/aws_lambda_powertools/event_handler/middlewares/__init__.py
new file mode 100644
index 00000000000..068ce9c04b7
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/middlewares/__init__.py
@@ -0,0 +1,3 @@
+from aws_lambda_powertools.event_handler.middlewares.base import BaseMiddlewareHandler, NextMiddleware
+
+__all__ = ["BaseMiddlewareHandler", "NextMiddleware"]
diff --git a/aws_lambda_powertools/event_handler/middlewares/async_utils.py b/aws_lambda_powertools/event_handler/middlewares/async_utils.py
new file mode 100644
index 00000000000..4f375bc9b0b
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/middlewares/async_utils.py
@@ -0,0 +1,224 @@
+"""Async middleware utilities for bridging sync and async middleware execution."""
+
+from __future__ import annotations
+
+import asyncio
+import inspect
+import logging
+import threading
+from typing import TYPE_CHECKING, Any
+
+logger = logging.getLogger(__name__)
+
+if TYPE_CHECKING:
+ from collections.abc import Callable
+
+ from aws_lambda_powertools.event_handler.api_gateway import ApiGatewayResolver, BedrockResponse, Response
+
+
+def wrap_middleware_async(middleware: Callable, next_handler: Callable) -> Callable:
+ """Wrap a middleware to work in an async context.
+
+ For async middlewares, delegates directly with ``await``.
+
+ For sync middlewares, runs the middleware in a background thread and uses
+ ``asyncio.Event`` / ``threading.Event`` to coordinate the ``next()`` call
+ so the async handler can be awaited on the main event-loop while the sync
+ middleware blocks its own thread waiting for the result.
+
+ Parameters
+ ----------
+ middleware : Callable
+ A sync or async middleware ``(app, next_middleware) -> Response``.
+ next_handler : Callable
+ The next (async) handler in the chain.
+
+ Returns
+ -------
+ Callable
+ An async callable ``(app) -> Response`` that executes *middleware*
+ followed by *next_handler*.
+ """
+
+ async def wrapped(app: ApiGatewayResolver) -> Response:
+ if inspect.iscoroutinefunction(middleware):
+ return await middleware(app, next_handler)
+
+ return await _run_sync_middleware_in_thread(middleware, next_handler, app)
+
+ return wrapped
+
+
+async def _run_sync_middleware_in_thread(
+ middleware: Callable,
+ next_handler: Callable,
+ app: Any,
+) -> Any:
+ """Execute a **sync** middleware inside a daemon thread.
+
+ The sync middleware calls ``sync_next(app)`` which:
+
+ 1. Signals the async side that the middleware is ready for the next handler.
+ 2. Blocks the thread until the async handler has produced a response.
+ 3. Returns the response so the middleware can do post-processing.
+
+ Meanwhile the async side awaits *next_handler*, feeds the response back,
+ and waits for the thread to finish.
+ """
+ middleware_called_next = asyncio.Event()
+ next_app_holder: list = []
+ real_response_holder: list = []
+ middleware_result_holder: list = []
+ middleware_error_holder: list = []
+
+ def sync_next(app: Any) -> Any:
+ next_app_holder.append(app)
+ middleware_called_next.set()
+ # Block this thread until the async handler resolves
+ event = threading.Event()
+ next_app_holder.append(event)
+ event.wait()
+ return real_response_holder[0]
+
+ def run_middleware() -> None:
+ try:
+ result = middleware(app, sync_next)
+ middleware_result_holder.append(result)
+ except Exception as e:
+ middleware_error_holder.append(e)
+ finally:
+ middleware_called_next.set()
+
+ thread = threading.Thread(target=run_middleware, daemon=True)
+ thread.start()
+
+ # Wait for the middleware to call next() or raise
+ await middleware_called_next.wait()
+
+ # If middleware raised before calling next, propagate immediately
+ if not next_app_holder:
+ thread.join()
+ raise middleware_error_holder[0]
+
+ # Resolve the async next_handler on the event-loop
+ real_response = await next_handler(next_app_holder[0])
+ real_response_holder.append(real_response)
+
+ # Unblock the middleware thread
+ threading_event = next_app_holder[1]
+ threading_event.set()
+
+ # Wait for the middleware thread to complete post-processing
+ thread.join()
+
+ if middleware_error_holder:
+ raise middleware_error_holder[0]
+
+ return middleware_result_holder[0]
+
+
+class AsyncMiddlewareFrame:
+ """Async version of MiddlewareFrame for the async middleware chain.
+
+ Each instance wraps a middleware (sync or async) and the next handler in the stack.
+ When called, it auto-detects whether the current middleware is sync or async:
+
+ - **Async middleware**: awaited directly with ``(app, next_middleware)``
+ - **Sync middleware**: executed in a background thread so the event loop is never blocked
+
+ Parameters
+ ----------
+ current_middleware : Callable
+ The current middleware function to be called as a request is processed.
+ next_middleware : Callable
+ The next middleware in the middleware stack.
+ """
+
+ def __init__(
+ self,
+ current_middleware: Callable[..., Any],
+ next_middleware: Callable[..., Any],
+ ) -> None:
+ self.current_middleware: Callable[..., Any] = current_middleware
+ self.next_middleware: Callable[..., Any] = next_middleware
+ self._next_middleware_name = next_middleware.__name__
+
+ @property
+ def __name__(self) -> str: # noqa: A003
+ return self.current_middleware.__name__
+
+ def __str__(self) -> str:
+ middleware_name = self.__name__
+ return f"[{middleware_name}] next call chain is {middleware_name} -> {self._next_middleware_name}"
+
+ async def __call__(self, app: ApiGatewayResolver) -> dict | tuple | Response:
+ logger.debug("AsyncMiddlewareFrame: %s", self)
+ app._push_processed_stack_frame(str(self))
+
+ if inspect.iscoroutinefunction(self.current_middleware):
+ return await self.current_middleware(app, self.next_middleware)
+
+ loop = asyncio.get_running_loop()
+
+ def sync_next(app: ApiGatewayResolver) -> Any:
+ future = asyncio.run_coroutine_threadsafe(self.next_middleware(app), loop)
+ return future.result()
+
+ return await asyncio.to_thread(self.current_middleware, app, sync_next)
+
+
+async def _registered_api_adapter_async(
+ app: ApiGatewayResolver,
+ next_middleware: Callable[..., Any],
+) -> dict | tuple | Response | BedrockResponse:
+ """
+ Async version of _registered_api_adapter.
+
+ Detects if the route handler is a coroutine and awaits it.
+ _to_response() stays sync (CPU-bound — no async benefit).
+
+ IMPORTANT: This is an internal building block only.
+ Nothing calls it in the resolve chain yet. It will be used
+ by resolve_async() (see issue #8137).
+
+ Parameters
+ ----------
+ app: ApiGatewayResolver
+ The API Gateway resolver
+ next_middleware: Callable[..., Any]
+ The function to handle the API
+
+ Returns
+ -------
+ Response
+ The API Response Object
+ """
+ route_args: dict = app.context.get("_route_args", {})
+ logger.debug(f"Calling API Route Handler: {route_args}")
+
+ route = app.context.get("_route")
+ if route is not None:
+ if not route.request_param_name_checked:
+ from aws_lambda_powertools.event_handler.api_gateway import _find_request_param_name
+
+ route.request_param_name = _find_request_param_name(next_middleware)
+ route.request_param_name_checked = True
+ if route.request_param_name:
+ route_args = {**route_args, route.request_param_name: app.request}
+
+ if route.has_dependencies:
+ from aws_lambda_powertools.event_handler.depends import build_dependency_tree, solve_dependencies
+
+ dep_values = solve_dependencies(
+ dependant=build_dependency_tree(route.func),
+ request=app.request,
+ dependency_overrides=app.dependency_overrides or None,
+ )
+ route_args.update(dep_values)
+
+ # Call handler — detect if result is a coroutine and await it
+ result = next_middleware(**route_args)
+ if inspect.iscoroutine(result):
+ result = await result
+
+ return app._to_response(result)
diff --git a/aws_lambda_powertools/event_handler/middlewares/base.py b/aws_lambda_powertools/event_handler/middlewares/base.py
new file mode 100644
index 00000000000..538338abf7c
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/middlewares/base.py
@@ -0,0 +1,121 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import TYPE_CHECKING, Generic, Protocol
+
+from aws_lambda_powertools.event_handler.types import EventHandlerInstance
+
+if TYPE_CHECKING:
+ from aws_lambda_powertools.event_handler.api_gateway import Response
+
+
+class NextMiddleware(Protocol):
+ def __call__(self, app: EventHandlerInstance) -> Response:
+ """Protocol for callback regardless of next_middleware(app), get_response(app) etc"""
+ ...
+
+ def __name__(self) -> str: # noqa A003
+ """Protocol for name of the Middleware"""
+ ...
+
+
+class BaseMiddlewareHandler(ABC, Generic[EventHandlerInstance]):
+ """Base implementation for Middlewares to run code before and after in a chain.
+
+
+ This is the middleware handler function where middleware logic is implemented.
+ The next middleware handler is represented by `next_middleware`, returning a Response object.
+
+ Example
+ --------
+
+ **Correlation ID Middleware**
+
+ ```python
+ import requests
+
+ from aws_lambda_powertools import Logger
+ from aws_lambda_powertools.event_handler import APIGatewayRestResolver, Response
+ from aws_lambda_powertools.event_handler.middlewares import BaseMiddlewareHandler, NextMiddleware
+
+ app = APIGatewayRestResolver()
+ logger = Logger()
+
+
+ class CorrelationIdMiddleware(BaseMiddlewareHandler):
+ def __init__(self, header: str):
+ super().__init__()
+ self.header = header
+
+ def handler(self, app: APIGatewayRestResolver, next_middleware: NextMiddleware) -> Response:
+ # BEFORE logic
+ request_id = app.current_event.request_context.request_id
+ correlation_id = app.current_event.headers.get(self.header, request_id)
+
+ # Call next middleware or route handler ('/todos')
+ response = next_middleware(app)
+
+ # AFTER logic
+ response.headers[self.header] = correlation_id
+
+ return response
+
+
+ @app.get("/todos", middlewares=[CorrelationIdMiddleware(header="x-correlation-id")])
+ def get_todos():
+ todos: requests.Response = requests.get("https://jsonplaceholder.typicode.com/todos")
+ todos.raise_for_status()
+
+ # for brevity, we'll limit to the first 10 only
+ return {"todos": todos.json()[:10]}
+
+
+ @logger.inject_lambda_context
+ def lambda_handler(event, context):
+ return app.resolve(event, context)
+
+ ```
+
+ """
+
+ @abstractmethod
+ def handler(self, app: EventHandlerInstance, next_middleware: NextMiddleware) -> Response:
+ """
+ The Middleware Handler
+
+ Parameters
+ ----------
+ app: EventHandlerInstance
+ An instance of an Event Handler that implements ApiGatewayResolver
+ next_middleware: NextMiddleware
+ The next middleware handler in the chain
+
+ Returns
+ -------
+ Response
+ The response from the next middleware handler in the chain
+
+ """
+ raise NotImplementedError()
+
+ @property
+ def __name__(self) -> str: # noqa A003
+ return str(self.__class__.__name__)
+
+ def __call__(self, app: EventHandlerInstance, next_middleware: NextMiddleware) -> Response:
+ """
+ The Middleware handler function.
+
+ Parameters
+ ----------
+ app: ApiGatewayResolver
+ An instance of an Event Handler that implements ApiGatewayResolver
+ next_middleware: NextMiddleware
+ The next middleware handler in the chain
+
+ Returns
+ -------
+ Response
+ The response from the next middleware handler in the chain
+ """
+ return self.handler(app, next_middleware)
diff --git a/aws_lambda_powertools/event_handler/middlewares/openapi_validation.py b/aws_lambda_powertools/event_handler/middlewares/openapi_validation.py
new file mode 100644
index 00000000000..470a19e6c54
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/middlewares/openapi_validation.py
@@ -0,0 +1,755 @@
+from __future__ import annotations
+
+import base64
+import dataclasses
+import json
+import logging
+import warnings
+from typing import TYPE_CHECKING, Any, Callable, Mapping, MutableMapping, Sequence, Union, cast
+from urllib.parse import parse_qs
+
+from pydantic import BaseModel
+from typing_extensions import get_args, get_origin
+
+from aws_lambda_powertools.event_handler.middlewares import BaseMiddlewareHandler
+from aws_lambda_powertools.event_handler.openapi.compat import (
+ _model_dump,
+ _normalize_errors,
+ _regenerate_error_with_loc,
+ field_annotation_is_sequence,
+ get_missing_field_error,
+ lenient_issubclass,
+)
+from aws_lambda_powertools.event_handler.openapi.dependant import is_scalar_field
+from aws_lambda_powertools.event_handler.openapi.encoders import jsonable_encoder
+from aws_lambda_powertools.event_handler.openapi.exceptions import (
+ RequestUnsupportedContentType,
+ RequestValidationError,
+ ResponseValidationError,
+)
+from aws_lambda_powertools.event_handler.openapi.params import Param, UploadFile
+from aws_lambda_powertools.event_handler.openapi.types import UnionType
+
+if TYPE_CHECKING:
+ from pydantic.fields import FieldInfo
+
+ from aws_lambda_powertools.event_handler import Response
+ from aws_lambda_powertools.event_handler.api_gateway import Route
+ from aws_lambda_powertools.event_handler.middlewares import NextMiddleware
+ from aws_lambda_powertools.event_handler.openapi.compat import ModelField
+ from aws_lambda_powertools.event_handler.openapi.types import IncEx
+ from aws_lambda_powertools.event_handler.types import EventHandlerInstance
+
+logger = logging.getLogger(__name__)
+
+# Constants
+CONTENT_DISPOSITION_NAME_PARAM = "name="
+APPLICATION_JSON_CONTENT_TYPE = "application/json"
+APPLICATION_FORM_CONTENT_TYPE = "application/x-www-form-urlencoded"
+MULTIPART_FORM_DATA_CONTENT_TYPE = "multipart/form-data"
+
+
+class OpenAPIRequestValidationMiddleware(BaseMiddlewareHandler):
+ """
+ OpenAPI request validation middleware - validates only incoming requests.
+
+ This middleware should be used first in the middleware chain to validate
+ requests before they reach user middlewares.
+ """
+
+ def __init__(self):
+ """Initialize the request validation middleware."""
+ pass
+
+ def handler(self, app: EventHandlerInstance, next_middleware: NextMiddleware) -> Response:
+ logger.debug("OpenAPIRequestValidationMiddleware handler")
+
+ route: Route = app.context["_route"]
+
+ values: dict[str, Any] = {}
+ errors: list[Any] = []
+
+ # Process path values, which can be found on the route_args
+ path_values, path_errors = _request_params_to_args(
+ route.dependant.path_params,
+ app.context["_route_args"],
+ )
+
+ # Normalize query values before validate this
+ query_string = _normalize_multi_params(
+ app.current_event.resolved_query_string_parameters,
+ route.dependant.query_params,
+ )
+
+ # Process query values
+ query_values, query_errors = _request_params_to_args(
+ route.dependant.query_params,
+ query_string,
+ )
+
+ # Normalize header values before validate this
+ headers = _normalize_multi_params(
+ app.current_event.resolved_headers_field,
+ route.dependant.header_params,
+ )
+
+ # Process header values
+ header_values, header_errors = _request_params_to_args(
+ route.dependant.header_params,
+ headers,
+ )
+
+ # Process cookie values
+ cookie_values, cookie_errors = _request_params_to_args(
+ route.dependant.cookie_params,
+ app.current_event.resolved_cookies_field,
+ )
+
+ values.update(path_values)
+ values.update(query_values)
+ values.update(header_values)
+ values.update(cookie_values)
+ errors += path_errors + query_errors + header_errors + cookie_errors
+
+ # Process the request body, if it exists
+ if route.dependant.body_params:
+ (body_values, body_errors) = _request_body_to_args(
+ required_params=route.dependant.body_params,
+ received_body=self._get_body(app),
+ )
+ values.update(body_values)
+ errors.extend(body_errors)
+
+ if errors:
+ # Raise the validation errors
+ raise RequestValidationError(_normalize_errors(errors))
+
+ # Re-write the route_args with the validated values
+ app.context["_route_args"] = values
+
+ # Call the next middleware
+ return next_middleware(app)
+
+ def _get_body(self, app: EventHandlerInstance) -> dict[str, Any]:
+ """
+ Get the request body from the event, and parse it according to content type.
+ """
+ content_type = app.current_event.headers.get("content-type", "").strip()
+
+ # Handle JSON content
+ if not content_type or content_type.startswith(APPLICATION_JSON_CONTENT_TYPE):
+ return self._parse_json_data(app)
+
+ # Handle URL-encoded form data
+ elif content_type.startswith(APPLICATION_FORM_CONTENT_TYPE):
+ return self._parse_form_data(app)
+
+ # Handle multipart/form-data (file uploads)
+ elif content_type.startswith(MULTIPART_FORM_DATA_CONTENT_TYPE):
+ return self._parse_multipart_data(app, content_type)
+
+ else:
+ raise RequestUnsupportedContentType(
+ "Unsupported content type",
+ errors=[
+ {
+ "type": "unsupported_content_type",
+ "loc": ("body",),
+ "msg": f"Unsupported content type: {content_type}",
+ "input": {},
+ "ctx": {},
+ },
+ ],
+ )
+
+ def _parse_json_data(self, app: EventHandlerInstance) -> dict[str, Any]:
+ """Parse JSON data from the request body."""
+ try:
+ return app.current_event.json_body
+ except json.JSONDecodeError as e:
+ raise RequestValidationError(
+ [
+ {
+ "type": "json_invalid",
+ "loc": ("body", e.pos),
+ "msg": "JSON decode error",
+ "input": {},
+ "ctx": {"error": e.msg},
+ },
+ ],
+ body=e.doc,
+ ) from e
+
+ def _parse_form_data(self, app: EventHandlerInstance) -> dict[str, Any]:
+ """Parse URL-encoded form data from the request body."""
+ try:
+ body = app.current_event.decoded_body or ""
+ # NOTE: Keep values as lists; we'll normalize per-field later based on the expected type.
+ # This avoids breaking List[...] fields when only a single value is provided.
+ parsed = parse_qs(body, keep_blank_values=True)
+ return parsed
+
+ except Exception as e: # pragma: no cover
+ raise RequestValidationError( # pragma: no cover
+ [
+ {
+ "type": "form_invalid",
+ "loc": ("body",),
+ "msg": "Form data parsing error",
+ "input": {},
+ "ctx": {"error": str(e)},
+ },
+ ],
+ ) from e
+
+ def _parse_multipart_data(self, app: EventHandlerInstance, content_type: str) -> dict[str, Any]:
+ """Parse multipart/form-data from the request body (file uploads)."""
+ try:
+ # Extract the boundary from the content-type header
+ boundary = _extract_multipart_boundary(content_type)
+ if not boundary:
+ raise ValueError("Missing boundary in multipart/form-data content-type header")
+
+ # Get raw body bytes
+ raw_body = app.current_event.body or ""
+ if app.current_event.is_base64_encoded:
+ body_bytes = base64.b64decode(raw_body)
+ else:
+ warnings.warn(
+ "Received multipart/form-data without base64 encoding. "
+ "Binary file uploads may be corrupted. "
+ "If using API Gateway REST API (v1), configure Binary Media Types "
+ "to include 'multipart/form-data'. "
+ "See: https://docs.aws.amazon.com/apigateway/latest/developerguide/"
+ "api-gateway-payload-encodings.html",
+ stacklevel=2,
+ )
+ # Use latin-1 to preserve all byte values (0-255) since the body
+ # may contain raw binary data that isn't valid UTF-8
+ body_bytes = raw_body.encode("latin-1")
+
+ return _parse_multipart_body(body_bytes, boundary)
+
+ except ValueError:
+ raise
+ except Exception as e:
+ raise RequestValidationError(
+ [
+ {
+ "type": "multipart_invalid",
+ "loc": ("body",),
+ "msg": "Multipart form data parsing error",
+ "input": {},
+ "ctx": {"error": str(e)},
+ },
+ ],
+ ) from e
+
+
+class OpenAPIResponseValidationMiddleware(BaseMiddlewareHandler):
+ """
+ OpenAPI response validation middleware - validates only outgoing responses.
+
+ This middleware should be used last in the middleware chain to validate
+ responses only from route handlers, not from user middlewares.
+ """
+
+ def __init__(
+ self,
+ validation_serializer: Callable[[Any], str] | None = None,
+ has_response_validation_error: bool = False,
+ ):
+ """
+ Initialize the response validation middleware.
+
+ Parameters
+ ----------
+ validation_serializer : Callable, optional
+ Optional serializer to use when serializing the response for validation.
+ Use it when you have a custom type that cannot be serialized by the default jsonable_encoder.
+
+ has_response_validation_error: bool, optional
+ Optional flag used to distinguish between payload and validation errors.
+ By setting this flag to True, ResponseValidationError will be raised if response could not be validated.
+ """
+ self._validation_serializer = validation_serializer
+ self._has_response_validation_error = has_response_validation_error
+
+ def handler(self, app: EventHandlerInstance, next_middleware: NextMiddleware) -> Response:
+ logger.debug("OpenAPIResponseValidationMiddleware handler")
+
+ route: Route = app.context["_route"]
+
+ # Call the next middleware (should be the route handler)
+ response = next_middleware(app)
+
+ # Process the response
+ return self._handle_response(route=route, response=response)
+
+ def _handle_response(self, *, route: Route, response: Response):
+ field = route.dependant.return_param
+
+ if field is None:
+ if not response.is_json():
+ return response
+ else:
+ # JSON serialize the body without validation
+ response.body = jsonable_encoder(response.body, custom_serializer=self._validation_serializer)
+ else:
+ # ALB resolver converts None body to "" to prevent ALB 5xx errors,
+ # but the validation should still see it as None.
+ response_content = None if response.body == "" and field.type_ in (None, type(None)) else response.body
+
+ response.body = self._serialize_response_with_validation(
+ field=field,
+ response_content=response_content,
+ has_route_custom_response_validation=route.custom_response_validation_http_code is not None,
+ )
+
+ return response
+
+ def _serialize_response_with_validation(
+ self,
+ *,
+ field: ModelField,
+ response_content: Any,
+ include: IncEx | None = None,
+ exclude: IncEx | None = None,
+ by_alias: bool = True,
+ exclude_unset: bool = False,
+ exclude_defaults: bool = False,
+ exclude_none: bool = False,
+ has_route_custom_response_validation: bool = False,
+ ) -> Any:
+ """
+ Serialize the response content according to the field type.
+ """
+ errors: list[dict[str, Any]] = []
+ value = _validate_field(field=field, value=response_content, loc=("response",), existing_errors=errors)
+ if errors:
+ # route-level validation must take precedence over app-level
+ if has_route_custom_response_validation:
+ raise ResponseValidationError(
+ errors=_normalize_errors(errors),
+ body=response_content,
+ source="route",
+ )
+ if self._has_response_validation_error:
+ raise ResponseValidationError(errors=_normalize_errors(errors), body=response_content, source="app")
+
+ raise RequestValidationError(errors=_normalize_errors(errors), body=response_content)
+
+ if hasattr(field, "serialize"):
+ return field.serialize(
+ value,
+ include=include,
+ exclude=exclude,
+ by_alias=by_alias,
+ exclude_unset=exclude_unset,
+ exclude_defaults=exclude_defaults,
+ exclude_none=exclude_none,
+ )
+
+ return jsonable_encoder(
+ value,
+ include=include,
+ exclude=exclude,
+ by_alias=by_alias,
+ exclude_unset=exclude_unset,
+ exclude_defaults=exclude_defaults,
+ exclude_none=exclude_none,
+ custom_serializer=self._validation_serializer,
+ )
+
+ def _prepare_response_content(
+ self,
+ res: Any,
+ *,
+ exclude_unset: bool,
+ exclude_defaults: bool = False,
+ exclude_none: bool = False,
+ ) -> Any:
+ """
+ Prepares the response content for serialization.
+ """
+ if isinstance(res, BaseModel): # pragma: no cover
+ return _model_dump( # pragma: no cover
+ res,
+ by_alias=True,
+ exclude_unset=exclude_unset,
+ exclude_defaults=exclude_defaults,
+ exclude_none=exclude_none,
+ )
+ elif isinstance(res, list): # pragma: no cover
+ return [ # pragma: no cover
+ self._prepare_response_content(item, exclude_unset=exclude_unset, exclude_defaults=exclude_defaults)
+ for item in res
+ ]
+ elif isinstance(res, dict): # pragma: no cover
+ return { # pragma: no cover
+ k: self._prepare_response_content(v, exclude_unset=exclude_unset, exclude_defaults=exclude_defaults)
+ for k, v in res.items()
+ }
+ elif dataclasses.is_dataclass(res): # pragma: no cover
+ return dataclasses.asdict(res) # type: ignore[arg-type] # pragma: no cover
+ return res # pragma: no cover
+
+
+def _request_params_to_args(
+ required_params: Sequence[ModelField],
+ received_params: Mapping[str, Any],
+) -> tuple[dict[str, Any], list[dict[str, Any]]]:
+ """
+ Convert the request params to a dictionary of values using validation, and returns a list of errors.
+ """
+ values: dict[str, Any] = {}
+ errors: list[dict[str, Any]] = []
+
+ for field in required_params:
+ field_info = field.field_info
+
+ # To ensure early failure, we check if it's not an instance of Param.
+ if not isinstance(field_info, Param):
+ raise AssertionError(f"Expected Param field_info, got {field_info}")
+
+ loc = (field_info.in_.value, field.alias)
+ value = received_params.get(field.alias)
+
+ # If we don't have a value, see if it's required or has a default
+ if value is None:
+ _handle_missing_field_value(field, values, errors, loc)
+ continue
+
+ # Finally, validate the value
+ values[field.name] = _validate_field(field=field, value=value, loc=loc, existing_errors=errors)
+
+ return values, errors
+
+
+def _request_body_to_args(
+ required_params: list[ModelField],
+ received_body: dict[str, Any] | None,
+) -> tuple[dict[str, Any], list[dict[str, Any]]]:
+ """
+ Convert the request body to a dictionary of values using validation, and returns a list of errors.
+ """
+ values: dict[str, Any] = {}
+ errors: list[dict[str, Any]] = []
+
+ received_body, field_alias_omitted = _get_embed_body(
+ field=required_params[0],
+ required_params=required_params,
+ received_body=received_body,
+ )
+
+ for field in required_params:
+ loc = _get_body_field_location(field, field_alias_omitted)
+ value = _extract_field_value_from_body(field, received_body, loc, errors)
+
+ # If we don't have a value, see if it's required or has a default
+ if value is None:
+ _handle_missing_field_value(field, values, errors, loc)
+ continue
+
+ value = _normalize_field_value(value=value, field_info=field.field_info)
+
+ # UploadFile objects bypass Pydantic validation — they're already constructed
+ if isinstance(value, UploadFile):
+ values[field.name] = value
+ else:
+ values[field.name] = _validate_field(field=field, value=value, loc=loc, existing_errors=errors)
+
+ return values, errors
+
+
+def _get_body_field_location(field: ModelField, field_alias_omitted: bool) -> tuple[str, ...]:
+ """Get the location tuple for a body field based on whether the field alias is omitted."""
+ if field_alias_omitted:
+ return ("body",)
+ return ("body", field.alias)
+
+
+def _extract_field_value_from_body(
+ field: ModelField,
+ received_body: dict[str, Any] | None,
+ loc: tuple[str, ...],
+ errors: list[dict[str, Any]],
+) -> Any | None:
+ """Extract field value from the received body, handling potential AttributeError."""
+ if received_body is None:
+ return None
+
+ try:
+ return received_body.get(field.alias)
+ except AttributeError:
+ errors.append(get_missing_field_error(loc))
+ return None
+
+
+def _handle_missing_field_value(
+ field: ModelField,
+ values: dict[str, Any],
+ errors: list[dict[str, Any]],
+ loc: tuple[str, ...],
+) -> None:
+ """Handle the case when a field value is missing."""
+ if field.required:
+ errors.append(get_missing_field_error(loc))
+ else:
+ values[field.name] = field.get_default()
+
+
+def _is_or_contains_sequence(annotation: Any) -> bool:
+ """
+ Check if annotation is a sequence or Union/RootModel containing a sequence.
+
+ This function handles complex type annotations like:
+ - List[Model] - direct sequence
+ - Union[Model, List[Model]] - checks if any Union member is a sequence
+ - Optional[List[Model]] - Union[List[Model], None]
+ - RootModel[List[Model]] - checks if the RootModel wraps a sequence
+ - Optional[RootModel[List[Model]]] - Union member that is a RootModel
+ - RootModel[Union[Model, List[Model]]] - RootModel wrapping a Union with a sequence
+ """
+ # Direct sequence check
+ if field_annotation_is_sequence(annotation):
+ return True
+
+ # Check Union members — recurse so we catch RootModel inside Union
+ origin = get_origin(annotation)
+ if origin is Union or origin is UnionType:
+ for arg in get_args(annotation):
+ if _is_or_contains_sequence(arg):
+ return True
+
+ # Check if it's a RootModel wrapping a sequence (or Union containing a sequence)
+ if lenient_issubclass(annotation, BaseModel) and getattr(annotation, "__pydantic_root_model__", False):
+ if hasattr(annotation, "model_fields") and "root" in annotation.model_fields:
+ root_annotation = annotation.model_fields["root"].annotation
+ return _is_or_contains_sequence(root_annotation)
+
+ return False
+
+
+def _normalize_field_value(value: Any, field_info: FieldInfo) -> Any:
+ """Normalize field value, converting lists to single values for non-sequence fields."""
+ # When annotation is bytes but value is UploadFile, extract raw content
+ if isinstance(value, UploadFile) and field_info.annotation is bytes:
+ return value.content
+
+ if _is_or_contains_sequence(field_info.annotation):
+ return value
+ elif isinstance(value, list) and value:
+ return value[0]
+
+ return value
+
+
+def _validate_field(
+ *,
+ field: ModelField,
+ value: Any,
+ loc: tuple[str, ...],
+ existing_errors: list[dict[str, Any]],
+):
+ """
+ Validate a field, and append any errors to the existing_errors list.
+ """
+ validated_value, errors = field.validate(value=value, loc=loc)
+
+ if isinstance(errors, list):
+ processed_errors = _regenerate_error_with_loc(errors=errors, loc_prefix=())
+ existing_errors.extend(processed_errors)
+ elif errors:
+ existing_errors.append(errors)
+
+ return validated_value
+
+
+def _get_embed_body(
+ *,
+ field: ModelField,
+ required_params: list[ModelField],
+ received_body: dict[str, Any] | None,
+) -> tuple[dict[str, Any] | None, bool]:
+ field_info = field.field_info
+ embed = getattr(field_info, "embed", None)
+
+ # If the field is an embed, and the field alias is omitted, we need to wrap the received body in the field alias.
+ field_alias_omitted = len(required_params) == 1 and not embed
+ if field_alias_omitted:
+ received_body = {field.alias: received_body}
+
+ return received_body, field_alias_omitted
+
+
+def _normalize_multi_params(
+ input_dict: MutableMapping[str, Any],
+ params: Sequence[ModelField],
+) -> MutableMapping[str, Any]:
+ """
+ Extract and normalize query string or header parameters with Pydantic model support.
+
+ Parameters
+ ----------
+ input_dict: MutableMapping[str, Any]
+ A dictionary containing the initial query string or header parameters.
+ params: Sequence[ModelField]
+ A sequence of ModelField objects representing parameters.
+
+ Returns
+ -------
+ MutableMapping[str, Any]
+ A dictionary containing the processed parameters with normalized values.
+ """
+ for param in params:
+ if is_scalar_field(param):
+ _process_scalar_param(input_dict, param)
+ elif lenient_issubclass(param.field_info.annotation, BaseModel):
+ _process_model_param(input_dict, param)
+ return input_dict
+
+
+def _process_scalar_param(input_dict: MutableMapping[str, Any], param: ModelField) -> None:
+ """Process a scalar parameter by normalizing single-item lists."""
+ try:
+ value = input_dict[param.alias]
+ if isinstance(value, list) and len(value) == 1:
+ input_dict[param.alias] = value[0]
+ except KeyError:
+ pass
+
+
+def _process_model_param(input_dict: MutableMapping[str, Any], param: ModelField) -> None:
+ """Process a Pydantic model parameter by extracting model fields."""
+ model_class = cast(type[BaseModel], param.field_info.annotation)
+
+ model_data = {}
+ for field_name, field_info in model_class.model_fields.items():
+ field_alias = field_info.alias or field_name
+ value = _get_param_value(input_dict, field_alias, field_name, model_class)
+
+ if value is not None:
+ model_data[field_alias] = _normalize_field_value(value=value, field_info=field_info)
+
+ input_dict[param.alias] = model_data
+
+
+def _get_param_value(
+ input_dict: MutableMapping[str, Any],
+ field_alias: str,
+ field_name: str,
+ model_class: type[BaseModel],
+) -> Any:
+ """Get parameter value, checking both alias and field name if needed."""
+ value = input_dict.get(field_alias)
+ if value is not None:
+ return value
+
+ if model_class.model_config.get("validate_by_name") or model_class.model_config.get("populate_by_name"):
+ value = input_dict.get(field_name)
+
+ return value
+
+
+def _extract_multipart_boundary(content_type: str) -> str | None:
+ """Extract the boundary string from a multipart/form-data content-type header."""
+ for segment in content_type.split(";"):
+ stripped = segment.strip()
+ if stripped.startswith("boundary="):
+ boundary = stripped[len("boundary=") :]
+ # Remove optional quotes around boundary
+ if boundary.startswith('"') and boundary.endswith('"'):
+ boundary = boundary[1:-1]
+ return boundary
+ return None
+
+
+def _parse_multipart_body(body: bytes, boundary: str) -> dict[str, Any]:
+ """
+ Parse a multipart/form-data body into a dict of field names to values.
+
+ File fields get bytes values; regular form fields get string values.
+ Multiple values for the same field name are collected into lists.
+ """
+ delimiter = f"--{boundary}".encode()
+ end_delimiter = f"--{boundary}--".encode()
+
+ result: dict[str, Any] = {}
+
+ # Split body by the boundary delimiter
+ raw_parts = body.split(delimiter)
+
+ for raw_part in raw_parts:
+ # Skip the preamble (before first boundary) and epilogue (after closing boundary)
+ if not raw_part or raw_part.strip() == b"" or raw_part.strip() == b"--":
+ continue
+
+ # Remove the end delimiter marker if present
+ chunk = raw_part
+ if chunk.endswith(end_delimiter):
+ chunk = chunk[: -len(end_delimiter)]
+
+ # Strip leading \r\n
+ if chunk.startswith(b"\r\n"):
+ chunk = chunk[2:]
+
+ # Strip trailing \r\n
+ if chunk.endswith(b"\r\n"):
+ chunk = chunk[:-2]
+
+ # Split headers from body at the double CRLF
+ header_end = chunk.find(b"\r\n\r\n")
+ if header_end == -1:
+ continue
+
+ header_section = chunk[:header_end].decode("utf-8")
+ body_section = chunk[header_end + 4 :]
+
+ # Parse Content-Disposition to get the field name and optional filename
+ field_name = None
+ filename = None
+ content_type_header = None
+
+ for header_line in header_section.split("\r\n"):
+ header_lower = header_line.lower()
+ if header_lower.startswith("content-disposition:"):
+ field_name = _extract_header_param(header_line, "name")
+ filename = _extract_header_param(header_line, "filename")
+ elif header_lower.startswith("content-type:"):
+ content_type_header = header_line.split(":", 1)[1].strip()
+
+ if field_name is None:
+ continue
+
+ # If it has a filename, it's a file upload — wrap as UploadFile
+ # Otherwise it's a regular form field — decode to string
+ if filename is not None:
+ value: Any = UploadFile(content=body_section, filename=filename, content_type=content_type_header)
+ else:
+ value = body_section.decode("utf-8")
+
+ # Collect multiple values for same field name into a list
+ if field_name in result:
+ existing = result[field_name]
+ if isinstance(existing, list):
+ existing.append(value)
+ else:
+ result[field_name] = [existing, value]
+ else:
+ result[field_name] = value
+
+ return result
+
+
+def _extract_header_param(header_line: str, param_name: str) -> str | None:
+ """Extract a parameter value from a header line (e.g., name="file" from Content-Disposition)."""
+ search = f'{param_name}="'
+ idx = header_line.find(search)
+ if idx == -1:
+ return None
+ start = idx + len(search)
+ end = header_line.find('"', start)
+ if end == -1:
+ return None
+ return header_line[start:end]
diff --git a/aws_lambda_powertools/event_handler/middlewares/schema_validation.py b/aws_lambda_powertools/event_handler/middlewares/schema_validation.py
new file mode 100644
index 00000000000..c24fff0cbe0
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/middlewares/schema_validation.py
@@ -0,0 +1,128 @@
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING
+
+from aws_lambda_powertools.event_handler.exceptions import BadRequestError, InternalServerError
+from aws_lambda_powertools.event_handler.middlewares import BaseMiddlewareHandler, NextMiddleware
+from aws_lambda_powertools.utilities.validation import validate
+from aws_lambda_powertools.utilities.validation.exceptions import InvalidSchemaFormatError, SchemaValidationError
+
+if TYPE_CHECKING:
+ from aws_lambda_powertools.event_handler.api_gateway import Response
+ from aws_lambda_powertools.event_handler.types import EventHandlerInstance
+
+logger = logging.getLogger(__name__)
+
+
+class SchemaValidationMiddleware(BaseMiddlewareHandler):
+ """Middleware to validate API request and response against JSON Schema using the [Validation utility](https://docs.powertools.aws.dev/lambda/python/latest/utilities/validation/).
+
+ Example
+ --------
+ **Validating incoming event**
+
+ ```python
+ import requests
+
+ from aws_lambda_powertools import Logger
+ from aws_lambda_powertools.event_handler import APIGatewayRestResolver, Response
+ from aws_lambda_powertools.event_handler.middlewares import BaseMiddlewareHandler, NextMiddleware
+ from aws_lambda_powertools.event_handler.middlewares.schema_validation import SchemaValidationMiddleware
+
+ app = APIGatewayRestResolver()
+ logger = Logger()
+ json_schema_validation = SchemaValidationMiddleware(inbound_schema=INCOMING_JSON_SCHEMA)
+
+
+ @app.get("/todos", middlewares=[json_schema_validation])
+ def get_todos():
+ todos: requests.Response = requests.get("https://jsonplaceholder.typicode.com/todos")
+ todos.raise_for_status()
+
+ # for brevity, we'll limit to the first 10 only
+ return {"todos": todos.json()[:10]}
+
+
+ @logger.inject_lambda_context
+ def lambda_handler(event, context):
+ return app.resolve(event, context)
+ ```
+ """
+
+ def __init__(
+ self,
+ inbound_schema: dict,
+ inbound_formats: dict | None = None,
+ outbound_schema: dict | None = None,
+ outbound_formats: dict | None = None,
+ ):
+ """See [Validation utility](https://docs.powertools.aws.dev/lambda/python/latest/utilities/validation/) docs for examples on all parameters.
+
+ Parameters
+ ----------
+ inbound_schema : dict
+ JSON Schema to validate incoming event
+ inbound_formats : dict | None, optional
+ Custom formats containing a key (e.g. int64) and a value expressed as regex or callback returning bool, by default None
+ JSON Schema to validate outbound event, by default None
+ outbound_formats : dict | None, optional
+ Custom formats containing a key (e.g. int64) and a value expressed as regex or callback returning bool, by default None
+ """ # noqa: E501
+ super().__init__()
+ self.inbound_schema = inbound_schema
+ self.inbound_formats = inbound_formats
+ self.outbound_schema = outbound_schema
+ self.outbound_formats = outbound_formats
+
+ def bad_response(self, error: SchemaValidationError) -> Response:
+ message: str = f"Bad Response: {error.message}"
+ logger.debug(message)
+ raise BadRequestError(message)
+
+ def bad_request(self, error: SchemaValidationError) -> Response:
+ message: str = f"Bad Request: {error.message}"
+ logger.debug(message)
+ raise BadRequestError(message)
+
+ def bad_config(self, error: InvalidSchemaFormatError) -> Response:
+ logger.debug(f"Invalid Schema Format: {error}")
+ raise InternalServerError("Internal Server Error")
+
+ def handler(self, app: EventHandlerInstance, next_middleware: NextMiddleware) -> Response:
+ """Validates incoming JSON payload (body) against JSON Schema provided.
+
+ Parameters
+ ----------
+ app : EventHandlerInstance
+ An instance of an Event Handler
+ next_middleware : NextMiddleware
+ Callable to get response from the next middleware or route handler in the chain
+
+ Returns
+ -------
+ Response
+ It can return three types of response objects
+
+ - Original response: Propagates HTTP response returned from the next middleware if validation succeeds
+ - HTTP 400: Payload or response failed JSON Schema validation
+ - HTTP 500: JSON Schema provided has incorrect format
+ """
+ try:
+ validate(event=app.current_event.json_body, schema=self.inbound_schema, formats=self.inbound_formats)
+ except SchemaValidationError as error:
+ return self.bad_request(error)
+ except InvalidSchemaFormatError as error:
+ return self.bad_config(error)
+
+ result = next_middleware(app)
+
+ if self.outbound_formats is not None:
+ try:
+ validate(event=result.body, schema=self.inbound_schema, formats=self.inbound_formats)
+ except SchemaValidationError as error:
+ return self.bad_response(error)
+ except InvalidSchemaFormatError as error:
+ return self.bad_config(error)
+
+ return result
diff --git a/aws_lambda_powertools/event_handler/openapi/__init__.py b/aws_lambda_powertools/event_handler/openapi/__init__.py
new file mode 100644
index 00000000000..f2881bcc75a
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/openapi/__init__.py
@@ -0,0 +1,9 @@
+"""OpenAPI module for AWS Lambda Powertools."""
+
+from aws_lambda_powertools.event_handler.openapi.exceptions import OpenAPIMergeError
+from aws_lambda_powertools.event_handler.openapi.merge import OpenAPIMerge
+
+__all__ = [
+ "OpenAPIMerge",
+ "OpenAPIMergeError",
+]
diff --git a/aws_lambda_powertools/event_handler/openapi/compat.py b/aws_lambda_powertools/event_handler/openapi/compat.py
new file mode 100644
index 00000000000..c37cd2a979a
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/openapi/compat.py
@@ -0,0 +1,367 @@
+# mypy: ignore-errors
+from __future__ import annotations
+
+from collections import deque
+from collections.abc import Mapping, Sequence
+from copy import copy
+from dataclasses import dataclass, is_dataclass
+from typing import TYPE_CHECKING, Any, Deque, FrozenSet, List, Set, Tuple, Union
+
+from pydantic import BaseModel, TypeAdapter, ValidationError, create_model
+
+# Importing from internal libraries in Pydantic may introduce potential risks, as these internal libraries
+# are not part of the public API and may change without notice in future releases.
+# We use this for forward reference, as it allows us to handle forward references in type annotations.
+from pydantic._internal._typing_extra import eval_type_lenient
+from pydantic._internal._utils import lenient_issubclass
+from pydantic.fields import FieldInfo as PydanticFieldInfo
+from pydantic_core import PydanticUndefined, PydanticUndefinedType
+from typing_extensions import Annotated, Literal, get_args, get_origin
+
+from aws_lambda_powertools.event_handler.openapi.types import UnionType
+
+if TYPE_CHECKING:
+ from pydantic.fields import FieldInfo
+ from pydantic.json_schema import GenerateJsonSchema, JsonSchemaValue
+
+ from aws_lambda_powertools.event_handler.openapi.types import IncEx, ModelNameMap
+
+Undefined = PydanticUndefined
+Required = PydanticUndefined
+UndefinedType = PydanticUndefinedType
+
+evaluate_forwardref = eval_type_lenient
+
+sequence_annotation_to_type = {
+ Sequence: list,
+ List: list,
+ list: list,
+ Tuple: tuple,
+ tuple: tuple,
+ Set: set,
+ set: set,
+ FrozenSet: frozenset,
+ frozenset: frozenset,
+ Deque: deque,
+ deque: deque,
+}
+
+sequence_types = tuple(sequence_annotation_to_type.keys())
+
+RequestErrorModel: type[BaseModel] = create_model("Request")
+
+
+class ErrorWrapper(Exception):
+ pass
+
+
+@dataclass
+class ModelField:
+ field_info: FieldInfo
+ name: str
+ mode: Literal["validation", "serialization"] = "validation"
+
+ @property
+ def alias(self) -> str:
+ value = self.field_info.alias
+ return value if value is not None else self.name
+
+ @property
+ def required(self) -> bool:
+ return self.field_info.is_required()
+
+ @property
+ def default(self) -> Any:
+ return self.get_default()
+
+ @property
+ def type_(self) -> Any:
+ return self.field_info.annotation
+
+ def __post_init__(self) -> None:
+ # If the field_info.annotation is already an Annotated type with discriminator metadata,
+ # use it directly instead of wrapping it again
+ annotation = self.field_info.annotation
+ if (
+ get_origin(annotation) is Annotated
+ and hasattr(self.field_info, "discriminator")
+ and self.field_info.discriminator is not None
+ ):
+ self._type_adapter: TypeAdapter[Any] = TypeAdapter(annotation)
+ else:
+ self._type_adapter: TypeAdapter[Any] = TypeAdapter(
+ Annotated[annotation, self.field_info],
+ )
+
+ def get_default(self) -> Any:
+ if self.field_info.is_required():
+ return Undefined
+ return self.field_info.get_default(call_default_factory=True)
+
+ def serialize(
+ self,
+ value: Any,
+ *,
+ mode: Literal["json", "python"] = "json",
+ include: IncEx | None = None,
+ exclude: IncEx | None = None,
+ by_alias: bool = True,
+ exclude_unset: bool = False,
+ exclude_defaults: bool = False,
+ exclude_none: bool = False,
+ ) -> Any:
+ return self._type_adapter.dump_python(
+ value,
+ mode=mode,
+ include=include,
+ exclude=exclude,
+ by_alias=by_alias,
+ exclude_unset=exclude_unset,
+ exclude_defaults=exclude_defaults,
+ exclude_none=exclude_none,
+ )
+
+ def validate(
+ self,
+ value: Any,
+ *,
+ loc: tuple[int | str, ...] = (),
+ ) -> tuple[Any, list[dict[str, Any]] | None]:
+ try:
+ return (self._type_adapter.validate_python(value, from_attributes=True), None)
+ except ValidationError as exc:
+ return None, _regenerate_error_with_loc(errors=exc.errors(), loc_prefix=loc)
+
+ def __hash__(self) -> int:
+ # Each ModelField is unique for our purposes
+ return id(self)
+
+
+def get_schema_from_model_field(
+ *,
+ field: ModelField,
+ model_name_map: ModelNameMap,
+ field_mapping: dict[
+ tuple[ModelField, Literal["validation", "serialization"]],
+ JsonSchemaValue,
+ ],
+) -> dict[str, Any]:
+ json_schema = field_mapping[(field, field.mode)]
+ if "$ref" not in json_schema:
+ # MAINTENANCE: remove when deprecating Pydantic v1
+ # Ref: https://github.com/pydantic/pydantic/blob/d61792cc42c80b13b23e3ffa74bc37ec7c77f7d1/pydantic/schema.py#L207
+ json_schema["title"] = field.field_info.title or field.alias.title().replace("_", " ")
+ return json_schema
+
+
+def get_definitions(
+ *,
+ fields: list[ModelField],
+ schema_generator: GenerateJsonSchema,
+ model_name_map: ModelNameMap,
+) -> tuple[
+ dict[
+ tuple[ModelField, Literal["validation", "serialization"]],
+ dict[str, Any],
+ ],
+ dict[str, dict[str, Any]],
+]:
+ inputs = [(field, field.mode, field._type_adapter.core_schema) for field in fields]
+ field_mapping, definitions = schema_generator.generate_definitions(inputs=inputs)
+
+ return field_mapping, definitions
+
+
+def get_compat_model_name_map(fields: list[ModelField]) -> ModelNameMap:
+ return {}
+
+
+def get_annotation_from_field_info(annotation: Any, field_info: FieldInfo, field_name: str) -> Any:
+ return annotation
+
+
+def model_rebuild(model: type[BaseModel]) -> None:
+ model.model_rebuild()
+
+
+def copy_field_info(*, field_info: FieldInfo, annotation: Any) -> FieldInfo:
+ # Create a shallow copy of the field_info to preserve its type and all attributes
+ new_field = copy(field_info)
+
+ # Recursively extract all metadata from nested Annotated types
+ def extract_metadata(ann: Any) -> tuple[Any, list[Any]]:
+ """Extract base type and all non-FieldInfo metadata from potentially nested Annotated types."""
+ if get_origin(ann) is not Annotated:
+ return ann, []
+
+ args = get_args(ann)
+ base_type = args[0]
+ metadata = list(args[1:])
+
+ # If base type is also Annotated, recursively extract its metadata
+ if get_origin(base_type) is Annotated:
+ inner_base, inner_metadata = extract_metadata(base_type)
+ all_metadata = [m for m in inner_metadata + metadata if not isinstance(m, PydanticFieldInfo)]
+ return inner_base, all_metadata
+ else:
+ constraint_metadata = [m for m in metadata if not isinstance(m, PydanticFieldInfo)]
+ return base_type, constraint_metadata
+
+ # Extract base type and constraints
+ base_type, constraints = extract_metadata(annotation)
+
+ # Set the annotation with base type and all constraint metadata
+ # Use tuple unpacking for Python 3.10+ compatibility
+ if constraints:
+ new_field.annotation = Annotated[(base_type, *constraints)]
+ else:
+ new_field.annotation = base_type
+
+ return new_field
+
+
+def get_missing_field_error(loc: tuple[str, ...]) -> dict[str, Any]:
+ error = ValidationError.from_exception_data(
+ "Field required",
+ [{"type": "missing", "loc": loc, "input": {}}],
+ ).errors()[0]
+ error["input"] = None
+ return error
+
+
+def is_scalar_field(field: ModelField) -> bool:
+ from aws_lambda_powertools.event_handler.openapi.params import Body
+
+ return field_annotation_is_scalar(field.field_info.annotation) and not isinstance(field.field_info, Body)
+
+
+def is_scalar_sequence_field(field: ModelField) -> bool:
+ return field_annotation_is_scalar_sequence(field.field_info.annotation)
+
+
+def is_sequence_field(field: ModelField) -> bool:
+ return field_annotation_is_sequence(field.field_info.annotation)
+
+
+def is_bytes_field(field: ModelField) -> bool:
+ return is_bytes_or_nonable_bytes_annotation(field.type_)
+
+
+def is_bytes_sequence_field(field: ModelField) -> bool:
+ return is_bytes_sequence_annotation(field.type_)
+
+
+def serialize_sequence_value(*, field: ModelField, value: Any) -> Sequence[Any]:
+ origin_type = get_origin(field.field_info.annotation) or field.field_info.annotation
+ if not issubclass(origin_type, sequence_types): # type: ignore[arg-type]
+ raise AssertionError(f"Expected sequence type, got {origin_type}")
+ return sequence_annotation_to_type[origin_type](value) # type: ignore[no-any-return]
+
+
+def _normalize_errors(errors: Sequence[Any]) -> list[dict[str, Any]]:
+ return errors # type: ignore[return-value]
+
+
+def create_body_model(*, fields: Sequence[ModelField], model_name: str) -> type[BaseModel]:
+ field_params = {f.name: (f.field_info.annotation, f.field_info) for f in fields}
+ model: type[BaseModel] = create_model(model_name, **field_params)
+ return model
+
+
+def _model_dump(model: BaseModel, mode: Literal["json", "python"] = "json", **kwargs: Any) -> Any:
+ return model.model_dump(mode=mode, **kwargs)
+
+
+def model_json(model: BaseModel, **kwargs: Any) -> Any:
+ return model.model_dump_json(**kwargs)
+
+
+# Common code for both versions
+
+
+def field_annotation_is_complex(annotation: type[Any] | None) -> bool:
+ origin = get_origin(annotation)
+ if origin is Union or origin is UnionType:
+ return any(field_annotation_is_complex(arg) for arg in get_args(annotation))
+
+ return (
+ _annotation_is_complex(annotation)
+ or _annotation_is_complex(origin)
+ or hasattr(origin, "__pydantic_core_schema__")
+ or hasattr(origin, "__get_pydantic_core_schema__")
+ )
+
+
+def field_annotation_is_scalar(annotation: Any) -> bool:
+ return annotation is Ellipsis or not field_annotation_is_complex(annotation)
+
+
+def field_annotation_is_sequence(annotation: type[Any] | None) -> bool:
+ return _annotation_is_sequence(annotation) or _annotation_is_sequence(get_origin(annotation))
+
+
+def field_annotation_is_scalar_sequence(annotation: type[Any] | None) -> bool:
+ origin = get_origin(annotation)
+ if origin is Union or origin is UnionType:
+ at_least_one_scalar_sequence = False
+ for arg in get_args(annotation):
+ if field_annotation_is_scalar_sequence(arg):
+ at_least_one_scalar_sequence = True
+ continue
+ elif not field_annotation_is_scalar(arg):
+ return False
+ return at_least_one_scalar_sequence
+ return field_annotation_is_sequence(annotation) and all(
+ field_annotation_is_scalar(sub_annotation) for sub_annotation in get_args(annotation)
+ )
+
+
+def is_bytes_or_nonable_bytes_annotation(annotation: Any) -> bool:
+ if lenient_issubclass(annotation, bytes):
+ return True
+ origin = get_origin(annotation)
+ if origin is Union or origin is UnionType:
+ for arg in get_args(annotation):
+ if lenient_issubclass(arg, bytes):
+ return True
+ return False
+
+
+def is_bytes_sequence_annotation(annotation: Any) -> bool:
+ origin = get_origin(annotation)
+ if origin is Union or origin is UnionType:
+ at_least_one = False
+ for arg in get_args(annotation):
+ if is_bytes_sequence_annotation(arg):
+ at_least_one = True
+ break
+ return at_least_one
+ return field_annotation_is_sequence(annotation) and all(
+ is_bytes_or_nonable_bytes_annotation(sub_annotation) for sub_annotation in get_args(annotation)
+ )
+
+
+def value_is_sequence(value: Any) -> bool:
+ return isinstance(value, sequence_types) and not isinstance(value, (str, bytes)) # type: ignore[arg-type]
+
+
+def _annotation_is_complex(annotation: type[Any] | None) -> bool:
+ return (
+ lenient_issubclass(annotation, (BaseModel, Mapping)) # Keep it to UploadFile
+ or _annotation_is_sequence(annotation)
+ or is_dataclass(annotation)
+ )
+
+
+def _annotation_is_sequence(annotation: type[Any] | None) -> bool:
+ if lenient_issubclass(annotation, (str, bytes)):
+ return False
+ return lenient_issubclass(annotation, sequence_types)
+
+
+def _regenerate_error_with_loc(*, errors: Sequence[Any], loc_prefix: tuple[str | int, ...]) -> list[dict[str, Any]]:
+ updated_loc_errors: list[Any] = [
+ {**err, "loc": loc_prefix + err.get("loc", ())} for err in _normalize_errors(errors)
+ ]
+
+ return updated_loc_errors
diff --git a/aws_lambda_powertools/event_handler/openapi/config.py b/aws_lambda_powertools/event_handler/openapi/config.py
new file mode 100644
index 00000000000..387388a88d2
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/openapi/config.py
@@ -0,0 +1,84 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import TYPE_CHECKING, Any
+
+from aws_lambda_powertools.event_handler.openapi.constants import (
+ DEFAULT_API_VERSION,
+ DEFAULT_OPENAPI_TITLE,
+ DEFAULT_OPENAPI_VERSION,
+)
+
+if TYPE_CHECKING:
+ from aws_lambda_powertools.event_handler.openapi.models import (
+ Contact,
+ ExternalDocumentation,
+ License,
+ SecurityScheme,
+ Server,
+ Tag,
+ )
+
+
+@dataclass
+class OpenAPIConfig:
+ """Configuration class for OpenAPI specification.
+
+ This class holds all the necessary configuration parameters to generate an OpenAPI specification.
+
+ Parameters
+ ----------
+ title: str
+ The title of the application.
+ version: str
+ The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API
+ openapi_version: str, default = "3.1.0"
+ The version of the OpenAPI Specification (which the document uses).
+ summary: str, optional
+ A short summary of what the application does.
+ description: str, optional
+ A verbose explanation of the application behavior.
+ tags: list[Tag, str], optional
+ A list of tags used by the specification with additional metadata.
+ servers: list[Server], optional
+ An array of Server Objects, which provide connectivity information to a target server.
+ terms_of_service: str, optional
+ A URL to the Terms of Service for the API. MUST be in the format of a URL.
+ contact: Contact, optional
+ The contact information for the exposed API.
+ license_info: License, optional
+ The license information for the exposed API.
+ security_schemes: dict[str, SecurityScheme]], optional
+ A declaration of the security schemes available to be used in the specification.
+ security: list[dict[str, list[str]]], optional
+ A declaration of which security mechanisms are applied globally across the API.
+ external_documentation: ExternalDocumentation, optional
+ A link to external documentation for the API.
+ openapi_extensions: Dict[str, Any], optional
+ Additional OpenAPI extensions as a dictionary.
+
+ Example
+ --------
+ >>> config = OpenAPIConfig(
+ ... title="My API",
+ ... version="1.0.0",
+ ... description="This is my API description",
+ ... contact=Contact(name="API Support", email="support@example.com"),
+ ... servers=[Server(url="https://api.example.com/v1")]
+ ... )
+ """
+
+ title: str = DEFAULT_OPENAPI_TITLE
+ version: str = DEFAULT_API_VERSION
+ openapi_version: str = DEFAULT_OPENAPI_VERSION
+ summary: str | None = None
+ description: str | None = None
+ tags: list[Tag | str] | None = None
+ servers: list[Server] | None = None
+ terms_of_service: str | None = None
+ contact: Contact | None = None
+ license_info: License | None = None
+ security_schemes: dict[str, SecurityScheme] | None = None
+ security: list[dict[str, list[str]]] | None = None
+ external_documentation: ExternalDocumentation | None = None
+ openapi_extensions: dict[str, Any] | None = None
diff --git a/aws_lambda_powertools/event_handler/openapi/constants.py b/aws_lambda_powertools/event_handler/openapi/constants.py
new file mode 100644
index 00000000000..7c5b938920a
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/openapi/constants.py
@@ -0,0 +1,6 @@
+DEFAULT_API_VERSION = "1.0.0"
+DEFAULT_OPENAPI_VERSION = "3.1.0"
+DEFAULT_OPENAPI_TITLE = "Powertools for AWS Lambda (Python) API"
+DEFAULT_CONTENT_TYPE = "application/json"
+DEFAULT_OPENAPI_RESPONSE_DESCRIPTION = "Successful Response"
+DEFAULT_STATUS_CODE = 200
diff --git a/aws_lambda_powertools/event_handler/openapi/dependant.py b/aws_lambda_powertools/event_handler/openapi/dependant.py
new file mode 100644
index 00000000000..1e7f4327602
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/openapi/dependant.py
@@ -0,0 +1,405 @@
+from __future__ import annotations
+
+import inspect
+import re
+from typing import TYPE_CHECKING, Any, ForwardRef, cast
+
+from aws_lambda_powertools.event_handler.depends import DependencyParam, _get_depends_from_annotation
+from aws_lambda_powertools.event_handler.openapi.compat import (
+ ModelField,
+ create_body_model,
+ evaluate_forwardref,
+ is_scalar_field,
+)
+from aws_lambda_powertools.event_handler.openapi.params import (
+ Body,
+ Dependant,
+ File,
+ Form,
+ Param,
+ ParamTypes,
+ analyze_param,
+ create_response_field,
+ get_flat_dependant,
+)
+from aws_lambda_powertools.event_handler.openapi.types import OpenAPIResponse, OpenAPIResponseContentModel
+from aws_lambda_powertools.event_handler.request import Request
+
+if TYPE_CHECKING:
+ from collections.abc import Callable
+
+ from pydantic import BaseModel
+
+"""
+This turns the opaque function signature into typed, validated models.
+
+It relies on Pydantic's typing and validation to achieve this in a declarative way.
+This enables traits like autocompletion, validation, and declarative structure vs imperative parsing.
+
+This code parses an OpenAPI operation handler function signature into Pydantic models. It uses inspect to get the
+signature and regex to parse path parameters. Each parameter is analyzed to extract its type annotation and generate
+a corresponding Pydantic field, which are added to a Dependant model. Return values are handled similarly.
+
+This modeling allows for type checking, automatic parameter name/location/type extraction, and input validation -
+turning the opaque signature into validated models. It relies on Pydantic's typing and validation for a declarative
+approach over imperative parsing, enabling autocompletion, validation and structure.
+"""
+
+
+def add_param_to_fields(
+ *,
+ field: ModelField,
+ dependant: Dependant,
+) -> None:
+ """
+ Adds a parameter to the list of parameters in the dependant model.
+
+ Parameters
+ ----------
+ field: ModelField
+ The field to add
+ dependant: Dependant
+ The dependant model to add the field to
+
+ """
+ field_info = cast(Param, field.field_info)
+
+ # Dictionary to map ParamTypes to their corresponding lists in dependant
+ param_type_map = {
+ ParamTypes.path: dependant.path_params,
+ ParamTypes.query: dependant.query_params,
+ ParamTypes.header: dependant.header_params,
+ ParamTypes.cookie: dependant.cookie_params,
+ }
+
+ # Check if field_info.in_ is a valid key in param_type_map and append the field to the corresponding list
+ # or raise an exception if it's not a valid key.
+ if field_info.in_ in param_type_map:
+ param_type_map[field_info.in_].append(field)
+ else:
+ raise AssertionError(f"Unsupported param type: {field_info.in_}")
+
+
+def get_typed_annotation(annotation: Any, globalns: dict[str, Any]) -> Any:
+ """
+ Evaluates a type annotation, which can be a string or a ForwardRef.
+ """
+ if isinstance(annotation, str):
+ annotation = ForwardRef(annotation)
+ annotation = evaluate_forwardref(annotation, globalns, globalns)
+ return annotation
+
+
+def get_typed_signature(call: Callable[..., Any]) -> inspect.Signature:
+ """
+ Returns a typed signature for a callable, resolving forward references.
+
+ Parameters
+ ----------
+ call: Callable[..., Any]
+ The callable to get the signature for
+
+ Returns
+ -------
+ inspect.Signature
+ The typed signature
+ """
+ signature = inspect.signature(call)
+
+ # Gets the global namespace for the call. This is used to resolve forward references.
+ globalns = getattr(call, "__globals__", {})
+
+ typed_params = [
+ inspect.Parameter(
+ name=param.name,
+ kind=param.kind,
+ default=param.default,
+ annotation=get_typed_annotation(param.annotation, globalns),
+ )
+ for param in signature.parameters.values()
+ ]
+
+ # If the return annotation is not empty, add it to the signature.
+ if signature.return_annotation is not inspect.Signature.empty:
+ return_param = inspect.Parameter(
+ name="Return",
+ kind=inspect.Parameter.POSITIONAL_OR_KEYWORD,
+ default=None,
+ annotation=get_typed_annotation(signature.return_annotation, globalns),
+ )
+ return inspect.Signature(typed_params, return_annotation=return_param.annotation)
+ else:
+ return inspect.Signature(typed_params)
+
+
+def get_path_param_names(path: str) -> set[str]:
+ """
+ Returns the path parameter names from a path template. Those are the strings between { and }.
+
+ Parameters
+ ----------
+ path: str
+ The path template
+
+ Returns
+ -------
+ set[str]
+ The path parameter names
+
+ """
+ return set(re.findall("{(.*?)}", path))
+
+
+def get_dependant(
+ *,
+ path: str,
+ call: Callable[..., Any],
+ name: str | None = None,
+ responses: dict[int, OpenAPIResponse] | None = None,
+) -> Dependant:
+ """
+ Returns a dependant model for a handler function. A dependant model is a model that contains
+ the parameters and return value of a handler function.
+
+ Parameters
+ ----------
+ path: str
+ The path template
+ call: Callable[..., Any]
+ The handler function
+ name: str, optional
+ The name of the handler function
+ responses: list[dict[int, OpenAPIResponse]], optional
+ The list of extra responses for the handler function
+
+ Returns
+ -------
+ Dependant
+ The dependant model for the handler function
+ """
+ path_param_names = get_path_param_names(path)
+ endpoint_signature = get_typed_signature(call)
+ signature_params = endpoint_signature.parameters
+
+ dependant = Dependant(
+ call=call,
+ name=name,
+ path=path,
+ )
+
+ # Add each parameter to the dependant model
+ for param_name, param in signature_params.items():
+ # Request-typed parameters are injected by the resolver at call time;
+ # they carry no OpenAPI meaning and must be excluded from schema generation.
+ if param.annotation is Request:
+ continue
+
+ # Depends() parameters (via Annotated[Type, Depends(fn)]) are resolved at call time.
+ depends_instance = _get_depends_from_annotation(param.annotation)
+ if depends_instance is not None:
+ sub_dependant = get_dependant(
+ path=path,
+ call=depends_instance.dependency,
+ )
+ dependant.dependencies.append(
+ DependencyParam(
+ param_name=param_name,
+ depends=depends_instance,
+ dependant=sub_dependant,
+ ),
+ )
+ continue
+
+ # If the parameter is a path parameter, we need to set the in_ field to "path".
+ is_path_param = param_name in path_param_names
+
+ # Analyze the parameter to get the Pydantic field.
+ param_field = analyze_param(
+ param_name=param_name,
+ annotation=param.annotation,
+ value=param.default,
+ is_path_param=is_path_param,
+ is_response_param=False,
+ )
+ if param_field is None:
+ raise AssertionError(f"Parameter field is None for param: {param_name}")
+
+ if is_body_param(param_field=param_field, is_path_param=is_path_param):
+ dependant.body_params.append(param_field)
+ else:
+ add_param_to_fields(field=param_field, dependant=dependant)
+
+ _add_return_annotation(dependant, endpoint_signature)
+ _add_extra_responses(dependant, responses)
+
+ return dependant
+
+
+def _add_extra_responses(dependant: Dependant, responses: dict[int, OpenAPIResponse] | None):
+ # Also add the optional extra responses to the dependant model.
+ if not responses:
+ return
+
+ for response in responses.values():
+ for schema in response.get("content", {}).values():
+ if "model" in schema:
+ response_field = analyze_param(
+ param_name="return",
+ annotation=cast(OpenAPIResponseContentModel, schema)["model"],
+ value=None,
+ is_path_param=False,
+ is_response_param=True,
+ )
+ if response_field is None:
+ raise AssertionError("Response field is None for response model")
+
+ dependant.response_extra_models.append(response_field)
+
+
+def _add_return_annotation(dependant: Dependant, endpoint_signature: inspect.Signature):
+ # If the return annotation is not empty, add it to the dependant model.
+ return_annotation = endpoint_signature.return_annotation
+ if return_annotation is not inspect.Signature.empty:
+ param_field = analyze_param(
+ param_name="return",
+ annotation=return_annotation,
+ value=None,
+ is_path_param=False,
+ is_response_param=True,
+ )
+ if param_field is None:
+ raise AssertionError("Param field is None for return annotation")
+
+ dependant.return_param = param_field
+
+
+def is_body_param(*, param_field: ModelField, is_path_param: bool) -> bool:
+ """
+ Returns whether a parameter is a request body parameter, by checking if it is a scalar field or a body field.
+
+ Parameters
+ ----------
+ param_field: ModelField
+ The parameter field
+ is_path_param: bool
+ Whether the parameter is a path parameter
+
+ Returns
+ -------
+ bool
+ Whether the parameter is a request body parameter
+ """
+ if is_path_param:
+ if not is_scalar_field(field=param_field):
+ raise AssertionError("Path params must be of one of the supported types")
+ return False
+ elif is_scalar_field(field=param_field):
+ return False
+ elif isinstance(param_field.field_info, Param):
+ return False
+ else:
+ if not isinstance(param_field.field_info, Body):
+ raise AssertionError(f"Param: {param_field.name} can only be a request body, use Body()")
+ return True
+
+
+def get_flat_params(dependant: Dependant) -> list[ModelField]:
+ """
+ Get a list of all the parameters from a Dependant object.
+
+ Parameters
+ ----------
+ dependant : Dependant
+ The Dependant object containing the parameters.
+
+ Returns
+ -------
+ list[ModelField]
+ A list of ModelField objects containing the flat parameters from the Dependant object.
+
+ """
+ flat_dependant = get_flat_dependant(dependant)
+ return (
+ flat_dependant.path_params
+ + flat_dependant.query_params
+ + flat_dependant.header_params
+ + flat_dependant.cookie_params
+ )
+
+
+def get_body_field(*, dependant: Dependant, name: str) -> ModelField | None:
+ """
+ Get the Body field for a given Dependant object.
+ """
+
+ flat_dependant = get_flat_dependant(dependant)
+ if not flat_dependant.body_params:
+ return None
+
+ first_param = flat_dependant.body_params[0]
+ field_info = first_param.field_info
+
+ # Handle the case where there is only one body parameter and it is embedded
+ embed = getattr(field_info, "embed", None)
+ body_param_names_set = {param.name for param in flat_dependant.body_params}
+ if len(body_param_names_set) == 1 and not embed:
+ return first_param
+
+ # If one field requires to embed, all have to be embedded
+ for param in flat_dependant.body_params:
+ setattr(param.field_info, "embed", True) # noqa: B010
+
+ # Generate a custom body model for this endpoint
+ model_name = "Body_" + name
+ body_model = create_body_model(fields=flat_dependant.body_params, model_name=model_name)
+
+ required = any(True for f in flat_dependant.body_params if f.required)
+
+ body_field_info, body_field_info_kwargs = get_body_field_info(
+ body_model=body_model,
+ flat_dependant=flat_dependant,
+ required=required,
+ )
+
+ final_field = create_response_field(
+ name="body",
+ type_=body_model,
+ required=required,
+ alias="body",
+ field_info=body_field_info(**body_field_info_kwargs),
+ )
+
+ return final_field
+
+
+def get_body_field_info(
+ *,
+ body_model: type[BaseModel],
+ flat_dependant: Dependant,
+ required: bool,
+) -> tuple[type[Body], dict[str, Any]]:
+ """
+ Get the Body field info and kwargs for a given body model.
+ """
+
+ body_field_info_kwargs: dict[str, Any] = {"annotation": body_model, "alias": "body"}
+
+ if not required:
+ body_field_info_kwargs["default"] = None
+
+ if any(isinstance(f.field_info, File) for f in flat_dependant.body_params):
+ body_field_info = Body
+ body_field_info_kwargs["media_type"] = "multipart/form-data"
+ elif any(isinstance(f.field_info, Form) for f in flat_dependant.body_params):
+ body_field_info = Body
+ body_field_info_kwargs["media_type"] = "application/x-www-form-urlencoded"
+ else:
+ body_field_info = Body
+
+ body_param_media_types = [
+ f.field_info.media_type for f in flat_dependant.body_params if isinstance(f.field_info, Body)
+ ]
+ if len(set(body_param_media_types)) == 1:
+ body_field_info_kwargs["media_type"] = body_param_media_types[0]
+
+ return body_field_info, body_field_info_kwargs
diff --git a/aws_lambda_powertools/event_handler/openapi/encoders.py b/aws_lambda_powertools/event_handler/openapi/encoders.py
new file mode 100644
index 00000000000..d1b8861bdde
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/openapi/encoders.py
@@ -0,0 +1,369 @@
+from __future__ import annotations
+
+import dataclasses
+import datetime
+from collections import defaultdict, deque
+from decimal import Decimal
+from enum import Enum
+from pathlib import PurePath
+from re import Pattern
+from types import GeneratorType
+from typing import TYPE_CHECKING, Any
+from uuid import UUID
+
+from pydantic import BaseModel
+from pydantic.types import SecretBytes, SecretStr
+
+from aws_lambda_powertools.event_handler.openapi.compat import _model_dump
+
+if TYPE_CHECKING:
+ from collections.abc import Callable
+
+ from aws_lambda_powertools.event_handler.openapi.types import IncEx
+
+from aws_lambda_powertools.event_handler.openapi.exceptions import SerializationError
+
+"""
+This module contains the encoders used by jsonable_encoder to convert Python objects to JSON serializable data types.
+"""
+
+
+def jsonable_encoder( # noqa: PLR0911
+ obj: Any,
+ include: IncEx | None = None,
+ exclude: IncEx | None = None,
+ by_alias: bool = True,
+ exclude_unset: bool = False,
+ exclude_defaults: bool = False,
+ exclude_none: bool = False,
+ custom_serializer: Callable[[Any], str] | None = None,
+) -> Any:
+ """
+ JSON encodes an arbitrary Python object into JSON serializable data types.
+
+ This is a modified version of fastapi.encoders.jsonable_encoder that supports
+ encoding of pydantic.BaseModel objects.
+
+ Parameters
+ ----------
+ obj : Any
+ The object to encode
+ include : IncEx | None, optional
+ A set or dictionary of strings that specifies which properties should be included, by default None,
+ meaning everything is included
+ exclude : IncEx | None, optional
+ A set or dictionary of strings that specifies which properties should be excluded, by default None,
+ meaning nothing is excluded
+ by_alias : bool, optional
+ Whether field aliases should be respected, by default True
+ exclude_unset : bool, optional
+ Whether fields that are not set should be excluded, by default False
+ exclude_defaults : bool, optional
+ Whether fields that are equal to their default value (as specified in the model) should be excluded,
+ by default False
+ exclude_none : bool, optional
+ Whether fields that are equal to None should be excluded, by default False
+ custom_serializer : Callable, optional
+ A custom serializer to use for encoding the object, when everything else fails.
+
+ Returns
+ -------
+ Any
+ The JSON serializable data types
+ """
+ if include is not None and not isinstance(include, (set, dict)):
+ include = set(include)
+ if exclude is not None and not isinstance(exclude, (set, dict)):
+ exclude = set(exclude)
+
+ try:
+ # Pydantic models
+ if isinstance(obj, BaseModel):
+ return _dump_base_model(
+ obj=obj,
+ include=include,
+ exclude=exclude,
+ by_alias=by_alias,
+ exclude_unset=exclude_unset,
+ exclude_none=exclude_none,
+ exclude_defaults=exclude_defaults,
+ )
+
+ # Dataclasses
+ if dataclasses.is_dataclass(obj):
+ obj_dict = dataclasses.asdict(obj) # type: ignore[arg-type]
+ return jsonable_encoder(
+ obj_dict,
+ include=include,
+ exclude=exclude,
+ by_alias=by_alias,
+ exclude_unset=exclude_unset,
+ exclude_defaults=exclude_defaults,
+ exclude_none=exclude_none,
+ custom_serializer=custom_serializer,
+ )
+
+ # Simple type dispatch (exact type match, then isinstance for subclasses)
+ encoder = ENCODERS_BY_TYPE.get(type(obj))
+ if encoder is not None:
+ return encoder(obj)
+
+ for encoder_fn, classes_tuple in _encoders_by_class_tuples.items():
+ if isinstance(obj, classes_tuple):
+ return encoder_fn(obj)
+
+ # Dictionaries
+ if isinstance(obj, dict):
+ return _dump_dict(
+ obj=obj,
+ include=include,
+ exclude=exclude,
+ by_alias=by_alias,
+ exclude_unset=exclude_unset,
+ exclude_none=exclude_none,
+ custom_serializer=custom_serializer,
+ )
+
+ # Sequences
+ if isinstance(obj, (list, set, frozenset, GeneratorType, tuple, deque)):
+ return _dump_sequence(
+ obj=obj,
+ include=include,
+ exclude=exclude,
+ by_alias=by_alias,
+ exclude_none=exclude_none,
+ exclude_defaults=exclude_defaults,
+ exclude_unset=exclude_unset,
+ custom_serializer=custom_serializer,
+ )
+
+ # Use custom serializer if present
+ if custom_serializer:
+ return custom_serializer(obj)
+
+ # Default
+ return _dump_other(
+ obj=obj,
+ include=include,
+ exclude=exclude,
+ by_alias=by_alias,
+ exclude_none=exclude_none,
+ exclude_unset=exclude_unset,
+ exclude_defaults=exclude_defaults,
+ custom_serializer=custom_serializer,
+ )
+ except ValueError as exc:
+ raise SerializationError(
+ f"Unable to serialize the object {obj} as it is not a supported type. Error details: {exc}",
+ "See: https://docs.powertools.aws.dev/lambda/python/latest/core/event_handler/api_gateway/#serializing-objects",
+ ) from exc
+
+
+def _dump_base_model(
+ *,
+ obj: Any,
+ include: IncEx | None = None,
+ exclude: IncEx | None = None,
+ by_alias: bool = True,
+ exclude_unset: bool = False,
+ exclude_none: bool = False,
+ exclude_defaults: bool = False,
+):
+ """
+ Dump a BaseModel object to a dict, using the same parameters as jsonable_encoder
+ """
+ obj_dict = _model_dump(
+ obj,
+ mode="json",
+ include=include,
+ exclude=exclude,
+ by_alias=by_alias,
+ exclude_unset=exclude_unset,
+ exclude_none=exclude_none,
+ exclude_defaults=exclude_defaults,
+ )
+ if "__root__" in obj_dict:
+ obj_dict = obj_dict["__root__"]
+
+ return jsonable_encoder(
+ obj_dict,
+ exclude_none=exclude_none,
+ exclude_defaults=exclude_defaults,
+ )
+
+
+def _dump_dict(
+ *,
+ obj: Any,
+ include: IncEx | None = None,
+ exclude: IncEx | None = None,
+ by_alias: bool = True,
+ exclude_unset: bool = False,
+ exclude_none: bool = False,
+ custom_serializer: Callable[[Any], str] | None = None,
+) -> dict[str, Any]:
+ """
+ Dump a dict to a dict, using the same parameters as jsonable_encoder
+
+ Parameters
+ ----------
+ custom_serializer : Callable, optional
+ A custom serializer to use for encoding the object, when everything else fails.
+ """
+ encoded_dict = {}
+ allowed_keys = set(obj.keys())
+ if include is not None:
+ allowed_keys &= set(include)
+ if exclude is not None:
+ allowed_keys -= set(exclude)
+ for key, value in obj.items():
+ if (
+ (not isinstance(key, str) or not key.startswith("_sa"))
+ and (value is not None or not exclude_none)
+ and key in allowed_keys
+ ):
+ encoded_key = jsonable_encoder(
+ key,
+ by_alias=by_alias,
+ exclude_unset=exclude_unset,
+ exclude_none=exclude_none,
+ custom_serializer=custom_serializer,
+ )
+ encoded_value = jsonable_encoder(
+ value,
+ by_alias=by_alias,
+ exclude_unset=exclude_unset,
+ exclude_none=exclude_none,
+ custom_serializer=custom_serializer,
+ )
+ encoded_dict[encoded_key] = encoded_value
+ return encoded_dict
+
+
+def _dump_sequence(
+ *,
+ obj: Any,
+ include: IncEx | None = None,
+ exclude: IncEx | None = None,
+ by_alias: bool = True,
+ exclude_unset: bool = False,
+ exclude_none: bool = False,
+ exclude_defaults: bool = False,
+ custom_serializer: Callable[[Any], str] | None = None,
+) -> list[Any]:
+ """
+ Dump a sequence to a list, using the same parameters as jsonable_encoder.
+ """
+ encoded_list = []
+ for item in obj:
+ encoded_list.append(
+ jsonable_encoder(
+ item,
+ include=include,
+ exclude=exclude,
+ by_alias=by_alias,
+ exclude_unset=exclude_unset,
+ exclude_defaults=exclude_defaults,
+ exclude_none=exclude_none,
+ custom_serializer=custom_serializer,
+ ),
+ )
+ return encoded_list
+
+
+def _dump_other(
+ *,
+ obj: Any,
+ include: IncEx | None = None,
+ exclude: IncEx | None = None,
+ by_alias: bool = True,
+ exclude_unset: bool = False,
+ exclude_none: bool = False,
+ exclude_defaults: bool = False,
+ custom_serializer: Callable[[Any], str] | None = None,
+) -> Any:
+ """
+ Dump an object to a hashable object, using the same parameters as jsonable_encoder
+ """
+ try:
+ data = dict(obj)
+ except Exception as e:
+ errors: list[Exception] = [e]
+ try:
+ data = vars(obj)
+ except Exception as e:
+ errors.append(e)
+ raise ValueError(errors) from e
+ return jsonable_encoder(
+ data,
+ include=include,
+ exclude=exclude,
+ by_alias=by_alias,
+ exclude_unset=exclude_unset,
+ exclude_defaults=exclude_defaults,
+ exclude_none=exclude_none,
+ custom_serializer=custom_serializer,
+ )
+
+
+def iso_format(o: datetime.date | datetime.time) -> str:
+ """
+ ISO format for date and time
+ """
+ return o.isoformat()
+
+
+def decimal_encoder(dec_value: Decimal) -> int | float:
+ """
+ Encodes a Decimal as int of there's no exponent, otherwise float
+
+ This is useful when we use ConstrainedDecimal to represent Numeric(x,0)
+ where an integer (but not int typed) is used. Encoding this as a float
+ results in failed round-tripping between encode and parse.
+
+ >>> decimal_encoder(Decimal("1.0"))
+ 1.0
+
+ >>> decimal_encoder(Decimal("1"))
+ 1
+ """
+ if dec_value.as_tuple().exponent >= 0: # type: ignore[operator]
+ return int(dec_value)
+ else:
+ return float(dec_value)
+
+
+# Encoders for types that are not JSON serializable
+ENCODERS_BY_TYPE: dict[type[Any], Callable[[Any], Any]] = {
+ bool: lambda o: o,
+ int: lambda o: o,
+ float: lambda o: o,
+ str: lambda o: o,
+ type(None): lambda o: o,
+ bytes: lambda o: o.decode(),
+ datetime.date: iso_format,
+ datetime.datetime: iso_format,
+ datetime.time: iso_format,
+ datetime.timedelta: lambda td: td.total_seconds(),
+ Decimal: decimal_encoder,
+ Enum: lambda o: o.value,
+ PurePath: str,
+ Pattern: lambda o: o.pattern,
+ SecretBytes: str,
+ SecretStr: str,
+ UUID: str,
+}
+
+
+# Generates a mapping of encoders to a tuple of classes that they can encode
+def generate_encoders_by_class_tuples(
+ type_encoder_map: dict[Any, Callable[[Any], Any]],
+) -> dict[Callable[[Any], Any], tuple[Any, ...]]:
+ encoders: dict[Callable[[Any], Any], tuple[Any, ...]] = defaultdict(tuple)
+ for type_, encoder in type_encoder_map.items():
+ encoders[encoder] += (type_,)
+ return encoders
+
+
+# Mapping of encoders to a tuple of classes that they can encode
+_encoders_by_class_tuples = generate_encoders_by_class_tuples(ENCODERS_BY_TYPE)
diff --git a/aws_lambda_powertools/event_handler/openapi/exceptions.py b/aws_lambda_powertools/event_handler/openapi/exceptions.py
new file mode 100644
index 00000000000..593f529ae5f
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/openapi/exceptions.py
@@ -0,0 +1,61 @@
+from collections.abc import Sequence
+from typing import Any, Literal
+
+
+class ValidationException(Exception):
+ """
+ Base exception for all validation errors
+ """
+
+ def __init__(self, errors: Sequence[Any]) -> None:
+ self._errors = errors
+
+ def errors(self) -> Sequence[Any]:
+ return self._errors
+
+
+class RequestValidationError(ValidationException):
+ """
+ Raised when the request body does not match the OpenAPI schema
+ """
+
+ def __init__(self, errors: Sequence[Any], *, body: Any = None) -> None:
+ super().__init__(errors)
+ self.body = body
+
+
+class ResponseValidationError(ValidationException):
+ """
+ Raised when the response body does not match the OpenAPI schema
+ """
+
+ def __init__(self, errors: Sequence[Any], *, body: Any = None, source: Literal["route", "app"] = "app") -> None:
+ super().__init__(errors)
+ self.body = body
+ self.source = source
+
+
+class SerializationError(Exception):
+ """
+ Base exception for all encoding errors
+ """
+
+
+class SchemaValidationError(ValidationException):
+ """
+ Raised when the OpenAPI schema validation fails
+ """
+
+
+class OpenAPIMergeError(Exception):
+ """Exception raised when there's a conflict during OpenAPI merge."""
+
+
+class RequestUnsupportedContentType(NotImplementedError, ValidationException):
+ """Exception raised when trying to read request body data, with unknown headers"""
+
+ # REVIEW: This inheritance is for backwards compatibility.
+ # Just inherit from ValidationException in Powertools V4
+ def __init__(self, msg: str, errors: Sequence[Any]) -> None:
+ NotImplementedError.__init__(self, msg)
+ ValidationException.__init__(self, errors)
diff --git a/aws_lambda_powertools/event_handler/openapi/merge.py b/aws_lambda_powertools/event_handler/openapi/merge.py
new file mode 100644
index 00000000000..4b7f51cab1c
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/openapi/merge.py
@@ -0,0 +1,543 @@
+"""OpenAPI Merge - Generate unified OpenAPI schema from multiple Lambda handlers."""
+
+from __future__ import annotations
+
+import ast
+import fnmatch
+import importlib.util
+import logging
+import sys
+import warnings
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Literal
+
+from aws_lambda_powertools.event_handler.openapi.config import OpenAPIConfig
+from aws_lambda_powertools.event_handler.openapi.constants import (
+ DEFAULT_API_VERSION,
+ DEFAULT_OPENAPI_TITLE,
+ DEFAULT_OPENAPI_VERSION,
+)
+from aws_lambda_powertools.event_handler.openapi.exceptions import OpenAPIMergeError
+
+if TYPE_CHECKING:
+ from aws_lambda_powertools.event_handler.openapi.models import (
+ Contact,
+ ExternalDocumentation,
+ License,
+ SecurityScheme,
+ Server,
+ Tag,
+ )
+
+logger = logging.getLogger(__name__)
+
+ConflictStrategy = Literal["warn", "error", "first", "last"]
+
+RESOLVER_CLASSES = frozenset(
+ {
+ "APIGatewayRestResolver",
+ "APIGatewayHttpResolver",
+ "ALBResolver",
+ "LambdaFunctionUrlResolver",
+ "VPCLatticeResolver",
+ "VPCLatticeV2Resolver",
+ "BedrockAgentResolver",
+ "ApiGatewayResolver",
+ },
+)
+
+
+def _is_resolver_call(node: ast.expr) -> bool:
+ """Check if an AST node is a call to a resolver class."""
+ if not isinstance(node, ast.Call):
+ return False
+ func = node.func
+ if isinstance(func, ast.Name) and func.id in RESOLVER_CLASSES:
+ return True
+ if isinstance(func, ast.Attribute) and func.attr in RESOLVER_CLASSES:
+ return True
+ return False
+
+
+def _file_has_resolver(file_path: Path, resolver_name: str) -> bool:
+ """Check if a Python file contains a resolver instance using AST."""
+ try:
+ source = file_path.read_text(encoding="utf-8")
+ tree = ast.parse(source, filename=str(file_path))
+ except (SyntaxError, UnicodeDecodeError):
+ return False
+
+ for node in ast.walk(tree):
+ targets: list[ast.expr] = []
+ value: ast.expr | None = None
+ if isinstance(node, ast.Assign):
+ targets = node.targets
+ value = node.value
+ elif isinstance(node, ast.AnnAssign):
+ targets = [node.target]
+ value = node.value
+ for target in targets:
+ if isinstance(target, ast.Name) and target.id == resolver_name:
+ if value is not None and _is_resolver_call(value):
+ return True
+ return False
+
+
+def _file_imports_resolver(file_path: Path, resolver_file: Path, resolver_name: str, root: Path) -> bool:
+ """Check if a Python file imports the resolver from the resolver file."""
+ try:
+ source = file_path.read_text(encoding="utf-8")
+ tree = ast.parse(source, filename=str(file_path))
+ except (SyntaxError, UnicodeDecodeError):
+ return False
+
+ # Get the module path of the resolver file relative to root
+ # e.g., "service/handlers/utils/rest_api_resolver.py" -> "service.handlers.utils.rest_api_resolver"
+ resolver_relative = resolver_file.relative_to(root).with_suffix("")
+ resolver_module = ".".join(resolver_relative.parts)
+
+ for node in ast.walk(tree):
+ # Check "from X import app" or "from X import app as something"
+ if isinstance(node, ast.ImportFrom) and node.module:
+ for alias in node.names:
+ if alias.name == resolver_name:
+ # Check if the import module matches the resolver module
+ if node.module == resolver_module:
+ return True
+ return False
+
+
+def _find_dependent_files(
+ search_path: Path,
+ resolver_file: Path,
+ resolver_name: str,
+ exclude: list[str],
+ project_root: Path,
+) -> list[Path]:
+ """Find all Python files that import the resolver.
+
+ Parameters
+ ----------
+ search_path : Path
+ Directory to search for dependent files.
+ resolver_file : Path
+ The resolver file that dependents import from.
+ resolver_name : str
+ Variable name of the resolver.
+ exclude : list[str]
+ Patterns to exclude.
+ project_root : Path
+ Root directory for resolving Python imports.
+ """
+ dependent_files: list[Path] = []
+
+ for file_path in search_path.rglob("*.py"):
+ if file_path == resolver_file:
+ continue
+ if _is_excluded(file_path, search_path, exclude):
+ continue
+ if _file_imports_resolver(file_path, resolver_file, resolver_name, project_root):
+ dependent_files.append(file_path)
+
+ return sorted(dependent_files)
+
+
+def _is_excluded(file_path: Path, root: Path, exclude_patterns: list[str]) -> bool:
+ """Check if a file matches any exclusion pattern."""
+ relative_str = str(file_path.relative_to(root))
+
+ for pattern in exclude_patterns:
+ if pattern.startswith("**/"):
+ sub_pattern = pattern[3:]
+ if fnmatch.fnmatch(relative_str, pattern) or fnmatch.fnmatch(file_path.name, sub_pattern):
+ return True
+ clean_pattern = sub_pattern.replace("/**", "").replace("/*", "")
+ for part in file_path.relative_to(root).parts:
+ if fnmatch.fnmatch(part, clean_pattern):
+ return True
+ elif fnmatch.fnmatch(relative_str, pattern) or fnmatch.fnmatch(file_path.name, pattern):
+ return True
+ return False
+
+
+def _get_glob_pattern(pat: str, recursive: bool) -> str:
+ """Get the glob pattern based on recursive flag."""
+ if recursive and not pat.startswith("**/"):
+ return f"**/{pat}"
+ if not recursive and pat.startswith("**/"):
+ return pat[3:]
+ return pat
+
+
+def _discover_resolver_files(
+ path: str | Path,
+ pattern: str | list[str],
+ exclude: list[str],
+ resolver_name: str,
+ recursive: bool = False,
+) -> list[Path]:
+ """Discover Python files containing resolver instances."""
+ root = Path(path).resolve()
+ if not root.exists():
+ raise FileNotFoundError(f"Path does not exist: {root}")
+
+ patterns = [pattern] if isinstance(pattern, str) else pattern
+ found_files: set[Path] = set()
+
+ for pat in patterns:
+ glob_pattern = _get_glob_pattern(pat, recursive)
+ for file_path in root.glob(glob_pattern):
+ if (
+ file_path.is_file()
+ and not _is_excluded(file_path, root, exclude)
+ and _file_has_resolver(file_path, resolver_name)
+ ):
+ found_files.add(file_path)
+
+ return sorted(found_files)
+
+
+def _load_module(file_path: Path, module_name: str) -> Any:
+ """Load a Python module from file."""
+ spec = importlib.util.spec_from_file_location(module_name, file_path)
+ if spec is None or spec.loader is None:
+ raise ImportError(f"Cannot load module from {file_path}")
+
+ module = importlib.util.module_from_spec(spec)
+ sys.modules[module_name] = module
+ spec.loader.exec_module(module)
+ return module
+
+
+def _load_resolver_with_dependencies(
+ file_path: Path,
+ resolver_name: str,
+ dependent_files: list[Path],
+ root: Path,
+) -> Any:
+ """Load a resolver instance, first loading all dependent files that register routes."""
+ file_path = Path(file_path).resolve()
+
+ # Add root to sys.path if not already there
+ root_str = str(root)
+ original_path = sys.path.copy()
+
+ try:
+ if root_str not in sys.path:
+ sys.path.insert(0, root_str)
+
+ # First, load all dependent files (they will import the resolver and register routes)
+ for dep_file in dependent_files:
+ dep_module_name = f"_powertools_dep_{dep_file.stem}_{id(dep_file)}"
+ try:
+ _load_module(dep_file, dep_module_name)
+ logger.debug(f"Loaded dependent file: {dep_file}")
+ except Exception as e:
+ warnings.warn(
+ f"Failed to load dependent file {dep_file}: {e}. "
+ "If your handler module has side effects at import time "
+ "(e.g. environment variable validation, database connections), "
+ "consider deferring them to runtime.",
+ stacklevel=2,
+ )
+
+ # Now get the resolver - it should already be loaded by the dependent files
+ # Try to get it from the module that was loaded by dependents
+ resolver_relative = file_path.relative_to(root).with_suffix("")
+ resolver_module_name = ".".join(resolver_relative.parts)
+
+ if resolver_module_name in sys.modules:
+ module = sys.modules[resolver_module_name]
+ else:
+ # Fallback: load the resolver file directly
+ module_name = f"_powertools_openapi_merge_{file_path.stem}_{id(file_path)}"
+ module = _load_module(file_path, module_name)
+
+ if not hasattr(module, resolver_name):
+ raise AttributeError(f"Resolver '{resolver_name}' not found in {file_path}.")
+ return getattr(module, resolver_name)
+ finally:
+ sys.path = original_path
+
+
+def _model_to_dict(obj: Any) -> Any:
+ """Convert Pydantic model to dict if needed."""
+ if hasattr(obj, "model_dump"):
+ return obj.model_dump(by_alias=True, exclude_none=True)
+ return obj
+
+
+class OpenAPIMerge:
+ """
+ Discover and merge OpenAPI schemas from multiple Lambda handlers.
+
+ This class supports two patterns:
+ 1. Standard pattern: Each handler file defines its own resolver with routes
+ 2. Shared resolver pattern: A central resolver file is imported by multiple handler files
+ that register routes on it
+
+ For the shared resolver pattern, this class automatically discovers files that import
+ the resolver and loads them before extracting the schema, ensuring all routes are registered.
+ """
+
+ def __init__(
+ self,
+ *,
+ title: str = DEFAULT_OPENAPI_TITLE,
+ version: str = DEFAULT_API_VERSION,
+ openapi_version: str = DEFAULT_OPENAPI_VERSION,
+ summary: str | None = None,
+ description: str | None = None,
+ tags: list[Tag | str] | None = None,
+ servers: list[Server] | None = None,
+ terms_of_service: str | None = None,
+ contact: Contact | None = None,
+ license_info: License | None = None,
+ security_schemes: dict[str, SecurityScheme] | None = None,
+ security: list[dict[str, list[str]]] | None = None,
+ external_documentation: ExternalDocumentation | None = None,
+ openapi_extensions: dict[str, Any] | None = None,
+ on_conflict: ConflictStrategy = "warn",
+ ):
+ self._config = OpenAPIConfig(
+ title=title,
+ version=version,
+ openapi_version=openapi_version,
+ summary=summary,
+ description=description,
+ tags=tags,
+ servers=servers,
+ terms_of_service=terms_of_service,
+ contact=contact,
+ license_info=license_info,
+ security_schemes=security_schemes,
+ security=security,
+ external_documentation=external_documentation,
+ openapi_extensions=openapi_extensions,
+ )
+ self._schemas: list[dict[str, Any]] = []
+ self._discovered_files: list[Path] = []
+ self._dependent_files: dict[Path, list[Path]] = {}
+ self._resolver_name: str = "app"
+ self._on_conflict = on_conflict
+ self._cached_schema: dict[str, Any] | None = None
+ self._root: Path | None = None
+ self._exclude: list[str] = []
+
+ def discover(
+ self,
+ path: str | Path,
+ pattern: str | list[str] = "handler.py",
+ exclude: list[str] | None = None,
+ resolver_name: str = "app",
+ recursive: bool = False,
+ project_root: str | Path | None = None,
+ ) -> list[Path]:
+ """Discover resolver files and their dependent handler files.
+
+ Parameters
+ ----------
+ path : str | Path
+ Directory to search for resolver files.
+ pattern : str | list[str]
+ Glob pattern(s) to match handler files.
+ exclude : list[str] | None
+ Patterns to exclude.
+ resolver_name : str
+ Variable name of the resolver instance.
+ recursive : bool
+ Whether to search recursively.
+ project_root : str | Path | None
+ Root directory for resolving Python imports. If None, uses current working directory.
+ This is needed when handlers import the resolver using absolute imports like
+ 'from service.handlers.utils.resolver import app'.
+ """
+ exclude = exclude or ["**/tests/**", "**/__pycache__/**", "**/.venv/**"]
+ self._exclude = exclude
+ self._resolver_name = resolver_name
+ self._search_path = Path(path).resolve()
+ self._root = Path(project_root).resolve() if project_root else self._search_path
+
+ self._discovered_files = _discover_resolver_files(path, pattern, exclude, resolver_name, recursive)
+
+ # For each resolver file, find files that import it (search within path, resolve imports with project_root)
+ for resolver_file in self._discovered_files:
+ dependent = _find_dependent_files(self._search_path, resolver_file, resolver_name, exclude, self._root)
+ self._dependent_files[resolver_file] = dependent
+ logger.debug(f"Found {len(dependent)} dependent files for {resolver_file}")
+
+ return self._discovered_files
+
+ def add_file(self, file_path: str | Path, resolver_name: str | None = None) -> None:
+ """Add a specific file to be included in the merge.
+
+ Note: Must be called before get_openapi_schema(). Adding files after
+ schema generation will not affect the cached result.
+ """
+ path = Path(file_path).resolve()
+ if path not in self._discovered_files:
+ self._discovered_files.append(path)
+ if resolver_name:
+ self._resolver_name = resolver_name
+
+ def add_schema(self, schema: dict[str, Any]) -> None:
+ """Add a pre-generated OpenAPI schema to be merged.
+
+ Note: Must be called before get_openapi_schema(). Adding schemas after
+ schema generation will not affect the cached result.
+ """
+ self._schemas.append(_model_to_dict(schema))
+
+ @property
+ def discovered_files(self) -> list[Path]:
+ """Get the list of discovered resolver files."""
+ return self._discovered_files.copy()
+
+ @property
+ def dependent_files(self) -> dict[Path, list[Path]]:
+ """Get the mapping of resolver files to their dependent handler files."""
+ return {k: v.copy() for k, v in self._dependent_files.items()}
+
+ def get_openapi_schema(self) -> dict[str, Any]:
+ """Generate the merged OpenAPI schema."""
+ if self._cached_schema is not None:
+ return self._cached_schema
+
+ for file_path in self._discovered_files:
+ try:
+ dependent = self._dependent_files.get(file_path, [])
+ root = self._root or file_path.parent
+ resolver = _load_resolver_with_dependencies(
+ file_path,
+ self._resolver_name,
+ dependent,
+ root,
+ )
+ if hasattr(resolver, "get_openapi_schema"):
+ self._schemas.append(_model_to_dict(resolver.get_openapi_schema()))
+ except (ImportError, AttributeError, FileNotFoundError) as e:
+ warnings.warn(
+ f"Failed to load resolver from {file_path}: {e}. "
+ "If your handler module has side effects at import time "
+ "(e.g. environment variable validation, database connections), "
+ "consider deferring them to runtime.",
+ stacklevel=1,
+ )
+
+ self._cached_schema = self._merge_schemas()
+
+ if self._discovered_files and not self._cached_schema.get("paths"):
+ warnings.warn(
+ f"OpenAPIMerge discovered {len(self._discovered_files)} handler file(s) "
+ "but the final schema has no paths. "
+ "Check if your handler modules have side effects at import time "
+ "that prevent route registration.",
+ stacklevel=1,
+ )
+
+ return self._cached_schema
+
+ def get_openapi_json_schema(self) -> str:
+ """Generate the merged OpenAPI schema as JSON string."""
+ from aws_lambda_powertools.event_handler.openapi.compat import model_json
+ from aws_lambda_powertools.event_handler.openapi.models import OpenAPI
+
+ schema = self.get_openapi_schema()
+ return model_json(OpenAPI(**schema), by_alias=True, exclude_none=True, indent=2)
+
+ def _merge_schemas(self) -> dict[str, Any]:
+ """Merge all schemas into a single OpenAPI schema."""
+ cfg = self._config
+
+ merged: dict[str, Any] = {
+ "openapi": cfg.openapi_version,
+ "info": {"title": cfg.title, "version": cfg.version},
+ "servers": [_model_to_dict(s) for s in cfg.servers] if cfg.servers else [{"url": "/"}],
+ }
+
+ self._add_optional_info_fields(merged, cfg)
+
+ merged_paths: dict[str, Any] = {}
+ merged_components: dict[str, dict[str, Any]] = {}
+
+ for schema in self._schemas:
+ self._merge_paths(schema.get("paths", {}), merged_paths)
+ self._merge_components(schema.get("components", {}), merged_components)
+
+ if cfg.security_schemes:
+ merged_components.setdefault("securitySchemes", {}).update(cfg.security_schemes)
+
+ if merged_paths:
+ merged["paths"] = merged_paths
+ if merged_components:
+ merged["components"] = merged_components
+
+ if merged_tags := self._merge_tags():
+ merged["tags"] = merged_tags
+
+ return merged
+
+ def _add_optional_info_fields(self, merged: dict[str, Any], cfg: OpenAPIConfig) -> None:
+ """Add optional fields from config to the merged schema."""
+ if cfg.summary:
+ merged["info"]["summary"] = cfg.summary
+ if cfg.description:
+ merged["info"]["description"] = cfg.description
+ if cfg.terms_of_service:
+ merged["info"]["termsOfService"] = cfg.terms_of_service
+ if cfg.contact:
+ merged["info"]["contact"] = _model_to_dict(cfg.contact)
+ if cfg.license_info:
+ merged["info"]["license"] = _model_to_dict(cfg.license_info)
+ if cfg.security:
+ merged["security"] = cfg.security
+ if cfg.external_documentation:
+ merged["externalDocs"] = _model_to_dict(cfg.external_documentation)
+ if cfg.openapi_extensions:
+ merged.update(cfg.openapi_extensions)
+
+ def _merge_paths(self, source_paths: dict[str, Any], target: dict[str, Any]) -> None:
+ """Merge paths from source into target."""
+ for path, path_item in source_paths.items():
+ if path not in target:
+ target[path] = path_item
+ else:
+ for method, operation in path_item.items():
+ if method not in target[path]:
+ target[path][method] = operation
+ else:
+ self._handle_conflict(method, path, target, operation)
+
+ def _handle_conflict(self, method: str, path: str, target: dict, operation: Any) -> None:
+ """Handle path/method conflict based on strategy."""
+ msg = f"Conflict: {method.upper()} {path} is defined in multiple schemas"
+ if self._on_conflict == "error":
+ raise OpenAPIMergeError(msg)
+ elif self._on_conflict == "warn":
+ logger.warning(f"{msg}. Keeping first definition.")
+ elif self._on_conflict == "last":
+ target[path][method] = operation
+
+ def _merge_components(self, source: dict[str, Any], target: dict[str, dict[str, Any]]) -> None:
+ """Merge components from source into target."""
+ for component_type, components in source.items():
+ target.setdefault(component_type, {}).update(components)
+
+ def _merge_tags(self) -> list[dict[str, Any]]:
+ """Merge tags from config and schemas."""
+ tags_map: dict[str, dict[str, Any]] = {}
+
+ for tag in self._config.tags or []:
+ if isinstance(tag, str):
+ tags_map[tag] = {"name": tag}
+ else:
+ tag_dict = _model_to_dict(tag)
+ tags_map[tag_dict["name"]] = tag_dict
+
+ for schema in self._schemas:
+ for tag in schema.get("tags", []):
+ name = tag["name"] if isinstance(tag, dict) else tag
+ if name not in tags_map:
+ tags_map[name] = tag if isinstance(tag, dict) else {"name": tag}
+
+ return list(tags_map.values())
diff --git a/aws_lambda_powertools/event_handler/openapi/models.py b/aws_lambda_powertools/event_handler/openapi/models.py
new file mode 100644
index 00000000000..53becd3f870
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/openapi/models.py
@@ -0,0 +1,486 @@
+# ruff: noqa: FA100
+from enum import Enum
+from typing import Any, Dict, List, Literal, Optional, Set, Union
+
+from pydantic import AnyUrl, BaseModel, ConfigDict, Field, model_validator
+from typing_extensions import Annotated
+
+from aws_lambda_powertools.event_handler.openapi.compat import model_rebuild
+from aws_lambda_powertools.event_handler.openapi.exceptions import SchemaValidationError
+
+MODEL_CONFIG_ALLOW = ConfigDict(extra="allow")
+MODEL_CONFIG_IGNORE = ConfigDict(extra="ignore")
+
+"""
+The code defines Pydantic models for the various OpenAPI objects like OpenAPI, PathItem, Operation, Parameter etc.
+These models can be used to parse OpenAPI JSON/YAML files into Python objects, or generate OpenAPI from Python data.
+"""
+
+
+class OpenAPIExtensions(BaseModel):
+ """
+ This class serves as a Pydantic proxy model to add OpenAPI extensions.
+
+ OpenAPI extensions are arbitrary fields, so we remove openapi_extensions when dumping
+ and add only the provided value in the schema.
+ """
+
+ openapi_extensions: Optional[Dict[str, Any]] = None
+
+ # If the 'openapi_extensions' field is present in the 'values' dictionary,
+ # And if the extension starts with x- (must respect the RFC)
+ # update the 'values' dictionary with the contents of 'openapi_extensions',
+ # and then remove the 'openapi_extensions' field from the 'values' dictionary
+ model_config = {"extra": "allow"}
+
+ @model_validator(mode="before")
+ def serialize_openapi_extension_v2(self):
+ if isinstance(self, dict) and self.get("openapi_extensions"):
+ openapi_extension_value = self.get("openapi_extensions")
+
+ for extension_key in openapi_extension_value:
+ if not str(extension_key).startswith("x-"):
+ raise SchemaValidationError("An OpenAPI extension key must start with x-")
+
+ self.update(openapi_extension_value)
+ self.pop("openapi_extensions", None)
+
+ return self
+
+
+# https://swagger.io/specification/#contact-object
+class Contact(BaseModel):
+ name: Optional[str] = None
+ url: Optional[AnyUrl] = None
+ email: Optional[str] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+# https://swagger.io/specification/#license-object
+class License(BaseModel):
+ name: str
+ identifier: Optional[str] = None
+ url: Optional[AnyUrl] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+# https://swagger.io/specification/#info-object
+class Info(BaseModel):
+ title: str
+ description: Optional[str] = None
+ termsOfService: Optional[str] = None
+ contact: Optional[Contact] = None
+ license: Optional[License] = None # noqa: A003
+ version: str
+ summary: Optional[str] = None
+
+ model_config = MODEL_CONFIG_IGNORE
+
+
+# https://swagger.io/specification/#server-variable-object
+class ServerVariable(BaseModel):
+ enum: Annotated[Optional[List[str]], Field(min_length=1)] = None
+ default: str
+ description: Optional[str] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+# https://swagger.io/specification/#server-object
+class Server(OpenAPIExtensions):
+ url: Union[AnyUrl, str]
+ description: Optional[str] = None
+ variables: Optional[Dict[str, ServerVariable]] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+# https://swagger.io/specification/#reference-object
+class Reference(BaseModel):
+ ref: str = Field(alias="$ref")
+
+
+# https://swagger.io/specification/#discriminator-object
+class Discriminator(BaseModel):
+ propertyName: str
+ mapping: Optional[Dict[str, str]] = None
+
+
+# https://swagger.io/specification/#xml-object
+class XML(BaseModel):
+ name: Optional[str] = None
+ namespace: Optional[str] = None
+ prefix: Optional[str] = None
+ attribute: Optional[bool] = None
+ wrapped: Optional[bool] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+# https://swagger.io/specification/#external-documentation-object
+class ExternalDocumentation(BaseModel):
+ description: Optional[str] = None
+ url: AnyUrl
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+# https://swagger.io/specification/#schema-object
+class Schema(BaseModel):
+ # Ref: JSON Schema 2020-12: https://json-schema.org/draft/2020-12/json-schema-core.html#name-the-json-schema-core-vocabu
+ # Core Vocabulary
+ schema_: Optional[str] = Field(default=None, alias="$schema")
+ vocabulary: Optional[str] = Field(default=None, alias="$vocabulary")
+ id: Optional[str] = Field(default=None, alias="$id") # noqa: A003
+ anchor: Optional[str] = Field(default=None, alias="$anchor")
+ dynamicAnchor: Optional[str] = Field(default=None, alias="$dynamicAnchor")
+ ref: Optional[str] = Field(default=None, alias="$ref")
+ dynamicRef: Optional[str] = Field(default=None, alias="$dynamicRef")
+ defs: Optional[Dict[str, "SchemaOrBool"]] = Field(default=None, alias="$defs")
+ comment: Optional[str] = Field(default=None, alias="$comment")
+ # Ref: JSON Schema 2020-12: https://json-schema.org/draft/2020-12/json-schema-core.html#name-a-vocabulary-for-applying-s
+ # A Vocabulary for Applying Subschemas
+ allOf: Optional[List["SchemaOrBool"]] = None
+ anyOf: Optional[List["SchemaOrBool"]] = None
+ oneOf: Optional[List["SchemaOrBool"]] = None
+ not_: Optional["SchemaOrBool"] = Field(default=None, alias="not")
+ if_: Optional["SchemaOrBool"] = Field(default=None, alias="if")
+ then: Optional["SchemaOrBool"] = None
+ else_: Optional["SchemaOrBool"] = Field(default=None, alias="else")
+ dependentSchemas: Optional[Dict[str, "SchemaOrBool"]] = None
+ prefixItems: Optional[List["SchemaOrBool"]] = None
+ # MAINTENANCE: uncomment and remove below when deprecating Pydantic v1
+ # MAINTENANCE: It generates a list of schemas for tuples, before prefixItems was available
+ # MAINTENANCE: items: Optional["SchemaOrBool"] = None
+ items: Optional[Union["SchemaOrBool", List["SchemaOrBool"]]] = None
+ contains: Optional["SchemaOrBool"] = None
+ properties: Optional[Dict[str, "SchemaOrBool"]] = None
+ patternProperties: Optional[Dict[str, "SchemaOrBool"]] = None
+ additionalProperties: Optional["SchemaOrBool"] = None
+ propertyNames: Optional["SchemaOrBool"] = None
+ unevaluatedItems: Optional["SchemaOrBool"] = None
+ unevaluatedProperties: Optional["SchemaOrBool"] = None
+ # Ref: JSON Schema Validation 2020-12: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-a-vocabulary-for-structural
+ # A Vocabulary for Structural Validation
+ type: Optional[str] = None # noqa: A003
+ enum: Optional[List[Any]] = None
+ const: Optional[Any] = None
+ multipleOf: Optional[float] = Field(default=None, gt=0)
+ maximum: Optional[float] = None
+ exclusiveMaximum: Optional[float] = None
+ minimum: Optional[float] = None
+ exclusiveMinimum: Optional[float] = None
+ maxLength: Optional[int] = Field(default=None, ge=0)
+ minLength: Optional[int] = Field(default=None, ge=0)
+ pattern: Optional[str] = None
+ maxItems: Optional[int] = Field(default=None, ge=0)
+ minItems: Optional[int] = Field(default=None, ge=0)
+ uniqueItems: Optional[bool] = None
+ maxContains: Optional[int] = Field(default=None, ge=0)
+ minContains: Optional[int] = Field(default=None, ge=0)
+ maxProperties: Optional[int] = Field(default=None, ge=0)
+ minProperties: Optional[int] = Field(default=None, ge=0)
+ required: Optional[List[str]] = None
+ dependentRequired: Optional[Dict[str, Set[str]]] = None
+ # Ref: JSON Schema Validation 2020-12: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-vocabularies-for-semantic-c
+ # Vocabularies for Semantic Content With "format"
+ format: Optional[str] = None # noqa: A003
+ # Ref: JSON Schema Validation 2020-12: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-a-vocabulary-for-the-conten
+ # A Vocabulary for the Contents of String-Encoded Data
+ contentEncoding: Optional[str] = None
+ contentMediaType: Optional[str] = None
+ contentSchema: Optional["SchemaOrBool"] = None
+ # Ref: JSON Schema Validation 2020-12: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-a-vocabulary-for-basic-meta
+ # A Vocabulary for Basic Meta-Data Annotations
+ title: Optional[str] = None
+ description: Optional[str] = None
+ default: Optional[Any] = None
+ deprecated: Optional[bool] = None
+ readOnly: Optional[bool] = None
+ writeOnly: Optional[bool] = None
+ examples: Optional[List[Any]] = None
+ # Ref: OpenAPI 3.0.0: https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.0.md#schema-object
+ # Schema Object
+ discriminator: Optional[Discriminator] = None
+ xml: Optional[XML] = None
+ externalDocs: Optional[ExternalDocumentation] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+# Ref: https://json-schema.org/draft/2020-12/json-schema-core.html#name-json-schema-documents
+# A JSON Schema MUST be an object or a boolean.
+SchemaOrBool = Union[Schema, bool]
+
+
+# https://swagger.io/specification/#example-object
+class Example(BaseModel):
+ summary: Optional[str] = None
+ description: Optional[str] = None
+ value: Optional[Any] = None
+ externalValue: Optional[AnyUrl] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+class ParameterInType(Enum):
+ query = "query"
+ header = "header"
+ path = "path"
+ cookie = "cookie"
+
+
+# https://swagger.io/specification/#encoding-object
+class Encoding(BaseModel):
+ contentType: Optional[str] = None
+ headers: Optional[Dict[str, Union["Header", Reference]]] = None
+ style: Optional[str] = None
+ explode: Optional[bool] = None
+ allowReserved: Optional[bool] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+# https://swagger.io/specification/#media-type-object
+class MediaType(BaseModel):
+ schema_: Optional[Union[Schema, Reference]] = Field(default=None, alias="schema")
+ examples: Optional[Dict[str, Union[Example, Reference]]] = None
+ encoding: Optional[Dict[str, Encoding]] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+# https://swagger.io/specification/#parameter-object
+class ParameterBase(BaseModel):
+ description: Optional[str] = None
+ required: Optional[bool] = None
+ deprecated: Optional[bool] = None
+ # Serialization rules for simple scenarios
+ style: Optional[str] = None
+ explode: Optional[bool] = None
+ allowReserved: Optional[bool] = None
+ schema_: Optional[Union[Schema, Reference]] = Field(default=None, alias="schema")
+ examples: Optional[Dict[str, Union[Example, Reference]]] = None
+ # Serialization rules for more complex scenarios
+ content: Optional[Dict[str, MediaType]] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+class Parameter(ParameterBase):
+ name: str
+ in_: ParameterInType = Field(alias="in")
+
+
+class Header(ParameterBase):
+ pass
+
+
+# https://swagger.io/specification/#request-body-object
+class RequestBody(BaseModel):
+ description: Optional[str] = None
+ content: Dict[str, MediaType]
+ required: Optional[bool] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+# https://swagger.io/specification/#link-object
+class Link(BaseModel):
+ operationRef: Optional[str] = None
+ operationId: Optional[str] = None
+ parameters: Optional[Dict[str, Union[Any, str]]] = None
+ requestBody: Optional[Union[Any, str]] = None
+ description: Optional[str] = None
+ server: Optional[Server] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+# https://swagger.io/specification/#response-object
+class Response(BaseModel):
+ description: str
+ headers: Optional[Dict[str, Union[Header, Reference]]] = None
+ content: Optional[Dict[str, MediaType]] = None
+ links: Optional[Dict[str, Union[Link, Reference]]] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+# https://swagger.io/specification/#tag-object
+class Tag(BaseModel):
+ name: str
+ description: Optional[str] = None
+ externalDocs: Optional[ExternalDocumentation] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+# https://swagger.io/specification/#operation-object
+class Operation(OpenAPIExtensions):
+ tags: Optional[List[str]] = None
+ summary: Optional[str] = None
+ description: Optional[str] = None
+ externalDocs: Optional[ExternalDocumentation] = None
+ operationId: Optional[str] = None
+ parameters: Optional[List[Union[Parameter, Reference]]] = None
+ requestBody: Optional[Union[RequestBody, Reference]] = None
+ # Using Any for Specification Extensions
+ responses: Optional[Dict[int, Union[Response, Any]]] = None
+ callbacks: Optional[Dict[str, Union[Dict[str, "PathItem"], Reference]]] = None
+ deprecated: Optional[bool] = None
+ security: Optional[List[Dict[str, List[str]]]] = None
+ servers: Optional[List[Server]] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+# https://swagger.io/specification/#path-item-object
+class PathItem(BaseModel):
+ ref: Optional[str] = Field(default=None, alias="$ref")
+ summary: Optional[str] = None
+ description: Optional[str] = None
+ get: Optional[Operation] = None
+ put: Optional[Operation] = None
+ post: Optional[Operation] = None
+ delete: Optional[Operation] = None
+ options: Optional[Operation] = None
+ head: Optional[Operation] = None
+ patch: Optional[Operation] = None
+ trace: Optional[Operation] = None
+ servers: Optional[List[Server]] = None
+ parameters: Optional[List[Union[Parameter, Reference]]] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+# https://swagger.io/specification/#security-scheme-object
+class SecuritySchemeType(Enum):
+ apiKey = "apiKey"
+ http = "http"
+ oauth2 = "oauth2"
+ openIdConnect = "openIdConnect"
+ mutualTLS = "mutualTLS"
+
+
+class SecurityBase(OpenAPIExtensions):
+ type_: SecuritySchemeType = Field(alias="type")
+ description: Optional[str] = None
+
+ model_config = {"extra": "allow", "populate_by_name": True}
+
+
+class APIKeyIn(Enum):
+ query = "query"
+ header = "header"
+ cookie = "cookie"
+
+
+class APIKey(SecurityBase):
+ type_: SecuritySchemeType = Field(default=SecuritySchemeType.apiKey, alias="type")
+ in_: APIKeyIn = Field(alias="in")
+ name: str
+
+
+class HTTPBase(SecurityBase):
+ type_: SecuritySchemeType = Field(default=SecuritySchemeType.http, alias="type")
+ scheme: str
+
+
+class HTTPBearer(HTTPBase): # type: ignore[override]
+ scheme: Literal["bearer"] = "bearer"
+ bearerFormat: Optional[str] = None
+
+
+class OAuthFlow(BaseModel):
+ refreshUrl: Optional[str] = None
+ scopes: Dict[str, str] = {}
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+class OAuthFlowImplicit(OAuthFlow):
+ authorizationUrl: str
+
+
+class OAuthFlowPassword(OAuthFlow):
+ tokenUrl: str
+
+
+class OAuthFlowClientCredentials(OAuthFlow):
+ tokenUrl: str
+
+
+class OAuthFlowAuthorizationCode(OAuthFlow):
+ authorizationUrl: str
+ tokenUrl: str
+
+
+class OAuthFlows(BaseModel):
+ implicit: Optional[OAuthFlowImplicit] = None
+ password: Optional[OAuthFlowPassword] = None
+ clientCredentials: Optional[OAuthFlowClientCredentials] = None
+ authorizationCode: Optional[OAuthFlowAuthorizationCode] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+class OAuth2(SecurityBase):
+ type_: SecuritySchemeType = Field(default=SecuritySchemeType.oauth2, alias="type")
+ flows: OAuthFlows
+
+
+class OpenIdConnect(SecurityBase):
+ type_: SecuritySchemeType = Field(
+ default=SecuritySchemeType.openIdConnect,
+ alias="type",
+ )
+ openIdConnectUrl: str
+
+
+class MutualTLS(SecurityBase):
+ type_: SecuritySchemeType = Field(default=SecuritySchemeType.mutualTLS, alias="type")
+
+
+SecurityScheme = Union[APIKey, HTTPBase, OAuth2, OpenIdConnect, HTTPBearer, MutualTLS]
+
+
+# https://swagger.io/specification/#components-object
+class Components(BaseModel):
+ schemas: Optional[Dict[str, Union[Schema, Reference]]] = None
+ responses: Optional[Dict[str, Union[Response, Reference]]] = None
+ parameters: Optional[Dict[str, Union[Parameter, Reference]]] = None
+ examples: Optional[Dict[str, Union[Example, Reference]]] = None
+ requestBodies: Optional[Dict[str, Union[RequestBody, Reference]]] = None
+ headers: Optional[Dict[str, Union[Header, Reference]]] = None
+ securitySchemes: Optional[Dict[str, Union[SecurityScheme, Reference]]] = None
+ links: Optional[Dict[str, Union[Link, Reference]]] = None
+ # Using Any for Specification Extensions
+ callbacks: Optional[Dict[str, Union[Dict[str, PathItem], Reference, Any]]] = None
+ pathItems: Optional[Dict[str, Union[PathItem, Reference]]] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+# https://swagger.io/specification/#openapi-object
+class OpenAPI(OpenAPIExtensions):
+ openapi: str
+ info: Info
+ jsonSchemaDialect: Optional[str] = None
+ servers: Optional[List[Server]] = None
+ # Using Any for Specification Extensions
+ paths: Optional[Dict[str, Union[PathItem, Any]]] = None
+ webhooks: Optional[Dict[str, Union[PathItem, Reference]]] = None
+ components: Optional[Components] = None
+ security: Optional[List[Dict[str, List[str]]]] = None
+ tags: Optional[List[Tag]] = None
+ externalDocs: Optional[ExternalDocumentation] = None
+
+ model_config = MODEL_CONFIG_ALLOW
+
+
+model_rebuild(Schema)
+model_rebuild(Operation)
+model_rebuild(Encoding)
diff --git a/aws_lambda_powertools/event_handler/openapi/params.py b/aws_lambda_powertools/event_handler/openapi/params.py
new file mode 100644
index 00000000000..468e2253b39
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/openapi/params.py
@@ -0,0 +1,1169 @@
+from __future__ import annotations
+
+import inspect
+from enum import Enum
+from typing import TYPE_CHECKING, Any, Literal
+
+from pydantic import BaseConfig, BaseModel, create_model
+from pydantic.fields import FieldInfo
+from typing_extensions import Annotated, get_args, get_origin
+
+from aws_lambda_powertools.event_handler import Response
+from aws_lambda_powertools.event_handler.openapi.compat import (
+ ModelField,
+ Required,
+ Undefined,
+ UndefinedType,
+ copy_field_info,
+ field_annotation_is_scalar,
+ get_annotation_from_field_info,
+ lenient_issubclass,
+)
+
+if TYPE_CHECKING:
+ from collections.abc import Callable
+
+ from aws_lambda_powertools.event_handler.depends import DependencyParam
+ from aws_lambda_powertools.event_handler.openapi.models import Example
+ from aws_lambda_powertools.event_handler.openapi.types import CacheKey
+
+"""
+This turns the low-level function signature into typed, validated Pydantic models for consumption.
+"""
+
+
+class ParamTypes(Enum):
+ query = "query"
+ header = "header"
+ path = "path"
+ cookie = "cookie"
+
+
+# MAINTENANCE: update when deprecating Pydantic v1, remove this alias
+_Unset: Any = Undefined
+
+
+class Dependant:
+ """
+ A class used internally to represent a dependency between path operation decorators and the path operation function.
+ """
+
+ def __init__(
+ self,
+ *,
+ path_params: list[ModelField] | None = None,
+ query_params: list[ModelField] | None = None,
+ header_params: list[ModelField] | None = None,
+ cookie_params: list[ModelField] | None = None,
+ body_params: list[ModelField] | None = None,
+ return_param: ModelField | None = None,
+ response_extra_models: list[ModelField] | None = None,
+ name: str | None = None,
+ call: Callable[..., Any] | None = None,
+ request_param_name: str | None = None,
+ websocket_param_name: str | None = None,
+ http_connection_param_name: str | None = None,
+ response_param_name: str | None = None,
+ background_tasks_param_name: str | None = None,
+ dependencies: list[DependencyParam] | None = None,
+ path: str | None = None,
+ ) -> None:
+ self.path_params = path_params or []
+ self.query_params = query_params or []
+ self.header_params = header_params or []
+ self.cookie_params = cookie_params or []
+ self.body_params = body_params or []
+ self.return_param = return_param or None
+ self.response_extra_models = response_extra_models or []
+ self.request_param_name = request_param_name
+ self.websocket_param_name = websocket_param_name
+ self.http_connection_param_name = http_connection_param_name
+ self.response_param_name = response_param_name
+ self.background_tasks_param_name = background_tasks_param_name
+ self.dependencies = dependencies or []
+ self.name = name
+ self.call = call
+ # Store the path to be able to re-generate a dependable from it in overrides
+ self.path = path
+ # Save the cache key at creation to optimize performance
+ self.cache_key: CacheKey = self.call
+
+
+class Param(FieldInfo): # type: ignore[misc]
+ """
+ A class used internally to represent a parameter in a path operation.
+ """
+
+ in_: ParamTypes
+
+ def __init__(
+ self,
+ default: Any = Undefined,
+ *,
+ default_factory: Callable[[], Any] | None = _Unset,
+ annotation: Any | None = None,
+ alias: str | None = None,
+ alias_priority: int | None = _Unset,
+ # MAINTENANCE: update when deprecating Pydantic v1, import these types
+ # MAINTENANCE: validation_alias: str | AliasPath | AliasChoices | None
+ validation_alias: str | None = _Unset,
+ serialization_alias: str | None = None,
+ title: str | None = None,
+ description: str | None = None,
+ gt: float | None = None,
+ ge: float | None = None,
+ lt: float | None = None,
+ le: float | None = None,
+ min_length: int | None = None,
+ max_length: int | None = None,
+ pattern: str | None = None,
+ discriminator: str | None = None,
+ strict: bool | None = _Unset,
+ multiple_of: float | None = _Unset,
+ allow_inf_nan: bool | None = _Unset,
+ max_digits: int | None = _Unset,
+ decimal_places: int | None = _Unset,
+ examples: list[Any] | None = None,
+ openapi_examples: dict[str, Example] | None = None,
+ deprecated: bool | None = None,
+ include_in_schema: bool = True,
+ json_schema_extra: dict[str, Any] | None = None,
+ **extra: Any,
+ ):
+ """
+ Constructs a new Param.
+
+ Parameters
+ ----------
+ default: Any
+ The default value of the parameter
+ default_factory: Callable[[], Any], optional
+ Callable that will be called when a default value is needed for this field
+ annotation: Any, optional
+ The type annotation of the parameter
+ alias: str, optional
+ The public name of the field
+ alias_priority: int, optional
+ Priority of the alias. This affects whether an alias generator is used
+ validation_alias: str | AliasPath | AliasChoices | None, optional
+ Alias to be used for validation only
+ serialization_alias: str | AliasPath | AliasChoices | None, optional
+ Alias to be used for serialization only
+ title: str, optional
+ The title of the parameter
+ description: str, optional
+ The description of the parameter
+ gt: float, optional
+ Only applies to numbers, required the field to be "greater than"
+ ge: float, optional
+ Only applies to numbers, required the field to be "greater than or equal"
+ lt: float, optional
+ Only applies to numbers, required the field to be "less than"
+ le: float, optional
+ Only applies to numbers, required the field to be "less than or equal"
+ min_length: int, optional
+ Only applies to strings, required the field to have a minimum length
+ max_length: int, optional
+ Only applies to strings, required the field to have a maximum length
+ pattern: str, optional
+ Only applies to strings, requires the field match against a regular expression pattern string
+ discriminator: str, optional
+ Parameter field name for discriminating the type in a tagged union
+ strict: bool, optional
+ Enables Pydantic's strict mode for the field
+ multiple_of: float, optional
+ Only applies to numbers, requires the field to be a multiple of the given value
+ allow_inf_nan: bool, optional
+ Only applies to numbers, requires the field to allow infinity and NaN values
+ max_digits: int, optional
+ Only applies to Decimals, requires the field to have a maxmium number of digits within the decimal.
+ decimal_places: int, optional
+ Only applies to Decimals, requires the field to have at most a number of decimal places
+ examples: list[Any], optional
+ A list of examples for the parameter
+ deprecated: bool, optional
+ If `True`, the parameter will be marked as deprecated
+ include_in_schema: bool, optional
+ If `False`, the parameter will be excluded from the generated OpenAPI schema
+ json_schema_extra: dict[str, Any], optional
+ Extra values to include in the generated OpenAPI schema
+ """
+ self.deprecated = deprecated
+ self.include_in_schema = include_in_schema
+
+ kwargs = dict(
+ default=default,
+ default_factory=default_factory,
+ alias=alias,
+ title=title,
+ description=description,
+ gt=gt,
+ ge=ge,
+ lt=lt,
+ le=le,
+ min_length=min_length,
+ max_length=max_length,
+ discriminator=discriminator,
+ multiple_of=multiple_of,
+ allow_nan=allow_inf_nan,
+ max_digits=max_digits,
+ decimal_places=decimal_places,
+ **extra,
+ )
+ if examples is not None:
+ kwargs["examples"] = examples
+
+ if openapi_examples is not None:
+ kwargs["openapi_examples"] = openapi_examples
+
+ current_json_schema_extra = json_schema_extra or extra
+
+ self.openapi_examples = openapi_examples
+
+ # Pydantic 2.12+ no longer copies alias to validation_alias automatically
+ # Ensure alias and validation_alias are in sync when only one is provided
+ if validation_alias is _Unset and alias is not None:
+ validation_alias = alias
+ elif alias is None and validation_alias is not _Unset and validation_alias is not None:
+ alias = validation_alias
+ kwargs["alias"] = alias
+
+ kwargs.update(
+ {
+ "annotation": annotation,
+ "alias_priority": alias_priority,
+ "validation_alias": validation_alias,
+ "serialization_alias": serialization_alias,
+ "strict": strict,
+ "json_schema_extra": current_json_schema_extra,
+ "pattern": pattern,
+ },
+ )
+
+ use_kwargs = {k: v for k, v in kwargs.items() if v is not _Unset}
+
+ super().__init__(**use_kwargs)
+
+ def __repr__(self) -> str:
+ return f"{self.__class__.__name__}({self.default})"
+
+
+class Path(Param): # type: ignore[misc]
+ """
+ A class used internally to represent a path parameter in a path operation.
+ """
+
+ in_ = ParamTypes.path
+
+ def __init__(
+ self,
+ default: Any = ...,
+ *,
+ default_factory: Callable[[], Any] | None = _Unset,
+ annotation: Any | None = None,
+ alias: str | None = None,
+ alias_priority: int | None = _Unset,
+ # MAINTENANCE: update when deprecating Pydantic v1, import these types
+ # MAINTENANCE: validation_alias: str | AliasPath | AliasChoices | None
+ validation_alias: str | None = _Unset,
+ serialization_alias: str | None = None,
+ title: str | None = None,
+ description: str | None = None,
+ gt: float | None = None,
+ ge: float | None = None,
+ lt: float | None = None,
+ le: float | None = None,
+ min_length: int | None = None,
+ max_length: int | None = None,
+ pattern: str | None = None,
+ discriminator: str | None = None,
+ strict: bool | None = _Unset,
+ multiple_of: float | None = _Unset,
+ allow_inf_nan: bool | None = _Unset,
+ max_digits: int | None = _Unset,
+ decimal_places: int | None = _Unset,
+ examples: list[Any] | None = None,
+ openapi_examples: dict[str, Example] | None = None,
+ deprecated: bool | None = None,
+ include_in_schema: bool = True,
+ json_schema_extra: dict[str, Any] | None = None,
+ **extra: Any,
+ ):
+ if default is not ...:
+ raise AssertionError("Path parameters cannot have a default value")
+
+ super().__init__(
+ default=default,
+ default_factory=default_factory,
+ annotation=annotation,
+ alias=alias,
+ alias_priority=alias_priority,
+ validation_alias=validation_alias,
+ serialization_alias=serialization_alias,
+ title=title,
+ description=description,
+ gt=gt,
+ ge=ge,
+ lt=lt,
+ le=le,
+ min_length=min_length,
+ max_length=max_length,
+ pattern=pattern,
+ discriminator=discriminator,
+ strict=strict,
+ multiple_of=multiple_of,
+ allow_inf_nan=allow_inf_nan,
+ max_digits=max_digits,
+ decimal_places=decimal_places,
+ deprecated=deprecated,
+ examples=examples,
+ openapi_examples=openapi_examples,
+ include_in_schema=include_in_schema,
+ json_schema_extra=json_schema_extra,
+ **extra,
+ )
+
+
+class Query(Param): # type: ignore[misc]
+ """
+ A class used internally to represent a query parameter in a path operation.
+ """
+
+ in_ = ParamTypes.query
+
+ def __init__(
+ self,
+ default: Any = _Unset,
+ *,
+ default_factory: Callable[[], Any] | None = _Unset,
+ annotation: Any | None = None,
+ alias: str | None = None,
+ alias_priority: int | None = _Unset,
+ validation_alias: str | None = _Unset,
+ serialization_alias: str | None = None,
+ title: str | None = None,
+ description: str | None = None,
+ gt: float | None = None,
+ ge: float | None = None,
+ lt: float | None = None,
+ le: float | None = None,
+ min_length: int | None = None,
+ max_length: int | None = None,
+ pattern: str | None = None,
+ discriminator: str | None = None,
+ strict: bool | None = _Unset,
+ multiple_of: float | None = _Unset,
+ allow_inf_nan: bool | None = _Unset,
+ max_digits: int | None = _Unset,
+ decimal_places: int | None = _Unset,
+ examples: list[Any] | None = None,
+ openapi_examples: dict[str, Example] | None = None,
+ deprecated: bool | None = None,
+ include_in_schema: bool = True,
+ json_schema_extra: dict[str, Any] | None = None,
+ **extra: Any,
+ ):
+ super().__init__(
+ default=default,
+ default_factory=default_factory,
+ annotation=annotation,
+ alias=alias,
+ alias_priority=alias_priority,
+ validation_alias=validation_alias,
+ serialization_alias=serialization_alias,
+ title=title,
+ description=description,
+ gt=gt,
+ ge=ge,
+ lt=lt,
+ le=le,
+ min_length=min_length,
+ max_length=max_length,
+ pattern=pattern,
+ discriminator=discriminator,
+ strict=strict,
+ multiple_of=multiple_of,
+ allow_inf_nan=allow_inf_nan,
+ max_digits=max_digits,
+ decimal_places=decimal_places,
+ deprecated=deprecated,
+ examples=examples,
+ openapi_examples=openapi_examples,
+ include_in_schema=include_in_schema,
+ json_schema_extra=json_schema_extra,
+ **extra,
+ )
+
+
+class Header(Param): # type: ignore[misc]
+ """
+ A class used internally to represent a header parameter in a path operation.
+ """
+
+ in_ = ParamTypes.header
+
+ def __init__(
+ self,
+ default: Any = Undefined,
+ *,
+ default_factory: Callable[[], Any] | None = _Unset,
+ annotation: Any | None = None,
+ alias: str | None = None,
+ alias_priority: int | None = _Unset,
+ # MAINTENANCE: update when deprecating Pydantic v1, import these types
+ # str | AliasPath | AliasChoices | None
+ validation_alias: str | None = _Unset,
+ serialization_alias: str | None = None,
+ convert_underscores: bool = True,
+ title: str | None = None,
+ description: str | None = None,
+ gt: float | None = None,
+ ge: float | None = None,
+ lt: float | None = None,
+ le: float | None = None,
+ min_length: int | None = None,
+ max_length: int | None = None,
+ pattern: str | None = None,
+ discriminator: str | None = None,
+ strict: bool | None = _Unset,
+ multiple_of: float | None = _Unset,
+ allow_inf_nan: bool | None = _Unset,
+ max_digits: int | None = _Unset,
+ decimal_places: int | None = _Unset,
+ examples: list[Any] | None = None,
+ openapi_examples: dict[str, Example] | None = None,
+ deprecated: bool | None = None,
+ include_in_schema: bool = True,
+ json_schema_extra: dict[str, Any] | None = None,
+ **extra: Any,
+ ):
+ self.convert_underscores = convert_underscores
+ self._alias = alias
+
+ super().__init__(
+ default=default,
+ default_factory=default_factory,
+ annotation=annotation,
+ alias=self._alias,
+ alias_priority=alias_priority,
+ validation_alias=validation_alias,
+ serialization_alias=serialization_alias,
+ title=title,
+ description=description,
+ gt=gt,
+ ge=ge,
+ lt=lt,
+ le=le,
+ min_length=min_length,
+ max_length=max_length,
+ pattern=pattern,
+ discriminator=discriminator,
+ strict=strict,
+ multiple_of=multiple_of,
+ allow_inf_nan=allow_inf_nan,
+ max_digits=max_digits,
+ decimal_places=decimal_places,
+ deprecated=deprecated,
+ examples=examples,
+ openapi_examples=openapi_examples,
+ include_in_schema=include_in_schema,
+ json_schema_extra=json_schema_extra,
+ **extra,
+ )
+
+ @property
+ def alias(self):
+ return self._alias
+
+ @alias.setter
+ def alias(self, value: str | None = None):
+ if value is not None:
+ # Headers are case-insensitive according to RFC 7540 (HTTP/2), so we lower the parameter name
+ # This ensures that customers can access headers with any casing, as per the RFC guidelines.
+ # Reference: https://www.rfc-editor.org/rfc/rfc7540#section-8.1.2
+ self._alias = value.lower()
+
+
+class Cookie(Param): # type: ignore[misc]
+ """
+ A class used internally to represent a cookie parameter in a path operation.
+ """
+
+ in_ = ParamTypes.cookie
+
+
+class Body(FieldInfo): # type: ignore[misc]
+ """
+ A class used internally to represent a body parameter in a path operation.
+ """
+
+ def __init__(
+ self,
+ default: Any = Undefined,
+ *,
+ default_factory: Callable[[], Any] | None = _Unset,
+ annotation: Any | None = None,
+ embed: bool = False,
+ media_type: str = "application/json",
+ alias: str | None = None,
+ alias_priority: int | None = _Unset,
+ # MAINTENANCE: update when deprecating Pydantic v1, import these types
+ # str | AliasPath | AliasChoices | None
+ validation_alias: str | None = _Unset,
+ serialization_alias: str | None = None,
+ title: str | None = None,
+ description: str | None = None,
+ gt: float | None = None,
+ ge: float | None = None,
+ lt: float | None = None,
+ le: float | None = None,
+ min_length: int | None = None,
+ max_length: int | None = None,
+ pattern: str | None = None,
+ discriminator: str | None = None,
+ strict: bool | None = _Unset,
+ multiple_of: float | None = _Unset,
+ allow_inf_nan: bool | None = _Unset,
+ max_digits: int | None = _Unset,
+ decimal_places: int | None = _Unset,
+ examples: list[Any] | None = None,
+ openapi_examples: dict[str, Example] | None = None,
+ deprecated: bool | None = None,
+ include_in_schema: bool = True,
+ json_schema_extra: dict[str, Any] | None = None,
+ **extra: Any,
+ ):
+ self.embed = embed
+ self.media_type = media_type
+ self.deprecated = deprecated
+ self.include_in_schema = include_in_schema
+ kwargs = dict(
+ default=default,
+ default_factory=default_factory,
+ alias=alias,
+ title=title,
+ description=description,
+ gt=gt,
+ ge=ge,
+ lt=lt,
+ le=le,
+ min_length=min_length,
+ max_length=max_length,
+ discriminator=discriminator,
+ multiple_of=multiple_of,
+ allow_nan=allow_inf_nan,
+ max_digits=max_digits,
+ decimal_places=decimal_places,
+ **extra,
+ )
+ if examples is not None:
+ kwargs["examples"] = examples
+ if openapi_examples is not None:
+ kwargs["openapi_examples"] = openapi_examples
+ current_json_schema_extra = json_schema_extra or extra
+
+ # Pydantic 2.12+ no longer copies alias to validation_alias automatically
+ # Ensure alias and validation_alias are in sync when only one is provided
+ if validation_alias is _Unset and alias is not None:
+ validation_alias = alias
+ elif alias is None and validation_alias is not _Unset and validation_alias is not None:
+ alias = validation_alias
+ kwargs["alias"] = alias
+ self.openapi_examples = openapi_examples
+
+ kwargs.update(
+ {
+ "annotation": annotation,
+ "alias_priority": alias_priority,
+ "validation_alias": validation_alias,
+ "serialization_alias": serialization_alias,
+ "strict": strict,
+ "json_schema_extra": current_json_schema_extra,
+ "pattern": pattern,
+ },
+ )
+
+ use_kwargs = {k: v for k, v in kwargs.items() if v is not _Unset}
+
+ super().__init__(**use_kwargs)
+
+ def __repr__(self) -> str:
+ return f"{self.__class__.__name__}({self.default})"
+
+
+class Form(Body): # type: ignore[misc]
+ """
+ A class used to represent a form parameter in a path operation.
+ """
+
+ def __init__(
+ self,
+ default: Any = Undefined,
+ *,
+ default_factory: Callable[[], Any] | None = _Unset,
+ annotation: Any | None = None,
+ media_type: str = "application/x-www-form-urlencoded",
+ alias: str | None = None,
+ alias_priority: int | None = _Unset,
+ # MAINTENANCE: update when deprecating Pydantic v1, import these types
+ # str | AliasPath | AliasChoices | None
+ validation_alias: str | None = _Unset,
+ serialization_alias: str | None = None,
+ title: str | None = None,
+ description: str | None = None,
+ gt: float | None = None,
+ ge: float | None = None,
+ lt: float | None = None,
+ le: float | None = None,
+ min_length: int | None = None,
+ max_length: int | None = None,
+ pattern: str | None = None,
+ discriminator: str | None = None,
+ strict: bool | None = _Unset,
+ multiple_of: float | None = _Unset,
+ allow_inf_nan: bool | None = _Unset,
+ max_digits: int | None = _Unset,
+ decimal_places: int | None = _Unset,
+ examples: list[Any] | None = None,
+ deprecated: bool | None = None,
+ include_in_schema: bool = True,
+ json_schema_extra: dict[str, Any] | None = None,
+ **extra: Any,
+ ):
+ super().__init__(
+ default=default,
+ default_factory=default_factory,
+ annotation=annotation,
+ embed=True,
+ media_type=media_type,
+ alias=alias,
+ alias_priority=alias_priority,
+ validation_alias=validation_alias,
+ serialization_alias=serialization_alias,
+ title=title,
+ description=description,
+ gt=gt,
+ ge=ge,
+ lt=lt,
+ le=le,
+ min_length=min_length,
+ max_length=max_length,
+ pattern=pattern,
+ discriminator=discriminator,
+ strict=strict,
+ multiple_of=multiple_of,
+ allow_inf_nan=allow_inf_nan,
+ max_digits=max_digits,
+ decimal_places=decimal_places,
+ deprecated=deprecated,
+ examples=examples,
+ include_in_schema=include_in_schema,
+ json_schema_extra=json_schema_extra,
+ **extra,
+ )
+
+
+class UploadFile:
+ """
+ Represents an uploaded file with its metadata.
+
+ Use with ``Annotated[UploadFile, File()]`` to receive file content along with
+ filename and content type. For raw bytes only, use ``Annotated[bytes, File()]``.
+
+ Attributes
+ ----------
+ filename : str | None
+ The original filename from the upload.
+ content_type : str | None
+ The MIME type declared by the client (e.g. ``image/jpeg``).
+ content : bytes
+ The raw file content.
+ """
+
+ __slots__ = ("content", "content_type", "filename")
+
+ def __init__(self, *, content: bytes, filename: str | None = None, content_type: str | None = None):
+ self.content = content
+ self.filename = filename
+ self.content_type = content_type
+
+ def __len__(self) -> int:
+ return len(self.content)
+
+ def __repr__(self) -> str:
+ return f"UploadFile(filename={self.filename!r}, content_type={self.content_type!r}, size={len(self.content)})"
+
+ @classmethod
+ def __get_pydantic_core_schema__(cls, _source_type: Any, _handler: Any) -> Any:
+ from pydantic_core import core_schema
+
+ return core_schema.no_info_plain_validator_function(
+ cls._validate,
+ serialization=core_schema.plain_serializer_function_ser_schema(lambda v: v, info_arg=False),
+ )
+
+ @classmethod
+ def _validate(cls, v: Any) -> UploadFile:
+ if isinstance(v, cls):
+ return v
+ raise ValueError(f"Expected UploadFile, got {type(v).__name__}")
+
+ @classmethod
+ def __get_pydantic_json_schema__(cls, _schema: Any, handler: Any) -> dict[str, Any]:
+ return {"type": "string", "format": "binary"}
+
+
+class File(Form): # type: ignore[misc]
+ """
+ A class used to represent a file parameter in a path operation.
+ """
+
+ def __init__(
+ self,
+ default: Any = Undefined,
+ *,
+ default_factory: Callable[[], Any] | None = _Unset,
+ annotation: Any | None = None,
+ media_type: str = "multipart/form-data",
+ alias: str | None = None,
+ alias_priority: int | None = _Unset,
+ # MAINTENANCE: update when deprecating Pydantic v1, import these types
+ # str | AliasPath | AliasChoices | None
+ validation_alias: str | None = None,
+ serialization_alias: str | None = None,
+ title: str | None = None,
+ description: str | None = None,
+ gt: float | None = None,
+ ge: float | None = None,
+ lt: float | None = None,
+ le: float | None = None,
+ min_length: int | None = None,
+ max_length: int | None = None,
+ pattern: str | None = None,
+ discriminator: str | None = None,
+ strict: bool | None = _Unset,
+ multiple_of: float | None = _Unset,
+ allow_inf_nan: bool | None = _Unset,
+ max_digits: int | None = _Unset,
+ decimal_places: int | None = _Unset,
+ examples: list[Any] | None = None,
+ deprecated: bool | None = None,
+ include_in_schema: bool = True,
+ json_schema_extra: dict[str, Any] | None = None,
+ **extra: Any,
+ ):
+ # For file uploads, ensure the OpenAPI schema has the correct format
+ # Also we can't test it
+ file_schema_extra = {"format": "binary"} # pragma: no cover
+ if json_schema_extra: # pragma: no cover
+ json_schema_extra.update(file_schema_extra) # pragma: no cover
+ else: # pragma: no cover
+ json_schema_extra = file_schema_extra # pragma: no cover
+
+ super().__init__(
+ default=default,
+ default_factory=default_factory,
+ annotation=annotation,
+ media_type=media_type,
+ alias=alias,
+ alias_priority=alias_priority,
+ validation_alias=validation_alias,
+ serialization_alias=serialization_alias,
+ title=title,
+ description=description,
+ gt=gt,
+ ge=ge,
+ lt=lt,
+ le=le,
+ min_length=min_length,
+ max_length=max_length,
+ pattern=pattern,
+ discriminator=discriminator,
+ strict=strict,
+ multiple_of=multiple_of,
+ allow_inf_nan=allow_inf_nan,
+ max_digits=max_digits,
+ decimal_places=decimal_places,
+ deprecated=deprecated,
+ examples=examples,
+ include_in_schema=include_in_schema,
+ json_schema_extra=json_schema_extra,
+ **extra,
+ )
+
+
+def get_flat_dependant(
+ dependant: Dependant,
+ visited: list[CacheKey] | None = None,
+) -> Dependant:
+ """
+ Flatten a recursive Dependant model structure.
+
+ This function recursively concatenates the parameter fields of a Dependant model and its dependencies into a flat
+ Dependant structure. This is useful for scenarios like parameter validation where the nested structure is not
+ relevant.
+
+ Parameters
+ ----------
+ dependant: Dependant
+ The dependant model to flatten
+ visited: list[CacheKey], optional
+ Keeps track of visited Dependents to avoid infinite recursion. Defaults to empty list.
+
+ Returns
+ -------
+ Dependant
+ The flattened Dependant model
+ """
+ if visited is None:
+ visited = []
+ visited.append(dependant.cache_key)
+
+ flat = Dependant(
+ path_params=dependant.path_params.copy(),
+ query_params=dependant.query_params.copy(),
+ header_params=dependant.header_params.copy(),
+ cookie_params=dependant.cookie_params.copy(),
+ body_params=dependant.body_params.copy(),
+ path=dependant.path,
+ )
+
+ # Flatten sub-dependencies that declare HTTP params (query, header, etc.)
+ for dep in dependant.dependencies:
+ if dep.dependant.cache_key not in visited:
+ sub_flat = get_flat_dependant(dep.dependant, visited=visited)
+ flat.path_params.extend(sub_flat.path_params)
+ flat.query_params.extend(sub_flat.query_params)
+ flat.header_params.extend(sub_flat.header_params)
+ flat.cookie_params.extend(sub_flat.cookie_params)
+ flat.body_params.extend(sub_flat.body_params)
+
+ return flat
+
+
+def analyze_param(
+ *,
+ param_name: str,
+ annotation: Any,
+ value: Any,
+ is_path_param: bool,
+ is_response_param: bool,
+) -> ModelField | None:
+ """
+ Analyze a parameter annotation and value to determine the type and default value of the parameter.
+
+ Parameters
+ ----------
+ param_name: str
+ The name of the parameter
+ annotation
+ The annotation of the parameter
+ value
+ The value of the parameter
+ is_path_param
+ Whether the parameter is a path parameter
+ is_response_param
+ Whether the parameter is the return annotation
+
+ Returns
+ -------
+ ModelField | None
+ The type annotation and the Pydantic field representing the parameter
+ """
+ field_info, type_annotation = get_field_info_and_type_annotation(
+ annotation,
+ value,
+ is_path_param,
+ is_response_param,
+ )
+
+ # If the value is a FieldInfo, we use it as the FieldInfo for the parameter
+ if isinstance(value, FieldInfo):
+ if field_info is not None:
+ raise AssertionError("Cannot use a FieldInfo as a parameter annotation and pass a FieldInfo as a value")
+ field_info = value
+
+ field_info.annotation = type_annotation # type: ignore[attr-defined,unused-ignore]
+
+ # If we didn't determine the FieldInfo yet, we create a default one
+ if field_info is None:
+ default_value = value if value is not inspect.Signature.empty else Required
+
+ # Check if the parameter is part of the path. Otherwise, defaults to query.
+ if is_path_param:
+ field_info = Path(annotation=type_annotation)
+ elif not field_annotation_is_scalar(annotation=type_annotation):
+ field_info = Body(annotation=type_annotation, default=default_value)
+ else:
+ field_info = Query(annotation=type_annotation, default=default_value)
+
+ # When we have a response field, we need to set the default value to Required
+ if is_response_param:
+ field_info.default = Required
+
+ field = _create_model_field(field_info, type_annotation, param_name, is_path_param, is_response_param)
+ return field
+
+
+def get_field_info_and_type_annotation(
+ annotation,
+ value,
+ is_path_param: bool,
+ is_response_param: bool,
+) -> tuple[FieldInfo | None, Any]:
+ """
+ Get the FieldInfo and type annotation from an annotation and value.
+ """
+ field_info: FieldInfo | None = None
+ type_annotation: Any = Any
+
+ if annotation is not inspect.Signature.empty:
+ # If the annotation is an Annotated type, we need to extract the type annotation and the FieldInfo
+ if get_origin(annotation) is Annotated:
+ field_info, type_annotation = get_field_info_annotated_type(annotation, value, is_path_param)
+ # If the annotation is a Response type, we recursively call this function with the inner type
+ elif get_origin(annotation) is Response:
+ field_info, type_annotation = get_field_info_response_type(annotation, value)
+ # If the response param is a tuple with two elements, we use the first element as the type annotation,
+ # just like we did in the APIGateway._to_response
+ elif is_response_param and get_origin(annotation) is tuple and len(get_args(annotation)) == 2:
+ field_info, type_annotation = get_field_info_tuple_type(annotation, value)
+ # If the annotation is not an Annotated type, we use it as the type annotation
+ else:
+ type_annotation = annotation
+
+ return field_info, type_annotation
+
+
+def get_field_info_tuple_type(annotation, value) -> tuple[FieldInfo | None, Any]:
+ (inner_type, _) = get_args(annotation)
+
+ # If the inner type is an Annotated type, we need to extract the type annotation and the FieldInfo
+ if get_origin(inner_type) is Annotated:
+ return get_field_info_annotated_type(inner_type, value, False)
+
+ return None, inner_type
+
+
+def get_field_info_response_type(annotation, value) -> tuple[FieldInfo | None, Any]:
+ # Example: get_args(Response[inner_type]) == (inner_type,) # noqa: ERA001
+ (inner_type,) = get_args(annotation)
+
+ # Recursively resolve the inner type
+ return get_field_info_and_type_annotation(inner_type, value, False, True)
+
+
+def _has_discriminator(field_info: FieldInfo) -> bool:
+ """Check if a FieldInfo has a discriminator."""
+ return hasattr(field_info, "discriminator") and field_info.discriminator is not None
+
+
+def _handle_discriminator_with_param(
+ annotations: list[FieldInfo],
+ annotation: Any,
+) -> tuple[FieldInfo | None, Any, bool]:
+ """
+ Handle the special case of Field(discriminator) + Body() combination.
+
+ Returns:
+ tuple of (powertools_annotation, type_annotation, has_discriminator_with_body)
+ """
+ field_obj = None
+ body_obj = None
+
+ for ann in annotations:
+ if isinstance(ann, Body):
+ body_obj = ann
+ elif _has_discriminator(ann):
+ field_obj = ann
+
+ if field_obj and body_obj:
+ # Use Body as the primary annotation, preserve full annotation for validation
+ return body_obj, annotation, True
+
+ raise AssertionError("Only one FieldInfo can be used per parameter")
+
+
+def _create_field_info(
+ powertools_annotation: FieldInfo,
+ type_annotation: Any,
+ has_discriminator_with_body: bool,
+) -> FieldInfo:
+ """Create or copy FieldInfo based on the annotation type."""
+ field_info: FieldInfo
+ if has_discriminator_with_body:
+ # For discriminator + Body case, create a new Body instance directly
+ field_info = Body()
+ field_info.annotation = type_annotation
+ else:
+ # Copy field_info because we mutate field_info.default later
+ field_info = copy_field_info(
+ field_info=powertools_annotation,
+ annotation=type_annotation,
+ )
+ return field_info
+
+
+def _set_field_default(field_info: FieldInfo, value: Any, is_path_param: bool) -> None:
+ """Set the default value for a field."""
+ if field_info.default not in [Undefined, Required]:
+ raise AssertionError("FieldInfo needs to have a default value of Undefined or Required")
+
+ if value is not inspect.Signature.empty:
+ if is_path_param:
+ raise AssertionError("Cannot use a FieldInfo as a path parameter and pass a value")
+ field_info.default = value
+ else:
+ field_info.default = Required
+
+
+def get_field_info_annotated_type(annotation, value, is_path_param: bool) -> tuple[FieldInfo | None, Any]:
+ """
+ Get the FieldInfo and type annotation from an Annotated type.
+ """
+ annotated_args = get_args(annotation)
+ type_annotation = annotated_args[0]
+
+ # Handle both FieldInfo instances and FieldInfo subclasses (e.g., Body vs Body())
+ powertools_annotations: list[FieldInfo] = []
+ for arg in annotated_args[1:]:
+ if isinstance(arg, FieldInfo):
+ powertools_annotations.append(arg)
+ elif isinstance(arg, type) and issubclass(arg, FieldInfo):
+ # If it's a class (e.g., Body instead of Body()), instantiate it
+ powertools_annotations.append(arg())
+
+ # Preserve non-FieldInfo metadata (like annotated_types constraints)
+ # This is important for constraints like Interval, Gt, Lt, etc.
+ other_metadata = [
+ arg
+ for arg in annotated_args[1:]
+ if not isinstance(arg, FieldInfo) and not (isinstance(arg, type) and issubclass(arg, FieldInfo))
+ ]
+
+ # Determine which annotation to use
+ powertools_annotation: FieldInfo | None = None
+ has_discriminator_with_param = False
+
+ if len(powertools_annotations) == 2:
+ powertools_annotation, type_annotation, has_discriminator_with_param = _handle_discriminator_with_param(
+ powertools_annotations,
+ annotation,
+ )
+ elif len(powertools_annotations) > 1:
+ raise AssertionError("Only one FieldInfo can be used per parameter")
+ else:
+ powertools_annotation = next(iter(powertools_annotations), None)
+
+ # Reconstruct type_annotation with non-FieldInfo metadata if present
+ # This ensures constraints like Interval are preserved
+ if other_metadata and not has_discriminator_with_param:
+ type_annotation = Annotated[(type_annotation, *other_metadata)]
+
+ # Process the annotation if it exists
+ field_info: FieldInfo | None = None
+ if isinstance(powertools_annotation, FieldInfo): # pragma: no cover
+ field_info = _create_field_info(powertools_annotation, type_annotation, has_discriminator_with_param)
+ _set_field_default(field_info, value, is_path_param)
+
+ # Preserve full annotated type for discriminated unions
+ if _has_discriminator(powertools_annotation): # pragma: no cover
+ type_annotation = annotation # pragma: no cover
+
+ return field_info, type_annotation
+
+
+def create_response_field(
+ name: str,
+ type_: type[Any],
+ default: Any | None = Undefined,
+ required: bool | UndefinedType = Undefined,
+ model_config: type[BaseConfig] = BaseConfig,
+ field_info: FieldInfo | None = None,
+ alias: str | None = None,
+ mode: Literal["validation", "serialization"] = "validation",
+) -> ModelField:
+ """
+ Create a new response field. Raises if type_ is invalid.
+ """
+ field_info = field_info or FieldInfo(
+ annotation=type_,
+ default=default,
+ alias=alias,
+ )
+
+ kwargs = {"name": name, "field_info": field_info, "mode": mode}
+
+ return ModelField(**kwargs) # type: ignore[arg-type]
+
+
+def _apply_header_underscore_conversion(
+ field_info: FieldInfo,
+ type_annotation: Any,
+ param_name: str,
+) -> tuple[FieldInfo, Any]:
+ """
+ Apply underscore-to-dash conversion for Header parameters.
+
+ For BaseModel: Creates new model with underscore-to-dash alias generator.
+ Note: If the BaseModel already has an alias generator, it will be replaced
+ with dash-case conversion since HTTP headers should use dash-case.
+ For all Header fields: Sets the parameter alias if convert_underscores is True
+ """
+ if not isinstance(field_info, Header) or not field_info.convert_underscores:
+ return field_info, type_annotation
+
+ # Always set the parameter alias for Header fields (if not already set)
+ if not field_info.alias:
+ field_info.alias = param_name.replace("_", "-")
+
+ # Handle BaseModel case - create new model with dash-case alias generator
+ if lenient_issubclass(type_annotation, BaseModel):
+ # For HTTP headers, we should use dash-case regardless of existing alias generator
+ # This ensures consistent header naming conventions
+ header_aliased_model = create_model(
+ f"{type_annotation.__name__}WithHeaderAliases",
+ __base__=type_annotation,
+ __config__={"alias_generator": lambda name: name.replace("_", "-")},
+ )
+
+ type_annotation = header_aliased_model
+ field_info.annotation = type_annotation
+
+ return field_info, type_annotation
+
+
+def _create_model_field(
+ field_info: FieldInfo | None,
+ type_annotation: Any,
+ param_name: str,
+ is_path_param: bool,
+ is_response_param: bool = False,
+) -> ModelField | None:
+ """
+ Create a new ModelField from a FieldInfo and type annotation.
+ """
+ if field_info is None:
+ return None
+
+ if is_path_param:
+ if not isinstance(field_info, Path):
+ raise AssertionError("Path parameters must be of type Path")
+ elif isinstance(field_info, Param) and getattr(field_info, "in_", None) is None:
+ field_info.in_ = ParamTypes.query
+
+ # Apply header underscore conversion
+ field_info, type_annotation = _apply_header_underscore_conversion(field_info, type_annotation, param_name)
+
+ # If the field_info is a Param, we use the `in_` attribute to determine the type annotation
+ use_annotation = get_annotation_from_field_info(type_annotation, field_info, param_name)
+
+ return create_response_field(
+ name=param_name,
+ type_=use_annotation,
+ default=field_info.default,
+ alias=field_info.alias,
+ required=field_info.default in (Required, Undefined),
+ field_info=field_info,
+ mode="serialization" if is_response_param else "validation",
+ )
diff --git a/aws_lambda_powertools/event_handler/openapi/pydantic_loader.py b/aws_lambda_powertools/event_handler/openapi/pydantic_loader.py
new file mode 100644
index 00000000000..225f7e88096
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/openapi/pydantic_loader.py
@@ -0,0 +1,6 @@
+try:
+ from pydantic.version import VERSION as PYDANTIC_VERSION
+
+ PYDANTIC_V2 = PYDANTIC_VERSION.startswith("2.")
+except ImportError:
+ PYDANTIC_V2 = False # pragma: no cover # false positive; dropping in v3
diff --git a/aws_lambda_powertools/event_handler/openapi/schema_generator.py b/aws_lambda_powertools/event_handler/openapi/schema_generator.py
new file mode 100644
index 00000000000..6334a3b53cc
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/openapi/schema_generator.py
@@ -0,0 +1,553 @@
+"""
+OpenAPI schema generation for individual routes.
+
+Extracted from Route to keep route configuration and schema generation
+as separate concerns. All functions here are internal.
+"""
+
+from __future__ import annotations
+
+import copy
+import warnings
+from typing import TYPE_CHECKING, Any, Literal, cast
+
+from aws_lambda_powertools.event_handler.openapi.types import (
+ COMPONENT_REF_PREFIX,
+ METHODS_WITH_BODY,
+ OpenAPIResponse,
+ OpenAPIResponseContentModel,
+ OpenAPIResponseContentSchema,
+ response_validation_error_response_definition,
+ validation_error_definition,
+ validation_error_response_definition,
+)
+
+if TYPE_CHECKING:
+ from collections.abc import Sequence
+ from http import HTTPStatus
+
+ from aws_lambda_powertools.event_handler.openapi.compat import (
+ JsonSchemaValue,
+ ModelField,
+ )
+ from aws_lambda_powertools.event_handler.openapi.params import Dependant, Param
+ from aws_lambda_powertools.event_handler.openapi.types import TypeModelOrEnum
+
+from aws_lambda_powertools.event_handler.openapi.constants import (
+ DEFAULT_CONTENT_TYPE,
+ DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ DEFAULT_STATUS_CODE,
+)
+
+
+def generate_openapi_path(
+ *,
+ method: str,
+ operation_id: str,
+ summary: str | None,
+ description: str | None,
+ openapi_path: str,
+ tags: list[str],
+ deprecated: bool,
+ security: list[dict[str, list[str]]] | None,
+ openapi_extensions: dict[str, Any] | None,
+ responses: dict[int, OpenAPIResponse] | None,
+ response_description: str | None,
+ body_field: ModelField | None,
+ custom_response_validation_http_code: HTTPStatus | None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ dependant: Dependant,
+ operation_ids: set[str],
+ model_name_map: dict[TypeModelOrEnum, str],
+ field_mapping: dict[tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue],
+ enable_validation: bool = False,
+) -> tuple[dict[str, Any], dict[str, Any]]:
+ """
+ Generate the OpenAPI path spec and definitions for a single route.
+ """
+ from aws_lambda_powertools.event_handler.openapi.dependant import get_flat_params
+
+ definitions: dict[str, Any] = {}
+
+ # Build operation metadata
+ operation = _build_operation_metadata(
+ method=method,
+ operation_id=operation_id,
+ summary=summary,
+ description=description,
+ openapi_path=openapi_path,
+ tags=tags,
+ deprecated=deprecated,
+ operation_ids=operation_ids,
+ func_name=dependant.call.__name__ if dependant.call else "",
+ func_file=getattr(dependant.call, "__globals__", {}).get("__file__") if dependant.call else None,
+ )
+
+ _apply_optional_fields(operation, security=security, openapi_extensions=openapi_extensions)
+
+ # Build parameters
+ all_route_params = get_flat_params(dependant)
+ parameters = _build_operation_parameters(
+ all_route_params=all_route_params,
+ model_name_map=model_name_map,
+ field_mapping=field_mapping,
+ )
+
+ if parameters:
+ operation["parameters"] = _deduplicate_parameters(parameters)
+
+ # Build request body
+ _apply_request_body(
+ operation,
+ method=method,
+ body_field=body_field,
+ model_name_map=model_name_map,
+ field_mapping=field_mapping,
+ )
+
+ # Build responses
+ operation_responses, response_definitions = _build_responses(
+ responses=responses,
+ response_description=response_description,
+ custom_response_validation_http_code=custom_response_validation_http_code,
+ status_code=status_code,
+ dependant=dependant,
+ model_name_map=model_name_map,
+ field_mapping=field_mapping,
+ enable_validation=enable_validation,
+ )
+ definitions.update(response_definitions)
+
+ operation["responses"] = operation_responses
+ path = {method.lower(): operation}
+
+ _add_validation_error_definitions(definitions)
+
+ return path, definitions
+
+
+def _build_operation_metadata(
+ *,
+ method: str,
+ operation_id: str,
+ summary: str | None,
+ description: str | None,
+ openapi_path: str,
+ tags: list[str],
+ deprecated: bool,
+ operation_ids: set[str],
+ func_name: str,
+ func_file: str | None,
+) -> dict[str, Any]:
+ """Build the OpenAPI operation metadata (tags, summary, operationId, etc.)."""
+ _warn_duplicate_operation_id(operation_id, operation_ids, func_name, func_file)
+ operation_ids.add(operation_id)
+
+ operation: dict[str, Any] = {
+ "summary": summary or f"{method.upper()} {openapi_path}",
+ "operationId": operation_id,
+ "deprecated": deprecated or None,
+ }
+
+ if tags:
+ operation["tags"] = tags
+ if description:
+ operation["description"] = description
+
+ return operation
+
+
+def _build_operation_parameters(
+ *,
+ all_route_params: Sequence[ModelField],
+ model_name_map: dict[TypeModelOrEnum, str],
+ field_mapping: dict[tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue],
+) -> list[dict[str, Any]]:
+ """Build the list of OpenAPI operation parameters."""
+ from aws_lambda_powertools.event_handler.openapi.params import Param
+
+ parameters: list[dict[str, Any]] = []
+
+ for param in all_route_params:
+ field_info = cast(Param, param.field_info)
+ if not field_info.include_in_schema:
+ continue
+
+ if _is_pydantic_model_param(field_info):
+ parameters.extend(_expand_pydantic_model_parameters(field_info))
+ else:
+ parameters.append(_create_regular_parameter(param, model_name_map, field_mapping))
+
+ return parameters
+
+
+def _build_request_body(
+ *,
+ body_field: ModelField | None,
+ model_name_map: dict[TypeModelOrEnum, str],
+ field_mapping: dict[tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue],
+) -> dict[str, Any] | None:
+ """Build the OpenAPI request body spec."""
+ from aws_lambda_powertools.event_handler.openapi.compat import ModelField as ModelFieldClass
+ from aws_lambda_powertools.event_handler.openapi.compat import get_schema_from_model_field
+ from aws_lambda_powertools.event_handler.openapi.params import Body
+
+ if not body_field:
+ return None
+
+ if not isinstance(body_field, ModelFieldClass):
+ raise AssertionError(f"Expected ModelField, got {body_field}")
+
+ body_schema = get_schema_from_model_field(
+ field=body_field,
+ model_name_map=model_name_map,
+ field_mapping=field_mapping,
+ )
+
+ field_info = cast(Body, body_field.field_info)
+
+ request_body_oai: dict[str, Any] = {}
+ if body_field.required:
+ request_body_oai["required"] = body_field.required
+ if field_info.description:
+ request_body_oai["description"] = field_info.description
+
+ request_body_oai["content"] = {
+ field_info.media_type: _build_media_content(body_schema, field_info.openapi_examples),
+ }
+ return request_body_oai
+
+
+def _build_responses(
+ *,
+ responses: dict[int, OpenAPIResponse] | None,
+ response_description: str | None,
+ custom_response_validation_http_code: HTTPStatus | None,
+ status_code: int = DEFAULT_STATUS_CODE,
+ dependant: Dependant,
+ model_name_map: dict[TypeModelOrEnum, str],
+ field_mapping: dict[tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue],
+ enable_validation: bool,
+) -> tuple[dict[int, OpenAPIResponse], dict[str, Any]]:
+ """Build the OpenAPI response specs and any extra definitions."""
+ definitions: dict[str, Any] = {}
+ operation_responses: dict[int, OpenAPIResponse] = {}
+
+ _add_validation_responses(operation_responses, enable_validation=enable_validation)
+ _add_response_validation_error(
+ operation_responses,
+ definitions,
+ custom_response_validation_http_code=custom_response_validation_http_code,
+ )
+
+ if responses:
+ for resp_code in list(responses):
+ operation_responses[resp_code] = _build_custom_response(
+ response=copy.deepcopy(responses[resp_code]),
+ dependant=dependant,
+ model_name_map=model_name_map,
+ field_mapping=field_mapping,
+ )
+ else:
+ response_schema = _build_return_schema(
+ param=dependant.return_param,
+ model_name_map=model_name_map,
+ field_mapping=field_mapping,
+ )
+
+ operation_responses[status_code] = {
+ "description": response_description or DEFAULT_OPENAPI_RESPONSE_DESCRIPTION,
+ "content": {DEFAULT_CONTENT_TYPE: response_schema},
+ }
+
+ return operation_responses, definitions
+
+
+def _build_return_schema(
+ *,
+ param: ModelField | None,
+ model_name_map: dict[TypeModelOrEnum, str],
+ field_mapping: dict[tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue],
+) -> OpenAPIResponseContentSchema:
+ """Build the response schema for a return parameter."""
+ if param is None:
+ return {}
+
+ from aws_lambda_powertools.event_handler.openapi.compat import get_schema_from_model_field
+
+ return_schema = get_schema_from_model_field(
+ field=param,
+ model_name_map=model_name_map,
+ field_mapping=field_mapping,
+ )
+
+ return {"schema": return_schema}
+
+
+def _is_pydantic_model_param(field_info: Param) -> bool:
+ """Check if the field info represents a Pydantic model parameter."""
+ from pydantic import BaseModel
+
+ from aws_lambda_powertools.event_handler.openapi.compat import lenient_issubclass
+
+ return lenient_issubclass(field_info.annotation, BaseModel)
+
+
+def _expand_pydantic_model_parameters(field_info: Param) -> list[dict[str, Any]]:
+ """Expand a Pydantic model into individual OpenAPI parameters."""
+ from pydantic import BaseModel
+
+ model_class = cast(type[BaseModel], field_info.annotation)
+ parameters: list[dict[str, Any]] = []
+
+ for field_name, field_def in model_class.model_fields.items():
+ param_name = field_def.alias or field_name
+ individual_param = _create_pydantic_field_parameter(
+ param_name=param_name,
+ field_def=field_def,
+ param_location=field_info.in_.value,
+ )
+ parameters.append(individual_param)
+
+ return parameters
+
+
+def _create_pydantic_field_parameter(
+ param_name: str,
+ field_def: Any,
+ param_location: str,
+) -> dict[str, Any]:
+ """Create an OpenAPI parameter from a Pydantic field definition."""
+ individual_param: dict[str, Any] = {
+ "name": param_name,
+ "in": param_location,
+ "required": field_def.is_required() if hasattr(field_def, "is_required") else field_def.default is ...,
+ "schema": _get_basic_type_schema(field_def.annotation or type(None)),
+ }
+
+ if field_def.description:
+ individual_param["description"] = field_def.description
+
+ return individual_param
+
+
+def _create_regular_parameter(
+ param: ModelField,
+ model_name_map: dict[TypeModelOrEnum, str],
+ field_mapping: dict[tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue],
+) -> dict[str, Any]:
+ """Create an OpenAPI parameter from a regular ModelField."""
+ from aws_lambda_powertools.event_handler.openapi.compat import get_schema_from_model_field
+ from aws_lambda_powertools.event_handler.openapi.params import Param
+
+ field_info = cast(Param, param.field_info)
+ param_schema = get_schema_from_model_field(
+ field=param,
+ model_name_map=model_name_map,
+ field_mapping=field_mapping,
+ )
+
+ parameter: dict[str, Any] = {
+ "name": param.alias,
+ "in": field_info.in_.value,
+ "required": param.required,
+ "schema": param_schema,
+ }
+
+ if field_info.description:
+ parameter["description"] = field_info.description
+ if field_info.openapi_examples:
+ parameter["examples"] = field_info.openapi_examples
+ if field_info.deprecated:
+ parameter["deprecated"] = field_info.deprecated
+
+ return parameter
+
+
+def _get_basic_type_schema(param_type: type) -> dict[str, str]:
+ """Get basic OpenAPI schema for simple types."""
+ type_map: dict[type, str] = {bool: "boolean", int: "integer", float: "number"}
+ try:
+ for base_type, schema_type in type_map.items():
+ if issubclass(param_type, base_type):
+ return {"type": schema_type}
+ return {"type": "string"}
+ except TypeError:
+ return {"type": "string"}
+
+
+def _apply_optional_fields(
+ operation: dict[str, Any],
+ *,
+ security: list[dict[str, list[str]]] | None,
+ openapi_extensions: dict[str, Any] | None,
+) -> None:
+ """Apply optional security and extension fields to the operation."""
+ if security:
+ operation["security"] = security
+ if openapi_extensions:
+ operation.update(openapi_extensions)
+
+
+def _apply_request_body(
+ operation: dict[str, Any],
+ *,
+ method: str,
+ body_field: ModelField | None,
+ model_name_map: dict[TypeModelOrEnum, str],
+ field_mapping: dict[tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue],
+) -> None:
+ """Build and apply request body to operation if applicable."""
+ if method.upper() not in METHODS_WITH_BODY:
+ return
+
+ request_body_oai = _build_request_body(
+ body_field=body_field,
+ model_name_map=model_name_map,
+ field_mapping=field_mapping,
+ )
+ if request_body_oai:
+ operation["requestBody"] = request_body_oai
+
+
+def _add_validation_responses(
+ operation_responses: dict[int, OpenAPIResponse],
+ *,
+ enable_validation: bool,
+) -> None:
+ """Add 422 validation error response if validation is enabled."""
+ if not enable_validation:
+ return
+
+ operation_responses[422] = {
+ "description": "Validation Error",
+ "content": {
+ DEFAULT_CONTENT_TYPE: {"schema": {"$ref": f"{COMPONENT_REF_PREFIX}HTTPValidationError"}},
+ },
+ }
+
+
+def _add_response_validation_error(
+ operation_responses: dict[int, OpenAPIResponse],
+ definitions: dict[str, Any],
+ *,
+ custom_response_validation_http_code: HTTPStatus | None,
+) -> None:
+ """Add response validation error if a custom HTTP code is configured."""
+ if not custom_response_validation_http_code:
+ return
+
+ http_code = custom_response_validation_http_code.value
+ operation_responses[http_code] = {
+ "description": "Response Validation Error",
+ "content": {
+ DEFAULT_CONTENT_TYPE: {"schema": {"$ref": f"{COMPONENT_REF_PREFIX}ResponseValidationError"}},
+ },
+ }
+ definitions["ResponseValidationError"] = response_validation_error_response_definition
+
+
+def _deduplicate_parameters(parameters: list[dict[str, Any]]) -> list[dict[str, Any]]:
+ """Deduplicate parameters, giving priority to required ones."""
+ all_parameters = {(param["in"], param["name"]): param for param in parameters}
+ required_parameters = {(param["in"], param["name"]): param for param in parameters if param.get("required")}
+ all_parameters.update(required_parameters)
+ return list(all_parameters.values())
+
+
+def _add_validation_error_definitions(definitions: dict[str, Any]) -> None:
+ """Add standard validation error schema definitions if not already present."""
+ if "ValidationError" not in definitions:
+ definitions["ValidationError"] = validation_error_definition
+ definitions["HTTPValidationError"] = validation_error_response_definition
+
+
+def _warn_duplicate_operation_id(
+ operation_id: str,
+ operation_ids: set[str],
+ func_name: str,
+ func_file: str | None,
+) -> None:
+ """Warn if an operationId has already been used."""
+ if operation_id not in operation_ids:
+ return
+
+ message = f"Duplicate Operation ID {operation_id} for function {func_name}"
+ if func_file:
+ message += f" in {func_file}"
+ warnings.warn(message, stacklevel=1)
+
+
+def _build_media_content(
+ body_schema: dict[str, Any],
+ openapi_examples: dict[str, Any] | None,
+) -> dict[str, Any]:
+ """Build the media content dict for a request body."""
+ content: dict[str, Any] = {"schema": body_schema}
+ if openapi_examples:
+ content["examples"] = openapi_examples
+ return content
+
+
+def _build_custom_response(
+ *,
+ response: OpenAPIResponse,
+ dependant: Dependant,
+ model_name_map: dict[TypeModelOrEnum, str],
+ field_mapping: dict[tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue],
+) -> OpenAPIResponse:
+ """Build a single custom response, resolving model references in content."""
+ if "content" not in response:
+ response["content"] = {
+ DEFAULT_CONTENT_TYPE: _build_return_schema(
+ param=dependant.return_param,
+ model_name_map=model_name_map,
+ field_mapping=field_mapping,
+ ),
+ }
+ return response
+
+ for content_type, payload in response["content"].items():
+ response["content"][content_type] = _resolve_response_payload(
+ payload=payload,
+ dependant=dependant,
+ model_name_map=model_name_map,
+ field_mapping=field_mapping,
+ )
+
+ return response
+
+
+def _resolve_response_payload(
+ *,
+ payload: OpenAPIResponseContentSchema | OpenAPIResponseContentModel,
+ dependant: Dependant,
+ model_name_map: dict[TypeModelOrEnum, str],
+ field_mapping: dict[tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue],
+) -> OpenAPIResponseContentSchema:
+ """Resolve a single response content payload, replacing model refs with schemas."""
+ if "model" not in payload:
+ return cast(OpenAPIResponseContentSchema, payload)
+
+ model_payload_typed = cast(OpenAPIResponseContentModel, payload)
+ return_field = next(
+ filter(
+ lambda model: model.type_ is model_payload_typed["model"],
+ dependant.response_extra_models,
+ ),
+ )
+ if not return_field:
+ raise AssertionError("Model declared in custom responses was not found")
+
+ model_payload = _build_return_schema(
+ param=return_field,
+ model_name_map=model_name_map,
+ field_mapping=field_mapping,
+ )
+
+ new_payload: OpenAPIResponseContentSchema = {}
+ for key, value in payload.items():
+ if key != "model":
+ new_payload[key] = value # type: ignore[literal-required]
+ new_payload.update(model_payload)
+ return new_payload
diff --git a/aws_lambda_powertools/event_handler/openapi/swagger_ui/__init__.py b/aws_lambda_powertools/event_handler/openapi/swagger_ui/__init__.py
new file mode 100644
index 00000000000..bc6eda8abb3
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/openapi/swagger_ui/__init__.py
@@ -0,0 +1,13 @@
+from aws_lambda_powertools.event_handler.openapi.swagger_ui.html import (
+ generate_swagger_html,
+)
+from aws_lambda_powertools.event_handler.openapi.swagger_ui.oauth2 import (
+ OAuth2Config,
+ generate_oauth2_redirect_html,
+)
+
+__all__ = [
+ "generate_swagger_html",
+ "generate_oauth2_redirect_html",
+ "OAuth2Config",
+]
diff --git a/aws_lambda_powertools/event_handler/openapi/swagger_ui/html.py b/aws_lambda_powertools/event_handler/openapi/swagger_ui/html.py
new file mode 100644
index 00000000000..6bcbcff50a4
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/openapi/swagger_ui/html.py
@@ -0,0 +1,101 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+ from aws_lambda_powertools.event_handler.openapi.swagger_ui.oauth2 import OAuth2Config
+
+
+def generate_swagger_html(
+ spec: str,
+ swagger_js: str,
+ swagger_css: str,
+ swagger_base_url: str,
+ oauth2_config: OAuth2Config | None,
+ persist_authorization: bool = False,
+) -> str:
+ """
+ Generate Swagger UI HTML page
+
+ Parameters
+ ----------
+ spec: str
+ The OpenAPI spec
+ swagger_js: str
+ Swagger UI JavaScript source code or URL
+ swagger_css: str
+ Swagger UI CSS source code or URL
+ swagger_base_url: str
+ The base URL for Swagger UI
+ oauth2_config: OAuth2Config, optional
+ The OAuth2 configuration.
+ persist_authorization: bool, optional
+ Whether to persist authorization data on browser close/refresh.
+ """
+
+ # If Swagger base URL is present, generate HTML content with linked CSS and JavaScript files
+ # If no Swagger base URL is provided, include CSS and JavaScript directly in the HTML
+ if swagger_base_url:
+ swagger_css_content = f"<link rel='stylesheet' type='text/css' href='{swagger_css}'>"
+ swagger_js_content = f"<script src='{swagger_js}'></script>"
+ else:
+ swagger_css_content = f"<style>{swagger_css}</style>"
+ swagger_js_content = f"<script>{swagger_js}</script>"
+
+ # Prepare oauth2 config
+ oauth2_content = (
+ f"ui.initOAuth({oauth2_config.json(exclude_none=True, exclude_unset=True)});" if oauth2_config else ""
+ )
+
+ return f"""
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="UTF-8">
+ <title>Swagger UI
+
+ {swagger_css_content}
+
+
+
+
+ Loading...
+
+
+
+{swagger_js_content}
+
+
+