dycw-utilities 0.174.9__py3-none-any.whl → 0.174.10__py3-none-any.whl

{dycw_utilities-0.174.9.dist-info → dycw_utilities-0.174.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dycw-utilities
-Version: 0.174.9
+Version: 0.174.10
 Author: Derek Wan
 Author-email: Derek Wan <d.wan@icloud.com>
 Requires-Dist: atomicwrites>=1.4.1,<1.5

{dycw_utilities-0.174.9.dist-info → dycw_utilities-0.174.10.dist-info}/RECORD

@@ -1,4 +1,4 @@
-utilities/__init__.py,sha256=s0yfL-qs6UI6ltNUkBKltAzsUuIudzaPhHhfNI2ILBI,60
+utilities/__init__.py,sha256=0CWy0Ep-3LcvfPyRs5NDWEzJToyo7mozx2oLa1j9OoA,61
 utilities/aeventkit.py,sha256=OmDBhYGgbsKrB7cdC5FFpJHUatX9O76eTeKVVTksp2Y,12673
 utilities/altair.py,sha256=rUK99g9x6CYDDfiZrf-aTx5fSRbL1Q8ctgKORowzXHg,9060
 utilities/asyncio.py,sha256=aJySVxBY0gqsIYnoNmH7-1r8djKuf4vSsU69VCD08t8,16772
@@ -47,7 +47,7 @@ utilities/orjson.py,sha256=T_0SlK811ysg46d3orvIPY3JpBa4FRMpP2wlPQo7-gU,41854
 utilities/os.py,sha256=kjKKSQfnRqFTTZ315iavaaGd3gGuYNoSWlxVLCJjyQs,4852
 utilities/parse.py,sha256=g7Qm9eBOIeDId2tGA021CIaeF6jp1TI8rx4srdvlyoo,17937
 utilities/pathlib.py,sha256=EKZn-wWxH7MEWFrQGqHIoB-GJzyXeiEj8iDIgvkr8Wk,9325
-utilities/permissions.py,sha256=PlY95KIon6onivvZt8H1dKlzPXatLdZ5cUPdfwZDfs4,9408
+utilities/permissions.py,sha256=HSVpLef4lfG6GsbeDgYbKRe_92Kk6dNPrB0kw7GsXMY,8093
 utilities/pickle.py,sha256=MBT2xZCsv0pH868IXLGKnlcqNx2IRVKYNpRcqiQQqxw,653
 utilities/platform.py,sha256=0pYO5v7L2sU5UN87zHhEEhTKsZ9NIEM8N6UCr0F7bLY,2778
 utilities/polars.py,sha256=cNFBLWgOMUAp_Sz4xtlto17uZswZRrcfQYC95QKyaY4,87483
@@ -98,7 +98,7 @@ utilities/warnings.py,sha256=un1LvHv70PU-LLv8RxPVmugTzDJkkGXRMZTE2-fTQHw,1771
 utilities/whenever.py,sha256=F4ek0-OBWxHYrZdmoZt76N2RnNyKY5KrEHt7rqO4AQE,60183
 utilities/zipfile.py,sha256=24lQc9ATcJxHXBPc_tBDiJk48pWyRrlxO2fIsFxU0A8,699
 utilities/zoneinfo.py,sha256=tdIScrTB2-B-LH0ukb1HUXKooLknOfJNwHk10MuMYvA,3619
-dycw_utilities-0.174.9.dist-info/WHEEL,sha256=ZyFSCYkV2BrxH6-HRVRg3R9Fo7MALzer9KiPYqNxSbo,79
-dycw_utilities-0.174.9.dist-info/entry_points.txt,sha256=ykGI1ArwOPHqm2g5Cqh3ENdMxEej_a_FcOUov5EM5Oc,155
-dycw_utilities-0.174.9.dist-info/METADATA,sha256=LpxiNDUuPoCbqx1Jb4H4UsVRdjGHNrGyeslCZqKy2AE,1709
-dycw_utilities-0.174.9.dist-info/RECORD,,
+dycw_utilities-0.174.10.dist-info/WHEEL,sha256=ZyFSCYkV2BrxH6-HRVRg3R9Fo7MALzer9KiPYqNxSbo,79
+dycw_utilities-0.174.10.dist-info/entry_points.txt,sha256=ykGI1ArwOPHqm2g5Cqh3ENdMxEej_a_FcOUov5EM5Oc,155
+dycw_utilities-0.174.10.dist-info/METADATA,sha256=xJJPzLScczDipOwF6AP4Tqr8p__BH8NV6WcuwhqZIq0,1710
+dycw_utilities-0.174.10.dist-info/RECORD,,

utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.174.9"
+__version__ = "0.174.10"

utilities/permissions.py

@@ -1,6 +1,5 @@
 from __future__ import annotations
 
-from contextlib import suppress
 from dataclasses import dataclass
 from functools import reduce
 from operator import or_
@@ -18,20 +17,8 @@ from stat import (
 from typing import Literal, Self, override
 
 from utilities.dataclasses import replace_non_sentinel
-from utilities.functions import ensure_member
-from utilities.re import (
-    ExtractGroupError,
-    ExtractGroupsError,
-    extract_group,
-    extract_groups,
-)
+from utilities.re import ExtractGroupsError, extract_groups
 from utilities.sentinel import Sentinel, sentinel
-from utilities.typing import get_args
-
-_MIN_INT = 0o0
-_MAX_INT = 0o777
-type _ZeroToSeven = Literal[0, 1, 2, 3, 4, 5, 6, 7]
-_ZERO_TO_SEVEN: list[_ZeroToSeven] = list(get_args(_ZeroToSeven.__value__))
 
 
 @dataclass(order=True, unsafe_hash=True, kw_only=True, slots=True)
@@ -65,7 +52,7 @@ class Permissions:
 
     def _int(
         self, *, read: bool = False, write: bool = False, execute: bool = False
-    ) -> _ZeroToSeven:
+    ) -> int:
         return (4 if read else 0) + (2 if write else 0) + (1 if execute else 0)
 
     @override
@@ -115,65 +102,32 @@ class Permissions:
 
     @classmethod
     def from_int(cls, n: int, /) -> Self:
-        with suppress(ExtractGroupsError):
-            user, group, others = extract_groups(r"^([0-7])([0-7])([0-7])$", str(n))
-            user_read, user_write, user_execute = cls._from_int(
-                ensure_member(int(user), _ZERO_TO_SEVEN)
-            )
-            group_read, group_write, group_execute = cls._from_int(
-                ensure_member(int(group), _ZERO_TO_SEVEN)
-            )
-            others_read, others_write, others_execute = cls._from_int(
-                ensure_member(int(others), _ZERO_TO_SEVEN)
-            )
-            return cls(
-                user_read=user_read,
-                user_write=user_write,
-                user_execute=user_execute,
-                group_read=group_read,
-                group_write=group_write,
-                group_execute=group_execute,
-                others_read=others_read,
-                others_write=others_write,
-                others_execute=others_execute,
-            )
-        with suppress(ExtractGroupsError):
-            group, others = extract_groups(r"^([0-7])([0-7])$", str(n))
-            group_read, group_write, group_execute = cls._from_int(
-                ensure_member(int(group), _ZERO_TO_SEVEN)
-            )
-            others_read, others_write, others_execute = cls._from_int(
-                ensure_member(int(others), _ZERO_TO_SEVEN)
-            )
-            return cls(
-                group_read=group_read,
-                group_write=group_write,
-                group_execute=group_execute,
-                others_read=others_read,
-                others_write=others_write,
-                others_execute=others_execute,
-            )
-        with suppress(ExtractGroupError):
-            others = extract_group(r"^([0-7])$", str(n))
-            others_read, others_write, others_execute = cls._from_int(
-                ensure_member(int(others), _ZERO_TO_SEVEN)
-            )
-            return cls(
-                others_read=others_read,
-                others_write=others_write,
-                others_execute=others_execute,
-            )
-        if n == 0:
-            return cls()
-        raise PermissionsFromIntError(n=n)
+        if not (0 <= n <= 777):
+            raise PermissionsFromIntRangeError(n=n)
+        user_read, user_write, user_execute = cls._from_int(n, (n // 100) % 10)
+        group_read, group_write, group_execute = cls._from_int(n, (n // 10) % 10)
+        others_read, others_write, others_execute = cls._from_int(n, n % 10)
+        return cls(
+            user_read=user_read,
+            user_write=user_write,
+            user_execute=user_execute,
+            group_read=group_read,
+            group_write=group_write,
+            group_execute=group_execute,
+            others_read=others_read,
+            others_write=others_write,
+            others_execute=others_execute,
+        )
 
     @classmethod
-    def _from_int(cls, n: _ZeroToSeven, /) -> tuple[bool, bool, bool]:
-        return bool(4 & n), bool(2 & n), bool(1 & n)
+    def _from_int(cls, n: int, digit: int, /) -> tuple[bool, bool, bool]:
+        if not (0 <= digit <= 7):
+            raise PermissionsFromIntDigitError(n=n, digit=digit)
+        return bool(4 & digit), bool(2 & digit), bool(1 & digit)
 
     @classmethod
     def from_octal(cls, n: int, /) -> Self:
-        if _MIN_INT <= n <= _MAX_INT:
+        if 0o0 <= n <= 0o777:
             return cls(
                 user_read=bool(n & S_IRUSR),
                 user_write=bool(n & S_IWUSR),
@@ -265,11 +219,23 @@ class PermissionsError(Exception): ...
 class PermissionsFromIntError(PermissionsError):
     n: int
 
+
+@dataclass(kw_only=True, slots=True)
+class PermissionsFromIntRangeError(PermissionsFromIntError):
     @override
     def __str__(self) -> str:
         return f"Invalid integer for permissions; got {self.n}"
 
 
+@dataclass(kw_only=True, slots=True)
+class PermissionsFromIntDigitError(PermissionsFromIntError):
+    digit: int
+
+    @override
+    def __str__(self) -> str:
+        return f"Invalid integer for permissions; got digit {self.digit} in {self.n}"
+
+
 @dataclass(kw_only=True, slots=True)
 class PermissionsFromOctalError(PermissionsError):
     n: int
@@ -291,6 +257,7 @@ class PermissionsFromTextError(PermissionsError):
 __all__ = [
     "Permissions",
     "PermissionsError",
+    "PermissionsFromIntDigitError",
     "PermissionsFromIntError",
     "PermissionsFromOctalError",
     "PermissionsFromTextError",