Metadata-Version: 2.0
Name: pytest-faulthandler
Version: 1.1.0
Summary: py.test plugin that activates the fault handler module for tests
Home-page: https://github.com/pytest-dev/pytest-faulthandler
Author: Bruno Oliveira
Author-email: nicoddemus@gmail.com
License: MIT
Keywords: pytest faulthandler
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Software Development :: Testing
Requires-Dist: pytest (>=2.6)
Requires-Dist: faulthandler; python_version=="2.6" or python_version=="2.7"

===================
pytest-faulthandler
===================

Plugin for pytest that automatically enables the
`faulthandler <http://faulthandler.readthedocs.org/>`_ module during tests.

Inspired by the
`nose faulthandler <https://github.com/schlamar/nose-faulthandler>`_ plugin.

|version| |downloads| |ci| |appveyor|

.. |version| image:: http://img.shields.io/pypi/v/pytest-faulthandler.png
  :target: https://pypi.python.org/pypi/pytest-faulthandler

.. |downloads| image:: http://img.shields.io/pypi/dm/pytest-faulthandler.png
  :target: https://pypi.python.org/pypi/pytest-faulthandler

.. |ci| image:: https://api.travis-ci.org/pytest-dev/pytest-faulthandler.svg?branch=master
  :target: https://travis-ci.org/pytest-dev/pytest-faulthandler

.. |appveyor| image:: https://ci.appveyor.com/api/projects/status/faf052p56ipp1i4u/branch/master?svg=true
  :target: https://ci.appveyor.com/project/pytestbot/pytest-faulthandler


Usage
=====

The plugin is always active by default, but you can disable it by passing
``--no-faulthandler`` to ``py.test``.

Options:

* ``--faulthandler-timeout=TIMEOUT``: Dump the traceback of all threads if a
  test takes more than TIMEOUT seconds to finish.


Requirements
============

* Python 2.6+, Python 3.4+
* pytest
* faulthandler


Install
=======

Install using `pip <http://pip-installer.org/>`_:

.. code-block:: console

    $ pip install pytest-faulthandler

Change Log
==========

Please consult the `CHANGELOG`_.

.. _CHANGELOG: https://github.com/pytest-dev/pytest-faulthandler/blob/master/CHANGELOG.rst


