helpers

type Helpers interface {
	JobHelper
	PodHelper
	ServiceHelper
}

type JobHelper interface {
	// WaitJobCompleted waits for the Job to be completed for up to the given timeout (in seconds) and returns
	// a boolean indicating if the status was reached. If the job is Failed an error is returned.
	WaitJobCompleted(name string, timeout uint) (bool, error)
}

type PodExecOptions struct {
	Pod       string   // name of the Pod to execute the command in
	Container string   // name of the container to execute the command in
	Command   []string // command to be executed with its parameters
	Stdin     []byte   // stdin to be supplied to the command
	Timeout   uint     // number of seconds allowed to wait for completion
}

type PodExecResult struct {
	Stdout []byte
	Stderr []byte
}

type PodHelper interface {
	// ExecuteInPod executes a non-interactive command described in options and returns the stdout and stderr outputs
	ExecuteInPod(options PodExecOptions) (*PodExecResult, error)
	// WaitPodRunning waits for the Pod to be running for up to given timeout (in seconds) and returns
	// a boolean indicating if the status was reached. If the pod is Failed returns error.
	WaitPodRunning(name string, timeout uint) (bool, error)
}

type ServiceHelper interface {
	// WaitServiceReady waits for the given service to have at least one endpoint available
	// or the timeout (in seconds) expires. It returns a boolean indicating if the service is ready
	WaitServiceReady(service string, timeout uint) (bool, error)
	// GetExternalIP returns one external ip for the given service. If none is assigned after the timeout
	// expires, returns an empty address "".
	GetExternalIP(service string, timeout uint) (string, error)
}