feat(system): add new roster functions from 8.1.21 (#99)

* feat(system): add new roster functions from 8.1.21

getRoster
getRosterNames
add supporting classes

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: César Román

src/com/inductiveautomation/ignition/alarming/__init__.py

@@ -0,0 +1,27 @@
+from typing import List
+
+from com.inductiveautomation.ignition.common.user import User
+from com.palantir.ptoss.cinch.core import DefaultBindableModel
+from java.lang import String
+
+
+class RosterModel(DefaultBindableModel):
+    def getName(self):
+        # type: () -> String
+        pass
+
+    def getUsers(self):
+        # type: () -> List[String]
+        pass
+
+    def set(self, that):
+        # type: (RosterModel) -> None
+        pass
+
+    def setName(self, name):
+        # type: (String) -> None
+        pass
+
+    def setUsers(self, users):
+        # type: (List[User]) -> None
+        pass

src/com/inductiveautomation/ignition/alarming/common/__init__.py

@@ -1,9 +1,9 @@
 __all__ = ["ScheduleModel"]
 
-from java.lang import Object
+from com.palantir.ptoss.cinch.core import DefaultBindableModel
 
 
-class ScheduleModel(Object):
+class ScheduleModel(DefaultBindableModel):
     def deselectDayOfWeek(self, day):
         pass
 

src/com/inductiveautomation/ignition/alarming/common/rosters/__init__.py

@@ -6,11 +6,12 @@
     "ScheduleAdjustment",
 ]
 
+from com.palantir.ptoss.cinch.core import DefaultBindableModel
 from java.lang import Object, String
 from java.util import Date
 
 
-class AbstractScheduleModel(Object):
+class AbstractScheduleModel(DefaultBindableModel):
     def getScheduleForDay(self, cal):
         pass
 
@@ -172,7 +173,7 @@ def getModels(self):
         pass
 
 
-class HolidayModel(Object):
+class HolidayModel(DefaultBindableModel):
     date = None  # type: Date
     name = None  # type: String
     repeatAnnually = None  # type: bool
@@ -212,7 +213,7 @@ def setRepeatAnnually(self, repeatAnnually):
         self.repeatAnnually = repeatAnnually
 
 
-class ScheduleAdjustment(Object):
+class ScheduleAdjustment(DefaultBindableModel):
     start = None  # type: Date
     end = None  # type: Date
     available = None  # type: bool

src/com/inductiveautomation/ignition/client/util/gui/scheduling/__init__.py

@@ -0,0 +1,31 @@
+from typing import Any
+
+from java.lang import Object
+
+
+class Binding(object):
+    def update(self, *args):
+        # type: (*Any) -> None
+        raise NotImplementedError
+
+
+class DefaultBindableModel(Object):
+    def bind(self, toBind):
+        # type: (Binding) -> None
+        pass
+
+    def modelUpdated(self, *args):
+        # type: (*Any) -> None
+        pass
+
+    def unbind(self, toUnbind):
+        # type: (Binding) -> None
+        pass
+
+    def unbindAll(self):
+        # type: () -> None
+        pass
+
+    def update(self):
+        # type: () -> None
+        pass

src/com/inductiveautomation/ignition/common/user/schedule/__init__.py

@@ -6,10 +6,19 @@
 
 from __future__ import print_function
 
-__all__ = ["addUsers", "createRoster", "deleteRoster", "getRosters", "removeUsers"]
+__all__ = [
+    "addUsers",
+    "createRoster",
+    "deleteRoster",
+    "getRoster",
+    "getRosterNames",
+    "getRosters",
+    "removeUsers",
+]
 
 from typing import Dict, List
 
+from com.inductiveautomation.ignition.alarming.common.rosters import RosterModel
 from com.inductiveautomation.ignition.common.user import PyUser
 from java.lang import String
 
@@ -59,6 +68,30 @@ def deleteRoster(rosterName):
     print(rosterName)
 
 
+def getRoster(name):
+    """Returns the roster corresponding to the given name.
+
+    Args:
+        name: The name of the roster to get the RosterModel object from.
+
+    Returns:
+        A RosterModel Object. Call getUsers() to access a list of User
+        objects in the RosterModel.
+    """
+    print(name)
+    return RosterModel()
+
+
+def getRosterNames():
+    # type: () -> List[String]
+    """Returns a list of roster names.
+
+    Returns:
+        A list of Strings representing the roster names
+    """
+    return ["On-Call"]
+
+
 def getRosters():
     # type: () -> Dict[String, List[String]]
     """Returns a dictionary of rosters, where the key is the name of the