engine

type BuildOptions struct {
	// Context is the build context directory COPY and ADD read from.
	Context string
	// File is the Containerfile path; empty selects Containerfile, then
	// Dockerfile, in Context.
	File string
	// Tag is the reference the built image is stored under.
	Tag string
	// BuildArgs override ARG defaults.
	BuildArgs map[string]string
	// Target selects the stage to build; empty builds the last one.
	Target string
}

type Container struct {
	Name       string
	Image      string
	Status     string
	Entrypoint []string
	PID        int
	Created    time.Time
	Options    RunOptions
}

type Engine struct {
	Root string
}

type ExecOptions struct {
	Command []string
	Env     []string
	WorkDir string
	User    string
	TTY     bool
}

type IO struct {
	Stdin  io.Reader
	Stdout io.Writer
	Stderr io.Writer
}

type Image struct {
	Reference string
	Digest    string
	Rootfs    string
	Config    v1.Config
	Created   time.Time
	Platform  v1.Platform
}

type Lifecycle interface {
	Run(context.Context, RunOptions, IO) (int, error)
	Start(context.Context, string, IO) (int, error)
	Exec(context.Context, string, ExecOptions, IO) (int, error)
	Stop(context.Context, string, time.Duration) error
	Remove(context.Context, string, bool) error
	Inspect(context.Context, string) (*Container, error)
	List(context.Context) ([]Container, error)
}

type Mount struct {
	Source   string
	Target   string
	ReadOnly bool
}

type RunOptions struct {
	Name        string
	Image       string
	Command     []string
	Entrypoint  []string
	Env         []string
	WorkDir     string
	User        string
	Hostname    string
	Mounts      []Mount
	Labels      map[string]string
	TTY         bool
	Interactive bool
	Remove      bool
	Network     string
	// UserNS selects the user namespace mapping: "" maps the caller to
	// container root; "keep-id" maps the caller to its own UID/GID and
	// container root to a subordinate ID, like podman --userns=keep-id.
	UserNS string
}