Project

General

Profile

Actions

Idea #20543

closed

Documentation should stop suggesting `pip install --user`

Added by Brett Smith 9 months ago. Updated 6 months ago.

Status:
Resolved
Priority:
Normal
Assigned To:
Category:
Documentation
Story points:
0.5
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.


Subtasks 1 (0 open1 closed)

Task #20716: Review 20543-pip-install-virtualenvResolvedBrett Smith07/07/2023Actions
Actions #1

Updated by Brett Smith 9 months ago

  • 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.

Actions #2

Updated by Peter Amstutz 8 months ago

  • Target version changed from To be scheduled to Development 2023-07-19 sprint
Actions #3

Updated by Peter Amstutz 8 months ago

  • Assigned To set to Brett Smith
Actions #4

Updated by Brett Smith 8 months ago

  • Status changed from New to In Progress
Actions #5

Updated by Peter Amstutz 8 months ago

  • Target version changed from Development 2023-07-19 sprint to Development 2023-08-02 sprint
Actions #6

Updated by Brett Smith 7 months ago

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.

Actions #7

Updated by Brett Smith 7 months ago

  • Status changed from In Progress to Resolved
Actions #8

Updated by Peter Amstutz 6 months ago

  • Release set to 66
Actions

Also available in: Atom PDF