python - 关于 setup test_suite 参数的文档

Question

有问题的功能

我正在寻找有关一项功能的文档，该功能让您可以为 python 包指定测试用例并使用 setup.xml 运行它们。例如，如果我的 setup.py 文件是：

from setuptools setup
setup(
    name='foo',
    version='1.0',
    py_modules=['foo'],
    test_suite='testsuite.test_all.suite',
)

然后我可以使用以下命令运行包的测试用例：

python setup.py test

我看过的地方

• PEP 索引- 有许多与包装相关的PEP，我在其中找不到 test_suite 功能。
• 分发 Python 模块文档也提到了它。

我想知道的

• test_suite 期望什么？据我所知，它需要一个测试套件，您可以直接引用一个或返回一个可调用的。
• 有些项目在 setup.py 中指定了他们的测试套件，比如 Flask，有些项目不喜欢 Django。指定这个有什么好处。

Answer 1

分发的文档有一个非常好的部分，称为构建包并运行一个单元测试套件，它很好地解释了 test_suite 的使用。

test_suite 期望什么？

要使用此命令，您的项目测试必须通过函数、TestCase 类或方法或包含 TestCase 类的模块或包包装在 unittest 测试套件中。如果命名套件是一个模块，并且该模块具有附加的_tests() 函数，则调用它并将结果（必须是 unittest.TestSuite）添加到要运行的测试中。如果命名套件是一个包，则任何子模块和子包都会递归地添加到整个测试套件中。

指定这个有什么好处？

通过在 setup.py 中指定测试机制，应用程序可以自动检测测试套件的位置并运行它们。