Skip to main content

Crate assay

Crate assay 

Source
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 — Effect over AssayEnv returning CaseVerdict.
compat
nix-unit / lib.runTests compatibility: 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 Exit outcomes.
schema
Schema decode/encode for Claim and 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 Exit model (D2).

Enums§

Exit
Final outcome of an effect: either a success value or a structured failure Cause.