dycw-utilities 0.131.10__py3-none-any.whl → 0.131.11__py3-none-any.whl

{dycw_utilities-0.131.10.dist-info → dycw_utilities-0.131.11.dist-info}/METADATA

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

{dycw_utilities-0.131.10.dist-info → dycw_utilities-0.131.11.dist-info}/RECORD

@@ -1,18 +1,18 @@
-utilities/__init__.py,sha256=cONWlHZLOohX6BsePAlAXt2CKhMSrwzSki10hHq4rjw,61
+utilities/__init__.py,sha256=wP5J8Mq8g6P6zyTVUVaa3X4tWb427OMAAyoOjt4J0qQ,61
 utilities/aiolimiter.py,sha256=mD0wEiqMgwpty4XTbawFpnkkmJS6R4JRsVXFUaoitSU,628
 utilities/altair.py,sha256=HeZBVUocjkrTNwwKrClppsIqgNFF-ykv05HfZSoHYno,9104
 utilities/asyncio.py,sha256=yfKvAIDCRrWdyQMVZMo4DJQx4nVrXoAcqwhNuF95Ryo,38186
 utilities/atomicwrites.py,sha256=geFjn9Pwn-tTrtoGjDDxWli9NqbYfy3gGL6ZBctiqSo,5393
 utilities/atools.py,sha256=IYMuFSFGSKyuQmqD6v5IUtDlz8PPw0Sr87Cub_gRU3M,1168
 utilities/cachetools.py,sha256=C1zqOg7BYz0IfQFK8e3qaDDgEZxDpo47F15RTfJM37Q,2910
-utilities/click.py,sha256=CianelgUj_M2SBpuvhmRPKOGxuvLM04FHllUWtL7hok,14647
+utilities/click.py,sha256=8gRYeyu9KQ3uim0UpC8VnFnOOKD3DyGwMJ7k0Qns1lM,14659
 utilities/concurrent.py,sha256=s2scTEd2AhXVTW4hpASU2qxV_DiVLALfms55cCQzCvM,2886
 utilities/contextlib.py,sha256=lpaLJBy3X0UGLWjM98jkQZZq8so4fRmoK-Bheq0uOW4,1027
 utilities/contextvars.py,sha256=RsSGGrbQqqZ67rOydnM7WWIsM2lIE31UHJLejnHJPWY,505
 utilities/cryptography.py,sha256=_CiK_K6c_-uQuUhsUNjNjTL-nqxAh4_1zTfS11Xe120,972
 utilities/cvxpy.py,sha256=Rv1-fD-XYerosCavRF8Pohop2DBkU3AlFaGTfD8AEAA,13776
 utilities/dataclasses.py,sha256=iiC1wpGXWhaocIikzwBt8bbLWyImoUlOlcDZJGejaIg,33011
-utilities/datetime.py,sha256=aiPh2OZK2g9gn4yEeSO0lODOmvx8U_rGn6XeSzyk4VY,38738
+utilities/datetime.py,sha256=cDb0-fE7rRt3Gwl5vJ1HW0ZWf-wW7PHsQruD6or9hUo,38770
 utilities/enum.py,sha256=HoRwVCWzsnH0vpO9ZEcAAIZLMv0Sn2vJxxA4sYMQgDs,5793
 utilities/errors.py,sha256=nC7ZYtxxDBMfrTHtT_MByBfup_wfGQFRo3eDt-0ZPe8,1045
 utilities/eventkit.py,sha256=6M5Xu1SzN-juk9PqBHwy5dS-ta7T0qA6SMpDsakOJ0E,13039
@@ -24,7 +24,7 @@ utilities/getpass.py,sha256=DfN5UgMAtFCqS3dSfFHUfqIMZX2shXvwphOz_6J6f6A,103
 utilities/git.py,sha256=oi7-_l5e9haSANSCvQw25ufYGoNahuUPHAZ6114s3JQ,1191
 utilities/hashlib.py,sha256=SVTgtguur0P4elppvzOBbLEjVM3Pea0eWB61yg2ilxo,309
 utilities/http.py,sha256=WcahTcKYRtZ04WXQoWt5EGCgFPcyHD3EJdlMfxvDt-0,946
-utilities/hypothesis.py,sha256=-m9YWVgDkKdBfPkZHJ4-vCOGORVHqgtDhbXllfPrr7o,49873
+utilities/hypothesis.py,sha256=spJCB3bKcSMFKuSwi184xfTbom_HEBLB0_-AiPnSR-A,49822
 utilities/importlib.py,sha256=mV1xT_O_zt_GnZZ36tl3xOmMaN_3jErDWY54fX39F6Y,429
 utilities/inflect.py,sha256=DbqB5Q9FbRGJ1NbvEiZBirRMxCxgrz91zy5jCO9ZIs0,347
 utilities/ipython.py,sha256=V2oMYHvEKvlNBzxDXdLvKi48oUq2SclRg5xasjaXStw,763
