diff options
author | Dos Moonen <d.moonen@nki.nl> | 2023-02-21 13:53:13 +0100 |
---|---|---|
committer | Dos Moonen <d.moonen@nki.nl> | 2023-02-21 14:02:32 +0100 |
commit | 6affad8032beaafe86a068233f83435e571220bb (patch) | |
tree | cadd8e95bdce160966e24db3ca9b2ece21d1c4fe /docs | |
parent | a840f1d10c3d07470984cc6c061f85dbbf10d0a4 (diff) | |
parent | 5e20a7bddcf05227a0c942367d92ab48b2a8293e (diff) | |
download | pip-6affad8032beaafe86a068233f83435e571220bb.tar.gz |
Merge branch 'main' into keyring-multi-choice
# Conflicts:
# src/pip/_internal/network/auth.py
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 |