16.2.3 traceback
traceback是不断变化的数据的一个特殊情况。由于traceback中的路径取决于模板安装在文件系统上的具体位置,如果像其他输出一样处理,则可能无法编写可移植的测试。
def this_raises():
"""This function always raises an exception.
>>> this_raises()
Traceback (most recent call last):
File "<stdin>",line 1, in <module>
File "/no/such/path/doctest_tracebacks.py", line 14, in
this_this_raises
raise RuntimeError('here is the error')
RuntimeError: here is the error
"""
raise RuntimeError('here is the error')
doctest做了一些特殊工作来识别traceback,并忽略可能因系统不同而改变的部分。
实际上,整个traceback体都将被忽略,可以略去。
def this_raises():
"""This function always raises an exception.
>>> this_raises()
Traceback (most recent call last):
RuntimeError: here is the error
>>> this_raises()
Traceback (innermost last):
RuntimeError: here is the error
"""
raise RuntimeError('here is the error')
doctest看到一个traceback首部行时(可能是"Traceback(most recent call last):“或"Traceback (innermost last):”,这取决于所用的Python版本),它会跳过去继续查找异常类型和消息,完全忽略中间的各行。