Outlook enhancements: new types & methods

Author: vgrem

examples/outlook/send_message_with_large_attachment.py

@@ -19,21 +19,21 @@ def run_example_1():
         body="The new cafeteria is open.",
         to_recipients=["[email protected]"]
     ).execute_query()
+    print(draft_message.id)
 
     draft_message.upload_attachment(local_path, print_progress).send().execute_query()
-    print(draft_message.id)
 
 
 def run_example_2():
     message = client.me.messages.add(
         subject="Meet for lunch?",
         body="The new cafeteria is open.",
-        to_recipients=["[email protected]"]
+        to_recipients=["[email protected]", "[email protected]"]
     ).upload_attachment(local_path, print_progress).execute_query()
     print(message.id)
 
 
-run_example_1()
-#run_example_2()
+#run_example_1()
+run_example_2()
 
 

examples/teams/send_message.py

@@ -1,7 +1,7 @@
 import sys
 
 from office365.graph_client import GraphClient
-from office365.outlook.mail.itemBody import ItemBody
+from office365.outlook.mail.item_body import ItemBody
 from tests.graph_case import acquire_token_by_username_password
 
 client = GraphClient(acquire_token_by_username_password)

generator/metadata/SharePoint.xml

@@ -1,6 +1,6 @@
 from office365.communications.onlinemeetings.meeting_participants import MeetingParticipants
 from office365.entity import Entity
-from office365.outlook.mail.itemBody import ItemBody
+from office365.outlook.mail.item_body import ItemBody
 
 
 class OnlineMeeting(Entity):

office365/communications/onlinemeetings/online_meeting.py

@@ -2,6 +2,7 @@
 
 from office365.delta_collection import DeltaCollection
 from office365.directory.applications.app_role_assignment import AppRoleAssignmentCollection
+from office365.directory.extensions.extension import Extension
 from office365.directory.licenses.assigned_license import AssignedLicense
 from office365.directory.object import DirectoryObject
 from office365.directory.object_collection import DirectoryObjectCollection
@@ -10,6 +11,7 @@
 from office365.onedrive.drives.drive import Drive
 from office365.onenote.onenote import Onenote
 from office365.outlook.calendar.event import Event
+from office365.outlook.mail.conversation_thread import ConversationThread
 from office365.planner.group import PlannerGroup
 from office365.runtime.client_result import ClientResult
 from office365.runtime.client_value_collection import ClientValueCollection
@@ -121,10 +123,18 @@ def delete_object(self, permanent_delete=False):
         return self
 
     @property
-    def members(self):
-        """Users and groups that are members of this group.
+    def extensions(self):
+        """
+        The collection of open extensions defined for the group
+        """
+        return self.properties.get('extensions',
+                                   EntityCollection(self.context, Extension,
+                                                    ResourcePath("extensions", self.resource_path)))
 
-        :rtype: DirectoryObjectCollection
+    @property
+    def members(self):
+        """
+        Users and groups that are members of this group.
         """
         return self.properties.get('members',
                                    DirectoryObjectCollection(self.context, ResourcePath("members", self.resource_path)))
@@ -150,6 +160,13 @@ def transitive_member_of(self):
                                    DirectoryObjectCollection(self.context,
                                                              ResourcePath("transitiveMemberOf", self.resource_path)))
 
+    @property
+    def threads(self):
+        """The group's conversation threads"""
+        return self.properties.get('threads',
+                                   EntityCollection(self.context, ConversationThread,
+                                                    ResourcePath("threads", self.resource_path)))
+
     @property
     def owners(self):
         """The owners of the group.
@@ -207,6 +224,7 @@ def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {
                 "appRoleAssignments": self.app_role_assignments,
+                "assignedLicenses": self.assigned_licenses,
                 "transitiveMembers": self.transitive_members,
                 "transitiveMemberOf": self.transitive_member_of,
             }

office365/directory/groups/group.py

@@ -0,0 +1,8 @@
+from office365.entity import Entity
+
+
+class OfficeGraphInsights(Entity):
+    """
+    Insights are relationships calculated using advanced analytics and machine learning techniques.
+    You can, for example, identify OneDrive for Business documents trending around users.
+    """

office365/security/__init__.py renamed to office365/directory/insights/__init__.py

@@ -3,6 +3,7 @@
 from office365.delta_collection import DeltaCollection
 from office365.directory.authentication.authentication import Authentication
 from office365.directory.extensions.extension import Extension
+from office365.directory.insights.office_graph import OfficeGraphInsights
 from office365.directory.licenses.assigned_plan import AssignedPlan
 from office365.directory.users.settings import UserSettings
 from office365.onedrive.sites.site import Site
@@ -353,6 +354,12 @@ def followed_sites(self):
                                    EntityCollection(self.context, Site,
                                                     ResourcePath("followedSites", self.resource_path)))
 
+    @property
+    def insights(self):
+        """"""
+        return self.properties.get('insights',
+                                   OfficeGraphInsights(self.context, ResourcePath("insights", self.resource_path)))
+
     @property
     def photo(self):
         """
