Struct ImageRunnerBuilder 

pub struct ImageRunnerBuilder { /* private fields */ }

Builder for creating and running bootable images.

Implementations

impl ImageRunnerBuilder

pub fn new() -> Self

Create a new builder with default settings.

pub fn with_config(self, config: Config) -> Self

Set the configuration directly.

pub fn from_cargo_metadata(self) -> Result<Self>

Load configuration from Cargo.toml metadata.

pub fn from_config_file(self, path: impl Into<PathBuf>) -> Result<Self>

Load configuration from a standalone TOML file.

pub fn executable(self, path: impl Into<PathBuf>) -> Self

Set the executable path.

pub fn workspace_root(self, path: impl Into<PathBuf>) -> Self

Set the workspace root.

pub fn extra_args(self, args: Vec<String>) -> Self

Set extra QEMU arguments from CLI passthrough (-- args).

pub fn bootloader<B: Bootloader + 'static>(self, bootloader: B) -> Self

Set a custom bootloader implementation.

pub fn limine(self) -> Self

Use Limine bootloader.

pub fn grub(self) -> Self

Use GRUB bootloader.

pub fn no_bootloader(self) -> Self

Use no bootloader (direct boot).

pub fn image_builder<I: ImageBuilder + 'static>(self, builder: I) -> Self

Set a custom image builder implementation.

pub fn iso_image(self) -> Self

Build an ISO image.

pub fn directory_output(self) -> Self

Output to a directory (for QEMU fat:rw:).

pub fn runner<R: Runner + 'static>(self, runner: R) -> Self

Set a custom runner implementation.

pub fn qemu(self) -> Self

Use QEMU runner.

pub fn io_handler<H: IoHandler + 'static>(self, handler: H) -> Self

Set an I/O handler for serial capture/streaming.

When set, the runner will pipe QEMU’s serial output through the handler, enabling capture, pattern matching, and reactive input.

pub fn build(self) -> Result<ImageRunner>

Build the image runner.

pub fn run(self) -> Result<()>

Build and immediately run.

pub fn run_with_result(self) -> Result<RunResult>

Build and immediately run, returning the full RunResult.

Trait Implementations

impl Default for ImageRunnerBuilder

fn default() -> Self

Returns the “default value” for a type.