pyenv-win/pyenv-win
Pyenv Win
pyenv-win is a version manager for Windows that enables the installation and switching of multiple Python versions without affecting the system global installation. It functions as a multi-version installer and environment controller that ensures isolation and reproducibility across different projects.
The tool uses a shim-based routing system to intercept executable calls and direct them to specific versioned binaries. This allows for both system-wide default configurations and local directory-level overrides, where a specific version is automatically activated when entering a project folder.
Its capabilities cover the full lifecycle of Python runtime administration, including remote version discovery, installation, and removal. It also includes utilities for refreshing executable mappings and updating the version manager itself.
Features
- Command Interception Shims - Intercepts Python executable calls via shims to route commands to the selected version based on environment settings.
- Python Version Managers - Provides a tool for managing and switching between multiple Python interpreter versions on Windows.
- Development Environment Setups - Configures specific Python versions for individual project folders to ensure environment consistency.
- Local Overrides - Provides local configuration files to override global Python version settings for specific project folders.
- Runtime Version Switching - Toggles the active Python version globally, for a specific session, or within a local directory.
- Multi-Version Installations - Downloads and installs multiple Python language versions using a single command.
- Python Runtime Managers - Provides administration tools for installing, removing, and updating multiple Python releases on Windows.
- Directory-Based Version Resolution - Resolves the active Python version by prioritizing local directory configuration files over global system settings.
- Isolated Runtime Directories - Stores multiple Python installations in separate directories to prevent binary conflicts on Windows.
- Shim Regeneration - Rebuilds proxy executables after installing new Python versions to ensure the CLI routes to the correct binaries.
- Shim Mapping Updates - Updates the internal mapping of executables to ensure correct Python versions are called after changes.
- Remote Version Discovery - Fetches remote lists of available Python releases to identify valid versions for installation.
- Environment and Package Management - Provides Python version management for Windows.
