aws-lambda-powertools 3.6.1a9__py3-none-any.whl → 3.7.1a0__py3-none-any.whl

aws_lambda_powertools/shared/version.py

@@ -1,3 +1,3 @@
 """Exposes version constant to avoid circular dependencies."""
 
-VERSION = "3.6.1a9"
+VERSION = "3.7.1a0"

aws_lambda_powertools/utilities/data_classes/iot_registry_event.py

@@ -0,0 +1,418 @@
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any, Literal
+
+from aws_lambda_powertools.utilities.data_classes.common import DictWrapper
+
+EVENT_CRUD_OPERATION = Literal["CREATED", "UPDATED", "DELETED"]
+EVENT_ADD_REMOVE_OPERATION = Literal["ADDED", "REMOVED"]
+
+
+class IoTCoreRegistryEventsBase(DictWrapper):
+    @property
+    def event_id(self) -> str:
+        """
+        The unique identifier for the event.
+        """
+        return self["eventId"]
+
+    @property
+    def timestamp(self) -> datetime:
+        """
+        The timestamp of the event.
+
+        The timestamp is in Unix format (seconds or milliseconds).
+        If it's 10 digits long, it represents seconds;
+        if it's 13 digits, it's in milliseconds and is converted to seconds.
+        """
+        ts = self["timestamp"]
+        return datetime.fromtimestamp(ts / 1000 if ts > 10**10 else ts)
+
+
+class IoTCoreThingEvent(IoTCoreRegistryEventsBase):
+    """
+    Thing Created/Updated/Deleted
+    The registry publishes event messages when things are created, updated, or deleted.
+    """
+
+    @property
+    def event_type(self) -> Literal["THING_EVENT"]:
+        """
+        The event type, which will always be "THING_EVENT".
+        """
+        return self["eventType"]
+
+    @property
+    def operation(self) -> str:
+        """
+        The operation type for the event (e.g., CREATED, UPDATED, DELETED).
+        """
+        return self["operation"]
+
+    @property
+    def thing_id(self) -> str:
+        """
+        The unique identifier for the thing.
+        """
+        return self["thingId"]
+
+    @property
+    def account_id(self) -> str:
+        """
+        The account ID associated with the event.
+        """
+        return self["accountId"]
+
+    @property
+    def thing_name(self) -> str:
+        """
+        The name of the thing.
+        """
+        return self["thingName"]
+
+    @property
+    def version_number(self) -> int:
+        """
+        The version number of the thing.
+        """
+        return self["versionNumber"]
+
+    @property
+    def thing_type_name(self) -> str | None:
+        """
+        The thing type name if available, or None if not specified.
+        """
+        return self.get("thingTypeName")
+
+    @property
+    def attributes(self) -> dict[str, Any]:
+        """
+        The dictionary of attributes associated with the thing.
+        """
+        return self["attributes"]
+
+
+class IoTCoreThingTypeEvent(IoTCoreRegistryEventsBase):
+    """
+    Thing Type Created/Updated/Deprecated/Undeprecated/Deleted
+    The registry publishes event messages when thing types are created, updated, deprecated, undeprecated, or deleted.
+    """
+
+    @property
+    def event_type(self) -> str:
+        """
+        The event type, corresponding to a thing type event.
+        """
+        return self["eventType"]
+
+    @property
+    def operation(self) -> EVENT_CRUD_OPERATION:
+        """
+        The operation performed on the thing type (e.g., CREATED, UPDATED, DELETED).
+        """
+        return self["operation"]
+
+    @property
+    def account_id(self) -> str:
+        """
+        The account ID associated with the event.
+        """
+        return self["accountId"]
+
+    @property
+    def thing_type_id(self) -> str:
+        """
+        The unique identifier for the thing type.
+        """
+        return self["thingTypeId"]
+
+    @property
+    def thing_type_name(self) -> str:
+        """
+        The name of the thing type.
+        """
+        return self["thingTypeName"]
+
+    @property
+    def is_deprecated(self) -> bool:
+        """
+        Whether the thing type is marked as deprecated.
+        """
+        return self["isDeprecated"]
+
+    @property
+    def deprecation_date(self) -> datetime | None:
+        """
+        The deprecation date of the thing type, or None if not available.
+        """
+        return datetime.fromisoformat(self["deprecationDate"]) if self.get("deprecationDate") else None
+
+    @property
+    def searchable_attributes(self) -> list[str]:
+        """
+        The list of attributes that are searchable for the thing type.
+        """
+        return self["searchableAttributes"]
+
+    @property
+    def propagating_attributes(self) -> list[dict[str, str]]:
+        """
+        The list of attributes to propagate for the thing type.
+        """
+        return self["propagatingAttributes"]
+
+    @property
+    def description(self) -> str:
+        """
+        The description of the thing type.
+        """
+        return self["description"]
+
+
+class IoTCoreThingTypeAssociationEvent(IoTCoreRegistryEventsBase):
+    """
+    The registry publishes event messages when a thing type is associated or disassociated with a thing.
+    """
+
+    @property
+    def event_type(self) -> str:
+        """
+        The event type, related to the thing type association event.
+        """
+        return self["eventType"]
+
+    @property
+    def operation(self) -> Literal["THING_TYPE_ASSOCIATION_EVENT"]:
+        """
+        The operation type, which is always "THING_TYPE_ASSOCIATION_EVENT".
+        """
+        return self["operation"]
+
+    @property
+    def thing_id(self) -> str:
+        """
+        The unique identifier for the associated thing.
+        """
+        return self["thingId"]
+
+    @property
+    def thing_name(self) -> str:
+        """
+        The name of the associated thing.
+        """
+        return self["thingName"]
+
+    @property
+    def thing_type_name(self) -> str:
+        """
+        The name of the associated thing type.
+        """
+        return self["thingTypeName"]
+
+
+class IoTCoreThingGroupEvent(IoTCoreRegistryEventsBase):
+    """
+    The registry publishes event messages when a thing group is created, updated, or deleted.
+    """
+
+    @property
+    def event_type(self) -> str:
+        """
+        The event type, corresponding to the thing group event.
+        """
+        return self["eventType"]
+
+    @property
+    def operation(self) -> EVENT_CRUD_OPERATION:
+        """
+        The operation type (e.g., CREATED, UPDATED, DELETED) performed on the thing group.
+        """
+        return self["operation"]
+
+    @property
+    def account_id(self) -> str:
+        """
+        The account ID associated with the event.
+        """
+        return self["accountId"]
+
+    @property
+    def thing_group_id(self) -> str:
+        """
+        The unique identifier for the thing group.
+        """
+        return self["thingGroupId"]
+
+    @property
+    def thing_group_name(self) -> str:
+        """
+        The name of the thing group.
+        """
+        return self["thingGroupName"]
+
+    @property
+    def version_number(self) -> int:
+        """
+        The version number of the thing group.
+        """
+        return self["versionNumber"]
+
+    @property
+    def parent_group_name(self) -> str | None:
+        """
+        The name of the parent group, or None if not applicable.
+        """
+        return self.get("parentGroupName")
+
+    @property
+    def parent_group_id(self) -> str | None:
+        """
+        The ID of the parent group, or None if not applicable.
+        """
+        return self.get("parentGroupId")
+
+    @property
+    def description(self) -> str:
+        """
+        The description of the thing group.
+        """
+        return self["description"]
+
+    @property
+    def root_to_parent_thing_groups(self) -> list[dict[str, str]]:
+        """
+        The list of root-to-parent thing group mappings.
+        """
+        return self["rootToParentThingGroups"]
+
+    @property
+    def attributes(self) -> dict[str, Any]:
+        """
+        The attributes associated with the thing group.
+        """
+        return self["attributes"]
+
+    @property
+    def dynamic_group_mapping_id(self) -> str | None:
+        """
+        The dynamic group mapping ID if available, or None if not specified.
+        """
+        return self.get("dynamicGroupMappingId")
+
+
+class IoTCoreAddOrRemoveFromThingGroupEvent(IoTCoreRegistryEventsBase):
+    """
+    The registry publishes event messages when a thing is added to or removed from a thing group.
+    """
+
+    @property
+    def event_type(self) -> str:
+        """
+        The event type, corresponding to the add/remove from thing group event.
+        """
+        return self["eventType"]
+
+    @property
+    def operation(self) -> EVENT_ADD_REMOVE_OPERATION:
+        """
+        The operation (ADDED or REMOVED) performed on the thing in the group.
+        """
+        return self["operation"]
+
+    @property
+    def account_id(self) -> str:
+        """
+        The account ID associated with the event.
+        """
+        return self["accountId"]
+
+    @property
+    def group_arn(self) -> str:
+        """
+        The ARN of the group the thing was added to or removed from.
+        """
+        return self["groupArn"]
+
+    @property
+    def group_id(self) -> str:
+        """
+        The unique identifier of the group.
+        """
+        return self["groupId"]
+
+    @property
+    def thing_arn(self) -> str:
+        """
+        The ARN of the thing being added or removed.
+        """
+        return self["thingArn"]
+
+    @property
+    def thing_id(self) -> str:
+        """
+        The unique identifier for the thing being added or removed.
+        """
+        return self["thingId"]
+
+    @property
+    def membership_id(self) -> str:
+        """
+        The unique membership ID for the thing within the group.
+        """
+        return self["membershipId"]
+
+
+class IoTCoreAddOrDeleteFromThingGroupEvent(IoTCoreRegistryEventsBase):
+    """
+    The registry publishes event messages when a child group is added to or deleted from a parent group.
+    """
+
+    @property
+    def event_type(self) -> str:
+        """
+        The event type, corresponding to the add/delete from thing group event.
+        """
+        return self["eventType"]
+
+    @property
+    def operation(self) -> EVENT_ADD_REMOVE_OPERATION:
+        """
+        The operation (ADDED or REMOVED) performed on the child group.
+        """
+        return self["operation"]
+
+    @property
+    def account_id(self) -> str:
+        """
+        The account ID associated with the event.
+        """
+        return self["accountId"]
+
+    @property
+    def thing_group_id(self) -> str:
+        """
+        The unique identifier of the thing group.
+        """
+        return self["thingGroupId"]
+
+    @property
+    def thing_group_name(self) -> str:
+        """
+        The name of the thing group.
+        """
+        return self["thingGroupName"]
+
+    @property
+    def child_group_id(self) -> str:
+        """
+        The unique identifier of the child group being added or removed.
+        """
+        return self["childGroupId"]
+
+    @property
+    def child_group_name(self) -> str:
+        """
+        The name of the child group being added or removed.
+        """
+        return self["childGroupName"]

