dycw-utilities 0.174.11__tar.gz → 0.174.12__tar.gz

{dycw_utilities-0.174.11 → dycw_utilities-0.174.12}/PKG-INFO

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

{dycw_utilities-0.174.11 → dycw_utilities-0.174.12}/pyproject.toml

@@ -101,7 +101,7 @@
   name = "dycw-utilities"
   readme = "README.md"
   requires-python = ">= 3.12"
-  version = "0.174.11"
+  version = "0.174.12"
 
   [project.entry-points.pytest11]
     pytest-randomly = "utilities.pytest_plugins.pytest_randomly"
@@ -135,7 +135,7 @@
   # bump-my-version
   [tool.bumpversion]
     allow_dirty = true
-    current_version = "0.174.11"
+    current_version = "0.174.12"
 
     [[tool.bumpversion.files]]
       filename = "src/utilities/__init__.py"

{dycw_utilities-0.174.11 → dycw_utilities-0.174.12}/src/utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.174.11"
+__version__ = "0.174.12"

{dycw_utilities-0.174.11 → dycw_utilities-0.174.12}/src/utilities/permissions.py

@@ -3,7 +3,9 @@ from __future__ import annotations
 from dataclasses import dataclass
 from functools import reduce
 from operator import or_
+from pathlib import Path
 from stat import (
+    S_IMODE,
     S_IRGRP,
     S_IROTH,
     S_IRUSR,
@@ -14,12 +16,15 @@ from stat import (
     S_IXOTH,
     S_IXUSR,
 )
-from typing import Literal, Self, assert_never, override
+from typing import TYPE_CHECKING, Literal, Self, assert_never, override
 
 from utilities.dataclasses import replace_non_sentinel
 from utilities.re import ExtractGroupsError, extract_groups
 from utilities.sentinel import Sentinel, sentinel
 
+if TYPE_CHECKING:
+    from utilities.types import PathLike
+
 type PermissionsLike = Permissions | int | str
 
 
@@ -154,6 +159,10 @@ class Permissions:
             )
         raise PermissionsFromIntError(n=n)
 
+    @classmethod
+    def from_path(cls, path: PathLike, /) -> Self:
+        return cls.from_int(S_IMODE(Path(path).stat().st_mode))
+
     @classmethod
     def from_text(cls, text: str, /) -> Self:
         try: