boto3-assist 0.2.7__py3-none-any.whl → 0.2.9__py3-none-any.whl

boto3_assist/dynamodb/dynamodb.py

@@ -82,11 +82,20 @@ class DynamoDB(DynamoDBConnection):
         try:
             if not isinstance(item, dict):
                 # attemp to convert it
+                if not isinstance(item, DynamoDBModelBase):
+                    raise RuntimeError(
+                        f"Item is not a dictionary or DynamoDBModelBase. Type: {type(item).__name__}. "
+                        "In order to prep the model for saving, it needs to already be dictionary or support "
+                        "the to_resource_dictionary() method, which is available when you inherit from DynamoDBModelBase. "
+                        "Unable to save item to DynamoDB.  The entry was not saved."
+                    )
                 try:
                     item = item.to_resource_dictionary()
                 except Exception as e:  # pylint: disable=w0718
                     logger.exception(e)
-                    raise ValueError("Unsupported item or module was passed.") from e
+                    raise RuntimeError(
+                        "An error occured during model converation.  The entry was not saved."
+                    ) from e
 
             if isinstance(item, dict):
                 self.__log_item_size(item=item)

boto3_assist/dynamodb/dynamodb_model_base.py

@@ -234,9 +234,19 @@ class DynamoDBModelBase:
             return value.timestamp()
 
         raise ValueError(
-            "Value must be a string in a valid datetime format or datetime"
+            "Value must be a None, a string in a valid datetime format or datetime"
         )
 
+    def to_utc(self, value: str | dt.datetime | None) -> dt.datetime | None:
+        """
+        Convert a datetime to UTC. This ensures all datetimes are stored in UTC format
+
+        Exceptions:
+            ValueError: If the value is not a datetime string or datetime
+        """
+
+        value = DatetimeUtility.to_datetime_utc(value)
+
 
 class DynamoDBSerializer:
     """Library to Serialize object to a DynamoDB Format"""

boto3_assist/version.py

@@ -1 +1 @@
-__version__ = '0.2.7'
+__version__ = '0.2.9'

