Outils pour utilisateurs

Outils du site


dev:python:environnement_virtuel_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.
# 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

Le fichier .gitignore

.gitignore
.venv/
 
*.pyc
__pycache__/
 
instance/
 
.pytest_cache/
.coverage
htmlcov/
 
dist/
build/
*.egg-info/

Références

dev/python/environnement_virtuel_avec_git.txt · Dernière modification : 2024/11/01 12:11 de yoann