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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dycw-utilities
-Version: 0.125.8
+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.8.dist-info → dycw_utilities-0.125.10.dist-info}/RECORD

@@ -1,4 +1,4 @@
-utilities/__init__.py,sha256=NMu0lmH61a5876HTROVqniekCmmFD7fjHMGBEq4s2LA,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
@@ -46,7 +46,7 @@ utilities/parse.py,sha256=vsZ2jf_ceSI_Kta9titixufysJaVXh0Whjz1T4awJZw,18938
 utilities/pathlib.py,sha256=31WPMXdLIyXgYOMMl_HOI2wlo66MGSE-cgeelk-Lias,1410
 utilities/period.py,sha256=o4wXYEXVlFomop4-Ra4L0yRP4i99NZFjIe_fa7NdZck,11024
 utilities/pickle.py,sha256=Bhvd7cZl-zQKQDFjUerqGuSKlHvnW1K2QXeU5UZibtg,657
-utilities/platform.py,sha256=NU7ycTvAXAG-fdYmDXaM1m4EOml2cGiaYwaUzfzSqyU,1767
+utilities/platform.py,sha256=48IOKx1IC6ZJXWG-b56ZQptITcNFhWRjELW72o2dGTA,2398
 utilities/polars.py,sha256=QlmUpYTqHNkcLnWOQh1TW22W2QyLzvifCvBcbsqhpdE,63272
 utilities/polars_ols.py,sha256=Uc9V5kvlWZ5cU93lKZ-cfAKdVFFw81tqwLW9PxtUvMs,5618
 utilities/pqdm.py,sha256=foRytQybmOQ05pjt5LF7ANyzrIa--4ScDE3T2wd31a4,3118
@@ -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.8.dist-info/METADATA,sha256=TWxcCoaCSvt2oxBQq7vNPceZ3qJb1ba9ODTLakKrhxc,12851
-dycw_utilities-0.125.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-dycw_utilities-0.125.8.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
-dycw_utilities-0.125.8.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.8"
+__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",

utilities/platform.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
+from pathlib import Path
 from platform import system
 from typing import TYPE_CHECKING, Literal, assert_never, override
 
@@ -42,6 +43,32 @@ IS_NOT_MAC = not IS_MAC
 IS_NOT_LINUX = not IS_LINUX
 
 
+##
+
+
+def get_max_pid() -> int | None:
+    """Get the maximum process ID."""
+    match SYSTEM:
+        case "windows":  # pragma: no cover
+            return None
+        case "mac":  # skipif-not-macos
+            return 99999
+        case "linux":  # skipif-not-linux
+            try:
+                with Path("/proc/sys/kernel/pid_max").open() as fh:
+                    return int(fh.read())
+            except FileNotFoundError:  # pragma: no cover
+                return None
+        case _ as never:
+            assert_never(never)
+
+
+MAX_PID = get_max_pid()
+
+
+##
+
+
 def maybe_yield_lower_case(text: Iterable[str], /) -> Iterator[str]:
     """Yield lower-cased text if the platform is case-insentive."""
     match SYSTEM:
@@ -62,9 +89,11 @@ __all__ = [
     "IS_NOT_MAC",
     "IS_NOT_WINDOWS",
     "IS_WINDOWS",
+    "MAX_PID",
     "SYSTEM",
     "GetSystemError",
     "System",
+    "get_max_pid",
     "get_system",
     "maybe_yield_lower_case",
 ]