Idea #20543
closed
Documentation should stop suggesting `pip install --user`
Added by Brett Smith 11 months ago.
Updated 8 months ago.
Release relationship:
Auto
Description
This installation method will fail on distributions that mark themselves as "externally managed" following PEP 668. As I write this that's Debian 12 and Ubuntu 23.04. Others are expected to follow.
The best replacement is probably:
python3 -m venv DIRNAME
DIRNAME/bin/pip install PKGNAME
… and then run the software from DIRNAME/bin
, either explicitly, using $PATH
, a symlink from $PATH
, whatever.
- Story points set to 0.5
- Target version changed from Future to To be scheduled
As I write this the only documentation suggesting this is the README
files for sdk/python
and services/fuse
, which appear on PyPI. It might be worth taking a look at what other polished, user-facing packages are doing, and cribbing from them.
- Target version changed from To be scheduled to Development 2023-07-19 sprint
- Assigned To set to Brett Smith
- Status changed from New to In Progress
- Target version changed from Development 2023-07-19 sprint to Development 2023-08-02 sprint
Note I had to rebase to fix a Git commit message problem, and while I was at it, I went ahead and just squashed everything. 0ea942762 incorporates all the review feedback.
- Status changed from In Progress to Resolved
Also available in: Atom
PDF