aws-lambda-powertools 3.13.1a1__py3-none-any.whl → 3.13.1a3__py3-none-any.whl

aws_lambda_powertools/event_handler/api_gateway.py

@@ -546,20 +546,20 @@ class Route:
 
         return self._body_field
 
-    def _get_openapi_path(
+    def _get_openapi_path(  # noqa PLR0912
         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.
         """
         from aws_lambda_powertools.event_handler.openapi.dependant import get_flat_params
 
-        path = {}
         definitions: dict[str, Any] = {}
 
         # Gather all the route parameters
@@ -598,13 +598,18 @@ class Route:
             if request_body_oai:
                 operation["requestBody"] = request_body_oai
 
-        # Validation failure response (422) will always be part of the schema
-        operation_responses: dict[int, OpenAPIResponse] = {
-            422: {
-                "description": "Validation Error",
-                "content": {_DEFAULT_CONTENT_TYPE: {"schema": {"$ref": f"{COMPONENT_REF_PREFIX}HTTPValidationError"}}},
-            },
-        }
+        operation_responses: dict[int, OpenAPIResponse] = {}
+
+        if enable_validation:
+            # Validation failure response (422) is added only if Enable Validation feature is true
+            operation_responses = {
+                422: {
+                    "description": "Validation Error",
+                    "content": {
+                        _DEFAULT_CONTENT_TYPE: {"schema": {"$ref": f"{COMPONENT_REF_PREFIX}HTTPValidationError"}},
+                    },
+                },
+            }
 
         # Add custom response validation response, if exists
         if self.custom_response_validation_http_code:
@@ -681,8 +686,7 @@ class Route:
             }
 
         operation["responses"] = operation_responses
-        path[self.method.lower()] = operation
-
+        path = {self.method.lower(): operation}
         # Add the validation error schema to the definitions, but only if it hasn't been added yet
         if "ValidationError" not in definitions:
             definitions.update(
@@ -1575,6 +1579,7 @@ class ApiGatewayResolver(BaseRouter):
         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
@@ -1596,6 +1601,9 @@ class ApiGatewayResolver(BaseRouter):
             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._proxy_type = proxy_type
         self._dynamic_routes: list[Route] = []
@@ -1621,6 +1629,7 @@ class ApiGatewayResolver(BaseRouter):
 
         # 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 OpenAPIValidationMiddleware
@@ -1834,6 +1843,7 @@ class ApiGatewayResolver(BaseRouter):
                 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)
@@ -2431,24 +2441,24 @@ class ApiGatewayResolver(BaseRouter):
         """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)
+            return APIGatewayProxyEvent(event, self._json_body_deserializer)
         if self._proxy_type == ProxyEventType.APIGatewayProxyEventV2:
             logger.debug("Converting event to API Gateway HTTP API contract")
-            return APIGatewayProxyEventV2(event)
+            return APIGatewayProxyEventV2(event, self._json_body_deserializer)
         if self._proxy_type == ProxyEventType.BedrockAgentEvent:
             logger.debug("Converting event to Bedrock Agent contract")
-            return BedrockAgentEvent(event)
+            return BedrockAgentEvent(event, self._json_body_deserializer)
         if self._proxy_type == ProxyEventType.LambdaFunctionUrlEvent:
             logger.debug("Converting event to Lambda Function URL contract")
-            return LambdaFunctionUrlEvent(event)
+            return LambdaFunctionUrlEvent(event, self._json_body_deserializer)
         if self._proxy_type == ProxyEventType.VPCLatticeEvent:
             logger.debug("Converting event to VPC Lattice contract")
-            return VPCLatticeEvent(event)
+            return VPCLatticeEvent(event, self._json_body_deserializer)
         if self._proxy_type == ProxyEventType.VPCLatticeEventV2:
             logger.debug("Converting event to VPC LatticeV2 contract")
-            return VPCLatticeEventV2(event)
+            return VPCLatticeEventV2(event, self._json_body_deserializer)
         logger.debug("Converting event to ALB contract")
-        return ALBEvent(event)
+        return ALBEvent(event, self._json_body_deserializer)
 
     def _resolve(self) -> ResponseBuilder:
         """Resolves the response or return the not found response"""
@@ -2865,6 +2875,7 @@ class APIGatewayRestResolver(ApiGatewayResolver):
         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,
     ):
         """Amazon API Gateway REST and HTTP API v1 payload resolver"""
         super().__init__(
@@ -2875,6 +2886,7 @@ class APIGatewayRestResolver(ApiGatewayResolver):
             strip_prefixes,
             enable_validation,
             response_validation_error_http_code,
+            json_body_deserializer=json_body_deserializer,
         )
 
     def _get_base_path(self) -> str:
