discover 0.4.0

这是从Python 2.7回滚到Python 2.4或更高版本（包括Python 3）的unittest测试发现机制和load_tests协议。

可以使用pip或easy_install安装discover。安装后，将当前目录切换到项目顶层目录并运行

python -m discover
python discover.py

（如果您已安装setuptools或distribute，您还将有一个discover脚本可用。）

这将发现当前目录中的所有测试（有某些限制）。discover模块有多个选项来控制其行为（完整的用法选项显示在python -m discover -h）

Usage: discover.py [options]

Options:
  -v, --verbose    Verbose output
  -s directory     Directory to start discovery ('.' default)
  -p pattern       Pattern to match test files ('test*.py' default)
  -t directory     Top level directory of project (default to
                   start directory)

For test discovery all test modules must be importable from the top
level directory of the project.

例如，要使用不同的模式匹配测试模块，请运行

python -m discover -p '*test.py'

（对于像Bash这样的UNIX-like shell，您需要在测试模式周围加上引号，否则shell将尝试展开模式，而不是将其传递给发现。在Windows上，您必须不要在模式周围加上引号，因为Windows shell也会将引号传递给发现。）

测试发现是在 discover.DiscoveringTestLoader.discover 中实现的。除了将 discover 用作命令行脚本外，您还可以导入 DiscoveringTestLoader，它是 unittest.TestLoader 的子类，并在您的测试框架中使用它。

此方法从指定的起始目录找到并返回所有测试模块，递归到子目录中查找它们。只有与 pattern 匹配的测试文件才会被加载。（使用shell样式模式匹配。）

所有测试模块都必须可以从项目的顶层导入。如果起始目录不是顶层目录，则必须单独指定顶层目录。

load_tests 协议允许测试模块和包自定义它们如何被加载。这通过 discover.DiscoveringTestLoader.loadTestsFromModule 实现。如果测试模块定义了一个 load_tests 函数，则通过调用 load_tests 并传递三个参数： loader、standard_tests、None 来从模块中加载测试。

如果测试包名称（具有 __init__.py 的目录）与模式匹配，则将检查包中的 load_tests 函数。如果存在，则将其与 loader、tests、pattern 一起调用。

如果存在 load_tests，则发现将不会递归到包中，load_tests 负责加载包中的所有测试。

模式故意不以加载器属性的形式存储，以便包可以继续发现。存储 top_level_dir，以便 load_tests 不需要在 loader.discover() 中传递此参数。

discover.py 在一个 google code 项目中维护（在此处应发布错误和功能请求）：http://code.google.com/p/unittest-ext/

discover.py 的最新开发版本可在以下位置找到：http://code.google.com/p/unittest-ext/source/browse/trunk/discover.py