Go to file
pre-commit-ci[bot] 239def9be9
Merge pull request #1227 from pytest-dev/pre-commit-ci-update-config
[pre-commit.ci] pre-commit autoupdate
2025-07-14 19:34:51 -03:00
.github build(deps): bump hynek/build-and-inspect-python-package 2025-06-16 19:13:50 +00:00
changelog Release 3.8.0 2025-06-30 11:05:48 -03:00
docs Join multiple xdist_group markers (#1201) 2025-05-14 21:51:59 -03:00
example Deprecate --boxed 2021-11-02 09:38:56 +02:00
src/xdist Ensure all xdist group names are strings (#1216) 2025-06-30 11:01:27 -03:00
testing Add `--no-loadscope-reorder` and `--loadscope-reorder` options (#1217) 2025-06-30 10:59:40 -03:00
.gitignore Adopt 'src' layout and add 'testing' extras 2019-06-06 19:35:13 -03:00
.pre-commit-config.yaml Merge pull request #1227 from pytest-dev/pre-commit-ci-update-config 2025-07-14 19:34:51 -03:00
.readthedocs.yaml Install requirements.txt while building docs 2023-10-10 08:14:19 -03:00
CHANGELOG.rst Release 3.8.0 2025-06-30 11:05:48 -03:00
LICENSE Update LICENSE formatting (#996) 2024-02-12 12:04:26 -03:00
README.rst Split workflows into test and deploy 2022-11-05 12:24:00 -03:00
RELEASING.rst Add deploy instructions using the command-line (#967) 2023-12-01 11:28:21 -03:00
pyproject.toml Use SPDX license identifier (#1190) 2025-03-25 13:36:07 +01:00
tox.ini Drop EOL Python 3.8 support 2024-12-07 08:47:25 -03:00

README.rst

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

============
pytest-xdist
============

.. image:: http://img.shields.io/pypi/v/pytest-xdist.svg
    :alt: PyPI version
    :target: https://pypi.python.org/pypi/pytest-xdist

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

.. image:: https://img.shields.io/pypi/pyversions/pytest-xdist.svg
    :alt: Python versions
    :target: https://pypi.python.org/pypi/pytest-xdist

.. image:: https://github.com/pytest-dev/pytest-xdist/workflows/test/badge.svg
    :target: https://github.com/pytest-dev/pytest-xdist/actions

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

The `pytest-xdist`_ plugin extends pytest with new test execution modes, the most used being distributing
tests across multiple CPUs to speed up test execution::

    pytest -n auto

With this call, pytest will spawn a number of workers processes equal to the number of available CPUs, and distribute
the tests randomly across them.

Documentation
=============

Documentation is available at `Read The Docs <https://pytest-xdist.readthedocs.io>`__.