利用doctestDocTestSuite()来测试Python模块

在Python中，可以使用doctest模块来编写和执行文档字符串中的测试用例。doctest模块提供了一个DocTestSuite()函数，它可以用来创建一个包含文档字符串中的所有测试用例的测试套件。除了测试用例本身，它还可以自动提取文档字符串中的预期输出和实际输出，并比较它们是否一致。

下面是一个例子，展示如何使用doctest模块和DocTestSuite()来测试一个Python模块：

import doctest

def add(a, b):
    """
    返回两个数的和
    
    使用例子：
    >>> add(2, 3)
    5
    >>> add(-1, 1)
    0
    """
    return a + b

def subtract(a, b):
    """
    返回两个数的差
    
    使用例子：
    >>> subtract(5, 2)
    3
    >>> subtract(10, 5)
    5
    """
    return a - b

# 创建一个包含所有测试用例的测试套件
suite = doctest.DocTestSuite()

# 执行测试套件，并打印测试结果
runner = doctest.DocTestRunner()
runner.run(suite)

在上面的例子中，我们定义了两个函数add()和subtract()，并在它们的文档字符串中添加了一些使用例子和预期输出。然后，我们使用doctest.DocTestSuite()函数创建了一个包含所有测试用例的测试套件，并使用doctest.DocTestRunner()来执行测试套件并打印测试结果。

当我们运行上面的代码时，它会自动执行文档字符串中的测试用例，并比较预期输出和实际输出是否一致。如果测试通过，它会显示一个"."，如果测试失败，它会显示一个"F"。最后，它会输出一个总结，告诉我们有多少个测试通过和失败。

doctest模块的一个优点是可以将测试用例直接写在函数的文档字符串中，这样可以更方便地编写和维护测试用例。另外，它还可以自动提取和执行测试用例，并且可以与其他测试框架（如unittest）配合使用。这使得它成为一个非常便捷和灵活的测试工具。