cargo-image-runner
| Crates.io | cargo-image-runner |
| lib.rs | cargo-image-runner |
| version | 0.1.0 |
| created_at | 2025-04-16 08:38:10.113672+00 |
| updated_at | 2025-04-16 08:38:10.113672+00 |
| description | A cargo subcommand that allows running kernels using cargo run |
| homepage | |
| repository | https://github.com/hxyulin/cargo-image-runner |
| max_upload_size | |
| id | 1636142 |
| size | 58,607 |
(hxyulin)
documentation
README
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.