Office365-REST-Python-Client 2.5.12__py3-none-any.whl → 2.5.13__py3-none-any.whl

office365/sharepoint/authpolicy/events/{auth_event.py → event.py}

@@ -2,6 +2,7 @@ from office365.sharepoint.entity import Entity
 
 
 class SPAuthEvent(Entity):
+
     @property
     def entity_type_name(self):
         return "Microsoft.SharePoint.AuthPolicy.Events.SPAuthEvent"

office365/sharepoint/authpolicy/events/role_assignment_resource_payload.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class RoleAssignmentResourcePayload(ClientValue):
+    """ """

office365/sharepoint/brandcenter/brand_center.py

@@ -0,0 +1,9 @@
+from office365.sharepoint.entity import Entity
+
+
+class BrandCenter(Entity):
+    """
+    The SharePoint brand center API offers a centralized branding management application
+    that empowers your brand managers or designated brand owners to help your organization to customize
+    the look and feel of their experiences.
+    """

office365/sharepoint/brandcenter/configuration.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class BrandCenterConfiguration(ClientValue):
+    """ """

office365/sharepoint/changes/change.py

@@ -16,9 +16,7 @@ class Change(Entity):
 
     @property
     def change_token(self):
-        """
-        Returns an ChangeToken that represents the change.
-        """
+        """Returns an ChangeToken that represents the change."""
         return self.properties.get("ChangeToken", ChangeToken())
 
     @property

office365/sharepoint/changes/collection.py

@@ -22,6 +22,7 @@ class ChangeCollection(EntityCollection[Change]):
         from office365.sharepoint.changes.item import ChangeItem
         from office365.sharepoint.changes.list import ChangeList
         from office365.sharepoint.changes.user import ChangeUser
+        from office365.sharepoint.changes.view import ChangeView
         from office365.sharepoint.changes.web import ChangeWeb
 
         if "ItemId" in properties and "ListId" in properties:
@@ -40,3 +41,5 @@ class ChangeCollection(EntityCollection[Change]):
             self._item_type = ChangeAlert
         elif "FieldId" in properties:
             self._item_type = ChangeField
+        elif "ViewId" in properties:
+            self._item_type = ChangeView

office365/sharepoint/changes/folder.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.changes.change import Change
 
 
@@ -6,8 +8,12 @@ class ChangeFolder(Change):
 
     @property
     def unique_id(self):
+        # type: () -> Optional[str]
+        """Identifies the folder that has changed."""
         return self.properties.get("UniqueId", None)
 
     @property
     def web_id(self):
+        # type: () -> Optional[str]
+        """Identifies the site that contains the changed folder."""
         return self.properties.get("WebId", None)

office365/sharepoint/changes/group.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.changes.change import Change
 
 
@@ -6,5 +8,6 @@ class ChangeGroup(Change):
 
     @property
     def group_id(self):
+        # type: () -> Optional[int]
         """Identifies the changed group."""
         return self.properties.get("GroupId", None)

office365/sharepoint/changes/list.py

@@ -16,9 +16,22 @@ class ChangeList(Change):
 
     @property
     def base_template(self):
+        # type: () -> Optional[int]
         """An SP.ListTemplateType object that returns the list template type of the list."""
         return self.properties.get("BaseTemplate", None)
 
+    @property
+    def editor(self):
+        # type: () -> Optional[str]
+        """A string that returns the name of the user who modified the list."""
+        return self.properties.get("Editor", None)
+
+    @property
+    def hidden(self):
+        # type: () -> Optional[bool]
+        """Returns a Boolean value that indicates whether a list is a hidden list."""
+        return self.properties.get("Hidden", None)
+
     @property
     def list_id(self):
         # type: () -> Optional[str]

office365/sharepoint/changes/view.py

@@ -0,0 +1,25 @@
+from typing import Optional
+
+from office365.sharepoint.changes.change import Change
+
+
+class ChangeView(Change):
+    """Specifies a change on a view."""
+
+    @property
+    def view_id(self):
+        # type: () -> Optional[str]
+        """Identifies the changed view."""
+        return self.properties.get("ViewId", None)
+
+    @property
+    def list_id(self):
+        # type: () -> Optional[str]
+        """Identifies the list that contains the changed view."""
+        return self.properties.get("ListId", None)
+
+    @property
+    def web_id(self):
+        # type: () -> Optional[str]
+        """Identifies the site that contains the changed view."""
+        return self.properties.get("WebId", None)

office365/sharepoint/client_context.py

