/**
 * This is javaunittest Moodle question type plugin.
 *
 * @package     qtype
 * @subpackage  javaunittest
 * @author      Michael Rumler, rumler@ni.tu-berlin.de
 * @license     http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
 
 
 ==========================================================

1. Installation and configuration

    Put the the directory 'javaunittest' and its content into your
    moodle directory: moodle/question/type/.
    
    Decide whether using local compiling and test running or using a remote server.
    If you chose remote running put the content of the directory
    'moodle_qtype_javaunittest_remoteserver' to your remote machine.
    
    Configure the plugin settings via admin settings page.
    Furthermore if necessary configure the remote server by editing the config.php.
    
    The compiling and test running machine needs beside the webserver with
    php support of course java compiler, java runtime environment and a current
    versions of junit and hamcrest (get them from 
    https://github.com/junit-team/junit/wiki/Download-and-Install).
    
==========================================================

2. JUnit examples

    In the sub directory EXAMPLE_FILES you find some examples and another 
    README file. It explains how to create a question with this question 
    type module.

==========================================================

3. Security Manager

    The java security manager has the task to prevent any evil
    things who could mess up your system. This plugin supports
    the usage of the java security manager. There is a polfile to
    configure things who are allowed. E.g. if you need to grant 
    threading privileges or file i/o edit this polfile.
    Policy files should be stored in the polfiles directory.
    
    Note that the remote server has its own polfiles directory.

==========================================================

4. About

    This module is developed by tutors of the TU Berlin.
    
    Original version: Süreç Özcan (sojunit 2008), suerec@darkjade.net
        Main developer: Gergely Bertalan, bertalangeri@freemail.hu
        Maintenance and Updates: Michael Rumler, rumler@ni.tu-berlin.de
        Improvements: Martin Gauk, gauk@math.tu-berlin.de
    
     Moodle module page: https://moodle.org/plugins/view.php?plugin=qtype_javaunittest
     Source: https://github.com/tuttorsOfTheTUBerlin/javaunittest
     Remote Server Source: https://github.com/tuttorsOfTheTUBerlin/moodle_qtype_javaunittest_remoteserver
     
     Contact via Moodle module page.
     Please write us if you find any issues or have feedback.

==========================================================

5. Important Note for Usage

    Please remember that any kind of software may have bugs. This also involves the
    Java Compiler, Run Time Enviroment and Security Manager, the Webserver, PHP,
    all the other components, and of course this Moodle plugin too. We made this plugin
    secure to our best of knowledge but we can not guarantee that nothing goes wrong.

==========================================================

6. Changelog

    Version 2.01:
        + added admin panel settings (removed config.php, replaced by settings.php) and
            backup feature, thanks to Martin Gauk
        + a lot of security improvements, again many thanks to Martin Gauk
        + added debug settings
        # 2.8 and 2.9 are supported
        # fixed grading issue (now 0% insteat of 100% if students code combined with
            test class do not compile)
        # code cleanup and rewrite (fixed encoding issues, adaption of Moodle coding
            style rules)
        # changed feedback level settings
            + feedback now adjustable per question
            # compiler errors for student code are shown fully, compiler errors for test
                code are printed as static error message, everything else is arranged by
                feedbacklevel
            # feedback levels: nothing, times, times and counts (tests, failures), all
                junit except stacktrace
        # output looks more fancy now


    Version 2.00:
        + plugin now supports remote compiling and test running via
            moodle_qtype_javaunittest_remoteServer
        + now you can configurate a global timeout for your junittests, 
            timeout will automatically added to test classes
        + some more display settings added
        + support for junit4 style (junit3 style still works)
        # changed grading: if the test class does not compile we grade
            the students answer as wrong, otherwise removing/renaming
            a required method let the student pass