@@ -2951,6 +2963,7 @@ class APIGatewayHttpResolver(ApiGatewayResolver):
         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,
     ):
         """Amazon API Gateway HTTP API v2 payload resolver"""
         super().__init__(
@@ -2961,6 +2974,7 @@ class APIGatewayHttpResolver(ApiGatewayResolver):
             strip_prefixes,
             enable_validation,
             response_validation_error_http_code,
+            json_body_deserializer=json_body_deserializer,
         )
 
     def _get_base_path(self) -> str:
@@ -2990,6 +3004,7 @@ class ALBResolver(ApiGatewayResolver):
         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,
     ):
         """Amazon Application Load Balancer (ALB) resolver"""
         super().__init__(
@@ -3000,6 +3015,7 @@ class ALBResolver(ApiGatewayResolver):
             strip_prefixes,
             enable_validation,
             response_validation_error_http_code,
+            json_body_deserializer=json_body_deserializer,
         )
 
     def _get_base_path(self) -> str:

aws_lambda_powertools/event_handler/bedrock_agent.py

@@ -103,6 +103,7 @@ class BedrockAgentResolver(ApiGatewayResolver):
             serializer=None,
             strip_prefixes=None,
             enable_validation=enable_validation,
+            json_body_deserializer=None,
         )
         self._response_builder_class = BedrockResponseBuilder
 

aws_lambda_powertools/event_handler/lambda_function_url.py

@@ -61,6 +61,7 @@ class LambdaFunctionUrlResolver(ApiGatewayResolver):
         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,
     ):
         super().__init__(
             ProxyEventType.LambdaFunctionUrlEvent,
@@ -70,6 +71,7 @@ class LambdaFunctionUrlResolver(ApiGatewayResolver):
             strip_prefixes,
             enable_validation,
             response_validation_error_http_code,
+            json_body_deserializer=json_body_deserializer,
         )
 
     def _get_base_path(self) -> str:

aws_lambda_powertools/event_handler/vpc_lattice.py

@@ -57,6 +57,7 @@ class VPCLatticeResolver(ApiGatewayResolver):
         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,
     ):
         """Amazon VPC Lattice resolver"""
         super().__init__(
@@ -67,6 +68,7 @@ class VPCLatticeResolver(ApiGatewayResolver):
             strip_prefixes,
             enable_validation,
             response_validation_error_http_code,
+            json_body_deserializer=json_body_deserializer,
         )
 
     def _get_base_path(self) -> str:
@@ -115,6 +117,7 @@ class VPCLatticeV2Resolver(ApiGatewayResolver):
         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,
     ):
         """Amazon VPC Lattice resolver"""
         super().__init__(
@@ -125,6 +128,7 @@ class VPCLatticeV2Resolver(ApiGatewayResolver):
             strip_prefixes,
             enable_validation,
             response_validation_error_http_code,
+            json_body_deserializer=json_body_deserializer,
         )
 
     def _get_base_path(self) -> str:

aws_lambda_powertools/shared/version.py

@@ -1,3 +1,3 @@
 """Exposes version constant to avoid circular dependencies."""
 
-VERSION = "3.13.1a1"
+VERSION = "3.13.1a3"

