eggtestinfo 0.3

概览

此包是一个setuptools插件：它会在生成的.egg-info目录中添加一个文件，捕获在运行测试时由setup.py test命令使用的相关信息。

特别地，生成的文件包含以下信息

test_module

包含一个可调用的test_suite函数的模块的点名称，该函数可用于为包计算一个unittest.TestSuite。

• 此选项与test_suite冲突。

• 此选项可以在命令行中覆盖，例如。

  $ python setup.py test --test_module=my_package.tests

test_suite

一个可调用的函数，可用于为包计算一个unittest.TestSuite。

• 此选项与test_module冲突。

• 请注意，此名称不使用与其他setuptools可调用相同的约定：函数名称附加到模块的点名称上，而不是冒号。

• 此选项可以在命令行中覆盖，例如。

  $ python setup.py test --test_suite=my_package.utils.find_tests

test_loader

一个setuptools入口点，当被调用时，返回一个加载器类的实例，适合作为unittest.main()的testLoader参数传递。

• 此选项不能在命令行中覆盖；它只能作为setup()的参数指定。

tests_require

一个列表，包含setuptools的包需求规格，当运行测试时必须可导入的包。

• 此选项不能在命令行中覆盖。

使用扩展

该包为setuptools的egg_info.writers组注册了一个入口点：因此，在PYTHONPATH中存在该包的任何环境中构建egg info时都会使用它。

为了确保您的包即使在使用未安装该包的环境时也能记录测试信息，请在对setup()的调用中添加以下内容：

from setuptools import setup
setup(name='my_package',
      # ...
      setup_requires=['eggtestinfo'],
      #...
     )

示例

以下示例显示了为各种示例包生成的test_info.txt文件。

• 对于可以通过setuptools默认加载器找到测试的包，但其测试依赖于不是包的“正常”依赖的另一个包

  test_module = None
  test_suite = None
  test_loader = None
  tests_require = another_package

• 对于具有包含返回整个包测试套件的‘test_suite’函数的‘tests’模块的包

  test_module = my_package.tests
  test_suite = None
  test_loader = None
  tests_require = None

• 对于在其‘utils’模块中具有返回包测试套件的‘find_tests’函数的包

  test_module = None
  test_suite = my_package.utils.find_tests
  test_loader = None
  tests_require = None

• 对于使用来自zope.testing的“跳过层”加载器的包

  test_module = None
  test_suite = None
  test_loader = zope.testing.testrunner.eggsupport:SkipLayers
  tests_require = zope.testing>=3.7dev

0.3 (2011-03-10)

• 验证/添加了Python3兼容性的断言。

• 添加了测试。

0.2.2 (2008-09-19)

• 打包更新：添加了更广泛的文档。

0.2.1 (2008-03-09)

• 打包更新：添加了新的Trove分类器，“Framework :: Setuptools Plugin”。

0.2 (2007-11-16)

• 将“test_loader”和“test_module”信息添加到生成的文件中。

0.1 (2007-11-15)

• 初始发布。