@@ -42,7 +42,7 @@ class ClientContext(ClientRuntimeContext):
     """SharePoint client context (SharePoint v1 API)"""
 
     def __init__(self, base_url, auth_context=None):
-        # type: (str, AuthenticationContext) -> None
+        # type: (str, AuthenticationContext | None) -> None
         """
         Instantiates a SharePoint client context
 
@@ -411,6 +411,14 @@ class ClientContext(ClientRuntimeContext):
 
         return AnnouncementsController(self, ResourcePath("Announcements"))
 
+    @property
+    def brand_center(self):
+        """Alias to BrandCenter"""
+
+        from office365.sharepoint.brandcenter.brand_center import BrandCenter
+
+        return BrandCenter(self, ResourcePath("BrandCenter"))
+
     @property
     def client_people_picker(self):
         """Query principals service alias"""
@@ -702,6 +710,16 @@ class ClientContext(ClientRuntimeContext):
 
         return WorkflowServicesManager.current(self)
 
+    @property
+    def workflow_deployment_service(self):
+        """Alias to WorkflowServicesManager"""
+
+        from office365.sharepoint.workflowservices.deployment_service import (
+            WorkflowDeploymentService,
+        )
+
+        return WorkflowDeploymentService(self)
+
     @property
     def work_items(self):
         """"""

office365/sharepoint/contenttypes/fieldlinks/collection.py

@@ -1,3 +1,5 @@
+from typing_extensions import Self
+
 from office365.runtime.paths.service_operation import ServiceOperationPath
 from office365.runtime.queries.create_entity import CreateEntityQuery
 from office365.runtime.queries.service_operation import ServiceOperationQuery
@@ -52,6 +54,7 @@ class FieldLinkCollection(EntityCollection[FieldLink]):
         )
 
     def reorder(self, internal_names):
+        # type: (list[str]) -> Self
         """
         Rearranges the collection of field links in the order in which field internal names are specified.
 

office365/sharepoint/copilot/file_collection.py

@@ -0,0 +1,27 @@
+from office365.runtime.client_result import ClientResult
+from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.sharepoint.copilot.file_collection_query_result import (
+    CopilotFileCollectionQueryResult,
+)
+from office365.sharepoint.entity import Entity
+
+
+class CopilotFileCollection(Entity):
+    """ """
+
+    @staticmethod
+    def get_working_set_files(context, top=None, order_by=None, skip_token=None):
+        """ """
+        payload = {"top": top, "orderBy": order_by, "skipToken": skip_token}
+        return_type = ClientResult(context, CopilotFileCollectionQueryResult())
+        qry = ServiceOperationQuery(
+            CopilotFileCollection(context),
+            "GetWorkingSetFiles",
+            None,
+            payload,
+            None,
+            return_type,
+            True,
+        )
+        context.add_query(qry)
+        return return_type

office365/sharepoint/copilot/file_collection_query_result.py

@@ -0,0 +1,10 @@
+from office365.runtime.client_value import ClientValue
+
+
+class CopilotFileCollectionQueryResult(ClientValue):
+    """ """
+
+    @property
+    def entity_type_name(self):
+        # type: () -> str
+        return "Microsoft.SharePoint.Copilot.CopilotFileCollectionQueryResult"

office365/sharepoint/copilot/list_item_extensions.py

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

office365/sharepoint/directory/provider/alternate_id_data.py

@@ -4,6 +4,11 @@ from office365.runtime.client_value import ClientValue
 class AlternateIdData(ClientValue):
     """"""
 
+    def __init__(self, email=None, identifying_property=None, user_principal_name=None):
+        self.Email = email
+        self.IdentifyingProperty = identifying_property
+        self.UserPrincipalName = user_principal_name
+
     @property
     def entity_type_name(self):
         return "SP.Directory.Provider.AlternateIdData"

office365/sharepoint/directory/provider/notification.py

@@ -1,4 +1,5 @@
 from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.entity import Entity
 
 
@@ -10,6 +11,13 @@ class DirectoryNotification(Entity):
             resource_path = ResourcePath("SP.Directory.Provider.DirectoryNotification")
         super(DirectoryNotification, self).__init__(context, resource_path)
 
+    def notify_changes(self, directory_object_changes):
+        """ """
+        payload = {"directoryObjectChanges": directory_object_changes}
+        qry = ServiceOperationQuery(self, "NotifyChanges", None, payload, None, None)
+        self.context.add_query(qry)
+        return self
+
     @property
     def entity_type_name(self):
         return "SP.Directory.Provider.DirectoryNotification"

