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가 발생하고, 유효하지 않은 리터럴이 있으면 OverflowErrorValueError가 발생합니다.

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

참고

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

class codeop.Compile

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

class codeop.CommandCompiler

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