robquant
diff --git a/‎webuntis/objects.py‎
Lines changed: 20 additions & 5 deletions b/‎webuntis/objects.py‎
Lines changed: 20 additions & 5 deletions
diff --git a/‎webuntis/objects.pyi‎
Lines changed: 40 additions & 20 deletions b/‎webuntis/objects.pyi‎
Lines changed: 40 additions & 20 deletions
diff --git a/‎webuntis/session.py‎
Lines changed: 8 additions & 0 deletions b/‎webuntis/session.py‎
Lines changed: 8 additions & 0 deletions
@@ -490,26 +490,29 @@ class SubjectList(ListResult):
     _itemclass = SubjectObject
 
 
-class TeacherObject(ListItem):
-    """Represents a teacher."""
+class PersonObject(ListItem):
+    """Represents a person (teacher or student)."""
 
     @lazyproperty
     def fore_name(self):
-        """fore name of the teacher"""
+        """fore name of the person"""
         return self._data[u'foreName']
 
     @lazyproperty
     def long_name(self):
-        """surname of teacher"""
+        """surname of person"""
         return self._data[u'longName']
 
     surname = long_name
 
     @lazyproperty
     def name(self):
-        """full name of the teacher"""
+        """full name of the person"""
         return self._data[u'name']
 
+
+class TeacherObject(PersonObject):
+    """Represents a teacher."""
     @lazyproperty
     def title(self):
         """title of the teacher"""
@@ -681,3 +684,15 @@ def timeUnits(self):
 
 class TimegridObject(ListResult):
     _itemclass = TimegridDayObject
+
+
+class StudentObject(PersonObject):
+    """Represents a student."""
+
+    @lazyproperty
+    def full_name(self):
+        """full name of student (forname, longname)"""
+        return " ".join((self.fore_name, self.long_name)).strip()
+
+class StudentsList(ListResult):
+    _itemclass = StudentObject
@@ -184,6 +184,29 @@ class PeriodObject(ListItem):
         ...
 
 
+class PersonObject(ListItem):
+
+    @property
+    def fore_name(self) -> str:
+        ...
+
+    @property
+    def full_name(self) -> str:
+        ...
+
+    @property
+    def long_name(self) -> str:
+        ...
+
+    @property
+    def name(self) -> str:
+        ...
+
+    @property
+    def surname(self) -> str:
+        ...
+
+
 class RoomList(ListResult):
 
     def filter(self, **criterions) -> RoomList:
@@ -267,6 +290,20 @@ class SubjectObject(ListItem):
         ...
 
 
+class StudentsList(ListResult):
+    def filter(self, **criterions) -> StudentsList:
+        ...
+
+    def __getitem__(self, i: int) -> StudentObject:
+        ...
+
+
+class StudentObject(PersonObject):
+    @property
+    def full_name(self) -> str:
+        ...
+
+
 class SubstitutionList(ListResult):
 
     def filter(self, **criterions) -> SubstitutionList:
@@ -300,30 +337,13 @@ class TeacherList(ListResult):
         ...
 
 
-class TeacherObject(ListItem):
-
-    @property
-    def fore_name(self) -> str:
-        ...
-
-    @property
-    def full_name(self) -> str:
-        ...
-
-    @property
-    def long_name(self) -> str:
-        ...
-
+class TeacherObject(PersonObject):
     @property
-    def name(self) -> str:
-        ...
-
-    @property
-    def surname(self) -> str:
+    def title(self) -> str:
         ...
 
     @property
-    def title(self) -> str:
+    def full_name(self):
         ...
 
 
 
@@ -323,6 +323,14 @@ def timegridUnits(self):
         return objects.TimegridObject, 'getTimegridUnits', {}
 
 
+    @result_wrapper
+    def students(self):
+        """
+
+        :rtype:  :py:class:`webuntis.objects.StudentsList`
+        """
+        return objects.StudentsList, 'getStudents', {}
+
 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.