Metadata-Version: 2.0
Name: pytest-faulthandler
Version: 1.4.1
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
Description-Content-Type: UNKNOWN
Keywords: pytest faulthandler
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Pytest
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
Requires-Dist: pytest (>=2.6)
Requires-Dist: faulthandler; python_version=="2.7"

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

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

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

|python| |version| |anaconda| |ci| |appveyor| 

.. |version| image:: http://img.shields.io/pypi/v/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

.. |python| image:: https://img.shields.io/pypi/pyversions/pytest-faulthandler.svg
    :target: https://pypi.python.org/pypi/pytest-faulthandler

.. |anaconda| image:: https://anaconda.org/conda-forge/pytest-faulthandler/badges/version.svg
    :target: https://anaconda.org/conda-forge/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.7+, 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


