Testing companion project for FRC Java Koans
Testing the FRC Java Koans is a bit challenging for a few reasons:
- by design, it has no build tool, nor any dependency
- testing the koans themselves means replacing the classes in
koans/ - we do not want to show some solutions to students!
Therefore, despite engine unit and integration tests being included in the main project, testing the koans require a new project, this one.
For now, we only test passing solutions. We import the engine and koans from the main project, replace solution classes, and make sure all the koans are passing for all locales.
Prerequisite: you need git and a JDK 17+. For example, on Windows, using Chocolatey:
choco install -y corretto21jdk git
Then, in a terminal:
git clone https://github.com/jletroui/FrcJavaKoans
git clone https://github.com/jletroui/FrcJavaKoansTests
cd FrcJavaKoansTests
.\gradlew.bat :run
Which hopefully should show you something close to:
> Task :run
494/494 assertions executed successfully in 162 koans.
BUILD SUCCESSFUL in 342ms
4 actionable tasks: 3 executed, 1 up-to-date
Test also non-passing solutions, to assert that the right messages are shown.
