Struct Harness 

pub struct Harness { /* private fields */ }

Available on crate feature async-client only.

A running localharness process that has completed its stdio handshake.

Dropping this kills the process.

Implementations

impl Harness

pub async fn launch(options: &HarnessOptions) -> Result<Self>

Spawns the binary and performs the length-prefixed stdio handshake.

pub fn port(&self) -> u16

The loopback port the harness bound.

pub fn api_key(&self) -> &str

The per-process key the WebSocket upgrade must present.

pub fn stderr_tail(&self) -> String

The most recent harness stderr, which is where it reports model and configuration failures that never reach the wire.

This is a snapshot: output still in flight is not waited for. Use Self::stderr_after_exit when diagnosing a failure.

pub async fn stderr_after_exit(&self) -> String

The harness’s stderr, waited for.

A harness that hits a fatal error writes the reason to stderr and then exits, which breaks the socket. The client notices the broken socket first — so reading stderr at that instant is a race, and losing it turns a precise “API key not valid” into a bare “connection closed”. This waits (briefly, and only on failure paths) for the pipe to reach EOF, which happens exactly when the process is gone and its output is all in.

pub async fn shutdown(self) -> Result<()>

Waits for the process to exit, having asked it to stop.

Trait Implementations

impl Debug for Harness

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.