dycw-utilities 0.175.27__py3-none-any.whl → 0.175.29__py3-none-any.whl

{dycw_utilities-0.175.27.dist-info → dycw_utilities-0.175.29.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dycw-utilities
-Version: 0.175.27
+Version: 0.175.29
 Summary: Miscellaneous Python utilities
 Author: Derek Wan
 Author-email: Derek Wan <d.wan@icloud.com>

{dycw_utilities-0.175.27.dist-info → dycw_utilities-0.175.29.dist-info}/RECORD

@@ -1,4 +1,4 @@
-utilities/__init__.py,sha256=IhEmMfmycJdR031fNLaK1iuiv3mg9N-cQcLonJln-q4,61
+utilities/__init__.py,sha256=4Vn2mZMxPdI4pPiLLbxz37PzGsyw0oipRMmAdN102Fw,61
 utilities/altair.py,sha256=TLfRFbG9HwG7SLXoJ-v0r-t49ZaGgTQZD82cpjVi4vs,9085
 utilities/asyncio.py,sha256=aJySVxBY0gqsIYnoNmH7-1r8djKuf4vSsU69VCD08t8,16772
 utilities/atomicwrites.py,sha256=tPo6r-Rypd9u99u66B9z86YBPpnLrlHtwox_8Z7T34Y,5790
@@ -80,7 +80,7 @@ utilities/sqlalchemy.py,sha256=HQYpd7LFxdTF5WYVWYtCJeEBI71EJm7ytvCGyAH9B-U,37163
 utilities/sqlalchemy_polars.py,sha256=JCGhB37raSR7fqeWV5dTsciRTMVzIdVT9YSqKT0piT0,13370
 utilities/statsmodels.py,sha256=koyiBHvpMcSiBfh99wFUfSggLNx7cuAw3rwyfAhoKpQ,3410
 utilities/string.py,sha256=shmBK87zZwzGyixuNuXCiUbqzfeZ9xlrFwz6JTaRvDk,582
-utilities/subprocess.py,sha256=RRDh212OgVj07cidE8SgyOvyaRfR9BFKyw48X_sIqhU,51182
+utilities/subprocess.py,sha256=InHiFN318S46vHtqgSPbC0zL2UACjxm4Y9oCLiTXTQo,52937
 utilities/tempfile.py,sha256=a3_M1QyxGZql_VcGkBOQBeWbbkItjgkfIpVyzU1UAic,3843
 utilities/testbook.py,sha256=j1KmaVbrX9VrbeMgtPh5gk55myAsn3dyRUn7jGbPbRk,1294
 utilities/text.py,sha256=7SvwcSR2l_5cOrm1samGnR4C-ZI6qyFLHLzSpO1zeHQ,13958
@@ -97,7 +97,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.175.27.dist-info/WHEEL,sha256=RRVLqVugUmFOqBedBFAmA4bsgFcROUBiSUKlERi0Hcg,79
-dycw_utilities-0.175.27.dist-info/entry_points.txt,sha256=cOGtKeJI0KXLSV7MJ8Dhc2G8jPgDcBDm53MVNJU4ycI,136
-dycw_utilities-0.175.27.dist-info/METADATA,sha256=_bP-SZHDjfjAq8A7eJxwN3gt0WHcfNSeifg3u5JWqUU,1443
-dycw_utilities-0.175.27.dist-info/RECORD,,
+dycw_utilities-0.175.29.dist-info/WHEEL,sha256=RRVLqVugUmFOqBedBFAmA4bsgFcROUBiSUKlERi0Hcg,79
+dycw_utilities-0.175.29.dist-info/entry_points.txt,sha256=cOGtKeJI0KXLSV7MJ8Dhc2G8jPgDcBDm53MVNJU4ycI,136
+dycw_utilities-0.175.29.dist-info/METADATA,sha256=JKE9YzvVLkTKQHdvaHCMrMs2NO1_pRPSxtqh8c5mizY,1443
+dycw_utilities-0.175.29.dist-info/RECORD,,

utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.175.27"
+__version__ = "0.175.29"

utilities/subprocess.py

@@ -146,6 +146,29 @@ def cd_cmd(path: PathLike, /) -> list[str]:
 ##
 
 
+def chattr(
+    path: PathLike, /, *, immutable: bool | None = None, sudo: bool = False
+) -> None:
+    """Change file attributes."""
+    args = maybe_sudo_cmd(  # pragma: no cover
+        *chattr_cmd(path, immutable=immutable), sudo=sudo
+    )
+    run(*args)  # pragma: no cover
+
+
+def chattr_cmd(path: PathLike, /, *, immutable: bool | None = None) -> list[str]:
+    """Command to use 'chattr' to change file attributes."""
+    args: list[str] = ["chattr"]
+    if immutable is True:
+        args.append("+i")
+    elif immutable is False:
+        args.append("-i")
+    return [*args, str(path)]
+
+
+##
+
+
 def chmod(path: PathLike, perms: PermissionsLike, /, *, sudo: bool = False) -> None:
     """Change file mode."""
     if sudo:  # pragma: no cover
@@ -421,8 +444,8 @@ def curl(
     logger: LoggerLike | None = None,
 ) -> str | None:
     """Transfer a URL."""
-    args = maybe_sudo_cmd(
-        *curl_cmd(  # skipif-ci
+    args = maybe_sudo_cmd(  # skipif-ci
+        *curl_cmd(
             url,
             fail=fail,
             location=location,
@@ -542,6 +565,53 @@ def git_clone_cmd(url: str, path: PathLike, /) -> list[str]:
 ##
 
 
+def install(
+    path: PathLike,
+    /,
+    *,
+    directory: bool = False,
+    mode: PermissionsLike | None = None,
+    owner: str | int | None = None,
+    group: str | int | None = None,
+    sudo: bool = False,
+) -> None:
+    """Install a binary."""
+    args = maybe_sudo_cmd(
+        *install_cmd(path, directory=directory, mode=mode, owner=owner, group=group),
+        sudo=sudo,
+    )
+    run(*args)
+
+
+def install_cmd(
+    path: PathLike,
+    /,
+    *,
+    directory: bool = False,
+    mode: PermissionsLike | None = None,
+    owner: str | int | None = None,
+    group: str | int | None = None,
+) -> list[str]:
+    """Command to use 'install' to install a binary."""
+    args: list[str] = ["install"]
+    if directory:
+        args.append("-d")
+    if mode is not None:
+        args.extend(["-m", str(ensure_perms(mode))])
+    if owner is not None:
+        args.extend(["-o", str(owner)])
+    if group is not None:
+        args.extend(["-g", str(group)])
+    if directory:
+        args.append(str(path))
+    else:
+        args.extend(["/dev/null", str(path)])
+    return args
+
+
+##
+
+
 def maybe_parent(path: PathLike, /, *, parent: bool = False) -> Path:
     """Get the parent of a path, if required."""
     path = Path(path)
@@ -1813,6 +1883,8 @@ __all__ = [
     "apt_update",
     "cat",
     "cd_cmd",
+    "chattr",
+    "chattr_cmd",
     "chmod",
     "chmod_cmd",
     "chown",
@@ -1831,6 +1903,8 @@ __all__ = [
     "git_checkout_cmd",
     "git_clone",
     "git_clone_cmd",
+    "install",
+    "install_cmd",
     "maybe_parent",
     "maybe_sudo_cmd",
     "mkdir",