Struct TestRunner 

pub struct TestRunner { /* private fields */ }

Top-level test runner.

Implementations

impl TestRunner

pub fn new(config: TestConfig, overrides: CliOverrides) -> Self

Build a runner with no programmatic suite hooks. For runners that need before_all / after_all closures, use TestRunner::with_hooks.

pub fn with_hooks( config: TestConfig, hooks: TestHooks, overrides: CliOverrides, ) -> Self

Build a runner with programmatic suite hooks supplied at construction.

pub fn add_reporter(&mut self, reporter: Box<dyn Reporter>)

Append an additional reporter after construction (e.g., NAPI ResultCollector).

pub async fn run(&mut self, plan: TestPlan) -> i32

Run the full test plan. Returns exit code (0 = all passed).

When config.projects is non-empty, topologically sorts projects by dependencies and runs each with a merged config. Otherwise runs the plan directly (single-project path).

Convenience wrapper: creates an EventBus, subscribes a ReporterDriver, and delegates to execute(). For real-time external observation (TUI, WebSocket), use execute() directly with a custom bus.

pub async fn execute(&self, plan: TestPlan, event_bus: EventBus) -> i32

Core execution engine. Emits events on the provided EventBus.

Takes &self — no reporter ownership, no mutable state. The caller controls who subscribes to the bus (reporters, TUI, external consumers).

The bus is consumed by value and dropped when execution completes, closing all subscriber channels and signaling consumers to finalize.

pub async fn run_watch<F>( &mut self, plan_factory: F, watch_root: PathBuf, ) -> i32

where F: Fn(Option<&[PathBuf]>) -> TestPlan,

Run in watch mode: re-run tests on file changes with interactive keyboard controls.

Launches a browser once and reuses it across all runs. Watches the project directory for file changes and dispatches re-runs based on change type.

Arguments

• plan_factory — Closure that generates a TestPlan. Receives an optional slice of changed file paths — when Some, the factory should only re-process those files (e.g., re-parse only changed .feature files). When None, generate the full plan.
• watch_root — Root directory to watch for file changes.