Office365-REST-Python-Client 2.5.5__py3-none-any.whl → 2.5.7__py3-none-any.whl

office365/sharepoint/tenant/insights/report.py

@@ -0,0 +1,11 @@
+from office365.sharepoint.tenant.insights.report_metadata import (
+    SPTenantIBInsightsReportMetadata,
+)
+
+
+class SPTenantIBInsightsReport(SPTenantIBInsightsReportMetadata):
+    """ """
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.Insights.SPTenantIBInsightsReport"

office365/sharepoint/tenant/insights/report_manager.py

@@ -0,0 +1,5 @@
+from office365.sharepoint.entity import Entity
+
+
+class SPTenantIBInsightsReportManager(Entity):
+    """ """

office365/sharepoint/tenant/insights/report_metadata.py

@@ -0,0 +1,5 @@
+from office365.sharepoint.entity import Entity
+
+
+class SPTenantIBInsightsReportMetadata(Entity):
+    """ """

office365/sharepoint/tenant/settings.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.entity import Entity
@@ -27,9 +29,8 @@ class TenantSettings(Entity):
 
     @property
     def corporate_catalog_url(self):
-        """Specifies the URL of the corporate catalog site collection.
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Specifies the URL of the corporate catalog site collection."""
         return self.properties.get("CorporateCatalogUrl", None)
 
     @staticmethod

office365/sharepoint/translation/sync_translator.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.runtime.client_result import ClientResult
 from office365.runtime.paths.service_operation import ServiceOperationPath
 from office365.runtime.queries.service_operation import ServiceOperationQuery
@@ -45,13 +47,12 @@ class SyncTranslator(Entity):
 
     @property
     def output_save_behavior(self):
+        # type: () -> Optional[int]
         """
         The protocol client sets this property to determine the behavior of the protocol server in the case that
         the output file already exists when a translation occurs.
 
         If the protocol client does not set this property, the AppendIfPossible (section 3.1.5.2.1.1) behavior is used.
-
-        :rtype: int or None
         """
         return self.properties.get("OutputSaveBehavior", None)
 

