dycw-utilities 0.125.9__py3-none-any.whl → 0.125.10__py3-none-any.whl

{dycw_utilities-0.125.9.dist-info → dycw_utilities-0.125.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dycw-utilities
-Version: 0.125.9
+Version: 0.125.10
 Author-email: Derek Wan <d.wan@icloud.com>
 License-File: LICENSE
 Requires-Python: >=3.12
@@ -174,7 +174,7 @@ Requires-Dist: scipy<1.16,>=1.15.3; extra == 'zzz-test-scipy'
 Provides-Extra: zzz-test-sentinel
 Provides-Extra: zzz-test-shelve
 Provides-Extra: zzz-test-slack-sdk
-Requires-Dist: aiohttp<3.12.1,>=3.12.0; extra == 'zzz-test-slack-sdk'
+Requires-Dist: aiohttp<3.12.3,>=3.12.2; extra == 'zzz-test-slack-sdk'
 Requires-Dist: slack-sdk<3.36,>=3.35.0; extra == 'zzz-test-slack-sdk'
 Provides-Extra: zzz-test-socket
 Provides-Extra: zzz-test-sqlalchemy

{dycw_utilities-0.125.9.dist-info → dycw_utilities-0.125.10.dist-info}/RECORD

@@ -1,4 +1,4 @@
-utilities/__init__.py,sha256=sL0f7a9_XSj0OxG9E_04onbu2cDKar7GrU1t0jU_9So,60
+utilities/__init__.py,sha256=hCotYGEOz7s5mhsPf8wWq526AJNjwEkUazmqfzo-lkU,61
 utilities/altair.py,sha256=Gpja-flOo-Db0PIPJLJsgzAlXWoKUjPU1qY-DQ829ek,9156
 utilities/asyncio.py,sha256=3OVbJKTYCucrIkM7WSMMkQA9jYJFCQMnGNM4H5rBNgA,29154
 utilities/atomicwrites.py,sha256=geFjn9Pwn-tTrtoGjDDxWli9NqbYfy3gGL6ZBctiqSo,5393
@@ -26,7 +26,7 @@ utilities/http.py,sha256=WcahTcKYRtZ04WXQoWt5EGCgFPcyHD3EJdlMfxvDt-0,946
 utilities/hypothesis.py,sha256=a75izXg9aCBhhDkj_ZgK3TDzlzk38evP8TO7JbYYQvg,46264
 utilities/importlib.py,sha256=mV1xT_O_zt_GnZZ36tl3xOmMaN_3jErDWY54fX39F6Y,429
 utilities/ipython.py,sha256=V2oMYHvEKvlNBzxDXdLvKi48oUq2SclRg5xasjaXStw,763
-utilities/iterables.py,sha256=wqq2lKfEAq1qncE-lR848DHX627aerFaq4BXmLen-NE,43589
+utilities/iterables.py,sha256=mDqw2_0MUVp-P8FklgcaVTi2TXduH0MxbhTDzzhSBho,44915
 utilities/jupyter.py,sha256=ft5JA7fBxXKzP-L9W8f2-wbF0QeYc_2uLQNFDVk4Z-M,2917
 utilities/libcst.py,sha256=L0IkwAWXPuNpYyceeJGOC8CAwHdVPRpbXC8MQphCXh4,4954
 utilities/lightweight_charts.py,sha256=0xNfcsrgFI0R9xL25LtSm-W5yhfBI93qQNT6HyaXAhg,2769
@@ -88,7 +88,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.9.dist-info/METADATA,sha256=Lr7FuRGFVTmBQl5RfJRKVA44Nz5TGMHeIKBv4Y4S5eY,12851
-dycw_utilities-0.125.9.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-dycw_utilities-0.125.9.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
-dycw_utilities-0.125.9.dist-info/RECORD,,
+dycw_utilities-0.125.10.dist-info/METADATA,sha256=TOOerRTXo6msfA1IIjYMyh-7-i0CR54HRLZc1GTpZdE,12852
+dycw_utilities-0.125.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+dycw_utilities-0.125.10.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
+dycw_utilities-0.125.10.dist-info/RECORD,,

utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.125.9"
+__version__ = "0.125.10"

utilities/iterables.py

@@ -1190,6 +1190,56 @@ def product_dicts(mapping: Mapping[_K, Iterable[_V]], /) -> Iterator[Mapping[_K,
 ##
 
 
+def range_partitions(stop: int, num: int, total: int, /) -> range:
+    """Partition a range."""
+    if stop <= 0:
+        raise _RangePartitionsStopError(stop=stop)
+    if not (1 <= total <= stop):
+        raise _RangePartitionsTotalError(stop=stop, total=total)
+    if not (0 <= num < total):
+        raise _RangePartitionsNumError(num=num, total=total)
+    q, r = divmod(stop, total)
+    start = num * q + min(num, r)
+    end = start + q + (1 if num < r else 0)
+    return range(start, end)
+
+
+@dataclass(kw_only=True, slots=True)
+class RangePartitionsError(Exception): ...
+
+
+@dataclass(kw_only=True, slots=True)
+class _RangePartitionsStopError(RangePartitionsError):
+    stop: int
+
+    @override
+    def __str__(self) -> str:
+        return f"'stop' must be positive; got {self.stop}"
+
+
+@dataclass(kw_only=True, slots=True)
+class _RangePartitionsTotalError(RangePartitionsError):
+    stop: int
+    total: int
+
+    @override
+    def __str__(self) -> str:
+        return f"'total' must be in [1, {self.stop}]; got {self.total}"
+
+
+@dataclass(kw_only=True, slots=True)
+class _RangePartitionsNumError(RangePartitionsError):
+    num: int
+    total: int
+
+    @override
+    def __str__(self) -> str:
+        return f"'num' must be in [0, {self.total - 1}]; got {self.num}"
+
+
+##
+
+
 @overload
 def reduce_mappings(
     func: Callable[[_V, _V], _V], sequence: Iterable[Mapping[_K, _V]], /
@@ -1458,6 +1508,7 @@ __all__ = [
     "OneUniqueEmptyError",
     "OneUniqueError",
     "OneUniqueNonUniqueError",
+    "RangePartitionsError",
     "ResolveIncludeAndExcludeError",
     "SortIterableError",
     "always_iterable",
@@ -1502,6 +1553,7 @@ __all__ = [
     "one_unique",
     "pairwise_tail",
     "product_dicts",
+    "range_partitions",
     "reduce_mappings",
     "resolve_include_and_exclude",
     "sort_iterable",