matrix/at.asitplus.testballoon.matrix

Package-level declarations

Types

value class Cases

Property-layer replay selector: the recorded cases to re-run, pasted as replay = Cases(seed = 1L, iter = 2L). The flat (seed, iteration) form covers the common single-case paste; use Cases(Input(...), Input(...)) for several seeds at once, or the (seed, iterations) vararg / range forms for several iterations of one seed.

CompactConcurrency

sealed interface CompactConcurrency

CompactConfig

data class CompactConfig

CompactConfigBuilder

class CompactConfigBuilder

CompactReport

sealed interface CompactReport

CompactScope

class CompactScope : MatrixScope<CompactScope>

DataLayer

class DataLayer<T, S : MatrixScope<S>>

DataLayerConfig

data class DataLayerConfig

DataLayerConfigBuilder

class DataLayerConfigBuilder

ExecutionMode

sealed interface ExecutionMode

Indexes

value class Indexes

Data-layer replay selector: the case indexes to re-run, pasted from a failure report as replay = Indexes(3L). Construct from explicit indexes (Indexes(0L, 2L)) or a range (Indexes(0L..9L)).

Indicator

sealed interface Indicator

Input

data class Input(val seed: Long, val iterations: List<Long>)

One recorded property case to reproduce, copied from a failure's replay report. seed and iterations always travel together — iteration indexes only reproduce values relative to the seed that generated them, so they cannot be set independently.

MatrixCompactFixtureGeneratorHolder

value class MatrixCompactFixtureGeneratorHolder<T>

MatrixCompactFixtureGeneratorScope

class MatrixCompactFixtureGeneratorScope<T>

MatrixCompactLayer

class MatrixCompactLayer

MatrixConfiguredSuite

class MatrixConfiguredSuite

MatrixFixtureConfiguredSuite

class MatrixFixtureConfiguredSuite<T>

MatrixFixtureGeneratorHolder

value class MatrixFixtureGeneratorHolder<T>

MatrixFixtureGeneratorScope

class MatrixFixtureGeneratorScope<T>

MatrixScope

sealed interface MatrixScope<SELF : MatrixScope<SELF>>

Common surface shared by the real-tree MatrixSuiteScope and the virtual CompactScope. The data / property overloads below build a kind-neutral LayerSpec and hand it to dispatchContainer / dispatchTerminal, which route to the right scope's registration primitive (registerLayer / addLayer). So the public overloads live in exactly one place instead of being duplicated across the two scopes.

MatrixSuiteConfig

data class MatrixSuiteConfig

MatrixSuiteConfigBuilder

class MatrixSuiteConfigBuilder

MatrixSuiteScope

data class MatrixSuiteScope : MatrixScope<MatrixSuiteScope>

MatrixTestDsl

@DslMarker

annotation class MatrixTestDsl

NameFn

typealias NameFn<T> = (index: Long, value: T) -> String

PropertyLayer

class PropertyLayer<T, S : MatrixScope<S>>

PropertyLayerConfig

data class PropertyLayerConfig

PropertyLayerConfigBuilder

class PropertyLayerConfigBuilder

Functions

fixture

fun <T> CompactScope.fixture(generator: () -> T): MatrixCompactFixtureGeneratorHolder<T>

fun <T> MatrixSuiteScope.fixture(generator: () -> T): MatrixFixtureGeneratorHolder<T>

matrixConfig

fun matrixConfig(block: MatrixSuiteConfigBuilder.() -> Unit): MatrixSuiteConfigBuilder

Builds a reusable matrix configuration value to pass to test / testSuite (and their FreeSpec "name"(…) forms), e.g. testSuite("group", matrixConfig { execution = ExecutionMode.Concurrent(4) }) { … }. Unset fields inherit the enclosing matrix scope. testConfig is one of the fields, so this also carries aroundAll / aroundEach / context.

matrixSuite

fun matrixSuite(config: MatrixSuiteConfigBuilder = matrixConfig {}, propertyName: String = "", body: MatrixSuiteScope.() -> Unit): <Error class: unknown class>

Declares a top-level matrix test suite.

MatrixTestDefaults

fun <Error class: unknown class>.MatrixTestDefaults(config: MatrixSuiteConfigBuilder.() -> Unit)