Skip to content

paen27/QPED-O3

 
 

Repository files navigation

QPED (Quality-focused Programming Education) - Feedback tools for Java and Python

QPED is a project that has seen life as an Erasmus+ project funded by the European government. It is a combined venture of four different universities (Open Universiteit Nederland, Fundacio per a la Universitat oberta de Catalunya, Philipps Universität Marburg and Technische Universiteit Eindhoven) and the Quarterfall-organisation. For more information about Quarterfall please refer to their website.

QPED aims to improve the quality of software by improving the written code underneath. Our philosophy is that if the quality and readability of the underlying code improves, then the software itself will become higher quality. In order to achieve that, we focus on improving the quality mindedness of early learners in a university context.

Since in the beginning of their studies, students mostly learn about programming and language features, more meta-topics like testing or readability are mostly sidelined or "to be learned later". QPED wants to teach the importance of high quality code and testing to students early so that they write their code adhering to standards from the start instead of having to relearn how to code correctly a few semesters later. However, detailed feedback on code can be quite tedious for teachers to provide since at any given point during a semester they are vastly outnumbered by the students. Because of this, we provide teachers with this particular piece of software.

What is this software about?

General

With this software, you can analyze and automatically generate feedback for learners of computer science. This project is aimed at early learners beginning their education by learning the JAVA and Python programming language. For the respective versions of this project, please refer to their respective folder.

What does it do?

At the moment, it is a highly customizable software that can compile and analyze submitted code and generate feedback. The generated feedback can be configured by the user to be in a specific language (e.g. German, English, etc) and can be adjusted to the level of knowledge of the learner.

Furthermore, it is possible to require a learner to use a specific loop within their solution or solve a task recursively. It is also possible to use different metrics and mutation testing to evaluate the test-quality of the submitted code and give the learner helpfull feedback. For a full list of possible configurations, please refer to the section below.

How can I interface with this programme?

Interfacing with this programme works solely via a JSON-Object. For specific instructions, please refer to the documentation of the framework.

How can it be configured?

Configuration is also done via different JSON-Objects. For specific properties and objects that can be used for configuration, please refer to the documentation of the checkers.

Requirements

This project is meant to interface specifically with the Quarterfall plattform in the form of a cloud-check, though it can be used with other plattforms. We interface with Quarterfall by using a JSON configuration that is done in Quarterfall and submitted to this software. The output is also generated as a JSON-object. However, the feedback itself is formatted in markdown.

Development

The implementation makes use of the Lombok project, which is properly configured in the Maven POM. If you want to build the project in your IDE, you need to have Lombok installed as an IDE extension. You can follow the instructions in this tutorial.

Licence

MIT-licence

Copyright (c) 2021 QPED Organization

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 99.2%
  • Other 0.8%