Fondamentaux de pip et gestion des interpréteurs

Chaque interpréteur Python possède sa propre instance de pip. Pour exécuter des commandes pip depuis l'invite de commandes (CMD) ou le terminal de votre IDE, le répertoire contenant l'exécutable doit être inclus dans la variable d'environnement PATH du système.

Identification et chemins d'accès

Pour vérifier la version et l'emplacement d'une instance spécifique, utilisez l'option -V :

pip3.9 -V

Le répertoire de cache par défaut pour les paquets téléchargés se trouve généralement à l'emplacement suivant sur Windows :

C:\Users\<Nom_Utilisateur>\AppData\Local\pip\cache

Gestion de plusieurs interpréteurs

Lorsque plusieurs versions de Python coexistent sur une même machine, il est crucial de les différencier pour éviter les conflits de paquets. Une approche efficace consiste à renommer les exécutables et les dossiers :

• Pour Python 3.10, nommez le dossier python310 et renommez pip.exe dans le dossier Scripts en pip310.exe.
• Pour Python 3.11, utilisez python311 et pip311.exe.

Ainsi, l'installation de modules via pip310 ou pip311 ciblera exclusivement l'intrepréteur corerspondant.

Lors de l'exécution d'une commande, le système d'exploitation recherche l'exécutable dans l'ordre suivant : le répertoire courant, puis la variable PATH utilisateur, et enfin la variable PATH système. Si l'exécutable n'est pas trouvé, une erreur est levée.

Configuration des miroirs (sources alternatives)

Par défaut, pip télécharge les paquets depuis le dépôt officiel PyPI (https://pypi.org/simple). Selon votre localisation géographique, cette opération peut être lente. L'utilisation de miroirs locaux ou régionaux accélère considérablement les installations dans le dossier site-packages.

Utilisation temopraire d'un miroir

Vous pouvez spécifier un miroir pour une installation unique en utilisant le paramètre -i. Voici quelques exemples avec des paquets courants :

# Miroir Tsinghua
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

# Miroir Alibaba
pip install numpy -i https://mirrors.aliyun.com/pypi/simple/

# Miroir Tencent
pip install pandas -i http://mirrors.cloud.tencent.com/pypi/simple

# Miroir Douban
pip install flask -i http://pypi.douban.com/simple/

Note : Certains miroirs peuvent ne pas synchroniser immédiatement les toutes dernières versions des paquets.

Configuration permanente via fichiers

Pour appliquer un miroir de manière persistante, vous devez modifier le fichier de configuration de pip.

Sous Windows

1. Ouvrez l'explorateur de fichiers et saisissez %APPDATA% dans la barre d'adresse pour accéder à C:\Users\<Utilisateur>\AppData\Roaming.
2. Créez un dossier nommé pip s'il n'existe pas.
3. À l'intérieur, créez un fichier texte et nommez-le pip.ini.
4. Ajoutez la configuration suivante :

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn

Sous macOS et Linux

1. Ouvrez un terminal et créez le répertoire caché : mkdir -p ~/.pip
2. Créez ou modifiez le fichier de configuration : touch ~/.pip/pip.conf
3. Insérez le même contenu que pour Windows dans pip.conf.

Configuration permanente via CLI

Depuis les versions récentes de pip, il est possible de configurer les miroirs directement via la ligne de commande, ce qui modifie automatiquement les fichiers de configuration appropriés.

Commencez par mettre à jour pip :

python -m pip install --upgrade pip

Ensuite, définissez le miroir global :

# Configuration du miroir Tsinghua
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# Configuration du miroir Alibaba
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

# Pour rétablir le dépôt officiel par défaut
pip config unset global.index-url