Merge nucleic/sleek-thistle-egret-fyej into dev

2026-07-18 05:19:31 -07:00
commit b6be87b72d
677 changed files with 102939 additions and 0 deletions
@@ -0,0 +1,40 @@
+//! Test harness library for brush shell integration tests.
+//!
+//! This crate provides a unified framework for running YAML-based integration tests
+//! that support both oracle-based comparison (comparing brush output against bash)
+//! and expectation-based testing (inline expectations or insta snapshots).
+//!
+//! # Modes of Operation
+//!
+//! 1. **Oracle comparison**: Runs both an oracle shell (e.g., bash) and the test shell (brush),
+//!    comparing their outputs. This is the traditional compatibility testing mode.
+//!
+//! 2. **Expectation-based**: Runs only the test shell and compares against inline expectations
+//!    specified in the YAML or against insta snapshots.
+//!
+//! 3. **Hybrid**: Combines both modes - runs oracle comparison AND validates against expectations.
+//!    Both must pass for the test to succeed.
+
+#![cfg(any(unix, windows))]
+#![allow(clippy::missing_panics_doc)]
+#![allow(clippy::unwrap_used)]
+
+mod comparison;
+mod config;
+mod execution;
+mod reporting;
+mod runner;
+mod testcase;
+pub mod util;
+
+pub use comparison::{
+    DirComparison, DirComparisonEntry, DurationComparison, ExitStatusComparison,
+    ExpectationComparison, OracleComparison, SingleExpectationComparison, SnapshotResult,
+    StringComparison, TestComparison,
+};
+pub use config::{
+    OracleConfig, OutputFormat, RunnerConfig, ShellConfig, TestMode, TestOptions, WhichShell,
+};
+pub use execution::RunResult;
+pub use runner::TestRunner;
+pub use testcase::{ShellInvocation, TestCase, TestCaseSet, TestFile};