Shard Slow Pytest Suites By Historic Timings Before Ci Bottlenecks Pile Up With Pytest Split

---
name: "Shard slow pytest suites by historic timings before CI bottlenecks pile up with pytest-split"
slug: "shard-slow-pytest-suites-by-historic-timings-before-ci-bottlenecks-pile-up-with-pytest-split"
description: "Lets an agent split a large pytest suite into timing-balanced shards so parallel CI lanes finish faster and with less variance."
github_stars: 308
verification: "security_reviewed"
source: "https://github.com/jerry-git/pytest-split"
author: "jerry-git"
publisher_type: "individual"
category: "CI/CD Integrations"
framework: "Multi-Framework"
tool_ecosystem:
  github_repo: "jerry-git/pytest-split"
  github_stars: 308
  npm_package: "pytest-split"
  npm_weekly_downloads: 12820130
---

# Shard slow pytest suites by historic timings before CI bottlenecks pile up with pytest-split

Lets an agent split a large pytest suite into timing-balanced shards so parallel CI lanes finish faster and with less variance.

## Prerequisites

Python, pytest, pytest-split

## Installation

Use the upstream install or setup path that matches your environment:
- pip install pytest-split

Requirements and caveats from upstream:
- [![PyPI](https://img.shields.io/pypi/v/pytest-split?style=flat-square)](https://pypi.python.org/pypi/pytest-split/)
- [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pytest-split?style=flat-square)](https://pypi.python.org/pypi/pytest-split/)
- [![PyPI - License](https://img.shields.io/pypi/l/pytest-split?style=flat-square)](https://pypi.python.org/pypi/pytest-split/)

Basic usage or getting-started notes:
- For example, some test suites may be fragile considering the order in which the tests are executed.
- sh
- First we have to store test durations from a complete test suite run.

- Source: https://github.com/jerry-git/pytest-split
- Extracted from upstream docs: https://raw.githubusercontent.com/jerry-git/pytest-split/HEAD/README.md

## Documentation

- https://github.com/jerry-git/pytest-split

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/shard-slow-pytest-suites-by-historic-timings-before-ci-bottlenecks-pile-up-with-pytest-split/)