Exécuter un script Python depuis le terminal

En bref

Résumé de l’article

Cet article explique ce qu’est un interpréteur Python, comment vérifier celui qui est installé sur votre machine et comment l’installer ou le mettre à jour. Il montre ensuite les deux façons de lui donner du travail : la session interactive, pour essayer une instruction, et le script, un simple fichier texte que l’on exécute avec python mon_script.py.

La dernière partie est la plus importante : elle explique le rôle du répertoire courant du terminal et la différence entre chemin relatif et chemin absolu. C’est ce qui explique la quasi-totalité des erreurs « mon programme ne trouve pas son fichier » ou « ça marchait hier ». Elle démystifie enfin le bouton « Exécuter » des éditeurs, qui ne fait rien d’autre que taper cette commande à votre place.

Points clés à retenir

• L’interpréteur traduit vos instructions une par une pour le processeur. Contrairement à un compilateur, il n’a pas besoin de traduire tout le programme avant de commencer à l’exécuter.
• Un script Python est un fichier texte brut d’extension .py. Un traitement de texte comme Word ou LibreOffice ne convient pas : il ajoute des informations de mise en forme que l’interpréteur ne sait pas lire.
• python mon_script.py se lit « interpréteur, exécute ce fichier ». Sous Linux et MacOS, la commande s’appelle python3.
• Le terminal a un répertoire courant, et un chemin relatif est toujours interprété par rapport à lui. Le même programme lancé depuis deux dossiers différents ne se comporte pas de la même façon.
• Le bouton « Exécuter » d’un éditeur n’a rien de magique : il choisit un interpréteur et un répertoire courant à votre place, puis lance la commande. Savoir la taper vous-même est ce qui vous permet de comprendre ce qu’il fait – et de le réparer quand il se trompe.

Contenu de l’article

L’interpréteur Python

Python est un langage informatique qui vous permet d’écrire des programmes, c’est-à-dire une liste d’instructions conçues pour être exécutées par l’ordinateur afin d’accomplir la tâche souhaitée.

Cependant, le processeur de l’ordinateur comprend essentiellement des séries de 0 et de 1. Un interpréteur Python fait la traduction entre vos instructions respectant la syntaxe Python et le processeur qui nécessite des séries de 0 et 1. C’est évidemment une simplification grossière car plusieurs étapes peuvent être nécessaires pour alimenter le processeur (via du bytecode par exemple). Cependant, la principale caractéristique d’un interpréteur est qu’il traduit une instruction à la fois pour le processeur de l’ordinateur.

Avec un interpréteur, il n’est pas nécessaire de traduire l’intégralité du code source et de produire le code binaire complet du programme avant de lancer l’exécution. Cela serait le rôle d’un compilateur. Des langages tels que C ou C++ nécessitent un compilateur. D’autres langages, comme Java, se situent entre ces deux solutions, en compilant le code Java en une représentation intermédiaire (bytecode), qui est ensuite interprétée.

Pour travailler avec le langage Python, vous devez donc installer sur votre machine un interpréteur capable de traduire et d’exécuter les lignes de texte que vous écrirez en syntaxe Python.

Vérifier ce qui est installé sur votre machine

Pour savoir si vous avez déjà un interpréteur Python, ouvrez un terminal et demandez-lui sa version :

python --version

python --version

python3 --version

python3 --version

La sortie devrait ressembler à Python 3.12.4. Si c’est le cas, vous avez bien une version de Python 3 installée ; vérifiez qu’il s’agit d’une version récente (au moins 3.12). Si vous obtenez au contraire un message indiquant que la commande est inconnue, vous devez installer Python.

Une deuxième question, moins évidente, est de savoir quel interpréteur répond. Il peut y en avoir plusieurs sur une même machine, et c’est une source d’erreurs classique. Pour connaître le fichier réellement exécuté :

where python

Get-Command python

which python3

which python3

Installer ou mettre à jour l’interpréteur

Pour installer ou mettre à jour Python, votre point de référence est le site officiel de Python.

Vous vous demandez peut-être s’il est toujours préférable d’avoir la dernière version d’un logiciel. Voici quelques questions à considérer avant de mettre à jour votre interpréteur :

• Parfois, le choix ne vous appartient pas : par exemple, votre client peut avoir des contraintes auxquelles vous devez vous conformer (votre programme ne fonctionnera probablement pas seul mais dans un système existant avec un environnement spécifique).
• C’est aussi une question d’équilibre entre casser un logiciel existant pour prendre en compte de nouvelles fonctionnalités ou corrections de bugs, des problèmes de sécurité, etc. En effet, vous devez être sûr de pouvoir réparer le logiciel cassé.
• Certains contrôles doivent être effectués : mon programme utilise-t-il des paquets ou a-t-il des dépendances (bibliothèques) qui ne sont pas compatibles (bugs) avec la dernière version ? Ai-je vérifié les retours utilisateurs sur une version spécifique ? Les pages de sortie mentionnent-elles des problèmes potentiels ?

