Skip to main content

Parallelize pytest across CircleCI workers.

Project description

# pytest-circleci-parallelized

[![PyPI version](https://img.shields.io/pypi/v/pytest-circleci-parallelized.svg)](https://pypi.org/project/pytest-circleci-parallelized) [![Python versions](https://img.shields.io/pypi/pyversions/pytest-circleci-parallelized.svg)](https://pypi.org/project/pytest-circleci-parallelized) [![CircleCI build status](https://circleci.com/gh/ryanwilsonperkin/pytest-circleci-parallelized.svg?style=svg)](https://circleci.com/gh/ryanwilsonperkin/pytest-circleci-parallelized)

Parallelize pytest across CircleCI workers.

---

## Features

Leverage the builtin parallelism of CircleCI to run your test suites. Call `pytest` with the `--circleci-parallelize` flag to automatically split tests amongst nodes using the `circleci tests split` utility.

Read more about CircleCI test splitting [here][circleci-test-splitting].

```yaml
# .circleci/config.yml
version: 2
jobs:
test:
docker:
- image: circleci/python:3
parallelism: 10
steps:
- checkout
- run: pytest --circleci-parallelize
workflows:
version: 2
test:
jobs:
- test
```

## Installation

You can install "pytest-circleci-parallelized" via pip from [PyPI][pypi].

```sh
pip install pytest-circleci-parallelized
```

## Contributing

Contributors welcome! Tests can be run with [`tox`][tox]

## License

Distributed under the terms of the [MIT](/LICENSE) license, `pytest-circleci-parallelized` is free and open source software.

## Issues

If you encounter any problems, please [file an issue](new-issue) along with a detailed description.

[tox]: https://tox.readthedocs.io/en/latest/
[pypi]: https://pypi.org/project/pytest-circleci-parallelized/
[new-issue]: https://github.com/ryanwilsonperkin/pytest-circleci-parallelized/issues/new
[circleci-test-splitting]: https://circleci.com/docs/2.0/parallelism-faster-jobs/

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pytest-circleci-parallelized, version 0.0.4
Filename, size File type Python version Upload date Hashes
Filename, size pytest-circleci-parallelized-0.0.4.tar.gz (3.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page