@@ -364,7 +371,7 @@ def photo(self):
     @property
     def manager(self):
         """
-        The user or contact that is this user's manager. Read-only. (HTTP Methods: GET, PUT, DELETE.)
+        The user or contact that is this user's manager
         """
         return self.properties.get('manager',
                                    DirectoryObject(self.context, ResourcePath("manager", self.resource_path)))
@@ -557,7 +564,8 @@ def get_property(self, name, default_value=None):
                 "assignedLicenses": self.assigned_licenses,
                 "mailFolders": self.mail_folders,
                 "mailboxSettings": self.mailbox_settings,
-                "directReports": self.direct_reports
+                "directReports": self.direct_reports,
+                "onlineMeetings": self.online_meetings
             }
             default_value = property_mapping.get(name, None)
         return super(User, self).get_property(name, default_value)

office365/directory/insights/office_graph.py

@@ -41,7 +41,7 @@
 from office365.runtime.queries.delete_entity import DeleteEntityQuery
 from office365.runtime.queries.update_entity import UpdateEntityQuery
 from office365.search.entity import SearchEntity
-from office365.security.security import Security
+from office365.directory.security.security import Security
 from office365.teams.chats.collection import ChatCollection
 from office365.teams.collection import TeamCollection
 from office365.teams.template import TeamsTemplate

office365/directory/security/__init__.py

@@ -1,7 +1,7 @@
 from office365.entity_collection import EntityCollection
 from office365.onedrive.contenttypes.content_type import ContentType
-from office365.runtime.http.http_method import HttpMethod
 from office365.runtime.queries.create_entity import CreateEntityQuery
+from office365.runtime.queries.function import FunctionQuery
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 
 
