#runner #run #cargo-image-runner

app cargo-image-runner

A cargo subcommand that allows running kernels using cargo run

1 unstable release

Uses new Rust 2024

new 0.1.0 Apr 16, 2025

#285 in Cargo plugins

MIT license

20KB
412 lines

Cargo Image Runner

A cargo CLI tool / runner that allows building ISO images from your rust executables and running them in qemu. Currently only supports x86_64 and UEFI booting, and the limine bootloader.

Dependencies

For cross-platform compatibility, this crate is mosly self-contained, bundling a version of git2 and hadris-iso to create the ISO image. A version of limine and ovmf are downloaded at runtime, which requires a network connection for the first run.

Note: A fully bundled version of limine and ovmf is planned for the future.

Roadmap

  • Add support for other bootloaders (GRUB, etc.)
  • Add support for other architectures (aarch64, etc.)
  • Make bundling git2 optional (use system libssl, libgit2, or use the command line git)
  • Add support for bundling limine (latest stable release) and ovmf (latest stable release), but allow per project overrides

License

This is forked from the cargo-image-runner project, which is licensed under the MIT license.

Dependencies

~17–30MB
~533K SLoC