office365/sharepoint/directory/provider/object_changes.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class DirectoryObjectChanges(ClientValue):
+    """ """

office365/sharepoint/directory/provider/object_data.py

@@ -1,13 +1,36 @@
 from office365.runtime.client_value import ClientValue
 from office365.sharepoint.directory.provider.alternate_id_data import AlternateIdData
+from office365.sharepoint.directory.provider.session_data import DirectorySessionData
 
 
 class DirectoryObjectData(ClientValue):
     """"""
 
-    def __init__(self, AlternateId=AlternateIdData(), Id=None):
-        self.AlternateId = AlternateId
-        self.Id = Id
+    def __init__(
+        self,
+        alternate_id=AlternateIdData(),
+        attribute_expiration_times=None,
+        change_marker=None,
+        directory_object_sub_type=None,
+        directory_object_type=None,
+        directory_session_data=DirectorySessionData(),
+        id_=None,
+        is_new=None,
+        last_modified_time=None,
+        tenant_context_id=None,
+        version=None,
+    ):
+        self.AlternateId = alternate_id
+        self.AttributeExpirationTimes = attribute_expiration_times
+        self.ChangeMarker = change_marker
+        self.DirectoryObjectSubType = directory_object_sub_type
+        self.DirectoryObjectType = directory_object_type
+        self.DirectorySessionData = directory_session_data
+        self.Id = id_
+        self.IsNew = is_new
+        self.LastModifiedTime = last_modified_time
+        self.TenantContextId = tenant_context_id
+        self.Version = version
 
     @property
     def entity_type_name(self):

office365/sharepoint/directory/provider/provider.py

@@ -14,6 +14,7 @@ class SharePointDirectoryProvider(Entity):
         super(SharePointDirectoryProvider, self).__init__(context, resource_path)
 
     def read_directory_object(self, data):
+        # type: (DirectoryObjectData) -> ClientResult[DirectoryObjectData]
         """"""
         return_type = ClientResult(self.context, DirectoryObjectData())
         payload = {"data": data}

office365/sharepoint/directory/provider/session_data.py

@@ -0,0 +1,9 @@
+from office365.runtime.client_value import ClientValue
+
+
+class DirectorySessionData(ClientValue):
+
+    @property
+    def entity_type_name(self):
+        # type: () -> str
+        return "SP.Directory.Provider.DirectorySessionData"

office365/sharepoint/lists/list.py

@@ -1,6 +1,9 @@
+import json
 import os
 from datetime import datetime
-from typing import TYPE_CHECKING, AnyStr, Dict, Optional
+from typing import IO, TYPE_CHECKING, AnyStr, Callable, Dict, Optional
+
+from typing_extensions import Self
 
 from office365.runtime.client_result import ClientResult
 from office365.runtime.client_value_collection import ClientValueCollection
@@ -24,6 +27,7 @@ from office365.sharepoint.files.checked_out_file_collection import (
     CheckedOutFileCollection,
 )
 from office365.sharepoint.files.file import File
+from office365.sharepoint.files.system_object_type import FileSystemObjectType
 from office365.sharepoint.flows.synchronization_result import FlowSynchronizationResult
 from office365.sharepoint.folders.folder import Folder
 from office365.sharepoint.forms.collection import FormCollection
@@ -77,6 +81,64 @@ class List(SecurableObject):
     def __repr__(self):
         return self.id or self.title or self.entity_type_name
 
+    def export(self, local_file, include_content=False, item_exported=None):
+        # type: (IO, bool, Callable[[ListItem|File|Folder], None]) -> Self
+        """Exports SharePoint List"""
+        import zipfile
+
+        def _append_file(name, data):
+            with zipfile.ZipFile(local_file.name, "a", zipfile.ZIP_DEFLATED) as zf:
+                zf.writestr(name, data)
+
+        def _download_content(list_item):
+            # type: (ListItem) -> None
+            def _after_downloaded(result):
+                # type: (ClientResult[AnyStr]) -> None
+                item_path = list_item.properties["FileRef"].replace(
+                    self.root_folder.serverRelativeUrl, ""
+                )
+                _append_file(item_path, result.value)
+
+            list_item.file.get_content().after_execute(_after_downloaded)
+
+        def _export_items(items):
+            # type: (ListItemCollection) -> None
+
+            for item in items:
+                # item_path = item.properties["FileRef"].replace(self.root_folder.serverRelativeUrl, "")
+                item_path = str(item.id) + ".json"
+
+                if item.file_system_object_type == FileSystemObjectType.Folder:
+                    pass
+                else:
+                    _append_file(item_path, json.dumps(item.to_json()))
+
+                    if include_content:
+                        _download_content(item)
+
+                    if callable(item_exported):
+                        item_exported(item)
+
+        def _save_schema():
+            (
+                self.items.select(
+                    [
+                        "*",
+                        "Id",
+                        "FileRef",
+                        "FileDirRef",
+                        "FileLeafRef",
+                        "FileSystemObjectType",
+                    ]
+                )
+                # .expand(["File", "Folder"])
+                .get().paged(page_loaded=_export_items)
+            )
+
+        self.ensure_properties(["SchemaXml", "RootFolder"], _save_schema)
+
+        return self
+
     def clear(self):
         """Clears the list."""
 
