teacher-tea 0.1.0__tar.gz

teacher_tea-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ali Haider
+
+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.

teacher_tea-0.1.0/PKG-INFO

@@ -0,0 +1,42 @@
+Metadata-Version: 2.4
+Name: teacher-tea
+Version: 0.1.0
+Summary: Help students compare teachers and build clash-free class schedules.
+Author-email: Ali Haider <AliHaider7108@users.noreply.github.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# TeacherTea
+
+TeacherTea is a small Python library that helps university students pick teachers and plan a weekly timetable. It includes teacher review summaries and simple schedule tools.
+
+## Install
+
+```bash
+pip install teacher-tea
+```
+
+## Quick example
+
+```python
+from teacher_tea import get_teacher_summary, compare_teachers, best_teacher_for
+from teacher_tea import check_clash, build_timetable, free_slots, workload_estimator
+
+print(get_teacher_summary("Jawairia Rasheed"))
+print(compare_teachers("Jawairia Rasheed", "Noreen Ashraf"))
+print(best_teacher_for("CS101"))
+
+courses = [
+    {"course": "CS101", "teacher": "Jawairia Rasheed", "slot": ("Mon", 9.0, 10.5)},
+    {"course": "SE201", "teacher": "Noreen Ashraf", "slot": ("Mon", 10.0, 11.5)},
+]
+print(build_timetable(courses))
+print(free_slots([("Mon", 9.0, 10.5), ("Mon", 14.0, 15.5)], "Mon"))
+print(workload_estimator(3, "medium"))
+```

teacher_tea-0.1.0/README.md

@@ -0,0 +1,28 @@
+# TeacherTea
+
+TeacherTea is a small Python library that helps university students pick teachers and plan a weekly timetable. It includes teacher review summaries and simple schedule tools.
+
+## Install
+
+```bash
+pip install teacher-tea
+```
+
+## Quick example
+
+```python
+from teacher_tea import get_teacher_summary, compare_teachers, best_teacher_for
+from teacher_tea import check_clash, build_timetable, free_slots, workload_estimator
+
+print(get_teacher_summary("Jawairia Rasheed"))
+print(compare_teachers("Jawairia Rasheed", "Noreen Ashraf"))
+print(best_teacher_for("CS101"))
+
+courses = [
+    {"course": "CS101", "teacher": "Jawairia Rasheed", "slot": ("Mon", 9.0, 10.5)},
+    {"course": "SE201", "teacher": "Noreen Ashraf", "slot": ("Mon", 10.0, 11.5)},
+]
+print(build_timetable(courses))
+print(free_slots([("Mon", 9.0, 10.5), ("Mon", 14.0, 15.5)], "Mon"))
+print(workload_estimator(3, "medium"))
+```

teacher_tea-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "teacher-tea"
+version = "0.1.0"
+description = "Help students compare teachers and build clash-free class schedules."
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "Ali Haider", email = "AliHaider7108@users.noreply.github.com"},
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]

teacher_tea-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

teacher_tea-0.1.0/src/teacher_tea/__init__.py

@@ -0,0 +1,36 @@
+"""TeacherTea helps students pick teachers and build schedules."""
+
+from teacher_tea.teacher_insights import (
+    add_review,
+    best_teacher_for,
+    compare_teachers,
+    get_teacher_summary,
+)
+from teacher_tea.schedule_helper import (
+    build_best_schedule,
+    build_timetable,
+    check_clash,
+    compare_schedules,
+    free_slots,
+    schedule_summary,
+    score_slot,
+    workload_estimator,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "add_review",
+    "get_teacher_summary",
+    "compare_teachers",
+    "best_teacher_for",
+    "check_clash",
+    "build_timetable",
+    "free_slots",
+    "workload_estimator",
+    "score_slot",
+    "build_best_schedule",
+    "schedule_summary",
+    "compare_schedules",
+    "__version__",
+]

teacher_tea-0.1.0/src/teacher_tea/schedule_helper.py

