16.5 traceback:异常和栈轨迹
traceback模块处理调用栈来生成错误消息。traceback是指从异常处理器沿调用链向下直到产生异常的那一点的栈轨迹。也可以在当前调用栈从调用位置(没有错误上下文)向上访问traceback,这对于确定进入函数的路径很有用。
traceback中的高层API使用StackSummary和FrameSummary实例保存栈的表示。可以从一个traceback或当前执行栈构造这些类,然后用同样的方式处理。traceback中的底层函数通常可以分为几类。有些函数用于从当前运行时环境(可能是一个traceback的异常处理器或者是常规的栈)抽取原始traceback。所抽取的栈轨迹是一个元组序列,元组中包含文件名、行号、函数名和源代码行文本。
一旦抽取了栈轨迹,便可以使用类似format_exception()和format_stack()等函数格式化。格式化函数会返回一个字符串列表,其中对消息进行格式化以便打印。还有一些用于打印格式化值的简写函数。
traceback中的函数默认地会模拟交互式解释器的行为,不仅如此,它们对另外一些情况下异常的处理也很有用,这些情况下并不需要将完整的栈轨迹转储到控制台。例如,一个Web应用可能需要格式化traceback,以便用HTML格式很好地显示,或者一个IDE可以将栈轨迹的元素转换为一个可点击的列表,以便用户浏览源文本。
16.5.1 支持函数
这一节中的例子使用了模块traceback_example.py
import traceback
import sys
def produce_exception(recursion_level=2):
sys.stdouut.flush()
if recursion_level:
produce_exception(recursion_level - 1)
else:
raise RuntimeError()
def call_function(f,recursion_level=2):
if recursion_level:
return call_function(f,recursion_level - 1)
else:
return f()