Pour l’instant, considérez que toute version supérieure à 3.12 devrait satisfaire vos besoins.

La procédure dépend de votre système :

sudo apt update
sudo apt install python3

brew update
brew install python3

Quel que soit votre système, vérifiez ensuite l’installation en ouvrant un nouveau terminal et en retapant python --version (ou python3 --version).

La session interactive

La façon la plus directe de parler à l’interpréteur est de le lancer sans rien lui donner à exécuter. Tapez python (ou python3) seul dans un terminal : le prompt devient >>> et chaque ligne que vous tapez est traduite et exécutée immédiatement.

>>> print("Hello World!")
Hello World!
>>> 2 + 3
5
>>> texte = "IMT Atlantique"
>>> texte[::-1]
'euqitnaltA TMI'

C’est très pratique pour vérifier le comportement d’une instruction ou explorer une bibliothèque. En revanche, rien n’est conservé : dès que vous quittez la session avec quit() ou exit(), tout ce que vous avez tapé disparaît.

Le script : un simple fichier texte

Pour conserver et rejouer votre travail, vous mettez vos instructions dans un fichier, et vous demandez à l’interpréteur de lire et d’exécuter ce fichier ligne par ligne. Ces fichiers portent par convention l’extension .py.

Un script Python est un fichier texte brut : n’importe quel éditeur de texte suffit à en écrire un. L’application “Notepad” sous Windows, “Gedit” sous Linux ou “TextEdit” sous MacOS font parfaitement l’affaire.

Une fois le fichier hello_world.py enregistré, on l’exécute en donnant son nom à l’interpréteur :

python hello_world.py

python hello_world.py

python3 hello_world.py

python3 hello_world.py

Cette ligne se lit comme une phrase : « interpréteur Python, exécute le fichier hello_world.py ». Il n’y a rien d’autre. Toute exécution d’un programme Python, y compris celle déclenchée par le bouton « Exécuter » d’un éditeur, revient à cette commande.

Le répertoire courant et les chemins

Dans la commande précédente, hello_world.py est un chemin relatif : il ne dit pas où se trouve le fichier, seulement comment y arriver depuis le répertoire courant du terminal. Si ce répertoire n’est pas le bon, l’interpréteur ne trouve rien :

python: can't open file 'hello_world.py': [Errno 2] No such file or directory

Le terminal affiche généralement son répertoire courant dans le prompt, mais vous pouvez toujours le demander explicitement :

echo %cd%

Get-Location

pwd

pwd

Vous avez donc trois façons d’exécuter le même fichier, selon d’où vous partez. Notez que le séparateur de dossiers et la forme des chemins absolus dépendent du système :

Le bouton « Exécuter » de l’éditeur, démystifié

Vous avez probablement déjà utilisé un éditeur qui propose un bouton « Exécuter » (ou ▷). Ce bouton ne fait rien de plus que ce que vous venez de faire à la main : il ouvre un terminal, y choisit un répertoire courant, y choisit un interpréteur, et lance la commande.

Le problème est qu’il fait ces trois choix à votre place, et pas toujours ceux que vous croyez :

• L’interpréteur peut ne pas être celui que vous attendez, en particulier si plusieurs versions de Python sont installées, ou si votre projet dispose d’un environnement isolé.
• Le répertoire courant peut être le dossier du fichier, ou la racine du projet ouvert, selon l’éditeur et sa configuration. D’où des erreurs de fichier introuvable qui apparaissent et disparaissent sans raison apparente.
• Les arguments ne peuvent en général pas être passés sans configurer l’éditeur.

Savoir lancer un programme depuis un terminal n’est donc pas une punition avant de mériter les outils confortables : c’est ce qui vous permet de comprendre ce que fait le bouton, de diagnostiquer une erreur, et plus tard de faire exécuter votre code par une autre machine, où il n’y a évidemment aucun bouton.

Pour aller plus loin

Passer des arguments à un script

Mettre son code dans un fichier permet aussi de lui passer des arguments, c’est-à-dire de le paramétrer au lancement plutôt que de modifier le code entre deux exécutions. Les arguments sont récupérés dans la liste sys.argv, dont le premier élément est le nom du script lui-même :

import sys

if len(sys.argv) != 3:
    print(f"Usage : {sys.argv[0]} <prenom> <nom>")
    sys.exit(1)

prenom, nom = sys.argv[1], sys.argv[2]
print(f"Bonjour {prenom} {nom} !")

$ python3 bonjour.py Ada Lovelace
Bonjour Ada Lovelace !

C’est ce mécanisme qui permet d’écrire un programme réutilisable, et de l’appeler en boucle depuis un script shell sur des dizaines de fichiers différents. Pour des besoins plus riches (options nommées, valeurs par défaut, aide automatique), la bibliothèque standard fournit le module argparse.

Les options de l’interpréteur

L’interpréteur accepte lui aussi des options, à placer avant le nom du script. Les plus utiles au quotidien :

La liste complète est décrite dans la documentation officielle.