Модуль используется для сбора и вывода трассировочной информации о программе после появления исключения. Функции в этом модуле оперируют объектами с трассировочной информацией, такими как в третьем элементе возвращаемого значения функции sys.exc_info(). В основном этот модуль может использоваться для реализации нестандартного способа вывода сообщений об ошибках, например когда программы на языке Python выполняются глубоко в недрах сетевого сервера и необходимо организовать вывод трассировочной информации в файл журнала.
traceback.
print_tb
(traceback[, limit[, file]])traceback – трассировочный объект
limit – количество выводимой информации
file – файл вывода, по дефолту sys.stderr
Выводит трассировочную информацию.
traceback.
print_exception
(type, value, traceback[, limit[, file]])type – тип исключения
value – значение исключения
traceback – трассировочный объект
limit – количество выводимой информации
file – файл вывода, по дефолту sys.stderr
Выводит в файл информацию об исключении и трассировочную информацию.
traceback.
print_exc
([limit[, file]])limit – количество выводимой информации
file – файл вывода, по дефолту sys.stderr
То же, что и print_exception()
, но применяется к информации, возвращаемой функцией sys.exc_info().
traceback.
format_exc
([limit[, file]])limit – количество выводимой информации
file – файл вывода, по дефолту sys.stderr
Возвращает строку, содержащую ту же информацию, которую выводит функция print_exc()
.
traceback.
print_last
([limit[, file]])limit – количество выводимой информации
file – файл вывода, по дефолту sys.stderr
То же, что и print_exception(sys.last_type, sys.last_value, sys.last_traceback, limit, file).
traceback.
print_stack
([frame[, limit[, file]]])frame – начальный кадр стека
limit – количество выводимой информации
file – файл вывода, по дефолту sys.stderr
Выводит трассировочную информацию для точки, откуда был сделан вызов функции.
traceback.
extract_tb
(traceback[, limit])traceback – трассировочный объект
limit – количество выводимой информации
Извлекает ту же трассировочную информацию, что и функция print_tb(). Возвращает список кортежей вида (filename, line, funcname, text), содержащих информацию, которая обычно выводится в сообщениях об ошибках.
traceback.
extract_stack
([frame[, limit]])frame – кадр стека
limit – количество выводимой информации
Извлекает ту же трассировочную информацию, что и функция print_stack(), но извлекает ее из кадра стека frame.
traceback.
format_list
(list)list – список кортежей, возвращаемый функцией extract_tb() или extract_stack()
Форматирует трассировочную информацию перед выводом.
traceback.
format_exception_only
(type, value)type – тип исключения
value – значение исключения
Форматирует информацию об исключении перед выводом.
traceback.
format_exception
(type, value, traceback[, limit])type – тип исключения
value – значение исключения
traceback – трассировочный объект
limit – количество выводимой информации
Форматирует трассировочную информацию и информацию об исключении перед выводом.
traceback.
format_tb
(traceback[, limit])traceback – трассировочный объект
limit – количество выводимой информации
То же, что и format_list(extract_tb(traceback, limit)).
traceback.
format_stack
([frame[, limit]])frame – кадр стека
limit – количество выводимой информации
То же, что и format_list(extract_stack(frame, limit)).
traceback.
tb_lineno
(traceback)traceback – трассировочный объект
Возвращает номер строки, установленной в объекте с трассировочной информацией.