Skip to content

arch_pacman

CachyOS pacman package manager backend.

This backend covers official-repository packages only. AUR packages need an AUR helper -- see arch_paru.ArchParuManager.

Notes
  • pacman needs root for anything that writes, so install/update/upgrade/cleanup go through sudo -n. Read-only queries (-Q) do not.

ArchPacmanManager

pacman manager for CachyOS.

Source code in src/personal_os_setup/tasks/managers/arch_pacman.py 
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
class ArchPacmanManager:
    """`pacman` manager for CachyOS."""

    name = "pacman"

    def _pacman(self) -> str | None:
        """Return the path to the `pacman` binary, or `None` if it's not on PATH."""
        return shutil.which("pacman")

    def _run_privileged(self, args: list[str], *, action: str) -> TaskResult:
        """Run a root-requiring pacman subcommand, reporting failures uniformly."""
        pacman = self._pacman()
        if pacman is None:
            return missing_executable_task_result(action, "pacman", _PACMAN_HINT)
        if not sudo_non_interactive_ok():
            return sudo_required_task_result(f"pacman {action}")

        res = run(["sudo", "-n", pacman, *args, "--noconfirm"], check=False)
        if res.returncode == 0:
            return TaskResult(ok=True, summary=f"pacman {action}: done")
        return TaskResult(
            ok=False, summary=f"pacman {action}: failed", details=format_failed_command(res)
        )

    def is_installed(self, package: str) -> bool:
        """Return whether the given package is already installed, via `pacman -Q`."""
        pacman = self._pacman()
        if pacman is None:
            return False
        res = run([pacman, "-Q", package], check=False)
        return res.returncode == 0

    def install(self, package: str) -> InstallResult:
        """Install a package via `pacman -S`."""
        pacman = self._pacman()
        if pacman is None:
            return missing_executable_install_result("pacman", _PACMAN_HINT)
        if not sudo_non_interactive_ok():
            return sudo_required_install_result(package)

        logger.info(f"Installing {package} via pacman...")
        res = run(
            ["sudo", "-n", pacman, "-S", "--needed", "--noconfirm", package],
            check=False,
        )
        if res.returncode == 0:
            return InstallResult(ok=True, summary=f"{package}: installed (pacman)")
        return InstallResult(
            ok=False,
            summary=f"{package}: install failed (pacman)",
            details=format_failed_command(res),
        )

    def update(self) -> TaskResult:
        """Refresh the package database via `pacman -Sy`."""
        return self._run_privileged(["-Sy"], action="sync")

    def upgrade(self) -> TaskResult:
        """Upgrade all official-repo packages via `pacman -Syu`."""
        return self._run_privileged(["-Syu"], action="-Syu")

    def cleanup(self) -> TaskResult:
        """Remove unused packages from the cache via `pacman -Sc`."""
        return self._run_privileged(["-Sc"], action="cache cleanup")

cleanup()

Remove unused packages from the cache via pacman -Sc.

Source code in src/personal_os_setup/tasks/managers/arch_pacman.py 
92
93
94
def cleanup(self) -> TaskResult:
    """Remove unused packages from the cache via `pacman -Sc`."""
    return self._run_privileged(["-Sc"], action="cache cleanup")

install(package)

Install a package via pacman -S.

Source code in src/personal_os_setup/tasks/managers/arch_pacman.py 
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
def install(self, package: str) -> InstallResult:
    """Install a package via `pacman -S`."""
    pacman = self._pacman()
    if pacman is None:
        return missing_executable_install_result("pacman", _PACMAN_HINT)
    if not sudo_non_interactive_ok():
        return sudo_required_install_result(package)

    logger.info(f"Installing {package} via pacman...")
    res = run(
        ["sudo", "-n", pacman, "-S", "--needed", "--noconfirm", package],
        check=False,
    )
    if res.returncode == 0:
        return InstallResult(ok=True, summary=f"{package}: installed (pacman)")
    return InstallResult(
        ok=False,
        summary=f"{package}: install failed (pacman)",
        details=format_failed_command(res),
    )

is_installed(package)

Return whether the given package is already installed, via pacman -Q.

Source code in src/personal_os_setup/tasks/managers/arch_pacman.py 
55
56
57
58
59
60
61
def is_installed(self, package: str) -> bool:
    """Return whether the given package is already installed, via `pacman -Q`."""
    pacman = self._pacman()
    if pacman is None:
        return False
    res = run([pacman, "-Q", package], check=False)
    return res.returncode == 0

update()

Refresh the package database via pacman -Sy.

Source code in src/personal_os_setup/tasks/managers/arch_pacman.py 
84
85
86
def update(self) -> TaskResult:
    """Refresh the package database via `pacman -Sy`."""
    return self._run_privileged(["-Sy"], action="sync")

upgrade()

Upgrade all official-repo packages via pacman -Syu.

Source code in src/personal_os_setup/tasks/managers/arch_pacman.py 
88
89
90
def upgrade(self) -> TaskResult:
    """Upgrade all official-repo packages via `pacman -Syu`."""
    return self._run_privileged(["-Syu"], action="-Syu")