{aws_lambda_powertools-3.13.1a1.dist-info → aws_lambda_powertools-3.13.1a3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: aws_lambda_powertools
-Version: 3.13.1a1
+Version: 3.13.1a3
 Summary: Powertools for AWS Lambda (Python) is a developer toolkit to implement Serverless best practices and increase developer velocity.
 License: MIT
 Keywords: aws_lambda_powertools,aws,tracing,logging,lambda,powertools,feature_flags,idempotency,middleware

{aws_lambda_powertools-3.13.1a1.dist-info → aws_lambda_powertools-3.13.1a3.dist-info}/RECORD

@@ -1,8 +1,8 @@
 aws_lambda_powertools/__init__.py,sha256=o4iEHU0MfWC0_TfVmisxi0VOAUw5uQfqLQWr0t29ZaE,676
 aws_lambda_powertools/event_handler/__init__.py,sha256=rbT-fYV_Lz8bcoecrtqkk0ZXh5-ccrWr1qvNecRCloc,1070
-aws_lambda_powertools/event_handler/api_gateway.py,sha256=4gfszkCNZP5Tm9i9YIA0pqVub-784NWu7R1qYwONCQs,120763
+aws_lambda_powertools/event_handler/api_gateway.py,sha256=XD51QGNfdq8ihkCu7YX-OAa6-Ny2Mr2j_-SXwBfLa7g,121997
 aws_lambda_powertools/event_handler/appsync.py,sha256=MNUlaM-4Ioaejei4L5hoW_DuDgOkQWAtMmKZU_Jwce4,18530
-aws_lambda_powertools/event_handler/bedrock_agent.py,sha256=4vWmF3wyoFn2u1SUgf0Rdz1KnrTZpcVUiU2KY-lhPMQ,15105
+aws_lambda_powertools/event_handler/bedrock_agent.py,sha256=j3pKSDUmfb5MNcanqm78s9THh7bvh40LKKgnov95JcU,15146
 aws_lambda_powertools/event_handler/content_types.py,sha256=0MKsKNu-SSrxbULVKnUjwgK-lVXhVD7BBjZ4Js0kEsI,163
 aws_lambda_powertools/event_handler/events_appsync/__init__.py,sha256=_SkA-qYoSdpDhPFHLxpFz8RacjMRMY6R8FFElQ3Otzs,144
 aws_lambda_powertools/event_handler/events_appsync/_registry.py,sha256=pzFQfv662Y0DPZQXCgJgabYZq-1gfasV5Mdl_aC9FBc,3071
@@ -19,7 +19,7 @@ aws_lambda_powertools/event_handler/graphql_appsync/_registry.py,sha256=cKbu_6Zq
 aws_lambda_powertools/event_handler/graphql_appsync/base.py,sha256=xbU2sLWyTjfNpbOK_NjQszDf2LgVRhozRt9HysLI3oM,5422
 aws_lambda_powertools/event_handler/graphql_appsync/exceptions.py,sha256=vTayCG3teb2XBfAhCMtTBDOOF1LJYs4uijY9GwQ5a-s,221
 aws_lambda_powertools/event_handler/graphql_appsync/router.py,sha256=zMyJ63Ck1ySqv3PofmpQs8lexJKiEkoEZATeLzu9aiI,2253
-aws_lambda_powertools/event_handler/lambda_function_url.py,sha256=cX5u2xMrsRbNkUzb9i4mJhRtYLGLa-BRkI_Gw4sl7fs,2343
+aws_lambda_powertools/event_handler/lambda_function_url.py,sha256=uNJY36nGLwyuuGNPmbyrcvOKGt-5UIMgJKPdRzgnskM,2471
 aws_lambda_powertools/event_handler/middlewares/__init__.py,sha256=3R5XptoCT8owm4swcAEG0lsV_zbL4X-gU5nv8eJ0jQs,158
 aws_lambda_powertools/event_handler/middlewares/base.py,sha256=llr1_sGaAsyMY9Gn4zKUDxePQ5X7ClcqgjqPesg5FJw,3724
 aws_lambda_powertools/event_handler/middlewares/openapi_validation.py,sha256=L7QjXgRT9c_PsKNVwk08uCFYGdf0htu5D_warAM2N34,16091
@@ -43,7 +43,7 @@ aws_lambda_powertools/event_handler/openapi/types.py,sha256=qIUSazCYnMu2GKwXrih-
 aws_lambda_powertools/event_handler/router.py,sha256=cxL3MtN2Q8_RkPndNtAAcjJSqDJ4WN02dro_O83nxAM,980
 aws_lambda_powertools/event_handler/types.py,sha256=yppbl_2wdyXSK_oTkSnkwPdAlJibc-uTm1IWmlB1RfU,177
 aws_lambda_powertools/event_handler/util.py,sha256=MQvqlA1Cf7SkoEJbPP-0VVIYyBCSGFWLSbo5nAB5vaY,3217
-aws_lambda_powertools/event_handler/vpc_lattice.py,sha256=1L7nTGhpqnAbsa29FLuJww2NiQ2p_WOD8H9ENtOhMxo,3689
+aws_lambda_powertools/event_handler/vpc_lattice.py,sha256=RTOgGxc-cVCZ7-4XsLEoZXn6N2SVfUVJ9JT4Yojzjyg,3945
 aws_lambda_powertools/exceptions/__init__.py,sha256=bv7fiO8Cj5xbHOTlDpWpM3pIkbdSB74Nt_mHbzLzYDw,163
 aws_lambda_powertools/logging/__init__.py,sha256=G5MTkVqaQvpfa7k3fGkj4QN0KU6nFfP0_SLF_47G_VE,72
 aws_lambda_powertools/logging/buffer/__init__.py,sha256=2sdmJToRBp6QJI2VQuvgjuxsJkTMd4dL3TYp6dASiOQ,109
@@ -97,7 +97,7 @@ aws_lambda_powertools/shared/json_encoder.py,sha256=JQeWNu-4M7_xI_hqYExrxsb3OcEH
 aws_lambda_powertools/shared/lazy_import.py,sha256=TbXQm2bcwXdZrYdBaJJXIswyLlumM85RJ_A_0w-h-GU,2019
 aws_lambda_powertools/shared/types.py,sha256=EZ_tbX3F98LA4Zcra1hTEjzRacpZAtggK957Zcv1oKg,135
 aws_lambda_powertools/shared/user_agent.py,sha256=DrCMFQuT4a4iIrpcWpAIjY37EFqR9-QxlxDGD-Nn9Gg,7081
-aws_lambda_powertools/shared/version.py,sha256=YM_Nd0L6J1hYQ0cXV0nEQFXZFoDOaQVFyJayvtDnVlw,85
+aws_lambda_powertools/shared/version.py,sha256=u2MIsLNOjSGxlp_F3zJ-Yk1ky9w9W4GtisE0lpA9q_8,85
 aws_lambda_powertools/tracing/__init__.py,sha256=f4bMThOPBPWTPVcYqcAIErAJPerMsf3H_Z4gCXCsK9I,141
 aws_lambda_powertools/tracing/base.py,sha256=WSO986XGBOe9K0F2SnG6ustJokIrtO0m0mcL8N7mfno,4544
 aws_lambda_powertools/tracing/extensions.py,sha256=APOfXOq-hRBKaK5WyfIyrd_6M1_9SWJZ3zxLA9jDZzU,492
@@ -269,7 +269,7 @@ aws_lambda_powertools/utilities/validation/envelopes.py,sha256=YD5HOFx6IClQgii0n
 aws_lambda_powertools/utilities/validation/exceptions.py,sha256=PKy_19zQMBJGCMMFl-sMkcm-cc0v3zZBn_bhGE4wKNo,2084
 aws_lambda_powertools/utilities/validation/validator.py,sha256=khCqFhACSdn0nKyYRRPiC5Exht956hTfSfhlV3IRmpg,10099
 aws_lambda_powertools/warnings/__init__.py,sha256=vqDVeZz8wGtD8WGYNSkQE7AHwqtIrPGRxuoJR_BBnSs,1193
-aws_lambda_powertools-3.13.1a1.dist-info/LICENSE,sha256=vMHS2eBgmwPUIMPb7LQ4p7ib_FPVQXarVjAasflrTwo,951
-aws_lambda_powertools-3.13.1a1.dist-info/METADATA,sha256=QBLt1BbRN5tBzT-pCQwysIhOwZZKbejVrFRFQ0gbZbY,11273
-aws_lambda_powertools-3.13.1a1.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
-aws_lambda_powertools-3.13.1a1.dist-info/RECORD,,
+aws_lambda_powertools-3.13.1a3.dist-info/LICENSE,sha256=vMHS2eBgmwPUIMPb7LQ4p7ib_FPVQXarVjAasflrTwo,951
+aws_lambda_powertools-3.13.1a3.dist-info/METADATA,sha256=pCZjV6CbL9oSDzVHAOZuW4IgXzEuoXEPSzsI_TPcuMs,11273
+aws_lambda_powertools-3.13.1a3.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
+aws_lambda_powertools-3.13.1a3.dist-info/RECORD,,