env

type Capture struct {
	Stdout   string
	Stderr   string
	ExitCode int
}

type DirEntry struct {
	// Name is the entry basename.
	Name string
	// IsDir reports whether the entry is a directory.
	IsDir bool
}

type ExecOptions struct {
	// Command runs through the platform shell when Argv is empty.
	Command string
	// Argv runs the binary directly without a shell when non-empty.
	Argv []string
	Dir  string
	// Timeout is the context governing cancellation and deadlines.
	Timeout context.Context
}

type ExecutionEnv interface {
	ReadFile(ctx context.Context, path string) result.Result[[]byte, result.FileError]
	WriteFile(ctx context.Context, path string, data []byte, perm os.FileMode) result.Result[struct{}, result.FileError]
	MkdirAll(ctx context.Context, path string, perm os.FileMode) result.Result[struct{}, result.FileError]
	Remove(ctx context.Context, path string) result.Result[struct{}, result.FileError]
	ReadDir(ctx context.Context, path string) result.Result[[]DirEntry, result.FileError]
	Exec(ctx context.Context, opts ExecOptions) result.Result[Capture, result.ExecutionError]
}

type OSExecutionEnv struct{}