파이썬의 `breakpoint()`

왜 알아둬야 하나

파이썬 3.7부터 소박한 breakpoint() 호출이 언어에 그대로 들어왔다. 여기저기 import pdb; pdb.set_trace()를 흩뿌릴 필요 없이 디버거로 즉시 들어갈 수 있다. 실행을 멈추고, 이것저것 들여다보고, 아무 일 없었다는 듯 재개하는 가장 빠른 방법이다.

시간을 멈추는 한 줄

def weird_math(x):
    result = (x ** 2) // 3
    breakpoint()          # ↓ 프로그램이 여기서 멈춘다
    return result + 42

스크립트를 실행하면 파이썬이 그 줄에서 익숙한 pdb 프롬프트로 데려다준다. 이제 지역 변수를 확인하고(p locals()), 변수를 바꾸고(x = 99), 한 줄씩 진행하거나(n / s) 계속 실행할 수 있다(c).

팁: 탐색용 코드에는 breakpoint()를 마음껏 뿌려도 되고, 나중에 import 정리 없이 그냥 지우면 된다.

pdb / ipdb 명령어 치트시트

아래는 간결하지만 빠짐없는 참고표다.

팁: 어떤 명령이든 앞에 반복 횟수를 붙일 수 있다. 10 n은 열 줄을 건너뛰고, 2 u는 두 프레임을 올라간다.

내부에서 벌어지는 일

breakpoint()는 그저 sys.breakpointhook()를 호출할 뿐이고, 기본 구현이 pdb를 띄운다. 그래서 이런 게 가능하다:

• 모든 breakpoint을 동적으로 비활성화:

  export PYTHONBREAKPOINT=0      # POSIX 셸
  set PYTHONBREAKPOINT=0         # 윈도우 cmd
  

  모든 breakpoint()가 아무 일도 하지 않게 된다. CI 파이프라인에서 유용하다.

• 다른 디버거로 교체 (예: ipdb, pudb, web-pdb):

  export PYTHONBREAKPOINT=ipdb.set_trace
  

  이제 같은 코드 줄이 소스 파일을 건드리지 않고도 원하는 디버거를 연다.

• 런타임에 커스텀 훅 제공:

  import sys, logging
  def log_only(*args, **kwargs):
      logging.warning("breakpoint() hit!")
  sys.breakpointhook = log_only
  

실제로 쓰게 되는 응용 기법