@@ -32,9 +32,9 @@ utilities/iterables.py,sha256=mDqw2_0MUVp-P8FklgcaVTi2TXduH0MxbhTDzzhSBho,44915
 utilities/jupyter.py,sha256=ft5JA7fBxXKzP-L9W8f2-wbF0QeYc_2uLQNFDVk4Z-M,2917
 utilities/libcst.py,sha256=Jto5ppzRzsxn4AD32IS8n0lbgLYXwsVJB6EY8giNZyY,4974
 utilities/lightweight_charts.py,sha256=JrkrAZMo6JID2Eoc9QCc05Y_pK4l2zsApIhmii1z2Ig,2764
-utilities/logging.py,sha256=9XpYHrSVnW2_wYTWQb7LllVxcgq-U2vjUIlM4M60LCE,18407
+utilities/logging.py,sha256=GP2BqpUlb9T7v90sdavsweJnOxfSdK7cJKFdgKURJZo,17892
 utilities/luigi.py,sha256=fpH9MbxJDuo6-k9iCXRayFRtiVbUtibCJKugf7ygpv0,5988
-utilities/math.py,sha256=-mQgbah-dPJwOEWf3SonrFoVZ2AVxMgpeQ3dfVa-oJA,26764
+utilities/math.py,sha256=_6vrDyjtaqE_OFE-F2DNWrDG_J_kMl3nFAJsok9v_bY,26862
 utilities/memory_profiler.py,sha256=tf2C51P2lCujPGvRt2Rfc7VEw5LDXmVPCG3z_AvBmbU,962
 utilities/modules.py,sha256=iuvLluJya-hvl1Q25-Jk3dLgx2Es3ck4SjJiEkAlVTs,3195
 utilities/more_itertools.py,sha256=tBbjjKx8_Uv_TCjxhPwrGfAx_jRHtvLIZqXVWAsjzqA,8842
@@ -61,7 +61,7 @@ utilities/pytest.py,sha256=zP4CWKXpRVk4aRDRxolUAvqQwX7wgDO8lzmkQfuZaZo,7832
 utilities/pytest_regressions.py,sha256=YI55B7EtLjhz7zPJZ6NK9bWrxrKCKabWZJe1cwcbA5o,5082
 utilities/python_dotenv.py,sha256=edXsvHZhZnYeqfMfrsRRpj7_9eJI6uizh3xLx8Q9B3w,3228
 utilities/random.py,sha256=lYdjgxB7GCfU_fwFVl5U-BIM_HV3q6_urL9byjrwDM8,4157
-utilities/re.py,sha256=J7pJOn-Zn5nJ6rvWwMeJWP86EtMk_klhBexnoSaQiZA,4610
+utilities/re.py,sha256=6qxeV0rQZaBDKWcB7apSBmxtg_XzoGY-EdegTkMn-ZY,4578
 utilities/redis.py,sha256=IceT5EjgrebVkGL8X3M35xlqjI2c7zFbyV1P4dExN4M,36037
 utilities/reprlib.py,sha256=ssYTcBW-TeRh3fhCJv57sopTZHF5FrPyyUg9yp5XBlo,3953
 utilities/scipy.py,sha256=wZJM7fEgBAkLSYYvSmsg5ac-QuwAI0BGqHVetw1_Hb0,947
@@ -79,19 +79,19 @@ utilities/tenacity.py,sha256=1PUvODiBVgeqIh7G5TRt5WWMSqjLYkEqP53itT97WQc,4914
 utilities/text.py,sha256=ymBFlP_cA8OgNnZRVNs7FAh7OG8HxE6YkiLEMZv5g_A,11297
 utilities/threading.py,sha256=GvBOp4CyhHfN90wGXZuA2VKe9fGzMaEa7oCl4f3nnPU,1009
 utilities/timer.py,sha256=VeSl3ot8-f4D1d3HjjSsgKvjxHJGXd_sW4KcTExOR64,2475
-utilities/traceback.py,sha256=l9onlqDdW5GCSIFbU_-htBE7KlsvsJdNtGrK6-k0RCQ,8759
-utilities/types.py,sha256=Ubd3VBiqZ71eS71WSemHEM4oRF-5fnwd3PnMAm8IZaI,18461
+utilities/traceback.py,sha256=U8Du13z0qFo7sntup2x8xLw49KNb-QtEv7-UgziZ_Cw,8769
+utilities/types.py,sha256=CHQke10ETEpypxppYVhWp1G68S6mvifalrRLolYBcCg,19506
 utilities/typing.py,sha256=kQWywPcRbFBKmvQBELmgbiqSHsnlo_D0ru53vl6KDeY,13846
 utilities/tzdata.py,sha256=yCf70NICwAeazN3_JcXhWvRqCy06XJNQ42j7r6gw3HY,1217
 utilities/tzlocal.py,sha256=P5BjqTiYskeCwjE7i9zycCFXO4MWdZgYCh4jut-LpzA,1042
 utilities/uuid.py,sha256=jJTFxz-CWgltqNuzmythB7iEQ-Q1mCwPevUfKthZT3c,611
 utilities/version.py,sha256=ufhJMmI6KPs1-3wBI71aj5wCukd3sP_m11usLe88DNA,5117
 utilities/warnings.py,sha256=un1LvHv70PU-LLv8RxPVmugTzDJkkGXRMZTE2-fTQHw,1771
