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

office365/sharepoint/lists/exporter.py

@@ -0,0 +1,73 @@
+import json
+from typing import IO, AnyStr, Callable
+
+from typing_extensions import Self
+
+from office365.runtime.client_result import ClientResult
+from office365.sharepoint.files.system_object_type import FileSystemObjectType
+from office365.sharepoint.listitems.collection import ListItemCollection
+from office365.sharepoint.listitems.listitem import ListItem
+from office365.sharepoint.lists.list import List
+
+
+class ListExporter(object):
+
+    @staticmethod
+    def export(
+        source_list, destination_file, include_content=False, item_exported=None
+    ):
+        # type: (List, IO, bool, Callable[[ListItem], None]) -> Self
+        """Exports SharePoint List"""
+        import zipfile
+
+        def _append_file(name, data):
+            with zipfile.ZipFile(
+                destination_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(
+                    source_list.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 = str(item.id) + ".json"
+
+                if item.file_system_object_type == FileSystemObjectType.File:
+                    _append_file(item_path, json.dumps(item.to_json()))
+
+                    if include_content:
+                        _download_content(item)
+
+                    if callable(item_exported):
+                        item_exported(item)
+
+        def _get_items():
+            (
+                source_list.items.select(
+                    [
+                        "*",
+                        "Id",
+                        "FileRef",
+                        "FileDirRef",
+                        "FileLeafRef",
+                        "FileSystemObjectType",
+                    ]
+                )
+                .get()
+                .paged(page_loaded=_export_items)
+            )
+
+        source_list.ensure_properties(["SchemaXml", "RootFolder"], _get_items)
+
+        return source_list

office365/sharepoint/lists/list.py

@@ -1,4 +1,3 @@
-import json
 import os
 from datetime import datetime
 from typing import IO, TYPE_CHECKING, AnyStr, Callable, Dict, Optional
@@ -22,12 +21,12 @@ from office365.sharepoint.eventreceivers.definition_collection import (
     EventReceiverDefinitionCollection,
 )
 from office365.sharepoint.fields.collection import FieldCollection
+from office365.sharepoint.fields.field import Field
 from office365.sharepoint.fields.related_field_collection import RelatedFieldCollection
 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
@@ -44,7 +43,9 @@ from office365.sharepoint.listitems.listitem import ListItem
 from office365.sharepoint.lists.bloom_filter import ListBloomFilter
 from office365.sharepoint.lists.creatables_info import CreatablesInfo
 from office365.sharepoint.lists.data_source import ListDataSource
+from office365.sharepoint.lists.render_data_parameters import RenderListDataParameters
 from office365.sharepoint.lists.rule import SPListRule
+from office365.sharepoint.lists.version_policy_manager import VersionPolicyManager
 from office365.sharepoint.navigation.configured_metadata_items import (
     ConfiguredMetadataNavigationItemCollection,
 )
@@ -84,60 +85,24 @@ class List(SecurableObject):
     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)
-            )
+        from office365.sharepoint.lists.exporter import ListExporter
 
-        self.ensure_properties(["SchemaXml", "RootFolder"], _save_schema)
+        return ListExporter.export(self, local_file, include_content, item_exported)
 
-        return self
+    def can_customize_forms(self):
+        """"""
+        from office365.sharepoint.flows.connector_result import ConnectorResult
+        from office365.sharepoint.forms.customization import FormsCustomization
+
+        return_type = ConnectorResult(self.context)
+
+        def _can_customize_forms():
+            FormsCustomization.can_customize_forms(
+                self.context, self.title, return_type
+            )
+
+        self.ensure_property("Title", _can_customize_forms)
+        return return_type
 
     def clear(self):
         """Clears the list."""
@@ -227,6 +192,21 @@ class List(SecurableObject):
         self.root_folder.ensure_property("ServerRelativeUrl", _loaded)
         return return_type
 
