Project

General

Profile

Actions

Story #20543

open

Documentation should stop suggesting `pip install --user`

Added by Brett Smith 9 days ago. Updated 9 days ago.

Status:
New
Priority:
Normal
Assigned To:
-
Category:
Documentation
Target version:
Start date:
Due date:
% Done:

0%

Estimated time:
Story points:
0.5

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.

Actions #1

Updated by Brett Smith 9 days ago

  • Story points set to 0.5
  • Target version changed from To be groomed 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

Also available in: Atom PDF