engine

type Engine interface {
	// Setup the pipeline environment.
	Setup(context.Context, *Spec) error

	// Run runs the pipeine step.
	Run(context.Context, *Spec, *Step, io.Writer) (*State, error)

	// Create creates the pipeline state.
	Create(context.Context, *Spec, *Step) error

	// Start the pipeline step.
	Start(context.Context, *Spec, *Step) error

	// Wait for the pipeline step to complete and returns the completion results.
	Wait(context.Context, *Spec, *Step) (*State, error)

	// Tail the pipeline step logs.
	Tail(context.Context, *Spec, *Step) (io.ReadCloser, error)

	// Destroy the pipeline environment.
	Destroy(context.Context, *Spec) error
}

type File struct {
	Path  string `json:"path,omitempty"`
	Mode  uint32 `json:"mode,omitempty"`
	Data  []byte `json:"data,omitempty"`
	IsDir bool   `json:"is_dir,omitempty"`
}

type Platform struct {
	OS      string `json:"os,omitempty"`
	Arch    string `json:"arch,omitempty"`
	Variant string `json:"variant,omitempty"`
	Version string `json:"version,omitempty"`
}

type RunPolicy int

type Secret struct {
	Name string `json:"name,omitempty"`
	Env  string `json:"env,omitempty"`
	Data []byte `json:"data,omitempty"`
	Mask bool   `json:"mask,omitempty"`
}

type Spec struct {
	// Metadata Metadata  `json:"metadata,omitempty"`
	Platform Platform `json:"platform,omitempty"`
	Root     string   `json:"root,omitempty"`
	Files    []*File  `json:"files,omitempty"`
	Steps    []*Step  `json:"steps,omitempty"`
}

type State struct {
	ExitCode  int  // Container exit code
	Exited    bool // Container exited
	OOMKilled bool // Container is oom killed
}

type Step struct {
	Args         []string          `json:"args,omitempty"`
	Command      string            `json:"command,omitempty"`
	Detach       bool              `json:"detach,omitempty"`
	DependsOn    []string          `json:"depends_on,omitempty"`
	Envs         map[string]string `json:"environment,omitempty"`
	Files        []*File           `json:"files,omitempty"`
	IgnoreErr    bool              `json:"ignore_err,omitempty"`
	IgnoreStdout bool              `json:"ignore_stderr,omitempty"`
	IgnoreStderr bool              `json:"ignore_stdout,omitempty"`
	Name         string            `json:"name,omitempt"`
	RunPolicy    RunPolicy         `json:"run_policy,omitempty"`
	Secrets      []*Secret         `json:"secrets,omitempty"`
	WorkingDir   string            `json:"working_dir,omitempty"`
}