第十六章：开发工具-doctest:通过文档完成测试-traceback

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版本)，它会跳过去继续查找异常类型和消息，完全忽略中间的各行。