Refactorings & improvements (fluent interface for ClientResult) Release 2.3.3

Author: [email protected]

README.md

@@ -189,7 +189,7 @@ Usage
 import adal
 from office365.graph_client import GraphClient
 
-def acquire_token():
+def acquire_token_func():
     authority_url = 'https://login.microsoftonline.com/{tenant_id_or_name}'
     auth_ctx = adal.AuthenticationContext(authority_url)
     token = auth_ctx.acquire_token_with_client_credentials(
@@ -211,7 +211,7 @@ The example demonstrates how to send an email via [Microsoft Graph endpoint](htt
 ```python
 from office365.graph_client import GraphClient
 
-client = GraphClient(acquire_token)
+client = GraphClient(acquire_token_func)
 
 message_json = {
     "Message": {
@@ -232,8 +232,7 @@ message_json = {
 }
 
 login_name = "[email protected]"
-client.users[login_name].send_mail(message_json)
-client.execute_query()
+client.users[login_name].send_mail(message_json).execute_query()
 ```
 
 
@@ -251,7 +250,7 @@ is used to obtain token
 ```python
 import msal
 
-def acquire_token():
+def acquire_token_func():
     """
     Acquire token via MSAL
     """
@@ -279,10 +278,8 @@ which corresponds to [`list available drives` endpoint](https://docs.microsoft.c
 from office365.graph_client import GraphClient
 
 tenant_name = "contoso.onmicrosoft.com"
-client = GraphClient(acquire_token)
-drives = client.drives
-client.load(drives)
-client.execute_query()
+client = GraphClient(acquire_token_func)
+drives = client.drives.get().execute_query()
 for drive in drives:
     print("Drive url: {0}".format(drive.web_url))
 ```
@@ -292,12 +289,9 @@ for drive in drives:
 
 ```python
 from office365.graph_client import GraphClient
-client = GraphClient(acquire_token)
+client = GraphClient(acquire_token_func)
 # retrieve drive properties 
-drive = client.users["{user_id_or_principal_name}"].drive
-client.load(drive)
-client.execute_query()
-
+drive = client.users["{user_id_or_principal_name}"].drive.get().execute_query()
 # download files from OneDrive into local folder 
 with tempfile.TemporaryDirectory() as path:
     download_files(drive.root, path)
@@ -307,15 +301,12 @@ where
 
 ```python
 def download_files(remote_folder, local_path):
-    drive_items = remote_folder.children
-    client.load(drive_items)
-    client.execute_query()
+    drive_items = remote_folder.children.get().execute_query()
     for drive_item in drive_items:
         if not drive_item.file.is_server_object_null:  # is file?
             # download file content
             with open(os.path.join(local_path, drive_item.name), 'wb') as local_file:
-                drive_item.download(local_file)
-                client.execute_query()
+                drive_item.download(local_file).execute_query()
 ```
 
 
@@ -339,9 +330,8 @@ which corresponds to [`Create team` endpoint](https://docs.microsoft.com/en-us/g
 ```python
 from office365.graph_client import GraphClient
 tenant_name = "contoso.onmicrosoft.com"
-client = GraphClient(tenant_name, acquire_token)
-new_team = client.groups["{group_id}"].add_team()
-client.execute_query()
+client = GraphClient(tenant_name, acquire_token_func)
+new_team = client.groups["{group_id}"].add_team().execute_query_retry()
 ```
 
 

examples/onedrive/export_files.py

@@ -1,37 +1,22 @@
+# --------------------------------------------------------------------------
+# Example demonstrates how to export OneDrive files into local file system
+# --------------------------------------------------------------------------
+
 import os
 import tempfile
 
 from examples import acquire_token_client_credentials
 from office365.graph_client import GraphClient
+from tests import test_user_principal_name
 
 
-def download_files(remote_folder, local_path):
-    """
-
-    :type remote_folder: office365.onedrive.driveItem.DriveItem
-    :type local_path: str
-    """
-    drive_items = remote_folder.children.get().execute_query()
-    for drive_item in drive_items:
-        if not drive_item.file.is_server_object_null:  # is file?
-            # download file content
-            with open(os.path.join(local_path, drive_item.name), 'wb') as local_file:
-                drive_item.download(local_file)
-                client.execute_query()
-            print("File '{0}' has been downloaded".format(local_file.name))
-
-
-# --------------------------------------------------------------------------
-# Example demonstrates how to export OneDrive files into local file system
-# --------------------------------------------------------------------------
-
-# connect
 client = GraphClient(acquire_token_client_credentials)
+drive = client.users[test_user_principal_name].drive  # get user's drive
+with tempfile.TemporaryDirectory() as local_path:
+    drive_items = drive.root.children.get().execute_query()
+    file_items = [item for item in drive_items if not item.file.is_server_object_null]    # files only
+    for drive_item in file_items:
+        with open(os.path.join(local_path, drive_item.name), 'wb') as local_file:
+            drive_item.download(local_file).execute_query()  # download file content
+        print("File '{0}' has been downloaded".format(local_file.name))
 
-# load drive properties
-target_user_name = settings.get('first_account_name')
-drive = client.users[target_user_name].drive
-# download files from OneDrive
-with tempfile.TemporaryDirectory() as path:
-    download_files(drive.root, path)
-    print("Done")

examples/outlook/send_message.py

@@ -20,6 +20,5 @@
     },
     "SaveToSentItems": "false"
 }
-
-client.users[test_user_principal_name].send_mail(message_json)
-client.execute_query()
+target_user = client.users[test_user_principal_name]
+target_user.send_mail(message_json).execute_query()

examples/sharepoint/lists_and_items/delete_lists.py

@@ -0,0 +1,19 @@
+from xml.etree import ElementTree
+from office365.sharepoint.client_context import ClientContext
+from office365.sharepoint.lists.list import List
+from tests import test_client_credentials, test_team_site_url
+
+ctx = ClientContext(test_team_site_url).with_credentials(test_client_credentials)
+
+
+def is_custom_list(list_object):
+    xml = ElementTree.fromstring(list_object.properties["SchemaXml"])
+    scope_id = xml.attrib['ScopeId']
+    return True
+
+
+lists = ctx.web.lists.select(["Title", "SchemaXml"]).top(10).get().execute_query()
+lists_to_delete = [l for l in lists if is_custom_list(l)]
+for list_obj in lists_to_delete:  # type: List
+    print(f"Deleting list .. {list_obj.title}")
+    # list_obj.delete_object().execute_query()

examples/sharepoint/search/search_documents.py

@@ -1,15 +1,15 @@
+import json
+
 from office365.sharepoint.client_context import ClientContext
 from office365.sharepoint.search.searchRequest import SearchRequest
 from office365.sharepoint.search.searchService import SearchService
 from tests import test_site_url, test_user_credentials
 
 ctx = ClientContext(test_site_url).with_credentials(test_user_credentials)
-
 search = SearchService(ctx)
 request = SearchRequest("IsDocument:1")
-result = search.post_query(request)
-ctx.execute_query()
-relevant_results = result.PrimaryQueryResult.RelevantResults
+result = search.post_query(request).execute_query()
+relevant_results = result.value.PrimaryQueryResult.RelevantResults
 for i in relevant_results['Table']['Rows']:
     cells = relevant_results['Table']['Rows'][i]['Cells']
-    print(cells[6]['Value'])
+    print(json.dumps(cells, sort_keys=True, indent=4))

office365/calendar/calendar.py

@@ -3,6 +3,7 @@
 from office365.calendar.event_collection import EventCollection
 from office365.calendar.schedule_information import ScheduleInformation
 from office365.entity import Entity
+from office365.runtime.client_result import ClientResult
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.runtime.queries.service_operation_query import ServiceOperationQuery
 from office365.runtime.resource_path import ResourcePath
@@ -32,7 +33,7 @@ def get_schedule(self, schedules, startTime=None, endTime=None, availabilityView
             "endTime": DateTimeTimeZone.parse(endTime),
             "availabilityViewInterval": availabilityViewInterval
         }
-        result = ClientValueCollection(ScheduleInformation)
+        result = ClientResult(self.context, ClientValueCollection(ScheduleInformation))
         qry = ServiceOperationQuery(self, "getSchedule", None, payload, None, result)
         self.context.add_query(qry)
         return result

office365/directory/application.py

@@ -1,6 +1,7 @@
 from office365.directory.directoryObject import DirectoryObject
 from office365.directory.keyCredential import KeyCredential
 from office365.directory.passwordCredential import PasswordCredential
+from office365.runtime.client_result import ClientResult
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.runtime.queries.service_operation_query import ServiceOperationQuery
 
@@ -18,10 +19,11 @@ def add_password(self, display_name):
         """Adds a strong password to an application.
         :param str display_name: App display name
         """
-        return_type = PasswordCredential(displayName=display_name)
-        qry = ServiceOperationQuery(self, "addPassword", None, return_type, None, return_type)
+        params = PasswordCredential(displayName=display_name)
+        result = ClientResult(self.context, params)
+        qry = ServiceOperationQuery(self, "addPassword", None, params, None, result)
         self.context.add_query(qry)
-        return return_type
+        return result
 
     def remove_password(self, keyId):
         """Remove a password from an application."""

office365/directory/user.py

@@ -14,6 +14,7 @@
 from office365.calendar.event_collection import EventCollection
 from office365.mail.message_collection import MessageCollection
 from office365.onedrive.siteCollection import SiteCollection
+from office365.runtime.client_result import ClientResult
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.runtime.http.http_method import HttpMethod
 from office365.runtime.queries.service_operation_query import ServiceOperationQuery
@@ -85,7 +86,7 @@ def find_meeting_times(self):
         that the suggested results may differ over time.
 
         """
-        result = MeetingTimeSuggestionsResult()
+        result = ClientResult(self.context, MeetingTimeSuggestionsResult())
         qry = ServiceOperationQuery(self, "findMeetingTimes", None, None, None, result)
         self.context.add_query(qry)
         return result
@@ -120,7 +121,7 @@ def get_reminder_view(self, start_dt, end_dt):
         :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)
+        result = ClientResult(self.context, ClientValueCollection(Reminder))
         params = {
             "startDateTime": start_dt.isoformat(),
             "endDateTime": end_dt.isoformat(),

office365/entity.py

@@ -41,5 +41,5 @@ def id(self):
     def set_property(self, name, value, persist_changes=True):
         super(Entity, self).set_property(name, value, persist_changes)
         if name == "id" and self._resource_path is None:
-            self._resource_path = ResourcePath(value,self._parent_collection.resource_path)
+            self._resource_path = ResourcePath(value, self._parent_collection.resource_path)
         return self

office365/graph_client.py

@@ -123,7 +123,7 @@ def shares(self):
         return SharedDriveItemCollection(self, ResourcePath("shares"))
 
     @property
-    def directoryObjects(self):
+    def directory_objects(self):
         """Get Directory Objects"""
         return DirectoryObjectCollection(self, ResourcePath("directoryObjects"))