是否有基于python的实用程序用于在注释中测试示例

Question

是否有基于python的实用程序用于测试函数注释中的示例？例如，给出orwell_1984.py中的以下代码：

def two_plus_two():
    """Returns 2 + 2 according to Orwell's 1984"""
    # EX: two_plus_two() => 5
    return 5

该实用程序将执行以下操作：

import orwell_1984
verify_test(orwell_1984.two_plus_two, (), 5)

其中verify_test使用指定的参数调用传入函数，然后确保等于期望值。

前段时间我在perl写了一些东西来做这件事;见http://www.cs.nmsu.edu/~tomohara/useful-scripts/test-perl-examples.perl。在尝试移植之前，我希望找到一个类似的基于python的实用程序。

Answer 1

在Python中称为docstring，例如：

def two_plus_two():
    """Returns 2 + 2 according to Orwell's 1984.

    >>> two_plus_two()
    5
    """
    return 5

if __name__ == "__main__":
   import doctest
   doctest.testmod()

查看有关doctest module。

的信息