Files
bootvine/docs/development.md
T

3.0 KiB

Development

Setup

Work inside the dev shell (direnv allow once, with direnv). Version control is jj, not the git CLI.

Before committing

cargo clippy --workspace --all-targets
cargo fmt --all

Clippy runs with the pedantic lints and forbids absolute paths; formatting needs the nightly toolchain the dev shell provides.

Commit messages follow Conventional Commits. jj does not run git hooks, so check the commits you are about to push with:

nix run .#check-conventional-commits -- origin/main..HEAD

Git users can install the same commit-message check and a formatting check as hooks with prek install (prek, from the dev shell) or pre-commit install (pre-commit).

Continuous integration

.woodpecker/rust-and-flake-checks.yaml runs on Codeberg's Woodpecker CI for every push and pull request: the bootvine build with its tests, the xtask build, clippy, rustfmt, an evaluation of every flake output, and the commit-message check on pull requests. Builds on main are pushed to the wvhulle Cachix cache, which nixConfig in flake.nix offers as a substituter. The two VM checks need KVM, which Codeberg's runners lack, so they only run locally.

Testing

What Command
Model and render tests cargo test --workspace
Scripted demos cargo run --example boot (also shutdown, luks)
Sample machine in a window nix run .#sample-machine-vm
Boot and shutdown in a VM nix build .#checks.x86_64-linux.vm-boot-and-shutdown
Passphrase prompt in a VM nix build .#checks.x86_64-linux.vm-luks-passphrase

To watch your own user manager start the sample units:

units=$(nix build --no-link --print-out-paths .#sample-unit-files)
systemctl --user link --runtime $units/*
systemctl --user start --no-block bootvine-demo.target
cargo run -- --user --target bootvine-demo.target --hold 3s
systemctl --user stop $(ls $units)
systemctl --user disable --runtime $(ls $units)

The VM checks read the console as text, hold the boot at fixed points and wait on marker files instead of sleeping. To step through one by hand, run nix run .#checks.x86_64-linux.vm-boot-and-shutdown.driverInteractive and call test_script().

Prefix VM and recording commands with env -u LD_LIBRARY_PATH when your shell exports libraries that clash with QEMU or Chromium.

Repository tasks

  • nix run .#record-screencasts re-records the README animations from the scripted demos and copies the passphrase screenshot from the VM check.
  • cargo run -- install --destdir <dir> --initrd dracut stages an install without touching the system; cargo run -- uninstall --destdir <dir> removes it again.

Code style and design

  • Code style.
  • Architecture: the event loop, the console takeover and the workarounds for systemd's private socket.