dycw-utilities 0.125.19__tar.gz → 0.125.21__tar.gz

{dycw_utilities-0.125.19 → dycw_utilities-0.125.21}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: dycw-utilities
-Version: 0.125.19
+Version: 0.125.21
 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.30; extra == 'test'
+Requires-Dist: hypothesis<6.132,>=6.131.32; extra == 'test'
 Requires-Dist: pytest-asyncio<1.1,>=1.0.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'
@@ -78,7 +78,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.30; extra == 'zzz-test-hypothesis'
+Requires-Dist: hypothesis<6.132,>=6.131.32; 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.125.19 → dycw_utilities-0.125.21}/pyproject.toml

@@ -25,7 +25,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.30, < 6.132",
+  "hypothesis >= 6.131.32, < 6.132",
   "img2pdf >= 0.6.0, < 0.7",
   "lightweight-charts >= 2.1, < 2.2",
   "loguru >= 0.7.3, < 0.8",
@@ -93,11 +93,11 @@ dependencies = [
 name = "dycw-utilities"
 readme = "README.md"
 requires-python = ">= 3.12"
-version = "0.125.19"
+version = "0.125.21"
 
 [project.optional-dependencies]
 test = [
-  "hypothesis >= 6.131.30, < 6.132",
+  "hypothesis >= 6.131.32, < 6.132",
   "pytest >= 8.3.5, < 8.4",
   "pytest-asyncio >= 1.0.0, < 1.1",
   "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.30, < 6.132",
+  "hypothesis >= 6.131.32, < 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.125.19"
+current_version = "0.125.21"
 
 [[tool.bumpversion.files]]
 filename = "src/utilities/__init__.py"

{dycw_utilities-0.125.19 → dycw_utilities-0.125.21}/src/tests/test_asyncio.py

@@ -42,6 +42,7 @@ from utilities.asyncio import (
     put_items,
     put_items_nowait,
     sleep_dur,
+    sleep_max_dur,
     sleep_until,
     sleep_until_rounded,
     stream_command,
@@ -1428,7 +1429,7 @@ class TestSleepDur:
     async def test_main(self, *, duration: Duration) -> None:
         with Timer() as timer:
             await sleep_dur(duration=duration)
-        assert timer >= datetime_duration_to_timedelta(duration / 2)
+        assert timer <= datetime_duration_to_timedelta(2 * duration)
 
     async def test_none(self) -> None:
         with Timer() as timer:
@@ -1436,6 +1437,20 @@ class TestSleepDur:
         assert timer <= 0.01
 
 
+class TestSleepMaxDur:
+    @given(duration=sampled_from([0.1, 10 * MILLISECOND]))
+    @settings(phases={Phase.generate})
+    async def test_main(self, *, duration: Duration) -> None:
+        with Timer() as timer:
+            await sleep_max_dur(duration=duration)
+        assert timer <= datetime_duration_to_timedelta(2 * duration)
+
+    async def test_none(self) -> None:
+        with Timer() as timer:
+            await sleep_max_dur()
+        assert timer <= 0.01
+
+
 class TestSleepUntil:
     async def test_main(self) -> None:
         await sleep_until(get_now() + 10 * MILLISECOND)

dycw_utilities-0.125.21/src/tests/test_contextlib.py

@@ -0,0 +1,75 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import override
+
+from pytest import raises
+
+from utilities.contextlib import (
+    NoOpContextManager,
+    suppress_super_object_attribute_error,
+)
+
+
+class TestNoOpContextManager:
+    def test_main(self) -> None:
+        with NoOpContextManager():
+            pass
+
+    def test_error(self) -> None:
+        with raises(RuntimeError), NoOpContextManager():
+            raise RuntimeError
+
+
+class TestSuppressSuperObjectAttributeError:
+    def test_main(self) -> None:
+        inits: list[str] = []
+
+        @dataclass(kw_only=True)
+        class A:
+            def __post_init__(self) -> None:
+                with suppress_super_object_attribute_error():
+                    super().__post_init__()  # pyright:ignore [reportAttributeAccessIssue]
+                nonlocal inits
+                inits.append("A")
+
+        @dataclass(kw_only=True)
+        class B: ...
+
+        @dataclass(kw_only=True)
+        class C:
+            def __post_init__(self) -> None:
+                with suppress_super_object_attribute_error():
+                    super().__post_init__()  # pyright:ignore [reportAttributeAccessIssue]
+                nonlocal inits
+                inits.append("C")
+
+        @dataclass(kw_only=True)
+        class D: ...
+
+        @dataclass(kw_only=True)
+        class E(A, B, C, D):
+            @override
+            def __post_init__(self) -> None:
+                super().__post_init__()
+                nonlocal inits
+                inits.append("E")
+
+        _ = E()
+        assert inits == ["C", "A", "E"]
+
+    def test_error(self) -> None:
+        @dataclass(kw_only=True)
+        class Parent:
+            def __post_init__(self) -> None:
+                with suppress_super_object_attribute_error():
+                    _ = self.error  # pyright:ignore [reportAttributeAccessIssue]
+
+        @dataclass(kw_only=True)
+        class Child(Parent):
+            @override
+            def __post_init__(self) -> None:
+                super().__post_init__()
+
+        with raises(AttributeError, match="'Child' object has no attribute 'error'"):
+            _ = Child()

{dycw_utilities-0.125.19 → dycw_utilities-0.125.21}/src/utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.125.19"
+__version__ = "0.125.21"

{dycw_utilities-0.125.19 → dycw_utilities-0.125.21}/src/utilities/asyncio.py

@@ -59,6 +59,7 @@ from utilities.datetime import (
 )
 from utilities.errors import ImpossibleCaseError, repr_error
 from utilities.functions import ensure_int, ensure_not_none, get_class_name
+from utilities.random import SYSTEM_RANDOM
 from utilities.sentinel import Sentinel, sentinel
 from utilities.types import (
     Coroutine1,
@@ -75,6 +76,7 @@ if TYPE_CHECKING:
     from collections import deque
     from collections.abc import AsyncIterator, Sequence
     from contextvars import Context
+    from random import Random
     from types import TracebackType
 
     from utilities.types import Duration
@@ -1305,6 +1307,18 @@ async def sleep_dur(*, duration: Duration | None = None) -> None:
 ##
 
 
+async def sleep_max_dur(
+    *, duration: Duration | None = None, random: Random = SYSTEM_RANDOM
+) -> None:
+    """Sleep which accepts max durations."""
+    if duration is None:
+        return
+    await sleep(random.uniform(0.0, datetime_duration_to_float(duration)))
+
+
+##
+
+
 async def sleep_until(datetime: dt.datetime, /) -> None:
     """Sleep until a given time."""
     await sleep_dur(duration=datetime - get_now())
@@ -1407,6 +1421,7 @@ __all__ = [
     "put_items",
     "put_items_nowait",
     "sleep_dur",
+    "sleep_max_dur",
     "sleep_until",
     "sleep_until_rounded",
     "stream_command",

dycw_utilities-0.125.21/src/utilities/contextlib.py

@@ -0,0 +1,44 @@
+from __future__ import annotations
+
+import re
+from contextlib import contextmanager
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from collections.abc import Iterator
+    from types import TracebackType
+
+
+class NoOpContextManager:
+    """Context-manager for no-op."""
+
+    def __enter__(self) -> None:
+        return None
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        traceback: TracebackType | None,
+    ) -> bool:
+        _ = (exc_type, exc_val, traceback)
+        return False
+
+
+##
+
+
+_SUPER_OBJECT_HAS_NO_ATTRIBUTE = re.compile(r"'super' object has no attribute '\w+'")
+
+
+@contextmanager
+def suppress_super_object_attribute_error() -> Iterator[None]:
+    """Suppress the super() attribute error, for mix-ins."""
+    try:
+        yield
+    except AttributeError as error:
+        if not _SUPER_OBJECT_HAS_NO_ATTRIBUTE.search(error.args[0]):
+            raise
+
+
+__all__ = ["NoOpContextManager", "suppress_super_object_attribute_error"]

{dycw_utilities-0.125.19 → dycw_utilities-0.125.21}/src/utilities/errors.py

@@ -15,6 +15,7 @@ class ImpossibleCaseError(Exception):
     def __str__(self) -> str:
         desc = ", ".join(self.case)
         return f"Case must be possible: {desc}."
+        ##
 
 
 ##

dycw_utilities-0.125.19/src/tests/test_contextlib.py

@@ -1,15 +0,0 @@
-from __future__ import annotations
-
-from pytest import raises
-
-from utilities.contextlib import NoOpContextManager
-
-
-class TestNoOpContextManager:
-    def test_main(self) -> None:
-        with NoOpContextManager():
-            pass
-
-    def test_error(self) -> None:
-        with raises(RuntimeError), NoOpContextManager():
-            raise RuntimeError

dycw_utilities-0.125.19/src/utilities/contextlib.py

@@ -1,23 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING
-
-if TYPE_CHECKING:
-    from types import TracebackType
-
-
-class NoOpContextManager:
-    def __enter__(self) -> None:
-        return None
-
-    def __exit__(
-        self,
-        exc_type: type[BaseException] | None,
-        exc_val: BaseException | None,
-        traceback: TracebackType | None,
-    ) -> bool:
-        _ = (exc_type, exc_val, traceback)
-        return False
-
-
-__all__ = ["NoOpContextManager"]