Gérer plusieurs versions de Python avec pyenv

«System Python» est le Python qui est installé sur votre système d'exploitation. Si vous êtes sur Mac ou Linux, alors par défaut, lorsque vous tapezpython dans votre terminal, vous obtenez une belle REPL Python.

Alors pourquoi ne pas l'utiliser? Une façon de voir les choses est que ce Python est vraimentbelongs au système d'exploitation. Après tout, il est venu installé avec le système d'exploitation. Cela se reflète même lorsque vous exécutezwhich:

Ici,python est disponible pour tous les utilisateurs comme en témoigne son emplacement/usr/bin/python. Il y a de fortes chances que ce ne soit pas la version de Python que vous souhaitez non plus:

Pour installer un package dans votre système Python, vous devez exécutersudo pip install. C'est parce que vous installez le package Python globalement, ce qui est un vrai problème si un autre utilisateur vient et souhaite installer une version légèrement plus ancienne du package.

Les problèmes avec plusieurs versions du même package ont tendance à vous envahir et à vous mordre lorsque vous vous y attendez le moins. Un problème courant se présente sous la forme d'un package stable et populaire qui se comporte soudainement de manière incorrecte sur votre système. Après des heures de dépannage et de recherche sur Google, vous constaterez peut-être que vous avez installé la mauvaise version d'une dépendance, et cela gâche votre journée.

Même si votre version Python est installée dans/usr/local/bin/python3, vous n’êtes toujours pas en sécurité. Vous rencontrerez les mêmes autorisations et problèmes de flexibilité que ceux décrits ci-dessus.

De plus, vous n'avez pas vraiment de contrôle sur la version de Python installée sur votre système d'exploitation. Si vous souhaitez utiliser les dernières fonctionnalités de Python et que vous utilisez Ubuntu par exemple, vous risquez de ne pas avoir de chance. Les versions par défaut sont peut-être trop anciennes, ce qui signifie que vous n'aurez qu'à attendre qu'un nouveau système d'exploitation sorte.

Enfin, certains systèmes d'exploitation utilisent réellement le Python packagé pour le fonctionnement. Prenons par exempleyum, qui utilise beaucoup Python pour faire son travail. Si vous installez une nouvelle version de Python et ne faites pas attention à l'installer dans votre espace utilisateur, vous risquez de nuire gravement à votre capacité à utiliser votre système d'exploitation.

Le prochain endroit logique à regarder est les gestionnaires de packages. Les programmes tels queapt,yum,brew ouport sont les options suivantes typiques. Après tout, c'est ainsi que vous installez la plupart des packages sur votre système. Malheureusement, vous rencontrerez certains des mêmes problèmes en utilisant un gestionnaire de packages.

Par défaut, les gestionnaires de packages ont tendance à installer leurs packages dans l'espace système global au lieu de l'espace utilisateur. Encore une fois, ces packages au niveau du système polluent votre environnement de développement et rendent difficile le partage d'un espace de travail avec d'autres.

Encore une fois, vous n'avez toujours pas le contrôle sur la version de Python que vous pouvez installer. Il est vrai que certains référentiels vous offrent une plus grande sélection, mais par défaut, vous regardez quelle version de Python votre fournisseur particulier est à jour un jour donné.

Même si vous installez Python à partir d'un gestionnaire de packages, pensez à ce qui se passerait si vous écrivez un package et souhaitez prendre en charge et tester sur Python 3.4 - 3.7.

Que se passerait-il sur votre système lorsque vous tapezpython3? Comment basculeriez-vous rapidement entre les différentes versions? Vous pouvez certainement le faire, mais c'est fastidieux et sujet à erreur. Peu importe le fait que si vous voulez PyPy, Jython ou Miniconda, vous n’avez probablement pas de chance avec votre gestionnaire de paquets.

Avec ces contraintes à l'esprit, récapitulons les critères qui vous permettraient d'installer et de gérer les versions de Python facilement et de manière flexible:

pyenv vous permet de faire toutes ces choses et plus encore.

pyenv construit Python à partir des sources, ce qui signifie que vous aurez besoin de dépendances de construction pour utiliser réellementpyenv. Les dépendances de génération varient selon la plate-forme. Si vous êtes surUbuntu/Debian et que vous souhaitez installer les dépendances de construction, vous pouvez utiliser ce qui suit:

