如何在方法docString /评论中从特殊语法中自动生成单元测试例程？

Question

这是我要寻找的内容的模型：

def is_even(a, b):
    """Returns True if both numbers are even.
    @AutoUnitTestTag:
    - (0,2) -> True
    - (2,1) -> False
    - (3,5) -> False
    """
    return (a % 2 == 0 and b % 2 == 0)

是否有一个工具可以允许一个工具在函数的DocString中插入紧凑型语法定义的单元测试，然后自动生成unittest_foobar.py unit测试例程？

我几乎确定我已经看过这件事了，但是找不到。

编辑： @mkrieger1建议doctest 在下面的评论中，在使用它之后，我说这是一个非常适合的解决方案。 但是，我想让这个问题持续更长的时间，以收集更多建议，尤其是关于更复杂的工具。

如果有人有兴趣，以下是在我的示例情况下使用医生的方式：

1. so中的格式函数。

def is_even(a,b):
    """Returns True if both numbers are even.
    >>> is_even(0,2)
    True
    >>> is_even(2,1)
    False
    >>> is_even(3,5)
    False
    """
    return (a % 2 == 0 and b % 2 == 0)

2. file is_even.py 。 输出看起来像：

Trying:
    is_even(0,2)
Expecting:
    True
ok
Trying:
    is_even(2,1)
Expecting:
    False
ok
Trying:
    is_even(3,5)
Expecting:
    False
ok
1 items had no tests:
    foo2
1 items passed all tests:
   3 tests in foo2.is_even
3 tests in 2 items.
3 passed and 0 failed.
Test passed.

Answer 1

它称为 doctect ，这是标准库的一部分。但是您必须对语法进行一些更改：

def is_even(a, b):
    """Returns True if both numbers are even.

    >>> is_even(0, 2)
    True
    >>> is_even(2, 1)
    False
    >>> is_even(3, 5)
    False
    """
    return (a % 2 == 0 and b % 2 == 0)

您可以使用它来运行：

python -m doctest is_even.py

该语法已设计为设计，以便您可以从交互式（C）Python解释器会话中复制和粘贴测试，因此有充分的理由不去尝试更改它。此外，其他Python开发人员将已经熟悉此语法，而不是您可能想出的任何自定义。