Metadata-Version: 2.4
Name: testfixtures
Version: 12.0.1
Summary: A collection of helpers and mock objects for unit tests and doc tests.
Project-URL: Homepage, https://github.com/Simplistix/testfixtures
Project-URL: Documentation, http://testfixtures.readthedocs.org/en/latest/
Project-URL: Repository, https://github.com/Simplistix/testfixtures
Project-URL: Changelog, https://testfixtures.readthedocs.io/en/latest/changes.html
Author-email: Chris Withers <chris@simplistix.co.uk>
License: MIT
License-File: LICENSE.txt
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Provides-Extra: django
Requires-Dist: django>=4; (python_version < '3.13') and extra == 'django'
Requires-Dist: django>=5.1.3; (python_version >= '3.13') and extra == 'django'
Provides-Extra: loguru
Requires-Dist: loguru>=0.7.3; extra == 'loguru'
Provides-Extra: mock-backport
Requires-Dist: mock>=4.0.3; extra == 'mock-backport'
Provides-Extra: pandas
Requires-Dist: pandas>=2.3.3; extra == 'pandas'
Provides-Extra: polars
Requires-Dist: polars>=1.32; extra == 'polars'
Provides-Extra: structlog
Requires-Dist: structlog>=24.3.0; extra == 'structlog'
Provides-Extra: sybil
Requires-Dist: sybil>=10.0.1; extra == 'sybil'
Provides-Extra: toml
Requires-Dist: tomlkit>=0.10.0; extra == 'toml'
Provides-Extra: twisted
Requires-Dist: twisted>=22.1; extra == 'twisted'
Provides-Extra: yaml
Requires-Dist: pyyaml>=6.0.3; extra == 'yaml'
Description-Content-Type: text/x-rst

Testfixtures
============

|Docs|_ |PyPI|_  |Git|_

.. |Docs| image:: https://readthedocs.org/projects/testfixtures/badge/?version=latest
.. _Docs: http://testfixtures.readthedocs.org/en/latest/

.. |PyPI| image:: https://badge.fury.io/py/testfixtures.svg
.. _PyPI: https://pypi.org/project/testfixtures/

.. |Git| image:: https://github.com/simplistix/testfixtures/actions/workflows/ci.yml/badge.svg
.. _Git: https://github.com/simplistix/testfixtures

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. Specialised helpers and mock objects are provided, including sub-processes,
dates and times.

**Testing logging**

Helpers for capturing logging and checking what has been logged is what was expected.

**Testing stream output**

Helpers for capturing stream output, such as that from print function calls or even
stuff written directly to file descriptors, and making assertions about it.

**Testing with files and directories**

Support for creating and checking both files and directories in sandboxes
including support for other common path libraries.

**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 when using django**

Helpers for comparing instances of django models.

**Testing when using Twisted**

Helpers for making assertions about logging when using Twisted.
