traceback

Модуль используется для сбора и вывода трассировочной информации о программе после появления исключения. Функции в этом модуле оперируют объектами с трассировочной информацией, такими как в третьем элементе возвращаемого значения функции sys.exc_info(). В основном этот модуль может использоваться для реализации нестандартного способа вывода сообщений об ошибках, например когда программы на языке Python выполняются глубоко в недрах сетевого сервера и необходимо организовать вывод трассировочной информации в файл журнала.

traceback.print_tb(traceback[, limit[, file]])
Parameters
  • traceback – трассировочный объект

  • limit – количество выводимой информации

  • file – файл вывода, по дефолту sys.stderr

Выводит трассировочную информацию.

traceback.print_exception(type, value, traceback[, limit[, file]])
Parameters
  • type – тип исключения

  • value – значение исключения

  • traceback – трассировочный объект

  • limit – количество выводимой информации

  • file – файл вывода, по дефолту sys.stderr

Выводит в файл информацию об исключении и трассировочную информацию.

traceback.print_exc([limit[, file]])
Parameters
  • limit – количество выводимой информации

  • file – файл вывода, по дефолту sys.stderr

То же, что и print_exception(), но применяется к информации, возвращаемой функцией sys.exc_info().

traceback.format_exc([limit[, file]])
Parameters
  • limit – количество выводимой информации

  • file – файл вывода, по дефолту sys.stderr

Возвращает строку, содержащую ту же информацию, которую выводит функция print_exc().

traceback.print_last([limit[, file]])
Parameters
  • limit – количество выводимой информации

  • file – файл вывода, по дефолту sys.stderr

То же, что и print_exception(sys.last_type, sys.last_value, sys.last_traceback, limit, file).

traceback.print_stack([frame[, limit[, file]]])
Parameters
  • frame – начальный кадр стека

  • limit – количество выводимой информации

  • file – файл вывода, по дефолту sys.stderr

Выводит трассировочную информацию для точки, откуда был сделан вызов функции.

traceback.extract_tb(traceback[, limit])
Parameters
  • traceback – трассировочный объект

  • limit – количество выводимой информации

Извлекает ту же трассировочную информацию, что и функция print_tb(). Возвращает список кортежей вида (filename, line, funcname, text), содержащих информацию, которая обычно выводится в сообщениях об ошибках.

traceback.extract_stack([frame[, limit]])
Parameters
  • frame – кадр стека

  • limit – количество выводимой информации

Извлекает ту же трассировочную информацию, что и функция print_stack(), но извлекает ее из кадра стека frame.

traceback.format_list(list)
Parameters

list – список кортежей, возвращаемый функцией extract_tb() или extract_stack()

Форматирует трассировочную информацию перед выводом.

traceback.format_exception_only(type, value)
Parameters
  • type – тип исключения

  • value – значение исключения

Форматирует информацию об исключении перед выводом.

traceback.format_exception(type, value, traceback[, limit])
Parameters
  • type – тип исключения

  • value – значение исключения

  • traceback – трассировочный объект

  • limit – количество выводимой информации

Форматирует трассировочную информацию и информацию об исключении перед выводом.

traceback.format_tb(traceback[, limit])
Parameters
  • traceback – трассировочный объект

  • limit – количество выводимой информации

То же, что и format_list(extract_tb(traceback, limit)).

traceback.format_stack([frame[, limit]])
Parameters
  • frame – кадр стека

  • limit – количество выводимой информации

То же, что и format_list(extract_stack(frame, limit)).

traceback.tb_lineno(traceback)
Parameters

traceback – трассировочный объект

Возвращает номер строки, установленной в объекте с трассировочной информацией.