{aws_lambda_powertools-3.6.1a9.dist-info → aws_lambda_powertools-3.7.1a0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: aws_lambda_powertools
-Version: 3.6.1a9
+Version: 3.7.1a0
 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.6.1a9.dist-info → aws_lambda_powertools-3.7.1a0.dist-info}/RECORD

@@ -83,7 +83,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=APkI38HbiTpSF19NSNii8Ydx73vmVUVotgEQ9jHruEI,124
 aws_lambda_powertools/shared/user_agent.py,sha256=DrCMFQuT4a4iIrpcWpAIjY37EFqR9-QxlxDGD-Nn9Gg,7081
-aws_lambda_powertools/shared/version.py,sha256=WZ6eerS4hr2Ba7_-XkiL0HCPEGMaI_xEwKa609r6xLU,84
+aws_lambda_powertools/shared/version.py,sha256=ILjLMM6Ed-2HVhr0dTOPKCJ15XN8wX1EuNrp4XLBMic,84
 aws_lambda_powertools/tracing/__init__.py,sha256=f4bMThOPBPWTPVcYqcAIErAJPerMsf3H_Z4gCXCsK9I,141
 aws_lambda_powertools/tracing/base.py,sha256=DbLD8OSK05KLdSV36oNA5wDSGv8KbcOD19qMUqoXh58,4513
 aws_lambda_powertools/tracing/extensions.py,sha256=APOfXOq-hRBKaK5WyfIyrd_6M1_9SWJZ3zxLA9jDZzU,492
