Improvements for calendar & sharepoint namespaces (types, methods)

Author: [email protected]

office365/base_item.py

@@ -1,26 +1,16 @@
 from office365.directory.identitySet import IdentitySet
 from office365.entity import Entity
 from office365.onedrive.itemReference import ItemReference
-from office365.runtime.queries.delete_entity_query import DeleteEntityQuery
 
 
 class BaseItem(Entity):
     """The baseItem resource is an abstract resource that contains a common set of properties shared among several
     other resources types """
 
-    def delete_object(self):
-        """Deletes the item."""
-        qry = DeleteEntityQuery(self)
-        self.context.add_query(qry)
-        self.remove_from_parent_collection()
-        return self
-
     @property
     def etag(self):
         """ETag for the item."""
-        if self.is_property_available("eTag"):
-            return self.properties['eTag']
-        return None
+        return self.properties.get('eTag', None)
 
     @property
     def createdBy(self):
@@ -30,23 +20,17 @@ def createdBy(self):
     @property
     def lastModifiedBy(self):
         """Identity of the user, device, and application which last modified the item."""
-        if self.is_property_available("lastModifiedBy"):
-            return self.properties['lastModifiedBy']
-        return IdentitySet()
+        return self.properties.get('lastModifiedBy', IdentitySet())
 
     @property
     def createdDateTime(self):
         """Date and time of item creation."""
-        if self.is_property_available("createdDateTime"):
-            return self.properties['createdDateTime']
-        return None
+        return self.properties.get('createdDateTime', None)
 
     @property
     def lastModifiedDateTime(self):
         """Date and time the item was last modified."""
-        if self.is_property_available("lastModifiedDateTime"):
-            return self.properties['lastModifiedDateTime']
-        return None
+        return self.properties.get('lastModifiedDateTime', None)
 
     @property
     def name(self):
@@ -60,9 +44,7 @@ def name(self, value):
     @property
     def description(self):
         """Provides a user-visible description of the item."""
-        if self.is_property_available("description"):
-            return self.properties['description']
-        return None
+        return self.properties.get('description',None)
 
     @description.setter
     def description(self, value):
@@ -71,9 +53,7 @@ def description(self, value):
     @property
     def web_url(self):
         """URL that displays the resource in the browser."""
-        if self.is_property_available("webUrl"):
-            return self.properties['webUrl']
-        return None
+        return self.properties.get('webUrl', None)
 
     @property
     def parentReference(self):

office365/calendar/attendee.py

@@ -0,0 +1,19 @@
+from office365.calendar.attendeeBase import AttendeeBase
+from office365.calendar.emailAddress import EmailAddress
+
+
+class Attendee(AttendeeBase):
+    """An event attendee. This can be a person or resource such as a meeting room or equipment,
+    that has been set up as a resource on the Exchange server for the tenant."""
+
+    def __init__(self, emailAddress=EmailAddress(), attendee_type=None, proposedNewTime=None, status=None):
+        """
+
+        :param office365.mail.emailAddress.EmailAddress emailAddress emailAddress:
+        :param office365.calendar.timeSlot.TimeSlot proposedNewTime:
+        :param str status: The attendee's response (none, accepted, declined, etc.) for the event and date-time
+            that the response was sent.
+        """
+        super().__init__(emailAddress, attendee_type)
+        self.proposedNewTime = proposedNewTime
+        self.status = status

office365/calendar/attendeeBase.py

@@ -0,0 +1,15 @@
+from office365.mail.recipient import Recipient
+
+
+class AttendeeBase(Recipient):
+    """The type of attendee."""
+
+    def __init__(self, emailAddress, attendee_type=None):
+        """
+
+        :param office365.mail.emailAddress.EmailAddress emailAddress: Includes the name and SMTP address of the attendee
+        :param str attendee_type: The type of attendee. The possible values are: required, optional, resource.
+            Currently if the attendee is a person, findMeetingTimes always considers the person is of the Required type.
+        """
+        super().__init__(emailAddress)
+        self.type = attendee_type

office365/calendar/calendar_permission.py

@@ -2,4 +2,18 @@
 
 
 class CalendarPermission(Entity):
+    """
+    The permissions of a user with whom the calendar has been shared or delegated in an Outlook client.
+
+    Get, update, and delete of calendar permissions is supported on behalf of only the calendar owner.
+
+    Getting the calendar permissions of a calendar on behalf of a sharee or delegate returns
+    an empty calendar permissions collection.
+
+    Once a sharee or delegate has been set up for a calendar, you can update only the role property to change
+    the permissions of a sharee or delegate. You cannot update the allowedRoles, emailAddress, isInsideOrganization,
+    or isRemovable property. To change these properties, you should delete the corresponding calendarPermission
+    object and create another sharee or delegate in an Outlook client.
+
+    """
     pass

