Outils pour utilisateurs

Outils du site


issue148:python

Last month, I talked about Python 3.8.0b2 and I suggested that if you wanted to try it, you should consider a virtual environment. I then realized that I hadn't really discussed virtual environments before. So, I'm going to now.

Le mois dernier, j'ai parlé de Python 3.8.0b2 et j'ai suggéré que, si vous vouliez l'essayer, vous pourriez envisager un environnement virtuel. J'ai ensuite réalisé que je n'avais jamais vraiment présenté les environnements virtuels. Aussi, je vais le faire maintenant.

What is a Python Virtual Environment? Basically, it allows you to manage multiple versions of Python (and pip) easily, without messing up any of the packages or configurations that you already have. Why would you have multiple versions of Python? I know my environment is probably somewhat different from your needs, but I have multiple machines, and on each, my “main” version of Python is either 3.6 or 3.7 depending on what I'm doing. For example, I have one instance of Python 3.6 for machine learning programming, one Python 3.7 for “normal” work, one for testing of Python 3.8 beta, and I still have a version of Python 2.7 just-in-case. While it's easy to deal with a version of Python 2.x and a version of 3.x on a single machine, sometimes library versions will conflict, and that can cause programs to stop working.

Qu'est-ce qu'un environnement virtuel en Python ?

En gros, il vous permet de gérer facilement des versions multiples de Python (et de pip), sans semer la pagaille dans les paquets et les configurations que vous avez déjà. Pourquoi auriez-vous plusieurs configurations de Python ? Je sais que mon environnement est probablement quelque peu éloigné de vos besoins, mais j'ai plusieurs machines et, sur chacune, ma version « principale » de Python est, soit la 3.6, soit la 3.7, selon ce que je fais. Par exemple, j'ai une instance de Python 3.6 pour la programmation de l'apprentissage machine, une de Python 3.7 pour le travail « normal », une pour les tests de la bêta de Python 3.8 et j'ai encore une version de Python 2.7 au cas où. Alors qu'il est facile de gérer une version de Python 2.x et une version de Python 3.x sur un seule machine, il arrive qu'il y ait des conflits entre versions de bibliothèques et que ça puisse entraîner l'arrêt des programmes.

What's the solution? I found a project called pyenv that pretty much does everything you need without much pain. You can find it at https://github.com/pyenv/pyenv. I found a great installation guide at https://realpython.com/intro-to-pyenv/. It is this guide that I used to install pyenv on my laptop, and I'll try to distill it down to get you up and running in the least amount of time.

Quelle est la solution ?

J'ai trouvé un projet appelé pyenv qui fait plutôt bien tout ce dont vous avez besoin sans trop de peine. Vous pouvez le trouver sur https://github.com/pyenv/pyenv. J'ai trouvé un magnifique guide d'installation sur : https://realpython.com/intro-to-pyenv/. C'est ce guide que j'ai utilisé pour installer pyenv sur mon portable et j'essaierai de vous en extraire le meilleur pour que vous puissiez vous lancer dans un temps record.

Getting Started I'll limit my instructions to those for a PC using Ubuntu/Linux Mint/Debian or some other similar Linux distribution. If you are on a MAC, or use some other Linux distribution, there are many pieces of helpful information on the two above noted sites, and on others – with a simple web search. There are two ways to install pyenv. There is an easy way and a hard way. I'm going to discuss the easy way. The reason for this is that the easy way not only installs pyenv, but also installs some other pyenv tools that will be helpful – like pyenv-virtualenv, pyenv-update, and more. While you can manually get these installed, this way is so much easier.

Mise en route

Je limiterai mes instructions à celles pour un PC utilisant Ubuntu/Linux Mint/Debian ou d'autres distributions Linux similaires. Si vous êtes sur MAC, ou utilisez une autre distribution Linux, vous trouverez beaucoup d'informations utiles sur les deux sites cités ci-dessus, et sur d'autres, avec une simple recherche sur le Web.

Il y a deux façons d'installer pyenv, une facile, l'autre difficile. Je vais vous présenter la méthode facile. C'est parce que cette méthode facile installe non seulement pyenv, mais aussi d'autres outils de pyenv qui seront utiles, comme pyenv-virtualenv, pyenv-update, et plus. Bien que vous puissiez les installer manuellement, c'est tellement plus facile de cette façon.

