aboutsummaryrefslogtreecommitdiffstats
path: root/setuptools.txt
diff options
context:
space:
mode:
authorPJ Eby <distutils-sig@python.org>2006-03-29 23:32:41 +0000
committerPJ Eby <distutils-sig@python.org>2006-03-29 23:32:41 +0000
commit696739a1fc24ccb3ace56a2156b7199f6b85e194 (patch)
tree03c589abad3b004b2f73605057cb3e2aaae7b345 /setuptools.txt
parentf4505e41e7c3c4c270c53a4506b3f17556f20f76 (diff)
downloadexternal_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-xsetuptools.txt23
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.