image

type ImageArch string

type ImageBootOptions struct {
	// VM configuration (applies to all boot modes).
	Arch       qemu.Arch
	SecureBoot bool
	SSHPort    uint16
	CPUs       int
	Memory     string

	// Image source: at least one must be provided (unless '--iso' is used, in which case
	// an empty disk is created if no image is specified).
	ImageName string      // Positional arg: look up image in project config to find its path.
	ImagePath string      // --image-path: explicit path to a disk image (overrides lookup).
	Format    ImageFormat // --format: explicit format hint for image-name lookup.

	// --iso: bootable ISO (e.g., livecd, installer, rescue media). Attached as a
	// bootable CD-ROM alongside the disk. Optional; independent of cloud-init.
	ISOPath  string
	DiskSize string // --disk-size: size of the empty qcow2 created when '--iso' is used without a disk.

	// Disk behavior.
	UseDiskRW bool // --rwdisk: persist writes to the source disk image.

	// Cloud-init configuration. If any credential is provided, a seed ISO is generated
	// and attached. Whether the booted system consumes it depends on cloud-init being
	// installed and enabled in the guest (same caveat applies to disk and ISO images).
	TestUserName            string
	TestUserPassword        string
	TestUserPasswordFile    string
	AuthorizedPublicKeyPath string
}

type ImageBuildOptions struct {
	// Name of the image to build.
	ImageName string

	// Paths to local repositories to include during build.
	LocalRepoPaths []string

	// URIs to remote repositories (http:// or https://) to include during build.
	RemoteRepoPaths []string

	// NoRemoteRepoGpgCheck disables GPG checking for all remote repositories
	// specified via RemoteRepoPaths.
	NoRemoteRepoGpgCheck bool

	// RemoteRepoIncludeInImage marks all remote repositories specified via RemoteRepoPaths
	// as part of the system image repository setup (imageinclude=true).
	RemoteRepoIncludeInImage bool

	// TargetArch specifies the target architecture to build for (e.g., "x86_64" or "aarch64").
	// If left empty, the host architecture will be used.
	TargetArch ImageArch
}

type ImageBuildResult struct {
	// Name of the image that was built.
	ImageName string `json:"imageName" table:",sortkey"`

	// Path to the output directory containing the built image.
	OutputDir string `json:"outputDir" table:"Output Dir"`

	// Paths to the artifact files that were linked into the output directory.
	ArtifactPaths []string `json:"artifactPaths" table:"Artifact Paths"`
}

type ImageDefinitionResult struct {
	// Type indicates the type of image definition (e.g., "kiwi").
	Type string `json:"type"`

	// Path points to the image definition file.
	Path string `json:"path"`
}

type ImageFormat string

type ImageListResult struct {
	// Name of the image.
	Name string `json:"name" table:",sortkey"`

	// Description of the image.
	Description string `json:"description"`

	// Capabilities describes the features and properties of this image.
	Capabilities projectconfig.ImageCapabilities `json:"capabilities" table:"-"`

	// CapabilitiesSummary is a comma-separated summary of enabled capabilities for table
	// display.
	CapabilitiesSummary string `json:"-" table:"Capabilities"`

	// Tests holds the test configuration for this image, matching the original config
	// structure.
	Tests projectconfig.ImageTestsConfig `json:"tests" table:"-"`

	// TestsSummary is a comma-separated summary of test suite names for table display.
	TestsSummary string `json:"-" table:"Tests"`

	// Publish holds the publish settings for this image.
	Publish projectconfig.ImagePublishConfig `json:"publish" table:"-"`

	// PublishSummary is a comma-separated summary of publish channels for table display.
	PublishSummary string `json:"-" table:"Publish"`

	// Definition contains the image definition details (hidden from table output).
	Definition ImageDefinitionResult `json:"definition" table:"-"`
}

type ImageTestOptions struct {
	// ImageName is the name of the image (positional argument), used to look up its
	// test suites and optionally resolve the image artifact path.
	ImageName string

	// TestSuites optionally selects specific test suites to run. When empty, all test
	// suites associated with the image are run.
	TestSuites []string

	// ImagePath is an optional explicit path to the image file. When empty, the image
	// artifact is resolved from the image name in the output directory.
	ImagePath string

	// JUnitXMLPath is an optional path for writing JUnit XML output.
	JUnitXMLPath string
}

type ListImageOptions struct {
	// Name patterns to filter images. Supports glob patterns (*, ?, []).
	ImageNamePatterns []string
}