This program is designed to help teachers and students of TDDD95 with grading. It is designed to help teachers get a good overview of how students are performing but also help students see how well they are performing, allowing them to easier attain their desired grade, as well as giving them an overview of how they are doing.

The program mainly uses custom software to create rules for judging student results, but it also uses the kattis-cli for accessing priviledged information (such as detailed submission results). Kattis-cli is used to download the information as an HTML page and then it is parsed using beautiful soup. The data is then saved to an output file and can later be parsed by the program

Before running the downloader you will need a configuration file from kattis. You can download yours here. The configuration file includes a secret personal token so make sure to keep the file secret! Store it in your home directory as .kattisrc.

In general this program requires that you have python3 and virtualenv installed. If you have neither installed and you are on a ubuntu-like system, then run sudo apt-get install python3 && sudo pip install -H virtualenv.

Start by running the setup script: ./scripts/setup.sh. Then download course data from Kattis and put it inside ./data. You can download any data, but we suggest that you download "All" instead of "First accepted" or any other.

After this is done you can run ./scripts/teacher_main.sh to see the results of the students. This script looks for AAPS-AAPS18_export_all.json inside the data directory, so if you get a FileNotFound exception then change the script to use the correct file.