Модуль pdb определяет интерактивный отладчик исходного кода для программ Python. Он поддерживает установку условных точек останова и пошаговое выполнение на уровне строки исходного кода, проверку стековых фреймов, листинг исходного кода и оценку произвольного кода Python в контексте любого стекового фрейма. Он также поддерживает посмертную отладку и может вызываться под управлением программы.
Отладчик является расширяемым - он фактически определяется как класс pdb.Pdb().
Типичное использование для запуска программы под управлением отладчика:
>>> import pdb >>> import mymodule >>> pdb.run('mymodule.test()') # > <string>(0)?() # (Pdb) continue # > <string>(1)?() # (Pdb) continue # NameError: 'spam' # > <string>(1)?() # (Pdb)
Модуль pdb также может быть вызван как скрипт для отладки других скриптов.
python3 -m pdb myscript.py
При вызове в виде сценария модуль pdb автоматически запускает post-mortem отладку, если отлаживаемая программа завершает работу ненормально. После post-mortem отладки или после обычного выхода из программы, модуль pdb перезапустит программу. Автоматический перезапуск сохраняет состояние pdb, например точки останова и в большинстве случаев более полезен, чем выход из отладчика при выходе из программы.
Типичное использование pdb.set_trace() для взлома отладчика из запущенной программы:
import pdb class MyClass(): def __init__(self, loops): self.count = loops def start(self): for i in range(self.count): pdb.set_trace() print(i) return if __name__ == '__main__': MyClass(5).start()
Затем вы можете пройти по коду после pdb.set_trace() и продолжить работу без отладчика, используя команду continue.
Для команд и аргументов команд доступно завершение табуляции через модуль readline, например в качестве аргументов команды p предлагаются текущие глобальные и локальные имена.
$ python3 test.py > /home/docs-python/test.py(10)start() -> print(i) (Pdb) p MyClass <class '__main__.MyClass'> (Pdb) p MyClass.start <function MyClass.start at 0x7f623f0502f0> (Pdb) p MyClass(2).start() 0 1 None (Pdb)
Встроенная функция breakpoint() при вызове со значениями по умолчанию может использоваться вместо import pdb; pdb.set_trace().
Типичное использование для проверки сбойной программы:
>>> import pdb >>> import mymodule >>> mymodule.test() # Traceback (most recent call last): # File "<stdin>", line 1, in <module> # File "./mymodule.py", line 4, in test # test2() # File "./mymodule.py", line 3, in test2 # print(spam) # NameError: spam >>> pdb.pm() # > ./mymodule.py(3)test2() # -> print(spam) # (Pdb)