Struct Context 

pub struct Context {
    pub config: Config,
    pub workspace_root: PathBuf,
    pub target_dir: PathBuf,
    pub executable: PathBuf,
    pub is_test: bool,
    pub cache_dir: PathBuf,
    pub output_dir: PathBuf,
    pub template_vars: HashMap<String, String>,
    pub cli_extra_args: Vec<String>,
    pub env_extra_args: Vec<String>,
}

Context object that carries state through the build pipeline.

Fields

config: Config

Configuration.

workspace_root: PathBuf

Workspace root directory.

target_dir: PathBuf

Target directory for build artifacts.

executable: PathBuf

Path to the executable being run.

is_test: bool

Whether this is a test run.

cache_dir: PathBuf

Cache directory for downloaded/generated files.

output_dir: PathBuf

Output directory for the current build.

template_vars: HashMap<String, String>

Template variables available for substitution.

cli_extra_args: Vec<String>

Extra QEMU arguments from CLI passthrough (-- args).

env_extra_args: Vec<String>

Extra QEMU arguments from CARGO_IMAGE_RUNNER_QEMU_ARGS env var.

Implementations

impl Context

pub fn new( config: Config, workspace_root: PathBuf, executable: PathBuf, ) -> Result<Self>

Create a new context from configuration and executable path.

pub fn detect_test(&mut self)

Detect if the executable is a test binary.

Tests are detected by checking if the executable name ends with a hash (Cargo appends a hash suffix to test binaries). Uses file_stem() to strip extensions like .efi before checking.

pub fn get_extra_args(&self) -> &[String]

Get the appropriate extra arguments based on whether this is a test run.

pub fn test_success_exit_code(&self) -> Option<i32>

Get the success exit code for tests, if configured.