pytest-test-groups 1.2.1

A Pytest plugin for running a subset of your tests by splitting them in to equally sized groups.

Welcome to pytest-test-groups!

pytest-test-groups allows you to split your test runs into groups of a specific size to make it easier to split up your test runs.

Usage

# Install pytest-test-groups
pip install pytest-test-groups

# Split the tests into 10 groups and run the second group
py.test --test-group-count 10 --test-group=2

# Assign tests pseudo-randomly into 10 groups, and run the second group
py.test --test-group-count 10 --test-group=2 --test-group-random-seed=12345

# Split the tests by files instead of items into 3 groups and run the second group.
# The groups might not be in the same size as each group contains full test files
py.test --test-group-count 10 --test-group=2 --test-group-by filename

Why would I use this?

Sometimes you may have some long running test jobs that take a while to complete. This can be a major headache when trying to run tests quickly. pytest-test-groups allows you to easily say “split my tests into groups of 10 tests and run the second group”. This is primarily useful in the context of CI builds.