Metadata-Version: 2.1
Name: pytest-circleci-parallelized-rjp
Version: 0.1.0
Summary: Parallelize pytest across CircleCI workers.
Home-page: https://github.com/RJPercival/pytest-circleci-parallelized
Author: Ryan Wilson-Perkin
Author-email: ryanwilsonperkin@gmail.com
Maintainer: Rob Percival
Maintainer-email: rob.percival87@gmail.com
License: MIT
Classifier: Framework :: Pytest
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Testing
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pytest

# pytest-circleci-parallelized

[![PyPI version](https://img.shields.io/pypi/v/pytest-circleci-parallelized-rjp.svg)](https://pypi.org/project/pytest-circleci-parallelized-rjp) [![Python versions](https://img.shields.io/pypi/pyversions/pytest-circleci-parallelized-rjp.svg)](https://pypi.org/project/pytest-circleci-parallelized-rjp) [![CircleCI build status](https://circleci.com/gh/RJPercival/pytest-circleci-parallelized.svg?style=svg)](https://circleci.com/gh/RJPercival/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-rjp" via pip from [PyPI][pypi].

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

## 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-rjp/
[new-issue]: https://github.com/RJPercival/pytest-circleci-parallelized/issues/new
[circleci-test-splitting]: https://circleci.com/docs/2.0/parallelism-faster-jobs/
