container

type BuildOptions struct {
	// The build context path. Defaults to current directory when empty.
	ContextDir string
	// Name and optionally a tag in the name:tag format.
	Tag string
	// Name of the Dockerfile (Default is "Dockerfile").
	File string
	// Do not use cache when building the image.
	NoCache bool

	// Target OS for the image.
	OS string
	// Target architecture for the image: amd64 or arm64
	Arch []string
	// Target platform for the image in the format os/arch[/variant].
	Platform string
	// Build arguments in the format key=val.
	BuildArgs map[string]string
	// Tries to pull the latest base image from the registry.
	Pull bool
}

type Client struct {
	Bin string

	Container ContainerClient
	System    SystemClient
	Images    ImageClient
	Volumes   VolumeClient
	Networks  NetworkClient
}

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

type ContainerDetails struct {
	ID          string
	ImageDigest string
	VolumeNames []string
	Mounts      []ContainerMount
	Networks    []NetworkAttachment
}

type ContainerMount struct {
	Type     MountType
	Source   string
	Target   string
	ReadOnly bool
}

type ContainerSummary struct {
	ID     string
	Labels map[string]string
}

type CreateOptions struct {
	// Name of the container to create
	Name string
	// Number of CPUs to allocate to the container
	CPUs uint
	// Amount of memory (1MiByte granularity), with optional K, M, G, T, or P suffix
	Memory string
	// Remove the container after it exits
	Rm bool
	// Port mappings
	Publish []PortMapping
	// Environment variables in KEY=VALUE (or KEY) format.
	Environment []string
	// Labels associates metadata with the container as KEY=VALUE pairs.
	Labels map[string]string
	// Nameservers identifies DNS server IP addresses to pass through repeated
	// --dns flags. Their order is preserved.
	Nameservers []string
	// Networks identifies the networks to attach when creating the container.
	Networks []string
	// Mounts configures filesystem mounts for the container.
	Mounts []Mount
	// Container init Process arguments, if any
	Arguments []string
}

type DeleteOptions struct {
	// Delete all containers
	All bool
	// List of container IDs or names to delete, should be empty if All flag is true
	IDs []string
	// Force deletion of running containers
	Force bool
}

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

type ImageSummary struct {
	Digest string
}

type ListOptions struct {
	// Display both running and stopped containers
	All bool
	// Return only container IDs
	Quiet bool
}

type LogsOptions struct {
	// Follow streams logs continuously until context cancellation or process exit.
	Follow bool
	// IDs are container IDs or names to fetch logs for.
	IDs []string
}

type Mount struct {
	// Type identifies the storage backing for the mount.
	Type MountType
	// Source is the absolute host path for a bind mount or a volume name for a
	// named-volume mount. Tmpfs mounts do not have a source.
	Source string
	// Target is the absolute path where the mount appears in the container.
	Target string
	// ReadOnly prevents writes through the mount.
	ReadOnly bool
	// TmpfsSize is the tmpfs capacity in bytes. Zero uses the runtime default.
	TmpfsSize uint64
	// TmpfsMode is the tmpfs file mode expressed as an octal Unix-permission
	// string. An empty value uses the runtime default.
	TmpfsMode string
}

type MountType string

type NetworkAttachment struct {
	Name      string
	Addresses []netip.Addr
}

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

type NetworkCreateOptions struct {
	// Name is the name of the network to create.
	Name string
	// Labels associates metadata with the network as KEY=VALUE pairs.
	Labels map[string]string
}

type NetworkSummary struct {
	Name   string
	Labels map[string]string
}

type PortMapping struct {
	HostIP        string
	HostPort      uint16
	ContainerPort uint16
	Protocol      Protocol // "tcp" or "udp"
}

type Protocol string

type Signal string

type StopOptions struct {
	// Stop all running containers
	All bool
	// List of container IDs or names to stop, should be empty if All flag is true
	IDs []string
	// Seconds to wait before killing the containers (default: 5)
	Time uint
	// Signal to send to the containers (default: SIGTERM)
	Signal Signal
}

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

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

type VolumeCreateOptions struct {
	// Name is the name of the volume to create.
	Name string
	// Labels associates metadata with the volume as KEY=VALUE pairs.
	Labels map[string]string
	// Options contains volume driver options as KEY=VALUE pairs.
	Options map[string]string
}

type VolumeDeleteOptions struct {
	// Names identifies the volumes to delete. It must be empty when All is set.
	Names []string
	// All deletes every volume.
	All bool
}

type VolumeSummary struct {
	Name   string
	Labels map[string]string
}