---
id: pytest-runner
version: "6.0.1"
license: unclear
license_treatment: permissive
maintenance: abandoned
---

# pytest-runner — Invoke py.test as distutils command with dependency resolution

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

## Install

pip install pytest-runner
uv add pytest-runner
poetry add pytest-runner

## Description

.. image:: https://img.shields.io/pypi/v/pytest-runner.svg
   :target: `PyPI link`_

.. image:: https://img.shields.io/pypi/pyversions/pytest-runner.svg
   :target: `PyPI link`_

.. _PyPI link: https://pypi.org/project/pytest-runner

.. image:: https://github.com/pytest-dev/pytest-runner/workflows/tests/badge.svg
   :target: https://github.com/pytest-dev/pytest-runner/actions?query=workflow%3A%22tests%22
   :alt: tests

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
   :target: https://github.com/psf/black
   :alt: Code style: Black

.. .. image:: https://readthedocs.org/projects/skeleton/badge/?version=latest
..    :target: https://skeleton.readthedocs.io/en/latest/?badge=latest

.. image:: https://img.shields.io/badge/skeleton-2022-informational
   :target: https://blog.jaraco.com/skeleton

.. image:: https://tidelift.com/badges/package/pypi/pytest-runner
   :target: https://tidelift.com/subscription/pkg/pypi-pytest-runner?utm_source=pypi-pytest-runner&utm_medium=readme

Setup scripts can use pytest-runner to add setup.py test support for pytest
runner.

Deprecation Notice
==================

pytest-runner depends on deprecated features of setuptools...

## AI interpretation — verify before relying

pytest-runner enables setup.py to invoke pytest as a distutils command with automatic test dependency resolution, though it is now deprecated.

Verdict: pytest-runner is a stable but abandoned tool for running pytest via setup.py. While it installs cleanly with zero runtime friction, its own documentation warns that it relies on deprecated features and security-bypassing mechanisms. New projects should use alternative test orchestration; existing users should plan migration.

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