codeop — Compilation de code Python

Code source : Lib/codeop.py

Le module codeop fournit des outils permettant d'émuler une boucle de lecture-évaluation-affichage (en anglais read-eval-print-loop ou REPL), comme dans le module code. Par conséquent, ce module n'est pas destiné à être utilisé directement ; pour inclure un REPL dans un programme, il est préférable d'utiliser le module code.

Cette tâche se divise en deux parties :

  1. Being able to tell if a line of input completes a Python statement: in short, telling whether to print '>>>' or '...' next.

  2. Remembering which future statements the user has entered, so subsequent input can be compiled with these in effect.

Le module codeop fournit un moyen d'effectuer ces deux parties, individuellement ou simultanément.

Pour ne faire que la première partie :

codeop.compile_command(source, filename='<input>', symbol='single')

Tries to compile source, which should be a string of Python code and return a code object if source is valid Python code. In that case, the filename attribute of the code object will be filename, which defaults to '<input>'. Returns None if source is not valid Python code, but is a prefix of valid Python code.

En cas de problème avec source, une exception est levée ; SyntaxError si la syntaxe Python est incorrecte, et OverflowError ou ValueError si un littéral invalide est rencontré.

The symbol argument determines whether source is compiled as a statement ('single', the default), as a sequence of statement ('exec') or as an expression ('eval'). Any other value will cause ValueError to be raised.

Note

Il est possible (quoique improbable) que l'analyseur s'arrête avant d'atteindre la fin du code source ; dans ce cas, les symboles venant après peuvent être ignorés au lieu de provoquer une erreur. Par exemple, une barre oblique inverse suivie de deux retours à la ligne peut être suivie par de la mémoire non-initialisée. Ceci sera corrigé quand l'interface de l'analyseur aura été améliorée.

class codeop.Compile

Les instances de cette classe ont des méthodes __call__() de signature identique à la fonction native compile(), à la différence près que si l'instance compile du code source contenant une instruction __future__, l'instance s'en « souviendra » et compilera tous les codes sources suivants avec cette instruction activée.

class codeop.CommandCompiler

Instances of this class have __call__() methods identical in signature to compile_command(); the difference is that if the instance compiles program text containing a __future__ statement, the instance 'remembers' and compiles all subsequent program texts with the statement in force.