Closed giuliop closed 1 month ago
This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs.
Hi @giuliop -- I took a look, and those docs are incorrect now that Homebrew adheres to PEP 668. Time permitting, I'll try and fix those docs in the coming days.
If you want to upgrade pip
, you should do so in either a virtual environment (the venv of whatever project you're developing) or use pyenv
or a similar version manager to install a non-Homebrew-managed version of Python.
I just took another look at the docs, and I think they're actually currently correct. Specifically, they say this:
Starting with Python@3.12, the bundled Python packages should be updated by reinstalling brewed Python. For older Python formulae, they can be updated as described below.
In other words, don't support pip install --upgrade pip
starting with Python 3.12, but earlier versions should still work. However, we can probably make that notice more prominent/visible.
https://github.com/Homebrew/brew/pull/17922 should further clarify the docs here.
I just took another look at the docs, and I think they're actually currently correct. Specifically, they say this:
Starting with Python@3.12, the bundled Python packages should be updated by reinstalling brewed Python. For older Python formulae, they can be updated as described below.
In other words, don't support
pip install --upgrade pip
starting with Python 3.12, but earlier versions should still work. However, we can probably make that notice more prominent/visible.
Indeed, re-reading the docs now they do appear correct to me too
brew doctor
outputVerification
brew doctor
output" above saysYour system is ready to brew.
and am still able to reproduce my issue.brew update
twice and am still able to reproduce my issue.brew install wget
. If they do, open an issue at https://github.com/Homebrew/homebrew-core/issues/new/choose instead.brew config
outputWhat were you trying to do (and why)?
I was trying to update pip as per the instructions in the docs. The instructions say to use:
python3 -m pip install --upgrade pip
What happened (include all command output)?
What did you expect to happen?
I was expecting pip to update.
According to the docs, that output should be expected for non-brew-packaged Python package but not for pip.
Either there is a bug or the documentation is wrong
Step-by-step reproduction instructions (by running
brew
commands)