"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.
