dycw-utilities 0.129.10__py3-none-any.whl → 0.175.17__py3-none-any.whl

utilities/tzdata.py

@@ -1,63 +1,11 @@
 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")
 
 
-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",
-]
+__all__ = ["HongKong", "Tokyo", "USCentral", "USEastern"]

utilities/tzlocal.py

@@ -1,14 +1,15 @@
 from __future__ import annotations
 
-import datetime as dt
 from logging import getLogger
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, cast
 
 from tzlocal import get_localzone
 
 if TYPE_CHECKING:
     from zoneinfo import ZoneInfo
 
+    from utilities.types import TimeZone
+
 
 def get_local_time_zone() -> ZoneInfo:
     """Get the local time zone, with the logging disabled."""
@@ -20,26 +21,8 @@ def get_local_time_zone() -> ZoneInfo:
     return 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()
+LOCAL_TIME_ZONE = get_local_time_zone()
+LOCAL_TIME_ZONE_NAME = cast("TimeZone", LOCAL_TIME_ZONE.key)
 
 
-__all__ = [
-    "NOW_LOCAL",
-    "TODAY_LOCAL",
-    "get_local_time_zone",
-    "get_now_local",
-    "get_today_local",
-]
+__all__ = ["LOCAL_TIME_ZONE", "LOCAL_TIME_ZONE_NAME", "get_local_time_zone"]

utilities/uuid.py

@@ -1,23 +1,61 @@
 from __future__ import annotations
 
-from typing import TYPE_CHECKING
+from collections.abc import Callable
+from random import Random
+from typing import TYPE_CHECKING, assert_never, overload
 from uuid import UUID, uuid4
 
 from utilities.random import get_state
+from utilities.sentinel import Sentinel
 
 if TYPE_CHECKING:
-    from utilities.types import Seed
+    from utilities.types import MaybeCallableUUIDLike, Seed
+
 
 UUID_PATTERN = "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
 UUID_EXACT_PATTERN = f"^{UUID_PATTERN}$"
 
 
-def get_uuid(*, seed: Seed | None = None) -> UUID:
+##
+
+
+def get_uuid(seed: Seed | None = None, /) -> UUID:
     """Generate a UUID, possibly with a seed."""
     if seed is None:
         return uuid4()
-    state = get_state(seed=seed)
+    state = get_state(seed)
     return UUID(int=state.getrandbits(128), version=4)
 
 
-__all__ = ["UUID_EXACT_PATTERN", "UUID_PATTERN", "get_uuid"]
+##
+
+
+@overload
+def to_uuid(uuid: Sentinel, /, *, seed: Seed | None = None) -> Sentinel: ...
+@overload
+def to_uuid(
+    uuid: MaybeCallableUUIDLike | None = get_uuid, /, *, seed: Seed | None = None
+) -> UUID: ...
+def to_uuid(
+    uuid: MaybeCallableUUIDLike | None | Sentinel = get_uuid,
+    /,
+    *,
+    seed: Seed | None = None,
+) -> UUID | Sentinel:
+    """Convert to a UUID."""
+    match uuid:
+        case UUID() | Sentinel():
+            return uuid
+        case None:
+            return get_uuid(seed)
+        case str():
+            return UUID(uuid)
+        case int() | float() | bytes() | bytearray() | Random() as seed:
+            return get_uuid(seed)
+        case Callable() as func:
+            return to_uuid(func(), seed=seed)
+        case never:
+            assert_never(never)
+
+
+__all__ = ["UUID_EXACT_PATTERN", "UUID_PATTERN", "get_uuid", "to_uuid"]

utilities/version.py

@@ -6,7 +6,7 @@ from dataclasses import dataclass, field, replace
 from functools import total_ordering
 from typing import Any, Self, assert_never, overload, override
 
-from utilities.sentinel import Sentinel, sentinel
+from utilities.sentinel import Sentinel
 from utilities.types import MaybeCallable, MaybeStr
 
 type VersionLike = MaybeStr[Version]
@@ -131,30 +131,6 @@ class _VersionEmptySuffixError(VersionError):
 ##
 
 
-@overload
-def get_version(*, version: MaybeCallableVersionLike) -> Version: ...
-@overload
-def get_version(*, version: None) -> None: ...
-@overload
-def get_version(*, version: Sentinel) -> Sentinel: ...
-def get_version(
-    *, version: MaybeCallableVersionLike | None | Sentinel = sentinel
-) -> Version | None | Sentinel:
-    """Get the version."""
-    match version:
-        case Version() | None | Sentinel():
-            return version
-        case str():
-            return parse_version(version)
-        case Callable() as func:
-            return get_version(version=func())
-        case _ as never:
-            assert_never(never)
-
-
-##
-
-
 def parse_version(version: str, /) -> Version:
     """Parse a string into a version object."""
     try:
@@ -178,12 +154,37 @@ class ParseVersionError(Exception):
         return f"Invalid version string: {self.version!r}"
 
 
+##
+
+
+@overload
+def to_version(version: MaybeCallableVersionLike, /) -> Version: ...
+@overload
+def to_version(version: None, /) -> None: ...
+@overload
+def to_version(version: Sentinel, /) -> Sentinel: ...
+def to_version(
+    version: MaybeCallableVersionLike | None | Sentinel, /
+) -> Version | None | Sentinel:
+    """Convert to a version."""
+    match version:
+        case Version() | None | Sentinel():
+            return version
+        case str():
+            return parse_version(version)
+        case Callable() as func:
+            return to_version(func())
+        case never:
+            assert_never(never)
+
+
+##
 __all__ = [
     "MaybeCallableVersionLike",
     "ParseVersionError",
     "Version",
     "VersionError",
     "VersionLike",
-    "get_version",
     "parse_version",
+    "to_version",
 ]