robquant
diff --git a/‎tests/test_session.py‎
Lines changed: 5 additions & 3 deletions b/‎tests/test_session.py‎
Lines changed: 5 additions & 3 deletions
diff --git a/‎webuntis/objects.py‎
Lines changed: 10 additions & 0 deletions b/‎webuntis/objects.py‎
Lines changed: 10 additions & 0 deletions
diff --git a/‎webuntis/objects.pyi‎
Lines changed: 14 additions & 0 deletions b/‎webuntis/objects.pyi‎
Lines changed: 14 additions & 0 deletions
diff --git a/‎webuntis/session.py‎
Lines changed: 32 additions & 1 deletion b/‎webuntis/session.py‎
Lines changed: 32 additions & 1 deletion
@@ -328,8 +328,10 @@ def test_students(self):
             assert student.full_name == "Alexander Mueller"
             assert student.gender == "male"
 
-
-
-
     def test_examtype(self):
+        """@TODO"""
+        pass
+
+    def test_exam(self):
+        """@TODO"""
         pass
@@ -693,6 +693,7 @@ def end(self):
 
 class TimegridDayObject(Result):
     """Information about one day in the time grid"""
+
     @lazyproperty
     def day(self):
         return self._data[u'day']
@@ -727,10 +728,12 @@ def full_name(self):
     def gender(self):
         return self._data[u'gender']
 
+
 class StudentsList(ListResult):
     """A list of students"""
     _itemclass = StudentObject
 
+
 '''
 @TODO: need additional rights
 class ExamTypeObject(Result):
@@ -739,4 +742,11 @@ class ExamTypeObject(Result):
 class ExamTypeList(ListResult):
     """A list of exam types"""
     _itemclass = ExamTypeObject
+
+class ExamObject(Result):
+    """Represents an Exam."""
+
+class ExamList(ListResult):
+    """A list of exams."""
+    _itemclass = ExamObject
 '''
@@ -312,6 +312,7 @@ class StudentObject(PersonObject):
     def gender(self) -> str:
         ...
 
+
 class StudentsList(ListResult):
     _itemclass = StudentObject
 
@@ -413,6 +414,7 @@ class TimegridObject(ListResult):
     def __getitem__(self, i: int) -> TimegridDayObject:
         ...
 
+
 """
 @TODO: need additional rights
 
@@ -427,4 +429,16 @@ class ExamTypeList(ListResult):
 
     def __getitem__(self, i: int) -> ExamTypeObject:
         ...
+
+class ExamObject(Result):
+    ...
+
+class ExamList(ListResult):
+    _itemclass = ExamObject
+
+    def filter(self, **criterions) -> ExamObject:
+        ...
+
+    def __getitem__(self, i: int) -> ExamObject:
+        ...
 """
@@ -335,13 +335,44 @@ def students(self):
     @TODO: need additional rights
     @result_wrapper
     def examTypes(self):
-        """Information about the Exams.
+        """Information about the Exam types.
 
         :rtype:  :py:class:`webuntis.objects.ExamTypeList`
         """
         return objects.ExamTypeList, 'getExamTypes', {}
+
+    
+    @result_wrapper
+    def exams(self, start, end, examTypeId=0):
+        """Information about the Exams.
+
+        :type start: :py:class:`datetime.datetime` or  :py:class:`datetime.date` or int
+        :param start: The beginning of the time period.
+
+        :type end: :py:class:`datetime.datetime` or  :py:class:`datetime.date` or int
+        :param end: The end of the time period.
+
+        :param examTypeId:  int, ??
+
+        :rtype: :py:class:`webuntis.objects.ExamList`
+        """
+
+        json_start = utils.datetime_utils.format_date(start)
+        json_end = utils.datetime_utils.format_date(end)
+
+        if json_start > json_end:
+            raise ValueError('Start can\'t be later than the end.')
+
+        parameters = {
+            'startDate': json_start,
+            'endDate': json_end,
+            'examTypeId': examTypeId
+        }
+
+        return objects.ExamList, 'getExams', parameters
     '''
 
+
 class Session(JSONRPCSession, ResultWrapperMixin):
     """The origin of everything you want to do with the WebUntis API. Can be
     used as a context-manager to provide automatic log-out.