dycw-utilities 0.174.19__tar.gz → 0.174.20__tar.gz

{dycw_utilities-0.174.19 → dycw_utilities-0.174.20}/PKG-INFO

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

{dycw_utilities-0.174.19 → dycw_utilities-0.174.20}/pyproject.toml

@@ -101,7 +101,7 @@
   name = "dycw-utilities"
   readme = "README.md"
   requires-python = ">= 3.12"
-  version = "0.174.19"
+  version = "0.174.20"
 
   [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.19"
+    current_version = "0.174.20"
 
     [[tool.bumpversion.files]]
       filename = "src/utilities/__init__.py"

{dycw_utilities-0.174.19 → dycw_utilities-0.174.20}/src/utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.174.19"
+__version__ = "0.174.20"

{dycw_utilities-0.174.19 → dycw_utilities-0.174.20}/src/utilities/subprocess.py

@@ -49,6 +49,13 @@ UPDATE_CA_CERTIFICATES: str = "update-ca-certificates"
 ##
 
 
+def apt_install(package: str, /, *, update: bool = False, sudo: bool = False) -> None:
+    """Install a package."""
+    if update:  # pragma: no cover
+        run(*maybe_sudo_cmd(*APT_UPDATE, sudo=sudo))
+    run(*maybe_sudo_cmd(*apt_install_cmd(package), sudo=sudo))
+
+
 def apt_install_cmd(package: str, /) -> list[str]:
     """Command to use 'apt' to install a package."""
     return ["apt", "install", "-y", package]
@@ -250,7 +257,7 @@ def git_clone(
     rm(path, sudo=sudo)
     run(*maybe_sudo_cmd(*git_clone_cmd(url, path), sudo=sudo))
     if branch is not None:
-        run(*maybe_sudo_cmd(*git_hard_reset_cmd(branch=branch), sudo=sudo), cwd=path)
+        git_checkout(branch, path)
 
 
 def git_clone_cmd(url: str, path: PathLike, /) -> list[str]:
@@ -261,15 +268,6 @@ def git_clone_cmd(url: str, path: PathLike, /) -> list[str]:
 ##
 
 
-def git_hard_reset_cmd(*, branch: str | None = None) -> list[str]:
-    """Command to use 'git hard-reset' to hard reset a repository."""
-    branch_use = "master" if branch is None else branch
-    return ["git", "hard-reset", branch_use]
-
-
-##
-
-
 def maybe_parent(path: PathLike, /, *, parent: bool = False) -> Path:
     """Get the parent of a path, if required."""
     path = Path(path)
@@ -1207,6 +1205,7 @@ __all__ = [
     "RsyncCmdError",
     "RsyncCmdNoSourcesError",
     "RsyncCmdSourcesNotFoundError",
+    "apt_install",
     "apt_install_cmd",
     "cd_cmd",
     "chmod",
@@ -1222,7 +1221,6 @@ __all__ = [
     "git_checkout_cmd",
     "git_clone",
     "git_clone_cmd",
-    "git_hard_reset_cmd",
     "maybe_parent",
     "maybe_sudo_cmd",
     "mkdir",