diff options
author | PJ Eby <distutils-sig@python.org> | 2006-03-29 23:32:41 +0000 |
---|---|---|
committer | PJ Eby <distutils-sig@python.org> | 2006-03-29 23:32:41 +0000 |
commit | 696739a1fc24ccb3ace56a2156b7199f6b85e194 (patch) | |
tree | 03c589abad3b004b2f73605057cb3e2aaae7b345 /setuptools.txt | |
parent | f4505e41e7c3c4c270c53a4506b3f17556f20f76 (diff) | |
download | external_python_setuptools-696739a1fc24ccb3ace56a2156b7199f6b85e194.tar.gz external_python_setuptools-696739a1fc24ccb3ace56a2156b7199f6b85e194.tar.bz2 external_python_setuptools-696739a1fc24ccb3ace56a2156b7199f6b85e194.zip |
Added ``test_loader`` keyword to support custom test loaders.
--HG--
branch : setuptools
extra : convert_revision : svn%3A6015fed2-1504-0410-9fe1-9d1591cc4771/sandbox/trunk/setuptools%4043430
Diffstat (limited to 'setuptools.txt')
-rwxr-xr-x | setuptools.txt | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/setuptools.txt b/setuptools.txt index e93d9304..01fb1bc4 100755 --- a/setuptools.txt +++ b/setuptools.txt @@ -362,6 +362,27 @@ unless you need the associated ``setuptools`` feature. are run, but only downloaded to the project's setup directory if they're not already installed locally. +``test_loader`` + If you would like to use a different way of finding tests to run than what + setuptools normally uses, you can specify a module name and class name in + this argument. The named class must be instantiable with no arguments, and + its instances must support the ``loadTestsFromNames()`` method as defined + in the Python ``unittest`` module's ``TestLoader`` class. Setuptools will + pass only one test "name" in the `names` argument: the value supplied for + the ``test_suite`` argument. The loader you specify may interpret this + string in any way it likes, as there are no restrictions on what may be + contained in a ``test_suite`` string. + + The module name and class name must be separated by a ``:``; the default + value of this argument is ``"setuptools.command.test:ScanningLoader"``. If + you want to use the default ``unittest`` behavior instead, you can specify + ``"unittest:TestLoader"`` as your ``test_loader`` argument instead. This + will prevent automatic scanning of submodules and subpackages. + + The module and class you specify here may be contained in another package, + as long as you use the ``tests_require`` option to ensure that the package + containing the loader class is available when the ``test`` command is run. + ``eager_resources`` A list of strings naming resources that should be extracted together, if any of them is needed, or if any C extensions included in the project are @@ -2471,6 +2492,8 @@ Release Notes/Change History ---------------------------- 0.6a11 + * Added ``test_loader`` keyword to support custom test loaders + * Added ``setuptools.file_finders`` entry point group to allow implementing revision control plugins. |