aws-lambda-powertools 3.12.1a5__py3-none-any.whl → 3.12.1a7__py3-none-any.whl

aws_lambda_powertools/shared/version.py

@@ -1,3 +1,3 @@
 """Exposes version constant to avoid circular dependencies."""
 
-VERSION = "3.12.1a5"
+VERSION = "3.12.1a7"

aws_lambda_powertools/utilities/data_classes/dynamo_db_stream_event.py

@@ -140,12 +140,25 @@ class DynamoDBRecord(DictWrapper):
         return self.get("userIdentity") or {}
 
 
+class DynamoDBStreamWindow(DictWrapper):
+    @property
+    def start(self) -> str:
+        """The time window started"""
+        return self["start"]
+
+    @property
+    def end(self) -> str:
+        """The time window will end"""
+        return self["end"]
+
+
 class DynamoDBStreamEvent(DictWrapper):
     """Dynamo DB Stream Event
 
     Documentation:
     -------------
     - https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html
+    - https://docs.aws.amazon.com/lambda/latest/dg/services-ddb-windows.html
 
     Example
     -------
@@ -167,3 +180,30 @@ class DynamoDBStreamEvent(DictWrapper):
     def records(self) -> Iterator[DynamoDBRecord]:
         for record in self["Records"]:
             yield DynamoDBRecord(record)
+
+    @property
+    def window(self) -> DynamoDBStreamWindow | None:
+        window = self.get("window")
+        if window:
+            return DynamoDBStreamWindow(window)
+        return window
+
+    @property
+    def state(self) -> dict[str, Any]:
+        return self.get("state") or {}
+
+    @property
+    def shard_id(self) -> str | None:
+        return self.get("shardId")
+
+    @property
+    def event_source_arn(self) -> str | None:
+        return self.get("eventSourceARN")
+
+    @property
+    def is_final_invoke_for_window(self) -> bool | None:
+        return self.get("isFinalInvokeForWindow")
+
+    @property
+    def is_window_terminated_early(self) -> bool | None:
+        return self.get("isWindowTerminatedEarly")

aws_lambda_powertools/utilities/data_classes/kinesis_stream_event.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 import base64
 import json
 import zlib
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any
 
 from aws_lambda_powertools.utilities.data_classes.cloud_watch_logs_event import (
     CloudWatchLogsDecodedData,
@@ -100,12 +100,25 @@ class KinesisStreamRecord(DictWrapper):
         return KinesisStreamRecordPayload(self["kinesis"])
 
 
+class KinesisStreamWindow(DictWrapper):
+    @property
+    def start(self) -> str:
+        """The time window started"""
+        return self["start"]
+
+    @property
+    def end(self) -> str:
+        """The time window will end"""
+        return self["end"]
+
+
 class KinesisStreamEvent(DictWrapper):
     """Kinesis stream event
 
     Documentation:
     --------------
     - https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html
