dycw-utilities 0.111.0__py3-none-any.whl → 0.112.0__py3-none-any.whl

{dycw_utilities-0.111.0.dist-info → dycw_utilities-0.112.0.dist-info}/METADATA

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

{dycw_utilities-0.111.0.dist-info → dycw_utilities-0.112.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-utilities/__init__.py,sha256=fjbCo5KvSkqKWLmPeMS8U77JZlYaYPd9js1ZVmdD1FE,60
+utilities/__init__.py,sha256=Xs6R-k_70_fB8zwc0DeYfdK4J8vyyL3G76ApWiuWPGo,60
 utilities/altair.py,sha256=Gpja-flOo-Db0PIPJLJsgzAlXWoKUjPU1qY-DQ829ek,9156
 utilities/astor.py,sha256=xuDUkjq0-b6fhtwjhbnebzbqQZAjMSHR1IIS5uOodVg,777
 utilities/asyncio.py,sha256=41oQUurWMvadFK5gFnaG21hMM0Vmfn2WS6OpC0R9mas,14757
@@ -12,24 +12,24 @@ utilities/contextvars.py,sha256=RsSGGrbQqqZ67rOydnM7WWIsM2lIE31UHJLejnHJPWY,505
 utilities/cryptography.py,sha256=HyOewI20cl3uRXsKivhIaeLVDInQdzgXZGaly7hS5dE,771
 utilities/cvxpy.py,sha256=Rv1-fD-XYerosCavRF8Pohop2DBkU3AlFaGTfD8AEAA,13776
 utilities/dataclasses.py,sha256=Q197PVnE_vUMn_SNnqJBCo4eRy4bdHtgMHWRbSJPtFk,26670
-utilities/datetime.py,sha256=XrVHvyHyYMBeU2ClC7xJKwB68l-F2ZCmDznyNXS4hT8,36862
+utilities/datetime.py,sha256=OF7jZE702UecnwAbq9D3N-GINpp9gSGoidki1RhimCE,35752
 utilities/enum.py,sha256=HoRwVCWzsnH0vpO9ZEcAAIZLMv0Sn2vJxxA4sYMQgDs,5793
 utilities/errors.py,sha256=BtSNP0JC3ik536ddPyTerLomCRJV9f6kdMe6POz0QHM,361
 utilities/eventkit.py,sha256=6M5Xu1SzN-juk9PqBHwy5dS-ta7T0qA6SMpDsakOJ0E,13039
-utilities/fastapi.py,sha256=uwqOGbGwzIbP-lfm-ApG1ZEN3BA_TDsaiuTghhLmxb8,2413
-utilities/fpdf2.py,sha256=zM3gwOYcAfv7P4qhbyvzPmRY4PPAiAQ-ZnPC6I9SZ1M,1832
+utilities/fastapi.py,sha256=y-35at3005jzlNx2wJoiSvB1Ch5bMo30wgU_so3IDdI,2467
+utilities/fpdf2.py,sha256=y1NGXR5chWqLXWpewGV3hlRGMr_5yV1lVRkPBhPEgJI,1843
 utilities/functions.py,sha256=jgt592voaHNtX56qX0SRvFveVCRmSIxCZmqvpLZCnY8,27305
 utilities/functools.py,sha256=WrpHt7NLNWSUn9A1Q_ZIWlNaYZOEI4IFKyBG9HO3BC4,1643
 utilities/getpass.py,sha256=DfN5UgMAtFCqS3dSfFHUfqIMZX2shXvwphOz_6J6f6A,103
 utilities/git.py,sha256=wpt5dZ5Oi5931pN24_VLZYaQOvmR0OcQuVtgHzFUN1k,2359
 utilities/hashlib.py,sha256=SVTgtguur0P4elppvzOBbLEjVM3Pea0eWB61yg2ilxo,309
 utilities/http.py,sha256=WcahTcKYRtZ04WXQoWt5EGCgFPcyHD3EJdlMfxvDt-0,946
-utilities/hypothesis.py,sha256=sLqYcrFn0I3o0R7maqliIERRtAcREk2CKG8rSHY1t5U,46205
+utilities/hypothesis.py,sha256=OpZhPdPmsYWvqMytFDc-G196eODosUzxQSuo-LfMYmM,46262
 utilities/ipython.py,sha256=V2oMYHvEKvlNBzxDXdLvKi48oUq2SclRg5xasjaXStw,763
 utilities/iterables.py,sha256=2Yy9gZ7BR4LXR4nlX7outFAjd4dpb3lgUo7ji_sdylY,45076
 utilities/jupyter.py,sha256=ft5JA7fBxXKzP-L9W8f2-wbF0QeYc_2uLQNFDVk4Z-M,2917
 utilities/lightweight_charts.py,sha256=vyVOzarYhBIOZj2xDhqdbP85qbSKUjdc6Au91rc1W4M,2814
-utilities/logging.py,sha256=opIwFjGKOYyMntVeCsFNXOmTY2z02hMf2UtCB76SaI4,25142
+utilities/logging.py,sha256=55LVJYd2BKzeTTQr4tG7uSNMDVEgUO56wK4s-rldjrM,25326
 utilities/loguru.py,sha256=MEMQVWrdECxk1e3FxGzmOf21vWT9j8CAir98SEXFKPA,3809
 utilities/luigi.py,sha256=fpH9MbxJDuo6-k9iCXRayFRtiVbUtibCJKugf7ygpv0,5988
 utilities/math.py,sha256=TexfvLCI12d9Sw5_W4pKVBZ3nRr3zk2iPkcEU7xdEWU,26771
@@ -41,7 +41,7 @@ utilities/operator.py,sha256=0M2yZJ0PODH47ogFEnkGMBe_cfxwZR02T_92LZVZvHo,3715
 utilities/optuna.py,sha256=loyJGWTzljgdJaoLhP09PT8Jz6o_pwBOwehY33lHkhw,1923
 utilities/orjson.py,sha256=DBm2zPP04kcHpY3l1etL24ksNynu-R3duFyx3U-RjqQ,36948
 utilities/os.py,sha256=D_FyyT-6TtqiN9KSS7c9g1fnUtgxmyMtzAjmYLkk46A,3587
-utilities/parse.py,sha256=-sDMqA4nB4CFctc86uIlSoKmIUisTUd3qyBcuUnf1D0,18957
+utilities/parse.py,sha256=hG-y8WAzpATakA61UOF6UlhfuJQ9XbMN-Uub1ZaiBRU,18780
 utilities/pathlib.py,sha256=31WPMXdLIyXgYOMMl_HOI2wlo66MGSE-cgeelk-Lias,1410
 utilities/period.py,sha256=RWfcNVoNlW07RNdU47g_zuLZMKbtgfK4bE6G-9tVjY8,11024
 utilities/pickle.py,sha256=Bhvd7cZl-zQKQDFjUerqGuSKlHvnW1K2QXeU5UZibtg,657
@@ -51,7 +51,7 @@ utilities/polars_ols.py,sha256=efhXf0gjrHUpQrvS6a7g8yJQJWf_ATKtJnqqF2inCOU,5680
 utilities/pqdm.py,sha256=foRytQybmOQ05pjt5LF7ANyzrIa--4ScDE3T2wd31a4,3118
 utilities/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 utilities/pydantic.py,sha256=f6qtR5mO2YMuyvNmbaEj5YeD9eGA4YYfb7Bjzh9jUs0,1845
-utilities/pyinstrument.py,sha256=ROq2txPwbe2ZUuYJ2IDNbfT97lu2ca0v5_C_yn6sSlM,800
+utilities/pyinstrument.py,sha256=OJFDh4o1CWIa4aYPYURdQjgap_nvP45KUsCEe94rQHY,829
 utilities/pyrsistent.py,sha256=MoDcAqQGlSNkmlS32DCJLw-cZFAfHB6K9kpox_iyI4k,2512
 utilities/pytest.py,sha256=85QUax4g2VBBAqAHtM9wekcSLB7_9O8AKFTaCshztL8,7989
 utilities/pytest_regressions.py,sha256=-SVT9647Dg6-JcdsiaDKXe3NdOmmrvGevLKWwGjxq3c,5088
@@ -76,18 +76,18 @@ utilities/tenacity.py,sha256=1PUvODiBVgeqIh7G5TRt5WWMSqjLYkEqP53itT97WQc,4914
 utilities/text.py,sha256=hfcBKF22fKT6s_U-ZdP-g5TjFQ0-NrIrQdvIwERWT80,10971
 utilities/threading.py,sha256=GvBOp4CyhHfN90wGXZuA2VKe9fGzMaEa7oCl4f3nnPU,1009
 utilities/timer.py,sha256=Rkc49KSpHuC8s7vUxGO9DU55U9I6yDKnchsQqrUCVBs,4075
-utilities/traceback.py,sha256=KwHPLdEbdj0fFhXo8MBfxcvem8A-VXYDwFMNJ6f0cTM,27328
+utilities/traceback.py,sha256=secexUnBsecfWV4ZuqP1W4pGF3prOeO1CRyJK-8zQDU,27402
 utilities/types.py,sha256=kVY71hZkcnyYNIlYSse0mLm8yeP3OBkzhDPMME6jXxo,18126
 utilities/typing.py,sha256=jtc6EiGZGG0E745jo3NeLqo_HdHt7Zdaco3kCAEWIYU,11177
-utilities/tzdata.py,sha256=2ZsPmhTVM9Ptrxb4QrWKtKOB9RiH8IOO-A1u7ULdVbg,176
-utilities/tzlocal.py,sha256=42BCquGF54oIqIKe5RGziP4K8Nbm3Ey7uqcNn6m5ge8,534
+utilities/tzdata.py,sha256=yCf70NICwAeazN3_JcXhWvRqCy06XJNQ42j7r6gw3HY,1217
+utilities/tzlocal.py,sha256=3upDNFBvGh1l9njmLR2z2S6K6VxQSb7QizYGUbAH3JU,960
 utilities/uuid.py,sha256=jJTFxz-CWgltqNuzmythB7iEQ-Q1mCwPevUfKthZT3c,611
 utilities/version.py,sha256=QFuyEeQA6jI0ruBEcmhqG36f-etg1AEiD1drBBqhQrs,5358
 utilities/warnings.py,sha256=un1LvHv70PU-LLv8RxPVmugTzDJkkGXRMZTE2-fTQHw,1771
-utilities/whenever.py,sha256=TjoTAJ1R27-rKXiXzdE4GzPidmYqm0W58XydDXp-QZM,17786
+utilities/whenever.py,sha256=iLRP_-8CZtBpHKbGZGu-kjSMg1ZubJ-VSmgSy7Eudxw,17787
 utilities/zipfile.py,sha256=24lQc9ATcJxHXBPc_tBDiJk48pWyRrlxO2fIsFxU0A8,699
-utilities/zoneinfo.py,sha256=-DQz5a0Ikw9jfSZtL0BEQkXOMC9yGn_xiJYNCLMiqEc,1989
-dycw_utilities-0.111.0.dist-info/METADATA,sha256=9UDVxMivd6ye3O57NEI2wEddqVpW9OE_rc_uhtMXD-c,13004
-dycw_utilities-0.111.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-dycw_utilities-0.111.0.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
-dycw_utilities-0.111.0.dist-info/RECORD,,
+utilities/zoneinfo.py,sha256=-Xm57PMMwDTYpxJdkiJG13wnbwK--I7XItBh5WVhD-o,1874
+dycw_utilities-0.112.0.dist-info/METADATA,sha256=GWKYE-rIVvmMBNyTnfCxMJNqV6PHKYsmLVs-6YJadKw,13004
+dycw_utilities-0.112.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+dycw_utilities-0.112.0.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
+dycw_utilities-0.112.0.dist-info/RECORD,,

utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.111.0"
+__version__ = "0.112.0"

utilities/datetime.py

@@ -23,13 +23,7 @@ from utilities.platform import SYSTEM
 from utilities.sentinel import Sentinel, sentinel
 from utilities.types import MaybeStr
 from utilities.typing import is_instance_gen
-from utilities.zoneinfo import (
-    UTC,
-    HongKong,
-    Tokyo,
-    ensure_time_zone,
-    get_time_zone_name,
-)
+from utilities.zoneinfo import UTC, ensure_time_zone, get_time_zone_name
 
 if TYPE_CHECKING:
     from collections.abc import Iterator
@@ -525,28 +519,6 @@ def get_now(*, time_zone: TimeZoneLike = UTC) -> dt.datetime:
 NOW_UTC = get_now(time_zone=UTC)
 
 
-def get_now_hk() -> dt.datetime:
-    """Get the current time in Hong Kong."""
-    return dt.datetime.now(tz=HongKong)
-
-
-NOW_HK = get_now_hk()
-
-
-def get_now_local() -> dt.datetime:
-    """Get the current time in local."""
-    return get_now(time_zone="local")
-    # don't define `NOW_LOCAL` as this would require `tzlocal`
-
-
-def get_now_tokyo() -> dt.datetime:
-    """Get the current time in Tokyo."""
-    return dt.datetime.now(tz=Tokyo)
-
-
-NOW_TOKYO = get_now_tokyo()
-
-
 ##
 
 
@@ -570,27 +542,6 @@ def get_today(*, time_zone: TimeZoneLike = UTC) -> dt.date:
 TODAY_UTC = get_today(time_zone=UTC)
 
 
-def get_today_hk() -> dt.date:
-    """Get the current date in Hong Kong."""
-    return get_now_hk().date()
-
-
-TODAY_HK = get_today_hk()
-
-
-def get_today_local() -> dt.date:
-    """Get the current, timezone-aware local date."""
-    return get_now_local().date()
-
-
-def get_today_tokyo() -> dt.date:
-    """Get the current date in Tokyo."""
-    return get_now_tokyo().date()
-
-
-TODAY_TOKYO = get_today_tokyo()
-
-
 ##
 
 
@@ -1279,13 +1230,9 @@ __all__ = [
     "MIN_DATE_TWO_DIGIT_YEAR",
     "MIN_MONTH",
     "MONTH",
-    "NOW_HK",
-    "NOW_TOKYO",
     "NOW_UTC",
     "QUARTER",
     "SECOND",
-    "TODAY_HK",
-    "TODAY_TOKYO",
     "TODAY_UTC",
     "WEEK",
     "YEAR",
@@ -1335,14 +1282,8 @@ __all__ = [
     "get_half_years",
     "get_months",
     "get_now",
-    "get_now_hk",
-    "get_now_local",
-    "get_now_tokyo",
     "get_quarters",
     "get_today",
-    "get_today_hk",
-    "get_today_local",
-    "get_today_tokyo",
     "get_years",
     "is_integral_timedelta",
     "is_local_datetime",

utilities/fastapi.py

@@ -7,7 +7,7 @@ from fastapi import FastAPI
 from uvicorn import Config, Server
 
 from utilities.asyncio import AsyncService
-from utilities.datetime import SECOND, datetime_duration_to_float, get_now_local
+from utilities.datetime import SECOND, datetime_duration_to_float
 
 if TYPE_CHECKING:
     from utilities.types import Duration
@@ -26,6 +26,7 @@ class _PingerReceiverApp(FastAPI):
 
         @self.get("/ping")  # skipif-ci
         def ping() -> str:
+            from utilities.tzlocal import get_now_local  # skipif-ci
             from utilities.whenever import serialize_zoned_datetime  # skipif-ci
 
             now = serialize_zoned_datetime(get_now_local())  # skipif-ci

utilities/fpdf2.py

@@ -6,8 +6,6 @@ from typing import TYPE_CHECKING, override
 from fpdf import FPDF
 from fpdf.enums import XPos, YPos
 
-from utilities.datetime import get_now_local
-
 if TYPE_CHECKING:
     from collections.abc import Iterator
 
@@ -45,6 +43,8 @@ def yield_pdf(*, header: str | None = None) -> Iterator[_BasePDF]:
 
         @override
         def footer(self) -> None:
+            from utilities.tzlocal import get_now_local
+
             self.set_y(-15)
             self.set_font(family="Helvetica", style="I", size=8)
             page_no, now = self.page_no(), get_now_local()

utilities/hypothesis.py

@@ -69,7 +69,6 @@ from utilities.datetime import (
     date_to_month,
     datetime_duration_to_float,
     datetime_duration_to_timedelta,
-    get_now_local,
     round_datetime,
 )
 from utilities.functions import ensure_int, ensure_str, max_nullable, min_nullable
@@ -1440,6 +1439,7 @@ def yield_test_redis(data: DataObject, /) -> AbstractAsyncContextManager[_TestRe
     from redis.exceptions import ResponseError  # skipif-ci-and-not-linux
 
     from utilities.redis import _TestRedis, yield_redis  #  skipif-ci-and-not-linux
+    from utilities.tzlocal import get_now_local  #  skipif-ci-and-not-linux
 
     now = get_now_local()  # skipif-ci-and-not-linux
     uuid = data.draw(uuids())  # skipif-ci-and-not-linux

utilities/logging.py

@@ -37,11 +37,9 @@ from typing import (
     override,
 )
 
-from utilities.atomicwrites import move_many, writer
 from utilities.dataclasses import replace_non_sentinel
 from utilities.datetime import (
     SECOND,
-    get_now_local,
     maybe_sub_pct_y,
     parse_datetime_compact,
     round_datetime,
@@ -200,6 +198,8 @@ def _compute_rollover_actions(
     patterns: _RolloverPatterns | None = None,
     backup_count: int = 1,
 ) -> _RolloverActions:
+    from utilities.tzlocal import get_now_local  # skipif-ci-and-windows
+
     patterns = (  # skipif-ci-and-windows
         _compute_rollover_patterns(stem, suffix) if patterns is None else patterns
     )
@@ -244,6 +244,8 @@ class _RolloverActions:
     rotations: set[_Rotation] = field(default_factory=set)
 
     def do(self) -> None:
+        from utilities.atomicwrites import move_many  # skipif-ci-and-windows
+
         for deletion in self.deletions:  # skipif-ci-and-windows
             deletion.delete()
         move_many(  # skipif-ci-and-windows
@@ -388,6 +390,9 @@ class StandaloneFileHandler(Handler):
 
     @override
     def emit(self, record: LogRecord) -> None:
+        from utilities.atomicwrites import writer
+        from utilities.tzlocal import get_now_local
+
         try:
             path = (
                 resolve_path(path=self._path)

utilities/parse.py

@@ -60,15 +60,15 @@ def parse_object(
     extra: ParseObjectExtra | None = None,
 ) -> Any:
     """Parse text."""
+    if extra is not None:
+        return _parse_object_extra(type_, text, extra)
     if type_ is None:
         try:
             return parse_none(text)
         except ParseNoneError:
             raise _ParseObjectParseError(type_=type_, text=text) from None
     if isinstance(type_, type):
-        return _parse_object_type(
-            type_, text, case_sensitive=case_sensitive, extra=extra
-        )
+        return _parse_object_type(type_, text, case_sensitive=case_sensitive)
     if is_dict_type(type_):
         return _parse_object_dict_type(
             type_,
@@ -146,17 +146,12 @@ def parse_object(
             extra=extra,
         )
     if is_union_type(type_):
-        return _parse_object_union_type(type_, text, extra=extra)
+        return _parse_object_union_type(type_, text)
     raise _ParseObjectParseError(type_=type_, text=text) from None
 
 
 def _parse_object_type(
-    cls: type[Any],
-    text: str,
-    /,
-    *,
-    case_sensitive: bool = False,
-    extra: ParseObjectExtra | None = None,
+    cls: type[Any], text: str, /, *, case_sensitive: bool = False
 ) -> Any:
     """Parse text."""
     if issubclass(cls, NoneType):
@@ -226,17 +221,6 @@ def _parse_object_type(
             return parse_timedelta(text)
         except ParseTimedeltaError:
             raise _ParseObjectParseError(type_=cls, text=text) from None
-    if extra is not None:
-        try:
-            parser = one(p for c, p in extra.items() if issubclass(cls, c))
-        except OneEmptyError:
-            pass
-        except OneNonUniqueError as error:
-            raise _ParseObjectExtraNonUniqueError(
-                type_=cls, text=text, first=error.first, second=error.second
-            ) from None
-        else:
-            return parser(text)
     raise _ParseObjectParseError(type_=cls, text=text)
 
 
@@ -296,6 +280,21 @@ def _parse_object_dict_type(
         raise _ParseObjectParseError(type_=type_, text=text) from None
 
 
+def _parse_object_extra(cls: Any, text: str, extra: ParseObjectExtra, /) -> Any:
+    try:
+        parser = one(
+            p for c, p in extra.items() if (cls is c) or is_subclass_gen(cls, c)
+        )
+    except OneEmptyError:
+        raise _ParseObjectParseError(type_=cls, text=text) from None
+    except OneNonUniqueError as error:
+        raise _ParseObjectExtraNonUniqueError(
+            type_=cls, text=text, first=error.first, second=error.second
+        ) from None
+    else:
+        return parser(text)
+
+
 def _parse_object_list_type(
     type_: Any,
     text: str,
@@ -368,9 +367,7 @@ def _parse_object_set_type(
         raise _ParseObjectParseError(type_=type_, text=text) from None
 
 
-def _parse_object_union_type(
-    type_: Any, text: str, /, *, extra: ParseObjectExtra | None = None
-) -> Any:
+def _parse_object_union_type(type_: Any, text: str, /) -> Any:
     if type_ is Number:
         try:
             return parse_number(text)
@@ -383,13 +380,6 @@ def _parse_object_union_type(
             return parse_duration(text)
         except ParseDurationError:
             raise _ParseObjectParseError(type_=type_, text=text) from None
-    if extra is not None:
-        try:
-            parser = one(p for c, p in extra.items() if c is type_)
-        except OneEmptyError:
-            pass
-        else:
-            return parser(text)
     raise _ParseObjectParseError(type_=type_, text=text) from None
 
 
@@ -466,6 +456,9 @@ def serialize_object(
     extra: SerializeObjectExtra | None = None,
 ) -> str:
     """Convert an object to text."""
+    if extra is not None:
+        with suppress(_SerializeObjectSerializeError):
+            return _serialize_object_extra(obj, extra)
     if (obj is None) or isinstance(
         obj, bool | int | float | str | Path | Sentinel | Version
     ):
@@ -504,8 +497,6 @@ def serialize_object(
         return _serialize_object_set(
             obj, list_separator=list_separator, pair_separator=pair_separator
         )
-    if extra is not None:
-        return _serialize_object_extra(obj, extra)
     raise _SerializeObjectSerializeError(obj=obj)
 
 
@@ -537,10 +528,7 @@ def _serialize_object_dict(
 def _serialize_object_extra(obj: Any, extra: SerializeObjectExtra, /) -> str:
     try:
         serializer = one(
-            s
-            for c, s in extra.items()
-            if (isinstance(c, type) and isinstance(obj, c))
-            or isinstance(obj, get_args(c))
+            s for c, s in extra.items() if (obj is c) or is_instance_gen(obj, c)
         )
     except OneEmptyError:
         raise _SerializeObjectSerializeError(obj=obj) from None

utilities/pyinstrument.py

@@ -6,8 +6,9 @@ from typing import TYPE_CHECKING
 
 from pyinstrument.profiler import Profiler
 
-from utilities.datetime import get_now_local, serialize_compact
+from utilities.datetime import serialize_compact
 from utilities.pathlib import PWD
+from utilities.tzlocal import get_now_local
 
 if TYPE_CHECKING:
     from collections.abc import Iterator

utilities/traceback.py

@@ -26,7 +26,6 @@ from typing import (
     runtime_checkable,
 )
 
-from utilities.datetime import get_now_local
 from utilities.errors import ImpossibleCaseError
 from utilities.functions import (
     ensure_not_none,
@@ -44,10 +43,8 @@ from utilities.reprlib import (
     RICH_MAX_STRING,
     RICH_MAX_WIDTH,
 )
-from utilities.rich import yield_call_args_repr, yield_mapping_repr
 from utilities.types import TBaseException, TCallable
 from utilities.version import get_version
-from utilities.whenever import serialize_zoned_datetime
 
 if TYPE_CHECKING:
     from collections.abc import Callable, Iterable, Iterator
@@ -192,6 +189,8 @@ class _CallArgs:
     @classmethod
     def create(cls, func: Callable[..., Any], *args: Any, **kwargs: Any) -> Self:
         """Make the initial trace data."""
+        from utilities.rich import yield_call_args_repr
+
         sig = signature(func)
         try:
             bound_args = sig.bind(*args, **kwargs)
@@ -428,6 +427,8 @@ class _Frame:
         depth: int = 0,
     ) -> str:
         """Format the traceback."""
+        from utilities.rich import yield_call_args_repr, yield_mapping_repr
+
         lines: list[str] = [f"Frame {index + 1}/{total}: {self.name} ({self.module})"]
         if detail:
             lines.append(indent("Inputs:", _INDENT))
@@ -784,6 +785,9 @@ def _yield_header_lines(
     *, version: MaybeCallableVersionLike | None = None
 ) -> Iterator[str]:
     """Yield the header lines."""
+    from utilities.tzlocal import get_now_local
+    from utilities.whenever import serialize_zoned_datetime
+
     yield f"Date/time | {serialize_zoned_datetime(get_now_local())}"
     yield f"User      | {getuser()}"
     yield f"Host      | {gethostname()}"

utilities/tzdata.py

@@ -1,9 +1,63 @@
 from __future__ import annotations
 
+from typing import TYPE_CHECKING
 from zoneinfo import ZoneInfo
 
+from utilities.datetime import get_now, get_today
+
+if TYPE_CHECKING:
+    import datetime as dt
+
+
+HongKong = ZoneInfo("Asia/Hong_Kong")
+Tokyo = ZoneInfo("Asia/Tokyo")
 USCentral = ZoneInfo("US/Central")
 USEastern = ZoneInfo("US/Eastern")
 
 
-__all__ = ["USCentral", "USEastern"]
+def get_now_hong_kong() -> dt.datetime:
+    """Get the current time in Hong Kong."""
+    return get_now(time_zone=HongKong)
+
+
+NOW_HONG_KONG = get_now_hong_kong()
+
+
+def get_now_tokyo() -> dt.datetime:
+    """Get the current time in Tokyo."""
+    return get_now(time_zone=Tokyo)
+
+
+NOW_TOKYO = get_now_tokyo()
+
+
+def get_today_hong_kong() -> dt.date:
+    """Get the current date in Hong Kong."""
+    return get_today(time_zone=HongKong)
+
+
+TODAY_HONG_KONG = get_today_hong_kong()
+
+
+def get_today_tokyo() -> dt.date:
+    """Get the current date in Tokyo."""
+    return get_today(time_zone=Tokyo)
+
+
+TODAY_TOKYO = get_today_tokyo()
+
+
+__all__ = [
+    "NOW_HONG_KONG",
+    "NOW_TOKYO",
+    "TODAY_HONG_KONG",
+    "TODAY_TOKYO",
+    "HongKong",
+    "Tokyo",
+    "USCentral",
+    "USEastern",
+    "get_now_hong_kong",
+    "get_now_tokyo",
+    "get_today_hong_kong",
+    "get_today_tokyo",
+]

utilities/tzlocal.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import datetime as dt
 from logging import getLogger
 from typing import TYPE_CHECKING
 
@@ -19,4 +20,26 @@ def get_local_time_zone() -> ZoneInfo:
     return time_zone
 
 
-__all__ = ["get_local_time_zone"]
+def get_now_local() -> dt.datetime:
+    """Get the current local time."""
+    return dt.datetime.now(tz=get_local_time_zone())
+
+
+NOW_LOCAL = get_now_local()
+
+
+def get_today_local() -> dt.date:
+    """Get the current, timezone-aware local date."""
+    return get_now_local().date()
+
+
+TODAY_LOCAL = get_today_local()
+
+
+__all__ = [
+    "NOW_LOCAL",
+    "TODAY_LOCAL",
+    "get_local_time_zone",
+    "get_now_local",
+    "get_today_local",
+]

utilities/whenever.py

@@ -36,6 +36,7 @@ if TYPE_CHECKING:
         TimeLike,
     )
 
+
 MAX_SERIALIZABLE_TIMEDELTA = dt.timedelta(days=3659635, microseconds=-1)
 MIN_SERIALIZABLE_TIMEDELTA = -MAX_SERIALIZABLE_TIMEDELTA
 

utilities/zoneinfo.py

@@ -8,10 +8,10 @@ from zoneinfo import ZoneInfo
 if TYPE_CHECKING:
     from utilities.types import TimeZone, TimeZoneLike
 
-HongKong = ZoneInfo("Asia/Hong_Kong")
-Tokyo = ZoneInfo("Asia/Tokyo")
+
 UTC = ZoneInfo("UTC")
 
+
 ##
 
 
@@ -68,11 +68,4 @@ def get_time_zone_name(time_zone: TimeZoneLike, /) -> TimeZone:
     return cast("TimeZone", ensure_time_zone(time_zone).key)
 
 
-__all__ = [
-    "UTC",
-    "EnsureTimeZoneError",
-    "HongKong",
-    "Tokyo",
-    "ensure_time_zone",
-    "get_time_zone_name",
-]
+__all__ = ["UTC", "EnsureTimeZoneError", "ensure_time_zone", "get_time_zone_name"]