office365/calendar/event.py

@@ -1,14 +1,14 @@
+from office365.calendar.attendee import Attendee
+from office365.mail.attachment_collection import AttachmentCollection
 from office365.mail.item import Item
+from office365.mail.location import Location
+from office365.runtime.client_value_collection import ClientValueCollection
 from office365.runtime.resource_path import ResourcePath
 
 
 class Event(Item):
     """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):
         """
@@ -25,6 +25,13 @@ def subject(self):
         """
         return self.properties.get("subject", None)
 
+    @property
+    def location(self):
+        """
+        The location of the event.
+        """
+        return self.properties.get("location", Location())
+
     @property
     def web_link(self):
         """
@@ -45,3 +52,15 @@ def calendar(self):
         from office365.calendar.calendar import Calendar
         return self.properties.get('calendar',
                                    Calendar(self.context, ResourcePath("calendar", self.resource_path)))
+
+    @property
+    def attendees(self):
+        """The collection of attendees for the event."""
+        return self.properties.get('attendees',
+                                   ClientValueCollection(Attendee))
+
+    @property
+    def attachments(self):
+        """The collection of fileAttachment and itemAttachment attachments for the event. """
+        return self.properties.get('attachments',
+                                   AttachmentCollection(self.context, ResourcePath("attachments", self.resource_path)))

office365/calendar/event_collection.py

@@ -1,8 +1,34 @@
+from office365.calendar.attendee import Attendee
+from office365.calendar.dateTimeTimeZone import DateTimeTimeZone
+from office365.calendar.emailAddress import EmailAddress
 from office365.calendar.event import Event
 from office365.entity_collection import EntityCollection
+from office365.mail.itemBody import ItemBody
+from office365.runtime.client_value_collection import ClientValueCollection
 
 
 class EventCollection(EntityCollection):
     """Event's collection"""
     def __init__(self, context, resource_path=None):
         super(EventCollection, self).__init__(context, Event, resource_path)
+
+    def add(self, subject, body, start, end, attendees_emails):
+        """
+        :param list[str] attendees_emails: The collection of attendees emails for the event.
+        :param datetime.datetime end: The date, time, and time zone that the event ends.
+             By default, the end time is in UTC.
+        :param datetime.datetime start: The date, time, and time zone that the event starts.
+            By default, the start time is in UTC.
+        :param str body: The body of the message associated with the event. It can be in HTML format.
+        :param str subject: The text of the event's subject line.
+        :rtype: Event
+        """
+        attendees_list = [Attendee(EmailAddress(email), attendee_type="required") for email in attendees_emails]
+        payload = {
+            "subject": subject,
+            "body": ItemBody(body, "HTML"),
+            "start": DateTimeTimeZone.parse(start),
+            "end": DateTimeTimeZone.parse(end),
+            "attendees": ClientValueCollection(Attendee, attendees_list)
+        }
+        return self.add_from_json(payload)

office365/calendar/timeSlot.py

@@ -0,0 +1,15 @@
+from office365.runtime.client_value import ClientValue
+
+
+class TimeSlot(ClientValue):
+    """Represents a time slot for a meeting."""
+
+    def __init__(self, start, end):
+        """
+
+        :param datetime.datetime start: The date, time, and time zone that a period begins.
+        :param datetime.datetime end: The date, time, and time zone that a period ends.
+        """
+        super().__init__()
+        self.start = start
+        self.end = end

office365/directory/group.py

@@ -73,19 +73,14 @@ def members(self):
     @property
     def owners(self):
         """The owners of the group."""
-        if self.is_property_available('owners'):
-            return self.properties['owners']
-        else:
-            return DirectoryObjectCollection(self.context,
-                                             ResourcePath("owners", self.resource_path))
+        return self.properties.get('owners',
+                                   DirectoryObjectCollection(self.context, ResourcePath("owners", self.resource_path)))
 
     @property
     def drives(self):
         """The group's drives. Read-only."""
-        if self.is_property_available('drives'):
-            return self.properties['drives']
-        else:
-            return DriveCollection(self.context, ResourcePath("drives", self.resource_path))
+        return self.properties.get('drives',
+                                   DriveCollection(self.context, ResourcePath("drives", self.resource_path)))
 
     @property
     def sites(self):

office365/directory/objectIdentity.py

@@ -6,7 +6,7 @@ class ObjectIdentity(ClientValue):
     Represents an identity used to sign in to a user account.
     """
 
-    def __init__(self, signInType, issuer, issuerAssignedId):
+    def __init__(self, signInType=None, issuer=None, issuerAssignedId=None):
         """
 
         :param str signInType: Specifies the user sign-in types in your directory, such as emailAddress, userName