boto3-assist 0.2.6__tar.gz → 0.2.8__tar.gz

{boto3_assist-0.2.6 → boto3_assist-0.2.8}/PKG-INFO

@@ -1,22 +1,22 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: boto3_assist
-Version: 0.2.6
+Version: 0.2.8
 Summary: Additional boto3 wrappers to make your life a little easier
 Author-email: Eric Wilson <boto3-assist@geekcafe.com>
+License-File: LICENSE-EXPLAINED.txt
+License-File: LICENSE.txt
 Classifier: License :: Other/Proprietary License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.10
-Requires-Dist: aws-lambda-powertools==2.38.1
+Requires-Dist: aws-lambda-powertools
 Requires-Dist: aws-xray-sdk
-Requires-Dist: boto3==1.34.110
-Requires-Dist: jsons==1.6.3
+Requires-Dist: boto3
+Requires-Dist: jsons
 Requires-Dist: python-dateutil
 Requires-Dist: python-dotenv
-Requires-Dist: python-dotenv==1.0.1
 Requires-Dist: pytz
-Requires-Dist: pytz==2024.1
-Requires-Dist: requests==2.31.0
+Requires-Dist: requests
 Requires-Dist: types-python-dateutil
 Description-Content-Type: text/markdown
 

{boto3_assist-0.2.6 → boto3_assist-0.2.8}/pyproject.toml

@@ -7,7 +7,8 @@ packages = ["src/boto3_assist"]
 
 [project]
 name = "boto3_assist"
-version = "0.2.6"
+version = "0.2.8"
+
 authors = [
   { name="Eric Wilson", email="boto3-assist@geekcafe.com" }
 ]
@@ -21,15 +22,14 @@ classifiers = [
 ]
 
 dependencies = [
-  "jsons==1.6.3",
-  "aws-lambda-powertools==2.38.1",
+  "jsons",
+  "aws-lambda-powertools",
   "aws-xray-sdk",
-  "boto3==1.34.110",    
-  "pytz==2024.1",
-  "python-dotenv==1.0.1",        
-  "python-dateutil",
-  "python-dotenv",
+  "boto3",    
+  "pytz",
+  "python-dotenv",        
+  "python-dateutil",  
   "pytz",
-  "requests==2.31.0",
+  "requests",
   "types-python-dateutil",  
 ]

boto3_assist-0.2.8/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.6 → boto3_assist-0.2.8}/src/boto3_assist/dynamodb/dynamodb_model_base.py

@@ -18,6 +18,7 @@ from boto3_assist.dynamodb.dynamodb_index import (
     DynamoDBIndex,
 )
 from boto3_assist.dynamodb.dynamodb_reserved_words import DynamoDBReservedWords
+from boto3_assist.utilities.datetime_utility import DatetimeUtility
 
 
 def exclude_from_serialization(method):
@@ -214,6 +215,38 @@ class DynamoDBModelBase:
 
         return values
 
+    def to_timestamp_or_none(self, value: str | dt.datetime | None) -> float | None:
+        """
+        Convert a value to a timestamp (float) or None
+
+        Exceptions:
+            ValueError: If the value is not a datetime string or datetime
+        """
+
+        if isinstance(value, str):
+            # value = dt.datetime.fromisoformat(value)
+            value = DatetimeUtility.to_datetime_utc(value)
+
+        if value is None:
+            return None
+
+        if isinstance(value, dt.datetime):
+            return value.timestamp()
+
+        raise ValueError(
+            "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.8/src/boto3_assist/version.py

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

boto3_assist-0.2.6/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.6/src/boto3_assist/version.py

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