{boto3_assist-0.2.7.dist-info → boto3_assist-0.2.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boto3_assist
-Version: 0.2.7
+Version: 0.2.9
 Summary: Additional boto3 wrappers to make your life a little easier
 Author-email: Eric Wilson <boto3-assist@geekcafe.com>
 License-File: LICENSE-EXPLAINED.txt

{boto3_assist-0.2.7.dist-info → boto3_assist-0.2.9.dist-info}/RECORD

@@ -2,13 +2,13 @@ boto3_assist/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 boto3_assist/boto3session.py,sha256=NWhWtYR3143thEbTpoklkwdz77-fTMs-QsoQdqfRm6E,6430
 boto3_assist/connection.py,sha256=EJlGueLIYqMSKs7aQlThK1S0Zkb8dOYBWch1iRZdgUI,3233
 boto3_assist/connection_tracker.py,sha256=_s1t7h2DOi3CCIHIr_HIKyGjku65WR-HJ_v8vJHDvO0,2977
-boto3_assist/version.py,sha256=e3cfQy_iVs9ILsymUalJnJu5D_dd7HuUVoVwKKurcL0,22
+boto3_assist/version.py,sha256=bd8hlxKMc0Fh_2w5GWfqBtuwa8uTepTMjT8w7F-EKvY,22
 boto3_assist/cloudwatch/cloudwatch_connection.py,sha256=mnGWaLSQpHh5EeY7Ek_2o9JKHJxOELIYtQVMX1IaHn4,2480
 boto3_assist/cloudwatch/cloudwatch_connection_tracker.py,sha256=mzRtO1uHrcfJNh1XrGEiXdTqxwEP8d1RqJkraMNkgK0,410
 boto3_assist/cloudwatch/cloudwatch_log_connection.py,sha256=qQMZHjUJ6gA8wU9utjQhOURXNSPH2RjxSoAy83bvoCs,1737
 boto3_assist/cloudwatch/cloudwatch_logs.py,sha256=VtI0OnFjX1l4RYVvA8tvveGkPwAogtrplnflZ4dQSNM,1204
 boto3_assist/cloudwatch/cloudwatch_query.py,sha256=uNhSb1Gfp99v8BaHmCnCKs63j4MMU4WveqBavCJyhGY,6409
-boto3_assist/dynamodb/dynamodb.py,sha256=oYmTTPRMCjWuIJnHW6z9diBfblzDCLxy_BOvWfprDM8,15147
+boto3_assist/dynamodb/dynamodb.py,sha256=PVWALqf5f8ftsf3U5xcNFo_32HQmysgkNbucMwope4w,15771
 boto3_assist/dynamodb/dynamodb_connection.py,sha256=hr4IGbbEE73fh375tj3_XtYAwwDV0s7z1-6JK_1Tc30,5263
 boto3_assist/dynamodb/dynamodb_connection_tracker.py,sha256=0BWHRfi5_vjkJLuCSX6sYwvA6wc7BSYCQnGrzbhfyKA,404
 boto3_assist/dynamodb/dynamodb_helpers.py,sha256=ajpTJ5bJOm9PDgE2Zx9p2zkTRFV4xswqJRS81SOTn1s,12198
@@ -16,7 +16,7 @@ boto3_assist/dynamodb/dynamodb_importer.py,sha256=nCKsyRQeMqDSf0Q5mQ_X_oVIg4PRnu
 boto3_assist/dynamodb/dynamodb_index.py,sha256=7xa2bN3o8P7XIN9CcJiU7_i1MVjZPl6ZPVZqbZr8pS4,7747
 boto3_assist/dynamodb/dynamodb_iservice.py,sha256=O9Aj0PFEvcuk2vhARifWTFnUwcQW5EXzwZS478Hm-N0,796
 boto3_assist/dynamodb/dynamodb_key.py,sha256=YD7o1EUlwVBQ55p9YCTKqAUU_np4nqtLIHnmp-BeolM,1803
-boto3_assist/dynamodb/dynamodb_model_base.py,sha256=ni8WGWMVW_238lo9UrgONbHu-to2_PfcuPtFDQ-0mgk,15003
+boto3_assist/dynamodb/dynamodb_model_base.py,sha256=RpVhh88Bvg0aPO5Ux1yliFc8-INQfWdMsXo3mk_Clw8,15351
 boto3_assist/dynamodb/dynamodb_model_base_interfaces.py,sha256=yT4zDRI8vP15WVOHnCvY3FsEy_QSIta5-bnUby70Xow,747
 boto3_assist/dynamodb/dynamodb_reindexer.py,sha256=bCj6KIU0fQOgjkkiq9yF51PFZZr4Y9Lu3-hPlmsPG0Y,6164
 boto3_assist/dynamodb/dynamodb_reserved_words.py,sha256=p0irNBSqGe4rd2FwWQqbRJWrNr4svdbWiyIXmz9lj4c,1937
@@ -36,8 +36,8 @@ boto3_assist/utilities/http_utility.py,sha256=koFv7Va-8ng-47Nt1K2Sh7Ti95e62IYs9V
 boto3_assist/utilities/logging_utility.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 boto3_assist/utilities/serialization_utility.py,sha256=s_QQRIhtwIE7xN5nU13mNk2wtWyErBX_Sg7n0gbHj-M,4308
 boto3_assist/utilities/string_utility.py,sha256=w8l063UT3GE48tuJopETyZrjG4CgAzWkyDWMAYMg5Og,7432
-boto3_assist-0.2.7.dist-info/METADATA,sha256=BpAKDCRt1Rnl6IZQIpvJCWznzr3TzXlsISLEv_NIJYw,1707
-boto3_assist-0.2.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-boto3_assist-0.2.7.dist-info/licenses/LICENSE-EXPLAINED.txt,sha256=WFREvTpfTjPjDHpOLADxJpCKpIla3Ht87RUUGii4ODU,606
-boto3_assist-0.2.7.dist-info/licenses/LICENSE.txt,sha256=PXDhFWS5L5aOTkVhNvoitHKbAkgxqMI2uUPQyrnXGiI,1105
-boto3_assist-0.2.7.dist-info/RECORD,,
+boto3_assist-0.2.9.dist-info/METADATA,sha256=i463YtqFRnpN9R6CpO4LNt5Esk0EJW9-XW5uLx1riqM,1707
+boto3_assist-0.2.9.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+boto3_assist-0.2.9.dist-info/licenses/LICENSE-EXPLAINED.txt,sha256=WFREvTpfTjPjDHpOLADxJpCKpIla3Ht87RUUGii4ODU,606
+boto3_assist-0.2.9.dist-info/licenses/LICENSE.txt,sha256=PXDhFWS5L5aOTkVhNvoitHKbAkgxqMI2uUPQyrnXGiI,1105
+boto3_assist-0.2.9.dist-info/RECORD,,