testscenarios 0.5.0

子类化

如果您可以子类化TestWithScenarios，则TestWithScenarios中的run()方法将负责测试乘法。在测试执行时，它将作为生成器导致多个测试执行。为了使此操作可靠，TestWithScenarios必须是MRO中的第一个类，并且您不能覆盖run()或__call__。这是最稳健的方法，因为任何遵循python unittest协议的测试运行器或测试加载器都将运行所有场景。

手动生成

如果您不能子类化TestWithScenarios（例如，因为您正在使用TwistedTestCase、TestCaseWithResources或任何其他有用的测试基类，或者需要自己覆盖run()或__call__）则可以通过调用testscenarios.generate_scenarios()来使场景应用延迟发生。例如

>>> import unittest
>>> try:
...     from StringIO import StringIO
... except ImportError:
...     from io import StringIO
>>> from testscenarios.scenarios import generate_scenarios

这可以与标准库中的加载器和运行器一起工作，或者可能是其他实现

>>> loader = unittest.TestLoader()
>>> test_suite = unittest.TestSuite()
>>> runner = unittest.TextTestRunner(stream=StringIO())

>>> mytests = loader.loadTestsFromNames(['doc.test_sample'])
>>> test_suite.addTests(generate_scenarios(mytests))
>>> runner.run(test_suite)
<unittest...TextTestResult run=1 errors=0 failures=0>

测试加载器

一些测试加载器支持诸如load_tests和test_suite之类的钩子。确保您的测试通过这些钩子应用了场景是一个好主意 - 这意味着支持这些钩子（如nose、trial、tribunal）的外部测试运行器仍然会运行您的场景。（当然，如果您使用的是子类化方法，这已经得到了保证）。使用load_tests

>>> def load_tests(standard_tests, module, loader):
...     result = loader.suiteClass()
...     result.addTests(generate_scenarios(standard_tests))
...     return result

作为便利，这可以在load_tests_apply_scenarios中找到，因此使用场景测试的模块只需说

>>> from testscenarios import load_tests_apply_scenarios as load_tests

Python 2.7及以上版本支持不同的load_tests调用约定 <https://bugs.launchpad.net/bzr/+bug/607412>。 load_tests_apply_scenarios可以处理这两种情况。

使用test_suite

>>> def test_suite():
...     loader = TestLoader()
...     tests = loader.loadTestsFromName(__name__)
...     result = loader.suiteClass()
...     result.addTests(generate_scenarios(tests))
...     return result

关于TestCase

您可以在测试用例上设置一个场景属性

>>> class MyTest(unittest.TestCase):
...
...     scenarios = [
...         ('scenario1', dict(param=1)),
...         ('scenario2', dict(param=2)),]

这提供了找到特定测试场景的主要接口。子类将继承场景（除非它们覆盖了该属性）。

加载后

测试场景也可以在之后任意生成，只要测试尚未运行。只需替换（或更改，但请注意，许多测试可能共享单个场景属性）。例如，在这个例子中，一些第三方测试被扩展为使用自定义场景。

>>> import testtools
>>> class TestTransport:
...     """Hypothetical test case for bzrlib transport tests"""
...     pass
...
>>> stock_library_tests = unittest.TestLoader().loadTestsFromNames(
...     ['doc.test_sample'])
...
>>> for test in testtools.iterate_tests(stock_library_tests):
...     if isinstance(test, TestTransport):
...         test.scenarios = test.scenarios + [my_vfs_scenario]
...
>>> suite = unittest.TestSuite()
>>> suite.addTests(generate_scenarios(stock_library_tests))

生成的测试没有scenarios列表，因为它们通常不需要更多扩展。然而，您可以将scenarios列表添加回它们，然后通过generate_scenarios再次运行以生成测试的笛卡尔积。

>>> class CrossProductDemo(unittest.TestCase):
...     scenarios = [('scenario_0_0', {}),
...                  ('scenario_0_1', {})]
...     def test_foo(self):
...         return
...
>>> suite = unittest.TestSuite()
>>> suite.addTests(generate_scenarios(CrossProductDemo("test_foo")))
>>> for test in testtools.iterate_tests(suite):
...     test.scenarios = [
...         ('scenario_1_0', {}),
...         ('scenario_1_1', {})]
...
>>> suite2 = unittest.TestSuite()
>>> suite2.addTests(generate_scenarios(suite))
>>> print(suite2.countTestCases())
4

动态场景

一个常见的用例是让场景列表根据插件和可用库动态变化。一种简单的方法是在相关测试中使用的地方提供一个全局范围的场景，然后可以进行自定义，或者从注册表等动态填充场景。例如

>>> hash_scenarios = []
>>> try:
...     from hashlib import md5
... except ImportError:
...     pass
... else:
...     hash_scenarios.append(("md5", dict(hash=md5)))
>>> try:
...     from hashlib import sha1
... except ImportError:
...     pass
... else:
...     hash_scenarios.append(("sha1", dict(hash=sha1)))
...
>>> class TestHashContract(unittest.TestCase):
...
...     scenarios = hash_scenarios
...
>>> class TestHashPerformance(unittest.TestCase):
...
...     scenarios = hash_scenarios

强制场景

apply_scenarios函数可以将场景应用到没有任何场景的测试中。apply_scenarios是generate_scenarios的工作马，除了它接受传递的场景而不是反查测试对象以确定场景。apply_scenarios函数不重置测试场景属性，允许在不影响现有场景选择的情况下分层场景。

按实现模块进行测试

通常有多个Python模块提供相同的功能和接口，并且希望将相同的测试应用到所有这些模块上。

在某些情况下，并非所有静态定义的实现都能在特定的测试环境中使用。例如，可能有一个模块既有C语言实现也有纯Python实现。如果可以加载C模块，您希望对其进行测试，但如果C模块尚未编译，测试也应通过。

per_module_scenarios函数为每个命名的模块生成一个场景。导入的模块对象设置为结果的场景的提供属性名称。在导入期间引发ImportError的模块将使用异常的sys.exc_info()而不是模块对象。测试可以检查属性是否为元组来决定要做什么（例如跳过）。

请注意，为了使测试有效，对受测试模块的所有访问都必须通过测试对象的相应属性进行。如果其中一个实现也被测试模块或其他直接导入，testscenarios不会神奇地阻止它被使用。