studentpybox 0.1.0

A simple Python toolkit for university students: GPA tools and study planning helpers.

studentpybox

A simple Python toolkit for university students, with two modules: GPA tools and study planning helpers.

Installation

pip install studentpybox

Modules & Functions

studentpybox.gpa

Function	Description
calculate_gpa(grades, credits)	Credit-weighted GPA from a list of grade points and credit hours.
percentage_to_grade(percentage)	Convert a percentage score into a letter grade.
cgpa_predictor(current_cgpa, completed_credits, target_cgpa, upcoming_credits)	GPA needed in upcoming courses to hit a target CGPA.
attendance_needed(attended, total, target_percentage=75.0)	Classes still needed (or classes that can be skipped) to meet an attendance target.

studentpybox.study

Function	Description
pomodoro_timer_text(work_minutes=25, break_minutes=5, sessions=4)	Printable Pomodoro study schedule.
random_motivation()	A random short motivational line.
study_hours_left(total_hours_needed, hours_completed)	Remaining study hours and progress percentage.
exam_countdown(exam_date, date_format="%Y-%m-%d")	Days left until an exam date.

Usage

from studentpybox import calculate_gpa, percentage_to_grade, random_motivation, exam_countdown

print(calculate_gpa([4.0, 3.3, 3.7], [3, 4, 3]))   # 3.63
print(percentage_to_grade(82))                      # B+
print(random_motivation())                          # a random study quote
print(exam_countdown("2026-07-15"))                  # {'days_left': ..., 'status': 'upcoming'}

License

MIT