# `codeop` — Compile Python code

Código fuente: Lib/codeop.py

El módulo `codeop` proporciona herramientas para emular el bucle principal del intérprete de Python (también conocido como read-eval-print), tal como se hace en el módulo `code`. Por lo tanto, este módulo no está diseñado para utilizarlo directamente; si desea incluir un ciclo de este tipo en su programa, probablemente es mejor utilizar el módulo `code` en su lugar.

Esta actividad consta de dos partes:

1. Ser capaz de identificar si una línea de entrada completa una sentencia de Python: en resumen, decir si se debe imprimir a continuación “`>>>`” o “`...`”.

2. Recordar qué declaraciones futuras ha ingresado el usuario, para que la entrada posterior puedan ser compiladas con estas en efecto.

El módulo `codeop` proporciona formas de realizar estas dos partes, tanto de forma independiente, como en conjunto.

Para hacer lo anterior:

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

  Intenta compilar source, que debe ser una cadena de caracteres de código Python y retorna un objeto si source es código Python válido. En este caso, el atributo del nombre del archivo del objeto va a ser filename, el cuál por defecto es `'<input>'`. Retorna `None` si source no es código Python válido, pero es un prefijo de código Python válido.

  Si hay un problema con source, se lanzará una excepción. `SyntaxError` se lanza si hay una sintaxis de Python no válida, y `OverflowError` o `ValueError` si hay un literal no válido.

  El argumento symbol determina si source se compila como una declaración (`'single'`, el valor predeterminado), como una secuencia de statement (`'exec'`) o como un expression (`'eval'`). Cualquier otro valor hará que se lance `ValueError`.

  Nota

  Es posible (pero no probable) que el analizador deje de analizar con un resultado exitoso antes de llegar al final de la fuente; en este caso, los símbolos finales pueden ignorarse en lugar de provocar un error. Por ejemplo, una barra invertida seguida de dos nuevas líneas puede ir seguida de basura arbitraria. Esto se solucionará una vez que la API para el analizador sea mejor.

class codeop.Compile

  Las instancias de esta clase tienen métodos `__call__()` idénticos en firma a la función incorporada `compile()`, pero con la diferencia de que si la instancia compila el texto del programa que contiene una instrucción `__future__`, la instancia “recuerda” y compila todos los textos de programa posteriores con la declaración en vigor.

class codeop.CommandCompiler

  Las instancias de esta clase tienen métodos `__call__()` idénticos en firma a `compile_command()`; la diferencia es que si la instancia compila un texto de programa que contiene una declaración `__future__`, la instancia “recuerda” y compila todos los textos de programa posteriores con la declaración en vigor.