dockercompose

type ComposeCapabilityMapper struct{}

type ComposeExecutor interface {
	// Up starts services defined in the compose file.
	Up(ctx context.Context, projectDir string, files ...string) (string, error)

	// Down stops and removes services defined in the compose file.
	Down(ctx context.Context, projectDir string, files ...string) (string, error)

	// Ps lists running containers for the compose project.
	Ps(ctx context.Context, projectDir string, files ...string) (string, error)

	// Logs retrieves logs from compose services.
	Logs(ctx context.Context, projectDir string, service string, files ...string) (string, error)

	// Version returns the docker compose version string.
	Version(ctx context.Context) (string, error)

	// IsAvailable checks whether docker compose is installed and reachable.
	IsAvailable(ctx context.Context) error
}

type ComposeFile struct {
	// Services maps service names to their definitions.
	Services map[string]*ComposeService `yaml:"services" json:"services"`

	// Networks maps network names to their definitions.
	Networks map[string]*ComposeNetwork `yaml:"networks,omitempty" json:"networks,omitempty"`

	// Volumes maps volume names to their definitions.
	Volumes map[string]*ComposeVolume `yaml:"volumes,omitempty" json:"volumes,omitempty"`
}

type ComposeNetwork struct {
	// Driver is the network driver (e.g., "bridge", "overlay").
	Driver string `yaml:"driver,omitempty" json:"driver,omitempty"`

	// External indicates whether the network is externally managed.
	External bool `yaml:"external,omitempty" json:"external,omitempty"`

	// Labels are metadata key-value pairs.
	Labels map[string]string `yaml:"labels,omitempty" json:"labels,omitempty"`

	// DriverOpts holds driver-specific options.
	DriverOpts map[string]string `yaml:"driver_opts,omitempty" json:"driver_opts,omitempty"`

	// IPAM configures IP address management.
	IPAM *IPAMConfig `yaml:"ipam,omitempty" json:"ipam,omitempty"`
}

type ComposeService struct {
	// Image is the Docker image to use.
	Image string `yaml:"image" json:"image"`

	// ContainerName is an explicit container name.
	ContainerName string `yaml:"container_name,omitempty" json:"container_name,omitempty"`

	// Ports maps host ports to container ports.
	Ports []string `yaml:"ports,omitempty" json:"ports,omitempty"`

	// Environment holds environment variable definitions.
	Environment map[string]string `yaml:"environment,omitempty" json:"environment,omitempty"`

	// Volumes are volume mounts for the service.
	Volumes []string `yaml:"volumes,omitempty" json:"volumes,omitempty"`

	// Networks lists the networks this service is attached to.
	Networks []string `yaml:"networks,omitempty" json:"networks,omitempty"`

	// DependsOn lists services that must start before this one.
	DependsOn []string `yaml:"depends_on,omitempty" json:"depends_on,omitempty"`

	// Deploy holds deployment configuration like replicas and resource limits.
	Deploy *DeployConfig `yaml:"deploy,omitempty" json:"deploy,omitempty"`

	// Healthcheck defines a container health check.
	Healthcheck *HealthcheckConfig `yaml:"healthcheck,omitempty" json:"healthcheck,omitempty"`

	// Restart is the restart policy.
	Restart string `yaml:"restart,omitempty" json:"restart,omitempty"`

	// Command overrides the default container command.
	Command string `yaml:"command,omitempty" json:"command,omitempty"`

	// Labels are metadata key-value pairs applied to the container.
	Labels map[string]string `yaml:"labels,omitempty" json:"labels,omitempty"`
}

type ComposeVolume struct {
	// Driver is the volume driver.
	Driver string `yaml:"driver,omitempty" json:"driver,omitempty"`

	// External indicates whether the volume is externally managed.
	External bool `yaml:"external,omitempty" json:"external,omitempty"`

	// Labels are metadata key-value pairs.
	Labels map[string]string `yaml:"labels,omitempty" json:"labels,omitempty"`

	// DriverOpts holds driver-specific options.
	DriverOpts map[string]string `yaml:"driver_opts,omitempty" json:"driver_opts,omitempty"`
}

type DeployConfig struct {
	// Replicas is the number of container instances.
	Replicas int `yaml:"replicas,omitempty" json:"replicas,omitempty"`

	// Resources defines resource limits and reservations.
	Resources *ResourcesConfig `yaml:"resources,omitempty" json:"resources,omitempty"`
}

type DockerComposeProvider struct {
	// contains filtered or unexported fields
}

type FileStateStore struct {
	// contains filtered or unexported fields
}

type HealthcheckConfig struct {
	// Test is the health check command.
	Test []string `yaml:"test" json:"test"`

	// Interval is the time between health checks.
	Interval string `yaml:"interval,omitempty" json:"interval,omitempty"`

	// Timeout is the maximum time for a single check.
	Timeout string `yaml:"timeout,omitempty" json:"timeout,omitempty"`

	// Retries is the number of consecutive failures before unhealthy.
	Retries int `yaml:"retries,omitempty" json:"retries,omitempty"`

	// StartPeriod is the time to wait before starting checks.
	StartPeriod string `yaml:"start_period,omitempty" json:"start_period,omitempty"`
}

type IPAMConfig struct {
	// Driver is the IPAM driver.
	Driver string `yaml:"driver,omitempty" json:"driver,omitempty"`

	// Config holds per-subnet configuration.
	Config []IPAMPoolConfig `yaml:"config,omitempty" json:"config,omitempty"`
}

type IPAMPoolConfig struct {
	// Subnet is the subnet CIDR.
	Subnet string `yaml:"subnet,omitempty" json:"subnet,omitempty"`
}

type MockCall struct {
	Method string
	Args   []string
}

type MockExecutor struct {
	// UpFn is called when Up is invoked. If nil, returns empty string and no error.
	UpFn func(ctx context.Context, projectDir string, files ...string) (string, error)

	// DownFn is called when Down is invoked.
	DownFn func(ctx context.Context, projectDir string, files ...string) (string, error)

	// PsFn is called when Ps is invoked.
	PsFn func(ctx context.Context, projectDir string, files ...string) (string, error)

	// LogsFn is called when Logs is invoked.
	LogsFn func(ctx context.Context, projectDir string, service string, files ...string) (string, error)

	// VersionFn is called when Version is invoked.
	VersionFn func(ctx context.Context) (string, error)

	// IsAvailableFn is called when IsAvailable is invoked.
	IsAvailableFn func(ctx context.Context) error

	// Calls records all method calls for assertion purposes.
	Calls []MockCall
}

type ResourceSpec struct {
	// CPUs is the CPU limit (e.g., "0.5", "2").
	CPUs string `yaml:"cpus,omitempty" json:"cpus,omitempty"`

	// Memory is the memory limit (e.g., "512M", "1G").
	Memory string `yaml:"memory,omitempty" json:"memory,omitempty"`
}

type ResourcesConfig struct {
	// Limits are the maximum resource constraints.
	Limits *ResourceSpec `yaml:"limits,omitempty" json:"limits,omitempty"`

	// Reservations are the minimum guaranteed resources.
	Reservations *ResourceSpec `yaml:"reservations,omitempty" json:"reservations,omitempty"`
}

type ShellExecutor struct {
	// ComposeCommand is the base command to use. Defaults to "docker" with "compose" subcommand.
	ComposeCommand string
}