container

type Container interface {
	Create(capAdd, capDrop []string) common.Executor
	Copy(destPath string, files ...*FileEntry) common.Executor
	CopyTarStream(ctx context.Context, destPath string, tarStream io.Reader) error
	CopyDir(destPath, srcPath string, useGitIgnore bool) common.Executor
	GetContainerArchive(ctx context.Context, srcPath string) (io.ReadCloser, error)
	Pull(forcePull bool) common.Executor
	Start(attach bool) common.Executor
	Exec(command []string, env map[string]string, user, workdir string) common.Executor
	UpdateFromEnv(srcPath string, env *map[string]string) common.Executor
	UpdateFromImageEnv(env *map[string]string) common.Executor
	Remove() common.Executor
	Close() common.Executor
	ReplaceLogWriter(io.Writer, io.Writer) (io.Writer, io.Writer)
	IsHealthy(ctx context.Context) (time.Duration, error)
}

type ExecutionsEnvironment interface {
	Container
	ToContainerPath(string) string
	GetName() string
	GetRoot() string
	// BackendID returns a stable, unique identifier for the back-end.
	// Format: lowercase ASCII, alphanumeric plus dashes/underscores (slug form).
	// Used in error messages, log fields, and (for plugins) matching against
	// runs-on labels. Must be unique across registered back-ends. Renames are
	// breaking.
	BackendID() string
	// SupportsDockerContainerActions reports whether the back-end can run a
	// step that requires a Docker container action: `uses: docker://image` or
	// an action whose `runs.using: docker`. It does not gate job-level
	// `container:`, `services:`, or JS/composite actions.
	SupportsDockerContainerActions() bool
	// ManagesOwnNetworking reports whether the back-end provides its own
	// networking, in which case the runner skips creating the shared Docker
	// network used for services and aliases.
	ManagesOwnNetworking() bool
	GetActPath() string
	GetPathVariableName() string
	DefaultPathVariable() string
	JoinPathVariable(...string) string
	GetRunnerContext(ctx context.Context) map[string]any
	// On windows PATH and Path are the same key
	IsEnvironmentCaseInsensitive() bool
}

type FileEntry struct {
	Name string
	Mode int64
	Body string
}

type HostEnvironment struct {
	Name      string
	Path      string
	TmpDir    string
	ToolCache string
	Workdir   string
	ActPath   string
	Root      string
	StdOut    io.Writer
	LXC       bool
}

type NewContainerInput struct {
	Image           string
	Username        string
	Password        string
	Entrypoint      []string
	Cmd             []string
	Init            bool
	TTY             bool
	WorkingDir      string
	Env             []string
	ToolCache       string
	Binds           []string
	Mounts          map[string]string
	Name            string
	Stdout          io.Writer
	Stderr          io.Writer
	NetworkMode     string
	Privileged      bool
	UsernsMode      string
	DefaultPlatform string // platform if not overridden in JobOptions
	NetworkAliases  []string
	ExposedPorts    map[PortSpec]struct{}
	PortBindings    map[PortSpec][]PortBinding

	ConfigOptions string
	JobOptions    string

	ValidVolumes []string
}

type PortBinding struct {
	HostIP   string
	HostPort string
}

type PortSpec string