office365/sharepoint/ui/applicationpages/peoplepicker/entity_information.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.runtime.client_object import ClientObject
 from office365.sharepoint.ui.applicationpages.peoplepicker.entity_information_request import (
     PickerEntityInformationRequest,
@@ -9,17 +11,15 @@ class PickerEntityInformation(ClientObject):
 
     @property
     def total_member_count(self):
+        # type: () -> Optional[int]
         """
         The count of members in a group. Valid when the principal is a SharePoint group or a security group.
-        :rtype: int
         """
         return self.properties.get("TotalMemberCount", None)
 
     @property
     def entity(self):
-        """
-        The principal for which information is being requested.
-        """
+        """The principal for which information is being requested."""
         return self.properties.get("Entity", PickerEntityInformationRequest())
 
     @property

office365/sharepoint/usercustomactions/action.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.entity import Entity
 
 
@@ -6,50 +8,40 @@ class UserCustomAction(Entity):
 
     @property
     def client_side_component_id(self):
-        """
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """"""
         return self.properties.get("ClientSideComponentId", None)
 
     @property
     def script_block(self):
-        """
-        Gets the value that specifies the ECMAScript to be executed when the custom action is performed.
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Gets the value that specifies the ECMAScript to be executed when the custom action is performed."""
         return self.properties.get("ScriptBlock", None)
 
     @script_block.setter
     def script_block(self, value):
+        # type: (str) -> None
         """
         Sets the value that specifies the ECMAScript to be executed when the custom action is performed.
-
-        :type value: str
         """
         self.set_property("ScriptBlock", value)
 
     @property
     def script_src(self):
-        """
-        Gets a value that specifies the URI of a file which contains the ECMAScript to execute on the page
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Gets a value that specifies the URI of a file which contains the ECMAScript to execute on the page"""
         return self.properties.get("ScriptSrc", None)
 
     @script_src.setter
     def script_src(self, value):
+        # type: (str) -> None
         """
         Sets a value that specifies the URI of a file which contains the ECMAScript to execute on the page
-
-        :type value: str
         """
         self.set_property("ScriptSrc", value)
 
     @property
     def url(self):
-        """
-        Gets or sets the URL, URI, or ECMAScript (JScript, JavaScript) function associated with the action.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Gets or sets the URL, URI, or ECMAScript (JScript, JavaScript) function associated with the action."""
         return self.properties.get("Url", None)

office365/sharepoint/userprofiles/followed_content.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.runtime.client_result import ClientResult
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.entity import Entity
@@ -25,20 +27,14 @@ class FollowedContent(Entity):
 
     @property
     def followed_documents_url(self):
-        """
-        The FollowedDocumentsUrl property gets the location of the followed documents view.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """The FollowedDocumentsUrl property gets the location of the followed documents view."""
         return self.properties.get("FollowedDocumentsUrl", None)
 
     @property
     def followed_sites_url(self):
-        """
-        The FollowedSitesUrl property gets the location of the followed sites view.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """The FollowedSitesUrl property gets the location of the followed sites view."""
         return self.properties.get("FollowedSitesUrl", None)
 
     @property

office365/sharepoint/userprofiles/people_manager.py

@@ -80,7 +80,6 @@ class PeopleManager(Entity):
         Gets the people who are following the specified user.
 
         :param str account_name: Account name of the specified user.
-        :return:
         """
         return_type = EntityCollection(self.context, PersonProperties)
         params = {"accountName": account_name}

office365/sharepoint/userprofiles/person_properties.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.runtime.types.collections import StringCollection
 from office365.sharepoint.entity import Entity
 
@@ -10,29 +12,20 @@ class PersonProperties(Entity):
 
     @property
     def account_name(self):
-        """
-        The AccountName property specifies the person's account name.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """The AccountName property specifies the person's account name."""
         return self.properties.get("AccountName", None)
 
     @property
     def email(self):
-        """
-        The Email property specifies the person's email address.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """The Email property specifies the person's email address."""
         return self.properties.get("Email", None)
 
     @property
     def latest_post(self):
-        """
-        The  LatestPost property specifies the person's latest microblog post.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """The  LatestPost property specifies the person's latest microblog post."""
         return self.properties.get("LatestPost", None)
 
     @property
@@ -45,11 +38,8 @@ class PersonProperties(Entity):
 
     @property
     def personal_url(self):
-        """
-        The PersonalUrl property specifies the absolute URL of the person's personal page.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """The PersonalUrl property specifies the absolute URL of the person's personal page."""
         return self.properties.get("PersonalUrl", None)
 
     @property
@@ -70,20 +60,14 @@ class PersonProperties(Entity):
 
     @property
     def picture_url(self):
-        """
-        The PictureUrl property specifies the  URL for the person's profile picture.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """The PictureUrl property specifies the  URL for the person's profile picture."""
         return self.properties.get("PictureUrl", None)
 
     @property
     def user_url(self):
-        """
-        The UserUrl property specifies the URL for the person's profile.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """The UserUrl property specifies the URL for the person's profile."""
         return self.properties.get("UserUrl", None)
 
     @property

office365/sharepoint/userprofiles/personal_cache.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.entity import Entity
@@ -21,9 +23,8 @@ class PersonalCache(Entity):
 
     @property
     def cache_name(self):
-        """
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """"""
         return self.properties.get("CacheName", None)
 
     @property

office365/sharepoint/userprofiles/properties_for_user.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.runtime.client_result import ClientResult
 from office365.runtime.paths.service_operation import ServiceOperationPath
 from office365.runtime.queries.service_operation import ServiceOperationQuery
@@ -21,11 +23,8 @@ class UserProfilePropertiesForUser(Entity):
 
     @property
     def account_name(self):
-        """
-        The AccountName property specifies the account name of the user.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """The AccountName property specifies the account name of the user."""
         return self.properties.get("AccountName", None)
 
     @property

office365/sharepoint/userprofiles/sharedwithme/document.py

@@ -1,4 +1,5 @@
 from datetime import datetime
+from typing import Optional
 
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.sharepoint.entity import Entity
@@ -12,41 +13,33 @@ class SharedWithMeDocument(Entity):
 
     @property
     def authors(self):
-        """
-        Specifies a list of users that authored the document.
-        """
+        # type: () -> ClientValueCollection[SharedWithMeDocumentUser]
+        """Specifies a list of users that authored the document."""
         return self.properties.get(
             "Authors", ClientValueCollection(SharedWithMeDocumentUser)
         )
 
     @property
     def caller_stack(self):
-        """
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """ """
         return self.properties.get("CallerStack", None)
 
     @property
     def content_type_id(self):
-        """
-        Specifies the identifier of the content type of the document.
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """Specifies the identifier of the content type of the document."""
         return self.properties.get("ContentTypeId", None)
 
     @property
     def doc_id(self):
-        """
-        Specifies the document identifier.
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """Specifies the document identifier."""
         return self.properties.get("DocId", None)
 
     @property
     def editors(self):
-        """
-        Specifies a list of users that can edit the document.
-        """
+        """Specifies a list of users that can edit the document."""
         return self.properties.get(
             "Editors", ClientValueCollection(SharedWithMeDocumentUser)
         )
@@ -58,10 +51,8 @@ class SharedWithMeDocument(Entity):
 
     @property
     def file_leaf_ref(self):
-        """
-        Specifies the name of the document.
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """Specifies the name of the document."""
         return self.properties.get("FileLeafRef", None)
 
     @property

office365/sharepoint/utilities/move_copy_util.py

@@ -1,5 +1,5 @@
 import os
-from typing import IO, TYPE_CHECKING, Callable
+from typing import IO, TYPE_CHECKING, AnyStr, Callable
 
 from office365.runtime.client_result import ClientResult
 from office365.runtime.queries.service_operation import ServiceOperationQuery
@@ -156,7 +156,8 @@ class MoveCopyUtil(Entity):
         """
         import zipfile
 
-        def _get_file_name(file):
+        def _get_relative_file_path(file):
+            # type: (File) -> str
             return os.path.join(
                 file.parent_folder.serverRelativeUrl.replace(
                     remove_folder.serverRelativeUrl, ""
@@ -164,27 +165,26 @@ class MoveCopyUtil(Entity):
                 file.name,
             )
 
-        def _after_downloaded(result, file):
-            """
-            :type result: ClientResult
-            :type file: office365.sharepoint.files.file.File
-            """
-            filename = _get_file_name(file)
-            if callable(after_file_downloaded):
-                after_file_downloaded(file)
-            with zipfile.ZipFile(download_file.name, "a", zipfile.ZIP_DEFLATED) as zf:
-                zf.writestr(filename, result.value)
+        def _download_file(file):
+            # type: (File) -> None
+
+            def _after_downloaded(result):
+                # type: (ClientResult[AnyStr]) -> None
+                filename = _get_relative_file_path(file)
+                if callable(after_file_downloaded):
+                    after_file_downloaded(file)
+                with zipfile.ZipFile(
+                    download_file.name, "a", zipfile.ZIP_DEFLATED
+                ) as zf:
+                    zf.writestr(filename, result.value)
+
+            file.get_content().after_execute(_after_downloaded)
 
         def _download_folder(folder):
-            """
-            :type folder: office365.sharepoint.folders.folder.Folder
-            """
+            # type: (Folder) -> None
 
             def _download_files(rt):
-                [
-                    file.get_content().after_execute(_after_downloaded, file)
-                    for file in folder.files
-                ]
+                [_download_file(file) for file in folder.files]
                 if recursive:
                     [_download_folder(sub_folder) for sub_folder in folder.folders]
 

office365/sharepoint/utilities/upload_status.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.entity import Entity
 
 
@@ -6,27 +8,22 @@ class UploadStatus(Entity):
 
     @property
     def expected_content_range(self):
+        # type: () -> Optional[str]
         """The string representation of the byte offset of the stream uploaded in chunk upload session that the
         next ContinueUpload (3.2.5.64.2.1.17) call uses to continue chunk upload.
-
-        :rtype: str or None
         """
         return self.properties.get("ExpectedContentRange", None)
 
     @property
     def expiration_date_time(self):
-        """The earliest time at which the chunk upload session will be automatically expired and then deleted.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """The earliest time at which the chunk upload session will be automatically expired and then deleted."""
         return self.properties.get("ExpirationDateTime", None)
 
     @property
     def upload_id(self):
-        """Unique Id of the chunk session upload.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Unique Id of the chunk session upload."""
         return self.properties.get("UploadId", None)
 
     @property

office365/sharepoint/views/field_collection.py

@@ -1,3 +1,5 @@
+from typing import List, Optional
+
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.entity import Entity
 
@@ -12,10 +14,8 @@ class ViewFieldCollection(Entity):
         return len(self.items)
 
     def __getitem__(self, index):
-        """
-        Gets view field by index
-        :param int index: Index
-        """
+        # type: (int) -> str
+        """Gets view field by index"""
         return self.items[index]
 
     def __repr__(self):
@@ -23,17 +23,14 @@ class ViewFieldCollection(Entity):
 
     @property
     def schema_xml(self):
-        """
-        Gets Schema Xml.
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Gets Schema Xml."""
         return self.properties.get("SchemaXml", None)
 
     @property
     def items(self):
-        """Gets items.
-        :rtype: list[str] or None
-        """
+        # type: () -> Optional[List[str]]
+        """Gets items."""
         return self.properties.get("Items", None)
 
     def set_property(self, name, value, persist_changes=False):
@@ -63,9 +60,7 @@ class ViewFieldCollection(Entity):
         return self
 
     def remove_all_view_fields(self):
-        """
-        Removes all the fields from the collection.
-        """
+        """Removes all the fields from the collection."""
         qry = ServiceOperationQuery(self, "RemoveAllViewFields")
         self.context.add_query(qry)
         return self