# `codeop` — Compila código Python

Código-fonte: Lib/codeop.py

The `codeop` module provides utilities upon which the Python read-eval-print loop can be emulated, as is done in the `code` module. As a result, you probably don’t want to use the module directly; if you want to include such a loop in your program you probably want to use the `code` module instead.

Há duas partes para esta tarefa:

1. Ser capaz de dizer se uma linha de entrada completa uma instrução Python: em suma, dizer se deve exibir ‘`>>>`’ ou ‘`...`’ em seguida.

2. Lembrar quais instruções futuras o usuário inseriu, para que as entradas subsequentes possam ser compiladas com essas declarações em vigor.

The `codeop` module provides a way of doing each of these things, and a way of doing them both.

Para fazer apenas a primeira:

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

  Tenta compilar source, que deve ser uma string de código Python e retornar um objeto código se source for um código Python válido. Nesse caso, o atributo de nome de arquivo do objeto código será filename, cujo padrão é `'<input>'`. Retorna `None` se source não é um código Python válido, mas é um prefixo de código Python válido.

  Se houver um problema com source, uma exceção será levantada. `SyntaxError` é levantada se houver sintaxe Python inválida, e `OverflowError` ou `ValueError` se houver um literal inválido.

  O argumento symbol determina se source é compilado como uma instrução (`'single'`, o padrão), como uma sequência de instruções (`'exec'`) ou como uma expressão (`'eval'`). Qualquer outro valor fará com que `ValueError` seja levantada.

  Nota

  É possível (mas não provável) que o analisador sintático pare de analisar com um resultado bem-sucedido antes de chegar ao final da fonte; neste caso, os símbolos finais podem ser ignorados em vez de causar um erro. Por exemplo, uma barra invertida seguida por duas novas linhas pode ser seguida por lixo arbitrário. Isso será corrigido quando a API para o analisador for melhor.

class codeop.Compile

  Instâncias desta classe têm métodos `__call__()` idênticos em assinatura à função embutida `compile()`, mas com a diferença de que se a instância compilar o texto do programa contendo uma instrução `__future__`, a instância se “lembra” e compila todos os textos de programa subsequentes com a instrução em vigor.

class codeop.CommandCompiler

  Instâncias desta classe têm métodos `__call__()` idênticos em assinatura a `compile_command()`; a diferença é que se a instância compila o texto do programa contendo uma instrução `__future__`, a instância se “lembra” e compila todos os textos do programa subsequentes com a instrução em vigor.