---
id: pytest-timeout
version: "2.4.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# pytest-timeout — pytest plugin to abort hanging tests

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install pytest-timeout
uv add pytest-timeout
poetry add pytest-timeout

## Description

==============
pytest-timeout
==============

|python| |version| |anaconda| |ci| |pre-commit|

.. |version| image:: https://img.shields.io/pypi/v/pytest-timeout.svg
  :target: https://pypi.python.org/pypi/pytest-timeout

.. |anaconda| image:: https://img.shields.io/conda/vn/conda-forge/pytest-timeout.svg
  :target: https://anaconda.org/conda-forge/pytest-timeout

.. |ci| image:: https://github.com/pytest-dev/pytest-timeout/workflows/build/badge.svg
  :target: https://github.com/pytest-dev/pytest-timeout/actions

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

.. |pre-commit| image:: https://results.pre-commit.ci/badge/github/pytest-dev/pytest-timeout/master.svg
   :target: https://results.pre-commit.ci/latest/github/pytest-dev/pytest-timeout/master


.. warning::

   Please read this README carefully and only use this plugin if you
   understand the consequences.  This plugin is designed to catch
   excessively long test durations like deadlocked or hanging tests,
   it is not designed for precise timings or performance regressions.
   Remember your test suite should aim to be **fast**, with...

## AI interpretation — verify before relying

A pytest plugin that terminates tests exceeding a specified duration, useful for catching hanging or deadlocked tests during continuous integration or local test runs.

Verdict: A mature, well-maintained pytest plugin with no security issues and permissive licensing. Install is straightforward. Best suited as a safety net for detecting hung tests rather than for precise performance measurement; read the documentation carefully to understand termination behavior on your platform.

[View on SkillFed](https://skillfed.io/packages/pytest-timeout) · [View on PyPI](https://pypi.org/project/pytest-timeout/)