dycw-utilities 0.125.19__py3-none-any.whl → 0.125.20__py3-none-any.whl

{dycw_utilities-0.125.19.dist-info → dycw_utilities-0.125.20.dist-info}/METADATA

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

{dycw_utilities-0.125.19.dist-info → dycw_utilities-0.125.20.dist-info}/RECORD

@@ -1,6 +1,6 @@
-utilities/__init__.py,sha256=xbWByimnNYAwGR2H45VzrhSnh2lnyKX0gBtEq-G4W3w,61
+utilities/__init__.py,sha256=7jjcydn2HpkHk2ldvyVCqxPJFAZwBb7SiotXzuwh50k,61
 utilities/altair.py,sha256=Gpja-flOo-Db0PIPJLJsgzAlXWoKUjPU1qY-DQ829ek,9156
-utilities/asyncio.py,sha256=D1o5dwq1y17Nk5tzeDyw5vAwxzqdy9WMY5u-uA6NMPw,50716
+utilities/asyncio.py,sha256=pQ5GRcNyBqmDyeAeSarYugrjSNxmX3E0G9pye-kkPt4,51085
 utilities/atomicwrites.py,sha256=geFjn9Pwn-tTrtoGjDDxWli9NqbYfy3gGL6ZBctiqSo,5393
 utilities/atools.py,sha256=IYMuFSFGSKyuQmqD6v5IUtDlz8PPw0Sr87Cub_gRU3M,1168
 utilities/cachetools.py,sha256=C1zqOg7BYz0IfQFK8e3qaDDgEZxDpo47F15RTfJM37Q,2910
@@ -89,7 +89,7 @@ utilities/warnings.py,sha256=un1LvHv70PU-LLv8RxPVmugTzDJkkGXRMZTE2-fTQHw,1771
 utilities/whenever.py,sha256=jS31ZAY5OMxFxLja_Yo5Fidi87Pd-GoVZ7Vi_teqVDA,16743
 utilities/zipfile.py,sha256=24lQc9ATcJxHXBPc_tBDiJk48pWyRrlxO2fIsFxU0A8,699
 utilities/zoneinfo.py,sha256=-5j7IQ9nb7gR43rdgA7ms05im-XuqhAk9EJnQBXxCoQ,1874
-dycw_utilities-0.125.19.dist-info/METADATA,sha256=Ec61c2aoYg19djvl2RrwPPtCXtqIVxSkLTTH6_Fz1o8,12852
-dycw_utilities-0.125.19.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-dycw_utilities-0.125.19.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
-dycw_utilities-0.125.19.dist-info/RECORD,,
+dycw_utilities-0.125.20.dist-info/METADATA,sha256=xMxMTQI22apLwASoFNF6uBV9K2oGR4cBmxYYzv6wzKs,12852
+dycw_utilities-0.125.20.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+dycw_utilities-0.125.20.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
+dycw_utilities-0.125.20.dist-info/RECORD,,

utilities/__init__.py

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

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",