Writing tests
Concept
VM Lifecycle
VMs are created from profiles, booted with hardware options, and shut down when the test is done. Provium cleans up any VMs left running.
ConceptRunning Commands
Execute shell commands in the guest, parse JSON output, read and write files, inspect kernel logs, and mount virtual filesystems.
ConceptAssertions and Sub-tests
Provium provides assert helpers and a test() function for organizing multiple named test cases in a single file.
ConceptFixtures
Fixtures snapshot a booted VM's state so that tests can resume from it instantly instead of cold-booting every time.
ConceptBackground Jobs
Start long-running commands in the background and poll or wait for their completion.
ConceptWorkers
Fork the guest agent into independent worker processes to test multi-process scenarios — credential isolation, inter-process communication, and concurrent access.