Metadata-Version: 2.4
Name: studentpybox
Version: 0.1.0
Summary: A simple Python toolkit for university students: GPA tools and study planning helpers.
Author-email: Talha_main <450talhatahir@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/YOUR_GITHUB_USERNAME/studentpybox
Keywords: gpa,student,university,study,pomodoro,education
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Education
Classifier: Topic :: Education
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# studentpybox

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

## Installation

```bash
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

```python
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