+    - https://docs.aws.amazon.com/lambda/latest/dg/services-kinesis-windows.html
     """
 
     @property
@@ -113,6 +126,33 @@ class KinesisStreamEvent(DictWrapper):
         for record in self["Records"]:
             yield KinesisStreamRecord(record)
 
+    @property
+    def window(self) -> KinesisStreamWindow | None:
+        window = self.get("window")
+        if window:
+            return KinesisStreamWindow(window)
+        return window
+
+    @property
+    def state(self) -> dict[str, Any]:
+        return self.get("state") or {}
+
+    @property
+    def shard_id(self) -> str | None:
+        return self.get("shardId")
+
+    @property
+    def event_source_arn(self) -> str | None:
+        return self.get("eventSourceARN")
+
+    @property
+    def is_final_invoke_for_window(self) -> bool | None:
+        return self.get("isFinalInvokeForWindow")
+
+    @property
+    def is_window_terminated_early(self) -> bool | None:
+        return self.get("isWindowTerminatedEarly")
+
 
 def extract_cloudwatch_logs_from_event(event: KinesisStreamEvent) -> list[CloudWatchLogsDecodedData]:
     return [CloudWatchLogsDecodedData(record.kinesis.data_zlib_compressed_as_json()) for record in event.records]

aws_lambda_powertools/utilities/parser/envelopes/kinesis.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import logging
+import zlib
 from typing import TYPE_CHECKING, Any, cast
 
 from aws_lambda_powertools.utilities.parser.envelopes.base import BaseEnvelope
@@ -45,5 +46,17 @@ class KinesisDataStreamEnvelope(BaseEnvelope):
         for record in parsed_envelope.Records:
             # We allow either AWS expected contract (bytes) or a custom Model, see #943
             data = cast(bytes, record.kinesis.data)
-            models.append(self._parse(data=data.decode("utf-8"), model=model))
+            try:
+                decoded_data = data.decode("utf-8")
+            except UnicodeDecodeError as ude:
+                try:
+                    logger.debug(
+                        f"{type(ude).__name__}: {str(ude)} encountered. "
+                        "Data will be decompressed with zlib.decompress().",
+                    )
+                    decompressed_data = zlib.decompress(data, zlib.MAX_WBITS | 32)
+                    decoded_data = decompressed_data.decode("utf-8")
+                except Exception as e:
+                    raise ValueError("Unable to decode and/or decompress data.") from e
+            models.append(self._parse(data=decoded_data, model=model))
         return models

{aws_lambda_powertools-3.12.1a5.dist-info → aws_lambda_powertools-3.12.1a7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: aws_lambda_powertools
-Version: 3.12.1a5
+Version: 3.12.1a7
 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
@@ -34,7 +34,7 @@ Requires-Dist: jmespath (>=1.0.1,<2.0.0)
 Requires-Dist: jsonpath-ng (>=1.6.0,<2.0.0) ; extra == "all" or extra == "datamasking"
 Requires-Dist: pydantic (>=2.4.0,<3.0.0) ; extra == "parser" or extra == "all"
 Requires-Dist: pydantic-settings (>=2.6.1,<3.0.0) ; extra == "all"
-Requires-Dist: redis (>=4.4,<6.0) ; extra == "redis"
+Requires-Dist: redis (>=4.4,<7.0) ; extra == "redis"
 Requires-Dist: typing-extensions (>=4.11.0,<5.0.0)
 Project-URL: Documentation, https://docs.powertools.aws.dev/lambda/python/
 Project-URL: Issue tracker, https://github.com/aws-powertools/powertools-lambda-python/issues

{aws_lambda_powertools-3.12.1a5.dist-info → aws_lambda_powertools-3.12.1a7.dist-info}/RECORD

@@ -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=QUHJEmCM4f0f_L5B_IodCkKpwwrqG-fU_bUzgjltcM0,85
+aws_lambda_powertools/shared/version.py,sha256=vHdb2rqyEczcHCuNec4ciWkyQkwsX2Cx-9EjfSts-rQ,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
@@ -131,13 +131,13 @@ aws_lambda_powertools/utilities/data_classes/code_pipeline_job_event.py,sha256=2
 aws_lambda_powertools/utilities/data_classes/cognito_user_pool_event.py,sha256=oHYYcFYeX5bQp7avtrLtwizWqSmJzLA3qqVvZ4ybj94,40540
 aws_lambda_powertools/utilities/data_classes/common.py,sha256=s3VqYE1yLsJxq1eQ9Oi4vm4GQlBxasSOIHlS1RuexEs,19564
 aws_lambda_powertools/utilities/data_classes/connect_contact_flow_event.py,sha256=4_L73ATO-M_2zUD3r0zS4c6I4zoLxTK9l8JQc-dATog,5468
-aws_lambda_powertools/utilities/data_classes/dynamo_db_stream_event.py,sha256=j8OKsS60Ab8hmnnEtvELbUMsk0LGSiUpwh_bZ41fLuY,6167
+aws_lambda_powertools/utilities/data_classes/dynamo_db_stream_event.py,sha256=tKv3Kpw0faLuNr4ac8uB5qDz-DvJPpnXHrDcIAZa3RY,7225
 aws_lambda_powertools/utilities/data_classes/event_bridge_event.py,sha256=TeTtx2jOKyZSVdSPFrtxZUgv0Yt6HW_H7J5NNxy_mHo,2434
 aws_lambda_powertools/utilities/data_classes/event_source.py,sha256=CKo1_TY0UcUVsh3PUk39z2WFVC2Bf4QgXWj93eEHbcY,1211
 aws_lambda_powertools/utilities/data_classes/iot_registry_event.py,sha256=wUa0Gr64maNGkd9qKNxtwFHawIJN-nj9X8uLFdINE7c,10842
 aws_lambda_powertools/utilities/data_classes/kafka_event.py,sha256=21K9iSH0sv_oj7alGWcommPUNDfto-tovIHspdIdsH4,4119
 aws_lambda_powertools/utilities/data_classes/kinesis_firehose_event.py,sha256=5H-Rt6LG80_jVkTlWxhutZH0cv4Xrhzm-fqwkpjPfQM,10508
-aws_lambda_powertools/utilities/data_classes/kinesis_stream_event.py,sha256=O42TpHCJHM5mz_b3Z65cJJ2DB19sb-b3rxced6bQB_Y,3958
+aws_lambda_powertools/utilities/data_classes/kinesis_stream_event.py,sha256=QVDKkcXQRp6T0KfjoZXkr_2U__5w9IT096jZqaoa4hI,5022
 aws_lambda_powertools/utilities/data_classes/lambda_function_url_event.py,sha256=dFhL3IYebW4WeJc1XJJYmF94gI_qYeay6EpT9b2mDZU,633
 aws_lambda_powertools/utilities/data_classes/rabbit_mq_event.py,sha256=30OBp80QTTGYdJb_YoIEFfsR5kmeftll2puB2nEw1jQ,3046
 aws_lambda_powertools/utilities/data_classes/s3_batch_operation_event.py,sha256=os7ox3SzTqgwouo0zq8HidhPexfM4jDW62gAkonAowU,8682
@@ -207,7 +207,7 @@ aws_lambda_powertools/utilities/parser/envelopes/cloudwatch.py,sha256=xERcckRMA_
 aws_lambda_powertools/utilities/parser/envelopes/dynamodb.py,sha256=fJyqT7i5dgzwuLkpK3tdvKPo_7g3VuVvKsqFYri3pJA,1731
 aws_lambda_powertools/utilities/parser/envelopes/event_bridge.py,sha256=JpstsMZsd5abf4oJvMUdo-K7x-gxHf91eR2BB9Z3rVA,1244
 aws_lambda_powertools/utilities/parser/envelopes/kafka.py,sha256=dt6aOo-ZuR7Yr6vSHWcenvKUK5ZkXi5gJrCeyjDVnWQ,1955
-aws_lambda_powertools/utilities/parser/envelopes/kinesis.py,sha256=s4M_O4O3tCKXIIhjZwrMDUmFPBeKdLSO78bbf-CpT-w,1894
+aws_lambda_powertools/utilities/parser/envelopes/kinesis.py,sha256=4PW4Sy_44LDFx77jg9aOhZaPq1GaWqf5DRSwDwu0jjY,2520
 aws_lambda_powertools/utilities/parser/envelopes/kinesis_firehose.py,sha256=lQC-duOS-AgPOyD3QSeCOCJiqrUBHO3grHtv3mPOPJw,1971
 aws_lambda_powertools/utilities/parser/envelopes/lambda_function_url.py,sha256=ppOvWaSZ5HvTp7DwrOqQIXBMiZg1Ad21DrC0rYXlzQI,1286
 aws_lambda_powertools/utilities/parser/envelopes/sns.py,sha256=F7PXKgdj3NBsTBHb4ZgPWD8trLVrZQlBoz8P94k3f1A,2987
@@ -268,7 +268,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.12.1a5.dist-info/LICENSE,sha256=vMHS2eBgmwPUIMPb7LQ4p7ib_FPVQXarVjAasflrTwo,951
-aws_lambda_powertools-3.12.1a5.dist-info/METADATA,sha256=ihnp3xY7rqB6a1-vHfAk5JQJrExCM8fHOroErK8hQ-I,11187
-aws_lambda_powertools-3.12.1a5.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
-aws_lambda_powertools-3.12.1a5.dist-info/RECORD,,
+aws_lambda_powertools-3.12.1a7.dist-info/LICENSE,sha256=vMHS2eBgmwPUIMPb7LQ4p7ib_FPVQXarVjAasflrTwo,951
+aws_lambda_powertools-3.12.1a7.dist-info/METADATA,sha256=p7BiI08p86kWMmLyALKSlr29XTbk8iZl5QLQPYH4oo0,11187
+aws_lambda_powertools-3.12.1a7.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
+aws_lambda_powertools-3.12.1a7.dist-info/RECORD,,