repobee-junit4 0.6.0

JUnit-4.12 plugin for repobee

repobee-junit4, a JUnit 4.12 test runner plugin for RepoBee

Overview

This is a plugin for RepoBee that runs JUnit4 test classes on production classes in cloned student repos. It allows teachers and teaching assistants to quickly assess the work performed by students in a managed and fair way. The plugin hooks into the repobee clone command, and executes test classes on repos when they have been cloned to disk. A summary report is then printed to the logfile and terminal. By default, the plugin will only report which test classes failed (and how many tests), but it is possible to ask for more verbose output which includes detailed information about each test failure. See this example use case for a more detailed look at how it works.

Install

repobee-junit4 is on PyPi, so python3 -m pip install repobee-junit4 should do the trick. See the install instructions for more elaborate instructions.

Getting started

The best way to get started with repobee-junit4 is to head over to the Docs, where you (among other things) will find install instructions and usage instructions. The latter includes an example use case which hopefully proves useful in clarifying how repobee-junit4 is supposed to be used.

Roadmap

This plugin is in the beta testing phase. It is feature-complete, but the CLI is not yet final and may change. This is partly due to the fact that the Repmate plugin system itself is still in beta, and may also change.

Versioning for the CLI adheres to Semantic Versioning 2.0.0. The internals of repobee-junit4 do not, so this project should not be used as a library.

License

This software is licensed under the MIT License. See the LICENSE file for specifics.