Lire la structure d’un fichier Python

Un script Python peut afficher le bon message tout en restant difficile à relire si les instructions sont mal organisées. Vous allez structurer le fichier du suivi de dépenses pour distinguer ce que Python exécute de ce qui sert à expliquer le code.

Vous avez déjà créé et lancé suivi_depenses.py ; cette leçon reprend ce même fichier et conserve ses deux messages affichés. Vous allez ajouter des commentaires et observer comment une indentation de quatre espaces rend une partie du script lisible sans changer son résultat.

Les instructions s’exécutent dans l’ordre

Dans un fichier Python, les instructions placées les unes après les autres sont exécutées de haut en bas. Dans votre script, le premier appel à print affiche le nom du projet ; le second affiche le message qui invite à saisir des dépenses. Cet ordre est visible directement dans le fichier.

Pour que les personnes qui liront le script comprennent son rôle, vous pouvez ajouter un commentaire. Une ligne qui commence par le caractère # est destinée aux lecteurs : Python l’ignore lorsqu’il exécute le programme. Le commentaire n’affiche donc rien et ne remplace pas une instruction exécutable.

Mettre en forme le script

Remplacez le contenu de suivi_depenses.py par ce fichier complet. Les deux appels à print sont toujours présents et restent dans le même ordre ; les commentaires décrivent le projet et son état actuel.

# Projet : suivi de dépenses
# Cette version affiche un message d'accueil.

print("Suivi de dépenses")
print("Saisissez vos dépenses pour préparer un récapitulatif.")

Reconnaître une indentation de quatre espaces

Une indentation est le décalage placé au début d’une ligne. Python s’en sert pour montrer qu’une instruction appartient à un bloc de code ; dans cette leçon, vous en observez simplement la forme avec une instruction placée sous une autre. Les quatre espaces de décalage rendent cette relation visible et respectent la convention du projet.

# Exemple de mise en retrait : n'ajoutez pas ce bloc au script.
print("Début du traitement")
    print("Instruction indentée")

Cet exemple est volontairement incorrect : la dernière instruction est décalée alors qu’aucun bloc ne la justifie. Si vous l’exécutez, Python signale une erreur d’indentation au lieu de lancer le programme. Ne recopiez donc pas cet exemple dans le fichier du projet ; le script complet à conserver est celui de la section précédente.

Exécuter et vérifier le résultat

Enregistrez le fichier, puis lancez-le depuis son dossier avec la commande Python que vous avez vérifiée dans la première leçon. Les commentaires ne produisent aucune ligne supplémentaire : vous devez retrouver les deux messages dans le même ordre qu’auparavant.

Suivi de dépenses
Saisissez vos dépenses pour préparer un récapitulatif.

Si vous voyez ces deux lignes, le fichier s’exécute et les commentaires ont bien été ignorés. Si une erreur apparaît, vérifiez que les appels à print sont alignés à gauche et que vous avez copié uniquement le script complet, sans l’exemple volontairement incorrect.

À retenir

• Les instructions d’un script sont exécutées de haut en bas.
• Une ligne qui commence par # est un commentaire ignoré à l’exécution.
• L’indentation rend visibles les blocs de code ; la convention du projet prévoit quatre espaces par niveau.
• Les deux messages du script restent affichés dans leur ordre d’origine.

Dans la prochaine leçon, vous donnerez des noms aux valeurs que le script devra conserver pour préparer la saisie des dépenses.