OneDrive model & method updates

Author: vgrem

examples/onedrive/powerpoint/create.py

@@ -0,0 +1,9 @@
+from examples import acquire_token_by_username_password
+from office365.graph_client import GraphClient
+
+
+client = GraphClient(acquire_token_by_username_password)
+
+remote_drive = client.me.drive.root
+pptx_file = remote_drive.create_powerpoint("sample.pptx").execute_query()
+print(f"File {pptx_file.web_url} has been uploaded")

generator/metadata/SharePoint.xml

@@ -26,6 +26,15 @@ def phone_methods(self):
                                    EntityCollection(self.context, PhoneAuthenticationMethod,
                                                     ResourcePath("phoneMethods", self.resource_path)))
 
+    @property
+    def password_methods(self):
+        """Represents the password that's registered to a user for authentication. For security, the password itself
+        will never be returned in the object, but action can be taken to reset a password."""
+        from office365.directory.authentication.methods.password import PasswordAuthenticationMethod
+        return self.properties.get('passwordMethods',
+                                   EntityCollection(self.context, PasswordAuthenticationMethod,
+                                                    ResourcePath("passwordMethods", self.resource_path)))
+
     @property
     def methods(self):
         """Represents all authentication methods registered to a user."""
@@ -37,6 +46,7 @@ def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {
                 "fido2Methods": self.fido2_methods,
+                "passwordMethods": self.password_methods,
                 "phoneMethods": self.phone_methods
             }
             default_value = property_mapping.get(name, None)

office365/directory/authentication/authentication.py

@@ -3,5 +3,3 @@
 
 class Fido2AuthenticationMethod(AuthenticationMethod):
     """Representation of a FIDO2 security key registered to a user. FIDO2 is a sign-in authentication method."""
-
-

office365/directory/authentication/methods/fido.py

@@ -0,0 +1,6 @@
+from office365.directory.authentication.methods.method import AuthenticationMethod
+
+
+class PasswordAuthenticationMethod(AuthenticationMethod):
+    """A representation of a user's password. For security, the password itself will never be returned in the object,
+    but action can be taken to reset a password."""

office365/directory/authentication/methods/password.py

@@ -1,5 +1,31 @@
+from office365.directory.identities.identity_set import IdentitySet
+from office365.onedrive.documentsets.version_item import DocumentSetVersionItem
 from office365.onedrive.versions.list_item import ListItemVersion
+from office365.runtime.client_value_collection import ClientValueCollection
 
 
 class DocumentSetVersion(ListItemVersion):
     """Represents the version of a document set item in a list."""
+
+    @property
+    def comment(self):
+        """Comment about the captured version."""
+        return self.properties.get("comment", None)
+
+    @property
+    def created_by(self):
+        """User who captured the version."""
+        return self.properties.get("createdBy", IdentitySet())
+
+    @property
+    def items(self):
+        """Items within the document set that are captured as part of this version."""
+        return self.properties.get("items", ClientValueCollection(DocumentSetVersionItem))
+
+    @property
+    def should_capture_minor_version(self):
+        """
+        If true, minor versions of items are also captured; otherwise, only major versions will be captured.
+        Default value is false.
+        """
+        return self.properties.get("shouldCaptureMinorVersion", None)

office365/onedrive/documentsets/version.py

@@ -46,6 +46,14 @@ def get_by_path(self, url_path):
         """
         return DriveItem(self.context, UrlPath(url_path, self.resource_path), self.children)
 
+    def create_powerpoint(self, name):
+        """
+        Creates a PowerPoint file
+
+        :param str name:
+        """
+        return self.upload(name, None)
+
     def create_link(self, link_type, scope="", expiration_datetime=None, password=None, message=None):
         """
         The createLink action will create a new sharing link if the specified link type doesn't already exist
@@ -154,7 +162,7 @@ def upload(self, name, content):
         :param name: The contents of the request body should be the binary stream of the file to be uploaded.
         :type name: str
         :param content: The contents of the request body should be the binary stream of the file to be uploaded.
-        :type content: str or bytes
+        :type content: str or bytes or None
         :rtype: DriveItem
         """
         qry = create_upload_content_query(self, name, content)

office365/onedrive/driveitems/driveItem.py

@@ -3,12 +3,14 @@
 
 class PublicationFacet(ClientValue):
 
-    def __init__(self, level=None, versionId=None):
+    def __init__(self, level=None, version_id=None):
         """
+        The publicationFacet resource provides details on the published status of a driveItemVersion
+        or driveItem resource.
 
         :param str level: The state of publication for this document. Either published or checkout. Read-only.
-        :param str versionId: The unique identifier for the version that is visible to the current caller. Read-only.
+        :param str version_id: The unique identifier for the version that is visible to the current caller. Read-only.
         """
         super(PublicationFacet, self).__init__()
         self.level = level
-        self.versionId = versionId
+        self.versionId = version_id

office365/onedrive/driveitems/publication_facet.py

@@ -1,3 +1,4 @@
+from office365.directory.identities.identity_set import IdentitySet
 from office365.runtime.client_value import ClientValue
 
 
@@ -9,3 +10,6 @@ class RemoteItem(ClientValue):
     DriveItems with a non-null remoteItem facet are resources that are shared, added to the user's OneDrive,
     or on items returned from hetrogenous collections of items (like search results).
     """
+
+    def __init__(self, created_by=IdentitySet()):
+        self.createdBy = created_by

office365/onedrive/driveitems/remote_item.py

@@ -0,0 +1,25 @@
+from office365.entity_collection import EntityCollection
+from office365.onedrive.analytics.item_activity_stat import ItemActivityStat
+from office365.runtime.http.http_method import HttpMethod
+from office365.runtime.queries.service_operation import ServiceOperationQuery
+
+
+def build_get_activities_by_interval_query(binding_type, start_dt=None, end_dt=None, interval=None):
+    """
+    :param office365.entity.Entity binding_type: Binding type
+    :param datetime.datetime start_dt: The start time over which to aggregate activities.
+    :param datetime.datetime end_dt: The end time over which to aggregate activities.
+    :param str interval: The aggregation interval.
+    """
+    params = {
+        "startDateTime": start_dt.strftime('%m-%d-%Y') if start_dt else None,
+        "endDateTime": end_dt.strftime('%m-%d-%Y') if end_dt else None,
+        "interval": interval
+    }
+    return_type = EntityCollection(binding_type.context, ItemActivityStat, binding_type.resource_path)
+    qry = ServiceOperationQuery(binding_type, "getActivitiesByInterval", params, None, None, return_type)
+
+    def _construct_request(request):
+        request.method = HttpMethod.Get
+    binding_type.context.before_execute(_construct_request)
+    return qry