@@ -125,6 +187,7 @@ class List(SecurableObject):
         return self
 
     def get_async_action_config(self):
+        """ """
         return_type = ClientResult(self.context)
         qry = ServiceOperationQuery(
             self, "GetAsyncActionConfig", return_type=return_type

office365/sharepoint/logger/log_export.py

@@ -14,12 +14,14 @@ class LogExport(Entity):
         )
 
     def get_files(self):
+        """ """
         return_type = LogFileInfoCollection(self.context)
         qry = ServiceOperationQuery(self, "GetFiles", None, None, None, return_type)
         self.context.add_query(qry)
         return return_type
 
     def get_log_types(self):
+        """ """
         return_type = ClientResult(self.context)
         qry = ServiceOperationQuery(self, "GetLogTypes", None, None, None, return_type)
         self.context.add_query(qry)

office365/sharepoint/migrationcenter/service/performance/data.py

@@ -31,14 +31,14 @@ class PerformanceDataCollection(EntityCollection[PerformanceData]):
             context, PerformanceData, resource_path
         )
 
-    def get_data(self, StartTime=None, EndTime=None, AgentId=None, TimeUnit=None):
+    def get_data(self, start_time=None, end_time=None, agent_id=None, time_unit=None):
         """ """
         return_type = ClientResult(self.context, PerformanceDashboardData())
         payload = {
-            "StartTime": StartTime,
-            "EndTime": EndTime,
-            "AgentId": AgentId,
-            "TimeUnit": TimeUnit,
+            "StartTime": start_time,
+            "EndTime": end_time,
+            "AgentId": agent_id,
+            "TimeUnit": time_unit,
         }
         qry = ServiceOperationQuery(self, "GetData", None, payload, None, return_type)
         self.context.add_query(qry)

office365/sharepoint/multigeo/services.py

@@ -1,7 +1,11 @@
 from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.entity import Entity
 from office365.sharepoint.entity_collection import EntityCollection
 from office365.sharepoint.multigeo.unified_group import UnifiedGroup
+from office365.sharepoint.multigeo.user_personal_site_location import (
+    UserPersonalSiteLocation,
+)
 
 
 class MultiGeoServices(Entity):
@@ -15,6 +19,26 @@ class MultiGeoServices(Entity):
     data residency requirements.
     """
 
+    def __init__(self, context):
+        static_path = ResourcePath(
+            "Microsoft.Online.SharePoint.MultiGeo.Service.MultiGeoServicesBeta"
+        )
+        super(MultiGeoServices, self).__init__(context, static_path)
+
+    def user_personal_site_location(self, user_principal_name):
+        # type: (str) -> UserPersonalSiteLocation
+        return_type = UserPersonalSiteLocation(self.context)
+        qry = ServiceOperationQuery(
+            self,
+            "UserPersonalSiteLocation",
+            [user_principal_name],
+            None,
+            None,
+            return_type,
+        )
+        self.context.add_query(qry)
+        return return_type
+
     @property
     def unified_groups(self):
         # type: () -> EntityCollection[UnifiedGroup]

office365/sharepoint/navigation/menu_node.py

@@ -1,15 +1,57 @@
 from office365.runtime.client_value import ClientValue
+from office365.runtime.client_value_collection import ClientValueCollection
+from office365.sharepoint.translation.resource_entry import SPResourceEntry
 
 
 class MenuNode(ClientValue):
     """Represents a navigation node in the navigation hierarchy. A navigation hierarchy is a tree structure of
     navigation nodes."""
 
-    def __init__(self, current_lcid=None, title=None):
+    def __init__(
+        self,
+        audience_ids=None,
+        current_lcid=None,
+        title=None,
+        is_deleted=None,
+        is_hidden=None,
+        key=None,
+        nodes=None,
+        node_type=None,
+        open_in_new_window=None,
+        simple_url=None,
+        translations=None,
+    ):
         """
