Crate test_better_core

Expand description

test-better-core: error and result types.

This crate is the foundation of the test-better testing library. It makes ? viable as the single control-flow operator of a test by providing:

TestError, the structured failure type, and its parts (ErrorKind, ContextFrame, Payload);
TestResult, the ?-friendly return type for tests and helpers;
ContextExt, which attaches “while doing X” context to a fallible value;
OrFail, the ?-friendly alternative to panicking on the error path;
Trace, which records in-test breadcrumbs attached to any failure;
StructuredError, the owned/serializable mirror that tooling consumes;
RUNNER_ENV/STRUCTURED_MARKER, the structured-output channel the optional cargo test-better runner consumes.

Structs§

ContextFrame: One human-readable frame in a TestError’s context chain.
SourceLocation: A source location, owned and serializable (the plain-data form of std::panic::Location).
StructuredContextFrame: The plain-data form of crate::ContextFrame.
StructuredError: The plain-data, owned, serializable mirror of TestError.
TestError: A test failure.
Trace: A scoped collector of in-test breadcrumbs.

RUNNER_ENV: The environment variable the runner sets on the cargo test it spawns.
STRUCTURED_MARKER: The sentinel that brackets the JSON structured-error payload on its own line in captured test output. Chosen to be unmistakable in prose and to sit alone on a line.

ContextExt: Attaches context to the failure path of a Result or the None of an Option.
OrFail: Converts a fallible value into a TestResult, producing a TestError on the failure path.

color_choice: Returns the process-wide ColorChoice.
set_color_choice: Sets the process-wide ColorChoice for rendered failures.