enginemap

type EngineOptions struct {
	Name                        string         `toml:"name"`
	Args                        []string       `toml:"args"`
	Options                     map[string]any `toml:"options,omitempty"`
	LogEngineString             bool           `toml:"log-engine-string"`
	AllowBadSubstringsInOptions bool           `toml:"allow-bad-substrings-in-options"`
	InitTimeout                 *time.Duration `toml:"init-timeout,omitempty"`
	WaitOnCancelTimeout         *time.Duration `toml:"wait-on-cancel-timeout,omitempty"`
	CreateTimeout               *time.Duration `toml:"create-timeout,omitempty"`
}

type Map interface {
	GetOptions(engine roomapi.JobEngine) (battle.EnginePoolOptions, error)
}

type Options struct {
	// Allows all the executables found in PATH to be run as chess engines as fallback.
	// SECURITY: May lead to remote code execution. Use only if you COMPLETELY TRUST THE SERVER AND
	// ALL ITS USERS WHO ARE ALLOWED TO RUN ENGINE CONTESTS.
	AllowPathDangerous bool `toml:"allow-path-dangerous"`

	// Allows all the executable from the given DIRs to be run as chess engines.
	// SECURITY: The server can execute ANY FILE from the provided dirs. Use with EXTREME CARE.
	AllowDirs []string `toml:"allow-dirs"`

	// Default options for engines found with AllowPathDangerous or AllowDirs.
	Default EngineOptions `toml:"default"`

	// Maps engine names to engine options.
	Engines map[string]EngineOptions `toml:"engines"`
}