Cela utiliseApt pour installer toutes les dépendances de construction. Laissez-le fonctionner et vous serez prêt à opter pour les systèmes Debian.

Si vous utilisezFedora/CentOS/RHEL, vous pouvez utiliseryum pour installer vos dépendances de construction:

Cette commande installera toutes les dépendances de construction pour Python en utilisantyum.

Les utilisateurs demacOS peuvent utiliser la commande suivante:

Cette commande s'appuie surHomebrew et installe les quelques dépendances pour les utilisateurs de macOS.

Tip: Lors de l'exécution de Mojave ou version ultérieure (10.14+), vous devrez également installer lesadditional SDK headers:

Merci à Rodrigo Viera pour la mise à jour.

Si vous utilisez à la placeopenSUSE, vous exécuterez la commande suivante:

Encore une fois, cette commande installe toutes les dépendances de build Python pour votre système.

Enfin, pour les utilisateurs deAlpine, vous pouvez utiliser ceci:

Cette commande utiliseapk comme gestionnaire de paquets et installera toutes les dépendances de construction pour Python sur Alpine.

Après avoir installé les dépendances de build, vous êtes prêt à installerpyenv lui-même. Je recommande d'utiliser lespyenv-installer project:

Cela installerapyenv avec quelques plugins utiles:

Note: La commande ci-dessus est identique au téléchargement dupyenv-installer script et à son exécution localement. Donc, si vous souhaitez voir exactement ce que vous exécutez, vous pouvez afficher le fichier vous-même. Sinon, si vous ne voulez vraiment pas exécuter de script, vous pouvez récupérer lesmanual installation instructions.

À la fin de la course, vous devriez voir quelque chose comme ceci:

La sortie sera basée sur votre shell. Mais vous devez suivre les instructions pour ajouterpyenv à votre chemin et pour initialiser la complétion automatique depyenv /pyenv-virtualenv. Une fois que vous avez fait cela, vous devez recharger votre shell:

C'est ça. Vous avez maintenant installépyenv et quatre plugins utiles.

Comme mentionné précédemment,pyenv fonctionne en construisant Python à partir des sources. Chaque version que vous avez installée se trouve bien dans le répertoire racine de votrepyenv:

Toutes vos versions seront situées ici. C'est pratique car la suppression de ces versions est triviale:

Bien sûr,pyenv fournit également une commande pour désinstaller une version particulière de Python:

Maintenant que vous avez installé deux versions différentes de Python, voyons quelques notions de base sur leur utilisation. Tout d'abord, vérifiez les versions de Python dont vous disposez:

Le* indique que la version Python desystem est actuellement active. Vous remarquerez également que cela est défini par un fichier dans votre répertoire racinepyenv. Cela signifie que, par défaut, vous utilisez toujours votre système Python:

Si vous essayez de le confirmer en utilisantwhich, vous verrez ceci:

Cela peut être surprenant, mais c'est ainsi que fonctionnepyenv. pyenv s’insère dans votrePATH et du point de vue de votre OSis l’exécutable qui est appelé. Si vous souhaitez voir le chemin réel, vous pouvez exécuter ce qui suit:

Si, par exemple, vous souhaitez utiliser la version 2.7.15, vous pouvez utiliser la commandeglobal:

Pro Tip: Un excellent moyen de s'assurer que la version de Python que vous venez d'installer fonctionne correctement est d'exécuter la suite de tests intégrée:

Cela lancera de nombreux tests Python internes qui vérifieront votre installation. Vous pouvez simplement vous détendre et regarder les tests passer.

Si vous souhaitez revenir à la version système de Python par défaut, vous pouvez exécuter ceci:

Vous pouvez désormais basculer facilement entre les différentes versions de Python. Ce n'est que le début. Si vous souhaitez basculer entre plusieurs versions, taper ces commandes de manière cohérente est fastidieux. Cette section passe en revue les bases, mais un meilleur flux de travail est décrit dansworking with multiple environments.

