pytest-jobserver 1.0.0

Description:

pytestjobserver 1.0.0

pytest-jobserver




Limit parallel tests with posix jobserver.
Installation
Install with pip:
pip install pytest-jobserver

The plugin officially supports Python >= 3.6 on a Linux OS.
You may find other Python 3 versions/MacOS work as well.
Usage
The plugin uses a POSIX jobserver to manage parallel test loading.
Pass the --jobserver argument with a path, where this path points to a named pipe acting as a jobserver.
You should probably also use pytest-xdist to enable parallelism in the first place:
pytest -n4 --jobserver /opt/jobserver

You can also pass this filepath via the PYTEST_JOBSERVER environment variable.
make
The plugin can also listen for an existing jobserver as created by make.
If a jobserver is not configured by filepath, pytest-jobserver will check the following environment variables in order:

CARGO_MAKEFLAGS
MAKEFLAGS
MFLAGS

Please note: it is not possible to use one of these environment variables with pytest-xdist. The execnet protocol used by xdist does not support passing file descriptors to remote child processes.
Implementation
This plugin wraps pytest's call to pytest_runtest_protocol, which is called to actually run a collected item on the worker node.
Development
See the top level Makefile and .circleci/config.yml for the development flow. But in essence:

make dev to install deps
make lint to lint code (will change files)
make test to run lint/unit tests
make integrate to run integration tests

Changelog
1.0.0
Features

jobserver token int value can be accessed within a test using the jobserver_token fixture
bump to 1.0.0 as the plugin is now stable, and in use by other projects

0.3.1
Bugfixes

fix package installation with pip

0.3.0
Features

a jobserver filepath can also be configured by the PYTEST_JOBSERVER environment variable

0.2.2
Bugfixes

move jobserver status on startup to official pytest_report_header hook

0.2.1
Bugfixes

remove pytest-xdist from runtime dependencies

0.2.0
Features

can run against a jobserver specified with make environment variables

note that this will deliberately not work when also using pytest-xdist



0.1.1
Bugfixes

fix setup.py package metadata

0.1.0
Features

can run against a jobserver specified at the cli

TODO

run against cli jobserver
integrate with Make jobserver from environment variables
factor out creation of jobservers to seperate python package