Add PIPX_DISABLE_SHARED_LIBS_AUTO_UPGRADE environment variable to disable automatic shared library upgrades #1682
+48
−2
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Fixes #1650
This PR implements the feature requested in #1650 by adding a new environment
variable
PIPX_DISABLE_SHARED_LIBS_AUTO_UPGRADE
that allows users to disableautomatic upgrades of shared libraries (pip, setuptools, wheel).
Motivation
Users who need to maintain compatibility with older Python versions (e.g., Python 3.8)
can encounter errors when pip automatically upgrades to versions that no longer support
their Python version. This environment variable provides a way to disable the automatic
upgrade behavior while still allowing manual upgrades via
pipx upgrade-shared
.Changes Made
PIPX_DISABLE_SHARED_LIBS_AUTO_UPGRADE
constant tosrc/pipx/constants.py
src/pipx/venv.py
to check the environment variable before auto-upgradingdocs/examples.md
explaining the new featuretests/test_shared_libs.py
to verify the behaviorUsage