code
— Clases básicas de intérpretes¶
Código fuente:: Lib/code.py
El módulo de code
proporciona facilidades para implementar bucles de lectura-evaluación-impresión en Python. Se incluyen dos clases y funciones de conveniencia que se pueden usar para crear aplicaciones que brinden un prompt interactivo del intérprete.
-
class
code.
InteractiveInterpreter
(locals=None)¶ Esta clase se ocupa del estado del intérprete y del análisis sintáctico (el espacio de nombres del usuario); no se ocupa del almacenamiento en búfer de entrada o de la solicitud o la denominación de archivos de entrada (el nombre de archivo siempre se pasa explícitamente). El argumento opcional locals especifica el diccionario en el que se ejecutará el código; por defecto es un diccionario recién creado con la clave
'__name __'
establecida en'__console __'
y la clave'__doc __'
enNone
.
-
class
code.
InteractiveConsole
(locals=None, filename="<console>")¶ Emula estrictamente el comportamiento del intérprete interactivo de Python. Esta clase se basa en
InteractiveInterpreter
y agrega solicitudes y búfer de entrada usando los conocidossys.ps1
ysys.ps2
.
-
code.
interact
(banner=None, readfunc=None, local=None, exitmsg=None)¶ Función de conveniencia para ejecutar un ciclo de lectura-evaluación-impresión (read-eval-print). Esto crea una nueva instancia de
InteractiveConsole
y establece readfunc -si se proporciona- para ser utilizado como el métodoInteractiveConsole.raw_input()
. Si se proporciona local, se pasa al constructorInteractiveConsole
para usarlo como el espacio de nombres predeterminado para el bucle del intérprete. El métodointeract()
de la instancia se ejecuta con banner y exitmsg, estos se pasan como bandera y mensaje de salida para usar nuevamente, si se proporciona. El objeto de la consola se descarta después de su uso.Distinto en la versión 3.6: Se agregó el parámetro exitmsg.
-
code.
compile_command
(source, filename="<input>", symbol="single")¶ Esta función es útil para programas que desean emular el bucle principal del intérprete de Python (también conocido como bucle read-eval-print). La parte complicada es determinar cuándo el usuario ha ingresado un comando incompleto que se puede completar ingresando más texto (en lugar de un comando completo o un error de sintaxis). Esta función casi siempre toma la misma decisión que el bucle principal del intérprete real.
source is the source string; filename is the optional filename from which source was read, defaulting to
'<input>'
; and symbol is the optional grammar start symbol, which should be'single'
(the default),'eval'
or'exec'
.Retorna un objeto de código (lo mismo que
compile(source, filename, symbol)
) si el comando está completo y es válido;None
si el comando está incompleto; lanzaSyntaxError
si el comando está completo y contiene un error de sintaxis, o lanzaOverflowError
oValueError
si el comando contiene un literal no válido.
Objetos de intérprete interactivo¶
-
InteractiveInterpreter.
runsource
(source, filename="<input>", symbol="single")¶ Compila y ejecuta alguna fuente en el intérprete. Los argumentos son los mismos que para
compile_command()
; el valor predeterminado para filename es'<input>'
, y para symbol es'single'
. Puede suceder una de varias cosas:La entrada es incorrecta;
compile_command()
generó una excepción (SyntaxError
oOverflowError
). Se imprime un seguimiento de sintaxis llamando al métodoshowsyntaxerror()
.runsource()
retornaFalse
.La entrada está incompleta y se requiere más información;
compile_command()
retornaNone
.runsource()
retornaTrue
.La entrada está completa;
compile_command()
retornó un objeto de código. El código se ejecuta llamando aruncode()
(que también maneja excepciones en tiempo de ejecución, exceptoSystemExit
).runsource()
retornaFalse
.
El valor de retorno se puede usar para decidir si usar
sys.ps1
osys.ps2
para solicitar la siguiente línea.
-
InteractiveInterpreter.
runcode
(code)¶ Ejecuta un objeto de código. Cuando ocurre una excepción, se llama a
showtraceback()
para mostrar un seguimiento del código. Se capturan todas las excepciones exceptoSystemExit
, que puede propagarse.Una nota sobre
KeyboardInterrupt
: esta excepción puede ocurrir en otra parte de este código y no siempre se detecta. Quien llama la función debe estar preparado para manejar esto.
-
InteractiveInterpreter.
showsyntaxerror
(filename=None)¶ Muestra el error de sintaxis que acaba de ocurrir. Esto no muestra la traza de seguimiento porque no la hay para errores de sintaxis. Si se proporciona filename, se incluirá en la excepción en lugar del nombre de archivo predeterminado proporcionado por el analizador de Python, ya que siempre usa
'<string>'
cuando lee de una cadena de caracteres. La salida se escribe mediante el métodowrite()
.
-
InteractiveInterpreter.
showtraceback
()¶ Muestra la excepción que acaba de ocurrir. Eliminamos el primer elemento de la pila porque está dentro de la implementación del intérprete. La salida se escribe mediante el método
write()
.Distinto en la versión 3.5: Se muestra la traza de seguimiento encadenada completa en lugar de solo la traza primaria de pila.
-
InteractiveInterpreter.
write
(data)¶ Escribe una cadena de caracteres en el flujo de error estándar (
sys.stderr
). Las clases derivadas deben reemplazar esto para proporcionar el manejo de salida apropiado según sea necesario.
Objetos de consola interactiva¶
La clase InteractiveConsole
es una subclase de InteractiveInterpreter
, por lo que ofrece todos los métodos de los objetos del intérprete, así como las siguientes adiciones.
-
InteractiveConsole.
interact
(banner=None, exitmsg=None)¶ Emula estrictamente la consola interactiva de Python. El argumento opcional banner especifica la bandera a imprimir antes de la primera interacción; de forma predeterminada, imprime una bandera similar al impreso por el intérprete estándar de Python, seguido del nombre de clase del objeto de la consola entre paréntesis (para no confundir esto con el intérprete real, ¡ya que está muy cerca!)
El argumento opcional exitmsg especifica un mensaje de salida que se imprime al salir. Pase la cadena de caracteres vacía para suprimir el mensaje de salida. Si no se proporciona exitmsg o es
None
, se imprime el mensaje predeterminado.Distinto en la versión 3.4: Para suprimir la impresión de cualquier bandera, pase una cadena de caracteres vacía.
Distinto en la versión 3.6: Imprime un mensaje de salida al salir.
-
InteractiveConsole.
push
(line)¶ Envía una línea de texto fuente al intérprete. La línea no debe tener un salto de línea al final; puede tener nuevas líneas internas. La línea se agrega a un búfer y se llama al método
runsource()
del intérprete con el contenido concatenado del búfer y la nueva fuente. Si indica que el comando se ejecutó o no es válido, el búfer se restablece; de lo contrario, el comando está incompleto y el búfer se deja como estaba después de agregar la línea. Si se requieren más entradas el valor de retorno esTrue
,False
si la línea se procesó de alguna manera (esto es lo mismo querunsource()
).
-
InteractiveConsole.
resetbuffer
()¶ Elimina cualquier texto fuente no gestionado del búfer de entrada.
-
InteractiveConsole.
raw_input
(prompt="")¶ Escribe un prompt y lee una línea. La línea retornada no incluye el salto de línea final. Cuando el usuario ingresa la secuencia de teclas EOF, se lanza
OFError
. La implementación base lee desys.stdin
; una subclase puede reemplazar esto con una implementación diferente.