CircleCI Docs

Testfixtures is a collection of helpers and mock objects that are useful when writing automated tests in Python.

The areas of testing this package can help with are listed below:

Comparing objects and sequences

Better feedback when the results aren’t as you expected along with support for comparison of objects that don’t normally support comparison and comparison of deeply nested datastructures.

Mocking out objects and methods

Easy to use ways of stubbing out objects, classes or individual methods for both doc tests and unit tests. Special helpers are provided for testing with dates and times.

Testing logging

Helpers for capturing logging output in both doc tests and unit tests.

Testing stream output

Helpers for capturing stream output, such as that from print statements, and making assertion about it.

Testing with files and directories

Support for creating and checking files and directories in sandboxes for both doc tests and unit tests.

Testing exceptions and warnings

Easy to use ways of checking that a certain exception is raised, or a warning is issued, even down the to the parameters provided.

Testing subprocesses

A handy mock for testing code that uses subprocesses.

Testing when using django

Helpers for comparing instances of django models.

Testing when using zope.component

An easy to use sterile component registry.

The sections below describe the use of the various tools included:

If you’re looking for a description of a particular tool, please see the API reference:

For details of how to install the package or get involved in its development, please see the sections below:

Indices and tables