diff options
author | Tzu-ping Chung <uranusjr@gmail.com> | 2023-02-01 01:40:09 +0800 |
---|---|---|
committer | GitHub <noreply@github.com> | 2023-02-01 01:40:09 +0800 |
commit | 56e5fa3c0fd0544e7b5b9b89d9d7854b82d51242 (patch) | |
tree | 8c086e520bd0e49fdcf2a4774d941d98d7a987b4 /docs | |
parent | 2c09e9c760e67fd801b3e756357de3b3c82cd08d (diff) | |
parent | 8d34a1111d7da062e774385990e72c6bb890b299 (diff) | |
download | pip-56e5fa3c0fd0544e7b5b9b89d9d7854b82d51242.tar.gz |
Merge pull request #11487 from pelson/feature/base-prefix-config
Diffstat (limited to 'docs')
-rw-r--r-- | docs/html/topics/configuration.md | 21 |
1 files changed, 16 insertions, 5 deletions
diff --git a/docs/html/topics/configuration.md b/docs/html/topics/configuration.md index e4aafcd2b..521bc9af4 100644 --- a/docs/html/topics/configuration.md +++ b/docs/html/topics/configuration.md @@ -19,13 +19,14 @@ and how they are related to pip's various command line options. ## Configuration Files -Configuration files can change the default values for command line option. -They are written using a standard INI style configuration files. +Configuration files can change the default values for command line options. +They are written using standard INI style configuration files. -pip has 3 "levels" of configuration files: +pip has 4 "levels" of configuration files: -- `global`: system-wide configuration file, shared across users. -- `user`: per-user configuration file. +- `global`: system-wide configuration file, shared across all users. +- `user`: per-user configuration file, shared across all environments. +- `base` : per-base environment configuration file, shared across all virtualenvs with the same base. (available since pip 23.0) - `site`: per-environment configuration file; i.e. per-virtualenv. ### Location @@ -47,6 +48,9 @@ User The legacy "per-user" configuration file is also loaded, if it exists: {file}`$HOME/.pip/pip.conf`. +Base +: {file}`\{sys.base_prefix\}/pip.conf` + Site : {file}`$VIRTUAL_ENV/pip.conf` ``` @@ -63,6 +67,9 @@ User The legacy "per-user" configuration file is also loaded, if it exists: {file}`$HOME/.pip/pip.conf`. +Base +: {file}`\{sys.base_prefix\}/pip.conf` + Site : {file}`$VIRTUAL_ENV/pip.conf` ``` @@ -81,6 +88,9 @@ User The legacy "per-user" configuration file is also loaded, if it exists: {file}`%HOME%\\pip\\pip.ini` +Base +: {file}`\{sys.base_prefix\}\\pip.ini` + Site : {file}`%VIRTUAL_ENV%\\pip.ini` ``` @@ -102,6 +112,7 @@ order: - `PIP_CONFIG_FILE`, if given. - Global - User +- Base - Site Each file read overrides any values read from previous files, so if the |