Documentation Index Fetch the complete documentation index at: https://mintlify.com/pyinfra-dev/pyinfra/llms.txt
Use this file to discover all available pages before exploring further.
The pacman module manages packages on Arch Linux systems using the pacman package manager.
Functions packages Install or remove pacman packages.
from pyinfra.operations import pacman pacman.packages( name = "Install development tools" , packages = [ "git" , "vim" ], update = True , )
List of packages to ensure.
Whether the packages should be installed.
Run pacman -Sy before installing packages.
Run pacman -Su before installing packages.
Package versions can be pinned like pacman: <pkg>=<version>
Example from pyinfra.operations import pacman pacman.packages( name = "Install Vim and a plugin" , packages = [ "vim-fugitive" , "vim" ], update = True , )
update Update pacman package database.
from pyinfra.operations import pacman pacman.update( name = "Update package database" , )
This operation is not idempotent - it will always execute.
upgrade Upgrade all pacman packages.
from pyinfra.operations import pacman pacman.upgrade( name = "Upgrade all packages" , )
This operation is not idempotent - it will always execute.
Common Use Cases System Setup from pyinfra.operations import pacman # Update package database pacman.update( name = "Update package database" , ) # Install base packages pacman.packages( name = "Install base development tools" , packages = [ "base-devel" , "git" , "vim" , "wget" , "curl" , ], )
Full System Upgrade from pyinfra.operations import pacman # Update and upgrade pacman.packages( name = "Perform full system upgrade" , packages = [], update = True , upgrade = True , )
Development Environment from pyinfra.operations import pacman # Install development tools pacman.packages( name = "Install development environment" , packages = [ "base-devel" , "git" , "vim" , "tmux" , "python" , "python-pip" , "docker" , "docker-compose" , ], update = True , )
Web Server Setup from pyinfra.operations import pacman # Install web server stack pacman.packages( name = "Install NGINX and certbot" , packages = [ "nginx" , "certbot" , "certbot-nginx" , ], update = True , )
Desktop Environment from pyinfra.operations import pacman # Install Xorg and i3 pacman.packages( name = "Install X server and i3 window manager" , packages = [ "xorg-server" , "xorg-xinit" , "i3-wm" , "i3status" , "dmenu" , "termite" , ], update = True , )
Arch-Specific Tips
Pacman supports package groups which install multiple related packages: from pyinfra.operations import pacman # Install the base-devel group pacman.packages( name = "Install base development tools" , packages = [ "base-devel" ], )
For AUR (Arch User Repository) packages, you’ll need to use a helper like yay or paru: from pyinfra.operations import server # Install AUR helper (yay) server.shell( name = "Install yay AUR helper" , commands = [ "cd /tmp" , "git clone https://aur.archlinux.org/yay.git" , "cd yay" , "makepkg -si --noconfirm" , ], ) # Install AUR packages with yay server.shell( name = "Install AUR packages" , commands = [ "yay -S --noconfirm package-name" ], )
Clean up old packages from cache: from pyinfra.operations import server # Remove all cached packages server.shell( name = "Clean package cache" , commands = [ "pacman -Sc --noconfirm" ], ) # Remove all cached packages and unused sync databases server.shell( name = "Clean all cache" , commands = [ "pacman -Scc --noconfirm" ], )
Remove packages that were installed as dependencies but are no longer needed: from pyinfra.operations import server # Remove orphaned packages server.shell( name = "Remove orphaned packages" , commands = [ "pacman -Rns $(pacman -Qtdq) --noconfirm || true" ], )
Important Notes Always run pacman -Sy (update) before installing packages to ensure you’re installing the latest versions and avoid partial upgrades.
Pacman uses the --noconfirm flag in pyinfra operations to enable non-interactive installations.
