dycw-utilities 0.119.0__tar.gz → 0.121.0__tar.gz

{dycw_utilities-0.119.0 → dycw_utilities-0.121.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: dycw-utilities
-Version: 0.119.0
+Version: 0.121.0
 Author-email: Derek Wan <d.wan@icloud.com>
 License-File: LICENSE
 Requires-Python: >=3.12
 Requires-Dist: typing-extensions<4.14,>=4.13.1
 Provides-Extra: test
-Requires-Dist: hypothesis<6.132,>=6.131.19; extra == 'test'
+Requires-Dist: hypothesis<6.132,>=6.131.20; extra == 'test'
 Requires-Dist: pytest-asyncio<0.27,>=0.26.0; extra == 'test'
 Requires-Dist: pytest-cov<6.2,>=6.1.1; extra == 'test'
 Requires-Dist: pytest-instafail<0.6,>=0.5.0; extra == 'test'
@@ -80,7 +80,7 @@ Provides-Extra: zzz-test-hypothesis
 Requires-Dist: aiosqlite<0.22,>=0.21.0; extra == 'zzz-test-hypothesis'
 Requires-Dist: asyncpg<0.31,>=0.30.0; extra == 'zzz-test-hypothesis'
 Requires-Dist: greenlet<3.3,>=3.2.0; extra == 'zzz-test-hypothesis'
-Requires-Dist: hypothesis<6.132,>=6.131.19; extra == 'zzz-test-hypothesis'
+Requires-Dist: hypothesis<6.132,>=6.131.20; extra == 'zzz-test-hypothesis'
 Requires-Dist: luigi<3.7,>=3.6.0; extra == 'zzz-test-hypothesis'
 Requires-Dist: numpy<2.3,>=2.2.6; extra == 'zzz-test-hypothesis'
 Requires-Dist: pathvalidate<3.3,>=3.2.3; extra == 'zzz-test-hypothesis'

{dycw_utilities-0.119.0 → dycw_utilities-0.121.0}/pyproject.toml

@@ -26,7 +26,7 @@ dev = [
   "fpdf2 >= 2.8.3, < 2.9",
   "greenlet >= 3.2.0, < 3.3",  # for sqlalchemy async
   "httpx >= 0.28.1, < 0.29",  # for fastapi
-  "hypothesis >= 6.131.19, < 6.132",
+  "hypothesis >= 6.131.20, < 6.132",
   "img2pdf >= 0.6.0, < 0.7",
   "lightweight-charts >= 2.1, < 2.2",
   "loguru >= 0.7.3, < 0.8",
@@ -92,11 +92,11 @@ dependencies = [
 name = "dycw-utilities"
 readme = "README.md"
 requires-python = ">= 3.12"
-version = "0.119.0"
+version = "0.121.0"
 
 [project.optional-dependencies]
 test = [
-  "hypothesis >= 6.131.19, < 6.132",
+  "hypothesis >= 6.131.20, < 6.132",
   "pytest >= 8.3.5, < 8.4",
   "pytest-asyncio >= 0.26.0, < 0.27",
   "pytest-cov >= 6.1.1, < 6.2",
@@ -174,7 +174,7 @@ zzz-test-hypothesis = [
   "aiosqlite >= 0.21.0, < 0.22",
   "asyncpg >= 0.30.0, < 0.31",  # for sqlalchemy async
   "greenlet >= 3.2.0, < 3.3",  # for sqlalchemy async
-  "hypothesis >= 6.131.19, < 6.132",
+  "hypothesis >= 6.131.20, < 6.132",
   "luigi >= 3.6.0, < 3.7",
   "numpy >= 2.2.6, < 2.3",
   "pathvalidate >= 3.2.3, < 3.3",
@@ -334,7 +334,7 @@ zzz-test-zoneinfo = [
 # bump-my-version
 [tool.bumpversion]
 allow_dirty = true
-current_version = "0.119.0"
+current_version = "0.121.0"
 
 [[tool.bumpversion.files]]
 filename = "src/utilities/__init__.py"

{dycw_utilities-0.119.0 → dycw_utilities-0.121.0}/src/tests/test_asyncio.py

@@ -5,7 +5,7 @@ from dataclasses import dataclass, field
 from functools import partial
 from itertools import chain, count
 from re import search
-from typing import TYPE_CHECKING, Self, override
+from typing import TYPE_CHECKING, Any, Self, cast, override
 
 from hypothesis import HealthCheck, Phase, given, settings
 from hypothesis.strategies import (
@@ -23,12 +23,12 @@ from pytest import LogCaptureFixture, mark, raises
 from utilities.asyncio import (
     EnhancedTaskGroup,
     InfiniteLooper,
-    InfiniteLooperError,
     InfiniteQueueLooper,
     InfiniteQueueLooperError,
     UniquePriorityQueue,
     UniqueQueue,
-    _DurationOrEvery,
+    _InfiniteLooperDefaultEventError,
+    _InfiniteLooperNoSuchEventError,
     get_event,
     get_items,
     get_items_nowait,
@@ -56,7 +56,13 @@ from utilities.timer import Timer
 if TYPE_CHECKING:
     from collections.abc import Callable, Iterator
 
-    from utilities.types import Coroutine1, Duration, MaybeCallableEvent, MaybeType
+    from utilities.types import (
+        Coroutine1,
+        Duration,
+        DurationOrEveryDuration,
+        MaybeCallableEvent,
+        MaybeType,
+    )
 
 
 class TestEnhancedTaskGroup:
@@ -130,7 +136,7 @@ class TestGetEvent:
 
 class TestInfiniteLooper:
     @given(n=integers(10, 11), sleep_core=sampled_from([0.1, ("every", 0.1)]))
-    async def test_main(self, *, n: int, sleep_core: _DurationOrEvery) -> None:
+    async def test_main(self, *, n: int, sleep_core: DurationOrEveryDuration) -> None:
         class TrueError(BaseException): ...
 
         class FalseError(BaseException): ...
@@ -147,7 +153,7 @@ class TestInfiniteLooper:
             async def _core(self) -> None:
                 self.counter += 1
                 if self.counter >= n:
-                    self._set_event(n % 2 == 0)
+                    self._set_event(event=n % 2 == 0)
 
             @override
             def _yield_events_and_exceptions(
@@ -166,15 +172,8 @@ class TestInfiniteLooper:
                     _ = await looper()
 
     async def test_hashable(self) -> None:
-        class CustomError(Exception): ...
-
         @dataclass(kw_only=True, unsafe_hash=True)
-        class Example(InfiniteLooper[None]):
-            @override
-            def _yield_events_and_exceptions(
-                self,
-            ) -> Iterator[tuple[None, MaybeType[Exception]]]:
-                yield (None, CustomError)
+        class Example(InfiniteLooper[None]): ...
 
         looper = Example(sleep_core=0.1)
         _ = hash(looper)
@@ -189,8 +188,6 @@ class TestInfiniteLooper:
                 obj.counter += 1
                 await sleep(0.05)
 
-        class CustomError(Exception): ...
-
         @dataclass(kw_only=True)
         class Example(InfiniteLooper[None]):
             initializations: int = 0
@@ -205,18 +202,12 @@ class TestInfiniteLooper:
             async def _core(self) -> None:
                 self.counter += 1
                 if self.counter >= 5:
-                    self._set_event(None)
+                    self._set_event()
 
             @override
             def _yield_coroutines(self) -> Iterator[Callable[[], Coroutine1[None]]]:
                 yield partial(inc_external, self)
 
-            @override
-            def _yield_events_and_exceptions(
-                self,
-            ) -> Iterator[tuple[None, MaybeType[BaseException]]]:
-                yield (None, CustomError)
-
         looper = Example(sleep_core=0.05, sleep_restart=0.05)
         with raises(TimeoutError):
             async with timeout_dur(duration=1.0):
@@ -251,12 +242,6 @@ class TestInfiniteLooper:
             def _yield_coroutines(self) -> Iterator[Callable[[], Coroutine1[None]]]:
                 yield dummy
 
-            @override
-            def _yield_events_and_exceptions(
-                self,
-            ) -> Iterator[tuple[None, MaybeType[BaseException]]]:
-                yield (None, CustomError)
-
         looper = Example(sleep_core=0.05, sleep_restart=0.05)
         with raises(TimeoutError):
             async with timeout_dur(duration=1.0):
@@ -294,12 +279,6 @@ class TestInfiniteLooper:
             def _yield_coroutines(self) -> Iterator[Callable[[], Coroutine1[None]]]:
                 yield dummy
 
-            @override
-            def _yield_events_and_exceptions(
-                self,
-            ) -> Iterator[tuple[None, MaybeType[BaseException]]]:
-                yield (None, CustomError)
-
         looper = Example(sleep_core=0.05, sleep_restart=0.05, logger=logger)
         with raises(CancelledError):
             async with timeout_dur(duration=1.0):
@@ -307,6 +286,17 @@ class TestInfiniteLooper:
         assert 3 <= looper.initializations <= 5
         assert 1 <= looper.counter <= 6
 
+    async def test_error_default_event(self) -> None:
+        @dataclass(kw_only=True)
+        class Example(InfiniteLooper[None]): ...
+
+        looper = Example()
+
+        with raises(
+            _InfiniteLooperDefaultEventError, match=r"'Example' default event error"
+        ):
+            raise _InfiniteLooperDefaultEventError(looper=looper)
+
     @given(logger=just("logger") | none())
     @mark.parametrize(
         ("sleep_restart", "desc"),
@@ -321,7 +311,7 @@ class TestInfiniteLooper:
     async def test_error_upon_initialize(
         self,
         *,
-        sleep_restart: _DurationOrEvery,
+        sleep_restart: DurationOrEveryDuration,
         desc: str,
         logger: str | None,
         caplog: LogCaptureFixture,
@@ -361,7 +351,7 @@ class TestInfiniteLooper:
     async def test_error_group_upon_coroutines(
         self,
         *,
-        sleep_restart: _DurationOrEvery,
+        sleep_restart: DurationOrEveryDuration,
         desc: str,
         logger: str | None,
         caplog: LogCaptureFixture,
@@ -374,12 +364,6 @@ class TestInfiniteLooper:
             async def _core(self) -> None:
                 raise CustomError
 
-            @override
-            def _yield_events_and_exceptions(
-                self,
-            ) -> Iterator[tuple[None, MaybeType[BaseException]]]:
-                yield (None, CustomError)
-
         looper = Example(sleep_core=0.1, sleep_restart=sleep_restart, logger=logger)
         with raises(TimeoutError):
             async with timeout_dur(duration=0.5):
@@ -402,10 +386,13 @@ class TestInfiniteLooper:
             async def _core(self) -> None:
                 self.counter += 1
                 if self.counter >= 10:
-                    self._set_event(None)
+                    self._set_event(event=cast("Any", "invalid"))
 
-        looper = Example(sleep_core=0.1)
-        with raises(InfiniteLooperError, match="'Example' does not have an event None"):
+        looper = Example()
+        with raises(
+            _InfiniteLooperNoSuchEventError,
+            match="'Example' does not have an event 'invalid'",
+        ):
             _ = await looper()
 
 

{dycw_utilities-0.119.0 → dycw_utilities-0.121.0}/src/tests/test_redis.py

@@ -29,8 +29,8 @@ from utilities.hypothesis import (
 )
 from utilities.orjson import deserialize, serialize
 from utilities.redis import (
-    PublisherIQL,
-    PublisherIQLError,
+    Publisher,
+    PublisherError,
     publish,
     redis_hash_map_key,
     redis_key,
@@ -118,11 +118,11 @@ class TestPublishAndSubscribe:
                 _ = task.cancel()
 
 
-class TestPublisherIQL:
+class TestPublisher:
     @given(
         data=data(),
         channel=text_ascii(min_size=1).map(
-            lambda c: f"{get_class_name(TestPublisherIQL)}_main_{c}"
+            lambda c: f"{get_class_name(TestPublisher)}_main_{c}"
         ),
         obj=make_objects(),
     )
@@ -143,7 +143,7 @@ class TestPublisherIQL:
                 ):
                     _ = buffer.write(str(obj_i))
 
-            publisher = PublisherIQL(
+            publisher = Publisher(
                 redis=test.redis, serializer=serialize, sleep_core=0.1
             )
 
@@ -162,7 +162,7 @@ class TestPublisherIQL:
     @given(
         data=data(),
         channel=text_ascii(min_size=1).map(
-            lambda c: f"{get_class_name(TestPublisherIQL)}_text_without_serialize_{c}"
+            lambda c: f"{get_class_name(TestPublisher)}_text_without_serialize_{c}"
         ),
         text=text_ascii(min_size=1),
     )
@@ -182,7 +182,7 @@ class TestPublisherIQL:
                 async for bytes_i in subscribe(test.redis.pubsub(), channel):
                     _ = buffer.write(bytes_i)
 
-            publisher = PublisherIQL(redis=test.redis, sleep_core=0.1)
+            publisher = Publisher(redis=test.redis, sleep_core=0.1)
 
             async def sleep_then_put() -> None:
                 await sleep_dur(duration=0.1)
@@ -200,9 +200,9 @@ class TestPublisherIQL:
     @SKIPIF_CI_AND_NOT_LINUX
     async def test_error(self, *, data: DataObject) -> None:
         async with yield_test_redis(data) as test:
-            publisher = PublisherIQL(redis=test.redis)
-            with raises(PublisherIQLError, match="Error running 'PublisherIQL'"):
-                raise PublisherIQLError(publisher=publisher)
+            publisher = Publisher(redis=test.redis)
+            with raises(PublisherError, match="Error running 'Publisher'"):
+                raise PublisherError(publisher=publisher)
 
 
 class TestSubscribeMessages:

{dycw_utilities-0.119.0 → dycw_utilities-0.121.0}/src/tests/test_slack_sdk.py

@@ -12,7 +12,7 @@ from utilities.asyncio import EnhancedTaskGroup, sleep_dur
 from utilities.datetime import MINUTE
 from utilities.os import get_env_var
 from utilities.pytest import throttle
-from utilities.slack_sdk import SlackHandlerIQL, _get_client, send_to_slack
+from utilities.slack_sdk import SlackHandler, _get_client, send_to_slack
 
 if TYPE_CHECKING:
     from collections.abc import Sequence
@@ -39,7 +39,7 @@ class TestSendToSlack:
         )
 
 
-class TestSlackHandlerIQL:
+class TestSlackHandler:
     async def test_main(self, *, tmp_path: Path) -> None:
         messages: Sequence[str] = []
 
@@ -49,7 +49,7 @@ class TestSlackHandlerIQL:
 
         logger = getLogger(str(tmp_path))
         logger.addHandler(
-            handler := SlackHandlerIQL("url", sleep_core=0.05, sender=sender)
+            handler := SlackHandler("url", sleep_core=0.05, sender=sender)
         )
 
         async def sleep_then_log() -> None:
@@ -68,13 +68,13 @@ class TestSlackHandlerIQL:
     async def test_real(self, *, tmp_path: Path) -> None:
         url = get_env_var("SLACK")
         logger = getLogger(str(tmp_path))
-        logger.addHandler(handler := SlackHandlerIQL(url, sleep_core=0.05))
+        logger.addHandler(handler := SlackHandler(url, sleep_core=0.05))
 
         async def sleep_then_log() -> None:
             await sleep_dur(duration=0.05)
             for i in range(10):
                 logger.warning(
-                    "message %d from %s", i, TestSlackHandlerIQL.test_real.__qualname__
+                    "message %d from %s", i, TestSlackHandler.test_real.__qualname__
                 )
 
         with raises(ExceptionGroup):  # noqa: PT012

{dycw_utilities-0.119.0 → dycw_utilities-0.121.0}/src/tests/test_sqlalchemy.py

@@ -43,8 +43,8 @@ from utilities.sqlalchemy import (
     InsertItemsError,
     TablenameMixin,
     TableOrORMInstOrClass,
-    UpserterIQL,
-    UpserterIQLError,
+    Upserter,
+    UpserterError,
     UpsertItemsError,
     _get_dialect,
     _get_dialect_max_params,
@@ -1150,7 +1150,7 @@ class TestTupleToMapping:
         assert result == expected
 
 
-class TestUpserterIQL:
+class TestUpserter:
     @given(
         data=data(),
         name=_table_names(),
@@ -1168,7 +1168,7 @@ class TestUpserterIQL:
             Column("value", Boolean, nullable=True),
         )
         engine = await sqlalchemy_engines(data, table)
-        upserter = UpserterIQL(engine=engine, sleep_core=0.1)
+        upserter = Upserter(engine=engine, sleep_core=0.1)
         pairs = [(id_, init) for id_, init, _ in triples]
 
         async def sleep_then_put() -> None:
@@ -1187,9 +1187,9 @@ class TestUpserterIQL:
     @given(data=data())
     async def test_error(self, *, data: DataObject) -> None:
         engine = await sqlalchemy_engines(data)
-        upserter = UpserterIQL(engine=engine)
-        with raises(UpserterIQLError, match="Error running 'UpserterIQL'"):
-            raise UpserterIQLError(upserter=upserter)
+        upserter = Upserter(engine=engine)
+        with raises(UpserterError, match="Error running 'Upserter'"):
+            raise UpserterError(upserter=upserter)
 
 
 class TestUpsertItems:

{dycw_utilities-0.119.0 → dycw_utilities-0.121.0}/src/utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.119.0"
+__version__ = "0.121.0"

{dycw_utilities-0.119.0 → dycw_utilities-0.121.0}/src/utilities/asyncio.py

@@ -26,7 +26,6 @@ from typing import (
     TYPE_CHECKING,
     Any,
     Generic,
-    Literal,
     NoReturn,
     TextIO,
     TypeVar,
@@ -49,6 +48,7 @@ from utilities.reprlib import get_repr
 from utilities.sentinel import Sentinel, sentinel
 from utilities.types import (
     Coroutine1,
+    DurationOrEveryDuration,
     MaybeCallableEvent,
     MaybeType,
     THashable,
@@ -121,17 +121,14 @@ class EnhancedTaskGroup(TaskGroup):
 ##
 
 
-type _DurationOrEvery = Duration | tuple[Literal["every"], Duration]
-
-
 @dataclass(kw_only=True, unsafe_hash=True)
 class InfiniteLooper(ABC, Generic[THashable]):
     """An infinite loop which can throw exceptions by setting events."""
 
-    sleep_core: _DurationOrEvery = SECOND
-    sleep_restart: _DurationOrEvery = MINUTE
+    sleep_core: DurationOrEveryDuration = SECOND
+    sleep_restart: DurationOrEveryDuration = MINUTE
     logger: str | None = None
-    _events: Mapping[THashable, Event] = field(
+    _events: Mapping[THashable | None, Event] = field(
         default_factory=dict, init=False, repr=False, hash=False
     )
 
@@ -229,7 +226,7 @@ class InfiniteLooper(ABC, Generic[THashable]):
             msgs.append(f"Sleeping {self._sleep_restart_desc}...")
             getLogger(name=self.logger).error("\n".join(msgs))
 
-    def _raise_error(self, event: THashable, /) -> NoReturn:
+    def _raise_error(self, event: THashable | None, /) -> NoReturn:
         """Raise the error corresponding to given event."""
         mapping = dict(self._yield_events_and_exceptions())
         error = mapping.get(event, InfiniteLooperError)
@@ -241,7 +238,7 @@ class InfiniteLooper(ABC, Generic[THashable]):
             event: Event() for event, _ in self._yield_events_and_exceptions()
         }
 
-    async def _run_sleep(self, sleep: _DurationOrEvery, /) -> None:
+    async def _run_sleep(self, sleep: DurationOrEveryDuration, /) -> None:
         """Sleep until the next part of the loop."""
         match sleep:
             case int() | float() | dt.timedelta() as duration:
@@ -264,12 +261,12 @@ class InfiniteLooper(ABC, Generic[THashable]):
             case _ as never:
                 assert_never(never)
 
-    def _set_event(self, event: THashable, /) -> None:
+    def _set_event(self, *, event: THashable | None = None) -> None:
         """Set the given event."""
         try:
             event_obj = self._events[event]
         except KeyError:
-            raise InfiniteLooperError(looper=self, event=event) from None
+            raise _InfiniteLooperNoSuchEventError(looper=self, event=event) from None
         event_obj.set()
 
     def _yield_coroutines(self) -> Iterator[Callable[[], Coroutine1[None]]]:
@@ -278,14 +275,18 @@ class InfiniteLooper(ABC, Generic[THashable]):
 
     def _yield_events_and_exceptions(
         self,
-    ) -> Iterator[tuple[THashable, MaybeType[BaseException]]]:
+    ) -> Iterator[tuple[THashable | None, MaybeType[BaseException]]]:
         """Yield the events & exceptions."""
-        yield from []
+        yield (None, _InfiniteLooperDefaultEventError)
 
 
 @dataclass(kw_only=True, slots=True)
 class InfiniteLooperError(Exception):
     looper: InfiniteLooper[Any]
+
+
+@dataclass(kw_only=True, slots=True)
+class _InfiniteLooperNoSuchEventError(InfiniteLooperError):
     event: Hashable
 
     @override
@@ -293,6 +294,13 @@ class InfiniteLooperError(Exception):
         return f"{get_class_name(self.looper)!r} does not have an event {self.event!r}"
 
 
+@dataclass(kw_only=True, slots=True)
+class _InfiniteLooperDefaultEventError(InfiniteLooperError):
+    @override
+    def __str__(self) -> str:
+        return f"{get_class_name(self.looper)!r} default event error"
+
+
 ##
 
 

{dycw_utilities-0.119.0 → dycw_utilities-0.121.0}/src/utilities/redis.py

@@ -589,7 +589,7 @@ async def publish(
 
 
 @dataclass(kw_only=True)
-class PublisherIQL(InfiniteQueueLooper[None, tuple[str, EncodableT]]):
+class Publisher(InfiniteQueueLooper[None, tuple[str, EncodableT]]):
     """Publish a set of messages to Redis."""
 
     redis: Redis
@@ -612,12 +612,12 @@ class PublisherIQL(InfiniteQueueLooper[None, tuple[str, EncodableT]]):
     def _yield_events_and_exceptions(
         self,
     ) -> Iterator[tuple[None, MaybeType[BaseException]]]:
-        yield (None, PublisherIQLError)  # skipif-ci-and-not-linux
+        yield (None, PublisherError)  # skipif-ci-and-not-linux
 
 
 @dataclass(kw_only=True)
-class PublisherIQLError(Exception):
-    publisher: PublisherIQL
+class PublisherError(Exception):
+    publisher: Publisher
 
     @override
     def __str__(self) -> str:
@@ -812,8 +812,8 @@ _ = _TestRedis
 
 
 __all__ = [
-    "PublisherIQL",
-    "PublisherIQLError",
+    "Publisher",
+    "PublisherError",
     "RedisHashMapKey",
     "RedisKey",
     "publish",

{dycw_utilities-0.119.0 → dycw_utilities-0.121.0}/src/utilities/slack_sdk.py

@@ -35,7 +35,7 @@ async def _send_adapter(url: str, text: str, /) -> None:
 
 
 @dataclass(init=False, unsafe_hash=True)
-class SlackHandlerIQL(Handler, InfiniteQueueLooper[None, str]):
+class SlackHandler(Handler, InfiniteQueueLooper[None, str]):
     """Handler for sending messages to Slack."""
 
     @override
@@ -110,4 +110,4 @@ def _get_client(url: str, /, *, timeout: Duration = _TIMEOUT) -> AsyncWebhookCli
     return AsyncWebhookClient(url, timeout=timeout_use)
 
 
-__all__ = ["SendToSlackError", "SlackHandlerIQL", "send_to_slack"]
+__all__ = ["SendToSlackError", "SlackHandler", "send_to_slack"]

{dycw_utilities-0.119.0 → dycw_utilities-0.121.0}/src/utilities/sqlalchemy.py

@@ -609,7 +609,7 @@ class TablenameMixin:
 
 
 @dataclass(kw_only=True)
-class UpserterIQL(InfiniteQueueLooper[None, _InsertItem]):
+class Upserter(InfiniteQueueLooper[None, _InsertItem]):
     """Upsert a set of items to a database."""
 
     engine: AsyncEngine
@@ -641,12 +641,12 @@ class UpserterIQL(InfiniteQueueLooper[None, _InsertItem]):
     def _yield_events_and_exceptions(
         self,
     ) -> Iterator[tuple[None, MaybeType[BaseException]]]:
-        yield (None, UpserterIQLError)
+        yield (None, UpserterError)
 
 
 @dataclass(kw_only=True)
-class UpserterIQLError(Exception):
-    upserter: UpserterIQL
+class UpserterError(Exception):
+    upserter: Upserter
 
     @override
     def __str__(self) -> str:
@@ -1108,8 +1108,8 @@ __all__ = [
     "InsertItemsError",
     "TablenameMixin",
     "UpsertItemsError",
-    "UpserterIQL",
-    "UpserterIQLError",
+    "Upserter",
+    "UpserterError",
     "check_engine",
     "columnwise_max",
     "columnwise_min",

{dycw_utilities-0.119.0 → dycw_utilities-0.121.0}/src/utilities/types.py

@@ -92,6 +92,7 @@ type DateTimeLike = MaybeStr[dt.datetime]
 type DateOrDateTime = dt.date | 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]
@@ -270,6 +271,7 @@ __all__ = [
     "DateTimeLike",
     "Duration",
     "DurationLike",
+    "DurationOrEveryDuration",
     "EnumLike",
     "ExcInfo",
     "IterableHashable",