Go to file
Alon Livne a9a303f688 add proxy gateways with --px arg
Proxy gateways do not run workers, and are meant to be passed with the
`via` attribute to additional gateways.
They are useful for running multiple workers on remote machines.

Example usage:
```
pytest -sv --dist=load --px "id=my_proxy//socket=IP:PORT" --tx "5*popen//via=my_proxy"
```

Proxy gateways do not run workers, anda re meant to be passed
2025-01-12 20:33:31 +02:00
.github build(deps): bump hynek/build-and-inspect-python-package 2024-12-16 17:43:16 +00:00
changelog Drop EOL Python 3.8 support 2024-12-07 08:47:25 -03:00
docs Fix '-n logical' inconsistencies and review --help formatting (#1022) 2024-02-25 11:49:41 -03:00
example Deprecate --boxed 2021-11-02 09:38:56 +02:00
src/xdist add proxy gateways with --px arg 2025-01-12 20:33:31 +02:00
testing add proxy gateways with --px arg 2025-01-12 20:33:31 +02:00
.gitignore Adopt 'src' layout and add 'testing' extras 2019-06-06 19:35:13 -03:00
.pre-commit-config.yaml [pre-commit.ci] pre-commit autoupdate (#1168) 2025-01-07 06:23:53 +01:00
.readthedocs.yaml Install requirements.txt while building docs 2023-10-10 08:14:19 -03:00
CHANGELOG.rst Release 3.6.1 2024-04-28 22:20:45 +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 Drop EOL Python 3.8 support 2024-12-07 08:47:25 -03: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>`__.