testresources 2.0.1

testresources.ResourcedTestCase

通过扩展或混合此类，测试可以用自动分配和处置或回收的必要资源。

ResourceTestCase可以用作测试的基础类，当这样做时，测试将自动检查其 resources 属性以获取资源，由OptimisingTestSuite以及它们自己的setUp()和tearDown()方法执行。（这允许测试在没有需要此特定TestSuite作为容器的条件下保持功能）。或者，您可以从自己的类setUp和tearDown中调用setUpResources(self, resources, test_result)和tearDownResources(self, resources, test_result)，并将激活相同的行为。

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

在setUp期间，对于每个声明的需求，测试将获得一个指向分配资源的属性，这是通过调用 resource_manager.getResource() 得到的。在tearDown()期间将对每个资源调用 finishedWith。

例如

class TestLog(testresources.ResourcedTestCase):

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

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

testresources.TestResourceManager

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

在实现新的 TestResourceManager 子类时，应考虑覆盖以下方法

make

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

返回资源对象的新实例（实际资源，而非TestResourceManager）。无需担心重用，重用将由其他部分处理。此方法仅在确实需要新资源时调用。

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

clean

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

_reset

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

isDirty

检查现有资源是否为脏。默认情况下，这仅报告是否调用了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对象上的resources列表用于声明依赖关系。例如，需要一个临时目录的DatabaseResource可以声明为具有资源列表

class DataBaseResource(TestResourceManager):

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

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

当测试有依赖项且该依赖项成功完成但返回None时，框架不会将其视为错误：请确保始终返回有效的资源或引发错误。错误处理尚未得到充分实践，但任何此领域的错误都将被迅速处理。

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

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

testresources.GenericResource

将testresources适配到现有资源类。

testresources.FixtureResource

将testresources适配到更简单的fixtures.Fixture API。从长远来看，testresources可能将侧重于该简单API作为编写资源的推荐方法。

testresources.OptimisingTestSuite

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

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

由于测试套件执行优化，您可以通过向单个OptimisingTestSuite添加更多或更少的测试来控制进行的优化程度。您可以将所有内容添加到单个OptimisingTestSuite中，以实现全局优化，或者可以使用几个较小的OptimisingTestSuites。

testresources.TestLoader

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

unittest.TestResult

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