3.18.1 Objets de l'Interpréteur Interactif

runsource(source[, nomfichier[, symbole]])

Compile et exécute du code source dans l'interpréteur. Les arguments sont les mêmes que pour compile_command(); les valeurs par défaut sont '<input>' pour nomfichier, et 'single' pour symbol. Plusieurs cas peuvent se produire:

L'entrée est incorrecte; compile_command() a déclenché une exception (SyntaxError ou OverflowError). Une trace de l'analyse de syntaxe sera imprimée en appelant la méthode showsyntaxerror(). runsource() retourne 0.
L'entrée est incomplète, il faut la compléter; compile_command() a retourné None. runsource() retourne 1.
L'entrée est complète; compile_command() a retourné un objet code. Le code est exécuté en appelant la méthode runcode() (qui gère aussi les exceptions à l'exécution, sauf SystemExit). runsource() retourne 0.

La valeur de retour peut être utilisée pour décider d'afficher sys.ps1 ou sys.ps2 comme invite pour la prochaine ligne.

runcode(code)

Exécute un objet code. Quand une exception se produit, showtraceback() est appelée pour afficher une trace. Toutes les exceptions sont interceptées, sauf SystemExit, qui est autorisée à se propager.

Une remarque au sujet de KeyboardInterrupt: cette exception peut se produire ailleurs dans ce code, et il se peut qu'elle ne soit pas toujours interceptée. L'appelant doit se préparer à en tenir compte.

showsyntaxerror([nomfichier])

Affiche l'erreur de syntaxe qui vient de se produire. Il n'y a pas d'affichage d'une trace de pile, parce qu'il n'en existe pas pour les erreurs de syntaxe. Si nomfichier est fourni, il est inclus dans l'exception à la place du nom de fichier par défaut qui est fourni par l'interpréteur de Python, parce qu'il utilise toujours '<string>' quand il lit depuis une chaîne de caractères. Le résultat est écrit par la méthode write().

showtraceback()

Affiche l'exception qui vient de se produire. Nous enlevons le premier élement de la pile parce qu'il appartient à l'implémentation d'objet de l'interpréteur. La résultat est écrit par la méthode write().

write(donnees)

Ecrit une chaîne sur le flux d'erreur standard (sys.stderr). Les classes dérivées doivent surcharger cette méthode pour fournir le mode d'affichage souhaité.