Python 05 : préparer son environnement

Installer un interpréteur, identifier celui qui exécute un programme et isoler un projet NKILItech. Ce chapitre prépare le premier programme du chapitre 06.

Chapitre rédigé pour compléter cette ancienne adresse. Les exemples et exercices ci-dessous sont originaux.

1. Préparer un dossier de travail

Créez un dossier nommé nkilitech-python dans vos documents. Un fichier source porte l’extension .py ; il ne se place pas dans le répertoire de l’interpréteur. Pour vérifier l’installation, ouvrez un terminal et choisissez la commande disponible sur votre machine.

# Windows, si le lanceur est installé
py --version
# Linux ou macOS, si Python 3 est installé
python3 --version

Si aucune commande ne fonctionne, installez Python depuis son site officiel ou le gestionnaire de paquets de votre système. Fermez puis rouvrez le terminal. N’installez pas une version différente uniquement pour faire disparaître un message : commencez par lire la version trouvée.

2. Identifier le bon interpréteur

import sys
print("Interpréteur :", sys.executable)
print("Version :", sys.version)
print("Projet NKILItech prêt")

Enregistrez ce programme dans diagnostic.py. Exécutez py diagnostic.py ou python3 diagnostic.py. Le chemin affiché permet de comparer l’interpréteur utilisé par le terminal avec celui sélectionné dans l’éditeur.

3. Isoler les dépendances

Schéma des étapesDossier du projet puis Environnement .venv puis Interpréteur du projet puis Programme diagnostic.pyDossier du projetEnvironnement .venvInterpréteur du projetProgramme diagnostic.py
Schéma pédagogique original PandaCodeur.
# Windows
py -m venv .venv
.\.venv\Scripts\python.exe diagnostic.py
# Linux / macOS
python3 -m venv .venv
./.venv/bin/python diagnostic.py

Exécutez seulement le groupe de commandes adapté à votre système. L’activation est facultative : le chemin explicite fonctionne sans changer les règles de sécurité du terminal. Le dossier .venv contient l’environnement, pas votre code. Il ne se partage pas dans Git ; on le recrée sur une autre machine.

4. Exercices de diagnostic

Deux terminaux affichent des versions différentes. Que vérifier ?

Voir le corrigé expliqué

Affichez sys.executable dans les deux terminaux. Ils peuvent pointer vers deux installations. Choisissez explicitement l’interpréteur du projet ; modifier le fichier source ne corrige pas ce problème.

Pourquoi le fichier est-il introuvable ?

Voir le corrigé expliqué

Le terminal ne travaille peut-être pas dans le dossier du fichier. Affichez le dossier courant avec pwd ou Get-Location, puis placez-vous dans le dossier du projet. Vérifiez que le nom n’est pas diagnostic.py.txt.

Un collègue doit-il recevoir le dossier .venv ?

Voir le corrigé expliqué

Non. Il reçoit les sources et la liste des dépendances. Il crée son environnement local, puis installe les dépendances prévues. Pour ce premier programme, aucune bibliothèque externe n’est nécessaire.

Référence : Documentation Python : environnements virtuels.