dycw-utilities 0.151.9__tar.gz → 0.151.11__tar.gz

{dycw_utilities-0.151.9 → dycw_utilities-0.151.11}/PKG-INFO

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

{dycw_utilities-0.151.9 → dycw_utilities-0.151.11}/pyproject.toml

@@ -232,7 +232,7 @@ dependencies = [
 name = "dycw-utilities"
 readme = "README.md"
 requires-python = ">= 3.12"
-version = "0.151.9"
+version = "0.151.11"
 
 [project.entry-points.pytest11]
 pytest-randomly = "utilities.pytest_plugins.pytest_randomly"
@@ -265,7 +265,7 @@ test = [
 # bump-my-version
 [tool.bumpversion]
 allow_dirty = true
-current_version = "0.151.9"
+current_version = "0.151.11"
 
 [[tool.bumpversion.files]]
 filename = "src/utilities/__init__.py"

{dycw_utilities-0.151.9 → dycw_utilities-0.151.11}/src/tests/test_period.py

@@ -21,9 +21,9 @@ from utilities.hypothesis import (
 )
 from utilities.period import (
     DatePeriod,
+    PeriodDict,
     TimePeriod,
     ZonedDateTimePeriod,
-    _PeriodAsDict,
     _PeriodExactEqArgumentsError,
     _PeriodInvalidError,
     _PeriodTimeZoneError,
@@ -154,7 +154,7 @@ class TestDatePeriod:
         period = DatePeriod(start, end)
         dict1 = period.to_dict()
         dstart, dend = dict1["start"], dict1["end"]
-        dict2 = _PeriodAsDict(
+        dict2 = PeriodDict(
             start=data.draw(sampled_from([dstart, dstart.py_date()])),
             end=data.draw(sampled_from([dend, dend.py_date()])),
         )
@@ -240,7 +240,7 @@ class TestTimePeriod:
         period = TimePeriod(start, end)
         dict1 = period.to_dict()
         dstart, dend = dict1["start"], dict1["end"]
-        dict2 = _PeriodAsDict(
+        dict2 = PeriodDict(
             start=data.draw(sampled_from([dstart, dstart.py_time()])),
             end=data.draw(sampled_from([dend, dend.py_time()])),
         )
@@ -478,7 +478,7 @@ class TestZonedDateTimePeriod:
         period = ZonedDateTimePeriod(start, end)
         dict1 = period.to_dict()
         dstart, dend = dict1["start"], dict1["end"]
-        dict2 = _PeriodAsDict(
+        dict2 = PeriodDict(
             start=data.draw(sampled_from([dstart, dstart.py_datetime()])),
             end=data.draw(sampled_from([dend, dend.py_datetime()])),
         )

{dycw_utilities-0.151.9 → dycw_utilities-0.151.11}/src/tests/test_polars.py

@@ -1500,14 +1500,14 @@ class TestGetDataTypeOrSeriesTimeZone:
                 dtype = zoned_datetime_dtype(time_zone=time_zone)
             case "struct":
                 dtype = zoned_datetime_period_dtype(time_zone=time_zone)
-            case _ as never:
+            case never:
                 assert_never(never)
         match dtype_or_series:
             case "dtype":
                 obj = dtype
             case "series":
                 obj = Series(dtype=dtype)
-            case _ as never:
+            case never:
                 assert_never(never)
         result = get_data_type_or_series_time_zone(obj)
         assert result is time_zone

{dycw_utilities-0.151.9 → dycw_utilities-0.151.11}/src/utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.151.9"
+__version__ = "0.151.11"

{dycw_utilities-0.151.9 → dycw_utilities-0.151.11}/src/utilities/asyncio.py

@@ -275,7 +275,7 @@ class EnhancedTaskGroup(TaskGroup):
                     _ = await super().__aexit__(et, exc, tb)
             case False:
                 _ = await super().__aexit__(et, exc, tb)
-            case _ as never:
+            case never:
                 assert_never(never)
 
     @override
@@ -312,7 +312,7 @@ class EnhancedTaskGroup(TaskGroup):
                     self.create_task(make_coro(*args, **kwargs))
                     for _ in range(self._max_tasks)
                 ]
-            case _ as never:
+            case never:
                 assert_never(never)
 
     async def run_or_create_task[T](
@@ -327,7 +327,7 @@ class EnhancedTaskGroup(TaskGroup):
                 return await coro
             case False:
                 return self.create_task(coro, name=name, context=context)
-            case _ as never:
+            case never:
                 assert_never(never)
 
     def _is_debug(self) -> bool:

{dycw_utilities-0.151.9 → dycw_utilities-0.151.11}/src/utilities/hypothesis.py

@@ -180,14 +180,14 @@ def date_deltas(
             min_value_ = DATE_DELTA_MIN
         case DateDelta():
             ...
-        case _ as never:
+        case never:
             assert_never(never)
     match max_value_:
         case None:
             max_value_ = DATE_DELTA_MAX
         case DateDelta():
             ...
-        case _ as never:
+        case never:
             assert_never(never)
     min_days = to_days(min_value_)
     max_days = to_days(max_value_)
@@ -217,14 +217,14 @@ def date_time_deltas(
             min_value_ = DATE_TIME_DELTA_MIN
         case DateTimeDelta():
             ...
-        case _ as never:
+        case never:
             assert_never(never)
     match max_value_:
         case None:
             max_value_ = DATE_TIME_DELTA_MAX
         case DateTimeDelta():
             ...
-        case _ as never:
+        case never:
             assert_never(never)
     min_nanos, max_nanos = map(to_nanoseconds, [min_value_, max_value_])
     if draw2(draw, parsable):
@@ -253,14 +253,14 @@ def dates(
             min_value_ = Date.MIN
         case Date():
             ...
-        case _ as never:
+        case never:
             assert_never(never)
     match max_value_:
         case None:
             max_value_ = Date.MAX
         case Date():
             ...
-        case _ as never:
+        case never:
             assert_never(never)
     if draw2(draw, two_digit):
         min_value_ = max(min_value_, DATE_TWO_DIGIT_YEAR_MIN)
@@ -343,7 +343,7 @@ def draw2[T](
             raise _Draw2InputResolvedToSentinelError
         case _, _, _:
             return value
-        case _ as never:
+        case never:
             assert_never(never)
 
 
@@ -672,14 +672,14 @@ def month_days(
             min_value_ = MonthDay.MIN
         case MonthDay():
             ...
-        case _ as never:
+        case never:
             assert_never(never)
     match max_value_:
         case None:
             max_value_ = MonthDay.MAX
         case MonthDay():
             ...
-        case _ as never:
+        case never:
             assert_never(never)
     min_date, max_date = [m.in_year(2000) for m in [min_value_, max_value_]]
     date = draw(dates(min_value=min_date, max_value=max_date))
@@ -794,14 +794,14 @@ def plain_datetimes(
             min_value_ = PlainDateTime.MIN
         case PlainDateTime():
             ...
-        case _ as never:
+        case never:
             assert_never(never)
     match max_value_:
         case None:
             max_value_ = PlainDateTime.MAX
         case PlainDateTime():
             ...
-        case _ as never:
+        case never:
             assert_never(never)
     py_datetime = draw(
         datetimes(
@@ -887,7 +887,7 @@ def setup_hypothesis_profiles(
                     return 100
                 case Profile.ci:
                     return 1000
-                case _ as never:
+                case never:
                     assert_never(never)
 
         @property
@@ -897,7 +897,7 @@ def setup_hypothesis_profiles(
                     return Verbosity.quiet
                 case Profile.ci:
                     return Verbosity.verbose
-                case _ as never:
+                case never:
                     assert_never(never)
 
     phases = {Phase.explicit, Phase.reuse, Phase.generate, Phase.target}
@@ -1154,14 +1154,14 @@ def time_deltas(
             min_value_ = TIME_DELTA_MIN
         case TimeDelta():
             ...
-        case _ as never:
+        case never:
             assert_never(never)
     match max_value_:
         case None:
             max_value_ = TIME_DELTA_MAX
         case TimeDelta():
             ...
-        case _ as never:
+        case never:
             assert_never(never)
     py_time = draw(
         hypothesis.strategies.timedeltas(
@@ -1189,14 +1189,14 @@ def times(
             min_value_ = Time.MIN
         case Time():
             ...
-        case _ as never:
+        case never:
             assert_never(never)
     match max_value_:
         case None:
             max_value_ = Time.MAX
         case Time():
             ...
-        case _ as never:
+        case never:
             assert_never(never)
     py_time = draw(
         hypothesis.strategies.times(
@@ -1356,14 +1356,14 @@ def year_months(
             min_value_ = YearMonth.MIN
         case YearMonth():
             ...
-        case _ as never:
+        case never:
             assert_never(never)
     match max_value_:
         case None:
             max_value_ = YearMonth.MAX
         case YearMonth():
             ...
-        case _ as never:
+        case never:
             assert_never(never)
     min_date, max_date = [m.on_day(1) for m in [min_value_, max_value_]]
     date = draw(dates(min_value=min_date, max_value=max_date, two_digit=two_digit))
@@ -1391,7 +1391,7 @@ def zoned_datetimes(
         case ZonedDateTime():
             with assume_does_not_raise(ValueError):
                 min_value_ = min_value_.to_tz(time_zone_.key).to_plain()
-        case _ as never:
+        case never:
             assert_never(never)
     match max_value_:
         case None | PlainDateTime():
@@ -1399,7 +1399,7 @@ def zoned_datetimes(
         case ZonedDateTime():
             with assume_does_not_raise(ValueError):
                 max_value_ = max_value_.to_tz(time_zone_.key).to_plain()
-        case _ as never:
+        case never:
             assert_never(never)
     plain = draw(plain_datetimes(min_value=min_value_, max_value=max_value_))
     with (

{dycw_utilities-0.151.9 → dycw_utilities-0.151.11}/src/utilities/logging.py

@@ -144,7 +144,7 @@ def basic_config(
                 color_field_styles=color_field_styles,
             )
             handler.setFormatter(formatter)
-        case _ as never:
+        case never:
             assert_never(never)
 
 
@@ -275,7 +275,7 @@ def get_logger(*, logger: LoggerOrName | None = None) -> Logger:
             return logger
         case str() | None:
             return getLogger(logger)
-        case _ as never:
+        case never:
             assert_never(never)
 
 

{dycw_utilities-0.151.9 → dycw_utilities-0.151.11}/src/utilities/period.py

@@ -2,7 +2,16 @@ from __future__ import annotations
 
 import datetime as dt
 from dataclasses import dataclass
-from typing import TYPE_CHECKING, Any, Self, TypedDict, assert_never, overload, override
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Self,
+    TypedDict,
+    TypeVar,
+    assert_never,
+    overload,
+    override,
+)
 from zoneinfo import ZoneInfo
 
 from whenever import Date, DateDelta, PlainDateTime, Time, TimeDelta, ZonedDateTime
@@ -16,8 +25,14 @@ from utilities.zoneinfo import UTC, ensure_time_zone, get_time_zone_name
 if TYPE_CHECKING:
     from utilities.types import TimeZoneLike
 
+_TDate_co = TypeVar("_TDate_co", bound=Date | dt.date, covariant=True)
+_TTime_co = TypeVar("_TTime_co", bound=Time | dt.time, covariant=True)
+_TDateTime_co = TypeVar(
+    "_TDateTime_co", bound=ZonedDateTime | dt.datetime, covariant=True
+)
 
-class _PeriodAsDict[T: Date | Time | ZonedDateTime | dt.date | dt.time | dt.datetime](
+
+class PeriodDict[T: Date | Time | ZonedDateTime | dt.date | dt.time | dt.datetime](
     TypedDict
 ):
     start: T
@@ -85,7 +100,7 @@ class DatePeriod:
         return f"{fc(start)}-{fc(end)}"
 
     @classmethod
-    def from_dict(cls, mapping: _PeriodAsDict[Date | dt.date], /) -> Self:
+    def from_dict(cls, mapping: PeriodDict[_TDate_co], /) -> Self:
         """Convert the dictionary to a period."""
         match mapping["start"]:
             case Date() as start:
@@ -109,9 +124,9 @@ class DatePeriod:
         """Replace elements of the period."""
         return replace_non_sentinel(self, start=start, end=end)
 
-    def to_dict(self) -> _PeriodAsDict[Date]:
+    def to_dict(self) -> PeriodDict[Date]:
         """Convert the period to a dictionary."""
-        return _PeriodAsDict(start=self.start, end=self.end)
+        return PeriodDict(start=self.start, end=self.end)
 
 
 @dataclass(repr=False, order=True, unsafe_hash=True, kw_only=False)
@@ -140,7 +155,7 @@ class TimePeriod:
         return DatePeriod(start, end).at((self.start, self.end), time_zone=time_zone)
 
     @classmethod
-    def from_dict(cls, mapping: _PeriodAsDict[Time | dt.time], /) -> Self:
+    def from_dict(cls, mapping: PeriodDict[_TTime_co], /) -> Self:
         """Convert the dictionary to a period."""
         match mapping["start"]:
             case Time() as start:
@@ -164,9 +179,9 @@ class TimePeriod:
         """Replace elements of the period."""
         return replace_non_sentinel(self, start=start, end=end)
 
-    def to_dict(self) -> _PeriodAsDict[Time]:
+    def to_dict(self) -> PeriodDict[Time]:
         """Convert the period to a dictionary."""
-        return _PeriodAsDict(start=self.start, end=self.end)
+        return PeriodDict(start=self.start, end=self.end)
 
 
 @dataclass(repr=False, order=True, unsafe_hash=True, kw_only=False)
@@ -271,7 +286,7 @@ class ZonedDateTimePeriod:
         return f"{fc(start.to_plain())}-{fc(end, fmt='%Y%m%dT%H')}"
 
     @classmethod
-    def from_dict(cls, mapping: _PeriodAsDict[ZonedDateTime | dt.datetime], /) -> Self:
+    def from_dict(cls, mapping: PeriodDict[_TDateTime_co], /) -> Self:
         """Convert the dictionary to a period."""
         match mapping["start"]:
             case ZonedDateTime() as start:
@@ -303,9 +318,9 @@ class ZonedDateTimePeriod:
         """The time zone of the period."""
         return ZoneInfo(self.start.tz)
 
-    def to_dict(self) -> _PeriodAsDict[ZonedDateTime]:
+    def to_dict(self) -> PeriodDict[ZonedDateTime]:
         """Convert the period to a dictionary."""
-        return _PeriodAsDict(start=self.start, end=self.end)
+        return PeriodDict(start=self.start, end=self.end)
 
     def to_tz(self, time_zone: TimeZoneLike, /) -> Self:
         """Convert the time zone."""
@@ -346,4 +361,10 @@ class _PeriodExactEqArgumentsError(PeriodError):
         return f"Invalid arguments; got {self.args}"
 
 
-__all__ = ["DatePeriod", "PeriodError", "TimePeriod", "ZonedDateTimePeriod"]
+__all__ = [
+    "DatePeriod",
+    "PeriodDict",
+    "PeriodError",
+    "TimePeriod",
+    "ZonedDateTimePeriod",
+]

{dycw_utilities-0.151.9 → dycw_utilities-0.151.11}/src/utilities/redis.py

@@ -386,7 +386,7 @@ class RedisKey[T]:
         match result:  # skipif-ci-and-not-linux
             case 0 | 1 as value:
                 return bool(value)
-            case _ as never:
+            case never:
                 assert_never(never)
 
     async def get(self, redis: Redis, /) -> T:
@@ -561,7 +561,7 @@ async def publish[T](
             raise PublishError(data=data)
         case _, Callable():
             data_use = serializer(data)
-        case _ as never:
+        case never:
             assert_never(never)
     async with timeout_td(timeout):  # skipif-ci-and-not-linux
         response = await redis.publish(channel, data_use)  # skipif-ci-and-not-linux
@@ -710,7 +710,7 @@ async def subscribe[T](
             def transform(message: _RedisMessage, /) -> T:
                 return deserialize(message["data"])
 
-        case _ as never:
+        case never:
             assert_never(never)
 
     task = create_task(  # skipif-ci-and-not-linux

{dycw_utilities-0.151.9 → dycw_utilities-0.151.11}/src/utilities/sqlalchemy.py

@@ -166,7 +166,7 @@ async def check_engine(
             query = "select * from all_objects"
         case "sqlite":
             query = "select * from sqlite_master where type='table'"
-        case _ as never:
+        case never:
             assert_never(never)
     statement = text(query)
     async with yield_connection(engine, timeout=timeout, error=error) as conn:
@@ -312,7 +312,7 @@ def create_engine(
             return sqlalchemy.create_engine(url, poolclass=poolclass)
         case True:
             return sqlalchemy.ext.asyncio.create_async_engine(url, poolclass=poolclass)
-        case _ as never:
+        case never:
             assert_never(never)
 
 
@@ -339,7 +339,7 @@ async def ensure_tables_created(
             match = "ORA-00955: name is already used by an existing object"
         case "sqlite":
             match = "table .* already exists"
-        case _ as never:
+        case never:
             assert_never(never)
     async with yield_connection(engine, timeout=timeout, error=error) as conn:
         for table in tables:
@@ -368,7 +368,7 @@ async def ensure_tables_dropped(
             match = "ORA-00942: table or view does not exist"
         case "sqlite":
             match = "no such table"
-        case _ as never:
+        case never:
             assert_never(never)
     async with yield_connection(engine, timeout=timeout, error=error) as conn:
         for table in tables:
@@ -493,7 +493,7 @@ def get_chunk_size(
         case int() as num_cols:
             size = floor(chunk_size_frac * max_params / num_cols)
             return max(size, 1)
-        case _ as never:
+        case never:
             assert_never(never)
 
 
@@ -777,7 +777,7 @@ def _normalize_upsert_item(
                 yield _NormalizedItem(mapping=values, table=norm.table)
         case "all":
             yield from normalized
-        case _ as never:
+        case never:
             assert_never(never)
 
 
@@ -890,7 +890,7 @@ def _upsert_items_build(
             insert = sqlite_insert
         case "mssql" | "mysql" | "oracle" as dialect:  # pragma: no cover
             raise NotImplementedError(dialect)
-        case _ as never:
+        case never:
             assert_never(never)
     ins = insert(table).values(values)
     primary_key = cast("Any", table.primary_key)
@@ -912,7 +912,7 @@ def _upsert_items_apply_on_conflict_do_update(
             columns = merge_sets(*values)
         case "all":
             columns = {c.name for c in insert.excluded}
-        case _ as never:
+        case never:
             assert_never(never)
     set_ = {c: getattr(insert.excluded, c) for c in columns}
     match insert:
@@ -920,7 +920,7 @@ def _upsert_items_apply_on_conflict_do_update(
             return insert.on_conflict_do_update(constraint=primary_key, set_=set_)
         case sqlite_Insert():
             return insert.on_conflict_do_update(index_elements=primary_key, set_=set_)
-        case _ as never:
+        case never:
             assert_never(never)
 
 
@@ -1029,7 +1029,7 @@ def _get_dialect_max_params(
         ):
             dialect = _get_dialect(engine_or_conn)
             return _get_dialect_max_params(dialect)
-        case _ as never:
+        case never:
             assert_never(never)