Skip to main content

Module engine

Module engine 

Source
Expand description

Unified Demo Engine Trait

Per specification SIMULAR-DEMO-001: All demos MUST implement DemoEngine. This trait ensures:

  • YAML-first configuration (single source of truth)
  • Deterministic replay (same seed → same output)
  • Renderer independence (TUI/WASM produce identical state sequences)
  • Metamorphic testing support
  • Falsification criteria evaluation

§Peer-Reviewed Foundation

  • Chen et al. (2018): Metamorphic testing
  • Lavoie & Hendren (2015): Deterministic replay
  • Faulk et al. (2020): Property-based testing for scientific code

Structs§

CriterionResult
Result of evaluating a falsification criterion.
DemoMeta
Demo metadata from YAML configuration.
FalsificationCriterion
A single falsification criterion.
MetamorphicRelation
A metamorphic relation for testing without oracles.
MrResult
Result of verifying a metamorphic relation.

Enums§

DemoError
Errors that can occur in demo operations.
Severity
Severity levels for falsification criteria.

Traits§

DemoEngine
MANDATORY trait for ALL demos (EDD-compliant).
DeterministicReplay
Helper trait for demos that support deterministic replay.
RendererIndependent
Helper trait for demos with renderer-independent core logic.