Overview

A personal project that records course marks by semester and reports final marks, letter grades, GPA and degree class using the grading rules in Egerton University’s 2020 regulations (section 16.4.1). The layout is designed for small phone screens. It is not an official university tool.

Screenshots

GPA Tracker screen for entering a course and its marks
Adding a course
GPA Tracker results showing grades, GPA and degree class
Results and degree class
GPA Tracker planner showing the average needed to reach a target
The “what do I need?” planner

Problem addressed

Class boundaries are decided on a rounded mean, so a raw 59.995 already counts as 60. Floating-point numbers and banker’s rounding can get cases like that wrong, so the app calculates everything with exact decimals and half-up rounding.

Verified features

Technologies

Python 3.13, Kivy 2.3.0 and KivyMD 1.2.0, SQLite (sqlite3), the decimal module, unittest.

Implementation approach

Twenty-one application modules (about 2,400 lines). Grading, validation, regrading, planning, sorting, exporting and error logic are kept free of GUI code; SQL lives only in database.py; the interface is a separate KivyMD layer (main.py, with its design tokens in theme.py). The logic modules need no Kivy, so their unit tests run without it.

Challenges and lessons

Six defects were found and fixed, four in the original app and two in code added later. Three are written up as case studies in the Journal: the Year 1 versus Year 10 match, grades that went stale, and a backup that could freeze.

Status and evidence

In progress: built as a personal project, not yet deployed and with no users. Checked with 564 automated checks (193 unit tests and 371 window-level checks written for the original interface and run against a stand-in for its toolkit) and mutation testing with 89 deliberately planted bugs. The layout has not been tried on a real phone.