README.md

Java Assignment Testing Frame

The goal of this testing framework is to make it easier to write automated tests for checking course work where Java 25 is used.

---

Technology

Java 25

JUnit 6

---

How to use:

Meant to be used within IntelliJ IDEA, recommended version: 2025.3

Tests can also be run via mvn test (For use with GitHub Actions)

src/main/java/assignment/

Code goes here

src/main/java/assignment/README.md

Assignment text goes here

src/test/java/assignment/

src/test/java/assignment/TestAssignment.java

Code that tests the assignment goes here

---

Examples

Examples below are just a subset of what is available, docs are work-in-progress

testClass("assignment.Person", () -> {
    assertTrue(fieldExists("name"));
    assertTrue(methodExists("getName"));
    assertTrue(methodExists("setName", String.class));
    assertTrue(methodExists("printName"));
    
    var Person = getScopedClass();

    testClass("assignment.Student", () -> {
        assertTrue(classInheritsFrom(Person));
    });
});

testClass("assignment.Student", () -> {
    var name = "Alice";
    var student = classCreateInstance(name);
    
    classInstanceInvokeMethod(instance, "printName");
    
    assertStandardOutputEquals(name);
});

testClassMethod("assignment.Person", "getName", () -> {
    assertFalse(methodIsStatic());
    
    assertTrue(methodHasModifiers(AccessFlag.PUBLIC));
    
    assertTrue(methodReturns(String.class));
});

Tips:

• Use message parameter in assert*()-methods to provide more detailed feedback
• If you are writing tests locally and from time to time are pulling changes from origin or upstream (in a fork), use src/main/java/[local|dev]/** and src/test/java/[local|dev]/** as these are included in the gitignore

Plans

• File I/O
• Database I/O (JDBC)
• Snapshot testing
• Relevant unit testing as part of the framework
• Testing the testing framework + solve "Quid revera probationes probabunt?"
• Deeper testing via bytecode analysis
• Testing of algorithmic complexity via bytecode analysis