Fixtures

~~~~~~

New ``DetailStream`` fixture to add file-like object content to testtools
details, cleanup logic factored out into a CallMany class.

CHANGES:

* Add ``join`` method to ``TempDir`` to more readily get paths relative
to a temporary directory. (Jonathan Lange)

* Factor out new ``CallMany`` class to isolate the cleanup logic.
(Robert Collins)

* New ``DetailStream`` fixture to add file-like object content to testtools
details. This allows for easy capture of sys.stdout and sys.stderr for
example. (Clark Boylan)

~~~~~

New ``TempHomeDir`` fixture and more log output included in ``FakeLogger``.

CHANGES:

* New TempHomeDir fixture to create and activate a temporary home directory.
(James Westby)

* ``FakeLogger`` now includes the output from python logging - the .output
attribute as a content object in getDetails, so the logs will automatically
be included in failed test output (or other similar circumstances).
(Francesco Banconi)

~~~~~

Simpler names for a number of fixtures, and two new fixtures NestedTempfile and
Timeout. See the manual for more information.

CHANGES:

* EnvironmentVariable now upcalls via super().
(Jonathan Lange, 881120)

* EnvironmentVariableFixture, LoggerFixture, PopenFixture renamed to
EnvironmentVariable, FakeLogger and FakePopen respectively. All are still
available under their old, deprecated names. (Jonathan Lange, 893539)

* gather_details fixed to handle the case where two child fixtures have the
same detail name. (Jonathan Lange, 895652)

* ``NestedTempfile`` which will change the default path for tempfile temporary
file / directory creation. (Gavin Panella)

* New Timeout fixture. (Martin Pool)

~~~~~

CHANGES:

* New fixture LoggerFixture which replaces a logging module logger.
(Free Ekanayaka)

* On Python 2.7 and above the _fixtures tests are no longer run twice.
(Robert Collins)

* Python 3 now supported. (Jonathan Lange, 816665)

* ``TempDir`` supports creating the temporary directory under a specific path.
An example of where this is useful would be if you have some specific long
lived temporary items and need to avoid running afoul of tmpreaper.
(Robert Collins, 830757)

* Updated to match the changed ``gather_details`` API in testtools. See 801027.
This is an incompatible change in testtools and requires testtools 0.9.12.
(Jonathan Lange)

~~~~~

Another small API break - sorry. Fixture.getDetails no longer returns the
internal details dict (self._details). Access that directly if needed. It now
looks for details in used fixtures and returns those as well as details added
directly.

CHANGES:

* Details from child fixtures for both Fixture and TestWithFixtures no longer
quash same-named details if testtools 0.9.11 is available (for the
gather_details helper).
(Gavin Panella, 796253)

* Fixture.getDetails will now return all the details of fixtures added using
useFixture. (RobertCollins, 780806)

* New fixture ``PackagePathEntry`` which patches the path of an existing
package, allowing importing part of it from another directory.
(Robert Collins)

* New fixture ``PythonPathEntry`` which patches sys.path.
(Robert Collins, 737503)

* Test failure on some setups in
test_cleanUp_raise_first_false_callscleanups_returns_exceptions.
(Gavin Panella, 796249)

* Testtools 0.9.8 is now a minimum requirement.
(Gavin Panella)

~~~~~

CHANGES:

* New fixture ``MonkeyPatch`` which patches (or deletes) an existing attribute
and restores it afterwards. (Robert Collins)

* New fixture ``PythonPackage`` which manages a temporary python package.
(Robert Collins)

* New fixture ``TempDir`` which manages a temporary directory. (Robert Collins)