Calendar API updates

Author: [email protected]

office365/calendar/event.py

@@ -1,9 +1,47 @@
 from office365.mail.item import Item
+from office365.runtime.resource_path import ResourcePath
 
 
 class Event(Item):
-    """An event in a calendar."""
+    """An event in a user calendar, or the default calendar of a Microsoft 365 group."""
 
     @property
     def id(self):
         return self.properties.get("id", None)
+
+    @property
+    def body_preview(self):
+        """
+        The preview of the message associated with the event. It is in text format.
+        :rtype: str or None
+        """
+        return self.properties.get("bodyPreview", None)
+
+    @property
+    def subject(self):
+        """
+        The text of the event's subject line.
+        :rtype: str or None
+        """
+        return self.properties.get("subject", None)
+
+    @property
+    def web_link(self):
+        """
+        The URL to open the event in Outlook on the web.
+
+        Outlook on the web opens the event in the browser if you are signed in to your mailbox. Otherwise, Outlook
+        on the web prompts you to sign in.
+
+        This URL cannot be accessed from within an iFrame.
+
+        :rtype: str or None
+        """
+        return self.properties.get("webLink", None)
+
+    @property
+    def calendar(self):
+        """The calendar that contains the event. Navigation property. Read-only."""
+        from office365.calendar.calendar import Calendar
+        return self.properties.get('calendar',
+                                   Calendar(self.context, ResourcePath("calendar", self.resource_path)))

office365/calendar/reminder.py

@@ -0,0 +1,13 @@
+from office365.runtime.client_value import ClientValue
+
+
+class Reminder(ClientValue):
+    """A reminder for an event in a user calendar."""
+
+    def __init__(self, eventId=None):
+        """
+
+        :param str eventId: The unique ID of the event. Read only.
+        """
+        super().__init__()
+        self.eventId = eventId

office365/directory/user.py

@@ -2,6 +2,7 @@
 from office365.calendar.calendar_collection import CalendarCollection
 from office365.calendar.calendar_group_collection import CalendarGroupCollection
 from office365.calendar.meeting_time_suggestions_result import MeetingTimeSuggestionsResult
+from office365.calendar.reminder import Reminder
 from office365.directory.directoryObject import DirectoryObject
 from office365.directory.directoryObjectCollection import DirectoryObjectCollection
 from office365.directory.objectIdentity import ObjectIdentity
@@ -65,6 +66,28 @@ def _construct_request(request):
         self.context.before_execute(_construct_request)
         return result
 
+    def get_reminder_view(self, start_dt, end_dt):
+        """Get the occurrences, exceptions, and single instances of events in a calendar view defined by a time range,
+                   from the user's default calendar, or from some other calendar of the user's.
+
+        :param datetime.datetime end_dt: The end date and time of the event for which the reminder is set up.
+            The value is represented in ISO 8601 format, for example, "2015-11-08T20:00:00.0000000"..
+        :param datetime.datetime start_dt: The start date and time of the event for which the reminder is set up.
+            The value is represented in ISO 8601 format, for example, "2015-11-08T19:00:00.0000000".
+        """
+        result = ClientValueCollection(Reminder)
+        params = {
+            "startDateTime": start_dt.isoformat(),
+            "endDateTime": end_dt.isoformat(),
+        }
+        qry = ServiceOperationQuery(self, "reminderView", params, None, None, result)
+        self.context.add_query(qry)
+
+        def _construct_request(request):
+            request.method = HttpMethod.Get
+        self.context.before_execute(_construct_request)
+        return result
+
     def delete_object(self, permanent_delete=False):
         """
         :param permanent_delete: Permanently deletes the user from directory

tests/calendar_tests/test_calendar.py

@@ -43,6 +43,13 @@ def test4_list_calendar_view(self):
         events = self.client.me.get_calendar_view(start_dt=start_time, end_dt=end_time).execute_query()
         self.assertIsNotNone(events.resource_path)
 
+    def test4_get_reminder_view(self):
+        end_time = datetime.utcnow()
+        start_time = end_time - timedelta(days=14)
+        reminders = self.client.me.get_reminder_view(start_dt=start_time, end_dt=end_time)
+        self.client.execute_query()
+        self.assertIsNotNone(reminders)
+
     def test5_list_events(self):
         events = self.client.me.calendar.events.get().execute_query()
         self.assertIsNotNone(events.resource_path)

tests/mail/test_event.py renamed to tests/calendar_tests/test_event.py

@@ -38,7 +38,7 @@ def test1_create_event(self):
         self.assertIsNotNone(event.id)
         self.__class__.target_event = event
 
-    def test2_get_events(self):
+    def test2_list_my_events(self):
         events = self.client.me.events.get().execute_query()
         self.assertGreaterEqual(len(events), 1)
 

tests/sharepoint/test_user_profile.py

@@ -76,4 +76,4 @@ def test8_get_followers_for(self):
     def test9_get_my_followers(self):
         people_manager = PeopleManager(self.my_client)
         result = people_manager.get_my_followers().execute_query()
-        self.assertIsInstance(result., PersonPropertiesCollection)
+        self.assertIsInstance(result, PersonPropertiesCollection)