OneDrive API: introduced Site and another resources. Refactorings

Author: vgrem

.idea/.gitignore

@@ -1,13 +1,14 @@
 # About
-Office 365 Library for Python
+Office 365 & Microsoft Graph Library for Python
 
-The list of supported Office 365 APIs:
+The list of supported APIs:
 
 -   [SharePoint REST API](https://msdn.microsoft.com/en-us/library/office/jj860569.aspx) (_supported_ versions: [SharePoint 2013](https://msdn.microsoft.com/library/office/jj860569(v=office.15).aspx), SharePoint 2016, SharePoint Online and OneDrive for Business)
 -   [Outlook REST API](https://msdn.microsoft.com/en-us/office/office365/api/use-outlook-rest-api#DefineOutlookRESTAPI) 
     -   [Outlook Contacts REST API](https://msdn.microsoft.com/en-us/office/office365/api/contacts-rest-operations)
     -   [Outlook Calendar REST API](https://msdn.microsoft.com/en-us/office/office365/api/calendar-rest-operations)
     -   [Outlook Mail REST API](https://msdn.microsoft.com/en-us/office/office365/api/mail-rest-operations)
+-   [OneDrive API](https://docs.microsoft.com/en-us/graph/api/resources/onedrive?view=graph-rest-1.0)    
 
 
 ## Status
@@ -24,7 +25,9 @@ pip install Office365-REST-Python-Client
 ```
 
 
-# Usage: working with SharePoint resources 
+# Usage
+ 
+## Working with SharePoint resources 
 
 There are **two approaches** available to perform REST queries:
 
@@ -74,12 +77,13 @@ else:
 
 
 # Python Version
-Python 2.7 is fully supported.
+Python `2.7 & 3.4–3.6` are supported.
 
 
 # Third Party Libraries and Dependencies
 The following libraries will be installed when you install the client library:
 * [requests](https://github.com/kennethreitz/requests)
+* [adal](https://github.com/AzureAD/azure-activedirectory-library-for-python)
 
 
 

README.md

@@ -1,5 +1,6 @@
 import json
 
+from office365.sharepoint.client_context import ClientContext
 from settings import settings
 from office365.runtime.auth.authentication_context import AuthenticationContext
 from office365.runtime.client_request import ClientRequest

examples/sharepoint/listitems_operations_alt.py

@@ -17,6 +17,13 @@ def id(self):
             return self.properties['id']
         return None
 
+    @property
+    def etag(self):
+        """ETag for the item."""
+        if self.is_property_available("eTag"):
+            return self.properties['eTag']
+        return None
+
     @property
     def created_by(self):
         """Identity of the user, device, or application which created the item."""

office365/onedrive/base_item.py

@@ -1,6 +1,12 @@
 from office365.onedrive.base_item import BaseItem
+from office365.runtime.resource_path_entity import ResourcePathEntity
 
 
 class DriveItem(BaseItem):
     """The driveItem resource represents a file, folder, or other item stored in a drive. All file system objects in
     OneDrive and SharePoint are returned as driveItem resources """
+
+    def item_with_path(self, path):
+        """Retrieve DriveItem by path"""
+        return DriveItem(self.context,
+                         ResourcePathEntity(self.context, self.resource_path, ':/{0}'.format(path)))

office365/onedrive/drive_item.py

@@ -1,9 +1,15 @@
 from office365.onedrive.drive_item import DriveItem
 from office365.runtime.client_object_collection import ClientObjectCollection
+from office365.runtime.resource_path_entity import ResourcePathEntity
 
 
 class DriveItemCollection(ClientObjectCollection):
     """Drive items's collection"""
 
     def __init__(self, context, resource_path=None):
         super(DriveItemCollection, self).__init__(context, DriveItem, resource_path)
+
+    def get_by_id(self, _id):
+        """Retrieve DriveItem by unique identifier"""
+        return DriveItem(self.context,
+                         ResourcePathEntity(self.context, self.resource_path, _id))

office365/onedrive/drive_item_collection.py

@@ -0,0 +1,6 @@
+from office365.runtime.client_value_object import ClientValueObject
+
+
+class SharePointIds(ClientValueObject):
+    """The SharePointIds resource groups the various identifiers for an item stored in a SharePoint site or OneDrive
+    for Business into a single structure. """

office365/onedrive/sharepoint_ids.py

@@ -0,0 +1,12 @@
+from office365.onedrive.base_item import BaseItem
+
+
+class Site(BaseItem):
+    """The site resource provides metadata and relationships for a SharePoint site. """
+
+    @property
+    def sharepointids(self):
+        """Returns identifiers useful for SharePoint REST compatibility."""
+        if self.is_property_available("sharepointIds"):
+            return self.properties['sharepointIds']
+        return None

office365/onedrive/site.py

@@ -0,0 +1,22 @@
+from office365.runtime.client_value_object import ClientValueObject
+
+
+class SiteCollection(ClientValueObject):
+    """The siteCollection resource provides more information about a site collection. """
+
+    def __init__(self):
+        super(SiteCollection, self).__init__()
+        self._hostname = None
+        self._root = None
+
+    @property
+    def hostname(self):
+        """The hostname for the site collection."""
+        return self._hostname
+
+    @property
+    def root(self):
+        """If present, indicates that this is a root site collection in SharePoint."""
+        return self._root
+
+

office365/onedrive/site_collection.py

@@ -1,12 +1,12 @@
 class ActionType:
-    """Http method"""
+    """Query type"""
 
     def __init__(self):
         pass
 
-    ReadEntry = 1
-    CreateEntry = 2
-    UpdateEntry = 3
-    DeleteEntry = 4
+    ReadEntity = 1
+    CreateEntity = 2
+    UpdateEntity = 3
+    DeleteEntity = 4
     GetMethod = 5
     PostMethod = 6