Merge branch 'develop' into nested_event_sources

Author: seshubaws

CHANGELOG.md

@@ -6,7 +6,9 @@
 
 ## 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:** improve overloads to ensure the return type follows the default_value type ([#4114](https://github.com/aws-powertools/powertools-lambda-python/issues/4114))
 
 ## Documentation
 
@@ -15,36 +17,59 @@
 ## Features
 
 * **Idempotency:** add feature for manipulating idempotent responses ([#4037](https://github.com/aws-powertools/powertools-lambda-python/issues/4037))
+* **logger:** add method to return currently configured keys ([#4033](https://github.com/aws-powertools/powertools-lambda-python/issues/4033))
 
 ## Maintenance
 
-* **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))
+* **ci:** add monthly roadmap reminder workflow ([#4075](https://github.com/aws-powertools/powertools-lambda-python/issues/4075))
+* **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 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 codecov/codecov-action from 4.2.0 to 4.3.0 ([#4098](https://github.com/aws-powertools/powertools-lambda-python/issues/4098))
 * **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 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 datadog-lambda from 5.91.0 to 5.92.0 ([#4038](https://github.com/aws-powertools/powertools-lambda-python/issues/4038))
+* **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:** 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 idna from 3.6 to 3.7 ([#4121](https://github.com/aws-powertools/powertools-lambda-python/issues/4121))
+* **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 codecov/codecov-action from 4.1.1 to 4.2.0 ([#4072](https://github.com/aws-powertools/powertools-lambda-python/issues/4072))
-* **deps:** bump squidfunk/mkdocs-material from `3307665` to `065f3af` in /docs ([#4052](https://github.com/aws-powertools/powertools-lambda-python/issues/4052))
-* **deps:** bump squidfunk/mkdocs-material from `065f3af` to `6b124e1` in /docs ([#4055](https://github.com/aws-powertools/powertools-lambda-python/issues/4055))
-* **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-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 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 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-lib from 2.135.0 to 2.136.0 ([#4092](https://github.com/aws-powertools/powertools-lambda-python/issues/4092))
+* **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 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 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 the boto-typing group with 2 updates ([#4062](https://github.com/aws-powertools/powertools-lambda-python/issues/4062))
+* **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.107 to 0.1.110 ([#4097](https://github.com/aws-powertools/powertools-lambda-python/issues/4097))
+* **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 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 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 mkdocs-material from 9.5.16 to 9.5.17 ([#4056](https://github.com/aws-powertools/powertools-lambda-python/issues/4056))
+* **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.105 to 0.1.106 ([#4048](https://github.com/aws-powertools/powertools-lambda-python/issues/4048))
-* **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 aws-cdk from 2.134.0 to 2.135.0 ([#4058](https://github.com/aws-powertools/powertools-lambda-python/issues/4058))
+* **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 aws-cdk from 2.136.1 to 2.137.0 ([#4115](https://github.com/aws-powertools/powertools-lambda-python/issues/4115))
 * **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 sentry-sdk from 1.43.0 to 1.44.0 ([#4040](https://github.com/aws-powertools/powertools-lambda-python/issues/4040))
-* **deps-dev:** bump the boto-typing group with 2 updates ([#4062](https://github.com/aws-powertools/powertools-lambda-python/issues/4062))
-* **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 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.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.44.0 to 1.44.1 ([#4065](https://github.com/aws-powertools/powertools-lambda-python/issues/4065))
-* **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 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-aws-lambda-python-alpha from 2.136.0a0 to 2.137.0a0 ([#4124](https://github.com/aws-powertools/powertools-lambda-python/issues/4124))
 
 
 <a name="v2.36.0"></a>

aws_lambda_powertools/utilities/data_classes/api_gateway_authorizer_event.py

@@ -167,22 +167,22 @@ def get_header_value(
         self,
         name: str,
         default_value: str,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> str: ...
 
     @overload
     def get_header_value(
         self,
         name: str,
         default_value: Optional[str] = None,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> Optional[str]: ...
 
     def get_header_value(
         self,
         name: str,
         default_value: Optional[str] = None,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> Optional[str]:
         """Get header value by name
 
@@ -291,14 +291,14 @@ def get_header_value(
         self,
         name: str,
         default_value: Optional[str] = None,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> Optional[str]: ...
 
     def get_header_value(
         self,
         name: str,
         default_value: Optional[str] = None,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> Optional[str]:
         """Get header value by name
 

aws_lambda_powertools/utilities/data_classes/appsync_resolver_event.py

@@ -219,22 +219,22 @@ def get_header_value(
         self,
         name: str,
         default_value: str,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> str: ...
 
     @overload
     def get_header_value(
         self,
         name: str,
         default_value: Optional[str] = None,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> Optional[str]: ...
 
     def get_header_value(
         self,
         name: str,
         default_value: Optional[str] = None,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> Optional[str]:
         """Get header value by name
 

aws_lambda_powertools/utilities/data_classes/common.py

@@ -274,22 +274,22 @@ def get_header_value(
         self,
         name: str,
         default_value: str,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> str: ...
 
     @overload
     def get_header_value(
         self,
         name: str,
         default_value: Optional[str] = None,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> Optional[str]: ...
 
     def get_header_value(
         self,
         name: str,
         default_value: Optional[str] = None,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> Optional[str]:
         """Get header value by name
 

aws_lambda_powertools/utilities/data_classes/s3_object_event.py

@@ -78,22 +78,22 @@ def get_header_value(
         self,
         name: str,
         default_value: str,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> str: ...
 
     @overload
     def get_header_value(
         self,
         name: str,
         default_value: Optional[str] = None,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> Optional[str]: ...
 
     def get_header_value(
         self,
         name: str,
         default_value: Optional[str] = None,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> Optional[str]:
         """Get header value by name
 

aws_lambda_powertools/utilities/data_classes/shared_functions.py

@@ -26,7 +26,7 @@ def get_header_value(
     headers: dict[str, Any],
     name: str,
     default_value: str,
-    case_sensitive: bool | None = False,
+    case_sensitive: bool = False,
 ) -> str: ...
 
 
@@ -35,15 +35,15 @@ def get_header_value(
     headers: dict[str, Any],
     name: str,
     default_value: str | None = None,
-    case_sensitive: bool | None = False,
+    case_sensitive: bool = False,
 ) -> str | None: ...
 
 
 def get_header_value(
     headers: dict[str, Any],
     name: str,
     default_value: str | None = None,
-    case_sensitive: bool | None = False,
+    case_sensitive: bool = False,
 ) -> str | None:
     """
     Get the value of a header by its name.

aws_lambda_powertools/utilities/data_classes/sqs_event.py

@@ -55,6 +55,13 @@ def message_deduplication_id(self) -> Optional[str]:
         the 5-minute deduplication interval."""
         return self.get("MessageDeduplicationId")
 
+    @property
+    def dead_letter_queue_source_arn(self) -> Optional[str]:
+        """The SQS queue ARN that sent the record to this DLQ.
+        Only present when a Lambda function is using a DLQ as an event source.
+        """
+        return self.get("DeadLetterQueueSourceArn")
+
 
 class SQSMessageAttribute(DictWrapper):
     """The user-specified message attribute value."""

aws_lambda_powertools/utilities/data_classes/vpc_lattice.py

@@ -78,22 +78,22 @@ def get_header_value(
         self,
         name: str,
         default_value: str,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> str: ...
 
     @overload
     def get_header_value(
         self,
         name: str,
         default_value: Optional[str] = None,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> Optional[str]: ...
 
     def get_header_value(
         self,
         name: str,
         default_value: Optional[str] = None,
-        case_sensitive: Optional[bool] = False,
+        case_sensitive: bool = False,
     ) -> Optional[str]:
         """Get header value by name
 

aws_lambda_powertools/utilities/parser/models/sqs.py

@@ -15,6 +15,7 @@ class SqsAttributesModel(BaseModel):
     SentTimestamp: datetime
     SequenceNumber: Optional[str] = None
     AWSTraceHeader: Optional[str] = None
+    DeadLetterQueueSourceArn: Optional[str] = None
 
 
 class SqsMsgAttributeModel(BaseModel):

docs/Dockerfile

@@ -1,5 +1,5 @@
 # v9.1.18
-FROM squidfunk/mkdocs-material@sha256:6b124e13728a591607e0f087920763e405fc18861736a997896d0b253867a7b7
+FROM squidfunk/mkdocs-material@sha256:521644b58bc0c806083ef66e8b1027861bd3e98c433b251c436c5c0cc7733603
 # pip-compile --generate-hashes --output-file=requirements.txt requirements.in
 COPY requirements.txt /tmp/
 RUN pip install --require-hashes -r /tmp/requirements.txt

docs/utilities/typing.md

@@ -38,7 +38,7 @@ Using `LambdaContext` typing makes it possible to access information and hints o
 
 === "working_with_context_function.py"
 
-	```python hl_lines="6 16 25 26"
+	```python hl_lines="6 15 22 23"
     --8<-- "examples/typing/src/working_with_context_function.py"
 	```