@@ -86,14 +86,7 @@ def get_compatible_hub_content_types(self):
         to sites and lists, effectively switching from a "push everywhere" to "pull as needed" approach.
         The method allows users to pull content types directly from the content type hub to a site or list.
         """
-        def _construct_request(request):
-            """
-            :type request: office365.runtime.http.request_options.RequestOptions
-            """
-            request.method = HttpMethod.Get
-
         return_type = ContentTypeCollection(self.context, self.resource_path)
-        qry = ServiceOperationQuery(self, "getCompatibleHubContentTypes", None, None, None, return_type)
+        qry = FunctionQuery(self, "getCompatibleHubContentTypes", None, return_type)
         self.context.add_query(qry)
-        self.context.before_execute(_construct_request)
         return return_type

office365/security/security.py renamed to office365/directory/security/security.py

@@ -8,6 +8,7 @@
 from office365.onedrive.listitems.item_reference import ItemReference
 from office365.runtime.client_result import ClientResult
 from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.queries.function import FunctionQuery
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.runtime.types.collections import StringCollection
 
@@ -20,8 +21,8 @@ def is_published(self):
         """
         Check the publishing status of a contentType in a content type hub site.
         """
-        return_type = ClientResult(self.context)
-        qry = ServiceOperationQuery(self, "isPublished", None, None, None, return_type)
+        return_type = ClientResult(self.context, bool())
+        qry = FunctionQuery(self, "isPublished", None, return_type)
         self.context.add_query(qry)
         return return_type
 

office365/directory/users/user.py

@@ -1,5 +1,5 @@
 from office365.runtime.client_result import ClientResult
-from office365.runtime.http.http_method import HttpMethod
+from office365.runtime.queries.function import FunctionQuery
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 
 
@@ -12,15 +12,7 @@ def create_download_content_query(file_item, format_name=None):
     action_name = "content"
     if format_name is not None:
         action_name = action_name + r"?format={0}".format(format_name)
-    qry = ServiceOperationQuery(file_item, action_name, None, None, None, return_type)
-
-    def _construct_query(request):
-        """
-        :type request: office365.runtime.http.request_options.RequestOptions
-        """
-        request.method = HttpMethod.Get
-    file_item.context.before_execute(_construct_query)
-    return qry
+    return FunctionQuery(file_item, action_name, None, return_type)
 
 
 def create_download_session_content_query(file_item, format_name=None):
@@ -31,5 +23,4 @@ def create_download_session_content_query(file_item, format_name=None):
     action_name = "content"
     if format_name is not None:
         action_name = action_name + r"?format={0}".format(format_name)
-    qry = ServiceOperationQuery(file_item, action_name)
-    return qry
+    return ServiceOperationQuery(file_item, action_name)

office365/graph_client.py

@@ -3,8 +3,7 @@
 from office365.onenote.pages.page_links import PageLinks
 from office365.onenote.sections.section import OnenoteSection
 from office365.runtime.client_result import ClientResult
-from office365.runtime.http.http_method import HttpMethod
-from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.runtime.queries.function import FunctionQuery
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.types.collections import StringCollection
 
@@ -14,18 +13,10 @@ class OnenotePage(OnenoteEntitySchemaObjectModel):
 
     def get_content(self):
         """Download the page's HTML content. """
-        result = ClientResult(self.context)
-        qry = ServiceOperationQuery(self, "content", None, None, None, result)
-
-        def _construct_query(request):
-            """
-            :type request: office365.runtime.http.request_options.RequestOptions
-            """
-            request.method = HttpMethod.Get
-
-        self.context.before_execute(_construct_query)
+        return_type = ClientResult(self.context)
+        qry = FunctionQuery(self, "content", None, return_type)
         self.context.add_query(qry)
-        return result
+        return return_type
 
     @property
     def content_url(self):
@@ -60,20 +51,16 @@ def user_tags(self):
     @property
     def parent_notebook(self):
         """The notebook that contains the page. Read-only.
-
-        :rtype: Notebook
         """
-        return self.get_property('parentNotebook',
-                                 Notebook(self.context, ResourcePath("parentNotebook", self.resource_path)))
+        return self.properties.get('parentNotebook',
+                                   Notebook(self.context, ResourcePath("parentNotebook", self.resource_path)))
 
     @property
     def parent_section(self):