@@ -0,0 +1,176 @@
+"""Basic timetable utilities for building a clash-free schedule."""
+
+
+def _clash(slot1, slot2):
+    """Return True if two slots are on the same day and overlap."""
+    day1, start1, end1 = slot1
+    day2, start2, end2 = slot2
+
+    if day1 != day2:
+        return False
+
+    return start1 < end2 and start2 < end1
+
+
+def check_clash(slot1, slot2):
+    """Return True if two class slots overlap on the same day."""
+    return _clash(slot1, slot2)
+
+
+def score_slot(slot, preference):
+    """Return a score showing how well a slot matches a time preference."""
+    day, start_hour, end_hour = slot
+
+    if preference not in ("morning", "evening", "balanced"):
+        preference = "balanced"
+
+    if preference == "morning":
+        return max(0, 12 - start_hour)
+    if preference == "evening":
+        return start_hour
+    return 1
+
+
+def build_best_schedule(courses, preference="balanced"):
+    """Pick the best non-clashing section for each course."""
+    schedule = []
+    unscheduled = []
+    chosen_slots = []
+
+    for course_info in courses:
+        course_name = course_info["course"]
+        options = sorted(
+            course_info["options"],
+            key=lambda option: score_slot(option["slot"], preference),
+            reverse=True,
+        )
+
+        picked = None
+        for option in options:
+            slot = option["slot"]
+            clashes = False
+            for chosen in chosen_slots:
+                if _clash(slot, chosen):
+                    clashes = True
+                    break
+            if not clashes:
+                picked = option
+                break
+
+        if picked is None:
+            unscheduled.append(course_name)
+        else:
+            schedule.append({
+                "course": course_name,
+                "teacher": picked["teacher"],
+                "slot": picked["slot"],
+            })
+            chosen_slots.append(picked["slot"])
+
+    return {"schedule": schedule, "unscheduled": unscheduled}
+
+
+def schedule_summary(schedule):
+    """Count morning, afternoon, and evening classes in a schedule."""
+    morning = 0
+    afternoon = 0
+    evening = 0
+    days = []
+
+    for item in schedule:
+        day, start_hour, end_hour = item["slot"]
+        if day not in days:
+            days.append(day)
+
+        if start_hour < 12:
+            morning += 1
+        elif start_hour < 17:
+            afternoon += 1
+        else:
+            evening += 1
+
+    return {
+        "morning_classes": morning,
+        "afternoon_classes": afternoon,
+        "evening_classes": evening,
+        "days_on_campus": days,
+    }
+
+
+def compare_schedules(schedule_a, schedule_b, preference):
+    """Compare two schedules and say which fits the preference better."""
+    if len(schedule_a) == 0:
+        avg_a = 0
+    else:
+        total_a = sum(score_slot(item["slot"], preference) for item in schedule_a)
+        avg_a = total_a / len(schedule_a)
+
+    if len(schedule_b) == 0:
+        avg_b = 0
+    else:
+        total_b = sum(score_slot(item["slot"], preference) for item in schedule_b)
+        avg_b = total_b / len(schedule_b)
+
+    if avg_a >= avg_b:
+        better = "schedule_a"
+    else:
+        better = "schedule_b"
+
+    return {
+        "schedule_a_avg_score": round(avg_a, 1),
+        "schedule_b_avg_score": round(avg_b, 1),
+        "better_fit": better,
+    }
+
+
+def build_timetable(courses):
+    """Split courses into a clash-free schedule and a list of clashes."""
+    schedule = []
+    clashes = []
+
+    for i, course_a in enumerate(courses):
+        added = True
+        for course_b in schedule:
+            if check_clash(course_a["slot"], course_b["slot"]):
+                pair = (course_a["course"], course_b["course"])
+                if pair not in clashes and (pair[1], pair[0]) not in clashes:
+                    clashes.append(pair)
+                added = False
+                break
+        if added:
+            schedule.append(course_a)
+
+    return {"schedule": schedule, "clashes": clashes}
+
+
+def free_slots(busy_slots, day, day_start=8.0, day_end=17.0):
+    """Return free time gaps on one day between day_start and day_end."""
+    day_busy = []
+    for slot in busy_slots:
+        slot_day, start, end = slot
+        if slot_day == day:
+            day_busy.append((start, end))
+
+    day_busy.sort(key=lambda item: item[0])
+
+    free = []
+    current = day_start
+
+    for start, end in day_busy:
+        if start > current:
+            free.append((current, start))
+        if end > current:
+            current = end
+
+    if current < day_end:
+        free.append((current, day_end))
+
+    return free
+
+
+def workload_estimator(credit_hours, difficulty="medium"):
+    """Estimate weekly self-study hours from credit hours and difficulty."""
+    multipliers = {"easy": 1.5, "medium": 2, "hard": 3}
+    if difficulty not in multipliers:
+        difficulty = "medium"
+    return credit_hours * multipliers[difficulty]

teacher_tea-0.1.0/src/teacher_tea/teacher_insights.py

