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 b1fa7de1f58..beb340ad645 100755
--- a/.chglog/CHANGELOG.tpl.md
+++ b/.chglog/CHANGELOG.tpl.md
@@ -1,13 +1,18 @@
+
+
+
{{ if .Versions -}}
-## Unreleased
+# Unreleased
{{ if .Unreleased.CommitGroups -}}
{{ range .Unreleased.CommitGroups -}}
-### {{ .Title }}
+## {{ .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 -}}
@@ -17,22 +22,25 @@
## {{ if .Tag.Previous }}[{{ .Tag.Name }}]{{ else }}{{ .Tag.Name }}{{ end }} - {{ datetime "2006-01-02" .Tag.Date }}
{{ range .CommitGroups -}}
-### {{ .Title }}
+
+## {{ .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 -}}
{{- if .RevertCommits -}}
-### Reverts
+## Reverts
{{ range .RevertCommits -}}
* {{ .Revert.Header }}
{{ end }}
{{ end -}}
{{- if .MergeCommits -}}
-### Pull Requests
+## Pull Requests
{{ range .MergeCommits -}}
* {{ .Header }}
@@ -41,7 +49,7 @@
{{- if .NoteGroups -}}
{{ range .NoteGroups -}}
-### {{ .Title }}
+## {{ .Title }}
{{ range .Notes }}
{{ .Body }}
{{ end }}
diff --git a/.chglog/config.yml b/.chglog/config.yml
index 3392563d445..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:
@@ -32,3 +32,6 @@ options:
notes:
keywords:
- BREAKING CHANGE
+ # issues:
+ # prefix:
+ # - #
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/.devcontainer/Dockerfile b/.devcontainer/Dockerfile
deleted file mode 100644
index 93e6be8034d..00000000000
--- a/.devcontainer/Dockerfile
+++ /dev/null
@@ -1,17 +0,0 @@
-# See here for image contents: https://github.com/microsoft/vscode-dev-containers/tree/v0.187.0/containers/python-3/.devcontainer/base.Dockerfile
-
-# [Choice] Python version: 3, 3.9, 3.8, 3.7, 3.6
-ARG VARIANT="3.9"
-FROM mcr.microsoft.com/vscode/devcontainers/python:0-${VARIANT}
-ENV POETRY_VIRTUALENVS_IN_PROJECT=true
-
-# [Option] Install Node.js
-ARG INSTALL_NODE="true"
-ARG NODE_VERSION="lts/*"
-RUN if [ "${INSTALL_NODE}" = "true" ]; then su vscode -c "umask 0002 && . /usr/local/share/nvm/nvm.sh && nvm install ${NODE_VERSION} 2>&1"; fi
-
-RUN pip3 install -U pip black poetry pre-commit
-
-# [Optional] Uncomment this section to install additional OS packages.
-RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
- && apt-get -y install --no-install-recommends bash-completion
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
deleted file mode 100644
index 995ac6c4fba..00000000000
--- a/.devcontainer/devcontainer.json
+++ /dev/null
@@ -1,47 +0,0 @@
-// For format details, see https://aka.ms/devcontainer.json. For config options, see the README at:
-{
- "name": "Python 3",
- "build": {
- "dockerfile": "Dockerfile",
- "context": "..",
- "args": {
- "VARIANT": "3.9",
- "INSTALL_NODE": "true",
- "NODE_VERSION": "lts/*"
- }
- },
- "settings": {
- "git.enableCommitSigning": true,
- "editor.formatOnSave": true,
- "python.pythonPath": "/usr/local/bin/python",
- "python.languageServer": "Pylance",
- "python.linting.enabled": true,
- "python.linting.pylintEnabled": true,
- "python.formatting.autopep8Path": "/usr/local/py-utils/bin/autopep8",
- "python.formatting.blackPath": "/usr/local/py-utils/bin/black",
- "python.formatting.yapfPath": "/usr/local/py-utils/bin/yapf",
- "python.linting.banditPath": "/usr/local/py-utils/bin/bandit",
- "python.linting.flake8Path": "/usr/local/py-utils/bin/flake8",
- "python.linting.mypyPath": "/usr/local/py-utils/bin/mypy",
- "python.linting.pycodestylePath": "/usr/local/py-utils/bin/pycodestyle",
- "python.linting.pydocstylePath": "/usr/local/py-utils/bin/pydocstyle",
- "python.linting.pylintPath": "/usr/local/py-utils/bin/pylint",
- "python.testing.pytestArgs": [
- "tests"
- ],
- "python.testing.unittestEnabled": false,
- "python.testing.nosetestsEnabled": false,
- "python.testing.pytestEnabled": true,
- "python.formatting.provider": "black"
- },
- "extensions": [
- "ms-python.python",
- "ms-python.vscode-pylance",
- "littlefoxteam.vscode-python-test-adapter",
- "ms-azuretools.vscode-docker",
- "davidanson.vscode-markdownlint",
- "bungcip.better-toml"
- ],
- "postCreateCommand": "make dev",
- "remoteUser": "vscode"
-}
diff --git a/.flake8 b/.flake8
index 6c0c78fa967..1db8406d9e4 100644
--- a/.flake8
+++ b/.flake8
@@ -3,6 +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
new file mode 100644
index 00000000000..1062320f5b1
--- /dev/null
+++ b/.github/CODEOWNERS
@@ -0,0 +1,3 @@
+# https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+
+* @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
new file mode 100644
index 00000000000..bbc3ff3b3d8
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/maintenance.yml
@@ -0,0 +1,65 @@
+name: Maintenance
+description: Suggest an activity to help address governance and anything internal
+title: "Maintenance: TITLE"
+labels: ["internal", "triage"]
+body:
+ - type: markdown
+ attributes:
+ value: |
+ 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: 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: Solution
+ 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/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 806bbebcedb..234a347f24a 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,4 +1,5 @@
-**Issue number:**
+<!-- markdownlint-disable MD041 MD043 -->
+**Issue number:** closes #<replace with issue number>
## Summary
@@ -10,30 +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 my this change
-* [ ] Changes are tested
-* [ ] Changes are documented
-* [ ] PR title follows [conventional commit semantics](https://github.com/awslabs/aws-lambda-powertools-python/blob/376ec0a2ac0d2a40e0af5717bef42ff84ca0d1b9/.github/semantic.yml#L2)
-
-
-<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 9f6554fc784..006db19c585 100644
--- a/.github/boring-cyborg.yml
+++ b/.github/boring-cyborg.yml
@@ -37,14 +37,15 @@ labelPRBasedOnFilePath:
feature_flags:
- aws_lambda_powertools/feature_flags/*
- aws_lambda_powertools/feature_flags/**/*
- jmespath_util:
+ jmespath:
- aws_lambda_powertools/utilities/jmespath_utils/*
typing:
- aws_lambda_powertools/utilities/typing/*
- mypy.ini
- utilities:
- - aws_lambda_powertools/utilities/*
- - aws_lambda_powertools/utilities/**/*
+ streaming:
+ - aws_lambda_powertools/utilities/streaming/*
+ commons:
+ - aws_lambda_powertools/shared/*
documentation:
- docs/*
@@ -96,6 +97,8 @@ 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 Powertools for AWS Lambda Discord: [Invite link](https://discord.gg/B8zZKbbyET)
+
# Comment to be posted to congratulate user on their first merged PR
firstPRMergeComment: >
Awesome work, congrats on your first merged pull request and thank you for helping improve everyone's experience!
@@ -104,6 +107,8 @@ 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 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.
#insertIssueLinkInPrDescription:
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/disabled_on_merged_pr.yml b/.github/disabled_on_merged_pr.yml
deleted file mode 100644
index 23d1053057a..00000000000
--- a/.github/disabled_on_merged_pr.yml
+++ /dev/null
@@ -1,52 +0,0 @@
-# Maintenance: Verify why we're having permissions issues even with write scope, then re-enable it.
-# logs: https://github.com/awslabs/aws-lambda-powertools-python/runs/7030238348?check_suite_focus=true
-
-# on:
-# pull_request:
-# types:
-# - closed
-
-# env:
-# RELEASE_LABEL: "pending-release"
-# MAINTAINERS_TEAM: "@awslabs/aws-lambda-powertools-python"
-
-# jobs:
-# release_label_on_merge:
-# if: github.event.pull_request.merged == true && github.event.pull_request.user.login != 'dependabot[bot]'
-# runs-on: ubuntu-latest
-# permissions:
-# issues: write # required for new scoped token
-# steps:
-# - name: "Label PR related issue for release"
-# uses: actions/github-script@v6
-# with:
-# github-token: ${{ secrets.GITHUB_TOKEN }}
-# script: |
-# const prBody = context.payload.body;
-# const prNumber = context.payload.number;
-# const releaseLabel = process.env.RELEASE_LABEL;
-# const maintainersTeam = process.env.MAINTAINERS_TEAM
-
-# const RELATED_ISSUE_REGEX = /Issue number:.+(\d)/
-
-# const matcher = new RegExp(RELATED_ISSUE_REGEX)
-# const isMatch = matcher.exec(prBody)
-# if (isMatch != null) {
-# let relatedIssueNumber = isMatch[1]
-# console.info(`Auto-labeling related issue ${relatedIssueNumber} for release`)
-
-# await github.rest.issues.addLabels({
-# issue_number: relatedIssueNumber,
-# owner: context.repo.owner,
-# repo: context.repo.repo,
-# labels: [releaseLabel]
-# })
-# } else {
-# let msg = `${maintainersTeam} No related issues found. Please ensure '${releaseLabel}' label is applied before releasing.`;
-# await github.rest.issues.createComment({
-# owner: context.repo.owner,
-# repo: context.repo.repo,
-# body: msg,
-# issue_number: prNumber,
-# });
-# }
diff --git a/.github/mergify.yml b/.github/mergify.yml
index a623796a514..dc3f1953586 100644
--- a/.github/mergify.yml
+++ b/.github/mergify.yml
@@ -22,7 +22,6 @@
# - name: Automatic merge ⬇️ on approval ✔
# conditions:
-# - base!=master
# - "#approved-reviews-by>=2"
# actions:
# queue:
diff --git a/.github/scripts/constants.js b/.github/scripts/constants.js
new file mode 100644
index 00000000000..8bfe5571974
--- /dev/null
+++ b/.github/scripts/constants.js
@@ -0,0 +1,42 @@
+module.exports = Object.freeze({
+ /** @type {string} */
+ // Values: https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#pull_request
+ "PR_ACTION": process.env.PR_ACTION?.replace(/"/g, '') || "",
+
+ /** @type {string} */
+ "PR_AUTHOR": process.env.PR_AUTHOR?.replace(/"/g, '') || "",
+
+ /** @type {string} */
+ "PR_BODY": process.env.PR_BODY || "",
+
+ /** @type {string} */
+ "PR_TITLE": process.env.PR_TITLE || "",
+
+ /** @type {number} */
+ "PR_NUMBER": process.env.PR_NUMBER || 0,
+
+ /** @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": "@aws-powertools/powertools-lambda-python",
+
+ /** @type {string[]} */
+ "IGNORE_AUTHORS": ["dependabot[bot]", "markdownify[bot]"],
+
+});
diff --git a/.github/workflows/post_release.js b/.github/scripts/post_release.js
similarity index 94%
rename from .github/workflows/post_release.js
rename to .github/scripts/post_release.js
index 70474740e2e..d6a598f1960 100644
--- a/.github/workflows/post_release.js
+++ b/.github/scripts/post_release.js
@@ -100,13 +100,13 @@ const notifyRelease = async ({
// context: https://github.com/actions/toolkit/blob/main/packages/github/src/context.ts
module.exports = async ({ github, context }) => {
- const { RELEASE_TAG_VERSION } = process.env;
- console.log(`Running post-release script for ${RELEASE_TAG_VERSION} version`);
+ const { RELEASE_VERSION } = process.env;
+ console.log(`Running post-release script for ${RELEASE_VERSION} version`);
await notifyRelease({
gh_client: github,
owner: context.repo.owner,
repository: context.repo.repo,
- release_version: RELEASE_TAG_VERSION,
+ release_version: RELEASE_VERSION,
});
};
diff --git a/.github/workflows/auto-merge.yml b/.github/workflows/auto-merge.yml
deleted file mode 100644
index 7ce6ff8ba29..00000000000
--- a/.github/workflows/auto-merge.yml
+++ /dev/null
@@ -1,25 +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-patch'
- 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
new file mode 100644
index 00000000000..9509114b423
--- /dev/null
+++ b/.github/workflows/build_changelog.yml
@@ -0,0 +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 edd7e67bf91..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]
+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
-
- # 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
-
- - name: Perform CodeQL Analysis
- uses: github/codeql-action/analyze@v2
+ - name: Checkout repository
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+ # Initializes the CodeQL tools for scanning.
+ - name: Initialize CodeQL
+ uses: github/codeql-action/init@f31a31c052207cc13b328d6295c5b728bb49568c # v2.13.1
+
+ - name: Perform CodeQL Analysis
+ 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/export_pr_details.yml b/.github/workflows/export_pr_details.yml
deleted file mode 100644
index af03150c3d5..00000000000
--- a/.github/workflows/export_pr_details.yml
+++ /dev/null
@@ -1,75 +0,0 @@
-on:
- workflow_call:
- inputs:
- record_pr_workflow_id:
- required: true
- type: number
- secrets:
- token:
- required: true
- # Map the workflow outputs to job outputs
- outputs:
- prNumber:
- description: "The first output string"
- value: ${{ jobs.export_pr_details.outputs.prNumber }}
- prTitle:
- description: "The second output string"
- value: ${{ jobs.export_pr_details.outputs.prTitle }}
- prBody:
- description: "The second output string"
- value: ${{ jobs.export_pr_details.outputs.prBody }}
- prAuthor:
- description: "The second output string"
- value: ${{ jobs.export_pr_details.outputs.prAuthor }}
- prAction:
- description: "The second output string"
- value: ${{ jobs.export_pr_details.outputs.prAction }}
-
-name: Export Pull Request details from fork
-jobs:
- export_pr_details:
- runs-on: ubuntu-latest
- # 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 }}
- steps:
- - name: "Download artifact"
- uses: actions/github-script@v6
- # For security, we only download artifacts tied to the successful PR recording workflow
- with:
- github-token: ${{ secrets.token }}
- script: |
- const fs = require('fs');
-
- const artifacts = await github.rest.actions.listWorkflowRunArtifacts({
- owner: context.repo.owner,
- repo: context.repo.repo,
- run_id: ${{inputs.record_pr_workflow_id}},
- });
-
- const matchArtifact = artifacts.data.artifacts.filter(artifact => artifact.name == "pr")[0];
-
- const artifact = await github.rest.actions.downloadArtifact({
- owner: context.repo.owner,
- repo: context.repo.repo,
- artifact_id: matchArtifact.id,
- archive_format: 'zip',
- });
-
- fs.writeFileSync('${{github.workspace}}/pr.zip', Buffer.from(artifact.data));
- # NodeJS standard library doesn't provide ZIP capabilities; use system `unzip` command instead
- - run: unzip pr.zip
- - id: prNumber
- run: echo ::set-output name=prNumber::$(cat ./number)
- - id: prTitle
- run: echo ::set-output name=prTitle::$(cat ./title)
- - id: prBody
- run: echo ::set-output name=prBody::$(cat ./body)
- - id: prAuthor
- run: echo ::set-output name=prAuthor::$(cat ./author)
- - id: prAction
- run: echo ::set-output name=prAction::$(cat ./action)
diff --git a/.github/workflows/label_pr_on_title.yml b/.github/workflows/label_pr_on_title.yml
deleted file mode 100644
index 06e3f552cc2..00000000000
--- a/.github/workflows/label_pr_on_title.yml
+++ /dev/null
@@ -1,87 +0,0 @@
-name: Label PR based on title
-
-on:
- workflow_run:
- workflows: ["Record PR number"]
- types:
- - completed
-
-jobs:
- upload:
- runs-on: ubuntu-latest
- # Guardrails to only ever run if PR recording workflow was indeed
- # run in a PR event and ran successfully
- if: >
- ${{ github.event.workflow_run.event == 'pull_request' &&
- github.event.workflow_run.conclusion == 'success' }}
- steps:
- - name: 'Download artifact'
- uses: actions/github-script@v6
- # For security, we only download artifacts tied to the successful PR recording workflow
- with:
- script: |
- const fs = require('fs');
-
- const artifacts = await github.rest.actions.listWorkflowRunArtifacts({
- owner: context.repo.owner,
- repo: context.repo.repo,
- run_id: ${{github.event.workflow_run.id }},
- });
-
- const matchArtifact = artifacts.data.artifacts.filter(artifact => artifact.name == "pr")[0];
-
- const artifact = await github.rest.actions.downloadArtifact({
- owner: context.repo.owner,
- repo: context.repo.repo,
- artifact_id: matchArtifact.id,
- archive_format: 'zip',
- });
-
- fs.writeFileSync('${{github.workspace}}/pr.zip', Buffer.from(artifact.data));
- # NodeJS standard library doesn't provide ZIP capabilities; use system `unzip` command instead
- - run: unzip pr.zip
-
- - name: 'Label PR based on title'
- uses: actions/github-script@v6
- 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 fs = require('fs');
- const pr_number = Number(fs.readFileSync('./number'));
- const pr_title = fs.readFileSync('./title', 'utf-8').trim();
-
- 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,
- }
-
- for (const label in labels) {
- const matcher = new RegExp(labels[label])
- const isMatch = matcher.exec(pr_title)
- if (isMatch != null) {
- console.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]
- })
-
- break
- }
- }
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 609afe583b1..00000000000
--- a/.github/workflows/on_closed_issues.yml
+++ /dev/null
@@ -1,12 +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: "This issue is now closed. Please be mindful that future comments are hard for our team to see."
diff --git a/.github/workflows/on_opened_pr.yml b/.github/workflows/on_opened_pr.yml
deleted file mode 100644
index 9a539976467..00000000000
--- a/.github/workflows/on_opened_pr.yml
+++ /dev/null
@@ -1,59 +0,0 @@
-on:
- workflow_run:
- workflows: ["Record PR number"]
- types:
- - completed
-
-env:
- BLOCK_LABEL: "do-not-merge"
- BLOCK_REASON_LABEL: "need-issue"
-
-jobs:
- get_pr_details:
- if: github.event.workflow_run.event == 'pull_request' && github.event.workflow_run.conclusion == 'success'
- uses: ./.github/workflows/export_pr_details.yml
- with:
- record_pr_workflow_id: ${{ github.event.workflow_run.id }}
- secrets:
- token: ${{ secrets.GITHUB_TOKEN }}
- check_related_issue:
- needs: get_pr_details
- if: >
- ${{ needs.get_pr_details.outputs.prAuthor != 'dependabot[bot]' &&
- needs.get_pr_details.outputs.prAction == 'opened'
- }}
- runs-on: ubuntu-latest
- steps:
- - name: "Ensure related issue is present"
- uses: actions/github-script@v6
- with:
- github-token: ${{ secrets.GITHUB_TOKEN }}
- # Maintenance: convert into a standalone JS like post_release.js
- script: |
- const prBody = "${{ needs.get_pr_details.outputs.prBody }}";
- const prNumber = ${{ needs.get_pr_details.outputs.prNumber }};
- const blockLabel = process.env.BLOCK_LABEL;
- const blockReasonLabel = process.env.BLOCK_REASON_LABEL;
-
- const RELATED_ISSUE_REGEX = /Issue number:.+(\d)/
-
- const matcher = new RegExp(RELATED_ISSUE_REGEX)
- const isMatch = matcher.exec(prBody)
- if (isMatch == null) {
- console.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: prNumber,
- });
-
- await github.rest.issues.addLabels({
- issue_number: prNumber,
- owner: context.repo.owner,
- repo: context.repo.repo,
- labels: [blockLabel, blockReasonLabel]
- })
- }
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
new file mode 100644
index 00000000000..fc1aa3786e6
--- /dev/null
+++ b/.github/workflows/on_push_docs.yml
@@ -0,0 +1,36 @@
+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:
+ - develop
+ paths:
+ - "docs/**"
+ - "mkdocs.yml"
+ - "examples/**"
+ - "CHANGELOG.md"
+
+permissions:
+ contents: read
+
+jobs:
+ release-docs:
+ permissions:
+ 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
\ No newline at end of file
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.yml b/.github/workflows/publish.yml
deleted file mode 100644
index 218df1aef35..00000000000
--- a/.github/workflows/publish.yml
+++ /dev/null
@@ -1,127 +0,0 @@
-name: Publish to PyPi
-
-# RELEASE PROCESS
-#
-# === Manual activities ===
-#
-# 1. Document human readable changes in CHANGELOG (pre-generate unreleased changes with `make changelog`)
-# 2. Bump package version using poetry version <major|minor|patch|specific version>
-# 3. Merge version changes to develop branch
-# 4. Edit the current draft release notes
-# 5. If not already set, use `v<new version>` as a tag, and select develop as target branch
-#
-# === Automated activities ===
-#
-# 1. Extract release notes tag that was published
-# 2. Ensure release notes tag match what's in CHANGELOG and pyproject
-# 3. Run tests, linting, security and complexity base line
-# 4. Publish package to PyPi test repository
-# 5. Publish package to PyPi prod repository
-# 6. Kick off Lambda Layer pipeline to publish latest version with minimal dependencies as a SAR App
-# 7. Kick off Lambda Layer pipeline to publish latest version with extra dependencies as a SAR App
-# 8. Builds a fresh version of docs including Changelog updates
-# 9. Push latest release source code to master using release title as the commit message
-# 10. Builds latest documentation for new release, and update latest alias pointing to the new release tag
-# 11. Close and notify all issues labeled "pending-release" about the release details
-
-#
-# === Fallback mechanism due to external failures ===
-#
-# 1. Trigger "Publish to PyPi" workflow manually: https://docs.github.com/en/actions/managing-workflow-runs/manually-running-a-workflow
-# 2. Use the version released under Releases e.g. v1.13.0
-#
-
-#
-# === Documentation hotfix ===
-#
-# Look for rebuild latest docs workflow
-
-on:
- release:
- types: [published]
-
-jobs:
- release:
- runs-on: ubuntu-latest
- steps:
- - uses: actions/checkout@v3
- with:
- fetch-depth: 0
- - name: Set up Python
- uses: actions/setup-python@v4
- with:
- python-version: "3.8"
- - name: Set release notes tag
- run: |
- RELEASE_TAG_VERSION=${{ github.event.release.tag_name }}
- echo "RELEASE_TAG_VERSION=${RELEASE_TAG_VERSION:1}" >> $GITHUB_ENV
- - name: Ensure new version is also set in pyproject and CHANGELOG
- run: |
- grep --regexp "${RELEASE_TAG_VERSION}" CHANGELOG.md
- grep --regexp "version \= \"${RELEASE_TAG_VERSION}\"" pyproject.toml
- - name: Install dependencies
- run: make dev
- - name: Run all tests, linting and baselines
- run: make pr
- - name: Build python package and wheel
- run: poetry build
- - name: Upload to PyPi test
- run: make release-test
- env:
- PYPI_USERNAME: __token__
- PYPI_TEST_TOKEN: ${{ secrets.PYPI_TEST_TOKEN }}
- - name: Upload to PyPi prod
- run: make release-prod
- env:
- PYPI_USERNAME: __token__
- PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}
- - name: publish lambda layer in SAR by triggering the internal codepipeline
- run: |
- aws ssm put-parameter --name "powertools-python-release-version" --value $RELEASE_TAG_VERSION --overwrite
- aws codepipeline start-pipeline-execution --name ${{ secrets.CODEPIPELINE_NAME }}
- env:
- # Maintenance: Migrate to new OAuth mechanism
- AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
- AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
- AWS_DEFAULT_REGION: eu-west-1
- AWS_DEFAULT_OUTPUT: json
- - name: Setup doc deploy
- run: |
- git config --global user.name Docs deploy
- git config --global user.email aws-devax-open-source@amazon.com
- - name: Build docs website and API reference
- run: |
- make release-docs VERSION=${RELEASE_TAG_VERSION} ALIAS="latest"
- poetry run mike set-default --push latest
- - name: Release API docs to release version
- uses: peaceiris/actions-gh-pages@v3
- with:
- github_token: ${{ secrets.GITHUB_TOKEN }}
- publish_dir: ./api
- keep_files: true
- destination_dir: ${{ env.RELEASE_TAG_VERSION }}/api
- - name: Release API docs to latest
- uses: peaceiris/actions-gh-pages@v3
- with:
- github_token: ${{ secrets.GITHUB_TOKEN }}
- publish_dir: ./api
- keep_files: true
- destination_dir: latest/api
- - name: Close issues related to this release
- uses: actions/github-script@v6
- with:
- script: |
- const post_release = require('.github/workflows/post_release.js')
- await post_release({github, context, core})
-
- sync_master:
- needs: release
- runs-on: ubuntu-latest
- steps:
- - uses: actions/checkout@v3
- - name: Sync master from detached head
- # If version matches CHANGELOG and pyproject.toml
- # If it passes all checks, successfully releases to test and prod
- # Then sync up master with latest source code release
- # where commit message will be Release notes title
- run: git push origin HEAD:refs/heads/master --force
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 c0cdcc85cff..00000000000
--- a/.github/workflows/python_build.yml
+++ /dev/null
@@ -1,61 +0,0 @@
-name: Code quality
-
-on:
- pull_request:
- paths:
- - "aws_lambda_powertools/**"
- - "tests/**"
- - "pyproject.toml"
- - "poetry.lock"
- - "mypy.ini"
- branches:
- - develop
- - master
- push:
- paths:
- - "aws_lambda_powertools/**"
- - "tests/**"
- - "pyproject.toml"
- - "poetry.lock"
- - "mypy.ini"
- branches:
- - develop
- - master
-
-jobs:
- build:
- runs-on: ubuntu-latest
- strategy:
- max-parallel: 4
- matrix:
- python-version: [3.6, 3.7, 3.8, 3.9]
- env:
- OS: ${{ matrix.os }}
- PYTHON: ${{ matrix.python-version }}
- steps:
- - uses: actions/checkout@v3
- - name: Set up Python ${{ matrix.python-version }}
- uses: actions/setup-python@v4
- with:
- python-version: ${{ matrix.python-version }}
- - 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@v3.1.0
- with:
- file: ./coverage.xml
- # flags: unittests
- env_vars: OS,PYTHON
- name: aws-lambda-powertools-python-codecov
- # fail_ci_if_error: true # failing more consistently making CI unreliable despite all tests above passing
- token: ${{ secrets.CODECOV_TOKEN }}
diff --git a/.github/workflows/python_docs.yml b/.github/workflows/python_docs.yml
deleted file mode 100644
index 3a6e15e5431..00000000000
--- a/.github/workflows/python_docs.yml
+++ /dev/null
@@ -1,53 +0,0 @@
-name: Docs
-
-on:
- push:
- branches:
- - develop
- paths:
- - "docs/**"
- - "CHANGELOG.md"
- - "mkdocs.yml"
- - "examples/**"
-
-jobs:
- docs:
- runs-on: ubuntu-latest
- steps:
- - uses: actions/checkout@v3
- with:
- fetch-depth: 0
- - name: Set up Python
- uses: actions/setup-python@v4
- with:
- python-version: "3.8"
- # Maintenance: temporarily until we drop Python 3.6 and make cfn-lint a dev dependency
- - name: Setup Cloud Formation Linter with Latest Version
- uses: scottbrenner/cfn-lint-action@v2
- - name: Install dependencies
- run: make dev
- - name: Lint documentation
- run: |
- make lint-docs
- cfn-lint examples/**/*.yaml
- - name: Setup doc deploy
- run: |
- git config --global user.name Docs deploy
- git config --global user.email docs@dummy.bot.com
- - name: Build docs website and API reference
- run: make release-docs VERSION="develop" ALIAS="stage"
- - name: Deploy all docs
- uses: peaceiris/actions-gh-pages@v3
- with:
- github_token: ${{ secrets.GITHUB_TOKEN }}
- publish_dir: ./api
- keep_files: true
- destination_dir: develop/api
- - 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/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 b185556f2ff..665cad81dd1 100644
--- a/.github/workflows/rebuild_latest_docs.yml
+++ b/.github/workflows/rebuild_latest_docs.yml
@@ -1,62 +1,39 @@
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
-# 3. Set `Build and publish docs only` field to `true`
-
+# 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.22.0'
- default: 'v1.22.0'
+ description: "Latest PyPi published version to rebuild latest docs for, e.g. 2.16.3"
+ default: "2.16.3"
required: true
+permissions:
+ contents: read
jobs:
- release:
- runs-on: ubuntu-latest
- steps:
- - uses: actions/checkout@v3
- with:
- fetch-depth: 0
- - name: Set up Python
- uses: actions/setup-python@v4
- with:
- python-version: "3.8"
- - name: Set release notes tag
- run: |
- RELEASE_TAG_VERSION=${{ github.event.inputs.latest_published_version }}
- echo "RELEASE_TAG_VERSION=${RELEASE_TAG_VERSION:1}" >> $GITHUB_ENV
- - name: Ensure new version is also set in pyproject and CHANGELOG
- run: |
- grep --regexp "${RELEASE_TAG_VERSION}" CHANGELOG.md
- grep --regexp "version \= \"${RELEASE_TAG_VERSION}\"" pyproject.toml
- - name: Install dependencies
- run: make dev
- - name: Setup doc deploy
- run: |
- git config --global user.name Docs deploy
- git config --global user.email aws-devax-open-source@amazon.com
- - name: Build docs website and API reference
- run: |
- make release-docs VERSION=${RELEASE_TAG_VERSION} ALIAS="latest"
- poetry run mike set-default --push latest
- - name: Release API docs to release version
- uses: peaceiris/actions-gh-pages@v3
- with:
- github_token: ${{ secrets.GITHUB_TOKEN }}
- publish_dir: ./api
- keep_files: true
- destination_dir: ${{ env.RELEASE_TAG_VERSION }}/api
- - name: Release API docs to latest
- uses: peaceiris/actions-gh-pages@v3
- with:
- github_token: ${{ secrets.GITHUB_TOKEN }}
- publish_dir: ./api
- keep_files: true
- destination_dir: latest/api
+ release-docs:
+ permissions:
+ 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 }}
+ alias: latest
diff --git a/.github/workflows/record_pr.yml b/.github/workflows/record_pr.yml
deleted file mode 100644
index fcee8876286..00000000000
--- a/.github/workflows/record_pr.yml
+++ /dev/null
@@ -1,24 +0,0 @@
-name: Record PR number
-
-on:
- pull_request:
- types: [opened, edited]
-
-jobs:
- build:
- runs-on: ubuntu-latest
-
- steps:
- - uses: actions/checkout@v3
- - name: Save PR number
- run: |
- mkdir -p ./pr
- echo ${{ github.event.number }} > ./pr/number
- echo "${{ github.event.pull_request.title }}" > ./pr/title
- echo "${{ github.event.pull_request.body }}" > ./pr/body
- echo "${{ github.event.pull_request.user.login }}" > ./pr/author
- echo "${{ github.event.action }}" > ./pr/action
- - uses: actions/upload-artifact@v3
- with:
- name: pr
- path: pr/
diff --git a/.github/workflows/release-drafter.yml b/.github/workflows/release-drafter.yml
index ecc2251ec43..e08dd925efe 100644
--- a/.github/workflows/release-drafter.yml
+++ b/.github/workflows/release-drafter.yml
@@ -1,16 +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 to consider in the event; optional, defaults to all
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@v5
- 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_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_publish_changelog.yml b/.github/workflows/reusable_publish_changelog.yml
new file mode 100644
index 00000000000..adccac305cc
--- /dev/null
+++ b/.github/workflows/reusable_publish_changelog.yml
@@ -0,0 +1,41 @@
+name: Build and publish latest changelog
+
+# see ./.github/workflows/build_changelog.yml for docs
+
+on:
+ workflow_call:
+
+env:
+ 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@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ fetch-depth: 0
+ - name: "Generate latest changelog"
+ run: make changelog
+ - 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
new file mode 100644
index 00000000000..dd054e98639
--- /dev/null
+++ b/.github/workflows/reusable_publish_docs.yml
@@ -0,0 +1,123 @@
+name: Reusable publish documentation
+
+# see .github/workflows/on_push_docs.yml for docs
+
+env:
+ ORIGIN: aws-powertools/powertools-lambda-python
+
+on:
+ workflow_call:
+ inputs:
+ version:
+ description: "Version to build and publish docs (1.28.0, develop)"
+ required: true
+ type: string
+ alias:
+ description: "Alias to associate version (latest, stage)"
+ required: true
+ type: string
+ detached_mode:
+ description: "Whether it's running in git detached mode to ensure git is sync'd"
+ required: false
+ default: false
+ type: boolean
+ git_ref:
+ description: "Branch or commit ID to checkout from"
+ required: false
+ type: string
+ default: develop
+
+permissions:
+ 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@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ with:
+ fetch-depth: 0
+ ref: ${{ inputs.git_ref }}
+ - name: Set up Python
+ uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+ with:
+ 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
+ git config --global user.email aws-devax-open-source@amazon.com
+ - name: Git refresh tip (detached mode)
+ # Git Detached mode (release notes) doesn't have origin
+ if: ${{ inputs.detached_mode }}
+ run: |
+ git config pull.rebase true
+ git config remote.origin.url >&- || git remote add origin https://github.com/"$ORIGIN"
+ git pull origin "$BRANCH"
+ 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: |
+ rm -rf site
+ mkdocs build
+ - name: Deploy Docs (Version)
+ env:
+ VERSION: ${{ inputs.version }}
+ 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
new file mode 100644
index 00000000000..d05239bf089
--- /dev/null
+++ b/.github/workflows/run-e2e-tests.yml
@@ -0,0 +1,81 @@
+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
+ - v3
+ paths:
+ - "aws_lambda_powertools/**"
+ - "tests/e2e/**"
+ - "pyproject.toml"
+ - "poetry.lock"
+ - "mypy.ini"
+ - "parallel_run_e2e.py"
+
+# Maintenance: Add support for triggering on `run-e2e` label
+# and enforce repo origin to prevent abuse
+
+env:
+ AWS_DEFAULT_REGION: us-east-1
+
+concurrency: e2e
+
+permissions:
+ contents: read
+
+jobs:
+ run:
+ 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 # checkout code
+ strategy:
+ fail-fast: false # needed so if a version fails, the others will still be able to complete and cleanup
+ matrix:
+ 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@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ - name: Install poetry
+ run: pipx install poetry
+ - name: "Use Python"
+ 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-quality-code
+ - name: Configure AWS credentials
+ 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
new file mode 100644
index 00000000000..e2f187a40f2
--- /dev/null
+++ b/.github/workflows/secure_workflows.yml
@@ -0,0 +1,39 @@
+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:
+ - ".github/workflows/**"
+ pull_request:
+ 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@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+ - name: Ensure 3rd party workflows have SHA pinned
+ uses: zgosalvez/github-actions-ensure-sha-pinned-actions@ca46236c6ce584ae24bc6283ba8dcf4b3ec8a066 # v5.0.4
+ with:
+ allowlist: |
+ 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/.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/.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 8a614f78968..f0ea1cbf495 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -5,38 +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: end-of-file-fixer
- 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
+ - id: ruff
+ name: linting::ruff
+ entry: poetry run ruff check
language: system
types: [python]
+ - repo: https://github.com/igorshubovych/markdownlint-cli
+ rev: "ce0d77ac47dc921b62429804fe763d4d35f66a76" # v0.34.0
+ hooks:
+ - id: markdownlint-docker
+ args: ["--fix"]
- repo: local
hooks:
- - id: flake8
- name: linting::flake8
- entry: poetry run flake8
+ - id: cloudformation
+ name: linting::cloudformation
+ entry: poetry run cfn-lint
language: system
- types: [python]
- - repo: https://github.com/igorshubovych/markdownlint-cli
- rev: "11c08644ce6df850480d98f628596446a526cbc6" # frozen: v0.31.1
+ types: [yaml]
+ exclude: examples/build_recipes/*
+ files: examples/.*
+ - repo: https://github.com/rhysd/actionlint
+ rev: "fd7ba3c382e13dcc0248e425b4cbc3f1185fa3ee" # v1.6.24
hooks:
- - id: markdownlint
- args: ["--fix"]
- - repo: https://github.com/aws-cloudformation/cfn-python-lint
- rev: v0.61.1
+ - 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: cfn-python-lint
- files: examples/.*\.(yaml|yml)$
+ - 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 1ca92b6a72a..f2dc360bea2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,1081 +1,7845 @@
-# Changelog
+<!-- changelog is partially generated, so it doesn't follow headings and required structure, so we disable it. -->
+<!-- markdownlint-disable -->
-All notable changes to this project will be documented in this file.
+<a name="unreleased"></a>
+# Unreleased
-This project follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) format for changes and adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-## 1.26.2 - 2022-06-16
+<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/aws-powertools/powertools-lambda-python/issues/1534))
+
+## Documentation
+
+* **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
+
+* **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/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/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>
+## [v1.29.1] - 2022-09-13
+
+<a name="v1.29.0"></a>
+## [v1.29.0] - 2022-09-13
+## Bug Fixes
+
+* **ci:** ignore v2 action for now
+* **ci:** only run e2e tests on py 3.7
+* **ci:** pass core fns to large pr workflow script
+* **ci:** on_label permissioning model & workflow execution
+* **ci:** ensure PR_AUTHOR is present for large_pr_split workflow
+* **ci:** gracefully and successful exit changelog upon no changes
+* **ci:** event resolution for on_label_added workflow
+* **core:** fixes leftovers from rebase
+
+## Documentation
+
+* **layer:** upgrade to 1.28.0 (v33)
+
+## Features
+
+* **ci:** add actionlint in pre-commit hook
+* **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/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
+* **ci:** add missing description fields
+* **ci:** sync package version with pypi
+* **ci:** fix invalid dependency leftover
+* **ci:** create adhoc docs workflow for v2
+* **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/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/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/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/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/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/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
+* **ci:** typo and bust gh actions cache
+* **ci:** use poetry to resolve layer deps; pip for CDK
+* **ci:** disable poetry venv for layer workflow as cdk ignores venv
+* **ci:** add cdk v2 dep for layers workflow
+* **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/aws-powertools/powertools-lambda-python/issues/1446))
+
+## Documentation
+
+* **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/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/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/aws-powertools/powertools-lambda-python/issues/1442))
+
+## Maintenance
+
+* **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
+* **ci:** update changelog with latest changes
+* **ci:** update changelog with latest changes
+* **ci:** reduce payload and only send prod notification
+* **ci:** remove area/utilities conflicting label
+* **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/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
+
+
+<a name="v1.27.0"></a>
+## [v1.27.0] - 2022-08-05
+## Bug Fixes
+
+* **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/aws-powertools/powertools-lambda-python/issues/1421))
+
+## Documentation
+
+* **layer:** upgrade to 1.26.7
+
+## Features
+
+* **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/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
+
+* **ci:** sync area labels to prevent dedup
+* **ci:** update changelog with latest changes
+* **ci:** update changelog with latest changes
+* **ci:** add manual trigger for docs
+* **ci:** update changelog with latest changes
+* **ci:** temporarily disable changelog push on release
+* **ci:** update changelog with latest changes
+* **ci:** move changelog generation to rebuild_latest_doc workflow
+* **ci:** update project with version
+* **ci:** update release automated activities
+* **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/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/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
+
+
+<a name="v1.26.7"></a>
+## [v1.26.7] - 2022-07-29
+## Bug Fixes
+
+* **ci:** add missing oidc token generation permission
+* **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/aws-powertools/powertools-lambda-python/issues/1393))
+
+## Features
+
+* **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/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/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/aws-powertools/powertools-lambda-python/issues/1392))
+
+
+<a name="v1.26.6"></a>
+## [v1.26.6] - 2022-07-25
+## Bug Fixes
+
+* **ci:** remove unsupported env in workflow_call
+* **ci:** allow inherit secrets for reusable workflow
+* **ci:** remove unused secret
+* **ci:** label_related_issue unresolved var from history mixup
+* **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/aws-powertools/powertools-lambda-python/issues/1325))
+
+## Maintenance
+
+* dummy for PR test
+* print full event depth
+* print full workflow event depth
+* debug full event
+* 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/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/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/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/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/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/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/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>
+## [v1.26.5] - 2022-07-20
+## Bug Fixes
+
+* mathc the name of the cdk synth from the build phase
+* typo in input for layer workflow
+* no need to cache npm since we only install cdk cli and don't have .lock files
+* add entire ARN role instead of account and role name
+* path to artefact
+* unzip the right artifact name
+* 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/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/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/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/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/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/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
+
+
+<a name="v1.26.4"></a>
+## [v1.26.4] - 2022-07-18
+## Bug Fixes
+
+* **ci:** checkout project before validating related issue workflow
+* **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
+* **ci:** regex group name for on_merge workflow
+* **ci:** escape outputs as certain PRs can break GH Actions expressions
+* **ci:** move conditionals from yaml to code; leftover
+* **ci:** move conditionals from yaml to code
+* **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/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/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/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/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/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/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/aws-powertools/powertools-lambda-python/issues/1278))
+* **layers:** bump to 22 for 1.26.3
+
+
+<a name="v1.26.3"></a>
+## [v1.26.3] - 2022-07-04
+## Bug Fixes
+
+* **ci:** remove utf-8 body in octokit body req
+* **ci:** improve msg visibility on closed issues
+* **ci:** disable merged_pr workflow
+* **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/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/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
+
+* move to approach B for multiple IaC
+* add sam build gitignore
+* bump to version 1.26.3
+* **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/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/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/aws-powertools/powertools-lambda-python/issues/1249))
+
+## Code Refactoring
+
+* rename to clear_state
+* rename to remove_custom_keys
+
+## Documentation
+
+* fix anchor
+
+## Features
+
+* **logger:** add option to clear state per invocation
+
+## Maintenance
+
+* bump to 1.26.2
+* **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
+* **governance:** limit build workflow to code changes only
+* **governance:** auto-merge workflow_dispatch off
+* **governance:** auto-merge to use squash
+* **governance:** check for related issue in new PRs
+* **governance:** auto-merge mypy-stub dependabot
+* **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/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/aws-powertools/powertools-lambda-python/issues/1240))
+
+## Documentation
+
+* **governance:** link roadmap and maintainers doc
+* **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/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/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/aws-powertools/powertools-lambda-python/issues/1204))
+
+## Features
+
+* **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/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/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
+
+* **layer:** upgrade to 1.25.9
+
+## Features
+
+* **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/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/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/aws-powertools/powertools-lambda-python/issues/1027)) ([#1190](https://github.com/aws-powertools/powertools-lambda-python/issues/1190))
+
+
+<a name="v1.25.9"></a>
+## [v1.25.9] - 2022-04-21
+## Bug Fixes
+
+* **deps:** correct py36 marker for jmespath
+
+## Maintenance
+
+* bump to 1.25.9
+
+
+<a name="v1.25.8"></a>
+## [v1.25.8] - 2022-04-21
+## Bug Fixes
+
+* removed ambiguous quotes from labels.
+* **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/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/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/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
+
+* **layer:** update to 1.25.6; cosmetic changes
+
+## Maintenance
+
+* bump to 1.25.7
+* **governance:** refresh pull request template sections
+* **governance:** update external non-triage effort disclaimer
+* **governance:** update static typing to a form
+* **governance:** update rfc to a form
+* **governance:** update feat request to a form
+* **governance:** bug report form typo
+* **governance:** update docs report to a form
+* **governance:** update bug report to a form
+* **governance:** new ask a question
+* **governance:** new static typing report
+
+
+<a name="v1.25.6"></a>
+## [v1.25.6] - 2022-04-01
+## Bug Fixes
+
+* **logger:** clear_state regression on absent standard keys ([#1088](https://github.com/aws-powertools/powertools-lambda-python/issues/1088))
+
+## Documentation
+
+* **layer:** bump to 1.25.5
+
+## Maintenance
+
+* bump to 1.25.6
+
+
+<a name="v1.25.5"></a>
+## [v1.25.5] - 2022-03-18
+## Bug Fixes
+
+* **logger-utils:** regression on exclude set leading to no formatter ([#1080](https://github.com/aws-powertools/powertools-lambda-python/issues/1080))
+
+## Maintenance
+
+* bump to 1.25.5
+
+
+<a name="v1.25.4"></a>
+## [v1.25.4] - 2022-03-17
+## Bug Fixes
+
+* package_logger as const over logger instance
+* repurpose test to cover parent loggers case
+* use addHandler over monkeypatch
+
+## Documentation
+
+* **appsync:** fix typo
+* **contributing:** operational excellence pause
+* **layer:** update to 1.25.3
+
+## Maintenance
+
+* bump to 1.25.4
+* remove duplicate test
+* comment reason for change
+* remove unnecessary test
+* lint unused import
+
+## Regression
+
+* service_name fixture
+
+## Pull Requests
+
+* 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/aws-powertools/powertools-lambda-python/issues/1072))
+
+## Documentation
+
+* **plugin:** add mermaid to create diagram as code ([#1070](https://github.com/aws-powertools/powertools-lambda-python/issues/1070))
+
+## Maintenance
+
+* bump to 1.25.3
+
+
+<a name="v1.25.2"></a>
+## [v1.25.2] - 2022-03-07
+## Bug Fixes
-### Bug Fixes
+* **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))
-* **event-handler:** body to empty string in CORS preflight (ALB non-compliant) ([#1249](https://github.com/awslabs/aws-lambda-powertools-python/issues/1249))
+## Documentation
-### Maintenance
+* **layer:** update to 1.25.1
+* **parser:** APIGatewayProxyEvent to APIGatewayProxyEventModel ([#1061](https://github.com/aws-powertools/powertools-lambda-python/issues/1061))
-* **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))
-* **governance:** fix workflow action requirements & syntax
-* **governance:** add release label on pr merge
-* **governance:** auto-merge on all PR events
-* **governance:** enforce safe scope on pr merge labelling
-* **governance:** auto-merge workflow_dispatch off
-* **governance:** auto-merge to use squash
-* **governance:** limit build workflow to code changes only
-* **governance:** auto-merge mypy-stub dependabot
-* **governance:** check for related issue in new PRs
-* **governance:** address gh reusable workflow limitation
-* **governance:** warn message on closed issues
-* **metrics:** revert dimensions test before splitting ([#1243](https://github.com/awslabs/aws-lambda-powertools-python/issues/1243))
+## Maintenance
-## 1.26.1 - 2022-06-07
-### Bug Fixes
+* bump to 1.25.2
+* **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))
-* **metrics:** raise SchemaValidationError for >8 metric dimensions ([#1240](https://github.com/awslabs/aws-lambda-powertools-python/issues/1240))
-### Documentation
+<a name="v1.25.1"></a>
+## [v1.25.1] - 2022-02-14
+## Bug Fixes
-* **governance:** link roadmap and maintainers doc
-* **maintainers:** initial maintainers playbook ([#1222](https://github.com/awslabs/aws-lambda-powertools-python/issues/1222))
-* **roadmap:** use pinned pause issue instead
+* **batch:** bugfix to clear exceptions between executions ([#1022](https://github.com/aws-powertools/powertools-lambda-python/issues/1022))
+
+## Maintenance
-### Maintenance
+* bump to 1.25.1
+* **layers:** bump to 10 for 1.25.0
-* **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))
+<a name="v1.25.0"></a>
+## [v1.25.0] - 2022-02-09
+## Bug Fixes
-## 1.26.0 - 2022-05-20
+* **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/aws-powertools/powertools-lambda-python/issues/1001))
+* **logger:** test generates logfile
-### Bug Fixes
+## Documentation
-* **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))
+* 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/aws-powertools/powertools-lambda-python/issues/996))
+* **layer:** update to 1.24.2
+* **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))
-### Documentation
+## Features
-* **layer:** upgrade to 1.25.10
-* **roadmap:** add new roadmap section ([#1204](https://github.com/awslabs/aws-lambda-powertools-python/issues/1204))
+* **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))
-### Features
+## Maintenance
-* **parameters:** accept boto3_client to support private endpoints and ease testing ([#1096](https://github.com/awslabs/aws-lambda-powertools-python/issues/1096))
+* bump to 1.25.0
+* 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/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))
-### Maintenance
+## Pull Requests
-* **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))
+* Merge pull request [#971](https://github.com/aws-powertools/powertools-lambda-python/issues/971) from gyft/fix-logger-util-tests
-## 1.25.10 - 2022-04-29
-### Bug Fixes
+<a name="v1.24.2"></a>
+## [v1.24.2] - 2022-01-21
+## 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:** underscore support in api gateway authorizer resource name ([#969](https://github.com/aws-powertools/powertools-lambda-python/issues/969))
-### Documentation
+## Documentation
-* **layer:** upgrade to 1.25.9
+* **layer:** update to 1.24.1
-### Features
+## Maintenance
-* **parameters:** add clear_cache method for providers ([#1194](https://github.com/awslabs/aws-lambda-powertools-python/issues/1194))
+* bump to 1.24.2
-### Maintenance
-* **ci:** changelog pre-generation to fetch tags from origin
-* **ci:** post release on tagged issues too
-* **ci:** disable mergify configuration after breaking changes ([#1188](https://github.com/awslabs/aws-lambda-powertools-python/issues/1188))
-* **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-bugbear from 22.1.11 to 22.4.25 ([#1156](https://github.com/awslabs/aws-lambda-powertools-python/issues/1156))
-* **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 mkdocs-git-revision-date-plugin ([#1146](https://github.com/awslabs/aws-lambda-powertools-python/issues/1146))
-* **deps-dev:** bump mypy from 0.942 to 0.950 ([#1162](https://github.com/awslabs/aws-lambda-powertools-python/issues/1162))
-* **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))
+<a name="v1.24.1"></a>
+## [v1.24.1] - 2022-01-20
+## Bug Fixes
+
+* remove unused json import
+* remove apigw contract when using event-handler, apigw tracing
+* 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/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/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/aws-powertools/powertools-lambda-python/issues/959))
+* **quickstart:** expand on intro line
+* **quickstart:** tidy requirements up
+* **quickstart:** make section agnostic to json lib
+* **quickstart:** same process for Logger
+* **quickstart:** add sub-sections, fix highlight & code
+* **quickstart:** sentence fragmentation, tidy up
+* **tenets:** make core, non-core more explicit
+* **tracer:** warning to note on local traces
+* **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/aws-powertools/powertools-lambda-python/issues/963))
-### Regression
+## Features
-* **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))
+* **ci:** auto-notify & close issues on release
+* **logger:** clone powertools logger config to any Python logger ([#927](https://github.com/aws-powertools/powertools-lambda-python/issues/927))
-## 1.25.9 - 2022-04-21
+## Maintenance
-### Bug Fixes
+* bump to 1.24.1
+* bump to 1.24.1
+* **ci:** run codeql analysis on push only
+* **ci:** fix mergify dependabot queue
+* **ci:** add queue name in mergify
+* **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/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))
-* **deps**: correct py36 marker for jmespath
-## 1.25.8 - 2022-04-21
+## Regression
-### Bug Fixes
+* order to APP logger/service name due to screenshots
-* **governance:** 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))
-* **governance:** update label in names in issues
+## Pull Requests
-### Documentation
+* Merge pull request [#769](https://github.com/aws-powertools/powertools-lambda-python/issues/769) from mploski/docs/quick-start
-* **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))
-* **layer:** update to 1.25.7
-### Maintenance
+<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/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
-* **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))
+* 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/aws-powertools/powertools-lambda-python/issues/931))
-## 1.25.7 - 2022-04-08
+## Features
-### Bug Fixes
+* **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))
-* **idempotency:** pass by value on idem key to guard inadvertent 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))
+## Maintenance
-### Documentation
+* bump to 1.24.0
+* **deps-dev:** bump mypy from 0.920 to 0.930 ([#925](https://github.com/aws-powertools/powertools-lambda-python/issues/925))
-* **layer:** update to 1.25.6; cosmetic changes
-### Maintenance
+<a name="v1.23.0"></a>
+## [v1.23.0] - 2021-12-20
+## Bug Fixes
-* **governance:** refresh pull request template sections
-* **governance:** update external non-triage effort disclaimer
-* **governance:** update static typing to a form
-* **governance:** update rfc to a form
-* **governance:** update feat request to a form
-* **governance:** bug report form typo
-* **governance:** update docs report to a form
-* **governance:** update bug report to a form
-* **governance:** new ask a question
-* **governance:** new static typing report
+* **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))
-## 1.25.6 - 2022-04-01
+## Documentation
+
+* 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/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
-* **logger:** clear_state regression on absent standard keys like level, location, timestamp ([#1088](https://github.com/awslabs/aws-lambda-powertools-python/issues/1088))
+## Features
-## 1.25.5 - 2022-03-18
+* **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))
-### Bug Fixes
+## Maintenance
-* **logger-utils:** regression on exclude set leading to no formatter on append_keys ([#1080](https://github.com/awslabs/aws-lambda-powertools-python/issues/1080))
+* correct pr label order
+* 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/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
-## 1.25.4 - 2022-03-17
+* 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/aws-powertools/powertools-lambda-python/issues/820))
+
+## Code Refactoring
+
+* **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/aws-powertools/powertools-lambda-python/issues/775))
+* Idiomatic tenet updated to Progressive
+* 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/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/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
+
+* fix var expr
+* remove Lambda Layer version tag
+* bump to 1.22.0
+* 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/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/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/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/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/aws-powertools/powertools-lambda-python/issues/744))
+
+
+<a name="v1.21.0"></a>
+## [v1.21.0] - 2021-10-05
+## Bug Fixes
-### Bug Fixes
+* **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/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))
-* **logger-utils**: ensure external loggers doesn't propagate logs when copying config
+## Code Refactoring
-### Documentation
+* **data-classes:** clean up internal logic for APIGatewayAuthorizerResponse ([#643](https://github.com/aws-powertools/powertools-lambda-python/issues/643))
-* **appsync:** fix typo on `listLocations` return
-* **contributing:** pause new features/enhancements over operational excellence focus
+## Documentation
-## 1.25.3 - 2022-03-09
+* 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/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/aws-powertools/powertools-lambda-python/issues/735))
-### Bug Fixes
+## Features
-* **logger:** ensure state is cleared for custom formatters ([#1072](https://github.com/awslabs/aws-lambda-powertools-python/issues/1072))
+* 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/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))
-### Documentation
+## Maintenance
-* **plugin:** add mermaid to create diagram as code ([#1070](https://github.com/awslabs/aws-lambda-powertools-python/issues/1070))
+* 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/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
-## 1.25.2 - 2022-03-07
+* Fix issue with strip_prefixes ([#647](https://github.com/aws-powertools/powertools-lambda-python/issues/647))
-### Bug Fixes
+## Maintenance
-* **event_handler:** high-level import CorsConfig, docs snippets ([#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))
+* bump to 1.20.2
+* **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))
-### Documentation
-* **layer:** update to 1.25.1
-* **parser:** APIGatewayProxyEvent to APIGatewayProxyEventModel ([#1061](https://github.com/awslabs/aws-lambda-powertools-python/issues/1061))
+<a name="v1.20.1"></a>
+## [v1.20.1] - 2021-08-22
+## Bug Fixes
-### Maintenance
+* **idempotency:** sorting keys before hashing ([#639](https://github.com/aws-powertools/powertools-lambda-python/issues/639))
-* **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))
+## Maintenance
-## 1.25.1 - 2022-02-14
+* bump to 1.20.1
+* 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))
-### Bug Fixes
-**batch:** bugfix to clear exceptions between executions ([#1022](https://github.com/awslabs/aws-lambda-powertools-python/issues/1022))
+<a name="v1.20.0"></a>
+## [v1.20.0] - 2021-08-21
+## Bug Fixes
-## 1.25.0 - 2022-02-09
+* **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))
-### Bug Fixes
+## Code Refactoring
-* **apigateway:** remove indentation in debug_mode ([#987](https://github.com/awslabs/aws-lambda-powertools-python/issues/987))
-* **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:** test generates logfile
+* **event_handler:** match to match_results; 3.10 new keyword ([#616](https://github.com/aws-powertools/powertools-lambda-python/issues/616))
-### Documentation
+## Documentation
-* **event-handler:** improve testing section for graphql ([#996](https://github.com/awslabs/aws-lambda-powertools-python/issues/996))
-* **layer:** update to 1.24.2
-* **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))
-* **general:** fix syntax errors and line highlights ([#1004](https://github.com/awslabs/aws-lambda-powertools-python/pull/1004))
+* **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/aws-powertools/powertools-lambda-python/issues/630))
-### Features
+## 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))
+* **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
+## Maintenance
-* **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))
+* update changelog to reflect out-of-band commits
+* 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/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
-## 1.24.2 - 2022-01-21
+* **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))
-### Bug Fixes
+## Code Refactoring
-* **data-classes**: underscore support in api gateway authorizer resource name
+* **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))
-## 1.24.1 - 2022-01-20
+## Documentation
-### Bug Fixes
+* **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/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/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
-* **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))
+## Features
+
+* **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
+
+* only build docs on docs path
+* update pypi description, keywords
+* 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/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
-### Documentation
+* **api-gateway:** route regression non-word and unsafe URI chars ([#556](https://github.com/aws-powertools/powertools-lambda-python/issues/556))
-* rename quickstart to tutorial in readme
-* **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))
-* **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))
-* **quickstart:** expand on intro line
-* **quickstart:** tidy requirements up
-* **quickstart:** same process for Logger
-* **quickstart:** add sub-sections, fix highlight & code
-* **quickstart:** sentence fragmentation, tidy up
-* **quickstart:** make section agnostic to json lib
-* **tenets:** make core, non-core more explicit
-* **tracer:** update ServiceLens image w/ API GW, copywriting
-* **tracer:** warning to note on local traces
-* **tracer:** add initial image, requirements
-* **tracer:** add annotation, metadata, and image
+## Maintenance
-## 1.24.0 - 2021-12-31
+* bump 1.18.1
-### 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 in 3.12 ([#921](https://github.com/awslabs/aws-lambda-powertools-python/issues/921))
+<a name="v1.18.0"></a>
+## [v1.18.0] - 2021-07-20
+## Bug Fixes
-### Documentation
+* **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))
-* **general**: consistency round admonitions and snippets ([#919](https://github.com/awslabs/aws-lambda-powertools-python/issues/919))
-* **homepage**: Added GraphQL Sample API to Examples section of README.md ([#930](https://github.com/awslabs/aws-lambda-powertools-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))
+## Code Refactoring
-### Features
+* **feature-toggles:** Code coverage and housekeeping ([#530](https://github.com/aws-powertools/powertools-lambda-python/issues/530))
-* **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))
+## Documentation
-### Maintenance
+* **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))
-* **deps-dev:** bump mypy from 0.920 to 0.930 ([#925](https://github.com/awslabs/aws-lambda-powertools-python/issues/925))
+## Features
-## 1.23.0 - 2021-12-20
+* **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))
-### Bug Fixes
+## Maintenance
-* **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:** mypy appconfig transform and return types ([#877](https://github.com/awslabs/aws-lambda-powertools-python/issues/877))
-* **parser:** mypy 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))
+* 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
-### Documentation
-* **nav**: reference cloudformation custom resource helper (CRD) ([#914](https://github.com/awslabs/aws-lambda-powertools-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)
-* **lambda_layer:** fix CDK layer syntax
+<a name="v1.17.1"></a>
+## [v1.17.1] - 2021-07-02
+## Bug Fixes
-### Features
+* **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/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/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/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/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/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/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/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/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
-* **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))
-### Maintenance
+<a name="v1.16.1"></a>
+## [v1.16.1] - 2021-05-23
+## Features
-* minor housekeeping before release ([#912](https://github.com/awslabs/aws-lambda-powertools-python/issues/912))
-* correct pr label order
-* **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:** 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:** bump aws-xray-sdk from 2.8.0 to 2.9.0 ([#876](https://github.com/awslabs/aws-lambda-powertools-python/issues/876))
-* **deps-dev:** bump mypy from 0.910 to 0.920 ([#903](https://github.com/awslabs/aws-lambda-powertools-python/issues/903))
-* **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))
+* **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))
-## 1.22.0 - 2021-11-17
+## Maintenance
-Tenet update! We've updated **Idiomatic** tenet to **Progressive** to reflect the new Router feature in Event Handler, and more importantly the new wave of customers coming from SRE, Data Analysis, and Data Science background.
+* bump to 1.16.1
-* BEFORE: **Idiomatic**. Utilities follow programming language idioms and language-specific best practices.
-* AFTER: **Progressive**. Utilities are designed to be incrementally adoptable for customers at any stage of their Serverless journey. They follow language idioms and their community’s common practices.
-### Bug Fixes
-* **ci:** 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))
-* **ci:** skip sync master on docs hotfix
-* **parser:** body and query strings can be null or omitted in ApiGatewayProxyEventModel and ApiGatewayProxyEventV2Model ([#820](https://github.com/awslabs/aws-lambda-powertools-python/issues/820))
-
-### Code Refactoring
-
-* **apigateway:** Add BaseRouter and duplicate route check ([#757](https://github.com/awslabs/aws-lambda-powertools-python/issues/757))
-
-### Documentation
-
-* **docs:** updated Lambda Layers definition & limitations. ([#775](https://github.com/awslabs/aws-lambda-powertools-python/issues/775))
-* **docs:** Idiomatic tenet updated to Progressive
-* **docs:** use higher contrast font to improve accessibility ([#822](https://github.com/awslabs/aws-lambda-powertools-python/issues/822))
-* **docs:** fix indentation of SAM snippets in install section ([#778](https://github.com/awslabs/aws-lambda-powertools-python/issues/778))
-* **docs:** improve public lambda layer wording, add clipboard buttons to improve UX ([#762](https://github.com/awslabs/aws-lambda-powertools-python/issues/762))
-* **docs:** add amplify-cli instructions for public layer ([#754](https://github.com/awslabs/aws-lambda-powertools-python/issues/754))
-* **api-gateway:** add new router feature to allow route splitting in API Gateway and ALB ([#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 to allow GraphQL Resolver composition ([#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))
-* **docs:** remove Lambda Layer version tag
-### 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))
-
-### Maintenance
-
-* **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.58 to 1.18.59 ([#760](https://github.com/awslabs/aws-lambda-powertools-python/issues/760))
-* **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.18.61 to 1.19.6 ([#783](https://github.com/awslabs/aws-lambda-powertools-python/issues/783))
-* **deps:** bump boto3 from 1.18.56 to 1.18.58 ([#755](https://github.com/awslabs/aws-lambda-powertools-python/issues/755))
-* **deps:** bump boto3 from 1.18.59 to 1.18.61 ([#766](https://github.com/awslabs/aws-lambda-powertools-python/issues/766))
-* **deps:** bump boto3 from 1.20.3 to 1.20.5 ([#817](https://github.com/awslabs/aws-lambda-powertools-python/issues/817))
-* **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-comprehensions from 3.6.1 to 3.7.0 ([#759](https://github.com/awslabs/aws-lambda-powertools-python/issues/759))
-* **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 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.3 to 7.3.5 ([#781](https://github.com/awslabs/aws-lambda-powertools-python/issues/781))
-* **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 mkdocs-material from 7.3.2 to 7.3.3 ([#758](https://github.com/awslabs/aws-lambda-powertools-python/issues/758))
-
-## 1.21.1 - 2021-10-07
-
-### Regression
-
-* **metrics:** typing regression on log_metrics callable ([#744](https://github.com/awslabs/aws-lambda-powertools-python/issues/744))
-
-### Documentation
-
-* add new public layer ARNs ([#746](https://github.com/awslabs/aws-lambda-powertools-python/issues/746))
-### Maintenance
-
-* ignore constants in test cov ([#745](https://github.com/awslabs/aws-lambda-powertools-python/issues/745))
-* github-actions: 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))
-
-## 1.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))
-* **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))
+<a name="v1.16.0"></a>
+## [v1.16.0] - 2021-05-17
+## Features
-### Code Refactoring
+* **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))
-* **data-classes:** clean up internal logic for APIGatewayAuthorizerResponse ([#643](https://github.com/awslabs/aws-lambda-powertools-python/issues/643))
+## Maintenance
-### Documentation
+* bump to 1.16.0
-* Terraform reference for SAR Lambda Layer ([#716](https://github.com/awslabs/aws-lambda-powertools-python/issues/716))
-* **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))
-* **jmespath:** clarify envelope terminology
-* **parser:** fix incorrect import in root_validator example ([#735](https://github.com/awslabs/aws-lambda-powertools-python/issues/735))
-### Features
+<a name="v1.15.1"></a>
+## [v1.15.1] - 2021-05-13
+## Bug Fixes
-* expose jmespath powertools functions ([#736](https://github.com/awslabs/aws-lambda-powertools-python/issues/736))
-* boto3 sessions in batch, parameters & idempotency ([#717](https://github.com/awslabs/aws-lambda-powertools-python/issues/717))
-* **feature-flags**: add get_raw_configuration property in store; expose store ([#720](https://github.com/awslabs/aws-lambda-powertools-python/issues/720))
-* **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))
+* **docs:** Use updated names for ProxyEventType ([#424](https://github.com/aws-powertools/powertools-lambda-python/issues/424))
-### Maintenance
+## Documentation
-* add python 3.9 support
-* **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.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.49 to 1.18.51 ([#713](https://github.com/awslabs/aws-lambda-powertools-python/issues/713))
-* **deps:** bump boto3 from 1.18.41 to 1.18.49 ([#703](https://github.com/awslabs/aws-lambda-powertools-python/issues/703))
-* **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 coverage from 5.5 to 6.0 ([#732](https://github.com/awslabs/aws-lambda-powertools-python/issues/732))
-* **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 flake8-bugbear from 21.9.1 to 21.9.2 ([#712](https://github.com/awslabs/aws-lambda-powertools-python/issues/712))
-* **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 mkdocs-material from 7.3.0 to 7.3.1 ([#731](https://github.com/awslabs/aws-lambda-powertools-python/issues/731))
-* **deps-dev:** bump xenon from 0.7.3 to 0.8.0 ([#669](https://github.com/awslabs/aws-lambda-powertools-python/issues/669))
+* update list of features
+* **event_handler:** add missing note on trimmed responses
-### Bug Fixes
+## Maintenance
-* **event-handler:** fix issue with strip_prefixes and root level resolvers ([#646](https://github.com/awslabs/aws-lambda-powertools-python/issues/646))
+* bump to 1.15.1
-### Maintenance
-* **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))
-* **deps-dev:** bump mike from 0.6.0 to 1.0.1 ([#453](https://github.com/awslabs/aws-lambda-powertools-python/issues/453))
-* **license:** add third party license to pyproject.toml ([#641](https://github.com/awslabs/aws-lambda-powertools-python/issues/641))
-## 1.20.2 - 2021-09-02
+<a name="v1.15.0"></a>
+## [v1.15.0] - 2021-05-06
+## Bug Fixes
-### Bug Fixes
+* **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))
-* **event-handler:** fix issue with strip_prefixes and root level resolvers ([#646](https://github.com/awslabs/aws-lambda-powertools-python/issues/646))
+## Code Refactoring
-### Maintenance
+* 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))
-* **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))
-* **deps-dev:** bump mike from 0.6.0 to 1.0.1 ([#453](https://github.com/awslabs/aws-lambda-powertools-python/issues/453))
-* **license:** add third party license to pyproject.toml ([#641](https://github.com/awslabs/aws-lambda-powertools-python/issues/641))
+## Documentation
-## 1.20.1 - 2021-08-22
+* **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/aws-powertools/powertools-lambda-python/issues/415))
+* **parser:** fix table and heading syntax
+* **tracer:** Fix line highlighting ([#395](https://github.com/aws-powertools/powertools-lambda-python/issues/395))
-### Bug Fixes
+## Features
-* **idempotency:** sorting keys before hashing ([#639](https://github.com/awslabs/aws-lambda-powertools-python/issues/639))
+* 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
+## Maintenance
-* 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))
+* bump to 1.15.0 ([#422](https://github.com/aws-powertools/powertools-lambda-python/issues/422))
-## 1.20.0 - 2021-08-21
+<a name="v1.14.0"></a>
+## [v1.14.0] - 2021-04-09
## Bug Fixes
-* **api-gateway:** HTTP API strip stage name from request path ([#622](https://github.com/awslabs/aws-lambda-powertools-python/issues/622))
+* perf tests for Logger and fail str msgs
+* 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/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/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/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/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
+
+* bump to 1.14.0
+* add approved by field in RFC template
+* make RFC proposal more explicit
+* update automated steps in release process
+
+
+<a name="v1.13.0"></a>
+## [v1.13.0] - 2021-03-23
+## Bug Fixes
-### Code Refactoring
+* **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))
-* **event-handler:** match to match_results; 3.10 new keyword ([#616](https://github.com/awslabs/aws-lambda-powertools-python/issues/616))
+## Features
-### Documentation
+* **data-classes:** Add S3 Object Lambda Event ([#353](https://github.com/aws-powertools/powertools-lambda-python/issues/353))
-* **data-classes:** make authorizer concise; use enum ([#630](https://github.com/awslabs/aws-lambda-powertools-python/issues/630))
-* **feature-flags:** correct link and json examples ([#605](https://github.com/awslabs/aws-lambda-powertools-python/issues/605))
-* **data-class:** fix invalid syntax in new AppSync Authorizer
-* **api-gateway:** add new API mapping support
+## Maintenance
-### Features
+* include internals in release template
+* bump to 1.13.0
+* correct 3rd party license
-* **data-classes:** authorizer for API Gateway HTTP and REST API ([#620](https://github.com/awslabs/aws-lambda-powertools-python/issues/620))
-* **data-classes:** new data_as_bytes property in 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 domain mapping paths ([#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))
-### Maintenance
+<a name="v1.12.0"></a>
+## [v1.12.0] - 2021-03-17
+## Bug Fixes
-* **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.17 to 1.18.21 ([#608](https://github.com/awslabs/aws-lambda-powertools-python/issues/608))
-* **deps:** bump boto3 from 1.18.21 to 1.18.22 ([#614](https://github.com/awslabs/aws-lambda-powertools-python/issues/614))
-* **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 flake8-comprehensions from 3.6.0 to 3.6.1 ([#615](https://github.com/awslabs/aws-lambda-powertools-python/issues/615))
-* **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))
+* **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))
-## 1.19.0 - 2021-08-11
+## Code Refactoring
-### Bug Fixes
+* **parameters:** Consistently reference env ([#319](https://github.com/aws-powertools/powertools-lambda-python/issues/319))
-* **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))
-* **parser:** API Gateway WebSocket validation under check_message_id; plus some housekeeping ([#553](https://github.com/awslabs/aws-lambda-powertools-python/issues/553))
-* **feature-toggles:** correct cdk example ([#601](https://github.com/awslabs/aws-lambda-powertools-python/issues/601))
+## Documentation
-### Code Refactoring
+* 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/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))
-* **feature-flags:** add debug statements for all feature evaluations ([#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))
+## Features
-### Documentation
+* **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))
-* **event-handler:** new custom serializer option
-* **feature-flags:** create concrete documentation ([#594](https://github.com/awslabs/aws-lambda-powertools-python/issues/594))
-* **feature-flags:** correct docs and typing ([#588](https://github.com/awslabs/aws-lambda-powertools-python/issues/588))
-* **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))
-* **tracer:** update wording that it auto-disables on non-Lambda env
-* **feature-flags:** fix SAM infra, convert CDK to Python
-* **feature-flags:** fix sample feature name in evaluate method
-* **feature-flags:** add guidance when to use vs env vars vs parameters
-### Features
+## Maintenance
-* **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 params `max_age`, `raise_on_transform_error` to high level functions ([#567](https://github.com/awslabs/aws-lambda-powertools-python/issues/567))
-* **tracer:** auto-disable tracer for non-Lambda environments to ease testing ([#598](https://github.com/awslabs/aws-lambda-powertools-python/issues/598))
+* bump to 1.12.0
+* remove auto-label as restrictions prevent it from working
+* increase perf SLA due to slow GitHub Actions machine
+* add PR size labelling action # 2
+* add PR size labelling action
+* add PR auto-label action
+* remove gatsby mention as migrated completed
-### Maintenance
-* **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:** bump boto3 from 1.18.15 to 1.18.17 ([#597](https://github.com/awslabs/aws-lambda-powertools-python/issues/597))
-* **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 mkdocs-material from 7.2.1 to 7.2.2 ([#582](https://github.com/awslabs/aws-lambda-powertools-python/issues/582))
-* **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))
-## 1.18.1 - 2021-07-23
-
-### Bug Fixes
-
-* **api-gateway:** route regression for non-word and unsafe URI chars ([#556](https://github.com/awslabs/aws-lambda-powertools-python/issues/556))
-
-## 1.18.0 - 2021-07-20
-
-### Bug Fixes
-
-* **api-gateway:** non-greedy route pattern regex which incorrectly mapped certain route params to function params ([#533](https://github.com/awslabs/aws-lambda-powertools-python/issues/533))
-* **api-gateway:** incorrect plain text mimetype constant [#506](https://github.com/awslabs/aws-lambda-powertools-python/issues/506)
-* **data-classes:** include milliseconds in scalar types to correctly align with AppSync scalars ([#504](https://github.com/awslabs/aws-lambda-powertools-python/issues/504))
-* **mypy:** addresses lack of optional types ([#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))
-
-### Code Refactoring
-
-* **feature-toggles:** code coverage and housekeeping ([#530](https://github.com/awslabs/aws-lambda-powertools-python/issues/530))
-
-### Documentation
-
-* **api-gateway:** new HTTP service error exceptions ([#546](https://github.com/awslabs/aws-lambda-powertools-python/issues/546))
-* **logger:** new get_correlation_id method ([#545](https://github.com/awslabs/aws-lambda-powertools-python/issues/545))
-
-### Features
-
-* **api-gateway:** add debug mode ([#507](https://github.com/awslabs/aws-lambda-powertools-python/issues/507))
-* **api-gateway:** add common HTTP 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))
-
-### Maintenance
-
-* **mypy:** add mypy support to makefile ([#508](https://github.com/awslabs/aws-lambda-powertools-python/issues/508))
-* **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))
-* **event-handler:** adjusts API Gateway/ALB service errors exception docstrings to not confuse AppSync customers
-
-## 1.17.1 - 2021-07-02
-
-### Bug Fixes
-
-* **Validator:** Handle built-in custom formats like `date-time` when type is `string` ([#498](https://github.com/awslabs/aws-lambda-powertools-python/issues/498))
-
-### Documentation
-
-* **Layers:** Add Layers example for Serverless framework & CDK ([#500](https://github.com/awslabs/aws-lambda-powertools-python/issues/500))
-* **Misc.:** Enable dark mode switch ([#471](https://github.com/awslabs/aws-lambda-powertools-python/issues/471))
-* **Tracer:** Additional scenario when to disable auto-capture for responses larger than 64K ([#499](https://github.com/awslabs/aws-lambda-powertools-python/issues/499))
-
-### Maintenance
-
-* **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))
-
-## 1.17.0 - 2021-06-08
-
-### Added
-
-* **Documentation**: Include new public roadmap ([#452](https://github.com/awslabs/aws-lambda-powertools-python/issues/452))
-* **Documentation**: Remove old todo in idempotency docs
-* **Data classes:** New `AttributeValueType` to get type and value from data in `DynamoDBStreamEvent` ([#462](https://github.com/awslabs/aws-lambda-powertools-python/issues/462))
-* **Data classes:** New decorator `event_source` to instantiate data_classes ([#442](https://github.com/awslabs/aws-lambda-powertools-python/issues/442))
-* **Logger:** New `clear_state` parameter to clear previously added custom keys upon invocation ([#467](https://github.com/awslabs/aws-lambda-powertools-python/issues/467))
-* **Parser:** 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))
-
-### Maintenance
-
-* **deps**: bump xenon from 0.7.1 to 0.7.3 ([#446](https://github.com/awslabs/aws-lambda-powertools-python/issues/446))
-* 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))
-* **deps**: bump mkdocs-material from 7.1.5 to 7.1.6 ([#451](https://github.com/awslabs/aws-lambda-powertools-python/issues/451))
-* **deps**: 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))
-* **deps**: bump actions/setup-python from 1 to 2.2.2 ([#445](https://github.com/awslabs/aws-lambda-powertools-python/issues/445))
-* **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))
-* **mergify:** disable check for matrix jobs
-* **mergify:** use job name to match GH Actions
+<a name="v1.11.0"></a>
+## [v1.11.0] - 2021-03-05
+## Bug Fixes
+
+* 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/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/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/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/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
+* attempt 1 to fix PR labeler
+
+
+<a name="v1.10.5"></a>
+## [v1.10.5] - 2021-02-17
+## Maintenance
+
+* version bump to 1.10.5 ([#292](https://github.com/aws-powertools/powertools-lambda-python/issues/292))
+
+
+<a name="v1.10.4"></a>
+## [v1.10.4] - 2021-02-17
+## Bug Fixes
+
+* sync features in main page
+* meta tags, and ext link to open in new tab
+
+## Documentation
+
+* **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/aws-powertools/powertools-lambda-python/issues/291))
+* add default runtime key
+* 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
+
+## Regression
+
+* search input size
+
+
+<a name="v1.10.3"></a>
+## [v1.10.3] - 2021-02-12
+## Bug Fixes
+
+* 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/aws-powertools/powertools-lambda-python/issues/279))
+
+## Maintenance
+
+* 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/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/aws-powertools/powertools-lambda-python/issues/271))
+
+## Maintenance
+
+* 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
+
+
+<a name="v1.10.1"></a>
+## [v1.10.1] - 2021-01-19
+## Features
+
+* 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/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/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/aws-powertools/powertools-lambda-python/issues/254))
+
+## Features
+
+* 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/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/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>
+## [v1.9.1] - 2020-12-21
+## Bug Fixes
+
+* ensures all Loggers have unique service names
+
+## Code Refactoring
+
+* convert dict into a literal dict object and re-use it
+
+## Documentation
+
+* add clarification to Tracer docs for how `capture_method` decorator can cause function responses to be read and serialized.
+
+## Features
-## 1.16.1 - 2021-05-23
+* **pep-561:** Create py.typed file and include into pyproject.
-### Fixed
+## Maintenance
-* **Parser**: Upgrade Pydantic to 1.8.2 due to CVE-2021-29510
+* 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
-## 1.16.0 - 2021-05-17
-### Features
-- **data-classes(API Gateway, ALB):** New method to decode base64 encoded body ([#425](https://github.com/awslabs/aws-lambda-powertools-python/issues/425))
-- **data-classes(CodePipeline):** Support for CodePipeline job event and methods to handle artifacts more easily ([#416](https://github.com/awslabs/aws-lambda-powertools-python/issues/416))
+## Pull Requests
-## 1.15.1 - 2021-05-13
+* 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
-### Fixed
-* **Logger**: Fix a regression with the `%s` operator
+<a name="v1.9.0"></a>
+## [v1.9.0] - 2020-12-04
+## Bug Fixes
+
+* s3 model import
+* cloudwatch logs envelope typo
+
+## Documentation
+
+* add Kinesis Streams as a supported model & envelope
+* add S3 as a supported model
+* add CW Logs as a supported envelope
+* add CW Logs as a supported model
+* add Alb as a supported model
+* shadow sidebar to remain expanded
+* add source code link in nav bar
+* fix broken link for github
+
+## Features
+
+* 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/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/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
+
+
+## Pull Requests
+
+* 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>
+## [v1.8.0] - 2020-11-20
+## Bug Fixes
+
+* replace now deprecated set-env with new GitHub Env file
+* remove dummy heading to prevent htmlAst bug
+
+## Documentation
+
+* correct example usage of SES data class
+* add faq section
+* add minimal permission set for using layer
+
+## Features
+
+* include new replay-name field in parser and data_classes
+* **data_classes:** API Gateway V2 IAM and Lambda
+
+## Maintenance
+
+* bump to 1.8.0
+* bump dependencies
+* **docs:** Add some of the missing docstrings
+
+## Pull Requests
+
+* 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>
+## [v1.7.0] - 2020-10-26
+## Bug Fixes
+
+* _parse return type
+* high and security peer dependency vulnerabilities
+* change to Yarn to support manual resolutions
+* generic type to match ABC bound class
+* debug logging in envelopes before each parsing
+* remove malformed 3.1. sentence
+* ensures parser can take json strings as input
+* parse high level import
+* code inspect issues
+* unnecessary return; better error handling
+* snake_case
+* 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
+* add only pydantic (+1 squashed commit) Squashed commits: [804f251] fix poetry.lock, revert changes
+* Correct typo
+* remove only dev extras
+* remove jmespath extras in Make
+
+## Code Refactoring
+
+* pydantic as optional dependancy, remove lambdaContext
+* change to advanced parser
+
+## Documentation
+
+* reorder parser's payload sample position
+* 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
+* reorder extending models as parse fn wasn't introduced
+* use yarn's resolution to fix incompatible dependency
+* add cold start data
+* add a FAQ section
+* ensure examples can be copied/pasted as-is
+* add extending built-in models
+* add envelope section
+* add data model validation section
+* use non-hello world model to better exemplify parsing
+* add 101 parsing events content
+* initial structure for parser docs
+* initial sketch of parser docs
+* update examples in README
+
+## Features
+
+* experiment with codeQL over LGTM
+* add standalone parse function
+* Advanced parser utility (pydantic)
+* 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
+* spacing
+* typo in list
+* typo on code generation tool
+* remove flake8 polyfill as explicit dep
+* explicit DynamoDB Stream schema naming
+* lint
+* kwarg over arg to ease refactoring
+* remove test for commented code
+* fix make build syntax for internal build whl
+* upgrade docs dep
+* remove dev deps from example project
+* remove kitchen sink example
+* upgrade gatsby
+* upgrade amplify, antd, and gatsby plugins
+* upgrade apollo-docs theme
+* remove dev deps from example project
+* remove kitchen sink example
+
+## Reverts
+* fix: remove jmespath extras in Make
+* fix: remove jmespath extras in Make
+
+## Pull Requests
+
+* 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/aws-powertools/powertools-lambda-python/issues/177))
+
+
+<a name="v1.6.0"></a>
+## [v1.6.0] - 2020-09-22
+## Bug Fixes
+
+* apply Tom's suggestion
+* branding
+* 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/aws-powertools/powertools-lambda-python/issues/170))
+* correct type hint Dict instead of dict
+
+## Code Refactoring
+
+* correct type hint
+
+## Documentation
+
+* fixed more typos, correct index reference to new util
+* fix typo in DynamoDB example
+* add docs for data classes utility
+* improve wording on jmespath fns
+* document validator utility
-## 1.15.0 - 2021-05-06
+## Features
-### Added
+* add custom jmespath functions support
+* 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/aws-powertools/powertools-lambda-python/issues/159))
-* **Event handlers**: New API Gateway and ALB utility to reduce routing boilerplate and more
-* **Documentation**: Logger enhancements such as bring your own formatter, handler, UTC support, and testing for Python 3.6
-* **Parser**: Support for API Gateway REST Proxy event and envelope
-* **Logger**: Support for bringing custom formatter, custom handler, custom JSON serializer and deserializer, UTC support, expose `LambdaPowertoolsFormatter`
-* **Metrics**: Support for persisting default dimensions that should always be added
+## Maintenance
-### Fixed
+* typo
+* bump to 1.6.0
+* better type hinting
+* update changelog
+* fix docstring; import order
-* **Documentation**: Fix highlights, Parser types
-* **Validator**: Fix event type annotations for `validate` standalone function
-* **Parser**: Improve and fix types
-* **Internal**: Remove X-Ray SDK version pinning as serialization regression has been fixed in 2.8.0
-* **Internal**: Latest documentation correctly includes a copy of API docs reference
+## Pull Requests
-## 1.14.0 - 2021-04-09
+* 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>
+## [v1.5.0] - 2020-09-04
+## Bug Fixes
+
+* throw exception by default if messages processing fails
+* add sqs_batch_processor as its own method
+* ensure debug log event has latest ctx
+* update image with correct sample
+* ensures xray_trace_id is refreshed
+* 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/aws-powertools/powertools-lambda-python/issues/132))
+
+## Code Refactoring
+
+* changes partial_sqs middleware in favor of a generic interface always expecting a BatchProcessor
+* replace LambdaEvent with Dict[str, Any]
+* remove initial reference
+* fix import issues and provide context in docblocks
+* split properties and add docblocks
+* split the objects into seperate files
+* make requested changes
+* use None instead of
+* batch middleware
+* remove references to BaseProcessor. Left BasePartialProcessor
+* change return for failure/success handlers
+* **sqs:** add module middlewares
+* **sqs:** change methods to protected
+* **tests:** update tests to new batch processor middleware
+* **tests:** processor using default config
+
+## Documentation
+
+* address readability feedbacks
+* add detail to batch processing
+* simplify documentation more SQS specific focus Update for sqs_batch_processor interface
+* rephrase the wording to make it more clear
+* refactor example; improve docs about creating your own processor
+* add newly created Slack Channel
+* describe the typing utility
+* 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/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/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/aws-powertools/powertools-lambda-python/issues/137)
+* initial implementation as the proposed gist is
+* add sqs failure processors
+* include base processors
+* add batch module
+* add package level import for batch utility
+* **logger:** readable log_dict seq
+* **logging:** suppress some log keys
+* **logging:** allow for custom json order
+* **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
+
+* 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/aws-powertools/powertools-lambda-python/issues/154))
+* doc typo
+* **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/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>
+## [v1.4.0] - 2020-08-25
+## Bug Fixes
+
+* upgrade dot-prop, serialize-javascript
+* remove actual response from debug logs
+* naming and staticmethod consistency
+* correct in_subsegment assertion
+* 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
+
+* add Lambda Layer SAR App url and ARN
+* move tenets; remove extra space
+* use table for clarity
+* add blog post, and quick example
+* subtle rewording for better clarity
+* fix typos, log_event & sampling wording
+* make sensitive info more explicit with an example
+* create Patching modules section; cleanup response wording
+* move concurrent asynchronous under escape hatch
+* grammar
+* bring new feature upfront when returning sensitive info
+
+## Features
+
+* capture_response as metadata option [#127](https://github.com/aws-powertools/powertools-lambda-python/issues/127)
+
+## Maintenance
+
+* bump to 1.4.0
+* update internal docstrings for consistency
+* update changelog to reflect new feature
+* clarify changelog bugfix vs breaking change
+* remove/correct unnecessary debug logs
+* fix debug log adding unused obj
+* grammar
+* add metrics fix description
+* correct typos
+
+## Pull Requests
+
+* 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/aws-powertools/powertools-lambda-python/issues/124))
+
+## Maintenance
+
+* version bump to 1.3.1
+* **deps:** bump prismjs from 1.20.0 to 1.21.0 in /docs
+* **deps:** bump elliptic from 6.5.2 to 6.5.3 in /docs
+
+## Pull Requests
+
+* 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/aws-powertools/powertools-lambda-python/issues/96))
+
+## Maintenance
-### Added
-* **Event handlers**: New core utility to easily handle incoming requests tightly integrated with Data Classes; AppSync being the first as we gauge from the community what additional ones would be helpful
-* **Documentation**: Enabled versioning to access docs on a per release basis or staging docs (`develop` branch)
-* **Documentation**: Links now open in a new tab and improved snippet line highlights
-* **Documentation(validation)**: JSON Schema snippets and more complete examples
-* **Documentation(idempotency)**: Table with expected configuration values for hash key and TTL attribute name when using the default behaviour
-* **Documentation(logger)**: New example on how to set logging record timestamps in UTC
-* **Parser(S3)**: Support for the new S3 Object Lambda Event model (`S3ObjectLambdaEvent`)
-* **Parameters**: Support for DynamoDB Local via `endpoint_url` parameter, including docs
-* **Internal**: Include `make pr` in pre-commit hooks when contributing to shorten feedback loop on pre-commit specific linting
-### Fixed
+<a name="v1.2.0"></a>
+## [v1.2.0] - 2020-08-20
+## Features
-* **Parser**: S3Model now supports keys with 0 length
-* **Tracer**: Lock X-Ray SDK to 2.6.0 as there's been a regression upstream in 2.7.0 on serializing & capturing exceptions
-* **Data Classes(API Gateway)**: Add missing property `operationName` within request context
-* **Misc.**: Numerous typing fixes to better to support MyPy across all utilities
-* **Internal**: Downgraded poetry to 1.1.4 as there's been a regression with `importlib-metadata` in 1.1.5 not yet fixed
+* add support for tracing of generators using capture_method decorator ([#113](https://github.com/aws-powertools/powertools-lambda-python/issues/113))
-## 1.13.0 - 2021-03-23
+## Maintenance
-### Added
-* **Data Classes**: New S3 Object Lambda event
-### Fixed
+<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/aws-powertools/powertools-lambda-python/issues/115)
+
+## Maintenance
+
+* bump to 1.1.3
+
+## Pull Requests
+
+* 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/aws-powertools/powertools-lambda-python/issues/107)
-* **Docs**: Lambda Layer SAM template reference example
+## Documentation
-## 1.12.0 - 2021-03-17
+* clarify auto_patch as per [#108](https://github.com/aws-powertools/powertools-lambda-python/issues/108)
-### Added
+## Maintenance
-* **Parameters**: New `force_fetch` param to always fetch the latest and bypass cache, if available
-* **Data Classes**: New AppSync Lambda Resolver event covering both Direct Lambda Resolver and Amplify GraphQL Transformer Resolver `@function`
-* **Data Classes**: New AppSync scalar utilities to easily compose Lambda Resolvers with date utils, uuid, etc.
-* **Logger**: Support for Correlation ID both in `inject_lambda_context` decorator and `set_correlation_id` method
-* **Logger**: Include new `exception_name` key to help customers easily enumerate exceptions across all functions
+* suppress LGTM alert
+* add autocomplete as unreleased
+* remove unused stdout fixture
+* update Tracer docs as per [#108](https://github.com/aws-powertools/powertools-lambda-python/issues/108)
-### Fixed
+## Pull Requests
-* **Tracer**: Type hint on return instance that made PyCharm no longer recognize autocompletion
-* **Idempotency**: Error handling for missing idempotency key and `save_in_progress` errors
+* 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
-## 1.11.0 - 2021-03-05
-### Fixed
-* **Tracer**: Lazy loads X-Ray SDK to increase perf by 75% for those not instantiating Tracer
-* **Metrics**: Optimize validation and serialization to increase perf by nearly 50% for large operations (<1ms)
+<a name="v1.1.1"></a>
+## [v1.1.1] - 2020-08-14
+## Bug Fixes
-### Added
+* regression 104 ([#105](https://github.com/aws-powertools/powertools-lambda-python/issues/105))
+* return log level int immediately
+* add test covering logging constant
-* **Dataclass**: Add new Amazon Connect contact flow event
-* **Idempotency**: New Idempotency utility
-* **Docs**: Add example on how to integrate Batch utility with Sentry.io
-* **Internal**: Added performance SLA tests for high level imports and Metrics validation/serialization
+## Maintenance
-## 1.10.5 - 2021-02-17
+* bump patch version
+* fix unused fixture
+* fix docstring on level [str,int] consistency
+* fix test level typo
+* 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
-No changes. Bumped version to trigger new pipeline build for layer publishing.
+## Regression
-## 1.10.4 - 2021-02-17
+* log level docstring as str
-### Fixed
+## Pull Requests
-* **Docs**: Fix anchor tags to be lower case
-* **Docs**: Correct the docs location for the labeller
+* Merge pull request [#106](https://github.com/aws-powertools/powertools-lambda-python/issues/106) from heitorlessa/fix/regression-104
-## 1.10.3 - 2021-02-04
-### Added
+<a name="v1.1.0"></a>
+## [v1.1.0] - 2020-08-14
+## Bug Fixes
-* **Docs**: Migrated from Gatsby to MKdocs documentation system
-* **Docs**: Included Getting started and Advanced sections in Core utilities, including additional examples
+* auto-assigner filename as per docs
-### Fixed
+## Features
-* **Tracer**: Disabled batching segments as X-Ray SDK does not flush traces upon reaching limits
-* **Parser**: Model type is now compliant with mypy
+* add support for logger inheritance ([#99](https://github.com/aws-powertools/powertools-lambda-python/issues/99))
+* enable issue auto-assigner to core team
-## 1.10.2 - 2021-02-04
+## Maintenance
-### Fixed
+* 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))
-* **Utilities**: Correctly handle and list multiple exceptions in SQS batch processing utility.
-* **Docs*:: Fix typos on AppConfig docstring import, and `SnsModel` typo in parser.
-* **Utilities**: `typing_extensions` package is now only installed in Python < 3.8
-## 1.10.1 - 2021-01-19
+<a name="v1.0.2"></a>
+## [v1.0.2] - 2020-07-16
+## Maintenance
-### Fixed
+* 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))
-* **Utilities**: Added `SnsSqsEnvelope` in `parser` to dynamically adjust model mismatch when customers use SNS + SQS instead of SNS + Lambda, since we've discovered three payload keys are slightly different.
-## 1.10.0 - 2021-01-18
+<a name="v1.0.1"></a>
+## [v1.0.1] - 2020-07-05
+## Bug Fixes
-### Added
-- **Utilities**: Added support for AppConfig in Parameters utility
-- **Logger**: Added support for `extra` parameter to add additional root fields when logging messages
-- **Logger**: Added support to Pytest Live Log feat. via feature toggle `POWERTOOLS_LOG_DEDUPLICATION_DISABLED`
-- **Tracer**: Added support to disable auto-capturing response and exception as metadata
-- **Utilities**: Added support to handle custom string/integer formats in JSON Schema in Validator utility
-- **Install**: Added new Lambda Layer with all extra dependencies installed, available in Serverless Application Repository (SAR)
+* append structured logs when injecting lambda context ([#86](https://github.com/aws-powertools/powertools-lambda-python/issues/86))
-### Fixed
+## Documentation
-- **Docs**: Added missing SNS parser model
-- **Docs**: Added new environment variables for toggling features in Logger and Tracer: `POWERTOOLS_LOG_DEDUPLICATION_DISABLED`, `POWERTOOLS_TRACER_CAPTURE_RESPONSE`, `POWERTOOLS_TRACER_CAPTURE_ERROR`
-- **Docs**: Fixed incorrect import for Cognito data classes in Event Sources utility
+* add blog post in the readme
-## 1.9.1 - 2020-12-21
-### Fixed
-- **Logger**: Bugfix to prevent parent loggers with the same name being configured more than once
+<a name="v1.0.0"></a>
+## [v1.0.0] - 2020-06-18
+## Documentation
-### Added
-- **Docs**: Add clarification to Tracer docs for how `capture_method` decorator can cause function responses to be read and serialized.
-- **Utilities**: Added equality to ease testing Event source data classes
-- **Package**: Added `py.typed` for initial work needed for PEP 561 compliance
+* customize contributing guide ([#77](https://github.com/aws-powertools/powertools-lambda-python/issues/77))
-## 1.9.0 - 2020-12-04
+## Features
-### Added
-- **Utilities**: Added Kinesis, S3, CloudWatch Logs, Application Load Balancer, and SES support in `Parser`
-- **Docs**: Sidebar menu are now always expanded
+* 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))
-### Fixed
-- **Docs**: Broken link to GitHub to homepage
+## Maintenance
-## 1.8.0 - 2020-11-20
+* 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/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
-### Added
-- **Utilities**: Added support for new EventBridge Replay field in `Parser` and `Event source data classes`
-- **Utilities**: Added SNS support in `Parser`
-- **Utilities**: Added API Gateway HTTP API data class support for new IAM and Lambda authorizer in `Event source data classes`
-- **Docs**: Add new FAQ section for Logger on how to enable debug logging for boto3
-- **Docs**: Add explicit minimal set of permissions required to use Layers provided by Serverless Application Repository (SAR)
-### Fixed
-- **Docs**: Fix typo in Dataclasses example for SES when fetching common email headers
+<a name="v0.11.0"></a>
+## [v0.11.0] - 2020-06-10
+## Bug Fixes
-## 1.7.0 - 2020-10-26
+* 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))
-### Added
-- **Utilities**: Add new `Parser` utility to provide parsing and deep data validation using Pydantic Models
-- **Utilities**: Add case insensitive header lookup, and Cognito custom auth triggers to `Event source data classes`
+## Maintenance
-### Fixed
-- **Logger**: keeps Lambda root logger handler, and add log filter instead to prevent child log records duplication
-- **Docs**: Improve wording on adding log keys conditionally
+* update CHANGELOG
-## 1.6.1 - 2020-09-23
-### Fixed
-- **Utilities**: Fix issue with boolean values in DynamoDB stream event data class.
+<a name="v0.10.1"></a>
+## [v0.10.1] - 2020-06-10
+## Bug Fixes
-## 1.6.0 - 2020-09-22
+* 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))
-### Added
-- **Metrics**: Support adding multiple metric values to a single metric name
-- **Utilities**: Add new `Validator` utility to validate inbound events and responses using JSON Schema
-- **Utilities**: Add new `Event source data classes` utility to easily describe event schema of popular event sources
-- **Docs**: Add new `Testing your code` section to both Logger and Metrics page, and content width is now wider
-- **Tracer**: Support for automatically disable Tracer when running a Chalice app
+## Documentation
-### Fixed
-- **Docs**: Improve wording on log sampling feature in Logger, and removed duplicate content on main page
-- **Utilities**: Remove DeleteMessageBatch API call when there are no messages to delete
+* fix contrast on highlighted code text ([#73](https://github.com/aws-powertools/powertools-lambda-python/issues/73))
-## 1.5.0 - 2020-09-04
+## Features
-### Added
-- **Logger**: Add `xray_trace_id` to log output to improve integration with CloudWatch Service Lens
-- **Logger**: Allow reordering of logged output
-- **Utilities**: Add new `SQS batch processing` utility to handle partial failures in processing message batches
-- **Utilities**: Add typing utility providing static type for lambda context object
-- **Utilities**: Add `transform=auto` in parameters utility to deserialize parameter values based on the key name
+* 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))
-### Fixed
-- **Logger**: The value of `json_default` formatter is no longer written to logs
+## Maintenance
-## 1.4.0 - 2020-08-25
+* version bump 0.10.1
+* **deps:** bump graphql-playground-html from 1.6.19 to 1.6.25 in /docs
-### Added
-- **All**: Official Lambda Layer via [Serverless Application Repository](https://serverlessrepo.aws.amazon.com/applications/eu-west-1/057560766410/aws-lambda-powertools-python-layer)
-- **Tracer**: `capture_method` and `capture_lambda_handler` now support **capture_response=False** parameter to prevent Tracer to capture response as metadata to allow customers running Tracer with sensitive workloads
+## Pull Requests
-### Fixed
-- **Metrics**: Cold start metric is now completely separate from application metrics dimensions, making it easier and cheaper to visualize.
- - This is a breaking change if you were graphing/alerting on both application metrics with the same name to compensate this previous malfunctioning
- - Marked as bugfix as this is the intended behaviour since the beginning, as you shouldn't have the same application metric with different dimensions
-- **Utilities**: SSMProvider within Parameters utility now have decrypt and recursive parameters correctly defined to support autocompletion
+* 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
-### Added
-- **Tracer**: capture_lambda_handler and capture_method decorators now support `capture_response` parameter to not include function's response as part of tracing metadata
-## 1.3.1 - 2020-08-22
-### Fixed
-- **Tracer**: capture_method decorator did not properly handle nested context managers
-
-## 1.3.0 - 2020-08-21
-### Added
-- **Utilities**: Add new `parameters` utility to retrieve a single or multiple parameters from SSM Parameter Store, Secrets Manager, DynamoDB, or your very own
+<a name="v0.10.0"></a>
+## v0.10.0 - 2020-06-08
+## Bug Fixes
-## 1.2.0 - 2020-08-20
-### Added
-- **Tracer**: capture_method decorator now supports generator functions (including context managers)
-
-## 1.1.3 - 2020-08-18
-### Fixed
-- **Logger**: Logs emitted twice, structured and unstructured, due to Lambda configuring the root handler
-
-## 1.1.2 - 2020-08-16
-### Fixed
-- **Docs**: Clarify confusion on Tracer reuse and `auto_patch=False` statement
-- **Logger**: Autocomplete for log statements in PyCharm
-
-## 1.1.1 - 2020-08-14
-### Fixed
-- **Logger**: Regression on `Logger` level not accepting `int` i.e. `Logger(level=logging.INFO)`
-
-## 1.1.0 - 2020-08-14
-### Added
-- **Logger**: Support for logger inheritance with `child` parameter
-
-### Fixed
-- **Logger**: Log level is now case insensitive via params and env var
-
-## 1.0.2 - 2020-07-16
-### Fixed
-- **Tracer**: Correct AWS X-Ray SDK dependency to support 2.5.0 and higher
-
-## 1.0.1 - 2020-07-06
-### Fixed
-- **Logger**: Fix a bug with `inject_lambda_context` causing existing Logger keys to be overridden if `structure_logs` was called before
-
-## 1.0.0 - 2020-06-18
-### Added
-- **Metrics**: `add_metadata` method to add any metric metadata you'd like to ease finding metric related data via CloudWatch Logs
-- Set status as General Availability
-
-## 0.11.0 - 2020-06-08
-### Added
-- Imports can now be made from top level of module, e.g.: `from aws_lambda_powertools import Logger, Metrics, Tracer`
-
-### Fixed
-- **Metrics**: Fix a bug with Metrics causing an exception to be thrown when logging metrics if dimensions were not explicitly added.
-
-### Changed
-- **Metrics**: No longer throws exception by default in case no metrics are emitted when using the log_metrics decorator.
-
-## 0.10.0 - 2020-06-08
-### Added
-- **Metrics**: `capture_cold_start_metric` parameter added to `log_metrics` decorator
-- **Metrics**: Optional `namespace` and `service` parameters added to Metrics constructor to more closely resemble other core utils
-
-### Changed
-- **Metrics**: Default dimension is now created based on `service` parameter or `POWERTOOLS_SERVICE_NAME` env var
-
-### Deprecated
-- **Metrics**: `add_namespace` method deprecated in favor of using `namespace` parameter to Metrics constructor or `POWERTOOLS_METRICS_NAMESPACE` env var
-
-## 0.9.5 - 2020-06-02
-### Fixed
-- **Metrics**: Coerce non-string dimension values to string
-- **Logger**: Correct `cold_start`, `function_memory_size` values from string to bool and int respectively
-
-## 0.9.4 - 2020-05-29
-### Fixed
-- **Metrics**: Fix issue where metrics were not correctly flushed, and cleared on every invocation
-
-## 0.9.3 - 2020-05-16
-### Fixed
-- **Tracer**: Fix Runtime Error for nested sync due to incorrect loop usage
-
-## 0.9.2 - 2020-05-14
-### Fixed
-- **Tracer**: Import aiohttp lazily so it's not a hard dependency
-
-## 0.9.0 - 2020-05-12
-### Added
-- **Tracer**: Support for async functions in `Tracer` via `capture_method` decorator
-- **Tracer**: Support for `aiohttp` via `aiohttp_trace_config` trace config
-- **Tracer**: Support for patching specific modules via `patch_modules` param
-- **Tracer**: Document escape hatch mechanisms via `tracer.provider`
-
-## 0.8.1 - 2020-05-1
-### Fixed
-* **Metrics**: Fix metric unit casting logic if one passes plain string (value or key)
-* **Metrics:**: Fix `MetricUnit` enum values for
- - `BytesPerSecond`
- - `KilobytesPerSecond`
- - `MegabytesPerSecond`
- - `GigabytesPerSecond`
- - `TerabytesPerSecond`
- - `BitsPerSecond`
- - `KilobitsPerSecond`
- - `MegabitsPerSecond`
- - `GigabitsPerSecond`
- - `TerabitsPerSecond`
- - `CountPerSecond`
-
-## 0.8.0 - 2020-04-24
-### Added
-- **Logger**: Introduced `Logger` class for structured logging as a replacement for `logger_setup`
-- **Logger**: Introduced `Logger.inject_lambda_context` decorator as a replacement for `logger_inject_lambda_context`
-
-### Removed
-- **Logger**: Raise `DeprecationWarning` exception for both `logger_setup`, `logger_inject_lambda_context`
-
-## 0.7.0 - 2020-04-20
-### Added
-- **Middleware factory**: Introduced Middleware Factory to build your own middleware via `lambda_handler_decorator`
-
-### Fixed
-- **Metrics**: Fixed metrics dimensions not being included correctly in EMF
-
-## 0.6.3 - 2020-04-09
-### Fixed
-- **Logger**: Fix `log_metrics` decorator logic not calling the decorated function, and exception handling
-
-## 0.6.1 - 2020-04-08
-### Added
-- **Metrics**: Introduces Metrics middleware to utilise CloudWatch Embedded Metric Format
-
-### Deprecated
-- **Metrics**: Added deprecation warning for `log_metrics`
-
-## 0.5.0 - 2020-02-20
-### Added
-- **Logger**: Introduced log sampling for debug - Thanks to [Danilo's contribution](https://github.com/awslabs/aws-lambda-powertools/pull/7)
-
-## 0.1.0 - 2019-11-15
-### Added
-- Public beta release
+* 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/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
+* CI attempt 2
+* add missing single_metric example; test var name
+* fix import of aws_lambda_logging to relative import
+* **Makefile:** format before linting
+* **make:** add twine as a dev dep
+* **setup:** correct invalid license classifier
+* **setup:** correct license to MIT-0 in meta
+
+## Documentation
+
+* build on master only
+* clarify logger debug sampling message
+* clean up readme in favour of docs website
+* add install in main docs website
+* add pypi badge
+
+## Features
+
+* 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/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/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
+* **pypi:** add bumpversion, public release pypi
+* **pyproject.toml:** move to poetry
+
+## Maintenance
+
+* 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/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/aws-powertools/powertools-lambda-python/issues/50))
+* bump to release candidate
+* renamed history to changelog dependabot
+* grammar issues
+* bump example to use 0.8.0 features
+* clean up CI workflows
+* fix github badge typo
+* pypi monthly download badge
+* lint
+* bump 0.3.1 with logging patch
+* bump history
+* lint
+* add Python 3.8 in badge as it's supported
+* 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/aws-powertools/powertools-lambda-python/issues/66))
+
+## Pull Requests
+
+* 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 563372a53d7..e42ce8ec09a 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,7 +1,31 @@
+<!-- markdownlint-disable MD043 MD041 -->
+# Table of contents <!-- omit in toc -->
+
+- [Contributing Guidelines](#contributing-guidelines)
+ - [Reporting Bugs/Feature Requests](#reporting-bugsfeature-requests)
+ - [Contributing via Pull Requests](#contributing-via-pull-requests)
+ - [Dev setup](#dev-setup)
+ - [Local documentation](#local-documentation)
+ - [Conventions](#conventions)
+ - [General terminology and practices](#general-terminology-and-practices)
+ - [Testing definition](#testing-definition)
+ - [Finding contributions to work on](#finding-contributions-to-work-on)
+ - [Code of Conduct](#code-of-conduct)
+ - [Security issue notifications](#security-issue-notifications)
+ - [Troubleshooting](#troubleshooting)
+ - [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.
@@ -10,67 +34,135 @@ 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
-We are temporarily de-prioritizing and pausing external contributions until end of July 2022. You can read more here: https://github.com/awslabs/aws-lambda-powertools-python/issues/1076
-
-<!-- Contributions via pull requests are much appreciated. Before sending us a pull request, please ensure that:
+Contributions via pull requests are much appreciated. Before sending us a pull request, please ensure that:
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 a [RFC issue](https://github.com/awslabs/aws-lambda-powertools-python/issues/new?assignees=&labels=RFC%2C+triage&template=rfc.md&title=RFC%3A+) to discuss any significant work - we would hate for your time to be wasted. -->
+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
+Firstly, [fork the repository](https://github.com/aws-powertools/powertools-lambda-python/fork).
+
+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:
-1. Fork the repository.
-2. Install dependencies in a virtual env with poetry, and pre-commit hooks: `make dev`
-3. Create a new branch to focus on the specific change you are contributing e.g. `improv/logger-debug-sampling`
-4. Run all tests, and code baseline checks: `make pr`
+1. Create a new branch to focus on the specific change you are contributing e.g. `improv/logger-debug-sampling`
+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
-4. Commit to your fork using clear commit messages.
-5. 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.
-6. Pay attention to any automated CI failures reported in the pull request, and stay involved in the conversation.
+3. Commit to your fork using clear commit messages.
+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
[creating a pull request](https://help.github.com/articles/creating-a-pull-request/).
-#### Local documentation
+### Local documentation
You might find useful to run both the documentation website and the API reference locally while contributing:
-* **API reference**: `make docs-api-local`
-* **Docs website**: `make docs-local`
- - If you prefer using Docker: `make docs-local-docker`
+- **API reference**: `make docs-api-local`
+- **Docs website**: `make docs-local`
+ - If you prefer using Docker: `make docs-local-docker`
+
+## Conventions
-### Conventions
+### General terminology and practices
-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).
-**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).
-**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.
-**Documentation** | We treat it like a product. We sub-divide content aimed at getting started (80% of customers) vs advanced usage (20%). We also ensure customers know how to unit test their code when using our features.
+| 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 [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://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. |
+| **Documentation** | We treat it like a product. We sub-divide content aimed at getting started (80% of customers) vs advanced usage (20%). We also ensure customers know how to unit test their code when using our features. |
+
+### Testing definition
+
+We group tests in different categories
+
+| Test | When to write | Notes | Speed |
+| ----------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
+| Unit tests | Verify the smallest possible unit works. | Networking access is prohibited. Prefer Functional tests given our complexity. | Lightning fast (nsec to ms) |
+| Functional tests | Guarantee functionality works as expected. It's a subset of integration test covering multiple units. | No external dependency. Prefer Fake implementations (in-memory) over Mocks and Stubs. | Fast (ms to few seconds at worst) |
+| Integration tests | Gain confidence that code works with one or more external dependencies. | No need for a Lambda function. Use our code base against an external dependency _e.g., fetch an existing SSM parameter_. | Moderate to slow (a few minutes) |
+| End-to-end tests | Gain confidence that a Lambda function with our code operates as expected. | It simulates how customers configure, deploy, and run their Lambda function - Event Source configuration, IAM permissions, etc. | Slow (minutes) |
+| Performance tests | Ensure critical operations won't increase latency and costs to customers. | CI arbitrary hardware can make it flaky. We'll resume writing perf test after our new Integ/End have significant coverage. | Fast to moderate (a few seconds to a few minutes) |
+
+**NOTE**: Functional tests are mandatory. We have plans to create a guide on how to create these different tests. Maintainers will help indicate whether additional tests are necessary and provide assistance as required.
## 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
+
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/). Please do **not** create a public github issue.
## Troubleshooting
@@ -81,9 +173,9 @@ When you are working on the codebase and you use the local API reference documen
This happens when:
-* You did not install the local dev environment yet
+- You did not install the local dev environment yet
- You can install dev deps with `make dev` command
-* The code in the repository is raising an exception while the `pdoc` is scanning the codebase
+- The code in the repository is raising an exception while the `pdoc` is scanning the codebase
- Unfortunately, this exception is not shown to you, but if you run, `poetry run pdoc --pdf aws_lambda_powertools`, the exception is shown and you can prevent the exception from being raised
- Once resolved the documentation should load correctly again
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 a706b94c6ab..2fa7b2eed23 100644
--- a/MAINTAINERS.md
+++ b/MAINTAINERS.md
@@ -1,279 +1,3 @@
+<!-- markdownlint-disable -->
-## Table of contents <!-- omit in toc -->
-
-- [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)
- - [Changelog generation](#changelog-generation)
- - [Bumping the version](#bumping-the-version)
- - [Drafting release notes](#drafting-release-notes)
- - [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 |
-
-## 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) | Amazon |
-
-## 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 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
-
-> TODO: This is an area we want to increase automation while keeping communication at human level.
-
-Firstly, make sure you are using the `develop` branch and it is up to date with the origin.
-
-There are three main steps to release a new version: Changelog generation, version bumping, and drafting release notes.
-
-#### Changelog generation
-
-You can pre-generate a temporary CHANGELOG using `make changelog`. This will generate a `TMP_CHANGELOG.md` with all staged changes under the `unreleased` section.
-
-Each unreleased line item is a commit. You can adjust them if you find the commit titles are insufficient to describe their intent. Once you're comfortable, bring these changes to the `CHANGELOG.md` with a new version heading like in previous versions.
-
-#### Bumping the version
-
-Use `poetry version <major|minor|patch|specific version>` to bump the version. For example, you can use `poetry version minor` when releasing a minor version.
-
-NOTE. Make sure both `CHANGELOG` and `pyproject.toml` are committed and pushed to the remote `develop` branch before proceeding.
-
-#### 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.
-
-> **Q: What if there's an incorrect title or grouping?**
-
-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.
-
-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. Always put yourself in the customers shoes. For that, 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 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/publish.yml) and within a few minutes you should see the latest version in PyPi, and all issues labeled as `pending-release` will be notified.
-
-> TODO: Wait for @am29d new Lambda Layers pipeline work to complete, then add how Lambda Layers are published
-
-### 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 removing `master` and 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 6173e3e310d..5c0125090a2 100644
--- a/Makefile
+++ b/Makefile
@@ -1,20 +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-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"
@@ -23,14 +32,23 @@ lint-docs-fix:
docker run -v ${PWD}:/markdown 06kellyjac/markdownlint-cli --fix "docs"
test:
- poetry run pytest -m "not perf" --cov=aws_lambda_powertools --cov-report=xml
+ 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:
+ poetry run pytest tests/e2e
+
coverage-html:
- poetry run pytest -m "not perf" --cov=aws_lambda_powertools --cov-report=html
+ poetry run pytest -m "not perf" --ignore tests/e2e --cov=aws_lambda_powertools --cov-report=html
pre-commit:
pre-commit run --show-diff-on-failure
@@ -40,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
@@ -60,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
@@ -70,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
@@ -91,8 +93,15 @@ release: pr
changelog:
git fetch --tags origin
- @echo "[+] Pre-generating CHANGELOG for tag: $$(git describe --abbrev=0 --tag)"
- docker run -v "${PWD}":/workdir quay.io/git-chglog/git-chglog $$(git describe --abbrev=0 --tag).. > TMP_CHANGELOG.md
+ 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:0.15.1 > CHANGELOG.md
mypy:
- poetry run mypy --pretty aws_lambda_powertools
+ 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 81cd3f3ce7f..34d3cac965c 100644
--- a/README.md
+++ b/README.md
@@ -1,57 +1,112 @@
-# AWS Lambda Powertools for Python
+<!-- markdownlint-disable MD013 MD041 MD043 -->
+# Powertools for AWS Lambda (Python)
-
-[](https://app.codecov.io/gh/awslabs/aws-lambda-powertools-python)
-  
+[](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
+## Features
+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
With [pip](https://pip.pypa.io/en/latest/index.html) installed, run: ``pip install aws-lambda-powertools``
-
## 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
-**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
new file mode 100644
index 00000000000..885ffb18f2c
--- /dev/null
+++ b/SECURITY.md
@@ -0,0 +1,7 @@
+<!-- markdownlint-disable MD043 -->
+
+## 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>.
+
+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 d63cd584bd4..98433b2e29b 100644
--- a/aws_lambda_powertools/event_handler/__init__.py
+++ b/aws_lambda_powertools/event_handler/__init__.py
@@ -2,14 +2,47 @@
Event handler decorators for common Lambda events
"""
-from .api_gateway import ALBResolver, APIGatewayHttpResolver, ApiGatewayResolver, APIGatewayRestResolver, CORSConfig
-from .appsync import AppSyncResolver
+from aws_lambda_powertools.event_handler.api_gateway import (
+ ALBResolver,
+ APIGatewayHttpResolver,
+ ApiGatewayResolver,
+ APIGatewayRestResolver,
+ CORSConfig,
+ Response,
+)
+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 78cee8f2051..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,24 +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
+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
-_NAMED_GROUP_BOUNDARY_PATTERN = fr"(?P\1[{_SAFE_URI}{_UNSAFE_URI}\\w]+)"
+_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):
@@ -36,6 +108,21 @@ 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:
@@ -44,20 +131,22 @@ class CORSConfig:
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 (
@@ -66,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,
@@ -88,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,
):
"""
@@ -99,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.
-class Response:
+ 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(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,
):
"""
@@ -150,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]] = []
-class ResponseBuilder:
+ 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(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."""
@@ -201,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
@@ -266,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
@@ -292,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
@@ -318,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
@@ -345,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
@@ -375,114 +1238,1343 @@ 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 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)
+ ```
+ """
+ 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,
- 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,
- ):
+ 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.
"""
- Parameters
- ----------
- proxy_type: ProxyEventType
+ 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
+ context: LambdaContext
+ Lambda context
+ Returns
+ -------
+ dict
+ Returns the dict response
+ """
+ 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)))
+
+ # 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
+
+ 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: dict[str, Any]
Event
context: LambdaContext
Lambda context
@@ -490,23 +2582,160 @@ def resolve(self, event, context) -> Dict[str, Any]:
-------
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"
+ "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)))
+
+ BaseRouter.current_event = self._to_proxy_event(cast(dict, event))
BaseRouter.lambda_context = context
- return self._resolve().build(self.current_event, self._cors)
+
+ 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
@@ -536,33 +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)
- 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"""
@@ -570,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
- return ResponseBuilder(
- Response(
+ 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="")
+
+ # 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 _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 exception_handler(self, exc_class: type[Exception] | list[type[Exception]]):
+ return self.exception_handler_manager.exception_handler(exc_class=exc_class)
- 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
----------
@@ -709,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] = []
- self.route(*route)(func)
+ 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)
+
+ 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 6a4bf989169..29c48d71cb1 100644
--- a/aws_lambda_powertools/event_handler/appsync.py
+++ b/aws_lambda_powertools/event_handler/appsync.py
@@ -1,84 +1,85 @@
+from __future__ import annotations
+
+import asyncio
import logging
-from abc import ABC
-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(ABC):
- 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:
@@ -115,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")
@@ -142,39 +143,228 @@ def lambda_handler(event, context):
ValueError
If we could not find a field resolver
"""
- 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/tests/functional/feature_flags/__init__.py b/aws_lambda_powertools/event_handler/graphql_appsync/__init__.py
similarity index 100%
rename from tests/functional/feature_flags/__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
new file mode 100644
index 00000000000..cbd92a00b6e
--- /dev/null
+++ b/aws_lambda_powertools/event_handler/lambda_function_url.py
@@ -0,0 +1,57 @@
+from __future__ import annotations
+
+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):
+ """AWS Lambda Function URL resolver
+
+ Notes:
+ -----
+ Lambda Function URL follows the API Gateway HTTP APIs Payload Format Version 2.0.
+
+ Documentation:
+ - https://docs.aws.amazon.com/lambda/latest/dg/urls-configuration.html
+ - https://docs.aws.amazon.com/lambda/latest/dg/urls-invocation.html#urls-payloads
+
+ Examples
+ --------
+ Simple example integrating with Tracer
+
+ ```python
+ from aws_lambda_powertools import Tracer
+ from aws_lambda_powertools.event_handler import LambdaFunctionUrlResolver
+
+ tracer = Tracer()
+ app = LambdaFunctionUrlResolver()
+
+ @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}
+
+ @tracer.capture_lambda_handler
+ def lambda_handler(event, context):
+ return app.resolve(event, context)
+ """
+
+ current_event: LambdaFunctionUrlEvent
+ _proxy_event_type = ProxyEventType.LambdaFunctionUrlEvent
+
+ 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}
+
+
+