12. Environnements virtuels et paquets
**************************************


12.1. Introduction
==================

Les programmes Python utilisent souvent des paquets et modules qui ne
font pas partie de la bibliothèque standard. Ils nécessitent aussi,
parfois, une version spécifique d'une bibliothèque, par exemple parce
qu'un certain bogue a été corrigé ou encore que le programme a été
implémenté en utilisant une version obsolète de l'interface de cette
bibliothèque.

Cela signifie qu'il n'est pas toujours possible, pour une installation
unique de Python, de couvrir tous les besoins de toutes les
applications. Basiquement, si une application A dépend de la version
1.0 d'un module et qu'une application B dépend de la version 2.0, ces
dépendances entrent en conflit et installer la version 1.0 ou 2.0
laisse une des deux applications incapable de fonctionner.

La solution est de créer un *environnement virtuel*, un dossier auto-
suffisant qui contient une installation de Python pour une version
particulière de Python ainsi que des paquets additionnels.

Différentes applications peuvent alors utiliser des environnements
virtuels différents. Pour résoudre l'exemple précédent où il existe un
conflit de dépendances, l'application A a son environnement virtuel
avec la version 1.0 installée pendant que l'application B a un autre
environnement virtuel avec la version 2.0. Si l'application B requiert
que la bibliothèque soit mise à jour à la version 3.0, cela n'affecte
pas l'environnement de A.


12.2. Création d'environnements virtuels
========================================

The module used to create and manage virtual environments is called
"venv".  "venv" will install the Python version from which the command
was run (as reported by the "--version" option). For instance,
executing the command with "python3.12" will install version 3.12.

Pour créer un environnement virtuel, décidez d'un dossier où vous
voulez le placer et exécutez le module "venv" comme un script avec le
chemin du dossier :

   python -m venv tutorial-env

Cela crée le dossier "tutorial-env" (s'il n'existe pas) et des sous-
dossiers contenant une copie de l'interpréteur Python et d'autres
fichiers utiles.

Un répertoire habituel pour un environnement virtuel est ".venv". Ce
nom fait que le répertoire est généralement caché dans votre
explorateur de fichiers, et donc non gênant, tout en lui donnant un
nom qui explique pourquoi le répertoire existe. Il empêche également
de rentrer en conflit avec les fichiers de définition de variable
d'environnement ".env" que certains outils utilisent.

Une fois l'environnement virtuel créé, vous pouvez l'activer.

Sur Windows, lancez :

   tutorial-env\Scripts\activate

Sur Unix et MacOS, lancez :

   source tutorial-env/bin/activate

(Ce script est écrit pour le shell **bash**. Si vous utilisez **csh**
ou **fish**, utilisez les variantes "activate.csh" ou
"activate.fish".)

Activer l'environnement virtuel change le prompt de votre ligne de
commande pour afficher le nom de l'environnement virtuel que vous
utilisez. Cela modifie aussi l'environnement afin, lorsque vous tapez
"python", d'exécuter la version spécifique de Python installée dans
l'environnement. Par exemple :

   $ source ~/envs/tutorial-env/bin/activate
   (tutorial-env) $ python
   Python 3.5.1 (default, May  6 2016, 10:59:36)
     ...
   >>> import sys
   >>> sys.path
   ['', '/usr/local/lib/python35.zip', ...,
   '~/envs/tutorial-env/lib/python3.5/site-packages']
   >>>

Pour désactiver un environnement virtuel, tapez :

   deactivate

dans le terminal.


12.3. Gestion des paquets avec *pip*
====================================

Vous pouvez installer, mettre à jour et supprimer des paquets en
utilisant un programme appelé **pip**. Par défaut, "pip" installe les
paquets du Python Package Index. Vous pouvez parcourir le Python
Package Index avec un navigateur.

"pip" a plusieurs sous-commandes : "install", "uninstall", "freeze",
etc. Consultez le guide Installation de modules Python pour une
documentation exhaustive sur "pip".

Vous pouvez installer la dernière version d'un paquet en indiquant son
nom :

   (tutorial-env) $ python -m pip install novas
   Collecting novas
     Downloading novas-3.1.1.3.tar.gz (136kB)
   Installing collected packages: novas
     Running setup.py install for novas
   Successfully installed novas-3.1.1.3

Vous pouvez installer une version spécifique d'un paquet en donnant le
nom du paquet suivi de "==" et du numéro de version souhaitée :

   (tutorial-env) $ python -m pip install requests==2.6.0
   Collecting requests==2.6.0
     Using cached requests-2.6.0-py2.py3-none-any.whl
   Installing collected packages: requests
   Successfully installed requests-2.6.0

Si vous relancez cette commande, "pip" remarque que la version
demandée est déjà installée et ne fait rien. Vous pouvez fournir un
numéro de version différent pour récupérer cette version ou lancer
"python -m pip install --upgrade" pour mettre à jour le paquet à la
dernière version :

   (tutorial-env) $ python -m pip install --upgrade requests
   Collecting requests
   Installing collected packages: requests
     Found existing installation: requests 2.6.0
       Uninstalling requests-2.6.0:
         Successfully uninstalled requests-2.6.0
   Successfully installed requests-2.7.0

"python -m pip uninstall" suivi d'un ou plusieurs noms de paquets les
supprime de votre environnement virtuel.

"python -m pip show" affiche des informations à propos d'un paquet
précis :

   (tutorial-env) $ python -m pip show requests
   ---
   Metadata-Version: 2.0
   Name: requests
   Version: 2.7.0
   Summary: Python HTTP for Humans.
   Home-page: http://python-requests.org
   Author: Kenneth Reitz
   Author-email: me@kennethreitz.com
   License: Apache 2.0
   Location: /Users/akuchling/envs/tutorial-env/lib/python3.4/site-packages
   Requires:

"python -m pip list" liste tous les paquets installés dans
l'environnement virtuel :

   (tutorial-env) $ python -m pip list
   novas (3.1.1.3)
   numpy (1.9.2)
   pip (7.0.3)
   requests (2.7.0)
   setuptools (16.0)

"python -m pip freeze" produit une liste similaire des paquets
installés mais l'affichage adopte un format que "pip install" peut
lire. La convention habituelle est de mettre cette liste dans un
fichier "requirements.txt" :

   (tutorial-env) $ python -m pip freeze > requirements.txt
   (tutorial-env) $ cat requirements.txt
   novas==3.1.1.3
   numpy==1.9.2
   requests==2.7.0

Le fichier "requirements.txt" peut alors être ajouté dans un système
de gestion de versions comme faisant partie de votre application. Les
utilisateurs peuvent alors installer tous les paquets nécessaires à
l'application avec "install -r" :

   (tutorial-env) $ python -m pip install -r requirements.txt
   Collecting novas==3.1.1.3 (from -r requirements.txt (line 1))
     ...
   Collecting numpy==1.9.2 (from -r requirements.txt (line 2))
     ...
   Collecting requests==2.7.0 (from -r requirements.txt (line 3))
     ...
   Installing collected packages: novas, numpy, requests
     Running setup.py install for novas
   Successfully installed novas-3.1.1.3 numpy-1.9.2 requests-2.7.0

"pip" has many more options.  Consult the Installation de modules
Python guide for complete documentation for "pip".  When you've
written a package and want to make it available on the Python Package
Index, consult the Python packaging user guide.
