python - documentation on setup test_suite argument

Question

Feature in question

I'm looking for documentation on a feature that let's you specify the test cases for a python packages and run them using setup. For example if my setup.py file was:

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

I could then run the package's test cases with the following command:

python setup.py test

Where I have looked

• The PEP Index - there are many PEPs related to packaging I couldn't find mention of the test_suite feature in them.
• Distributing Python Modules documentation mention it either.

What I want to know

• what does test_suite expect? from what I can tell it expects a test suite and you can refer to one directly or a callable that returns one.
• Some projects specify their test suite in their setup.py like Flask some don't like Django. What is the benefit of specifying this.

Answer 1

配布のドキュメントには、ビルド パッケージと呼ばれる非常に優れたセクションがあり、test_suite の使用法をかなりよく説明しているユニットテスト スイートを実行します。

test_suite は何を期待していますか?

このコマンドを使用するには、関数、TestCase クラスまたはメソッド、または TestCase クラスを含むモジュールまたはパッケージによって、プロジェクトのテストを単体テスト テスト スイートにラップする必要があります。名前付きスイートがモジュールであり、モジュールに additional_tests() 関数がある場合、それが呼び出され、結果 (unittest.TestSuite である必要があります) が実行するテストに追加されます。名前付きスイートがパッケージの場合、サブモジュールとサブパッケージは再帰的にテスト スイート全体に追加されます。

これを指定する利点は何ですか？

setup.py でテスト メカニズムを指定することにより、アプリケーションはテスト スイートの場所を自動的に検出して実行できます。