Travailler sur plusieurs projets Python peut vite devenir un casse-tête lorsque chaque projet requiert une version différente du langage. Gérer ces versions efficacement est donc essentiel pour éviter les conflits et assurer la compatibilité des dépendances. Pyenv permet d’installer, basculer et gérer facilement ces versions sans interférer avec la version système.
Installation de Pyenv
Sous macOS & Linux
Le plus simple est d’utiliser le gestionnaire de paquets Homebrew pour installer Pyenv :
brew update
brew install pyenvSous Windows
Utilisez WSL et suivez les mêmes étapes que sous Linux. WSL permet d’exécuter un environnement Linux sous Windows, offrant une compatibilité optimale avec les outils Unix comme Pyenv et facilitant la gestion des dépendances.
A noter qu’il existe un fork spécifique pour Windows : Pyenv-win
Gérer les versions Python avec Pyenv
Pyenv offre des commandes simples pour installer, lister et supprimer différentes versions selon les besoins :
| Installer une version | pyenv install 3.10 |
| Afficher les versions disponibles | pyenv versions |
| Supprimer une version | pyenv uninstall 3.10.4 |
Basculer entre les versions
Changer de version Python est essentiel lorsque vous travaillez sur plusieurs projets avec des exigences différentes. Pyenv permet de passer rapidement d’une version à l’autre selon le contexte du projet.
| Définir une version globale | pyenv global 3.12 |
| Définir une version locale (par projet) | pyenv local 3.10.4 |
| Changer temporairement de version | pyenv shell 3.9.0 |
Résolution des problèmes courants rencontrés avec Pyenv
Lors de l’utilisation de Pyenv, il est possible de rencontrer divers problèmes liés à l’installation, la configuration ou l’utilisation. Voici les solutions aux erreurs les plus fréquentes pour vous aider à maintenir un environnement de développement stable.
Pyenv non reconnu
Ajoutez Pyenv à votre $PATH dans .bashrc ou .zshrc :
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init - bash)"' >> ~/.bashrcErreur d’installation
Vérifiez les dépendances avec pyenv doctor
Installez les bibliothèques manquantes (zlib, openssl).
Conflits avec Anaconda
Vérifiez que Pyenv est prioritaire dans votre $PATH.
Problèmes de permissions
Assurez-vous que l’utilisateur dispose des droits nécessaires sur les fichiers Pyenv.
Pyenv est un outil incontournable pour gérer les versions de Python de manière fluide et éviter les conflits. Il simplifie le travail des développeurs en adaptant l’environnement de développement aux besoins spécifiques de chaque projet.