-utilities/whenever.py,sha256=jS31ZAY5OMxFxLja_Yo5Fidi87Pd-GoVZ7Vi_teqVDA,16743
-utilities/whenever2.py,sha256=JHixGl6KibK8GUF13GeBjvWMYsFHRDSXixSo0xMSJFM,5437
+utilities/whenever.py,sha256=2NQ-0SnLNW2kFpefP9dVE8H0RbaeusXYLPmv282Jpto,16755
+utilities/whenever2.py,sha256=76tFaAVX5CfXOjjMJ1Sg3LW85RoYARNZIALseCLG81k,7047
 utilities/zipfile.py,sha256=24lQc9ATcJxHXBPc_tBDiJk48pWyRrlxO2fIsFxU0A8,699
 utilities/zoneinfo.py,sha256=tvcgu3QzDxe2suTexi2QzRGpin7VK1TjHa0JYYxT69I,1862
-dycw_utilities-0.131.10.dist-info/METADATA,sha256=-HOUsSw5_v1-mDFC9l1PXOLDdbSUCRRbZYCgf-nmnbY,1585
-dycw_utilities-0.131.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-dycw_utilities-0.131.10.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
-dycw_utilities-0.131.10.dist-info/RECORD,,
+dycw_utilities-0.131.11.dist-info/METADATA,sha256=m2QhrLfCIpPGxtKXK8nVbiyX5ldnlLwNHjQnHy9UWkk,1585
+dycw_utilities-0.131.11.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+dycw_utilities-0.131.11.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
+dycw_utilities-0.131.11.dist-info/RECORD,,

utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.131.10"
+__version__ = "0.131.11"

utilities/click.py

@@ -23,13 +23,13 @@ from utilities.functions import EnsureStrError, ensure_str, get_class_name
 from utilities.iterables import is_iterable_not_str
 from utilities.text import split_str
 from utilities.types import (
-    DateLike,
     DateTimeLike,
     EnumLike,
     MaybeStr,
+    PyDateLike,
+    PyTimeDeltaLike,
+    PyTimeLike,
     TEnum,
-    TimeDeltaLike,
-    TimeLike,
 )
 
 if TYPE_CHECKING:
@@ -76,7 +76,7 @@ class Date(ParamType):
 
     @override
     def convert(
-        self, value: DateLike, param: Parameter | None, ctx: Context | None
+        self, value: PyDateLike, param: Parameter | None, ctx: Context | None
     ) -> dt.date:
         """Convert a value into the `Date` type."""
         from utilities.whenever import EnsureDateError, ensure_date
@@ -197,7 +197,7 @@ class Time(ParamType):
 
     @override
     def convert(
-        self, value: TimeLike, param: Parameter | None, ctx: Context | None
+        self, value: PyTimeLike, param: Parameter | None, ctx: Context | None
     ) -> dt.time:
         """Convert a value into the `Time` type."""
         from utilities.whenever import EnsureTimeError, ensure_time
@@ -219,7 +219,7 @@ class Timedelta(ParamType):
 
     @override
     def convert(
-        self, value: TimeDeltaLike, param: Parameter | None, ctx: Context | None
+        self, value: PyTimeDeltaLike, param: Parameter | None, ctx: Context | None
     ) -> dt.timedelta:
         """Convert a value into the `Timedelta` type."""
         from utilities.whenever import EnsureTimedeltaError, ensure_timedelta

utilities/datetime.py

@@ -31,9 +31,9 @@ if TYPE_CHECKING:
     from utilities.types import (
         DateOrDateTime,
         Duration,
-        MaybeCallableDate,
-        MaybeCallableDateTime,
-        RoundMode,
+        MathRoundMode,
+        MaybeCallablePyDate,
+        MaybeCallablePyDateTime,
         TimeZoneLike,
     )
 
@@ -476,19 +476,19 @@ def format_datetime_local_and_utc(datetime: dt.datetime, /) -> str:
 
 
 @overload
-def get_date(*, date: MaybeCallableDate) -> dt.date: ...
+def get_date(*, date: MaybeCallablePyDate) -> dt.date: ...
 @overload
 def get_date(*, date: None) -> None: ...
 @overload
 def get_date(*, date: Sentinel) -> Sentinel: ...
 @overload
