suite-doctor

A pytest-integrated health checkup tool. Runs your existing test suite via pytest and reports on its health — not another test framework, a wrapper around the one you already use.

Status

Core pipeline working: runs pytest, parses results, prints a styled summary via the CLI. Flaky test detection in progress.

Why

pytest tells you pass/fail. suite-doctor tells you:

• Slowest tests, sorted
• Failures with short message + full traceback available
• Flaky tests — re-runs failures N times, flags inconsistent ones (in progress)
• Coverage summary — % covered, worst-covered files, untested functions (planned)
• Skipped/xfail counts
• Clean, colorized CLI output (via rich) instead of pytest's default verbose dump

How it works

Shells out to pytest --json-report (via pytest-json-report), parses the JSON, formats a summary. No pytest internals, no plugin hooks — just wraps the CLI you already run.

Requirements

suite-doctor

A pytest-integrated health checkup tool. Runs your existing test suite via pytest and reports on its health — not another test framework, a wrapper around the one you already use.

Status

Early development. Core subprocess runner in progress.

Why

pytest tells you pass/fail. suite-doctor tells you:

• Coverage summary — % covered, worst-covered files, untested functions
• Flaky tests — re-runs failures N times, flags inconsistent ones
• Slowest tests
• Skipped/xfail counts
• Clean CLI table output instead of pytest's default verbose dump

How it works

Shells out to pytest --json-report (via pytest-json-report), parses the JSON, formats a summary. No pytest internals, no plugin hooks — just wraps the CLI you already run.

Requirements

• Python 3.x
• pytest
• pytest-json-report
• pytest-cov

Install

pip install -e .

(placeholder — update once packaged)

Usage

suite-doctor <path-to-project>

(placeholder — update once CLI exists)

• Python 3.9+
• pytest
• pytest-json-report
• pytest-cov
• rich

Install

pip install -e .

Usage

suite-doctor <path-to-project>

Example:

suite-doctor ./test-project

Roadmap

• Subprocess runner (runner.py) — run pytest, capture JSON
• Parse results into summary/slowest/failures (report.py)
• CLI output with rich (cli.py)
• Flaky test detection (re-run failures)
• Coverage summary formatting
• --verbose flag for full tracebacks
• --top flag for slowest-N count