"codeop" --- 파이썬 코드 컴파일
*******************************

**소스 코드:** Lib/codeop.py

======================================================================

"codeop" 모듈은 "code" 모듈에서와같이 파이썬 읽기-평가-인쇄 루프를 에
뮬레이트 할 수 있는 유틸리티를 제공합니다. 결과적으로, 모듈을 직접 사
용하고 싶지 않을 것입니다; 여러분의 프로그램에 이러한 루프를 포함 시키
려면 대신 "code" 모듈을 사용하는 것이 좋습니다.

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

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

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

"codeop" 모듈은 이들을 각각 수행하는 방법과 이들을 모두 수행하는 방법
을 제공합니다.

단지 전자를 수행하려면:

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

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

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

   The *symbol* argument determines whether *source* is compiled as a
   statement ("'single'", the default), as a sequence of statements
   ("'exec'") or as an *expression* ("'eval'").  Any other value will
   cause "ValueError" to  be raised.

   참고:

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

class codeop.Compile

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

class codeop.CommandCompiler

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