ciutil

type HostInfo struct {
	OS     string
	Arch   string
	Kernel string
}

type HostInfoInput struct {
	// The name a tool uses for Linux OSes (e.g. "linux", "unknown", etc.)
	OSLinux string
	// The name a tool uses for the Linux kernel (e.g. "linux", "linux-gnu", etc.)
	KernelLinux string
	// The name a tool uses for macOS (e.g. "apple")
	OSMacOS string
	// The name a tool uses for the macOS kernel (e.g. "darwin")
	KernelMacOS string
	// The name a tool uses for AMD64 architectures (e.g. "x86_64", "amd64", etc.)
	ArchAMD64 string
	// The name a tool uses for ARM64 architectures (e.g. "aarch64", "arm64", etc.)
	ArchARM64 string
}

type Repo struct {
	HasGo       bool
	HasPython   bool
	HasShell    bool
	HasMarkdown bool
}

type Tasker interface {
	// InfoText should return a human-readable display string that describes the task, e.g. "Run
	// tests". If this is unset, then its banner will not show in the CI log output at all (which
	// may be desirable) in the case of implementers of [Tasker.Init])
	InfoText() string
	// Run should perform the actual task's actions.
	Run() error
	// Post should perform any post-run actions for the task, if necessary.
	Post() error
}

type Tool struct {
	// The tool's name, used as an identifier. May also be the tool's invocable command, in which
	// case it can be interpolated as such.
	Name string
	// The installable path for the tool, like a URL. Can also be a format string, e.g. with
	// placeholders for platform-specific strings.
	RemotePath string
	// The version of the tool.
	Version string
	// The path to the tool's config file, if it has one to use.
	ConfigFilePath string
}