Vous avez déjà vu la commandeinstall ci-dessus. Cette commande peut être utilisée pour installer une version spécifique de Python. Par exemple, si vous vouliez installer3.6.8, vous utiliseriez ceci:

La sortie nous montrepyenv en train de télécharger et d'installer Python. Certains des indicateurs communs que vous souhaiterez peut-être utiliser sont les suivants:

La commandeversions affiche toutes les versions de Python actuellement installées:

Cette sortie montre non seulement que2.7.15,3.6.8,3.8-dev et votresystem Python sont installés, mais vous montre également que lesystem Python est actif. Si vous ne vous souciez que de la version active actuelle, vous pouvez utiliser la commande suivante:

Cette commande est similaire àversions mais ne vous montre que la version actuelle de Python active.

La commandewhich est utile pour déterminer le chemin complet vers un exécutable système. Étant donné quepyenv fonctionne à l'aide de shims, cette commande vous permet de voir le chemin complet de l'exécutablepyenv en cours d'exécution. Par exemple, si vous voulez voir oùpip est installé, vous pouvez exécuter ceci:

La sortie affiche le chemin complet du système pourpip. Cela peut être utile lorsque vous avez installé des applications en ligne de commande.

La commandeglobal définit la version globale de Python. Cela peut être remplacé par d'autres commandes, mais est utile pour vous assurer que vous utilisez une version Python particulière par défaut. Si vous souhaitez utiliser3.6.8 par défaut, vous pouvez exécuter ceci:

Cette commande définit les~/.pyenv/version sur3.6.8. Pour plus d'informations, consultez la section sur lesspecifying your Python version.

La commandelocal est souvent utilisée pour définir une version Python spécifique à une application. Vous pouvez l'utiliser pour définir la version sur2.7.15:

Cette commande crée un fichier.python-version dans votre répertoire actuel. Si vous avezpyenv actif dans votre environnement, ce fichier activera automatiquement cette version pour vous.

La commandeshell est utilisée pour définir une version Python spécifique au shell. Par exemple, si vous souhaitez tester la version3.8-dev de Python, vous pouvez le faire:

Cette commande active la version spécifiée en définissant la variable d'environnementPYENV_VERSION. Cette commande remplace toutes les applications ou les paramètres globaux que vous pourriez avoir. Si vous souhaitez désactiver la version, vous pouvez utiliser l'indicateur--unset.

La création d'un environnement virtuel est une commande unique:

Techniquement, le<python_version> est facultatif, mais vous devriez toujours le spécifier pour être sûr de la version de Python que vous utilisez.

Le<environment_name> est juste un nom pour vous aider à garder vos environnements séparés. Une bonne pratique consiste à nommer vos environnements du même nom que votre projet. Par exemple, si vous travailliez surmyproject et que vous vouliez développer avec Python 3.6.8, vous exécuteriez ceci:

La sortie inclut des messages qui montrent quelques paquets Python supplémentaires en cours d'installation, à savoirwheel,pip etsetuptools. Ceci est strictement pour des raisons de commodité et configure simplement un environnement plus complet pour chacun de vos environnements virtuels.

Maintenant que vous avez créé votre environnement virtuel, son utilisation est la prochaine étape. Normalement, vous devez activer vos environnements en exécutant ce qui suit:

Vous avez déjà vu la commandepyenv local, mais cette fois, au lieu de spécifier une version Python, vous spécifiez un environnement. Cela crée un fichier.python-version dans votre répertoire de travail actuel et comme vous avez exécutéeval "$(pyenv virtualenv-init -)" dans votre environnement, l'environnement sera automatiquement activé.

Vous pouvez le vérifier en exécutant ce qui suit:

Vous pouvez voir qu'une nouvelle version a été créée appeléemyproject et que l'exécutable depython pointe vers cette version. Si vous regardez n'importe quel exécutable fourni par cet environnement, vous verrez la même chose. Prenons, par exemple,pip:

Si vous n'avez pas configuréeval "$(pyenv virtualenv-init -)" pour qu'il s'exécute dans votre shell, vous pouvez activer / désactiver manuellement vos versions Python avec ceci:

Ce qui précède est ce que faitpyenv-virtualenv quand il entre ou sort d'un répertoire contenant un fichier.python-version.