+    def get_flow_permission_level(self):
+        """"""
+        from office365.sharepoint.flows.connector_result import ConnectorResult
+        from office365.sharepoint.flows.permissions import FlowPermissions
+
+        return_type = ConnectorResult(self.context)
+
+        def _loaded():
+            FlowPermissions.get_flow_permission_level_on_list(
+                self.context, self.title, return_type
+            )
+
+        self.ensure_property("Title", _loaded)
+        return return_type
+
     def get_sharing_settings(self):
         """Retrieves a sharing settings for a List"""
         return_type = ObjectSharingSettings(self.context)
@@ -263,6 +243,16 @@ class List(SecurableObject):
         self.ensure_property("RootFolder", _list_loaded)
         return return_type
 
+    def ensure_signoff_status_field(self):
+        """"""
+        return_type = Field(self.context)
+        self.fields.add_child(return_type)
+        qry = ServiceOperationQuery(
+            self, "EnsureSignoffStatusField", None, None, None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
     def get_all_rules(self):
         """Retrieves rules of a List"""
         return_type = ClientResult(self.context, ClientValueCollection(SPListRule))
@@ -392,25 +382,72 @@ class List(SecurableObject):
         return return_type
 
     @staticmethod
-    def get_list_data_as_stream(context, list_full_url, parameters=None):
+    def get_list_data_as_stream(
+        context,
+        list_full_url,
+        parameters=None,
+        casc_del_warn_message=None,
+        custom_action=None,
+        drill_down=None,
+        field=None,
+        field_internal_name=None,
+        return_type=None,
+    ):
         """
         Returns list data from the specified list url and for the specified query parameters.
 
         :param office365.sharepoint.client_context.ClientContext context: Client context
         :param str list_full_url: The absolute URL of the list.
         :param RenderListDataParameters parameters: The parameters to be used.
-        """
-        result = ClientResult(context)
+        :param str casc_del_warn_message:
+        :param str custom_action:
+        :param str drill_down:
+        :param str field:
+        :param str field_internal_name:
+        :param ClientResult[dict] return_type: The return type.
+        """
+        if return_type is None:
+            return_type = ClientResult(context, dict())
         payload = {
             "listFullUrl": list_full_url,
             "parameters": parameters,
+            "CascDelWarnMessage": casc_del_warn_message,
+            "CustomAction": custom_action,
+            "DrillDown": drill_down,
+            "Field": field,
+            "FieldInternalName": field_internal_name,
+        }
+        qry = ServiceOperationQuery(
+            List(context), "GetListDataAsStream", None, payload, None, return_type, True
+        )
+        context.add_query(qry)
+        return return_type
+
+    @staticmethod
+    def get_onedrive_list_data_as_stream(context, parameters=None, return_type=None):
+        """
+        Returns list data from the specified list url and for the specified query parameters.
+
+        :param office365.sharepoint.client_context.ClientContext context: Client context
+        :param RenderListDataParameters parameters: The parameters to be used.
+        :param ClientResult[dict] return_type: The return type.
+        """
+        if return_type is None:
+            return_type = ClientResult(context, dict())
+        payload = {
+            "parameters": parameters,
         }
-        target_list = context.web.get_list(list_full_url)
         qry = ServiceOperationQuery(
-            target_list, "GetListDataAsStream", None, payload, None, result
+            List(context),
+            "GetOneDriveListDataAsStream",
+            None,
+            payload,
+            None,
+            return_type,
+            True,
         )
         context.add_query(qry)
-        return result
+        return return_type
 
     def bulk_validate_update_list_items(
         self,
@@ -450,6 +487,7 @@ class List(SecurableObject):
 
     def get_lookup_field_choices(self, target_field_name, paging_info=None):
         """
+        Retrieves the possible choices or values for a lookup field in a SharePoint list
         :param str target_field_name:
         :param str paging_info:
         """
@@ -711,6 +749,31 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    def render_list_data_as_stream(
+        self, view_xml=None, render_options=None, expand_groups=None
+    ):
+        """Returns the data for the specified query view.
+
+        :param str view_xml: Specifies the CAML view XML.
+        :param int render_options: Specifies the type of output to return.
+        :param bool expand_groups: Specifies whether to expand the grouping or not.
+        """
+        return_type = ClientResult(self.context, dict())
+        if view_xml is None:
+            view_xml = "<View/>"
+        payload = {
+            "parameters": RenderListDataParameters(
+                view_xml=view_xml,
+                render_options=render_options,
+                expand_groups=expand_groups,
+            ),
+        }
+        qry = ServiceOperationQuery(
+            self, "RenderListDataAsStream", None, payload, None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
     def reserve_list_item_id(self):
         # type: () -> ClientResult[int]
         """Reserves the returned list item identifier for the idempotent creation of a list item."""
@@ -751,6 +814,17 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    def reset_doc_id(self):
+        """"""
+        from office365.sharepoint.documentmanagement.document_id import DocumentId
+
+        def _loaded():
+            doc_mng = DocumentId(self.context)
+            doc_mng.reset_doc_ids_in_library(self.root_folder.serverRelativeUrl)
+
+        self.ensure_property("RootFolder", _loaded)
+        return self
+
     @property
     def id(self):
         # type: () -> Optional[str]
@@ -1016,6 +1090,34 @@ class List(SecurableObject):
         """ """
         return self.properties.get("HasContentAssemblyTemplates", None)
 
+    @property
+    def has_external_data_source(self):
+        # type: () -> Optional[bool]
+        """
+        Specifies whether the list is an external list.
+        """
+        return self.properties.get("HasExternalDataSource", None)
+
+    @property
+    def has_folder_coloring_fields(self):
+        # type: () -> Optional[bool]
+        """ """
+        return self.properties.get("HasFolderColoringFields", None)
+
+    @property
+    def irm_enabled(self):
+        # type: () -> Optional[bool]
+        """Gets a Boolean value that specifies whether Information Rights Management (IRM) is enabled for the list."""
+        return self.properties.get("IrmEnabled", None)
+
+    @property
+    def irm_expire(self):
+        # type: () -> Optional[bool]
+        """Gets a Boolean value that specifies whether Information Rights Management (IRM) expiration is enabled
+        for the list
+        """
+        return self.properties.get("IrmExpire", None)
+
     @property
     def items(self):
         # type: () -> ListItemCollection
@@ -1128,6 +1230,16 @@ class List(SecurableObject):
             ),
         )
 
+    @property
+    def version_policies(self):
+        """ """
+        return self.properties.get(
+            "VersionPolicies",
+            VersionPolicyManager(
+                self.context, ResourcePath("VersionPolicies", self.resource_path)
+            ),
+        )
+
     @property
     def custom_action_elements(self):
         return self.properties.get(
@@ -1408,6 +1520,7 @@ class List(SecurableObject):
                 "RootFolder": self.root_folder,
                 "TitleResource": self.title_resource,
                 "UserCustomActions": self.user_custom_actions,
+                "VersionPolicies": self.version_policies,
             }
             default_value = property_mapping.get(name, None)
         return super(List, self).get_property(name, default_value)
@@ -1420,4 +1533,8 @@ class List(SecurableObject):
                 self._resource_path = self.parent_collection.get_by_id(
                     value
                 ).resource_path
+            elif name == "Url":
+                self._resource_path = ServiceOperationPath(
+                    "getList", [value], self.context.web.resource_path
+                )
         return self

office365/sharepoint/lists/render_data_parameters.py

@@ -1,6 +1,25 @@
 from office365.runtime.client_value import ClientValue
 
 
+class RenderListDataOptions:
+    """The type of data to return when rendering a list view as JSON."""
+
+    """Default render type."""
+    None_ = 0
+
+    """ Returns the list data context information. """
+    ContextInfo = 1
+
+    """ Returns the list data. """
+    ListData = 2
+
+    """ Returns the list schema. """
+    ListSchema = 4
+
+    """ Returns the menu view of the list. """
+    MenuView = 8
+
+
 class RenderListDataParameters(ClientValue):
     """Specifies the parameters to be used to render list data as a JSON string"""
 
@@ -16,6 +35,10 @@ class RenderListDataParameters(ClientValue):
         expand_groups=None,
         expand_user_field=None,
         filter_out_channel_folders_in_default_doc_lib=None,
+        render_options=None,
+        require_folder_coloring_fields=None,
+        show_stub_file=None,
+        view_xml=None,
     ):
         """
         :param bool add_all_fields:
@@ -29,6 +52,10 @@ class RenderListDataParameters(ClientValue):
         :param bool expand_groups: Specifies whether to expand the grouping or not.
         :param bool expand_user_field:
         :param bool filter_out_channel_folders_in_default_doc_lib:
+        :param int render_options: Specifies the type of output to return.
+        :param bool require_folder_coloring_fields:
+        :param bool show_stub_file:
+        :param str view_xml: Specifies the CAML view XML.
         """
         self.AddAllFields = add_all_fields
         self.AddAllViewFields = add_all_view_fields
@@ -44,6 +71,10 @@ class RenderListDataParameters(ClientValue):
         self.FilterOutChannelFoldersInDefaultDocLib = (
             filter_out_channel_folders_in_default_doc_lib
         )
+        self.RenderOptions = render_options
+        self.RequireFolderColoringFields = require_folder_coloring_fields
+        self.ShowStubFile = show_stub_file
+        self.ViewXml = view_xml
 
     @property
     def entity_type_name(self):

office365/sharepoint/lists/version_policy_manager.py

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

office365/sharepoint/marketplace/app_metadata.py

@@ -7,6 +7,9 @@ from office365.sharepoint.entity import Entity
 class CorporateCatalogAppMetadata(Entity):
     """App metadata for apps stored in the corporate catalog."""
 
+    def __str__(self):
+        return self.title or self.entity_type_name
+
     def deploy(self, skip_feature_deployment):
         """This method deploys an app on the app catalog.  It MUST be called in the context of the tenant app
         catalog web or it will fail.
@@ -18,6 +21,13 @@ class CorporateCatalogAppMetadata(Entity):
         self.context.add_query(qry)
         return self
 
+    def remove(self):
+        """This is the inverse of the add step above. One removed from the app catalog,
+        the solution can't be deployed."""
+        qry = ServiceOperationQuery(self, "Remove")
+        self.context.add_query(qry)
+        return self
+
     def install(self):
         """This method allows an app which is already deployed to be installed on a web."""
         qry = ServiceOperationQuery(self, "Install")
@@ -68,7 +78,8 @@ class CorporateCatalogAppMetadata(Entity):
 
     @property
     def property_ref_name(self):
-        return "AadAppId"
+        # return "AadAppId"
+        return "ID"
 
     @property
     def entity_type_name(self):

office365/sharepoint/marketplace/app_metadata_collection.py

@@ -22,3 +22,11 @@ class CorporateCatalogAppMetadataCollection(
         return CorporateCatalogAppMetadata(
             self.context, ServiceOperationPath("GetById", [app_id], self.resource_path)
         )
+
+    def get_by_title(self, title):
+        """
+        Get app metadata by title.
+
+        :param str title: The title of the app to retrieve.
+        """
+        return self.first("title eq '{0}'".format(title))

office365/sharepoint/marketplace/corporatecuratedgallery/addins/instance_info.py

@@ -2,6 +2,28 @@ from office365.runtime.client_value import ClientValue
 
 
 class SPAddinInstanceInfo(ClientValue):
+
+    def __init__(
+        self,
+        app_identifier=None,
+        app_instance_id=None,
+        tenant_app_data=None,
+        tenant_app_data_update_time=None,
+        title=None,
+    ):
+        """
+        :param str app_identifier:
+        :param str app_instance_id:
+        :param str tenant_app_data:
+        :param datetime.datetime tenant_app_data_update_time:
+        :param str title:
+        """
+        self.appIdentifier = app_identifier
+        self.appInstanceId = app_instance_id
+        self.tenantAppData = tenant_app_data
+        self.tenantAppDataUpdateTime = tenant_app_data_update_time
+        self.title = title
+
     @property
     def entity_type_name(self):
         return "Microsoft.SharePoint.Marketplace.CorporateCuratedGallery.SPAddinInstanceInfo"

office365/sharepoint/marketplace/corporatecuratedgallery/addins/permission_failed_info.py

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

office365/sharepoint/marketplace/corporatecuratedgallery/addins/permission_info.py

@@ -0,0 +1,12 @@
+from office365.runtime.client_value import ClientValue
+
+
+class SPAddinPermissionInfo(ClientValue):
+    """"""
+
+    def __init__(self, absolute_url=None):
+        self.absoluteUrl = absolute_url
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.Marketplace.CorporateCuratedGallery.SPAddinPermissionInfo"

office365/sharepoint/marketplace/corporatecuratedgallery/addins/permission_response.py

@@ -1,9 +1,24 @@
 from office365.runtime.client_value import ClientValue
+from office365.runtime.client_value_collection import ClientValueCollection
+from office365.sharepoint.marketplace.corporatecuratedgallery.addins.permission_failed_info import (
+    SPAddinPermissionFailedInfo,
+)
+from office365.sharepoint.marketplace.corporatecuratedgallery.addins.permission_info import (
+    SPAddinPermissionInfo,
+)
 
 
 class SPAddinPermissionResponse(ClientValue):
     """"""
 
+    def __init__(self, addin_permissions=None, failed_addins=None):
+        self.addinPermissions = ClientValueCollection(
+            SPAddinPermissionInfo, addin_permissions
+        )
+        self.failedAddins = ClientValueCollection(
+            SPAddinPermissionFailedInfo, failed_addins
+        )
+
     @property
     def entity_type_name(self):
         return "Microsoft.SharePoint.Marketplace.CorporateCuratedGallery.SPAddinPermissionResponse"

office365/sharepoint/marketplace/corporatecuratedgallery/addins/principals_response.py

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

office365/sharepoint/marketplace/corporatecuratedgallery/app_request_information.py

@@ -0,0 +1,9 @@
+from office365.runtime.client_value import ClientValue
+
+
+class SPStoreAppRequestInformation(ClientValue):
+    """"""
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.Marketplace.CorporateCuratedGallery.SPStoreAppRequestInformation"

office365/sharepoint/marketplace/corporatecuratedgallery/app_response_information.py

@@ -0,0 +1,9 @@
+from office365.runtime.client_value import ClientValue
+
+
+class SPStoreAppResponseInformation(ClientValue):
+    """"""
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.Marketplace.CorporateCuratedGallery.SPStoreAppResponseInformation"

office365/sharepoint/marketplace/corporatecuratedgallery/available_addins_response.py

@@ -8,3 +8,7 @@ from office365.sharepoint.marketplace.corporatecuratedgallery.addins.instance_in
 class SPAvailableAddinsResponse(ClientValue):
     def __init__(self, addins=None):
         self.addins = ClientValueCollection(SPAddinInstanceInfo, addins)
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.Marketplace.CorporateCuratedGallery.SPAvailableAddinsResponse"

office365/sharepoint/marketplace/corporatecuratedgallery/card_design.py

@@ -0,0 +1,9 @@
+from office365.runtime.client_value import ClientValue
+
+
+class CardDesign(ClientValue):
+    """"""
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.Marketplace.CorporateCuratedGallery.CardDesign"

office365/sharepoint/marketplace/corporatecuratedgallery/card_designs.py

@@ -0,0 +1,9 @@
+from office365.sharepoint.entity import Entity
+
+
+class CardDesigns(Entity):
+    """"""
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.Marketplace.CorporateCuratedGallery.CardDesigns"