bdb
— 디버거 프레임워크¶
소스 코드: Lib/bdb.py
bdb
모듈은 중단점 설정이나 디버거를 통한 실행 관리와 같은 기본 디버거 기능을 처리합니다.
다음 예외가 정의됩니다:
bdb
모듈은 또한 두 가지 클래스를 정의합니다:
-
class
bdb.
Breakpoint
(self, file, line, temporary=False, cond=None, funcname=None)¶ 이 클래스는 임시 중단점, 무시 카운트, 비활성화와 (재) 활성화 및 조건을 구현합니다.
중단점은
bpbynumber
라는 리스트를 통해 번호로,bplist
를 통해(file, line)
쌍으로 인덱싱됩니다. 전자는Breakpoint
클래스의 단일 인스턴스를 가리킵니다. 후자는 줄당 하나 이상의 중단점이 있을 수 있어서 이러한 인스턴스의 리스트를 가리킵니다.When creating a breakpoint, its associated
file name
should be in canonical form. If afuncname
is defined, a breakpointhit
will be counted when the first line of that function is executed. Aconditional
breakpoint always counts ahit
.Breakpoint
인스턴스에는 다음과 같은 메서드가 있습니다:-
deleteMe
()¶ file/line과 관련된 리스트에서 중단점을 삭제합니다. 해당 위치의 마지막 중단점이면, file/line의 항목도 삭제합니다.
-
enable
()¶ 중단점을 활성화된 것으로 표시합니다.
-
disable
()¶ 중단점을 비활성화된 것으로 표시합니다.
-
bpformat
()¶ 멋지게 포맷된, 중단점에 대한 모든 정보가 포함된 문자열을 반환합니다:
Breakpoint number.
Temporary status (del or keep).
File/line position.
Break condition.
Number of times to ignore.
Number of times hit.
버전 3.2에 추가.
-
bpprint
(out=None)¶ bpformat()
의 출력을 파일 out, 또는None
이면 표준 출력으로 인쇄합니다.
Breakpoint
instances have the following attributes:-
file
¶ File name of the
Breakpoint
.
-
line
¶ Line number of the
Breakpoint
withinfile
.
-
temporary
¶ True if a
Breakpoint
at (file, line) is temporary.
-
cond
¶ Condition for evaluating a
Breakpoint
at (file, line).
-
funcname
¶ Function name that defines whether a
Breakpoint
is hit upon entering the function.
-
enabled
¶ True if
Breakpoint
is enabled.
-
bpbynumber
¶ Numeric index for a single instance of a
Breakpoint
.
-
bplist
¶ Dictionary of
Breakpoint
instances indexed by (file
,line
) tuples.
-
ignore
¶ Number of times to ignore a
Breakpoint
.
-
hits
¶ Count of the number of times a
Breakpoint
has been hit.
-
-
class
bdb.
Bdb
(skip=None)¶ Bdb
클래스는 범용 파이썬 디버거 베이스 클래스 역할을 합니다.이 클래스는 추적 기능의 세부 사항을 처리합니다; 파생 클래스는 사용자 상호 작용을 구현해야 합니다. 표준 디버거 클래스 (
pdb.Pdb
)가 예입니다.skip 인자는, 주어지면, glob 스타일 모듈 이름 패턴의 이터러블 이어야 합니다. 디버거는 이러한 패턴 중 하나와 일치하는 모듈에서 시작되는 프레임으로 들어가지 않습니다. 프레임을 특정 모듈에서 시작된 것으로 간주하는지는 프레임 전역의
__name__
에 의해 결정됩니다.버전 3.1에 추가: skip 인자
Bdb
의 다음 메서드는 일반적으로 재정의할 필요가 없습니다.-
canonic
(filename)¶ Return canonical form of filename.
For real file names, the canonical form is an operating-system-dependent,
case-normalized
absolute path
. A filename with angle brackets, such as"<stdin>"
generated in interactive mode, is returned unchanged.
-
reset
()¶ 디버깅을 시작할 준비가 된 값으로
botframe
,stopframe
,returnframe
및quitting
어트리뷰트를 설정합니다.
-
trace_dispatch
(frame, event, arg)¶ 이 함수는 디버그되는 프레임의 추적 함수(trace function)로 설치됩니다. 반환 값은 새로운 추적 함수(대부분 자체)입니다.
기본 구현은 실행되려고 하는 (문자열로 전달된) 이벤트의 유형에 따라 프레임을 디스패치 하는 방법을 결정합니다. event는 다음 중 하나일 수 있습니다:
"line"
: 새로운 코드 줄이 실행되려고 합니다."call"
: 함수가 호출되거나, 다른 코드 블록에 진입하려고 합니다."return"
: 함수나 다른 코드 블록이 반환하려고 합니다."exception"
: 예외가 발생했습니다."c_call"
: C 함수가 호출되려고 합니다."c_return"
: C 함수가 반환했습니다."c_exception"
: C 함수가 예외를 발생시켰습니다.
파이썬 이벤트의 경우, 특수 함수(아래를 참조하세요)가 호출됩니다. C 이벤트의 경우, 아무런 액션도 취하지 않습니다.
arg 매개 변수는 앞의 이벤트에 따라 다릅니다.
추적 함수에 대한 자세한 내용은
sys.settrace()
설명서를 참조하십시오. 코드와 프레임 객체에 대한 자세한 내용은 표준형 계층을 참조하십시오.
-
dispatch_line
(frame)¶ 디버거가 현재 행에서 중지해야 하면,
user_line()
메서드를 호출하십시오 (서브 클래스에서 재정의되어야 합니다).Bdb.quitting
플래그가 설정되면 (user_line()
에서 설정할 수 있습니다)BdbQuit
예외를 발생시킵니다. 해당 스코프에서 추가 추적을 위해trace_dispatch()
메서드에 대한 참조를 반환합니다.
-
dispatch_call
(frame, arg)¶ 디버거가 이 함수 호출에서 중지해야 하면,
user_call()
메서드를 호출하십시오 (서브 클래스에서 재정의되어야 합니다).Bdb.quitting
플래그가 설정되면 (user_call()
에서 설정할 수 있습니다)BdbQuit
예외를 발생시킵니다. 해당 스코프에서 추가 추적을 위해trace_dispatch()
메서드에 대한 참조를 반환합니다.
-
dispatch_return
(frame, arg)¶ 디버거가 이 함수 반환에서 중지해야 하면,
user_return()
메서드를 호출하십시오 (서브 클래스에서 재정의되어야 합니다).Bdb.quitting
플래그가 설정되면 (user_return()
에서 설정할 수 있습니다)BdbQuit
예외를 발생시킵니다. 해당 스코프에서 추가 추적을 위해trace_dispatch()
메서드에 대한 참조를 반환합니다.
-
dispatch_exception
(frame, arg)¶ 디버거가 이 예외에서 중지해야 하면,
user_exception()
메서드를 호출하십시오 (서브 클래스에서 재정의되어야 합니다).Bdb.quitting
플래그가 설정되면 (user_exception()
에서 설정할 수 있습니다)BdbQuit
예외를 발생시킵니다. 해당 스코프에서 추가 추적을 위해trace_dispatch()
메서드에 대한 참조를 반환합니다.
일반적으로 파생된 클래스는 다음 메서드를 재정의하지 않지만, 중지와 중단점의 정의를 재정의하려고 하면 그럴 수 있습니다.
-
is_skipped_line
(module_name)¶ Return True if module_name matches any skip pattern.
-
stop_here
(frame)¶ Return True if frame is below the starting frame in the stack.
-
break_here
(frame)¶ Return True if there is an effective breakpoint for this line.
Check whether a line or function breakpoint exists and is in effect. Delete temporary breakpoints based on information from
effective()
.
-
break_anywhere
(frame)¶ Return True if any breakpoint exists for frame’s filename.
파생 클래스는 디버거 연산을 제어하기 위해 이 메서드를 재정의해야 합니다.
-
user_call
(frame, argument_list)¶ Called from
dispatch_call()
if a break might stop inside the called function.
-
user_line
(frame)¶ Called from
dispatch_line()
when eitherstop_here()
orbreak_here()
returnsTrue
.
-
user_return
(frame, return_value)¶ Called from
dispatch_return()
whenstop_here()
returnsTrue
.
-
user_exception
(frame, exc_info)¶ Called from
dispatch_exception()
whenstop_here()
returnsTrue
.
-
do_clear
(arg)¶ 중단점이 일시적일 때 중단점을 제거하는 방법을 처리합니다.
이 메서드는 파생 클래스에서 구현해야 합니다.
파생 클래스와 클라이언트는 다음 메서드를 호출하여 스테핑(stepping) 상태에 영향을 줄 수 있습니다.
-
set_step
()¶ 한 줄의 코드 후에 멈춥니다.
-
set_next
(frame)¶ 주어진 프레임 내 또는 아래의 다음 줄에서 멈춥니다.
-
set_return
(frame)¶ 주어진 프레임에서 반환할 때 멈춥니다.
-
set_until
(frame, lineno=None)¶ Stop when the line with the lineno greater than the current one is reached or when returning from current frame.
-
set_trace
([frame])¶ frame에서 디버깅을 시작합니다. frame을 지정하지 않으면 호출자의 프레임에서 디버깅을 시작합니다.
-
set_continue
()¶ 중단점에서나 완료 시에만 멈춥니다. 중단점이 없으면, 시스템 추적 함수를
None
으로 설정합니다.
파생 클래스와 클라이언트는 다음 메서드를 호출하여 중단점을 조작할 수 있습니다. 이 메서드는 문제가 발생하면 에러 메시지가 포함된 문자열을 반환하고, 모두 정상이면
None
을 반환합니다.-
set_break
(filename, lineno, temporary=False, cond=None, funcname=None)¶ 새로운 중단점을 설정합니다. 인자로 전달된 filename에 lineno 줄이 없으면 에러 메시지를 반환합니다.
canonic()
메서드에 설명된 대로 filename은 규범적 형식이어야 합니다.
-
clear_break
(filename, lineno)¶ Delete the breakpoints in filename and lineno. If none were set, return an error message.
-
clear_bpbynumber
(arg)¶ Breakpoint.bpbynumber
에서 인덱스 arg인 중단점을 삭제합니다. arg가 숫자가 아니거나 범위를 벗어나면, 에러 메시지를 반환합니다.
-
clear_all_file_breaks
(filename)¶ Delete all breakpoints in filename. If none were set, return an error message.
-
clear_all_breaks
()¶ Delete all existing breakpoints. If none were set, return an error message.
-
get_bpbynumber
(arg)¶ 주어진 숫자로 지정된 중단점을 반환합니다. arg가 문자열이면, 숫자로 변환됩니다. arg가 숫자가 아닌 문자열이면, 지정된 중단점이 존재하지 않거나 삭제되었으면,
ValueError
가 발생합니다.버전 3.2에 추가.
-
get_break
(filename, lineno)¶ Return True if there is a breakpoint for lineno in filename.
-
get_breaks
(filename, lineno)¶ filename의 lineno에 있는 모든 중단점을 반환하거나, 없으면 빈 리스트를 반환합니다.
-
get_file_breaks
(filename)¶ filename의 모든 중단점을 반환하거나, 없으면 빈 리스트를 반환합니다.
-
get_all_breaks
()¶ 설정된 모든 중단점을 반환합니다.
파생 클래스와 클라이언트는 다음 메서드를 호출하여 스택 추적을 나타내는 데이터 구조를 얻을 수 있습니다.
-
get_stack
(f, t)¶ Return a list of (frame, lineno) tuples in a stack trace, and a size.
The most recently called frame is last in the list. The size is the number of frames below the frame where the debugger was invoked.
-
format_stack_entry
(frame_lineno, lprefix=': ')¶ Return a string with information about a stack entry, which is a
(frame, lineno)
tuple. The return string contains:The canonical filename which contains the frame.
The function name or
"<lambda>"
.입력 인자.
반환 값.
코드 줄 (있으면).
클라이언트가 문자열로 지정된 statement를 디버깅하기 위해 디버거를 사용하려면 다음 두 가지 메서드를 호출할 수 있습니다.
-
run
(cmd, globals=None, locals=None)¶ exec()
함수를 통해 실행된 문장을 디버그합니다. globals의 기본값은__main__.__dict__
이고, locals의 기본값은 globals입니다.
-
runeval
(expr, globals=None, locals=None)¶ eval()
함수를 통해 실행된 표현식을 디버그합니다. globals와 locals는run()
과 같은 의미입니다.
-
runcall
(func, /, *args, **kwds)¶ 단일 함수 호출을 디버그하고, 결과를 반환합니다.
-
마지막으로, 모듈은 다음과 같은 함수를 정의합니다:
-
bdb.
checkfuncname
(b, frame)¶ Return True if we should break here, depending on the way the
Breakpoint
b was set.If it was set via line number, it checks if
b.line
is the same as the one in frame. If the breakpoint was set viafunction name
, we have to check we are in the right frame (the right function) and if we are on its first executable line.
-
bdb.
effective
(file, line, frame)¶ Return
(active breakpoint, delete temporary flag)
or(None, None)
as the breakpoint to act upon.The active breakpoint is the first entry in
bplist
for the (file
,line
) (which must exist) that isenabled
, for whichcheckfuncname()
is True, and that has neither a Falsecondition
nor positiveignore
count. The flag, meaning that a temporary breakpoint should be deleted, is False only when thecond
cannot be evaluated (in which case,ignore
count is ignored).If no such entry exists, then (None, None) is returned.