The first thing you need to do is install the dependencies. You probably have most of them, but run the install command below just to be safe. Open a terminal and enter… sudo apt-get install -y make build-essential libssl-dev zlib1g-dev libbz2-dev \ libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev \ xz-utils tk-dev libffi-dev liblzma-dev python-openssl git Now you need to make a decision on where you are going to install pyenv. I suggest you put it into the home directory. Change to whatever directory you choose, and enter: $ curl https://pyenv.run | bash

La première chose que vous devez faire est d'installer les dépendances. Vous possédez probablement la plupart d'entre elles, mais lancez la commande d'installation ci-dessous juste pour vous en assurer. Ouvrez un terminal et saisissez :

sudo apt-get install -y make build-essential libssl-dev zlib1g-dev libbz2-dev \

libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev \

xz-utils tk-dev libffi-dev liblzma-dev python-openssl git

Maintenant vous devez décider de l'endroit où vous allez installer pyenv. Je vous suggère de le mettre dans votre répertoire home. Placez-vous dans le répertoire que vous voulez et saisissez :

$ curl https://pyenv.run | bash

This runs the installer for pyenv. Close your terminal and reopen it. This loads any changes to the .bashrc file, or, alternatively, you can enter: $ source ~/.bashrc Next, we need to modify the .bashrc file. If you are using a different version, it might be .bash_profile. In your terminal, type: $ gedit ~/.bashrc and add the following lines (next page, top right) to the bottom of the file. Make sure that the first line defining the PYENV_ROOT points to the correct directory.

Cela lance l'installation de pyenv. Fermez votre terminal et rouvrez-le. Tous les changements sont chargés dans le fichier .bashrc. Ou, à la place, vous pouvez saisir :

$ source ~/.bashrc

Vous avez besoin, ensuite, de modifier le fichier .bashrc. Si vous utilisez une version différente, ce pourrait être .bash_profile. Dans votre terminal, saisissez :

$ gedit ~/.bashrc

et ajoutez les lignes suivantes (page suivante, en haut à droite) en bas du fichier.

Assurez-vous que la première ligne, définissant PYENV_ROOT, pointe sur le bon répertoire.

Save your .bashrc file and reload it. As before, this can be done by either closing and re-opening the terminal, or by simply typing: $ source ~/.bashrc This will cause the .bashrc to reload. Now, just to be complete, run an update on pyenv. $ pyenv update Now we have to install a version of Python. Right now, let's do the latest version of 3.7, which is 3.7.4. Again in your terminal window, type: $ pyenv install –list

Sauvegardez votre fichier .bashrc et rechargez-le. Comme précédemment, cela peut être fait, soit en fermant puis en rouvrant le terminal, soit en tapant simplement :

$ source ~/.bashrc

Cela force le rechargement de .bashrc. Maintenant, juste pour terminer, lancez une mise à jour de pyenv.

$ pyenv update

Nous devons maintenant installer une version de Python. À l'heure actuelle, utilisons la dernière version de la 3.7, qui est la 3.7.4, À nouveau, tapez dans la fenêtre de votre terminal :

$ pyenv install –list

