The choco module manages packages on Windows using the Chocolatey package manager.
Functions packages Install, remove, or update Chocolatey packages.
from pyinfra.operations import choco choco.packages( name = "Install development tools" , packages = [ "git" , "vscode" ], )
List of packages to ensure.
Whether the packages should be installed.
Whether to upgrade packages without a specified version.
Package versions can be pinned like gem: <pkg>:<version>
Example from pyinfra.operations import choco # Note: Assumes that 'choco' is installed and # user has Administrator permission. choco.packages( name = "Install Notepad++" , packages = [ "notepadplusplus" ], )
install Install Chocolatey package manager.
from pyinfra.operations import choco choco.install( name = "Install Chocolatey" , )
This operation is not idempotent - it will always execute.
Requires Administrator permissions to install Chocolatey.
Common Use Cases Install Chocolatey and Packages from pyinfra.operations import choco # Install Chocolatey choco.install( name = "Install Chocolatey package manager" , ) # Install packages choco.packages( name = "Install essential tools" , packages = [ "git" , "vscode" , "googlechrome" , "7zip" , ], )
Development Environment from pyinfra.operations import choco choco.packages( name = "Install development tools" , packages = [ "git" , "nodejs" , "python" , "vscode" , "postman" , "docker-desktop" , ], )
Web Server Setup from pyinfra.operations import choco choco.packages( name = "Install web server components" , packages = [ "nginx" , "php" , "mysql" , ], )
Install with Specific Versions from pyinfra.operations import choco choco.packages( name = "Install specific versions" , packages = [ "python:3.11.0" , "nodejs:18.16.0" , ], )
System Utilities from pyinfra.operations import choco choco.packages( name = "Install system utilities" , packages = [ "7zip" , "notepadplusplus" , "googlechrome" , "firefox" , "vlc" , "windirstat" , ], )
Update All Packages from pyinfra.operations import choco choco.packages( name = "Update all packages to latest" , packages = [ "all" ], latest = True , )
Chocolatey-Specific Tips
Administrator Permissions Required
Most Chocolatey operations require Administrator privileges. Ensure pyinfra is running with elevated permissions: # Run PowerShell as Administrator or use: # pyinfra @winrm/administrator:password@hostname deploy.py
Checking Installed Packages
List all installed Chocolatey packages: from pyinfra.operations import server server.shell( name = "List installed packages" , commands = [ "choco list --local-only" ], )
Search the Chocolatey repository: from pyinfra.operations import server server.shell( name = "Search for packages" , commands = [ "choco search nodejs" ], )
Add custom package sources: from pyinfra.operations import server server.shell( name = "Add custom source" , commands = [ 'choco source add -n="MySource" -s="https://mypackages.com/chocolatey"' , ], )
Pass additional options to Chocolatey: from pyinfra.operations import server # Install with parameters server.shell( name = "Install with custom options" , commands = [ 'choco install nodejs -y --version=18.16.0 --params="/InstallDir:C: \\ NodeJS"' , ], )
Important Notes Chocolatey requires PowerShell and .NET Framework to be installed on the target Windows system.
All choco commands in pyinfra automatically include the -y flag for non-interactive installations.
For Windows Server management, consider using pyinfra @winrm connection method for remote deployments.
