zunit

Zero-dependency test runner for java-cli-app projects. Discovers *Test.java files and runs each directly via java --source 25 — no compilation step, no JUnit, no framework.

How It Works

graph LR
    zunit -->|discovers| T["test/*Test.java"]
    zunit -->|classpath| J["zbo/app.jar"]
    T -->|java --source 25| JVM1["JVM 1"]
    T -->|java --source 25| JVM2["JVM 2"]
    T -->|java --source 25| JVMN["JVM N"]

Loading

Each test file runs concurrently in a separate JVM. A thrown exception or non-zero exit means failure; clean exit means success.

Test Convention

Test files live in test/, use unnamed class style, and assert with assert or Objects.equals:

void main() {
    var result = Converter.toFahrenheit(0);
    assert result == 32 : "expected 32 but got " + result;

    var name = Greeter.greet("Duke");
    assert Objects.equals(name, "Hello, Duke") : "unexpected: " + name;
}

No package declarations, no assertion libraries, no imports needed for java.base types. Run with -ea enabled by default.

Usage

zb && zunit

Build with zb first to produce zbo/app.jar, then run zunit to discover and execute all tests. Use zunit -verbose to debug classpath or discovery issues.