dycw-utilities 0.131.5__tar.gz → 0.131.6__tar.gz

{dycw_utilities-0.131.5 → dycw_utilities-0.131.6}/PKG-INFO

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

{dycw_utilities-0.131.5 → dycw_utilities-0.131.6}/pyproject.toml

@@ -94,7 +94,7 @@ dependencies = [
 name = "dycw-utilities"
 readme = "README.md"
 requires-python = ">= 3.12"
-version = "0.131.5"
+version = "0.131.6"
 
 [project.optional-dependencies]
 logging = [
@@ -121,7 +121,7 @@ test = [
 # bump-my-version
 [tool.bumpversion]
 allow_dirty = true
-current_version = "0.131.5"
+current_version = "0.131.6"
 
 [[tool.bumpversion.files]]
 filename = "src/utilities/__init__.py"

{dycw_utilities-0.131.5 → dycw_utilities-0.131.6}/src/tests/test_whenever2.py

@@ -6,11 +6,12 @@ from zoneinfo import ZoneInfo
 from hypothesis import given
 from hypothesis.strategies import just, timezones
 from pytest import mark, param, raises
-from whenever import DateDelta, DateTimeDelta, TimeDelta, ZonedDateTime
+from whenever import Date, DateDelta, DateTimeDelta, TimeDelta, ZonedDateTime
 
 from tests.conftest import IS_CI
 from utilities.hypothesis import zoned_datetimes_whenever
 from utilities.tzdata import HongKong, Tokyo
+from utilities.tzlocal import LOCAL_TIME_ZONE
 from utilities.whenever2 import (
     DATE_DELTA_MAX,
     DATE_DELTA_MIN,
@@ -22,11 +23,14 @@ from utilities.whenever2 import (
     DATE_TIME_DELTA_MIN,
     DATE_TIME_DELTA_PARSABLE_MAX,
     DATE_TIME_DELTA_PARSABLE_MIN,
+    NOW_LOCAL,
     NOW_UTC,
     PLAIN_DATE_TIME_MAX,
     PLAIN_DATE_TIME_MIN,
     TIME_DELTA_MAX,
     TIME_DELTA_MIN,
+    TODAY_LOCAL,
+    TODAY_UTC,
     ZONED_DATE_TIME_MAX,
     ZONED_DATE_TIME_MIN,
     WheneverLogRecord,
@@ -35,6 +39,8 @@ from utilities.whenever2 import (
     from_timestamp_nanos,
     get_now,
     get_now_local,
+    get_today,
+    get_today_local,
 )
 from utilities.zoneinfo import UTC
 
@@ -81,6 +87,28 @@ class TestGetNowLocal:
         time_zones = {ETC, HongKong, Tokyo, UTC}
         assert any(now.tz == time_zone.key for time_zone in time_zones)
 
+    def test_constant(self) -> None:
+        assert isinstance(NOW_LOCAL, ZonedDateTime)
+        assert NOW_LOCAL.tz == LOCAL_TIME_ZONE.key
+
+
+class TestGetToday:
+    def test_function(self) -> None:
+        today = get_today()
+        assert isinstance(today, Date)
+
+    def test_constant(self) -> None:
+        assert isinstance(TODAY_UTC, Date)
+
+
+class TestGetTodayLocal:
+    def test_function(self) -> None:
+        today = get_today_local()
+        assert isinstance(today, Date)
+
+    def test_constant(self) -> None:
+        assert isinstance(TODAY_LOCAL, Date)
+
 
 class TestMinMax:
     def test_date_min(self) -> None:
@@ -151,19 +179,19 @@ class TestMinMax:
 
     def test_date_time_delta_parsable_min(self) -> None:
         def func(delta: DateTimeDelta, /) -> None:
-            _ = DateDelta.parse_common_iso(delta.format_common_iso())
+            _ = DateTimeDelta.parse_common_iso(delta.format_common_iso())
 
         _ = func(DATE_TIME_DELTA_PARSABLE_MIN)
-        with raises(ValueError, match="Invalid format: '.*'"):
+        with raises(ValueError, match="Addition result out of bounds"):
             _ = func(DATE_TIME_DELTA_PARSABLE_MIN - DateTimeDelta(nanoseconds=1))
 
     def test_date_time_delta_parsable_max(self) -> None:
         def func(delta: DateTimeDelta, /) -> None:
-            _ = DateDelta.parse_common_iso(delta.format_common_iso())
+            _ = DateTimeDelta.parse_common_iso(delta.format_common_iso())
 
         _ = func(DATE_TIME_DELTA_PARSABLE_MAX)
-        with raises(ValueError, match="Invalid format: '.*'"):
-            _ = func(DATE_TIME_DELTA_PARSABLE_MAX + DateTimeDelta(nanoseconds=1))
+        with raises(ValueError, match="Invalid format or out of range: '.*'"):
+            _ = func(DATE_TIME_DELTA_PARSABLE_MAX + TimeDelta(nanoseconds=1))
 
     def test_plain_date_time_min(self) -> None:
         with raises(ValueError, match=r"Result of subtract\(\) out of range"):
@@ -184,6 +212,7 @@ class TestMinMax:
         ],
     )
     def test_time_delta_min(self, *, delta: TimeDelta) -> None:
+        _ = TimeDelta.parse_common_iso(TIME_DELTA_MIN.format_common_iso())
         with raises(ValueError, match="Addition result out of range"):
             _ = TIME_DELTA_MIN - delta
 
@@ -202,6 +231,7 @@ class TestMinMax:
     def test_time_delta_max(self, *, delta: TimeDelta, is_ok: bool) -> None:
         if is_ok:
             _ = TIME_DELTA_MAX + delta
+            _ = TimeDelta.parse_common_iso(delta.format_common_iso())
         else:
             with raises(ValueError, match="Addition result out of range"):
                 _ = TIME_DELTA_MAX + delta

{dycw_utilities-0.131.5 → dycw_utilities-0.131.6}/src/utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.131.5"
+__version__ = "0.131.6"

{dycw_utilities-0.131.5 → dycw_utilities-0.131.6}/src/utilities/whenever2.py

@@ -5,7 +5,15 @@ from functools import cache
 from logging import LogRecord
 from typing import TYPE_CHECKING, Any, override
 
-from whenever import Date, DateTimeDelta, PlainDateTime, ZonedDateTime
+from whenever import (
+    Date,
+    DateDelta,
+    DateTimeDelta,
+    PlainDateTime,
+    Time,
+    TimeDelta,
+    ZonedDateTime,
+)
 
 from utilities.zoneinfo import UTC, get_time_zone_name
 
@@ -15,8 +23,15 @@ if TYPE_CHECKING:
     from utilities.types import TimeZoneLike
 
 
+## bounds
+
+
 DATE_MIN = Date.from_py_date(dt.date.min)
 DATE_MAX = Date.from_py_date(dt.date.max)
+TIME_MIN = Time.from_py_time(dt.time.min)
+TIME_MAX = Time.from_py_time(dt.time.max)
+
+
 PLAIN_DATE_TIME_MIN = PlainDateTime.from_py_datetime(dt.datetime.min)  # noqa: DTZ901
 PLAIN_DATE_TIME_MAX = PlainDateTime.from_py_datetime(dt.datetime.max)  # noqa: DTZ901
 ZONED_DATE_TIME_MIN = PLAIN_DATE_TIME_MIN.assume_tz(UTC.key)
@@ -28,10 +43,24 @@ DATE_DELTA_MAX = DATE_TIME_DELTA_MAX.date_part()
 TIME_DELTA_MIN = DATE_TIME_DELTA_MIN.time_part()
 TIME_DELTA_MAX = DATE_TIME_DELTA_MAX.time_part()
 
-DATE_TIME_DELTA_PARSABLE_MIN = DateTimeDelta(days=-999999)
-DATE_TIME_DELTA_PARSABLE_MAX = DateTimeDelta(days=999999)
-DATE_DELTA_PARSABLE_MIN = DATE_TIME_DELTA_PARSABLE_MIN.date_part()
-DATE_DELTA_PARSABLE_MAX = DATE_TIME_DELTA_PARSABLE_MAX.date_part()
+
+DATE_TIME_DELTA_PARSABLE_MIN = DateTimeDelta(days=-999999, seconds=-316192377600)
+DATE_TIME_DELTA_PARSABLE_MAX = DateTimeDelta(days=999999, seconds=316192377600)
+DATE_DELTA_PARSABLE_MIN = DateDelta(days=-999999)
+DATE_DELTA_PARSABLE_MAX = DateDelta(days=999999)
+
+
+## common constants
+
+
+ZERO_TIME = Time()
+MICROSECOND = TimeDelta(microseconds=1)
+MILLISECOND = TimeDelta(milliseconds=1)
+SECOND = TimeDelta(seconds=1)
+MINUTE = TimeDelta(minutes=1)
+HOUR = TimeDelta(hours=1)
+DAY = DateDelta(days=1)
+WEEK = DateDelta(weeks=1)
 
 
 ##
@@ -68,6 +97,28 @@ def get_now_local() -> ZonedDateTime:
     return get_now(time_zone="local")
 
 
+NOW_LOCAL = get_now_local()
+
+
+##
+
+
+def get_today(*, time_zone: TimeZoneLike = UTC) -> Date:
+    """Get the current, timezone-aware local date."""
+    return get_now(time_zone=time_zone).date()
+
+
+TODAY_UTC = get_today(time_zone=UTC)
+
+
+def get_today_local() -> Date:
+    """Get the current, timezone-aware local date."""
+    return get_today(time_zone="local")
+
+
+TODAY_LOCAL = get_today_local()
+
+
 ##
 
 
@@ -132,10 +183,23 @@ __all__ = [
     "DATE_TIME_DELTA_MIN",
     "DATE_TIME_DELTA_PARSABLE_MAX",
     "DATE_TIME_DELTA_PARSABLE_MIN",
+    "DAY",
+    "HOUR",
+    "MICROSECOND",
+    "MILLISECOND",
+    "MINUTE",
+    "NOW_LOCAL",
     "PLAIN_DATE_TIME_MAX",
     "PLAIN_DATE_TIME_MIN",
+    "SECOND",
     "TIME_DELTA_MAX",
     "TIME_DELTA_MIN",
+    "TIME_MAX",
+    "TIME_MIN",
+    "TODAY_LOCAL",
+    "TODAY_UTC",
+    "WEEK",
+    "ZERO_TIME",
     "ZONED_DATE_TIME_MAX",
     "ZONED_DATE_TIME_MIN",
     "WheneverLogRecord",
@@ -143,6 +207,7 @@ __all__ = [
     "from_timestamp_millis",
     "from_timestamp_nanos",
     "get_now",
-    "get_now",
     "get_now_local",
+    "get_today",
+    "get_today_local",
 ]