@@ -0,0 +1,417 @@
+"""Collect and summarize teacher reviews for course registration."""
+
+_reviews = {}
+
+
+def _seed_reviews():
+    """Load starting review data for all teachers from the faculty list."""
+    entries = [
+        ("Abdul Basit", "CS101", 4, 1, 5),
+        ("Abdul Jamil", "CS102", 3, 5, 5),
+        ("Abdullah Hasan", "SE201", 3, 3, 3),
+        ("Abdullah Miraj", "AI301", 5, 4, 5),
+        ("Abeera Ashraf", "IT205", 1, 5, 2),
+        ("Abu Huraira", "MATH101", 2, 4, 1),
+        ("Adeel Ashraf", "ENG102", 2, 3, 5),
+        ("Adnan Sadiq", "CS101", 1, 1, 4),
+        ("Afnan Iftikhar", "CS102", 5, 3, 4),
+        ("Ahmad Abduhu", "SE201", 1, 5, 4),
+        ("Ahmad Dawood", "AI301", 3, 4, 1),
+        ("Ahmad Hussain", "IT205", 2, 1, 5),
+        ("Ahmad Shaoor", "MATH101", 1, 4, 5),
+        ("Ahmad Sohail Aslam", "ENG102", 3, 2, 1),
+        ("Ahmad Yar", "CS101", 3, 4, 4),
+        ("Ahmed Raza", "CS102", 2, 2, 2),
+        ("Ahtsham Ali", "SE201", 4, 2, 2),
+        ("Aima Arif", "AI301", 3, 5, 1),
+        ("Ali Harris", "IT205", 3, 4, 2),
+        ("Ali Raza", "MATH101", 2, 2, 5),
+        ("Amal Akbar", "ENG102", 3, 1, 4),
+        ("Amiq Inayat", "CS101", 1, 4, 5),
+        ("Amjad Ali", "CS102", 5, 5, 3),
+        ("Ammar Haider", "SE201", 1, 4, 2),
+        ("Ammar Yasir Sajjad", "AI301", 1, 2, 1),
+        ("Ammerha Naz", "IT205", 4, 4, 3),
+        ("Amna Faisal", "MATH101", 3, 3, 3),
+        ("Anam Umera", "ENG102", 5, 3, 4),
+        ("Anum Saleem", "CS101", 1, 4, 3),
+        ("Aqsa Afzal", "CS102", 3, 5, 4),
+        ("Arifah Azhar", "SE201", 1, 1, 5),
+        ("Arman Sohail Saeed", "AI301", 5, 5, 4),
+        ("Arshi Iftikhar", "IT205", 1, 3, 3),
+        ("Arslan Ahmad", "MATH101", 4, 4, 4),
+        ("Arslan Anjum", "ENG102", 1, 1, 3),
+        ("Ashraf Ali", "CS101", 4, 2, 5),
+        ("Asim Aziz Waqas", "CS102", 5, 1, 4),
+        ("Asma", "SE201", 4, 4, 5),
+        ("Asma Arshad", "AI301", 1, 1, 3),
+        ("Asma Hamayoun", "IT205", 3, 5, 3),
+        ("Ateeqa Naseer", "MATH101", 3, 1, 4),
+        ("Awais Amin", "ENG102", 1, 2, 3),
+        ("Ayesha Arooj", "CS101", 2, 4, 4),
+        ("Ayesha Ashraf", "CS102", 5, 1, 3),
+        ("Ayesha Asmat", "SE201", 2, 2, 2),
+        ("Ayesha Ayub", "AI301", 4, 3, 1),
+        ("Ayesha Yasin", "IT205", 4, 5, 3),
+        ("Basit Sattar", "MATH101", 3, 3, 3),
+        ("Bilal Arif", "ENG102", 1, 5, 5),
+        ("Bilal Hussain", "CS101", 5, 3, 1),
+        ("Daniyal Adeeb", "CS102", 5, 4, 5),
+        ("Dr Aaqif Afzaal Abbasi", "SE201", 1, 2, 2),
+        ("Dr Abdul Hameed", "AI301", 5, 1, 3),
+        ("Dr Amber Sultan", "IT205", 4, 5, 5),
+        ("Dr Amjad Hussain Zahid", "MATH101", 2, 3, 4),
+        ("Dr Anwar Ur Rehman", "ENG102", 3, 4, 5),
+        ("Dr Arfan Arshad", "CS101", 2, 5, 2),
+        ("Dr Ashfaq Ahmad", "CS102", 1, 1, 3),
+        ("Dr Atif Alvi", "SE201", 3, 2, 2),
+        ("Dr Bilal Ashfaq Ahmed", "AI301", 5, 2, 2),
+        ("Dr Ehtesham Ul Haq Dar", "IT205", 2, 5, 2),
+        ("Dr Fawad Ali Khan", "MATH101", 5, 1, 3),
+        ("Dr Ghulam Mustafa", "ENG102", 3, 1, 5),
+        ("Dr Ifra Afzal", "CS101", 5, 3, 1),
+        ("Dr Iqra Javed", "CS102", 3, 1, 3),
+        ("Dr Irshad Ahmed", "SE201", 4, 2, 2),
+        ("Dr Jameel Ahmad", "AI301", 2, 5, 1),
+        ("Dr Kashif Ishaq", "IT205", 2, 4, 4),
+        ("Dr Kashif Zafar", "MATH101", 3, 4, 5),
+        ("Dr Malik Tahir Hassan", "ENG102", 5, 5, 5),
+        ("Dr Muhammad Adnan", "CS101", 5, 3, 5),
+        ("Dr Muhammad Ahsan", "CS102", 2, 2, 3),
+        ("Dr Muhammad Amir Khalil", "SE201", 3, 1, 1),
+        ("Dr Muhammad Asad Arshed", "AI301", 1, 1, 2),
+        ("Dr Muhammad Asghar Saqib", "IT205", 5, 2, 1),
+        ("Dr Muhammad Asim Butt", "MATH101", 2, 2, 2),
+        ("Dr Muhammad Azeem Javed", "ENG102", 2, 1, 5),
+        ("Dr Muhammad Danish Javed", "CS101", 3, 4, 5),
+        ("Dr Muhammad Faraz Manzoor", "CS102", 4, 4, 4),
+        ("Dr Muhammad Husnain Ashfaq", "SE201", 3, 4, 5),
+        ("Dr Muhammad Kabir", "AI301", 2, 4, 3),
+        ("Dr Muhammad Nadeem Ashraf", "IT205", 4, 2, 5),
+        ("Dr Muhammad Shoaib Farooq", "MATH101", 2, 1, 3),
+        ("Dr Muhammad Tahir Mushtaq", "ENG102", 3, 5, 4),
+        ("Dr Muhammad Tanveer", "CS101", 5, 1, 2),
+        ("Dr Muhammad Wasim Nawaz", "CS102", 5, 3, 3),
+        ("Dr Naeem Ahmed", "SE201", 1, 1, 3),
+        ("Dr Noman Javed", "AI301", 3, 2, 5),
+        ("Dr Nosheen Qamar", "IT205", 2, 1, 5),
+        ("Dr Raja Noshad Jamil", "MATH101", 5, 1, 2),
+        ("Dr Rashid Rasheed", "ENG102", 1, 2, 2),
+        ("Dr Rimsha Anam", "CS101", 1, 1, 4),
+        ("Dr Sadaf Jabeen", "CS102", 4, 1, 4),
+        ("Dr Saima Waseem", "SE201", 1, 3, 2),
+        ("Dr Sajid Mahmood", "AI301", 3, 3, 2),
+        ("Dr Sameera Basit", "IT205", 2, 4, 3),
+        ("Dr Shaista Habib", "MATH101", 2, 5, 3),
+        ("Dr Shariq Aziz Butt", "ENG102", 5, 3, 1),
+        ("Dr Shaukat Iqbal", "CS101", 2, 1, 5),
+        ("Dr Sohail Khalid", "CS102", 2, 1, 2),
+        ("Dr Syed Baqar Hussain", "SE201", 2, 1, 4),
+        ("Dr Syed Farooq Ali", "AI301", 3, 4, 5),
+        ("Dr Syed Khuram Shahzad", "IT205", 4, 5, 2),
+        ("Dr Tariq Mahmood", "MATH101", 3, 2, 2),
+        ("Dr Tayaba Anjum", "ENG102", 3, 4, 3),
+        ("Dr Tayyaba Anees", "CS101", 1, 3, 1),
+        ("Dr Toqir Ahmad Rana", "CS102", 2, 1, 3),
+        ("Dr Usman Inayat", "SE201", 3, 1, 3),
+        ("Dr Uzma Farooq", "AI301", 5, 2, 3),
+        ("Dr Waqar Azeem", "IT205", 5, 4, 4),
+        ("Dr Waseem Iqbal", "MATH101", 3, 2, 4),
+        ("Dr Yaser Daanial Khan", "ENG102", 5, 4, 5),
+        ("Emmara Zulfiqar", "CS101", 5, 5, 2),
+        ("Emmen Farooq", "CS102", 1, 4, 5),
+        ("Ezzah Aftab", "SE201", 1, 4, 2),
+        ("Fahad Ali", "AI301", 2, 1, 4),
+        ("Faheem Akbar", "IT205", 1, 4, 3),
+        ("Faisal Nadeem", "MATH101", 5, 1, 2),
+        ("Faiza Saeed", "ENG102", 2, 3, 4),
+        ("Faizan Younas", "CS101", 5, 2, 2),
+        ("Fakhar Abbas", "CS102", 4, 5, 1),
+        ("Fareeha Rauf", "SE201", 5, 5, 5),
+        ("Faria Ferooz", "AI301", 3, 3, 2),
+        ("Faria Nazir", "IT205", 5, 5, 1),
+        ("Farrukh Liaquat", "MATH101", 5, 5, 3),
+        ("Fasiha Ashraf", "ENG102", 3, 2, 4),
+        ("Fatima Shehzad", "CS101", 1, 1, 5),
+        ("Fatima Tariq", "CS102", 4, 3, 5),
+        ("Fiza Kazmi", "SE201", 5, 2, 3),
+        ("Furqan Rustam", "AI301", 1, 3, 3),
+        ("Ghulam Murtaza", "IT205", 1, 1, 5),
+        ("Habiba Habib", "MATH101", 4, 2, 5),
+        ("Hafiz Abdul Rehman", "ENG102", 1, 4, 5),
+        ("Hafiz Ahsan Arshad", "CS101", 1, 3, 4),
+        ("Hafiz Muhammad Ahmad Nawaz", "CS102", 5, 3, 2),
+        ("Hafiz Muhammad Ashja Khan", "SE201", 2, 5, 4),
+        ("Hafiz Muhammad Rizwan", "AI301", 1, 2, 3),
+        ("Hafiz Muhammad Tahir Sohail", "IT205", 1, 3, 4),
+        ("Hafiz Saifullah", "MATH101", 5, 5, 5),
+        ("Hafiza Daheem", "ENG102", 1, 1, 2),
+        ("Hafiza Hina Javed", "CS101", 3, 4, 5),
+        ("Hafsa Rafique", "CS102", 5, 1, 3),
+        ("Hafsa Riasat", "SE201", 2, 2, 3),
+        ("Hafsa Zafar", "AI301", 3, 4, 3),
+        ("Haiqa Saman", "IT205", 3, 4, 5),
+        ("Hajran Saleem", "MATH101", 3, 2, 2),
+        ("Halima Jamil", "ENG102", 4, 5, 4),
+        ("Hamda Raheen", "CS101", 2, 2, 4),
+        ("Hamid Raza Malik", "CS102", 3, 1, 2),
+        ("Hamza Mustafa", "SE201", 1, 2, 1),
+        ("Hareem Aslam", "AI301", 1, 2, 3),
+        ("Haseeb Imdad", "IT205", 5, 4, 2),
+        ("Hashir Hasnain Asghar", "MATH101", 5, 4, 4),
+        ("Hassaan Ahmad", "ENG102", 4, 2, 4),
+        ("Hassan Bashir", "CS101", 4, 4, 2),
+        ("Hassan Moatasam Awan", "CS102", 5, 3, 5),
+        ("Hina Bari", "SE201", 4, 2, 1),
+        ("Insha Rafique", "AI301", 5, 1, 5),
+        ("Iqra Khalid", "IT205", 1, 1, 3),
+        ("Iqra Khalil", "MATH101", 4, 4, 1),
+        ("Javeria Iqbal", "ENG102", 2, 4, 4),
+        ("Jawad Hassan", "CS101", 4, 1, 3),
+        ("Jawairia Rasheed", "CS102", 1, 5, 4),
+        ("Jaweria Aamir Ali", "SE201", 2, 2, 4),
+        ("Jaweria Aslam", "AI301", 1, 1, 5),
+        ("Kamla Salahuddin", "IT205", 2, 5, 1),
+        ("Kamran Arshad", "MATH101", 1, 4, 5),
+        ("Kawish Habiba", "ENG102", 2, 5, 4),
+        ("Khadija Shams", "CS101", 5, 1, 5),
+        ("Khaqan Zaheer", "CS102", 4, 1, 5),
+        ("Khawaja Ubaid Ur Rehman", "SE201", 2, 3, 1),
+        ("Kinza Sardar", "AI301", 2, 2, 2),
+        ("Komal Naseer", "IT205", 2, 4, 5),
+        ("Laila Zahra", "MATH101", 2, 5, 5),
+        ("Laraib Kanwal", "ENG102", 4, 1, 4),
+        ("Madiha Jalil", "CS101", 4, 3, 4),
+        ("Mahira Zainab", "CS102", 2, 1, 5),
+        ("Mahmood Hussain", "SE201", 2, 1, 4),
+        ("Maida Sabir", "AI301", 4, 1, 5),
+        ("Mariha Asad", "IT205", 4, 1, 1),
+        ("Mariya Tauqeer", "MATH101", 5, 2, 2),
+        ("Maryam Afzal", "ENG102", 3, 1, 5),
+        ("Mehak Saleem", "CS101", 2, 4, 1),
+        ("Mehr Un Nisa", "CS102", 4, 3, 4),
+        ("Mehwish Afshan", "SE201", 5, 2, 2),
+        ("Mian Ahmed Shafiq", "AI301", 5, 4, 2),
+        ("Mian Raybal Akhtar", "IT205", 5, 2, 5),
+        ("Mirza Muhammad Haris Baig", "MATH101", 1, 4, 2),
+        ("Mobashirah Nasir", "ENG102", 1, 1, 1),
+        ("Mohammad Umar Farooq", "CS101", 3, 1, 1),
+        ("Mudassar Hussain", "CS102", 1, 1, 2),
+        ("Muhammad Abdul Jabbar", "SE201", 5, 1, 4),
+        ("Muhammad Abdullah Fiaz", "AI301", 2, 3, 3),
+        ("Muhammad Ali", "IT205", 1, 5, 3),
+        ("Muhammad Amir Waseem", "MATH101", 1, 1, 3),
+        ("Muhammad Asif Subhani", "ENG102", 5, 1, 3),
+        ("Muhammad Awais Ali", "CS101", 3, 3, 4),
+        ("Muhammad Ayesh Butt", "CS102", 5, 1, 5),
+        ("Muhammad Bilal", "SE201", 4, 1, 5),
+        ("Muhammad Bilal Anwar", "AI301", 5, 5, 1),
+        ("Muhammad Ehsan", "IT205", 1, 5, 3),
+        ("Muhammad Fahad Irshad", "MATH101", 5, 1, 3),
+        ("Muhammad Faheem Subhnani", "ENG102", 4, 1, 2),
+        ("Muhammad Faran Aslam", "CS101", 5, 3, 1),
+        ("Muhammad Farrukh Nadeem", "CS102", 5, 5, 4),
+        ("Muhammad Hamza Farooq", "SE201", 2, 2, 4),
+        ("Muhammad Haroon", "AI301", 1, 3, 3),
+        ("Muhammad Ibtissam", "IT205", 3, 1, 3),
+        ("Muhammad Imran Shafi", "MATH101", 4, 4, 3),
+        ("Muhammad Jawad Akhtar", "ENG102", 4, 4, 2),
+        ("Muhammad Maaz Waseem", "CS101", 1, 2, 4),
+        ("Muhammad Masab Akram", "CS102", 3, 1, 2),
+        ("Muhammad Mustansar Ali Khan", "SE201", 5, 4, 5),
+        ("Muhammad Nabeel", "AI301", 4, 5, 3),
+        ("Muhammad Nadeem", "IT205", 3, 5, 3),
+        ("Muhammad Rehan Akhtar", "MATH101", 4, 5, 1),
+        ("Muhammad Rizwan", "ENG102", 1, 1, 1),
+        ("Muhammad Rizwan Jamil", "CS101", 4, 1, 4),
+        ("Muhammad Rumaan", "CS102", 2, 3, 3),
+        ("Muhammad Sadaqat Janjua", "SE201", 2, 5, 5),
+        ("Muhammad Saqib", "AI301", 3, 2, 3),
+        ("Muhammad Saquib Nazir", "IT205", 2, 2, 3),
+        ("Muhammad Sarwar", "MATH101", 5, 5, 3),
+        ("Muhammad Shahbaz Ali", "ENG102", 2, 3, 1),
+        ("Muhammad Shehan Latif", "CS101", 5, 1, 4),
+        ("Muhammad Sheraz Nawaz", "CS102", 1, 5, 5),
+        ("Muhammad Shoaib", "SE201", 2, 2, 5),
+        ("Muhammad Siddiqui", "AI301", 3, 5, 4),
+        ("Muhammad Tahir", "IT205", 3, 5, 1),
+        ("Muhammad Umar Farooq", "MATH101", 3, 1, 5),
+        ("Muhammad Waseem Asif", "ENG102", 2, 2, 4),
+        ("Muhammad Wisal Khan", "CS101", 5, 2, 1),
+        ("Muhammad Zubair Shafique", "CS102", 4, 3, 5),
+        ("Mutahher Mahmood", "SE201", 1, 5, 4),
+        ("Muzahir Saleem", "AI301", 2, 2, 3),
+        ("Muzzamil Mustafa", "IT205", 1, 2, 5),
+        ("Nabeel Ali Khan", "MATH101", 2, 5, 4),
+        ("Nafeesa Yousaf", "ENG102", 1, 2, 5),
+        ("Naila Aslam", "CS101", 4, 3, 5),
+        ("Naseer Ahmad", "CS102", 1, 2, 1),
+        ("Naveed Husain", "SE201", 3, 4, 2),
+        ("Nitasha Arooj", "AI301", 2, 5, 4),
+        ("Noaman Saleem", "IT205", 4, 5, 5),
+        ("Noreen Ashraf", "MATH101", 4, 4, 3),
+        ("Numan Babar", "ENG102", 1, 3, 3),
+        ("Osama Tariq", "CS101", 4, 2, 4),
+        ("Qamar Abbas Arbie", "CS102", 3, 3, 5),
+        ("Qanza Azam", "SE201", 4, 3, 4),
+        ("Rabia Khalid", "AI301", 3, 3, 3),
+        ("Rabia Qasim", "IT205", 2, 5, 4),
+        ("Rafia Asad Khan", "MATH101", 3, 2, 1),
+        ("Raja Muzammil Muneer", "ENG102", 4, 5, 3),
+        ("Rana Marwat Hussain", "CS101", 3, 3, 4),
+        ("Reamsha Khan", "CS102", 2, 2, 5),
+        ("Rehan Raza", "SE201", 5, 5, 5),
+        ("Reshmail Fatima", "AI301", 1, 3, 1),
+        ("Rida Ayesha", "IT205", 1, 1, 5),
+        ("Roma Rasheed", "MATH101", 3, 4, 4),
+        ("Sadia Abbas Shah", "ENG102", 4, 4, 1),
+        ("Sahrish Shafique", "CS101", 1, 5, 3),
+        ("Saima Shaheen", "CS102", 5, 2, 1),
+        ("Samar Ikram", "SE201", 3, 1, 5),
+        ("Sameer Ahmed", "AI301", 4, 2, 5),
+        ("Sana Akhtar Naseer", "IT205", 2, 3, 4),
+        ("Sana Naseem", "MATH101", 2, 3, 3),
+        ("Sana Zubair", "ENG102", 5, 2, 5),
+        ("Sania Qamar", "CS101", 1, 5, 2),
+        ("Sardar Waqar Khan", "CS102", 1, 2, 3),
+        ("Sehrish Munawar", "SE201", 2, 2, 2),
+        ("Sehrish Riaz", "AI301", 4, 5, 5),
+        ("Shafaq Khan", "IT205", 2, 5, 4),
+        ("Shahbaz Qadeer", "MATH101", 3, 4, 4),
+        ("Shaheen Bibi", "ENG102", 4, 5, 5),
+        ("Shahzaib Mushtaq Shah", "CS101", 4, 5, 2),
+        ("Shamila Ghafoor", "CS102", 4, 4, 1),
+        ("Shanza Zaman", "SE201", 5, 5, 2),
+        ("Sharmeen Amir", "AI301", 3, 3, 4),
+        ("Sheeza Zaheer", "IT205", 3, 2, 1),
+        ("Shehla Afzal", "MATH101", 5, 5, 1),
+        ("Sheza Shabir", "ENG102", 4, 3, 2),
+        ("Shinawar Naeem", "CS101", 5, 5, 5),
+        ("Shoaib Khan", "CS102", 1, 1, 3),
+        ("Sidra Ramzan", "SE201", 4, 2, 5),
+        ("Sowaiba Khan", "AI301", 1, 5, 4),
+        ("Sundas Sagheer", "IT205", 1, 4, 4),
+        ("Syed Hamed Raza", "MATH101", 2, 5, 5),
+        ("Syed Shaheer Afzal", "ENG102", 3, 3, 4),
+        ("Syeda Inshrah Fatima", "CS101", 5, 1, 3),
+        ("Syeda Nimra Zamir", "CS102", 2, 2, 1),
+        ("Tahir Mehmood", "SE201", 2, 2, 2),
+        ("Tahir Shahzad", "AI301", 1, 2, 4),
+        ("Taila Jabeen", "IT205", 1, 4, 2),
+        ("Talha Bin Sohail", "MATH101", 5, 5, 1),
+        ("Umair Ghazanfar", "ENG102", 1, 2, 3),
+        ("Umer Usman", "CS101", 3, 2, 5),
+        ("Usama Ahmed", "CS102", 5, 5, 2),
+        ("Usama Amjad", "SE201", 3, 3, 2),
+        ("Usama Husnain", "AI301", 5, 1, 2),
+        ("Usman Ali", "IT205", 3, 4, 2),
+        ("Usman Ul Haq", "MATH101", 2, 5, 1),
+        ("Uzair Arslan", "ENG102", 4, 4, 3),
+        ("Uzair Zia", "CS101", 1, 4, 2),
+        ("Waleed Riaz", "CS102", 4, 1, 2),
+        ("Waqar Ashiq", "SE201", 3, 2, 4),
+        ("Waqar Hussain", "AI301", 3, 4, 1),
+        ("Warda Mehboob", "IT205", 4, 1, 3),
+        ("Zahida Tayyab", "MATH101", 3, 4, 4),
+        ("Zahoor Ahmed Khan", "ENG102", 2, 5, 3),
+        ("Zarnab Azam", "CS101", 5, 4, 4),
+        ("Zaryab Qayyum", "CS102", 2, 1, 3),
+        ("Zeenat Tanveer", "SE201", 2, 3, 3),
+        ("Zeeshan Akram", "AI301", 5, 2, 2),
+        ("Zohaib Ashraf", "IT205", 1, 1, 4),
+        ("Zunaira Zulfiqar", "MATH101", 1, 2, 5),
+    ]
+    for teacher, course, attendance_strictness, teaching_quality, grading_leniency in entries:
+        if teacher not in _reviews:
+            _reviews[teacher] = {}
+        if course not in _reviews[teacher]:
+            _reviews[teacher][course] = []
+        _reviews[teacher][course].append({
+            "attendance_strictness": attendance_strictness,
+            "teaching_quality": teaching_quality,
+            "grading_leniency": grading_leniency,
+        })
+
+
+_seed_reviews()
+
+
+def add_review(teacher, course, attendance_strictness, teaching_quality, grading_leniency):
+    """Add a student review for a teacher and course."""
+    scores = {
+        "attendance_strictness": attendance_strictness,
+        "teaching_quality": teaching_quality,
+        "grading_leniency": grading_leniency,
+    }
+    for name, value in scores.items():
+        if not isinstance(value, int) or value < 1 or value > 5:
+            raise ValueError(f"{name} must be an integer between 1 and 5")
+
+    if teacher not in _reviews:
+        _reviews[teacher] = {}
+    if course not in _reviews[teacher]:
+        _reviews[teacher][course] = []
+
+    review = {
+        "attendance_strictness": attendance_strictness,
+        "teaching_quality": teaching_quality,
+        "grading_leniency": grading_leniency,
+    }
+    _reviews[teacher][course].append(review)
+    return f"Review added for {teacher} in {course}."
+
+
+def get_teacher_summary(teacher):
+    """Return average review scores and course list for one teacher."""
+    if teacher not in _reviews or not _reviews[teacher]:
+        return f"No reviews found for {teacher}."
+
+    all_reviews = []
+    courses = sorted(_reviews[teacher].keys())
+    for course in courses:
+        all_reviews.extend(_reviews[teacher][course])
+
+    count = len(all_reviews)
+    avg_attendance = sum(r["attendance_strictness"] for r in all_reviews) / count
+    avg_teaching = sum(r["teaching_quality"] for r in all_reviews) / count
+    avg_grading = sum(r["grading_leniency"] for r in all_reviews) / count
+
+    return {
+        "teacher": teacher,
+        "review_count": count,
+        "avg_attendance_strictness": round(avg_attendance, 2),
+        "avg_teaching_quality": round(avg_teaching, 2),
+        "avg_grading_leniency": round(avg_grading, 2),
+        "courses": courses,
+    }
+
+
+def compare_teachers(teacher1, teacher2):
+    """Compare review summaries for two teachers."""
+    return {
+        teacher1: get_teacher_summary(teacher1),
+        teacher2: get_teacher_summary(teacher2),
+    }
+
+
+def best_teacher_for(course):
+    """Find the teacher with the highest teaching quality for a course."""
+    best_name = None
+    best_score = -1
+
+    for teacher, courses in _reviews.items():
+        if course not in courses:
+            continue
+        reviews = courses[course]
+        avg = sum(r["teaching_quality"] for r in reviews) / len(reviews)
+        if avg > best_score:
+            best_score = avg
+            best_name = teacher
+
+    if best_name is None:
+        return f"No reviews found for course {course}."
+
+    return {
+        "teacher": best_name,
+        "avg_teaching_quality": round(best_score, 2),
+    }

