dycw-utilities 0.138.15__tar.gz → 0.138.16__tar.gz

{dycw_utilities-0.138.15 → dycw_utilities-0.138.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dycw-utilities
-Version: 0.138.15
+Version: 0.138.16
 Author-email: Derek Wan <d.wan@icloud.com>
 License-File: LICENSE
 Requires-Python: >=3.12

{dycw_utilities-0.138.15 → dycw_utilities-0.138.16}/pyproject.toml

@@ -106,7 +106,7 @@ dependencies = [
 name = "dycw-utilities"
 readme = "README.md"
 requires-python = ">= 3.12"
-version = "0.138.15"
+version = "0.138.16"
 
 [project.entry-points.pytest11]
 pytest-regressions = "utilities.pytest_regressions_plugin"
@@ -137,7 +137,7 @@ test = [
 # bump-my-version
 [tool.bumpversion]
 allow_dirty = true
-current_version = "0.138.15"
+current_version = "0.138.16"
 
 [[tool.bumpversion.files]]
 filename = "src/utilities/__init__.py"

{dycw_utilities-0.138.15 → dycw_utilities-0.138.16}/src/tests/test_whenever.py

@@ -94,6 +94,7 @@ from utilities.whenever import (
     to_local_plain,
     to_months,
     to_nanos,
+    to_py_date_or_date_time,
     to_py_time_delta,
     to_time_delta,
     to_zoned_date_time,
@@ -608,6 +609,28 @@ class TestToMonths:
             _ = to_months(delta)
 
 
+class TestToPyDateOrDateTime:
+    @mark.parametrize(
+        ("date_or_date_time", "expected"),
+        [
+            param(Date(2000, 1, 1), dt.date(2000, 1, 1)),
+            param(
+                ZonedDateTime(2000, 1, 1, tz=UTC.key),
+                dt.datetime(2000, 1, 1, tzinfo=UTC),
+            ),
+            param(None, None),
+        ],
+    )
+    def test_main(
+        self,
+        *,
+        date_or_date_time: Date | ZonedDateTime | None,
+        expected: dt.date | None,
+    ) -> None:
+        result = to_py_date_or_date_time(date_or_date_time)
+        assert result == expected
+
+
 class TestToPyTimeDelta:
     @mark.parametrize(
         ("delta", "expected"),
@@ -618,10 +641,14 @@ class TestToPyTimeDelta:
                 DateTimeDelta(days=1, microseconds=1),
                 dt.timedelta(days=1, microseconds=1),
             ),
+            param(None, None),
         ],
     )
     def test_main(
-        self, *, delta: DateDelta | TimeDelta | DateTimeDelta, expected: dt.timedelta
+        self,
+        *,
+        delta: DateDelta | TimeDelta | DateTimeDelta | None,
+        expected: dt.timedelta | None,
     ) -> None:
         result = to_py_time_delta(delta)
         assert result == expected

{dycw_utilities-0.138.15 → dycw_utilities-0.138.16}/src/utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.138.15"
+__version__ = "0.138.16"

{dycw_utilities-0.138.15 → dycw_utilities-0.138.16}/src/utilities/whenever.py

@@ -636,7 +636,39 @@ class ToNanosError(Exception):
 ##
 
 
-def to_py_time_delta(delta: DateDelta | TimeDelta | DateTimeDelta, /) -> dt.timedelta:
+@overload
+def to_py_date_or_date_time(date_or_date_time: Date, /) -> dt.date: ...
+@overload
+def to_py_date_or_date_time(date_or_date_time: ZonedDateTime, /) -> dt.datetime: ...
+@overload
+def to_py_date_or_date_time(date_or_date_time: None, /) -> None: ...
+def to_py_date_or_date_time(
+    date_or_date_time: Date | ZonedDateTime | None, /
+) -> dt.date | None:
+    """Convert a Date or ZonedDateTime into a standard library equivalent."""
+    match date_or_date_time:
+        case Date() as date:
+            return date.py_date()
+        case ZonedDateTime() as date_time:
+            return date_time.py_datetime()
+        case None:
+            return None
+        case _ as never:
+            assert_never(never)
+
+
+##
+
+
+@overload
+def to_py_time_delta(
+    delta: DateDelta | TimeDelta | DateTimeDelta, /
+) -> dt.timedelta: ...
+@overload
+def to_py_time_delta(delta: None, /) -> None: ...
+def to_py_time_delta(
+    delta: DateDelta | TimeDelta | DateTimeDelta | None, /
+) -> dt.timedelta | None:
     """Try convert a DateDelta to a standard library timedelta."""
     match delta:
         case DateDelta():
@@ -651,6 +683,8 @@ def to_py_time_delta(delta: DateDelta | TimeDelta | DateTimeDelta, /) -> dt.time
             return to_py_time_delta(delta.date_part()) + to_py_time_delta(
                 delta.time_part()
             )
+        case None:
+            return None
         case _ as never:
             assert_never(never)
 
@@ -888,6 +922,7 @@ __all__ = [
     "to_local_plain",
     "to_months",
     "to_nanos",
+    "to_py_date_or_date_time",
     "to_py_time_delta",
     "to_zoned_date_time",
     "two_digit_year_month",