TestGenerationContext

SPI-facing context for rule/provider evaluation during test generation.

This contract is intentionally small and stable. Concrete orchestration may carry more internal state than what is exposed here.

Determinism: providers and rules should treat this context as immutable and avoid side effects.

Properties

Provider for basic test data values (e.g., strings, integers).

Optional budget limiting schema combinations to prevent explosion.

abstract val depth: Int

Current recursion depth in schema traversal.

abstract val maxDepth: Int

Maximum schema traversal depth.

abstract val openAPI: OpenAPI

The parsed OpenAPI specification being processed.

abstract val operation: Operation

The current operation being processed.

Generator for deriving example values from schemas.

Merger for composed schemas (allOf/anyOf/oneOf).

Path of property/item names leading to the current schema location.

Provider for security scheme values.

The valid (baseline) test case from which negative cases are derived.

Set of $ref pointers already visited in the current traversal path.

abstract fun checkSkip(schema: Schema<*>): SkipReason?

Checks if the schema should be skipped based on cycles or depth.

Returns a new context with the schema visited, or null if it should be skipped.