boto3-assist 0.2.7__tar.gz → 0.2.9__tar.gz

{boto3_assist-0.2.7 → boto3_assist-0.2.9}/PKG-INFO

@@ -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 → boto3_assist-0.2.9}/pyproject.toml

@@ -7,7 +7,7 @@ packages = ["src/boto3_assist"]
 
 [project]
 name = "boto3_assist"
-version = "0.2.7"
+version = "0.2.9"
 
 authors = [
   { name="Eric Wilson", email="boto3-assist@geekcafe.com" }

boto3_assist-0.2.9/requirements-dev.txt

@@ -0,0 +1,18 @@
+boto3-stubs[dynamodb]
+build
+mypy
+mypy_boto3_dynamodb
+mypy_boto3_ec2
+mypy_boto3_cloudwatch
+mypy_boto3_s3
+moto [dynamodb2] # mocks for unit tests
+# setuptools
+types-python-dateutil
+toml
+twine
+wheel
+pkginfo # occasionally we need to upgrade this or we can get upload errors when it's out of sync
+# the error may look like the following
+# ERROR    InvalidDistribution: Metadata is missing required fields: Name, Version.                                                
+#          Make sure the distribution includes the files where those fields are specified, and is using a supported                
+#          Metadata-Version: 1.0, 1.1, 1.2, 2.0, 2.1, 2.2, 2.3. 

{boto3_assist-0.2.7 → boto3_assist-0.2.9}/src/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-0.2.7 → boto3_assist-0.2.9}/src/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-0.2.9/src/boto3_assist/version.py

@@ -0,0 +1 @@
+__version__ = '0.2.9'

boto3_assist-0.2.7/requirements-dev.txt

@@ -1,13 +0,0 @@
-boto3-stubs[dynamodb]
-build
-mypy
-mypy_boto3_dynamodb
-mypy_boto3_ec2
-mypy_boto3_cloudwatch
-mypy_boto3_s3
-moto [dynamodb2] # mocks for unit tests
-# setuptools
-types-python-dateutil
-toml
-twine
-wheel

boto3_assist-0.2.7/src/boto3_assist/version.py

@@ -1 +0,0 @@
-__version__ = '0.2.7'