Justfile

# python-tools on Hyperlight
#
# just run      - Run once
# just run-5    - Run 5x (snapshot/restore)
# just rootfs   - Build rootfs via Docker (cross-platform)
# just build    - Build/pull kernel
# just clean    - Remove build artifacts

set windows-shell := ["powershell.exe", "-NoLogo", "-Command"]
export DOCKER_BUILDKIT := "0"

kernel      := ".unikraft/build/python-tools-hyperlight_hyperlight-x86_64"
initrd      := "initrd.cpio"
memory      := "96Mi"
image       := "python-tools-hyperlight"
ghcr_kernel := "ghcr.io/hyperlight-dev/hyperlight-unikraft/python-tools-kernel:latest"

# Run the example
run:
    hyperlight-unikraft {{kernel}} --initrd {{initrd}} --memory {{memory}} --enable-tools -- /test_tools.py

# Run 5 times via snapshot/restore
run-5:
    hyperlight-unikraft {{kernel}} --initrd {{initrd}} --repeat 4 --memory {{memory}} --enable-tools -- /test_tools.py

# Build rootfs via Docker (cross-platform)
rootfs:
    docker build --platform linux/amd64 --target cpio -t {{image}}-cpio .
    - docker rm -f {{image}}-tmp
    docker create --name {{image}}-tmp {{image}}-cpio /bin/true
    docker cp {{image}}-tmp:/output.cpio ./{{initrd}}
    docker rm -f {{image}}-tmp

# Build kernel via kraft (Linux)
[unix]
build:
    -kraft-hyperlight build --plat hyperlight --arch x86_64

# Pull pre-built kernel from GHCR (Windows)
[windows]
build:
    docker pull {{ghcr_kernel}}
    - docker rm -f {{image}}-kernel-tmp
    docker create --name {{image}}-kernel-tmp {{ghcr_kernel}} /kernel
    New-Item -ItemType Directory -Force -Path (Split-Path {{kernel}}) | Out-Null
    docker cp {{image}}-kernel-tmp:/kernel ./{{kernel}}
    docker rm -f {{image}}-kernel-tmp

# Clean build artifacts
[unix]
clean:
    rm -rf .unikraft {{initrd}}

[windows]
clean:
    if (Test-Path .unikraft) { Remove-Item -Recurse -Force .unikraft }
    if (Test-Path {{initrd}}) { Remove-Item -Force {{initrd}} }