-def get_date(*, date: MaybeCallableDate | Sentinel) -> dt.date | Sentinel: ...
+def get_date(*, date: MaybeCallablePyDate | Sentinel) -> dt.date | Sentinel: ...
 @overload
 def get_date(
-    *, date: MaybeCallableDate | None | Sentinel = sentinel
+    *, date: MaybeCallablePyDate | None | Sentinel = sentinel
 ) -> dt.date | None | Sentinel: ...
 def get_date(
-    *, date: MaybeCallableDate | None | Sentinel = sentinel
+    *, date: MaybeCallablePyDate | None | Sentinel = sentinel
 ) -> dt.date | None | Sentinel:
     """Get the date."""
     match date:
@@ -504,13 +504,13 @@ def get_date(
 
 
 @overload
-def get_datetime(*, datetime: MaybeCallableDateTime) -> dt.datetime: ...
+def get_datetime(*, datetime: MaybeCallablePyDateTime) -> dt.datetime: ...
 @overload
 def get_datetime(*, datetime: None) -> None: ...
 @overload
 def get_datetime(*, datetime: Sentinel) -> Sentinel: ...
 def get_datetime(
-    *, datetime: MaybeCallableDateTime | None | Sentinel = sentinel
+    *, datetime: MaybeCallablePyDateTime | None | Sentinel = sentinel
 ) -> dt.datetime | None | Sentinel:
     """Get the datetime."""
     match datetime:
@@ -755,7 +755,7 @@ def mean_datetime(
     /,
     *,
     weights: Iterable[SupportsFloat] | None = None,
-    mode: RoundMode = "standard",
+    mode: MathRoundMode = "standard",
     rel_tol: float | None = None,
     abs_tol: float | None = None,
 ) -> dt.datetime:
@@ -790,7 +790,7 @@ def mean_timedelta(
     /,
     *,
     weights: Iterable[SupportsFloat] | None = None,
-    mode: RoundMode = "standard",
+    mode: MathRoundMode = "standard",
     rel_tol: float | None = None,
     abs_tol: float | None = None,
 ) -> dt.timedelta:
@@ -1022,7 +1022,7 @@ def round_datetime(
     duration: Duration,
     /,
     *,
-    mode: RoundMode = "standard",
+    mode: MathRoundMode = "standard",
     rel_tol: float | None = None,
     abs_tol: float | None = None,
 ) -> dt.datetime:

utilities/hypothesis.py

@@ -48,7 +48,7 @@ from hypothesis.strategies import (
     uuids,
 )
 from hypothesis.utils.conventions import not_set
-from whenever import Date, DateDelta, PlainDateTime, Time, TimeDelta
+from whenever import Date, DateDelta, PlainDateTime, Time, TimeDelta, ZonedDateTime
 
 from utilities.datetime import (
     DATETIME_MAX_NAIVE,
@@ -112,10 +112,9 @@ if TYPE_CHECKING:
 
     from hypothesis.database import ExampleDatabase
     from numpy.random import RandomState
-    from whenever import ZonedDateTime
 
     from utilities.numpy import NDArrayB, NDArrayF, NDArrayI, NDArrayO
-    from utilities.types import Duration, Number, RoundMode, TimeZoneLike
+    from utilities.types import Duration, MathRoundMode, Number, TimeZoneLike
 
 
 _T = TypeVar("_T")
@@ -725,7 +724,7 @@ def min_and_max_datetimes(
     min_value: MaybeSearchStrategy[dt.datetime | None] = None,
     max_value: MaybeSearchStrategy[dt.datetime | None] = None,
     time_zone: MaybeSearchStrategy[ZoneInfo | timezone] = UTC,
-    round_: RoundMode | None = None,
+    round_: MathRoundMode | None = None,
     timedelta: dt.timedelta | None = None,
     rel_tol: float | None = None,
     abs_tol: float | None = None,
@@ -804,7 +803,7 @@ def min_and_maybe_max_datetimes(
     min_value: MaybeSearchStrategy[dt.datetime | None] = None,
     max_value: MaybeSearchStrategy[dt.datetime | None | Sentinel] = sentinel,
     time_zone: MaybeSearchStrategy[ZoneInfo | timezone] = UTC,
-    round_: RoundMode | None = None,
+    round_: MathRoundMode | None = None,
     timedelta: dt.timedelta | None = None,
     rel_tol: float | None = None,
     abs_tol: float | None = None,
@@ -1036,7 +1035,7 @@ def plain_datetimes(
     *,
     min_value: MaybeSearchStrategy[dt.datetime] = DATETIME_MIN_NAIVE,
     max_value: MaybeSearchStrategy[dt.datetime] = DATETIME_MAX_NAIVE,
-    round_: RoundMode | None = None,
+    round_: MathRoundMode | None = None,
     timedelta: dt.timedelta | None = None,
     rel_tol: float | None = None,
     abs_tol: float | None = None,
@@ -1056,7 +1055,7 @@ def plain_datetimes(
 
 @dataclass(kw_only=True, slots=True)
 class PlainDateTimesError(Exception):
-    round_: RoundMode
+    round_: MathRoundMode
 
     @override
     def __str__(self) -> str:
@@ -1577,7 +1576,7 @@ def zoned_datetimes(
     min_value: MaybeSearchStrategy[dt.datetime] = DATETIME_MIN_UTC + DAY,
     max_value: MaybeSearchStrategy[dt.datetime] = DATETIME_MAX_UTC - DAY,
     time_zone: MaybeSearchStrategy[ZoneInfo | timezone] = UTC,
-    round_: RoundMode | None = None,
+    round_: MathRoundMode | None = None,
     timedelta: dt.timedelta | None = None,
     rel_tol: float | None = None,
     abs_tol: float | None = None,
@@ -1626,7 +1625,7 @@ def zoned_datetimes(
 
 @dataclass(kw_only=True, slots=True)
 class ZonedDateTimesError(Exception):
-    round_: RoundMode
+    round_: MathRoundMode
 
     @override
     def __str__(self) -> str:
@@ -1646,8 +1645,6 @@ def zoned_datetimes_whenever(
     time_zone: MaybeSearchStrategy[TimeZoneLike] = UTC,
 ) -> ZonedDateTime:
     """Strategy for generating zoned datetimes."""
-    from whenever import PlainDateTime, ZonedDateTime
-
     min_value_, max_value_ = [draw2(draw, v) for v in [min_value, max_value]]
     time_zone_ = ensure_time_zone(draw2(draw, time_zone))
     match min_value_:

utilities/logging.py

@@ -34,12 +34,7 @@ from typing import (
 
 from utilities.atomicwrites import move_many
 from utilities.dataclasses import replace_non_sentinel
-from utilities.datetime import (
-    SECOND,
-    parse_datetime_compact,
-    round_datetime,
-    serialize_compact,
-)
+from utilities.datetime import parse_datetime_compact, serialize_compact
 from utilities.errors import ImpossibleCaseError
 from utilities.iterables import OneEmptyError, always_iterable, one
 from utilities.pathlib import ensure_suffix, get_path
@@ -484,12 +479,6 @@ class _RotatingLogFile:
     start: dt.datetime | None = None
     end: dt.datetime | None = None
 
-    def __post_init__(self) -> None:
-        if self.start is not None:
-            self.start = round_datetime(self.start, SECOND)
-        if self.end is not None:
-            self.end = round_datetime(self.end, SECOND)
-
     @classmethod
     def from_path(
         cls,
@@ -582,12 +571,6 @@ class _Rotation:
     start: dt.datetime | None | Sentinel = sentinel
     end: dt.datetime | Sentinel = sentinel
 
-    def __post_init__(self) -> None:
-        if isinstance(self.start, dt.datetime):
-            self.start = round_datetime(self.start, SECOND)
-        if isinstance(self.end, dt.datetime):
-            self.end = round_datetime(self.end, SECOND)
-
     @cached_property
     def destination(self) -> Path:
         return self.file.replace(index=self.index, start=self.start, end=self.end).path

utilities/math.py

@@ -8,9 +8,10 @@ from re import Match, search
 from typing import TYPE_CHECKING, Literal, assert_never, overload, override
 
 from utilities.errors import ImpossibleCaseError
+from utilities.re import ExtractGroupsError, extract_groups
 
 if TYPE_CHECKING:
-    from utilities.types import Number, RoundMode, Sign
+    from utilities.types import MathRoundMode, Number, Sign
 
 
 MIN_FLOAT32, MAX_FLOAT32 = -3.4028234663852886e38, 3.4028234663852886e38
@@ -708,7 +709,7 @@ def round_(
     x: float,
     /,
     *,
-    mode: RoundMode = "standard",
+    mode: MathRoundMode = "standard",
     rel_tol: float | None = None,
     abs_tol: float | None = None,
 ) -> int:
@@ -748,7 +749,7 @@ def round_(
 
 def _round_tie_standard(
     x: float,
-    mode: RoundMode,
+    mode: MathRoundMode,
     /,
     *,
     rel_tol: float | None = None,
@@ -757,9 +758,9 @@ def _round_tie_standard(
     """Round a float to an integer using the standard method."""
     frac, _ = modf(x)
     if _is_close(abs(frac), 0.5, rel_tol=rel_tol, abs_tol=abs_tol):
-        mode_use: RoundMode = mode
+        mode_use: MathRoundMode = mode
     else:
-        mode_use: RoundMode = "standard"
+        mode_use: MathRoundMode = "standard"
     return round_(x, mode=mode_use)
 
 
@@ -775,9 +776,9 @@ def round_float_imprecisions(
 ) -> float:
     """Round a float, removing binary representation imprecisions."""
     try:
-        ((head, tail),) = _ROUND_FLOAT_IMPRECISIONS_PATTERN.findall(str(x))
-    except ValueError:
-        ((head, tail),) = _ROUND_FLOAT_IMPRECISIONS_PATTERN.findall(f"{x:.20f}")
+        head, tail = extract_groups(_ROUND_FLOAT_IMPRECISIONS_PATTERN, str(x))
+    except ExtractGroupsError:
+        head, tail = extract_groups(_ROUND_FLOAT_IMPRECISIONS_PATTERN, f"{x:.20f}")
     half = ceil(decimals / 2)
     pattern0 = search(rf"^([0-9]+?)(0{{{half},}})([0-9]+?)$", tail)
     pattern9 = search(rf"^(0*)([0-9]+?)(9{{{half},}})([0-9]+?)$", tail)
@@ -823,7 +824,7 @@ def round_to_float(
     y: float,
     /,
     *,
-    mode: RoundMode = "standard",
+    mode: MathRoundMode = "standard",
     rel_tol: float | None = None,
     abs_tol: float | None = None,
 ) -> float:

utilities/re.py

@@ -5,8 +5,6 @@ from dataclasses import dataclass
 from re import Pattern
 from typing import TYPE_CHECKING, assert_never, override
 
-from utilities.iterables import OneEmptyError, OneNonUniqueError, one
-
 if TYPE_CHECKING:
     from utilities.types import PatternLike
 
@@ -36,16 +34,17 @@ def extract_group(pattern: PatternLike, text: str, /, *, flags: int = 0) -> str:
             raise _ExtractGroupNoCaptureGroupsError(pattern=pattern_use, text=text)
         case 1:
             matches: list[str] = pattern_use.findall(text)
-            try:
-                return one(matches)
-            except OneEmptyError:
-                raise _ExtractGroupNoMatchesError(
-                    pattern=pattern_use, text=text
-                ) from None
-            except OneNonUniqueError:
-                raise _ExtractGroupMultipleMatchesError(
-                    pattern=pattern_use, text=text, matches=matches
-                ) from None
+            match len(matches):
+                case 0:
+                    raise _ExtractGroupNoMatchesError(
+                        pattern=pattern_use, text=text
+                    ) from None
+                case 1:
+                    return matches[0]
+                case _:
+                    raise _ExtractGroupMultipleMatchesError(
+                        pattern=pattern_use, text=text, matches=matches
+                    ) from None
         case _:
             raise _ExtractGroupMultipleCaptureGroupsError(
                 pattern=pattern_use, text=text
@@ -109,7 +108,7 @@ def extract_groups(pattern: PatternLike, text: str, /, *, flags: int = 0) -> lis
         case 1, 1:
             return matches
         case 1, _:
-            return list(one(matches))
+            return list(matches[0])
         case _:
             raise _ExtractGroupsMultipleMatchesError(
                 pattern=pattern_use, text=text, matches=matches

utilities/traceback.py

@@ -36,7 +36,7 @@ if TYPE_CHECKING:
     from traceback import FrameSummary
     from types import TracebackType
 
-    from utilities.types import MaybeCallableDateTime, MaybeCallablePathLike, PathLike
+    from utilities.types import MaybeCallablePathLike, MaybeCallablePyDateTime, PathLike
     from utilities.version import MaybeCallableVersionLike
 
 
@@ -51,7 +51,7 @@ def format_exception_stack(
     /,
     *,
     header: bool = False,
-    start: MaybeCallableDateTime | None = _START,
+    start: MaybeCallablePyDateTime | None = _START,
     version: MaybeCallableVersionLike | None = None,
     capture_locals: bool = False,
     max_width: int = RICH_MAX_WIDTH,
@@ -82,7 +82,7 @@ def format_exception_stack(
 
 def _yield_header_lines(
     *,
-    start: MaybeCallableDateTime | None = _START,
+    start: MaybeCallablePyDateTime | None = _START,
     version: MaybeCallableVersionLike | None = None,
 ) -> Iterator[str]:
     """Yield the header lines."""
@@ -193,7 +193,7 @@ def _trim_path(path: PathLike, pattern: str, /) -> Path | None:
 
 def make_except_hook(
     *,
-    start: MaybeCallableDateTime | None = _START,
+    start: MaybeCallablePyDateTime | None = _START,
     version: MaybeCallableVersionLike | None = None,
     path: MaybeCallablePathLike | None = None,
     max_width: int = RICH_MAX_WIDTH,
@@ -228,7 +228,7 @@ def _make_except_hook_inner(
     traceback: TracebackType | None,
     /,
     *,
-    start: MaybeCallableDateTime | None = _START,
+    start: MaybeCallablePyDateTime | None = _START,
     version: MaybeCallableVersionLike | None = None,
     path: MaybeCallablePathLike | None = None,
     max_width: int = RICH_MAX_WIDTH,

utilities/types.py

@@ -20,6 +20,16 @@ from typing import (
 )
 from zoneinfo import ZoneInfo
 
+from whenever import (
+    Date,
+    DateDelta,
+    DateTimeDelta,
+    PlainDateTime,
+    Time,
+    TimeDelta,
+    ZonedDateTime,
+)
+
 _T_co = TypeVar("_T_co", covariant=True)
 _T_contra = TypeVar("_T_contra", contravariant=True)
 
@@ -88,17 +98,16 @@ TDataclass = TypeVar("TDataclass", bound=Dataclass)
 
 
 # datetime
-type DateLike = MaybeStr[dt.date]
-type DateTimeLike = MaybeStr[dt.datetime]
 type DateOrDateTime = dt.date | dt.datetime
+type DateTimeLike = MaybeStr[dt.datetime]
 type Duration = Number | dt.timedelta
 type DurationLike = MaybeStr[Duration]
 type DurationOrEveryDuration = Duration | tuple[Literal["every"], Duration]
-type MaybeCallableDate = MaybeCallable[dt.date]
-type MaybeCallableDateTime = MaybeCallable[dt.datetime]
-type TimeLike = MaybeStr[dt.time]
-type TimeDeltaLike = MaybeStr[dt.timedelta]
-type WeekDay = Literal["mon", "tue", "wed", "thu", "fri", "sat", "sun"]
+type MaybeCallablePyDate = MaybeCallable[dt.date]
+type MaybeCallablePyDateTime = MaybeCallable[dt.datetime]
+type PyDateLike = MaybeStr[dt.date]
+type PyTimeDeltaLike = MaybeStr[dt.timedelta]
+type PyTimeLike = MaybeStr[dt.time]
 
 
 # enum
@@ -133,7 +142,7 @@ type LoggerOrName = MaybeStr[Logger]
 
 # math
 type Number = int | float
-type RoundMode = Literal[
+type MathRoundMode = Literal[
     "standard",
     "floor",
     "ceil",
@@ -259,6 +268,25 @@ type ExcInfo = tuple[type[BaseException], BaseException, TracebackType]
 type OptExcInfo = ExcInfo | tuple[None, None, None]
 
 
+# whenever
+type DateDeltaLike = MaybeStr[DateDelta]
+type DateLike = MaybeStr[Date]
+type DateTimeDeltaLike = MaybeStr[DateTimeDelta]
+type MaybeCallableDate = MaybeCallable[Date]
+type MaybeCallableZonedDateTime = MaybeCallable[ZonedDateTime]
+type PlainDateTimeLike = MaybeStr[PlainDateTime]
+type TimeDeltaLike = MaybeStr[TimeDelta]
+type TimeLike = MaybeStr[Time]
+type ZonedDateTimeLike = MaybeStr[ZonedDateTime]
+type DateTimeRoundUnit = Literal[
+    "day", "hour", "minute", "second", "millisecond", "microsecond", "nanosecond"
+]
+type DateTimeRoundMode = Literal[
+    "ceil", "floor", "half_ceil", "half_floor", "half_even"
+]
+type WeekDay = Literal["mon", "tue", "wed", "thu", "fri", "sat", "sun"]
+
+
 # zoneinfo
 # fmt: off
 type TimeZone = Literal[
@@ -271,9 +299,13 @@ type TimeZoneLike = ZoneInfo | Literal["local"] | TimeZone | dt.tzinfo | dt.date
 __all__ = [
     "Coroutine1",
     "Dataclass",
+    "DateDeltaLike",
     "DateLike",
     "DateOrDateTime",
+    "DateTimeDeltaLike",
     "DateTimeLike",
+    "DateTimeRoundMode",
+    "DateTimeRoundUnit",
     "Duration",
     "DurationLike",
     "DurationOrEveryDuration",
@@ -282,12 +314,15 @@ __all__ = [
     "IterableHashable",
     "LogLevel",
     "LoggerOrName",
+    "MathRoundMode",
     "MaybeAwaitable",
     "MaybeCallable",
     "MaybeCallableDate",
-    "MaybeCallableDateTime",
     "MaybeCallableEvent",
     "MaybeCallablePathLike",
+    "MaybeCallablePyDate",
+    "MaybeCallablePyDateTime",
+    "MaybeCallableZonedDateTime",
     "MaybeCoroutine1",
     "MaybeIterable",
     "MaybeIterableHashable",
@@ -300,7 +335,10 @@ __all__ = [
     "ParseObjectExtra",
     "PathLike",
     "PatternLike",
-    "RoundMode",
+    "PlainDateTimeLike",
+    "PyDateLike",
+    "PyTimeDeltaLike",
+    "PyTimeLike",
     "Seed",
     "SerializeObjectExtra",
     "Sign",
@@ -343,4 +381,5 @@ __all__ = [
     "TupleOrStrMapping",
     "TypeLike",
     "WeekDay",
+    "ZonedDateTimeLike",
 ]

utilities/whenever.py

@@ -34,12 +34,12 @@ from utilities.zoneinfo import UTC, ensure_time_zone, get_time_zone_name
 
 if TYPE_CHECKING:
     from utilities.types import (
-        DateLike,
         DateTimeLike,
         Duration,
         DurationLike,
-        TimeDeltaLike,
-        TimeLike,
+        PyDateLike,
+        PyTimeDeltaLike,
+        PyTimeLike,
     )
 
 
@@ -91,7 +91,7 @@ class _CheckValidZonedDateTimeUnequalError(CheckValidZonedDateTimeError):
 ##
 
 
-def ensure_date(date: DateLike, /) -> dt.date:
+def ensure_date(date: PyDateLike, /) -> dt.date:
     """Ensure the object is a date."""
     if isinstance(date, dt.date):
         check_date_not_datetime(date)
@@ -180,7 +180,7 @@ class EnsurePlainDateTimeError(Exception):
 ##
 
 
-def ensure_time(time: TimeLike, /) -> dt.time:
+def ensure_time(time: PyTimeLike, /) -> dt.time:
     """Ensure the object is a time."""
     if isinstance(time, dt.time):
         return time
@@ -202,7 +202,7 @@ class EnsureTimeError(Exception):
 ##
 
 
-def ensure_timedelta(timedelta: TimeDeltaLike, /) -> dt.timedelta:
+def ensure_timedelta(timedelta: PyTimeDeltaLike, /) -> dt.timedelta:
     """Ensure the object is a timedelta."""
     if isinstance(timedelta, dt.timedelta):
         return timedelta

utilities/whenever2.py

@@ -1,9 +1,10 @@
 from __future__ import annotations
 
 import datetime as dt
+from collections.abc import Callable
 from functools import cache
 from logging import LogRecord
-from typing import TYPE_CHECKING, Any, override
+from typing import TYPE_CHECKING, Any, assert_never, overload, override
 
 from whenever import (
     Date,
@@ -15,12 +16,17 @@ from whenever import (
     ZonedDateTime,
 )
 
+from utilities.sentinel import Sentinel, sentinel
 from utilities.zoneinfo import UTC, get_time_zone_name
 
 if TYPE_CHECKING:
     from zoneinfo import ZoneInfo
 
-    from utilities.types import TimeZoneLike
+    from utilities.types import (
+        MaybeCallableDate,
+        MaybeCallableZonedDateTime,
+        TimeZoneLike,
+    )
 
 
 ## bounds
@@ -118,6 +124,52 @@ def get_today_local() -> Date:
 
 TODAY_LOCAL = get_today_local()
 
+##
+
+
+@overload
+def to_date(*, date: MaybeCallableDate) -> Date: ...
+@overload
+def to_date(*, date: None) -> None: ...
+@overload
+def to_date(*, date: Sentinel) -> Sentinel: ...
+@overload
+def to_date(*, date: MaybeCallableDate | Sentinel) -> Date | Sentinel: ...
+@overload
+def to_date(
+    *, date: MaybeCallableDate | None | Sentinel = sentinel
+) -> Date | None | Sentinel: ...
+def to_date(
+    *, date: MaybeCallableDate | None | Sentinel = sentinel
+) -> Date | None | Sentinel:
+    """Get the date."""
+    match date:
+        case Date() | None | Sentinel():
+            return date
+        case Callable() as func:
+            return to_date(date=func())
+        case _ as never:
+            assert_never(never)
+
+
+@overload
+def to_zoned_date_time(*, date_time: MaybeCallableZonedDateTime) -> ZonedDateTime: ...
+@overload
+def to_zoned_date_time(*, date_time: None) -> None: ...
+@overload
+def to_zoned_date_time(*, date_time: Sentinel) -> Sentinel: ...
+def to_zoned_date_time(
+    *, date_time: MaybeCallableZonedDateTime | None | Sentinel = sentinel
+) -> ZonedDateTime | None | Sentinel:
+    """Resolve into a zoned date_time."""
+    match date_time:
+        case ZonedDateTime() | None | Sentinel():
+            return date_time
+        case Callable() as func:
+            return to_zoned_date_time(date_time=func())
+        case _ as never:
+            assert_never(never)
+
 
 ##
 
@@ -210,4 +262,6 @@ __all__ = [
     "get_now_local",
     "get_today",
     "get_today_local",
+    "to_date",
+    "to_zoned_date_time",
 ]