-        """The section that contains the page. Read-only.
-
-        :rtype: OnenoteSection
+        """The section that contains the page.
         """
-        return self.get_property('parentSection',
-                                 OnenoteSection(self.context, ResourcePath("parentSection", self.resource_path)))
+        return self.properties.get('parentSection',
+                                   OnenoteSection(self.context, ResourcePath("parentSection", self.resource_path)))
 
     def get_property(self, name, default_value=None):
         if default_value is None:

office365/onedrive/contenttypes/collection.py

@@ -35,10 +35,10 @@ def get_schedule(self, schedules, start_time=None, end_time=None, availability_v
             "endTime": DateTimeTimeZone.parse(end_time),
             "availabilityViewInterval": availability_view_interval
         }
-        result = ClientResult(self.context, ClientValueCollection(ScheduleInformation))
-        qry = ServiceOperationQuery(self, "getSchedule", None, payload, None, result)
+        return_type = ClientResult(self.context, ClientValueCollection(ScheduleInformation))
+        qry = ServiceOperationQuery(self, "getSchedule", None, payload, None, return_type)
         self.context.add_query(qry)
-        return result
+        return return_type
 
     @property
     def can_edit(self):

office365/onedrive/contenttypes/content_type.py

@@ -6,7 +6,7 @@
 from office365.outlook.calendar.email_address import EmailAddress
 from office365.outlook.item import OutlookItem
 from office365.outlook.mail.attachments.collection import AttachmentCollection
-from office365.outlook.mail.itemBody import ItemBody
+from office365.outlook.mail.item_body import ItemBody
 from office365.outlook.mail.location import Location
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.runtime.queries.service_operation import ServiceOperationQuery

office365/onedrive/internal/queries/download_content.py

@@ -1,7 +1,6 @@
 from office365.entity import Entity
 from office365.runtime.client_result import ClientResult
-from office365.runtime.http.http_method import HttpMethod
-from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.runtime.queries.function import FunctionQuery
 
 
 class Attachment(Entity):
@@ -28,18 +27,10 @@ def get_content(self):
         """
         Gets the raw contents of a file or item attachment
         """
-        result = ClientResult(self.context)
-        qry = ServiceOperationQuery(self, "$value", None, None, None, result)
-
-        def _construct_query(request):
-            """
-            :type request: office365.runtime.http.request_options.RequestOptions
-            """
-            request.method = HttpMethod.Get
-
-        self.context.before_execute(_construct_query)
+        return_type = ClientResult(self.context)
+        qry = FunctionQuery(self, "$value", None, return_type)
         self.context.add_query(qry)
-        return result
+        return return_type
 
     @property
     def name(self):

office365/onenote/pages/page.py

@@ -1,5 +1,13 @@
 from office365.outlook.mail.attachments.attachment import Attachment
+from office365.runtime.paths.resource_path import ResourcePath
 
 
 class ItemAttachment(Attachment):
-    pass
+    """A contact, event, or message that's attached to a user event, message, or post."""
+
+    @property
+    def item(self):
+        """The attached message or event."""
+        from office365.outlook.item import OutlookItem
+        return self.properties.get('item',
+                                   OutlookItem(self.context, ResourcePath("item", self.resource_path)))

office365/outlook/calendar/calendar.py

@@ -0,0 +1,13 @@
+from office365.entity import Entity
+from office365.entity_collection import EntityCollection
+from office365.outlook.mail.post import Post
+from office365.runtime.paths.resource_path import ResourcePath
+
+
+class ConversationThread(Entity):
+    """A conversationThread is a collection of posts."""
+
+    @property
+    def posts(self):
+        return self.properties.get('posts',
+                                   EntityCollection(self.context, Post, ResourcePath("posts", self.resource_path)))

office365/outlook/calendar/event.py

@@ -2,7 +2,7 @@
     MultiValueLegacyExtendedProperty
 from office365.entity import Entity
 from office365.entity_collection import EntityCollection
-from office365.outlook.mail.messages.message import Message
+from office365.outlook.mail.messages.collection import MessageCollection
 from office365.outlook.mail.messages.message_rule import MessageRule
 from office365.runtime.paths.resource_path import ResourcePath
 
@@ -42,8 +42,7 @@ def message_rules(self):
     def messages(self):
         """The collection of messages in the mailFolder."""
         return self.properties.get('messages',
-                                   EntityCollection(self.context, Message,
-                                                    ResourcePath("messages", self.resource_path)))
+                                   MessageCollection(self.context, ResourcePath("messages", self.resource_path)))
 
     @property
     def multi_value_extended_properties(self):