teacher_tea-0.1.0/src/teacher_tea.egg-info/PKG-INFO

@@ -0,0 +1,42 @@
+Metadata-Version: 2.4
+Name: teacher-tea
+Version: 0.1.0
+Summary: Help students compare teachers and build clash-free class schedules.
+Author-email: Ali Haider <AliHaider7108@users.noreply.github.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# TeacherTea
+
+TeacherTea is a small Python library that helps university students pick teachers and plan a weekly timetable. It includes teacher review summaries and simple schedule tools.
+
+## Install
+
+```bash
+pip install teacher-tea
+```
+
+## Quick example
+
+```python
+from teacher_tea import get_teacher_summary, compare_teachers, best_teacher_for
+from teacher_tea import check_clash, build_timetable, free_slots, workload_estimator
+
+print(get_teacher_summary("Jawairia Rasheed"))
+print(compare_teachers("Jawairia Rasheed", "Noreen Ashraf"))
+print(best_teacher_for("CS101"))
+
+courses = [
+    {"course": "CS101", "teacher": "Jawairia Rasheed", "slot": ("Mon", 9.0, 10.5)},
+    {"course": "SE201", "teacher": "Noreen Ashraf", "slot": ("Mon", 10.0, 11.5)},
+]
+print(build_timetable(courses))
+print(free_slots([("Mon", 9.0, 10.5), ("Mon", 14.0, 15.5)], "Mon"))
+print(workload_estimator(3, "medium"))
+```

teacher_tea-0.1.0/src/teacher_tea.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+src/teacher_tea/__init__.py
+src/teacher_tea/schedule_helper.py
+src/teacher_tea/teacher_insights.py
+src/teacher_tea.egg-info/PKG-INFO
+src/teacher_tea.egg-info/SOURCES.txt
+src/teacher_tea.egg-info/dependency_links.txt
+src/teacher_tea.egg-info/top_level.txt

teacher_tea-0.1.0/src/teacher_tea.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

teacher_tea-0.1.0/src/teacher_tea.egg-info/top_level.txt

@@ -0,0 +1 @@
+teacher_tea