vm_testing library

Classes

CallbackWebSocketScenarioTransport
CucumberExpression
A compiled Cucumber Expression. It deliberately keeps the feature text plain: placeholders are automation glue, not feature metadata.
EvidenceEnvelope
EvidenceRecord
The one current semantic evidence record.
EvidenceWriter
ExecutionResult
ExecutionResultWriter
FlutterDriverFactory<W extends ScenarioWorld>
Flutter projects implement this in a project-owned testWidgets entrypoint so the runner never creates a second Flutter test world.
HttpDriverFactory<W extends ScenarioWorld>
HTTP projects implement this with their logical endpoint registry and fixture lifecycle. The runner only depends on the world contract.
InMemoryWebSocketScenarioTransport
MapScenarioWorld
RecordingWebSocketScenarioSink
ResolvedScenarioContract
The parsed Gherkin nodes matched by a generated scenario contract.
ScenarioExampleCase
One executable instance of a Gherkin scenario.
ScenarioExecutor<W extends ScenarioWorld>
ScenarioResult
ScenarioWorld
StepDataTable
A Gherkin step data table.
StepDefinition<W extends ScenarioWorld>
StepDocString
A Gherkin step doc string.
StepMatch<W extends ScenarioWorld>
StepParameterType<T>
A typed transformation used by generated Gherkin step support.
StepParameterTypeRegistry
Registry for Cucumber-style parameter transformations.
StepRegistry<W extends ScenarioWorld>
StepResult
SuiteEvidenceEmitter
Emits deterministic passed suite evidence for non-Gherkin test bodies.
SuiteResult
Raw result produced by an ordinary test adapter. It is deliberately not an EvidenceRecord: only the CLI may bind a result to current workspace digests and publish semantic evidence.
TargetDriverFactory<W extends ScenarioWorld>
WebSocketScenarioDriver
WebSocketScenarioTransport
Portable transport boundary for deterministic WebSocket scenario tests.
ZukeFeatureLoader
Resolves a feature from a Zuke workspace without project-specific current-working-directory fallbacks in every test entrypoint.

Enums

ScenarioStatus
StepStatus
StepTier
Resolution order is semantic, not an accidental priority convention. Project steps can refine vendor vocabulary, but cannot shadow generated feature steps; ambiguity remains an error within the selected tier.
SuiteStatus

Functions

buildStepRegistry<W extends ScenarioWorld>(Iterable<StepDefinition<W>> definitions) → StepRegistry<W>
Builds a registry from an expression-friendly iterable of definitions.
connectVmWebSocketScenario(Uri uri, {Map<String, dynamic>? headers}) → Future<WebSocketScenarioTransport>
Connects a VM test to a real WebSocket while preserving the portable scenario-driver lifecycle and bounded receive behavior.
defaultZukeDescription(ZukeScenarioContract scenario, String? caseId) → String
Computes the canonical display description for a scenario test.
matchScenarioContracts<T extends ZukeScenarioContract>(Iterable<T> contracts, ZukeScenarioPattern pattern) → List<T>
Selects contracts in declaration order, requiring at least one match.
resolveScenarioContract(ParsedFeature feature, ZukeScenarioContract contract) → ResolvedScenarioContract
Resolves contract against feature and rejects any generated-contract drift before a scenario can emit evidence.
resolveScenarioContracts<T extends ZukeScenarioContract>(ParsedFeature feature, Iterable<T> contracts, ZukeScenarioPattern pattern) → List<ResolvedScenarioContract>
Matches and resolves generated contracts before a harness registers tests.
scenarioExampleCaseAt(GherkinScenario scenario, {required int examplesIndex, required int rowIndex}) → ScenarioExampleCase
Resolves one executable case and validates its indexes.
scenarioExampleCaseId(ScenarioExampleCase exampleCase) → String?
Returns the stable managed identity for one scenario case.
scenarioExampleCases(GherkinScenario scenario) → Iterable<ScenarioExampleCase>
Enumerates every executable case for scenario in source order.
scenarioFilterFromEnvironment(Map<String, String> environment) → Set<String>
Parses the runner's stable scenario-ID allow-list.
shouldRunScenario(String scenarioId, Set<String> selectedScenarioIds) → bool
Returns whether scenarioId is selected, treating an empty filter as all.
zukeTest(FutureOr body(), {required ZukeScenarioContract scenario, String? description, Iterable<String> evidenceTypes = const [], Set<ControlId> provedControls = const {}, Iterable<String> provedImplementationSlots = const [], String? caseId, String? testOn, Timeout? timeout, Object? skip, Object? tags, Map<String, dynamic>? onPlatform, int? retry}) → void
Registers a normal Dart test that can publish evidence when launched by the Zuke CLI.
zukeUnit(FutureOr body(), {required ZukeScenarioContract scenario, String? description, Set<ControlId> provedControls = const {}, Iterable<String> provedImplementationSlots = const ['primary'], String? caseId, String? testOn, Timeout? timeout, Object? skip, Object? tags, Map<String, dynamic>? onPlatform, int? retry}) → void
Registers a unit-oriented managed test with the stable Zuke defaults.

Typedefs

StepAction<W extends ScenarioWorld> = FutureOr<void> Function(W world, GherkinStep step, Map<String, String> arguments)
TransformedStepAction<W extends ScenarioWorld> = FutureOr<void> Function(W world, GherkinStep step, List<Object?> values)
Callback used by generated Cucumber Expression support. Values have already passed through their registered parameter transformers.
WebSocketScenarioClose = FutureOr<void> Function({int? code, String? reason})
WebSocketScenarioSend = FutureOr<void> Function(Object? message)