SUMAN/TESTSuman

A systems-minded test runner

A test runner designed for the whole system.

Tests live in files, but test work spans orchestration, processes, reporting, watch state, and developer feedback. Suman treats that surrounding system as part of the runner rather than a collection of afterthoughts.

Fast execution matters. So does knowing what the runner is doing around it.

Parallel execution · reporters · watch · daemon · interactive

01 / PRINCIPLES

What the system protects.

Orchestrated execution

Coordinate suites and workers across a larger test topology.

Useful feedback

Route results through reporters and interactive development workflows.

Ecosystem pieces

Treat watch processes, daemons, and companion tools as designed interfaces.

02 / METHOD

A visible sequence.

  1. 01

    Discover

    Resolve the intended suite and execution graph.

  2. 02

    Run

    Use available concurrency without losing test identity.

  3. 03

    Report

    Make failure context useful to people and automation.

A runner earns trust one intelligible failure at a time.

github.com/sumanjs