[Python Cheatsheet] 58. pdb 심화 - 대화형 디버깅

1
2
3
4
5
6
7
8

# 방법 1: breakpoint() (Python 3.7+, 권장)
breakpoint()

# 방법 2: import pdb
import pdb; pdb.set_trace()

# 방법 3: 명령행에서 실행
# python -m pdb script.py

1
2
3
4
5
6
7

def calculate(x, y):
    result = x + y
    breakpoint()  # 여기서 멈춤
    return result * 2

total = calculate(3, 4)
print(total)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

> script.py(4)calculate()
-> return result * 2
(Pdb) p result
7
(Pdb) p x, y
(3, 4)
(Pdb) n
--Return--
> script.py(4)calculate()->14
(Pdb) c
14

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

def outer():
    x = 10
    inner()

def inner():
    y = 20
    breakpoint()
    print(y)

outer()

1
2
3
4
5
6

(Pdb) l          # 현재 위치 코드 보기
(Pdb) l 1, 10    # 1-10줄 보기
(Pdb) ll         # 현재 함수 전체
(Pdb) w          # 스택 트레이스
(Pdb) u          # 상위 프레임으로
(Pdb) d          # 하위 프레임으로

1
2
3
4
5
6

(Pdb) p variable      # 변수 출력
(Pdb) pp large_dict   # 예쁘게 출력
(Pdb) p type(obj)     # 타입 확인
(Pdb) p dir(obj)      # 속성 목록
(Pdb) p vars(obj)     # __dict__
(Pdb) !x = 10         # 변수 수정 (! 접두사)

1
2
3
4
5
6
7
8

def func_a():
    return func_b()

def func_b():
    return 42

breakpoint()
result = func_a()

1
2
3

(Pdb) n    # func_a() 전체 실행 (안으로 들어가지 않음)
(Pdb) s    # func_a() 안으로 들어감
(Pdb) r    # 현재 함수 끝까지 실행 후 반환

1
2
3
4
5
6
7
8

(Pdb) b 10           # 10번 줄에 중단점
(Pdb) b func_name    # 함수 시작에 중단점
(Pdb) b file.py:20   # 특정 파일의 줄
(Pdb) b              # 모든 중단점 보기
(Pdb) cl 1           # 중단점 1 삭제
(Pdb) cl             # 모든 중단점 삭제
(Pdb) disable 1      # 중단점 1 비활성화
(Pdb) enable 1       # 중단점 1 활성화

1
2
3
4
5
6
7
8
9

(Pdb) b 10, x > 5          # x > 5일 때만 멈춤
(Pdb) b func, len(items) > 100

# 또는 코드에서
def process(items):
    for i, item in enumerate(items):
        if i == 50:  # 50번째에서만
            breakpoint()
        handle(item)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

import pdb

def buggy():
    x = 1
    y = 0
    return x / y  # ZeroDivisionError

try:
    buggy()
except:
    pdb.post_mortem()  # 예외 발생 시점으로

1
2
3

# 또는 명령행에서
# python -m pdb script.py
# 예외 발생 시 자동으로 pdb 진입

1
2
3
4

(Pdb) !import json           # 모듈 import
(Pdb) !result = x + y        # 코드 실행
(Pdb) p json.dumps(data)     # 함수 호출
(Pdb) interact               # 대화형 Python 쉘

1
2
3
4
5
6
7
8
9

import os

# PYTHONBREAKPOINT 환경 변수로 제어
# export PYTHONBREAKPOINT=0  # breakpoint() 무시
# export PYTHONBREAKPOINT=ipdb.set_trace  # ipdb 사용

def debug_code():
    breakpoint()  # PYTHONBREAKPOINT=0이면 무시됨
    print("code")

1
2
3
4
5
6

# pip install remote-pdb
from remote_pdb import set_trace
set_trace(host='0.0.0.0', port=4444)

# 다른 터미널에서:
# telnet 127.0.0.1 4444

1
2
3
4

# ~/.pdbrc
alias pi p dir(%1)
alias pl p locals()
alias pg p globals()

1

pip install pdbpp

1
2
3

# 자동으로 pdb 대체
# 구문 강조, sticky mode 등 제공
breakpoint()

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

# 루프에서 특정 조건일 때만 멈추기
for i in range(1000):
    if i == 500:
        breakpoint()
    process(i)

# 함수 시작점에서 항상 멈추기
def complex_function(data):
    breakpoint()
    # ...

# 예외 직전 상태 확인
try:
    risky_operation()
except Exception:
    import pdb; pdb.set_trace()
    raise

1
2
3

(Pdb) p n        # 'n'이라는 변수? 아니면 next 명령?
(Pdb) p(n)       # 변수 n 출력
(Pdb) !n         # 변수 n 출력

1
2

# 커밋 전 체크
# git diff --staged | grep -E "breakpoint|pdb"