This will list all of the available packages that you can install. It's a VERY long list, with the actual Python versions near the top. You'll also see versions of jython, ironpython, anaconda and anaconda3, activepython, and more. Right now, we can verify that the version text we need to use is “3.7.4”. (In a little bit, we'll also add the latest available version of 3.8.0). To install, type: $ pyenv install 3.7.4 This takes about five minutes on my old laptop, so go get a cup of coffee or tea and come back. Once the install is finished, type: $ pyenv versions You should see something like this… $ pyenv versions system * 3.7.4 (set by /home/greg/.python-version)

Vous obtiendrez ainsi une liste de tous les paquets disponibles que vous pouvez installer. C'est une TRÉS longue liste, avec les versions actuelles de Python au début. Vous verrez aussi les versions de jython, ironpython, anaconda et anaconda3, activepython et d'autres. Maintenant, nous pouvons vérifier que le numéro de version que nous devons utiliser est « 3.7.4 ». (Dans peu de temps, nous ajouterons aussi la dernière version disponible, la 3.8.0).

Pour l'installer, tapez :

$ pyenv install 3.7.4

Ça prend environ cinq minutes sur mon vieux portable ; aussi, allez prendre une tasse de café ou de thé, puis reprenez.

Une fois l'installation terminée, saisissez :

$ pyenv versions

Vous devriez voir quelque chose comme ceci…

$ pyenv versions

system

* 3.7.4 (set by /home/greg/.python-version)

A couple of things here to note. First, you'll see * 3.7.4 which lets you know which version is set as the current default version of Python when using pyenv. Next, there is a “system” version, which is your regular version before we started this process. You can always use this without using pyenv. To prove this, in your terminal, type: $ python -V You should see whichever version you normally use. Now, you can always see what versions that pyenv has installed by doing a: $ ls ~/pyenv/versions/

Plusieurs choses à noter ici. D'abord, vous verrez * 3.7.4, qui vous indiquera la version de Python installée comme version par défaut quand vous utilisez pyenv. Ensuite, il y a une version « système », qui est votre version normale avant que vous ne démarriez le processus. Vous pouvez toujours l'utiliser sans utiliser pyenv. Pour vous le prouver, tapez dans votre terminal :

$ python -V

Vous devriez voir la version que vous utilisez normalement.

Bon. Vous pouvez toujours voir les versions que pyenv a installées, en faisant ceci :

$ ls ~/pyenv/versions/

This is where all of the pyenv Python versions are located. If you ever want to delete one, simply type: rm -rf ~/pyenv/versions/{version number} in a terminal window. For example, if I wanted to delete the 3.7.4 version, I'd do: $ rm -rf ~/pyenv/versions/3.7.4 Or, you can do it with a pyenv command: $ pyenv uninstall 3.7.4 But don't do that yet. Let's tell pyenv that we want to use the 3.7.4 version we just installed. $ pyenv local 3.7.4

C'est là que sont situées toutes les versions de python dans pyenv. Si vous voulez en supprimer une, il suffit de taper :

rm -rf ~/pyenv/versions/{numéro de version}

dans une fenêtre de terminal. Par exemple, si je voulais supprimer la version 3.7.4, je ferai :

$ rm -rf ~/pyenv/versions/3.7.4

Ou vous pouvez le faire avec une commande de pyenv :

$ pyenv uninstall 3.7.4

Mais ne le faites pas encore. Disons à pyenv que nous voulons utiliser la version 3.7.4 que nous venons d'installer :

$ pyenv local 3.7.4

Now ask python what version it is… $ python -V What you should see is something like this… Python 3.7.4 If not, try doing “exec $SHELL” and try again. Now just for sanity sake, go back to the system version. $ pyenv local system $ python -V

Demandez maintenant à python la version qui est installée…

$ python -V

Vous devriez voir quelque chose comme ceci…

Python 3.7.4

Sinon, essayez de faire « exec $SHELL », puis réessayez.

Histoire de bien comprendre, revenez maintenant à la version du système.

$ pyenv local system $ python -V

You should see your normal Python instance restored. Now, let's install the latest version of 3.8.0 in pyenv (which, at this writing, is 3.8.0b2). $ pyenv install 3.8-dev After about 5 minutes, everything will be installed. To verify, do the following: $ pyenv versions $ pyenv local 3.8-dev $ python -V Finally, let's make sure that we are using the correct pip – so we can install some libraries… $ pyenv which pip

Vous devriez voir que votre instance normale de Python a été rétablie. Maintenant, installons dans pyenv la dernière version de la 3.8.0 (qui est la 3.8.0b2, à l'heure où j'écris).

$ pyenv install 3.8-dev

Après environ 5 minutes, tout est installé. Pour le vérifier, faites ceci :

$ pyenv versions $ pyenv local 3.8-dev $ python -V

Enfin, assurons-nous que nous utilisons le bon pip - ainsi, nous pourrons installer quelques bibliothèques…

$ pyenv which pip

You should see something like: /home/greg/pyenv/versions/3.8-dev/bin/pip and to further prove it to ourselves… $ pip –version pip 19.0.3 from /home/greg/pyenv/versions/3.8-dev/lib/python3.8/site-packages/pip (python 3.8) So now we know that our version of Python is 3.8.0b2, and the pip that we are using is also from python 3.8. As normal, let's do a pip list to see what library packages are installed. $ pip list and you should see… Package Version ———- ——- pip 19.0.3 setuptools 40.8.0

Vous devriez voir quelque chose comme :

/home/greg/pyenv/versions/3.8-dev/bin/pip

et pour mieux nous le prouver…

$ pip –version pip 19.0.3 from /home/greg/pyenv/versions/3.8-dev/lib/python3.8/site-packages/pip (python 3.8)

Ainsi, nous savons maintenant que notre version de Python est la 3.8.0b2 et que le pip que nous utilisons vient aussi de Python 3.8. Comme d'habitude, listons pip pour voir quels paquets de bibliothèques sont installés.

$ pip list

et vous devriez voir…

Package Version ———- ——- pip 19.0.3 setuptools 40.8.0

You might also get a notice to upgrade pip. Go ahead and do that if you want, then we'll set up a virtual environment. Notice that we are using “pip” and not “pip3”. It actually doesn't matter which you use when you are working with a pyenv install. They are all the same. (There is an issue that some are having where the wrong pip is being used when going by to the system version. As a safety check, when using system, do a “pip3 –version” after setting back to system version). Now, we'll deal with the virtual environment. As I said earlier, this is so we can have various special libraries installed without causing issues with our “normal” environment. Since we chose the easy install option, the virtualenv plugin is already installed. We'll create a virtual environment for our 3.8-dev install. The basic syntax is “pyenv virtualenv <python version> <environment name>”. So, for our example, we'll do… $ pyenv virtualenv 3.8-dev 38beta and the response should be something like: Looking in links: /tmp/tmpby1g9af4 Requirement already satisfied: setuptools in /home/greg/pyenv/versions/3.8-dev/envs/38beta/lib/python3.8/site-packages (40.8.0) Requirement already satisfied: pip in /home/greg/pyenv/versions/3.8-dev/envs/38beta/lib/python3.8/site-packages (19.0.3)

Vous pourriez recevoir aussi un message vous demandant de mettre pip à jour. Allez-y ; faîtes-le si vous voulez et ensuite nous paramétrerons un environnement virtuel.

Notez que nous utilisons « pip » et non « pip3 ». Que vous utilisiez l'un ou l'autre dans une installation de pyenv n'a pas vraiment d'importance. Ils sont tous deux équivalents. (Il y a un problème pour certains quand le mauvais pip est utilisé lorsque vous passez par la version du système. Par sécurité, quand vous utilisez le système, vérifiez par un « pip –version » une fois être revenu à la version du système).

Maintenant, nous allons traiter l'environnement virtuel. Comme je l'ai dit plus tôt, c'est comme ça que nous pouvons installer diverses bibliothèques spéciales sans que cela pose des problèmes à l'environnement « normal ». Comme nous avons choisi la méthode d'installation facile, le module additionnel virtualenv est déjà installé. Nous créerons un environnement virtuel pour notre installation de 3.8-dev. La syntaxe de base est « pyenv virtualenv <version de python> <version de l'environnement> <nom de l'environnement>. Aussi, pour notre exemple, nous ferons…

$ pyenv virtualenv 3.8-dev 38beta

et la réponse devrait être quelque chose comme ça :

Looking in links: /tmp/tmpby1g9af4 Requirement already satisfied: setuptools in /home/greg/pyenv/versions/3.8-dev/envs/38beta/lib/python3.8/site-packages (40.8.0) Requirement already satisfied: pip in /home/greg/pyenv/versions/3.8-dev/envs/38beta/lib/python3.8/site-packages (19.0.3)

Now we want to activate our virtual environment $ pyenv activate 38beta You should see: pyenv-virtualenv: prompt changing will be removed from future release. configure `export PYENV_VIRTUALENV_DISABLE_PROMPT=1' to simulate the behavior. (38beta) greg@greg-Latitude-E5500:~$ The first thing you should notice is the (38beta) that appears before your prompt. This lets you know that you are now in the virtual environment 38beta. Next, notice the warning notice above. This says that the prompt change will be going away in some future version. Many users are trying to get the maintainers of pyenv to change their minds, since this can tell you what, if any, virtual environment you are using just at a glance.

Maintenant nous voulons activer notre environnement virtuel :

$ pyenv activate 38beta

Vous devriez obtenir :

pyenv-virtualenv: prompt changing will be removed from future release. configure `export PYENV_VIRTUALENV_DISABLE_PROMPT=1' to simulate the behavior. (38beta) greg@greg-Latitude-E5500:~$

La première chose que vous devez noter, c'est le (38beta) qui apparaît avant votre invite. Cela vous permet de savoir que vous êtes maintenant dans l'environnement virtuel 38beta. Ensuite, notez l'avertissement au-dessus. Il indique que la modification de l'invite sera retirée dans une version future. Beaucoup d'utilisateurs essaient de faire changer les idées des mainteneurs de pyenv, car cela peut vous dire d'un eseul coup d'œil, si c'est le cas, quel environnement virtuel est utilisé.

Now, verify you are using the correct python version… $ python -V Python 3.8.0b2+ And verify the pip version points to the correct python installation… (38beta) greg@greg-Latitude-E5500:~$ pip –version pip 19.1.1 from /home/greg/pyenv/versions/3.8-dev/envs/38beta/lib/python3.8/site-packages/pip (python 3.8) To get out of the virtual environment, simply use… $ pyenv deactivate This should reset the prompt back to its “normal” environment.

Maintenant vérifiez que vous utilisez la bonne version de python…

$ python -V Python 3.8.0b2+

Et vérifiez que la version de pip pointe sur la bonne installation de python…

(38beta) greg@greg-Latitude-E5500:~$ pip –version pip 19.1.1 from /home/greg/pyenv/versions/3.8-dev/envs/38beta/lib/python3.8/site-packages/pip (python 3.8)

Pour sortir de l'environnement virtuel, utilisez juste…

$ pyenv deactivate

Cela remettra l'invite dans son environnement « normal ».

At this point, you should now be able to move around using different Python versions pretty easily, activate and deactivate your virtual environments, and install new versions of python. I should say that whatever you do, don't use python 3.8.0 for any serious production work until the full release comes out sometime in October or November. The actual release is currently scheduled for October 21, 2019. Here is the schedule as of now… 3.8.0 beta 3: Monday, 2019-07-29 3.8.0 beta 4: Monday, 2019-08-26 3.8.0 candidate 1: Monday, 2019-09-30 3.8.0 candidate 2: Monday, 2019-10-07 (if necessary) 3.8.0 final: Monday, 2019-10-21

À ce stade, vous devriez être capable de passer d'une version de Python à une autre assez facilement, d'activer et désactiver vos environnements virtuels et d'installer de nouvelles versions de Python.

Je dirais que, quoique vous fassiez, n'utilisez pas python 3.8.0 dans un développement de production important avant que la publication officielle ne sorte en octobre ou novembre prochains. Le version finale est planifiée actuellement pour le 21 octobre 2019. C'est le calendrier officiel pour le moment…

3.8.0 beta 3 : lundi 29-07-2019

3.8.0 beta 4 : lundi 26-08-2019

3.8.0 candidate 1 : lundi 30-09-2019

3.8.0 candidate 2 : lundi 07-10-2019 (si nécessaire)

3.8.0 final : lundi 21-10-2019

If you want to keep up with the latest beta and release candidates within your pyenv world, when a new version is released, give it a day or two before you try to nstall the new one. Get a list from pip of the library packages you have installed in your beta setup (pip list > pippkgs38beta.txt), and use this raw file to create a requirements.txt file that you can use to automate the re-installation process, and finally remove the old beta or release candidate (rm -rf ~/pyenv/versions/3.8-dev), then reinstall the new version. Just for your information, Python 3.9 development is already underway. The first alpha release is scheduled for 2019-09-13, the first beta is scheduled for 2020-01-20 and final release is scheduled for 2020-06-08.

Si vous voulez vous tenir au courant des dernières RC (release candidiate - pré-version) et bêta du monde pyenv, quand une nouvelle version sort, donnez-vous un jour ou deux avant d'essayer d'en installer une nouvelle. Faîtes une liste issue de pip des paquets de bibliothèques que vous avez installés dans votre paramétrage de la bêta (pip list > pippkgs38beta.txt), utilisez ce fichier texte pour créer un fichier requirements.txt que vous pouvez utiliserez pour automatiser le processus de ré-installation et, enfin, enlever la vieille bêta ou RC (rm -rf ~/pyenv/versions/3.8-dev) puis réinstaller la nouvelle version. Juste pour votre information, le développement de Python 3.9 est déjà en cours. La première publication alpha est planifiée pour le 13-09-2019, la première bêta pour le 20-01-2020 et la publication finale pour le 08-06-2020.

issue148/python.txt · Dernière modification : 2019/09/17 15:38 de lecastillan