nusmods-api 0.2.0__tar.gz → 0.3.1__tar.gz

{nusmods_api-0.2.0 → nusmods_api-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nusmods-api
-Version: 0.2.0
+Version: 0.3.1
 Summary: A Python wrapper for the NUSMods API
 Author: kommade
 Author-email: kommade <khoojarrell@gmail.com>
@@ -182,6 +182,8 @@ The package exposes frozen dataclasses for common API response types:
 
 Some model fields retain the NUSMods API naming convention, such as
 `moduleCode`, `classNo`, `startTime`, `lessonType`, and `examDate`.
+`ExamTimetable.examDate` is represented as a `datetime` and preserves the
+time and timezone supplied by the API.
 
 ## Error handling
 

{nusmods_api-0.2.0 → nusmods_api-0.3.1}/README.md

@@ -172,6 +172,8 @@ The package exposes frozen dataclasses for common API response types:
 
 Some model fields retain the NUSMods API naming convention, such as
 `moduleCode`, `classNo`, `startTime`, `lessonType`, and `examDate`.
+`ExamTimetable.examDate` is represented as a `datetime` and preserves the
+time and timezone supplied by the API.
 
 ## Error handling
 

{nusmods_api-0.2.0 → nusmods_api-0.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nusmods-api"
-version = "0.2.0"
+version = "0.3.1"
 description = "A Python wrapper for the NUSMods API"
 readme = "README.md"
 requires-python = ">=3.15.0"

{nusmods_api-0.2.0 → nusmods_api-0.3.1}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "nusmods-api"
-version = "0.2.0"
+version = "0.3.1"
 description = "A Python wrapper for the NUSMods API"
 readme = "README.md"
 authors = [

{nusmods_api-0.2.0 → nusmods_api-0.3.1}/src/nusmods_api/client.py

@@ -6,7 +6,7 @@ import re
 from typing import Any
 
 import requests
-from datetime import datetime, date
+from datetime import datetime
 from pathlib import Path
 from urllib.parse import parse_qs, urlparse
 
@@ -387,8 +387,8 @@ class NUSModsClient:
     def _exam_sort_key(
         self,
         exam: ExamTimetable,
-    ) -> tuple[date, str]:
+    ) -> tuple[datetime, str]:
         return (
-            exam.examDate or date.max,
+            exam.examDate or datetime.max,
             exam.moduleCode,
         )

{nusmods_api-0.2.0 → nusmods_api-0.3.1}/src/nusmods_api/models.py

@@ -88,13 +88,13 @@ class SemesterData:
     """Semester data for a module."""
 
     semester: int
-    examDate: date | None = None
+    examDate: datetime | None = None
     examDuration: int | None = None
     timetable: list[Lesson] | None = None
     
     def __post_init__(self) -> None:
-        if self.examDate is not None and not isinstance(self.examDate, date):
-            object.__setattr__(self, "examDate", parse_date(self.examDate))
+        if self.examDate is not None and not isinstance(self.examDate, datetime):
+            object.__setattr__(self, "examDate", parse_datetime(self.examDate))
 
 @dataclass(frozen=True)
 class ModuleCondensed:
@@ -138,7 +138,7 @@ class ExamTimetable:
     """Exam timetable for a module."""
 
     moduleCode: str
-    examDate: date | None = None
+    examDate: datetime | None = None
     examDuration: int | None = None
 
 @dataclass(frozen=True)
@@ -148,7 +148,7 @@ class Timetable:
     weekly: list[LessonWithModule]
     exams: list[ExamTimetable]
     
-    def get_day_schedule(self, day: str) -> list[Lesson]:
+    def get_day_schedule(self, day: str) -> list[LessonWithModule]:
         """Get the lessons for a specific day of the week."""
         if day not in {"Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"}:
             raise ValueError("Day must be one of Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday")
@@ -168,6 +168,10 @@ def parse_date(value: str) -> date:
         return datetime.fromisoformat(value.replace("Z", "+00:00")).date()
 
 
+def parse_datetime(value: str) -> datetime:
+    return datetime.fromisoformat(value.replace("Z", "+00:00"))
+
+
 def parse_weeks(value: list[int] | dict[str, Any]) -> LessonWeeks:
     if isinstance(value, list):
         return value