Différences

Ci-dessous, les différences entre deux révisions de la page.

--- virtualenv [2018/09/01 08:00] – serge
+++ virtualenv [2022/05/06 15:49] (Version actuelle) – [Pense bêtes] serge
@@ Ligne 1: / Ligne 1: @@
 ====== Python: Virtualenv ======
-<WRAP center round info centeralign 30%>
+<WRAP center round box 60% centeralign>
-**Niveau Pro**
+**[[toutes_les_pages_sur_python|Toutes les pages sur Python]] sans les pages sur {{tagpage>kivy|Kivy}}**\\
+**[[http://translate.google.com/translate?hl=&sl=auto&tl=en&u=https%3A%2F%2Fressources.labomedia.org%2Fvirtualenv|English Version]]**
 </WRAP>
-{{tag>python sb}}
-=====Virtualenv=====
+=====Pense bêtes=====
+<code bash>
+# Installation initiale
+sudo apt install python3-pip python3-venv
+python3 -m pip install --upgrade pip
-virtualenv est un outil pour créer un environnement Python isolé.
+# Dans le dossier du projet
+python3 -m venv mon_env
+source mon_env/bin/activate
+python3 -m pip install -r requirements.txt
+python3 -m pip install Pillow==7.1.1
+pip freeze > all_requirements.txt
+</code>
-The basic problem being addressed is one of dependencies and versions, and indirectly permissions. Imagine you have an application that needs version 1 of LibFoo, but another application requires version 2. How can you use both these applications? If you install everything into /usr/lib/python2.7/site-packages (or whatever your platform’s standard location is), it’s easy to end up in a situation where you unintentionally upgrade an application that shouldn’t be upgraded.
+=====Version de python=====
+Si vous avez plusieurs versions de python, vous devez remplacer
+  python3
+par
+  python3.x
+ou x = 6 ou 7 ou 8 ou 9 ou 10 ou 11 ...
+=====Ressources=====
+  * **[[https://docs.python.org/fr/3/tutorial/index.html|Le tutoriel Python]]** de la fondation Python fr.
+  * **[[https://docs.python.org/fr/3/tutorial/venv.html|Environnements virtuels et paquets]]** sur la Doc officielle docs.python.org
-Or more generally, what if you want to install an application and leave it be? If an application works, any change in its libraries or the versions of those libraries can break the application.
+===== Installation d'un package sans environnement virtuel =====
-Also, what if you can’t install packages into the global site-packages directory? For instance, on a shared host.
+<code bash>
+python3 -m pip install psutil --user
+python3 -m mon_fichier.py
+</code>
-In all these cases, virtualenv can help you. It creates an environment that has its own installation directories, that doesn’t share libraries with other virtualenv environments (and optionally doesn’t access the globally installed libraries either).
+Notez le –user, ainsi que les -m.\\
+Ceci va installer psutil dans ~.local, pas au niveau du système. L'option -m exécute pip en tant que module. Il y a un warning sur le python path, personnellement python m'a toujours trouvé les packages de .local, sur debian et ubuntu.
+Si besoin, ajouter à ~.bashrc
+<code bash>export PYTHONPATH="${PYTHONPATH}:~/.local"</code>
-=====Comment créer un virtualenv ?=====
+====Liste des package installés localement====
-Voici la marche à suivre pour créer le « virtualenv ».
+Donc sans les packages du système et les packages installés dans le système.
-====Installation====
+  python3 -m pip list --user
-Installe python3-venv python3.5-venv
+===== Environnement Virtuel =====
-  sudo apt-get install python3-venv
-Crée un dossier /home/user/VEnv
+==== Installation de venv ====
-====Utilisation====
+<code bash>
+# Mise à jour de pip
+python3 -m pip install --upgrade pip
+# Installation de venv
+sudo apt install python3-venv
+</code>
+=====Ressources=====
+  * **https://packaging.python.org/** la doc officielle
-  python3 -m venv ~/VEnv
+==== Initialisation ====
+<code bash>
-===1ère solution===
+cd /le/dossier/de/votre/projet/truc/
+# Création du dossier environnement si pas encore créé
+python3 -m venv mon_env
+# Activation
+source mon_env/bin/activate
+# le prompt devient (mon_env) machin@127:/../../../projets/truc/
+# Installation des package
+python3 -m pip install -r requirements.txt
+# Installation d'un package supplémentaire
+python3 -m pip install Pillow==7.1.1
+# Création ou re-création des requirements
+pip freeze > requirements.txt
+</code>
-  source ~/VEnv/bin/activate
+====Arguments spécifiques====
-équivalent à
+===Installation avec les sources dans un dossier===
+<code bash>python3 -m pip install --no-index --find-links=/media/data/exclude/clones/mediapipe mediapipe</code>
-  source /home/user/VEnv/bin/activate
+===Avec accès aux package système===
+  * https://pip.pypa.io/en/stable/user_guide/
+Permet à python du venv d'accéder au package système: --system-site-packages
+<code bash>python3 -m pip install -r --system-site-packages requirements.txt</code>
-Le prompt devient:
+--no-site-packages est la valeur par défaut
-  (VEnv) user@PC01:~$
+===Depuis un Git===
+<code bash>python3 -m pip install -e git+https://git.repo/some_pkg.git#egg=SomeProject</code>
-Installation des modules appelés par votre projet:
+====Exécution d'un script de votre projet====
+<code bash>
+cd /le/dossier/de/votre/projet/truc/
+./mon_env/bin/python3 ./sous_dossier/main.py
+# Dans Geany, commande de construction
+../mon_env/bin/python3 "%f"
+</code>
-  pip3 install twisted librosa bs4
+==== Relance pour installer de nouveaux package ====
+<code bash>
+cd /le/dossier/de/votre/projet/truc/
+source mon_env/bin/activate
+python3 -m pip install some_package
+# Mise à jour des requirements
+pip freeze > requirements.txt
+</code>
+==== Génération du fichier requirements.txt ====
+Pour faciliter la distribution de votre projet dans son virtualenv, il est recommandé de produire un fichier requirements.txt qui listera toutes les dépendances de votre projet.\\
+C'est la liste de tous les paquets que vous avez installé pour votre projet.
+<code bash>pip freeze > requirements.txt</code>
-===2ème solution===
-Utiliser l’interpréteur installé dans le « virtualenv » :
+=====Création d'un venv avec une autre version de python=====
+Installation de python 3.8 sur Xubuntu 18.04
+  * https://askubuntu.com/questions/1197683/how-do-i-install-python-3-8-in-lubuntu-18-04
+<code bash>
+sudo apt update
+sudo apt install software-properties-common
+sudo add-apt-repository ppa:deadsnakes/ppa
+sudo apt install python3.8
+</code>
+Création d'un venv
+<code bash>
+cd /mes/projets/keras-jordan-bird/
+python3.8 -m venv mon_env
+sudo apt install python3.8-venv python3.8-dev
+python3.8 -m venv mon_env
+source mon_env/bin/activate
+python3.8 -m pip install -r requirements.txt
+</code>
-    * ~/VEnv/bin/python` (qui peut être utilisé comme shebang aussi bien sur)
+=====Travailler avec Geany et un Virtual Env=====
+  * **[[https://stackoverflow.com/questions/42013705/using-geany-with-python-virtual-environment|Using geany with python virtual environment]]**
+Dans "Construire" / "Définir les commandes de construction":
+  ../mon_env/bin/python3 "%f"
-=====Ressources====
+{{:media_14:geany_construire.png?200|}}
-  * [[https://deusyss.developpez.com/tutoriels/Python/packaging_pypi/|Packaging Python et PyPI de GALODE Alexandre sur developpez.com]]
+{{:media_14:construire_execute.png?400|}}
+{{tag>python sb}}
-=====Requirement=====
-===Ressources===
-  * [[https://deusyss.developpez.com/tutoriels/Python/packaging_pypi/#LIII-D|Installer un groupe de paquets grâce à un fichier requirement]]
-  * [[https://deusyss.developpez.com/tutoriels/Python/packaging_pypi/#LIII-A|Le format requirement]]
-===Exemple===
-<file txt requirements.txt>
-twisted
-service_identity
-google-auth-oauthlib
-</file>
-Dans un terminal, dans le dossier de requirements.txt, installation dans le système:
-  sudo pip3 install -r requirements.txt