StudentScore

Computing score of a given student assignment


Keywords
testing, functional-testing
License
MIT
Install
pip install StudentScore==0.3.1

Documentation

Score

GitHub issues GitHub last commit Build and Deploy Python

Compute the final score of an assignment based on the criteria.yml file.

This small package is an helper to sum the points of programming assignments.

Usage

Simply use score inside an assignment folder

$ score -v
Got 7 points + 2 points out of 10 points
4.5
$ score 
4.5

Criteria file format

Each assignment has a description files that looks like the one below. One can add criteria with positive or negative points. Also bonus point can be set.

---
criteria:
  testing:
    tests:
      build:
        $description: The program builds correctly
        $points: [-2, -4]
      unit-testing:
        foo: 
          $description: Foo function works
          $points: [3, 3]          
        bar:
          $description: Bar function works
          $points: [1, 3]        
  code:
    implementation:
      smart-pointer: 
        $description: Smart pointers are used correcly
        $points: [4, 4]
    overall:
      dry:
        $description: No repeated code
        $points: [0, -5]
      kiss:
        $description: No unnecessary code
        $points: [-1, -5]
      ssot:
        $description: No redundant information
        $points: [0, -5]
      indentation:
        $description: Indentation is correct
        $points: [0, -3]
  bonus:
    test_framework:
      $description: Use a test framework
      $bonus: [2, 2]
    extension:
      $description: Program goes beyond the scope of the assignment
      $bonus: [0, 3]