feat: BI-6610 add serialize_datetime to dl_httpx (#1264)

Author: ovsds

lib/dl_httpx/dl_httpx/__init__.py

@@ -17,6 +17,7 @@
     TypedSchemaDictAnnotation,
     TypedSchemaListAnnotation,
 )
+from .serializers import serialize_datetime
 from .testing import TestingHttpxClient
 
 
@@ -37,4 +38,5 @@
     "RequestHttpxClientException",
     "NoRetriesHttpxClientException",
     "TestingHttpxClient",
+    "serialize_datetime",
 ]

lib/dl_httpx/dl_httpx/serializers.py

@@ -0,0 +1,16 @@
+import datetime
+
+
+def serialize_datetime(value: datetime.datetime) -> str:
+    if value.tzinfo is None:
+        value = value.replace(tzinfo=datetime.timezone.utc)
+
+    if value.tzinfo is not datetime.timezone.utc:
+        value = value.astimezone(datetime.timezone.utc)
+
+    return value.strftime("%Y-%m-%dT%H:%M:%S.%fZ")
+
+
+__all__ = [
+    "serialize_datetime",
+]

lib/dl_httpx/dl_httpx_tests/unit/serializers/__init__.py

@@ -0,0 +1,27 @@
+import datetime
+
+import dl_httpx
+
+
+def test_no_timezone_sets_to_utc() -> None:
+    dt = datetime.datetime(2025, 1, 2, 3, 4, 5)
+    serialized_datetime = dl_httpx.serialize_datetime(dt)
+    assert serialized_datetime == "2025-01-02T03:04:05.000000Z"
+
+
+def test_with_microseconds() -> None:
+    dt = datetime.datetime(2025, 1, 2, 3, 4, 5, 6)
+    serialized_datetime = dl_httpx.serialize_datetime(dt)
+    assert serialized_datetime == "2025-01-02T03:04:05.000006Z"
+
+
+def test_with_timezone_utc() -> None:
+    dt = datetime.datetime(2025, 1, 2, 3, 4, 5, 6, datetime.timezone.utc)
+    serialized_datetime = dl_httpx.serialize_datetime(dt)
+    assert serialized_datetime == "2025-01-02T03:04:05.000006Z"
+
+
+def test_with_timezone_offset_3() -> None:
+    dt = datetime.datetime(2025, 1, 2, 3, 4, 5, 6, datetime.timezone(datetime.timedelta(hours=3)))
+    serialized_datetime = dl_httpx.serialize_datetime(dt)
+    assert serialized_datetime == "2025-01-02T00:04:05.000006Z"