testresources 2.0.1

testresources.ResourcedTestCase

通过扩展或混入这个类，测试可以有必要的资源自动分配和处置或回收。

ResourceTestCase 可以用作测试的基类，完成后，测试将通过 OptimisingTestSuite 及其自己的 setUp() 和 tearDown() 方法自动检查其资源属性。（这允许测试保持功能，而不需要这个特定的 TestSuite 作为容器）。或者，您可以从您自己的类 setUp 和 tearDown 中调用 setUpResources(self, resources, test_result) 和 tearDownResources(self, resources, test_result) 并且将激活相同的行为。

要声明资源的使用，请将资源属性设置为(attribute_name, resource_manager)的元组列表。

在设置期间，对于每个声明的需求，测试都会获得一个指向已分配资源的属性，这是调用 resource_manager.getResource()的结果。 在 tearDown() 期间将在每个资源上调用finishedWith 。

例如：

class TestLog(testresources.ResourcedTestCase):

    resources = [('branch', BzrPopulatedBranch())]

    def test_log(self):
        show_log(self.branch, ...)

测试资源.TestResourceManager

TestResourceManager 是测试可以用来创建资源的对象。它可以被覆盖以管理不同类型的资源。通常测试代码不需要调用任何方法，因为这将由 testresources 机器安排。

在实现新的TestResourceManager子类时，您应该考虑覆盖这些方法：

制作

必须在每个具体子类中被覆盖。

返回资源对象的新实例（实际资源，而不是 TestResourceManager）。无需担心重用，这是单独处理的。仅当确实需要新资源时才调用此方法。

make由getResource调用；您通常不需要覆盖后者。

干净的

清理现有资源实例，例如通过删除目录或关闭网络连接。默认情况下，这不会执行任何操作，这可能适用于自动进行垃圾收集的资源。

_重置

将不再使用的脏资源重置为干净状态。默认情况下，这只是丢弃它并创建一个新的，但对于某些资源，可能有一种更快的方法来重置它们。

是脏的

检查现有资源是否脏。默认情况下，这只报告是否调用了TestResourceManager.dirtied或任何依赖资源是脏的。

例如：

class TemporaryDirectoryResource(TestResourceManager):

    def clean(self, resource):
        shutil.rmtree(resource)

    def make(self):
        return tempfile.mkdtemp()

    def isDirty(self, resource):
        # Can't detect when the directory is written to, so assume it
        # can never be reused.  We could list the directory, but that might
        # not catch it being open as a cwd etc.
        return True

TestResourceManager 对象上的资源列表用于声明依赖关系。例如，需要 TemporaryDirectory 的 DataBaseResource 可以用资源列表声明：

class DataBaseResource(TestResourceManager):

    resources = [("scratchdir", TemporaryDirectoryResource())]

最重要的是，同一个 TestResourceManager 的两个 getResources 中间没有finishedWith调用，只要它不脏，就会返回同一个对象。

当一个 Test 有一个依赖并且该依赖成功完成但返回 None 时，框架不会认为这是一个错误：确保总是返回一个有效的资源，或者引发一个错误。错误处理没有被大量使用，但是这方面的任何错误都会得到及时处理。

可以在 doc/ 文件夹中找到示例 TestResourceManager。

有关详细信息，请参阅 pydoc testresources.TestResourceManager。

测试资源.GenericResource

粘合以使 testresources 适应现有的类资源类。

testresources.FixtureResource

胶水使测试资源适应更简单的fixtures.Fixture API。长期的 testresources 可能会巩固更简单的 API 作为编写资源的推荐方法。

testresources.OptimisingTestSuite

此 TestSuite 将内省它直接持有的所有测试用例，如果它们声明了所需的资源，则将按照尝试最小化所需设置和拆卸次数的顺序运行测试。它试图通过围绕使用特定资源的测试序列调用 getResource() 和 finishedWith() 来实现这一点。

测试正常添加到 OptimisingTestSuite。任何标准库 TestSuite 对象都将被展平，而任何自定义 TestSuite 子类将分布在其成员测试中。这意味着应该保留测试套件中的任何自定义逻辑，代价是某种程度的优化。

因为测试套件会进行优化，所以您可以通过向单个 OptimisingTestSuite 添加更多或更少的测试来控制发生的优化量。您可以将所有内容添加到单个 OptimisingTestSuite，获得全局优化，或者您可以使用几个较小的 OptimisingTestSuite。

测试资源.TestLoader

这是一个简单的 TestLoader，默认创建 OptimisingTestSuites。

unittest.TestResult

testresources 会将有关资源创建和销毁的活动记录到运行对象测试的结果中。寻找 6 个扩展方法： startCleanResource、stopCleanResource、startMakeResource、 stopMakeResource、startResetResource和最后stopResetResource。 testresources.tests.ResultWithResourceExtensions是存在这些方法的TestResult示例。