@@ -118,6 +118,7 @@ aws_lambda_powertools/utilities/data_classes/connect_contact_flow_event.py,sha25
 aws_lambda_powertools/utilities/data_classes/dynamo_db_stream_event.py,sha256=BrgOyFREC9gjj_ULhKB3L_7EbQ6ptV-8Was1TulPeWE,6102
 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=hANsq_sZjFtDzV0ju47iSYwKcsn5Byk6ww0F2jUpMKw,1179
+aws_lambda_powertools/utilities/data_classes/iot_registry_event.py,sha256=wUa0Gr64maNGkd9qKNxtwFHawIJN-nj9X8uLFdINE7c,10842
 aws_lambda_powertools/utilities/data_classes/kafka_event.py,sha256=BwkrEfGvmv0LvVpMsQeIzuX08QeWl9dVFjrbgSYL8Bs,3764
 aws_lambda_powertools/utilities/data_classes/kinesis_firehose_event.py,sha256=ea7Eq6ccBMhRHZzAYWwukwUJtRVi80DRej8VnixPJNU,10722
 aws_lambda_powertools/utilities/data_classes/kinesis_stream_event.py,sha256=vGQRJeoqE2Poqpis9d4FaF-ekdJxZzFYsJJMrv7ThhE,3943
@@ -250,7 +251,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=x_1qpuKJBuWpgNU-zCD3Di-vXrZfyUu7oA5RmjZjr84,10034
 aws_lambda_powertools/warnings/__init__.py,sha256=vqDVeZz8wGtD8WGYNSkQE7AHwqtIrPGRxuoJR_BBnSs,1193
-aws_lambda_powertools-3.6.1a9.dist-info/LICENSE,sha256=vMHS2eBgmwPUIMPb7LQ4p7ib_FPVQXarVjAasflrTwo,951
-aws_lambda_powertools-3.6.1a9.dist-info/METADATA,sha256=BVIInOdbgjfb0wQv9NyspRw14pno95Rckb5MbVro3P8,11151
-aws_lambda_powertools-3.6.1a9.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
-aws_lambda_powertools-3.6.1a9.dist-info/RECORD,,
+aws_lambda_powertools-3.7.1a0.dist-info/LICENSE,sha256=vMHS2eBgmwPUIMPb7LQ4p7ib_FPVQXarVjAasflrTwo,951
+aws_lambda_powertools-3.7.1a0.dist-info/METADATA,sha256=kdq4S1vY3Ub_0kDX7wvB3vfu1utVHXe_hsL31uuHVo0,11151
+aws_lambda_powertools-3.7.1a0.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
+aws_lambda_powertools-3.7.1a0.dist-info/RECORD,,