* Added ``testresources.FixtureResource`` to wrap ``fixtures.Fixture``

  instances. (Robert Collins)

2 files changed, 56 insertions, 0 deletions

diff --git a/lib/testresources/__init__.py b/lib/testresources/__init__.py
index 32d97e4..dbb2f01 100644
--- a/lib/testresources/__init__.py
+++ b/lib/testresources/__init__.py
@@ -616,6 +616,42 @@ class GenericResource(TestResource):
         return True
 
 
+class FixtureResource(TestResource):
+    """A TestResource that decorates a ``fixtures.Fixture``.
+
+    The fixture has its setUp and cleanUp called as expected, and
+    reset is called between uses.
+
+    Due to the API of fixtures, dependency_resources are not
+    accessible to the wrapped fixture. However, if you are using
+    resource optimisation, you should wrap any dependencies in a
+    FixtureResource and set resources appropriately. 
+
+    See the ``fixtures`` documentation for information on managing
+    dependencies within the ``fixtures`` API.
+
+    :ivar fixture: The wrapped fixture.
+    """
+
+    def __init__(self, fixture):
+        """Create a FixtureResource
+
+        :param fixture: The fixture to wrap.
+        """
+        TestResource.__init__(self)
+        self.fixture = fixture
+
+    def clean(self, resource):
+        resource.cleanUp()
+
+    def make(self, dependency_resources):
+        self.fixture.setUp()
+        return self.fixture
+
+    def isDirty(self):
+        return True
+
+
 class ResourcedTestCase(unittest.TestCase):
     """A TestCase parent or utility that enables cross-test resource usage.
 
diff --git a/lib/testresources/tests/test_test_resource.py b/lib/testresources/tests/test_test_resource.py
index 97e5ab0..7cde13b 100644
--- a/lib/testresources/tests/test_test_resource.py
+++ b/lib/testresources/tests/test_test_resource.py
@@ -15,6 +15,7 @@
 #  license.
 #
 
+from fixtures.tests.helpers import LoggingFixture
 import testtools
 
 import testresources
@@ -446,3 +447,22 @@ class TestGenericResource(testtools.TestCase):
         resource = mgr.getResource()
         self.assertTrue(mgr.isDirty())
         mgr.finishedWith(resource)
+
+
+class TestFixtureResource(testtools.TestCase):
+
+    def test_uses_setUp_cleanUp(self):
+        fixture = LoggingFixture()
+        mgr = testresources.FixtureResource(fixture)
+        resource = mgr.getResource()
+        self.assertEqual(fixture, resource)
+        self.assertEqual(['setUp'], fixture.calls)
+        mgr.finishedWith(resource)
+        self.assertEqual(['setUp', 'cleanUp'], fixture.calls)
+
+    def test_always_dirty(self):
+        fixture = LoggingFixture()
+        mgr = testresources.FixtureResource(fixture)
+        resource = mgr.getResource()
+        self.assertTrue(mgr.isDirty())
+        mgr.finishedWith(resource)