Merge branch 'develop' into logger-current-keys

Author: leandrodamascena

docs/core/event_handler/api_gateway.md

@@ -874,6 +874,13 @@ You can use the `Response` class to have full control over the response. For exa
     --8<-- "examples/event_handler_rest/src/fine_grained_responses_output.json"
     ```
 
+???- note "Using `Response` with data validation?"
+    When using the [data validation](#data-validation) feature with `enable_validation=True`, you must specify the concrete type for the `Response` class. This allows the validation middleware to infer the underlying type and perform validation correctly.
+
+    ```python hl_lines="8 26 32"
+    --8<-- "examples/event_handler_rest/src/data_validation_fine_grained_response.py"
+    ```
+
 ### Compress
 
 You can compress with gzip and base64 encode your responses via `compress` parameter. You have the option to pass the `compress` parameter when working with a specific route or using the Response object.

examples/event_handler_rest/src/data_validation_fine_grained_response.py

@@ -0,0 +1,39 @@
+from http import HTTPStatus
+from typing import Optional
+
+import requests
+from pydantic import BaseModel, Field
+
+from aws_lambda_powertools import Logger, Tracer
+from aws_lambda_powertools.event_handler import APIGatewayRestResolver, Response, content_types
+from aws_lambda_powertools.logging import correlation_paths
+from aws_lambda_powertools.utilities.typing import LambdaContext
+
+tracer = Tracer()
+logger = Logger()
+app = APIGatewayRestResolver(enable_validation=True)
+
+
+class Todo(BaseModel):
+    userId: int
+    id_: Optional[int] = Field(alias="id", default=None)
+    title: str
+    completed: bool
+
+
+@app.get("/todos/<todo_id>")
+@tracer.capture_method
+def get_todo_by_id(todo_id: int) -> Response[Todo]:
+    todo = requests.get(f"https://jsonplaceholder.typicode.com/todos/{todo_id}")
+    todo.raise_for_status()
+    return Response(
+        status_code=HTTPStatus.OK.value,
+        content_type=content_types.APPLICATION_JSON,
+        body=todo.json(),
+    )
+
+
+@logger.inject_lambda_context(correlation_id_path=correlation_paths.API_GATEWAY_REST)
+@tracer.capture_lambda_handler
+def lambda_handler(event: dict, context: LambdaContext) -> dict:
+    return app.resolve(event, context)

package-lock.json

@@ -2,7 +2,7 @@
   "name": "aws-lambda-powertools-python-e2e",
   "version": "1.0.0",
   "devDependencies": {
-    "aws-cdk": "^2.136.0"
+    "aws-cdk": "^2.137.0"
   },
   "dependencies": {
     "package-lock.json": "^1.0.0"

package.json

@@ -65,16 +65,16 @@ xenon = "^0.9.1"
 mkdocs-git-revision-date-plugin = "^0.3.2"
 mike = "^1.1.2"
 pytest-xdist = "^3.5.0"
-aws-cdk-lib = "^2.136.0"
+aws-cdk-lib = "^2.136.1"
 "aws-cdk.aws-apigatewayv2-alpha" = "^2.38.1-alpha.0"
 "aws-cdk.aws-apigatewayv2-integrations-alpha" = "^2.38.1-alpha.0"
 "aws-cdk.aws-apigatewayv2-authorizers-alpha" = "^2.38.1-alpha.0"
 "aws-cdk.aws-lambda-python-alpha" = "^2.136.0a0"
-"cdklabs.generative-ai-cdk-constructs" = "^0.1.110"
+"cdklabs.generative-ai-cdk-constructs" = "^0.1.112"
 pytest-benchmark = "^4.0.0"
 mypy-boto3-appconfig = "^1.34.58"
 mypy-boto3-cloudformation = "^1.34.77"
-mypy-boto3-cloudwatch = "^1.34.75"
+mypy-boto3-cloudwatch = "^1.34.83"
 mypy-boto3-dynamodb = "^1.34.67"
 mypy-boto3-lambda = "^1.34.77"
 mypy-boto3-logs = "^1.34.66"
@@ -115,7 +115,7 @@ mypy = "^1.1.1"
 types-python-dateutil = "^2.8.19.6"
 httpx = ">=0.23.3,<0.28.0"
 sentry-sdk = "^1.22.2"
-ruff = ">=0.0.272,<0.3.6"
+ruff = ">=0.0.272,<0.3.8"
 retry2 = "^0.9.5"
 pytest-socket = ">=0.6,<0.8"
 types-redis = "^4.6.0.7"