Testing¶

Test Types¶

Type	Command	Description
JUnit	`sh build.sh tests`	Unit tests for all subprojects
Regression	`sh build.sh regression-tests`	Shell command integration tests
Boot	QEMU/VirtualBox	Full OS boot verification

JUnit Tests¶

# All tests (runs in CI)
sh build.sh tests

# Per-subproject
sh build.sh -f core/build-tests.xml all-junit
sh build.sh -f fs/build-tests.xml all-junit
sh build.sh -f net/build-tests.xml all-junit
sh build.sh -f shell/build-tests.xml all-junit
sh build.sh -f gui/build-tests.xml all-junit

Framework: JUnit 4.5 + JMock + Mockito
Location: <subproject>/src/test/
~390 test files total
Reports: all/build/reports/junit/

Regression Tests¶

Shell command integration tests that run against a booted JNode:

sh build.sh regression-tests

Tests are defined in tests/regression/ and executed via the shell.

Boot Testing¶

QEMU (CI)¶

# Automated in CI (.github/workflows/ant.yml)
qemu-system-x86_64 -cdrom all/build/cdroms/jnode-x86-lite.iso \
  -m 1024 -M pc -cpu pentium -boot once=d,menu=off -net none \
  -serial file:/tmp/com1.txt -display none &
# Wait for "System has finished" in /tmp/com1.txt (timeout 120s)

Local Boot Test¶

# Quick smoke test
sh build.sh cd-x86-lite
qemu-system-x86_64 -cdrom all/build/cdroms/jnode-x86-lite.iso \
  -m 512 -serial stdio -display none
# Type: help, ls /, ps, vminfo, exit

Writing Tests¶

JUnit Example¶

// core/src/test/org/jnode/vm/ClassLoaderTest.java
package org.jnode.vm;

import junit.framework.TestCase;

public class ClassLoaderTest extends TestCase {
    public void testBootClassLoader() {
        ClassLoader cl = ClassLoader.getSystemClassLoader();
        assertNotNull(cl);
        assertEquals("BootClassLoader", cl.getClass().getSimpleName());
    }
}

Regression Test Example¶

<!-- tests/regression/commands/ls-test.xml -->
<test name="ls-root">
    <command>ls /</command>
    <expect>bin</expect>
    <expect>dev</expect>
    <expect>etc</expect>
    <expect>home</expect>
</test>

CI Integration¶

The ant.yml workflow runs:

sh build.sh clean -Dbuild.properties.file=../.github/qemu/jnode.properties cd-x86-lite regression-tests
./test.sh all (runs JUnit)
QEMU boot test with serial log capture
Upload JUnit reports + serial log as artifacts

Test Utilities¶

Tool	Purpose	Location
`jnode-interact` skill	Interactive QEMU testing via serial	repo `.opencode/skills/`
`filesystem-debug` skill	Analyze FS test failures	repo `.opencode/skills/`
`jnode-issue-resolver` skill	Issue/PR resolution protocol	repo `.opencode/skills/`
`jnode-java-coding` skill	Compile/run Java on live JNode	user config
`jnode-kdb-serial` skill	Kernel debugger via serial	user config

See .opencode/skills/ for the repo's skills.