Différences

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

--- dev:python:environnement_virtuel_avec_git [2021/12/14 17:56] – créée yoann
+++ dev:python:environnement_virtuel_avec_git [2025/07/21 09:33] (Version actuelle) – yoann
@@ Ligne 1: / Ligne 1: @@
-{{tag>dev python venv git todo}}
+{{tag>dev python venv git}}
-====== Python : Usage des environnements virtuels avec Git ======
+====== Python : environnement virtuel dans Git ======
+L'environnement virtuel est créé afin de garantir une isolation des dépendances nécessaires au bon fonctionnement du programme Python. Ainsi, les mises à jours des bibliothèques du système ne remplaceront pas les versions nécessaires au bon fonctionnement de l'application.
+**L'environnement virtuel n'a pas à être suivi par le gestionnaire de révision Git**, il peut d'ailleurs tout à fait être créé en dehors du dépot. S'il est créé à l'intérieur du répertoire du projet il devra être ignoré.
+La démarche générale est la suivante:
+  * On crée un répertoire projet pour le programme Python à développer, on initialise le dépôt Git;
+  * On crée le script Python et on fait un import initial pour commencer le suivi;
+  * On crée un environnement virtuel (par convention ''env'') dans le dépôt;
+  * On crée ou on modifie le fichier **.gitignore** pour désactiver le suivi sur l'ensemble du dossier et du contenu de ''./env''
+  * On active l'environnement virtuel, on installe les dépendances nécessaires au fonctionnement du script.
+  * Pour sauvegarder et pouvoir reconstruire l'environnement virtuel dans Git, on exporte les dépendances via la commande pip freeze dans un fichier ''requirements.txt''.
+<code bash>
+# Avant de modifier le script Python, on charge son environnement virtuel
+source "./env/bin/activate"
+# on travaille sur le script, on installe les modules nécessaires
+pip3 install pyyaml
+# Pour sauvegarder l'environnement virtuel utilisé par notre script dans Git
+# on enregistre la liste des modules installés dans un fichier texte
+pip3 freeze > requirements.txt
+# On ajoute le fichier à l'index et on le pousse dans le dépot
+git add requirements.txt
+git commit -m "Fichier de création de l'environnement virtuel Python"
+# pour terminer, on quitte l'environnement virtuel
+deactivate
+</code>
+===== Exemple de fichier .gitignore =====
+<file txt .gitignore>
+.venv/
+*.pyc
+__pycache__/
+instance/
+*.db
+*.sqlite
+.pytest_cache/
+.coverage
+htmlcov/
+dist/
+build/
+*.egg-info/
+</file>
+===== Tester les règles du .gitignore =====
+Pour vérifier que les règles définies dans le fichier .gitignore s'appliquent comme attendu, on peut utiliser la commande **git check-ignore** :
+<code bash>
+# Vérifier que le fichier database.db est bien ignoré par git
+git check-ignore -v ./instance/database.db
+</code>

wikinotes

Outils pour utilisateurs

Outils du site

Différences

Outils de la page