+        :param list[str] audience_ids:
         :param int current_lcid:
         :param str title: Specifies the title of the navigation node. The value is in the preferred language of the
             user, if available, or is in the default language of the site (2) as a fallback.
+        :param int node_type: Specifies the type of the navigation node.
+        :param bool is_deleted: A client MUST use this property set to TRUE to indicate that this node MUST be
+             deleted by the server. When set to TRUE the server MUST delete the node including all the child nodes
+             when present. When set to FALSE the server SHOULD NOT delete this node.
+        :param bool is_hidden: Specifies whether the node will be hidden in the navigation menu. During editing,
+             all nodes temporarily become visible so that they can be edited.
+        :param str key: Specifies the identifier for the navigation node in the menu tree. If the navigation node does
+             not exist on the protocol server, this value MUST be an empty string.
+        :param list[MenuNode] nodes:
+        :param bool open_in_new_window:
+        :param str simple_url: If the NodeType (section 3.2.5.244.1.1.7) property is set to "SimpleLink",
+            this property represents the URL of the navigation node. The URL can be relative or absolute.
+            If the value is a relative URL, it can begin with URL tokens "~site" and "~sitecollection".
+            These tokens indicate that the URL is either relative to the site (2) or to the site collection
+            respectively. If the NodeType (section 3.2.5.244.1.1.7) property is not set to "SimpleLink",
+            the value MUST be an empty string.
+         :param list[SPResourceEntry] translations:
         """
+        self.AudienceIds = audience_ids
         self.CurrentLCID = current_lcid
+        self.IsDeleted = is_deleted
+        self.IsHidden = is_hidden
+        self.Key = key
+        self.Nodes = ClientValueCollection(MenuNode, nodes)
+        self.NodeType = node_type
+        self.OpenInNewWindow = open_in_new_window
+        self.SimpleUrl = simple_url
         self.Title = title
+        self.Translations = ClientValueCollection(SPResourceEntry, translations)

office365/sharepoint/navigation/node_collection.py

@@ -39,7 +39,7 @@ class NavigationNodeCollection(EntityCollection[NavigationNode]):
         :param int previous_node_id: Identifier of the navigation node after which the node identified by nodeId moves to
         """
         params = {"nodeId": node_id, "previousNodeId": previous_node_id}
-        qry = ServiceOperationQuery(self, "GetByIndex", params)
+        qry = ServiceOperationQuery(self, "MoveAfter", params)
         self.context.add_query(qry)
         return self
 

office365/sharepoint/oauth/token.py

@@ -0,0 +1,22 @@
+from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.sharepoint.entity import Entity
+from office365.sharepoint.oauth.token_response import TokenResponse
+
+
+class Token(Entity):
+    """"""
+
+    def __init__(self, context):
+        super(Token, self).__init__(context, ResourcePath("SP.OAuth.Token"))
+
+    def acquire(self):
+        """ """
+        return_type = TokenResponse(self.context)
+        qry = ServiceOperationQuery(self, "Acquire", return_type=return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @property
+    def entity_type_name(self):
+        return "SP.OAuth.Token"

office365/sharepoint/oauth/token_response.py

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

office365/sharepoint/publishing/pages/campaign_publication.py

@@ -1,5 +1,6 @@
 from typing import Optional
 
+from office365.runtime.client_result import ClientResult
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.publishing.highlights_info import HighlightsInfo
 from office365.sharepoint.publishing.pages.page import SitePage
@@ -15,6 +16,15 @@ class CampaignPublication(SitePage):
         self.context.add_query(qry)
         return return_type
 
+    def send_test_email(self):
+        """ """
+        return_type = ClientResult(self.context)
+        qry = ServiceOperationQuery(
+            self, "SendTestEmail", None, None, None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
     @property
     def email_endpoint(self):
         # type: () -> Optional[str]

office365/sharepoint/securestore/target_application.py

@@ -1,4 +1,5 @@
 from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.sharepoint.client_context import ClientContext
 from office365.sharepoint.entity import Entity
 
 
@@ -10,6 +11,7 @@ class TargetApplication(Entity):
 
     @staticmethod
     def create(context, application_id, friendly_name):
+        # type: (ClientContext, str, str) -> "TargetApplication"
         """
         Creates a target application
 

office365/sharepoint/sharing/inherited_from.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class InheritedFrom(ClientValue):
+    """ """