core

type Checker struct {
	// contains filtered or unexported fields
}

type CommandCheckError struct {
	Command string
	Lineno  int
	Errs    []error
}

type CommandResult struct {
	Output   []byte
	ExitCode int
}

type DiffError struct {
	Expected string
	Actual   string
}

type Handler interface {
	// HandleComment processes comment lines and blank lines.
	// Corresponds to cmdt syntax: "# comment text" or blank lines.
	HandleComment(ctx context.Context, text string) error

	// HandleRun executes a shell command.
	// Corresponds to cmdt syntax: "$ command args".
	HandleRun(ctx context.Context, command string) error

	// HandleOutput processes expected output from a command.
	// The fd parameter indicates the file descriptor: 1 for stdout, 2 for stderr.
	// Corresponds to cmdt syntax: "1 stdout line" or "2 stderr line".
	HandleOutput(ctx context.Context, fd int, line string) error

	// HandleFileOutput processes expected output that references an external file.
	// The fd parameter indicates the file descriptor: 1 for stdout, 2 for stderr.
	// The filepath parameter specifies the file containing the expected output.
	// Corresponds to cmdt syntax: "1< filename" or "2< filename".
	HandleFileOutput(ctx context.Context, fd int, filepath string) error

	// HandleNoNewline indicates that the last output line did not end with a newline.
	// The fd parameter indicates which stream (stdout=1, stderr=2) lacks the newline.
	// Corresponds to cmdt syntax: "% no-newline".
	HandleNoNewline(ctx context.Context, fd int) error

	// HandleExitCode processes the expected exit code of a command.
	// If omitted in the transcript, the exit code defaults to 0.
	// Corresponds to cmdt syntax: "? exitcode".
	HandleExitCode(ctx context.Context, exitCode int) error

	// HandleEnd is called after a command and all its assertions have been processed.
	// This method has no direct cmdt syntax equivalent but signals command completion.
	HandleEnd(ctx context.Context) error
}

type Interpreter struct {
	// Input parameters.
	Handler Handler

	// Exposed state.
	Lineno        int    // Line currently executing.
	Command       string // Text of the most recently executed command.
	CommandLineno int    // Line of the most recently executed command.
	// contains filtered or unexported fields
}

type Recorder struct {
	// If provided, tees Stdout to this writer in addition to the buffer.
	Stdout io.Writer
	// If provided, tees Stderr to this writer in addition to the buffer.
	Stderr io.Writer
	// Transcript captures the recorded output in cmdt format.
	Transcript bytes.Buffer
	// contains filtered or unexported fields
}

type Updater struct {
	// contains filtered or unexported fields
}