Как обрабатывать сбои тестов

Переход в pdb при сбоях

В Python есть встроенный отладчик под названием pdb. pytest позволяет перейти к приглашению pdb с помощью параметра командной строки:

pytest --pdb

Это запустит отладчик Python при каждом сбое (или прерывании с клавиатуры). Часто требуется сделать это только при первом сбое теста, чтобы разобраться в конкретной ситуации:

pytest -x --pdb   # drop to PDB on first failure, then end test session
pytest --pdb --maxfail=3  # drop to PDB for first three failures

Обратите внимание: при любом сбое информация об исключении сохраняется в sys.last_value, sys.last_type и sys.last_traceback. В интерактивном режиме это позволяет перейти к отладке после сбоя с помощью любого отладчика. Также можно вручную получить доступ к информации об исключении, например:

>>> import sys
>>> sys.last_traceback.tb_lineno
42
>>> sys.last_value
AssertionError('assert result == "ok"',)

Переход в pdb в начале теста

pytest позволяет сразу перейти к приглашению pdb в начале каждого теста с помощью параметра командной строки:

pytest --trace

Это запустит отладчик Python в начале каждого теста.

Установка точек останова

Чтобы установить точку останова в коде, используйте встроенный вызов Python import pdb;pdb.set_trace(): pytest автоматически отключит перехват вывода для этого теста:

• Перехват вывода в остальных тестах не затрагивается.
• Вывод предыдущего теста, который уже был перехвачен, будет обработан соответствующим образом.
• Перехват вывода возобновится после завершения сеанса отладчика (с помощью команды continue).

Использование встроенной функции breakpoint

В Python 3.7 появилась встроенная функция breakpoint(). Pytest поддерживает использование breakpoint() со следующими особенностями:

• Когда вызывается breakpoint(), а для PYTHONBREAKPOINT задано значение по умолчанию, pytest использует собственный интерфейс отладки PDB вместо системного интерфейса Pdb по умолчанию.
• После завершения тестов система возвращается к системному интерфейсу трассировки Pdb.
• Если передать pytest параметр --pdb, собственный интерфейс трассировки Pdb будет использоваться как для breakpoint(), так и для неудачных тестов и необработанных исключений.
• Параметр --pdbcls позволяет указать пользовательский класс отладчика.