dycw-utilities 0.175.15__py3-none-any.whl → 0.175.16__py3-none-any.whl

{dycw_utilities-0.175.15.dist-info → dycw_utilities-0.175.16.dist-info}/METADATA

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

{dycw_utilities-0.175.15.dist-info → dycw_utilities-0.175.16.dist-info}/RECORD

@@ -1,4 +1,4 @@
-utilities/__init__.py,sha256=uha69lq96VwVWN0nlW9IjESjk42aY0AznvoMolkyS1U,61
+utilities/__init__.py,sha256=T7O3-BYhuabAFjqxaQs9o5WOToPVSLS3TN_UrDKm1-o,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=NrBYeuIfQvsbebP0tY6jDPhK6upagI9aVfe6eLctxiY,42374
+utilities/subprocess.py,sha256=nFPIXVzXomI_Oby8PYF9HNWrsWtcSsCtgFnj_22QYlI,43753
 utilities/tempfile.py,sha256=QyvIdfV4r4YZ0NeNYsg0tCijThLKa7Z32u5Kxy6ZsGo,3619
 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.15.dist-info/WHEEL,sha256=RRVLqVugUmFOqBedBFAmA4bsgFcROUBiSUKlERi0Hcg,79
-dycw_utilities-0.175.15.dist-info/entry_points.txt,sha256=cOGtKeJI0KXLSV7MJ8Dhc2G8jPgDcBDm53MVNJU4ycI,136
-dycw_utilities-0.175.15.dist-info/METADATA,sha256=hEKvIOQ5qtPfWiuWMr6PtGqv2OtWnvBmh1fTxpHvNtU,1443
-dycw_utilities-0.175.15.dist-info/RECORD,,
+dycw_utilities-0.175.16.dist-info/WHEEL,sha256=RRVLqVugUmFOqBedBFAmA4bsgFcROUBiSUKlERi0Hcg,79
+dycw_utilities-0.175.16.dist-info/entry_points.txt,sha256=cOGtKeJI0KXLSV7MJ8Dhc2G8jPgDcBDm53MVNJU4ycI,136
+dycw_utilities-0.175.16.dist-info/METADATA,sha256=I6NeFafea7kKkUKz82clljp9LupC0JkQ0AgxoPvke34,1443
+dycw_utilities-0.175.16.dist-info/RECORD,,

utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.175.15"
+__version__ = "0.175.16"

utilities/subprocess.py

@@ -43,6 +43,7 @@ _HOST_KEY_ALGORITHMS = ["ssh-ed25519"]
 APT_UPDATE = ["apt", "update", "-y"]
 BASH_LC = ["bash", "-lc"]
 BASH_LS = ["bash", "-ls"]
+CHPASSWD = "chpasswd"
 GIT_BRANCH_SHOW_CURRENT = ["git", "branch", "--show-current"]
 KNOWN_HOSTS = Path.home() / ".ssh/known_hosts"
 MKTEMP_DIR_CMD = ["mktemp", "-d"]
@@ -92,9 +93,6 @@ def chmod(path: PathLike, perms: PermissionsLike, /, *, sudo: bool = False) -> N
         Path(path).chmod(int(ensure_perms(perms)))
 
 
-##
-
-
 def chmod_cmd(path: PathLike, perms: PermissionsLike, /) -> list[str]:
     """Command to use 'chmod' to change file mode."""
     return ["chmod", str(ensure_perms(perms)), str(path)]
@@ -134,9 +132,6 @@ def chown(
                 assert_never(never)
 
 
-##
-
-
 def chown_cmd(
     path: PathLike, /, *, user: str | int | None = None, group: str | int | None = None
 ) -> list[str]:
@@ -165,6 +160,16 @@ class ChownCmdError(Exception):
 ##
 
 
+def chpasswd(user_name: str, password: str, /, *, sudo: bool = False) -> None:
+    """Update passwords."""
+    run(  # pragma: no cover
+        *maybe_sudo_cmd(CHPASSWD, sudo=sudo), input=f"{user_name}:{password}"
+    )
+
+
+##
+
+
 def cp(
     src: PathLike,
     dest: PathLike,
@@ -1288,12 +1293,54 @@ def touch_cmd(path: PathLike, /) -> list[str]:
 
 
 def update_ca_certificates(*, sudo: bool = False) -> None:
+    """Update the system CA certificates."""
     run(*maybe_sudo_cmd(UPDATE_CA_CERTIFICATES, sudo=sudo))  # pragma: no cover
 
 
 ##
 
 
+def useradd(
+    login: str,
+    /,
+    *,
+    create_home: bool = True,
+    groups: MaybeIterable[str] | None = None,
+    shell: PathLike | None = None,
+    sudo: bool = False,
+    password: str | None = None,
+) -> None:
+    """Create a new user."""
+    args = maybe_sudo_cmd(  # pragma: no cover
+        *useradd_cmd(login, create_home=create_home, groups=groups, shell=shell)
+    )
+    run(*args)  # pragma: no cover
+    if password is not None:  # pragma: no cover
+        chpasswd(login, password, sudo=sudo)
+
+
+def useradd_cmd(
+    login: str,
+    /,
+    *,
+    create_home: bool = True,
+    groups: MaybeIterable[str] | None = None,
+    shell: PathLike | None = None,
+) -> list[str]:
+    """Command to use 'useradd' to create a new user."""
+    args: list[str] = ["useradd"]
+    if create_home:
+        args.append("--create-home")
+    if groups is not None:
+        args.extend(["--groups", *always_iterable(groups)])
+    if shell is not None:
+        args.extend(["--shell", str(shell)])
+    return [*args, login]
+
+
+##
+
+
 @overload
 def uv_run(
     module: str,
@@ -1456,6 +1503,7 @@ __all__ = [
     "APT_UPDATE",
     "BASH_LC",
     "BASH_LS",
+    "CHPASSWD",
     "GIT_BRANCH_SHOW_CURRENT",
     "MKTEMP_DIR_CMD",
     "RESTART_SSHD",
@@ -1473,6 +1521,7 @@ __all__ = [
     "chmod_cmd",
     "chown",
     "chown_cmd",
+    "chpasswd",
     "cp",
     "cp_cmd",
     "echo_cmd",
@@ -1514,6 +1563,8 @@ __all__ = [
     "touch",
     "touch_cmd",
     "update_ca_certificates",
+    "useradd",
+    "useradd_cmd",
     "uv_run",
     "uv_run_cmd",
     "yield_git_repo",