Créer un environnement virtuel et l’activer

Quand plusieurs projets Python partagent le même ordinateur, ils peuvent avoir besoin de versions ou de paquets différents. Installer tout dans l’environnement global rend ces projets difficiles à isoler et à reproduire. Vous allez créer un environnement propre au suivi des dépenses, puis vérifier que les commandes Python utilisent bien celui-ci.

Créer l’environnement dans le dossier du projet

Ouvrez un terminal dans le dossier racine du projet, celui qui contient notamment README.md et requirements.txt. Un environnement virtuel est un répertoire contenant un interpréteur Python isolé et les outils associés. La commande standard python -m venv .venv demande au Python sélectionné de créer cet environnement dans un répertoire nommé .venv.

python3 -m venv .venv

py -m venv .venv

Le nom .venv est une convention pratique : le point le rend discret dans les outils qui masquent les fichiers cachés, tout en restant explicite dans le terminal. La création ne modifie pas le code de l’application et ne supprime aucun fichier existant. Exécutez la commande une seule fois pour ce projet ; par la suite, vous réutiliserez le répertoire créé en l’activant.

Activer et désactiver l’environnement

La création et l’activation sont deux opérations distinctes. Activez l’environnement au début de chaque nouvelle session de travail dans le terminal : les commandes python et pip pointeront alors vers les outils de .venv. L’invite du terminal affiche souvent son nom entre parenthèses, par exemple (.venv), ce qui constitue un indice visuel, mais pas une vérification suffisante à lui seul.

source .venv/bin/activate

.venv\Scripts\Activate.ps1

Dans l’invite de commandes Windows, la commande d’activation diffère : utilisez .venv\Scripts\activate.bat. PowerShell peut bloquer l’exécution du script selon sa configuration de sécurité ; ne contournez pas cette protection à l’aveugle. Utilisez un terminal autorisé par votre environnement de travail ou demandez conseil à l’administrateur de votre poste.

Quand vous avez terminé, désactivez l’environnement avec la même commande sur les systèmes courants. Cette action rend au terminal son contexte précédent ; elle ne désinstalle rien et ne supprime pas le répertoire .venv. Vous pourrez le réactiver lors de votre prochaine session.

deactivate

Vérifier l’interpréteur utilisé

Après l’activation, demandez à Python d’afficher le chemin de son exécutable. La commande python convient dans les deux environnements activés ci-dessous ; sous macOS ou Linux, vous pouvez aussi employer python3. Le chemin retourné doit désigner un fichier situé dans le répertoire .venv du projet, et non l’installation Python globale.

python -c "import sys; print(sys.executable)"

Chemin attendu : le chemin vers le répertoire du projet suivi de /.venv/bin/python sous macOS ou Linux, ou de \.venv\Scripts\python.exe sous Windows.

La propriété sys.executable désigne l’exécutable qui fait tourner le processus Python courant. Contrôlez son résultat après activation, notamment si plusieurs installations de Python sont présentes sur votre ordinateur. Si le chemin ne contient pas .venv, vérifiez que vous êtes dans le bon terminal et que l’activation a réussi, puis relancez la vérification.

À retenir

• Créez l’environnement avec `python -m venv .venv` à la racine du projet.
• Activez-le dans chaque nouvelle session de terminal ; la commande dépend du système utilisé.
• Vérifiez `sys.executable` et assurez-vous que le chemin pointe dans `.venv`.
• Utilisez `deactivate` pour quitter l’environnement sans supprimer ses fichiers.

Dans la prochaine leçon, vous consignerez les dépendances du projet afin de rendre son installation plus prévisible.