Class UserFuzzRunner

java.lang.Object

org.ek9lang.compiler.fuzz.UserFuzzRunner

public final class UserFuzzRunner
extends Object

Orchestrates user-facing fuzz operations: test generation and mutation testing. Manages the compile-check loop that filters candidates down to survivors, and handles output file/directory generation.

Follows the proven pattern from FuzzRunner: generate candidates, compile-check each through PRE_IR_CHECKS in-process, keep survivors.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	UserFuzzRunner.FuzzResult	Result of a user fuzz operation.

Constructor Summary

Constructors

Constructor	Description
UserFuzzRunner(SharedThreadContext<CompilableProgram> sharedContext, FileHandling fileHandling, CompilerReporter compilerReporter)

Method Summary

Modifier and Type	Method	Description
UserFuzzRunner.FuzzResult	generateMutations(File sourceFile, String outputDir, long seed, int candidateCount)	Mode 2: Generate mutated variants of the given source file.
UserFuzzRunner.FuzzResult	generateTests(File sourceFile, String outputPath, long seed, int candidateCount)	Mode 1: Generate edge-case @Test functions for the given source file.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

UserFuzzRunner

public UserFuzzRunner(SharedThreadContext<CompilableProgram> sharedContext,
 FileHandling fileHandling,
 CompilerReporter compilerReporter)

Method Details

generateTests

public UserFuzzRunner.FuzzResult generateTests(File sourceFile,
 String outputPath,
 long seed,
 int candidateCount)

Mode 1: Generate edge-case @Test functions for the given source file.

Parameters:

sourceFile - the .ek9 file to analyze

outputPath - the output .ek9 file path

seed - reproducibility seed (-1 for random)

candidateCount - max candidates to generate (-1 for default)

Returns:

the fuzz result, or null on failure

generateMutations

public UserFuzzRunner.FuzzResult generateMutations(File sourceFile,
 String outputDir,
 long seed,
 int candidateCount)

Mode 2: Generate mutated variants of the given source file.

Parameters:

sourceFile - the .ek9 file to mutate

outputDir - the output directory path

seed - reproducibility seed (-1 for random)

candidateCount - max candidates to generate (-1 for default)

Returns:

the fuzz result, or null on failure