# `codeop` — 파이썬 코드 컴파일

소스 코드: 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.

이 작업에는 두 가지 부분이 있습니다:

1. 입력 줄이 파이썬 문장을 완성하는지 알려주는 것: 간단히 말해서, ‘`>>>`’ 나 ‘`...`’ 를 다음에 인쇄할지 알려주기.

2. 사용자가 입력한 퓨처 문을 기억해서, 후속 입력을 컴파일할 때 이것들이 효과가 있도록 하기.

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

단지 전자를 수행하려면:

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

  source를 컴파일하려고 시도합니다. source는 파이썬 코드의 문자열이어야 하며, source가 유효한 파이썬 코드면 코드 객체를 반환합니다. 이 경우, 코드 객체의 filename 어트리뷰트는 filename가 되는데, 기본값은 `'<input>'`입니다. source가 유효한 파이썬 코드가 *아니지만 유효한 파이썬 코드의 앞부분이면 `None`을 반환합니다.

  source에 문제가 있으면, 예외가 발생합니다. 유효하지 않은 파이썬 구문이 있으면 `SyntaxError`가 발생하고, 유효하지 않은 리터럴이 있으면 `OverflowError` 나 `ValueError`가 발생합니다.

  symbol 인자는 source가 문장(`'single'`, 기본값)으로 컴파일되는지, 문장의 시퀀스(`'exec'`)로 컴파일되는지 또는 표현식(`'eval'`)으로 컴파일되는지 결정합니다. 다른 값을 지정하면 `ValueError`가 발생합니다.

  참고

  구문 분석기가 source의 끝에 도달하기 전에 성공적인 결과로 구문 분석을 중지하는 것이 가능합니다 (하지만 대체로 그렇지 않습니다); 이 경우, 뒤따르는 기호는 에러를 유발하는 대신 무시 될 수 있습니다. 예를 들어, 백 슬래시 뒤에 두 개의 개행이 오면 그 뒤에 임의의 가비지가 올 수 있습니다. 구문 분석기를 위한 API가 개선되면 이 문제가 해결될 것입니다.

class codeop.Compile

  이 클래스의 인스턴스는 내장 함수 `compile()`와 같은 서명의 `__call__()` 메서드를 갖지만, 인스턴스가 `__future__` 문을 포함하는 프로그램 텍스트를 컴파일하면 인스턴스가 이를 ‘기억’하고 모든 후속 프로그램 텍스트를 이 문장의 효과 아래에서 컴파일한다는 차이점이 있습니다.

class codeop.CommandCompiler

  이 클래스의 인스턴스는 `compile_command()`와 같은 서명의 `__call__()` 메서드를 갖습니다; 차이점은, 인스턴스가 `__future__` 문을 포함하는 프로그램 텍스트를 컴파일하면 인스턴스가 이를 ‘기억’하고 모든 후속 프로그램 텍스트를 이 문장의 효과 아래에서 컴파일한다는 것입니다.