Expand description
Assay — Nix unit testing framework (claim algebra + isolated eval runner).
Re-exports§
pub use caps::AssayEnv;pub use caps::ClockKey;pub use caps::FakeStore;pub use caps::FsSnapshotStoreLive;pub use caps::LiveClockLive;pub use caps::MockNixEval;pub use caps::NixEvaluatorKey;pub use caps::NixWorkerPoolKey;pub use caps::ProcessNixEvalLive;pub use caps::SemaphoreWorkerPoolLive;pub use caps::SnapshotStoreKey;pub use caps::live_providers;pub use caps::require_store;pub use claims::Claim;pub use claims::build_module_eval_expr;pub use claims::interpret_claim;pub use compat::CompatCase;pub use compat::CompatSuite;pub use compat::load_compat_suite;pub use discover::SuiteFile;pub use discover::discover_suites;pub use eval::EvalBackend;pub use eval::EvalResult;pub use eval::NixEval;pub use eval::ProcessNixEval;pub use laws::run_builtin_laws;pub use laws::run_law_by_name;pub use outcome::AssayOutcome;pub use outcome::run_case;pub use pool::MockWorkerPool;pub use pool::NixWorkerPool;pub use pool::PoolStats;pub use pool::SemaphoreWorkerPool;pub use report::ReportFormat;pub use report::report_outcomes_stdout;pub use run::RunOptions;pub use run::RunSummary;pub use run::SuiteReport;pub use run::run_discovered;pub use run::run_suite;pub use run::summarize;pub use schema::decode_claim_json;pub use schema::decode_suite_cases;pub use schema::encode_claim_json;pub use snapshot::SnapshotStore;pub use verdict::CaseVerdict;pub use verdict::InfraError;pub use verdict::exit_to_outcome;pub use verdict::outcome_to_exit;
Modules§
- assay_
suite - Load Assay-native suites:
{ name, cases = { case = { claim, ... }; }; }. - batch
- Suite-/repo-level batched Nix evaluation via
builtins.tryEval. - caps
- Capability keys and providers for Assay DI 3.0 (
#[capability],ProviderSpec,provide!). - claims
- Claim algebra interpreter —
EffectoverAssayEnvreturningCaseVerdict. - compat
- nix-unit /
lib.runTestscompatibility: load{ name = { expr; expected; }; }suites. - discover
- Discover assay suite files under a directory tree.
- eval
- Isolated Nix evaluation backends.
- force
- Force-set coverage claims (
forces paths). - laws
- Algebraic laws for JSON object merge (
//-style, last-wins). - outcome
- Assay outcome taxonomy — first-class Pass/Fail/EvalError and related exits.
- pool
- Bounded concurrency for Nix evaluator subprocesses (wave 3).
- prop
- Deterministic property generators and trial runner.
- report
- Streaming reporter for assay outcomes.
- run
- Run assay suites and collect
Exitoutcomes. - schema
- Schema decode/encode for
Claimand assay suite JSON via id_effect. - simple_
eval - snapshot
- Golden snapshot store — read, write, and assert JSON fixtures on disk.
- timeout
- Deterministic timeouts and flaky-eval retry via [
TestClock]. - verdict
- Case verdict vs infrastructure error — id_effect
Exitmodel (D2).