services

type APIService interface {
	// Initialize configures the APIService with a default server and API key.
	Initialize(server, APIKey string) error

	// These functions are for convenience; for most cases, the server and API
	// key don't change over the life of the command.
	Get(URL string, body []byte) (res string, statusCode int, err error)
	Post(URL string, body []byte) (res string, statusCode int, err error)

	GetJSON(URL string, body []byte, v interface{}) (statusCode int, err error)
	PostJSON(URL string, body []byte, v interface{}) (statusCode int, err error)

	// This is the underlying implementation of the APIService's functionality.
	MakeAPIRequest(endpoint *url.URL, method, APIKey string, body []byte) (res []byte, statusCode int, err error)
}

type ExecService interface {
	RunCWD(cmd string, args ...string) (stdout string, stderr string, err error)
	Run(dir string, cmd string, args ...string) (stdout string, stderr string, err error)

	Which(args []string, candidates ...string) (cmd string, version string, err error)
	WhichWithResolver(resolver WhichResolver, candidates ...string) (cmd string, version string, err error)
}

type FileService interface {
	HasFile(pathElems ...string) bool
	HasFolder(pathElems ...string) bool
	ReadFile(pathElems ...string) ([]byte, error)
	ReadJSON(v interface{}, pathElems ...string) error
	ReadUnmarshal(unmarshal UnmarshalFunc, v interface{}, pathElems ...string) error
}

type LogService interface {
	// Returns the spinner. There should only be at most one spinner active at
	// one time.
	Spinner() Spinner

	// Debug statements are meant for diagnosing and resolving issues. They are
	// not shown unless `--debug` is specified. When `--debug` is set, all
	// statements are logged with extra debug information.
	Debugf(format string, args ...interface{})

	// Notices inform the user of a non-error condition that is important.
	Noticef(format string, args ...interface{})

	// Warnings inform the user of a non-fatal error condition.
	Warningf(format string, args ...interface{})

	// Fatals cause the program to exit with a non-zero exit code. They inform
	// the user of fatal error conditions.
	Fatalf(format string, args ...interface{})

	// Printing sends output to STDOUT.
	Printf(format string, args ...interface{})
}

type Services struct {
	Logger     LogService
	API        APIService
	Exec       ExecService
	FileSystem FileService
}

type Spinner interface {
	Spin(message string)
	Stop()
}

type TimeoutError = error

type UnmarshalFunc func(data []byte, v interface{}) error

type WhichResolver func(cmd string) (version string, ok bool)