tester_definition

type CompileStep struct {
	// Language is the compile language: "c", "make", "java", "python", or "auto".
	//   "c"      → invokes clang with default flags (-lm -Wall -Werror) + Flags
	//   "make"   → invokes make <Target>
	//   "java"   → invokes javac
	//   "python" → invokes python3 -m py_compile (syntax check)
	//   "auto"   → detects language via AutoDetect rules, then dispatches
	Language string

	// Source is the source file to compile (required when Language="c" or "java").
	Source string

	// Output is the compilation target (used by "c" and "make" only; ignored for java/python/auto).
	Output string

	// Flags are extra compiler flags appended (not replacing) after the default flags.
	Flags []string

	// IncludeParentDir adds -I.. to include the parent directory (e.g. for tensorhero.h).
	IncludeParentDir bool

	// AutoDetect is the ordered list of language detection rules (used only when Language="auto").
	// The first rule whose DetectFile exists in the submission directory wins.
	AutoDetect []LanguageRule
}

type LanguageRule struct {
	// DetectFile is the file whose existence signals this language (relative to submission dir).
	DetectFile string

	// Language is the compile language to use when matched ("java", "python", "c", "make").
	Language string

	// Source is the main source file for compilation. Defaults to DetectFile if empty.
	Source string

	// Flags are extra compiler flags (e.g. additional .java files for javac).
	Flags []string

	// RunCmd is the run command (e.g. "java", "python3") exposed via harness.DetectedLang.
	RunCmd string

	// RunArgs are the run arguments (e.g. ["-cp", ".", "TestE01"]) exposed via harness.DetectedLang.
	RunArgs []string
}

type TestCase struct {
	// Slug is the unique identifier for this test case. For now, it must match the slug of the stage from the course's YAML definition.
	Slug string

	// TestFunc is the function that'll be run against the user's code.
	TestFunc func(testCaseHarness *test_case_harness.TestCaseHarness) error

	// Timeout is the maximum amount of time that the test case can run for.
	Timeout time.Duration

	// RequiredFiles declares files that must exist in the submission directory.
	// The framework checks these before TestFunc; any missing file aborts the test.
	// nil or empty = skip check.
	RequiredFiles []string

	// CompileStep declares a compilation step executed after RequiredFiles check
	// and before TestFunc. nil = skip compilation.
	// The compiled output is written to {SubmissionDir}/{CompileStep.Output}.
	CompileStep *CompileStep

	// BeforeFunc is a custom pre-test hook executed after declarative checks
	// (RequiredFiles, CompileStep) and before TestFunc.
	// nil = skip. Returning an error skips TestFunc. Panics are recovered.
	// Shares the same TestCaseHarness instance as TestFunc.
	BeforeFunc func(testCaseHarness *test_case_harness.TestCaseHarness) error
}

type TesterDefinition struct {
	// Example: spawn_redis_server.sh
	ExecutableFileName       string
	LegacyExecutableFileName string

	TestCases          []TestCase
	AntiCheatTestCases []TestCase
}