sp tenant namespace update

vgrem · vgrem · commit 5d9eac0ee125 · 2024-05-06T20:29:39.000+03:00
diff --git a/examples/onedrive/folders/list_files.py b/examples/onedrive/folders/list_files.py
@@ -16,7 +16,7 @@
 )
 # items = client.me.drive.root.get_files(False).execute_query()
 site = client.sites.get_by_url(test_team_site_url)
-items = site.lists["Documents"].drive.root.get_files(True, 1000).execute_query()
+items = site.lists["Documents"].drive.root.get_files(False, 1000).execute_query()
 print("{0} files found".format(len(items)))
 for file_item in items:
     print(file_item.web_url)
diff --git a/examples/onedrive/folders/list_folders.py b/examples/onedrive/folders/list_folders.py
@@ -16,7 +16,9 @@
 )
 # items = client.me.drive.root.get_files(False).execute_query()
 site = client.sites.get_by_url(test_team_site_url)
-items = site.lists["Documents"].drive.root.get_folders(True, 1000).execute_query()
+items = (
+    site.lists["Documents_Archive"].drive.root.get_folders(False, 10000).execute_query()
+)
 print("{0} folders found".format(len(items)))
 # for folder_item in items:
 #    print(folder_item.web_url)
diff --git a/examples/sharepoint/files/upload_json.py b/examples/sharepoint/files/upload_json.py
@@ -0,0 +1,15 @@
+"""
+Demonstrates how to upload a JSON file to a SharePoint site
+"""
+
+from office365.sharepoint.client_context import ClientContext
+from tests import test_team_site_url, test_user_credentials
+
+ctx = ClientContext(test_team_site_url).with_credentials(test_user_credentials)
+
+list_title = "Documents"
+folder = ctx.web.lists.get_by_title(list_title).root_folder
+path = "../../data/countries.json"
+with open(path, "r") as f:
+    file = folder.files.upload(f).execute_query()
+print("File has been uploaded into: {0}".format(file.serverRelativeUrl))
diff --git a/examples/sharepoint/files/versions/list.py b/examples/sharepoint/files/versions/list.py
@@ -15,4 +15,5 @@
 )
 
 for version in file_with_versions.versions:
+    # print(version.properties.get("Created"))
     print(version.version_label)
diff --git a/examples/sharepoint/listitems/filter_by_folder.py b/examples/sharepoint/listitems/filter_by_folder.py
diff --git a/examples/sharepoint/listitems/get_deleted.py b/examples/sharepoint/listitems/get_deleted.py
@@ -1,7 +1,6 @@
 """
 Demonstrates how to retrieve deleted items (of File type)
 """
-from office365.sharepoint.changes.query import ChangeQuery
 from office365.sharepoint.client_context import ClientContext
 from tests import test_client_credentials, test_team_site_url
 
diff --git a/generator/import_metadata.py b/generator/import_metadata.py
@@ -26,13 +26,13 @@ def export_to_file(path, content):
     "--endpoint",
     dest="endpoint",
     help="Import metadata endpoint",
-    default="sharepoint",
+    default="microsoftgraph",
 )
 parser.add_argument(
     "-p",
     "--path",
     dest="path",
-    default="./metadata/SharePoint.xml",
+    default="./metadata/MicrosoftGraph.xml",
     help="Import metadata endpoint",
 )
 
diff --git a/generator/metadata/MicrosoftGraph.xml b/generator/metadata/MicrosoftGraph.xml
diff --git a/office365/onedrive/driveitems/driveItem.py b/office365/onedrive/driveitems/driveItem.py
@@ -81,7 +81,7 @@ def _after_loaded(col):
 
                 for drive_item in col:
                     if drive_item.is_folder:
-                        if recursive:
+                        if recursive and drive_item.folder.childCount > 0:
                             _get_files(drive_item)
                     else:
                         return_type.add_child(drive_item)
diff --git a/office365/sharepoint/attachments/collection.py b/office365/sharepoint/attachments/collection.py
@@ -19,7 +19,7 @@ def __init__(self, context, resource_path=None, parent=None):
         )
 
     def add(self, attachment_file_information):
-        # type: (AttachmentCreationInformation) -> Attachment
+        # type: (AttachmentCreationInformation|dict) -> Attachment
         """
         Adds the attachment represented by the file name and stream in the specified parameter to the list item.
 
diff --git a/office365/sharepoint/files/versions/version.py b/office365/sharepoint/files/versions/version.py
@@ -1,3 +1,4 @@
+from datetime import datetime
 from typing import IO, AnyStr, Optional
 
 from typing_extensions import Self
@@ -54,6 +55,12 @@ def open_binary_stream_with_options(self, open_options):
         self.context.add_query(qry)
         return return_type
 
+    @property
+    def created(self):
+        # type: () -> Optional[datetime]
+        """Specifies the creation date and time for the file version."""
+        return self.properties.get("Created", datetime.min)
+
     @property
     def created_by(self):
         """Gets the user that created the file version."""
diff --git a/office365/sharepoint/multigeo/api_versions.py b/office365/sharepoint/multigeo/api_versions.py
@@ -0,0 +1,28 @@
+from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.types.collections import StringCollection
+from office365.sharepoint.entity import Entity
+
+
+class MultiGeoApiVersions(Entity):
+    """"""
+
+    def __init__(self, context, resource_path=None):
+        if resource_path is None:
+            resource_path = ResourcePath(
+                "Microsoft.Online.SharePoint.MultiGeo.Service.MultiGeoApiVersions"
+            )
+        super(MultiGeoApiVersions, self).__init__(context, resource_path)
+
+    @property
+    def supported_versions(self):
+        return self.properties.get("SupportedVersions", StringCollection())
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Online.SharePoint.MultiGeo.Service.MultiGeoApiVersions"
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {"SupportedVersions": self.supported_versions}
+            default_value = property_mapping.get(name, None)
+        return super(MultiGeoApiVersions, self).get_property(name, default_value)
diff --git a/office365/sharepoint/multigeo/services.py b/office365/sharepoint/multigeo/services.py
@@ -0,0 +1,39 @@
+from office365.runtime.paths.resource_path import ResourcePath
+from office365.sharepoint.entity import Entity
+from office365.sharepoint.entity_collection import EntityCollection
+from office365.sharepoint.multigeo.unified_group import UnifiedGroup
+
+
+class MultiGeoServices(Entity):
+    """
+    Multi-Geo capabilities in OneDrive and SharePoint enable control of shared resources like SharePoint team sites
+    and Microsoft 365 Group mailboxes stored at rest in a specified geo location.
+
+    Each user, Group mailbox, and SharePoint site have a Preferred Data Location (PDL) which denotes the geo location
+    where related data is to be stored. Users' personal data (Exchange mailbox and OneDrive) along with any
+    Microsoft 365 Groups or SharePoint sites that they create can be stored in the specified geo location to meet
+    data residency requirements.
+    """
+
+    @property
+    def unified_groups(self):
+        # type: () -> EntityCollection[UnifiedGroup]
+        """ """
+        return self.properties.get(
+            "UnifiedGroups",
+            EntityCollection(
+                self.context,
+                UnifiedGroup,
+                ResourcePath("UnifiedGroups", self.resource_path),
+            ),
+        )
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Online.SharePoint.MultiGeo.Service.MultiGeoServicesBeta"
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {"UnifiedGroups": self.unified_groups}
+            default_value = property_mapping.get(name, None)
+        return super(MultiGeoServices, self).get_property(name, default_value)
diff --git a/office365/sharepoint/multigeo/tenant_information.py b/office365/sharepoint/multigeo/tenant_information.py
@@ -0,0 +1,9 @@
+from office365.sharepoint.entity import Entity
+
+
+class TenantInformation(Entity):
+    """ """
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Online.SharePoint.MultiGeo.Service.TenantInformation"
diff --git a/office365/sharepoint/sharing/permission_collection.py b/office365/sharepoint/sharing/permission_collection.py
@@ -13,19 +13,26 @@ class PermissionCollection(ClientValue):
     """
 
     def __init__(
-        self, hasInheritedLinks=None, links=None, principals=None, siteAdmins=None
+        self,
+        hasInheritedLinks=None,
+        links=None,
+        principals=None,
+        siteAdmins=None,
+        totalNumberOfPrincipals=None,
     ):
         """
         :param bool hasInheritedLinks:
         :param list[LinkInfo] links: The List of tokenized sharing links with their LinkInfo objects.
         :param list[PrincipalInfo] principals: The List of Principals with their roles on this list item.
         :param list[PrincipalInfo] siteAdmins: The List of Principals who are Site Admins. This property is returned
             only if the caller is an Auditor.
+        :param int totalNumberOfPrincipals:
         """
         self.hasInheritedLinks = hasInheritedLinks
         self.links = ClientValueCollection(LinkInfo, links)
         self.principals = ClientValueCollection(PrincipalInfo, principals)
         self.siteAdmins = ClientValueCollection(PrincipalInfo, siteAdmins)
+        self.totalNumberOfPrincipals = totalNumberOfPrincipals
 
     @property
     def entity_type_name(self):
diff --git a/office365/sharepoint/sharing/shared_document_info.py b/office365/sharepoint/sharing/shared_document_info.py
@@ -1,5 +1,6 @@
 from typing import Optional
 
+from office365.sharepoint.contenttypes.content_type_id import ContentTypeId
 from office365.sharepoint.entity import Entity
 from office365.sharepoint.sharing.principal import Principal
 
@@ -24,6 +25,24 @@ def caller_stack(self):
         """"""
         return self.properties.get("CallerStack", None)
 
+    @property
+    def color_hex(self):
+        # type: () -> Optional[str]
+        """"""
+        return self.properties.get("ColorHex", None)
+
+    @property
+    def color_tag(self):
+        # type: () -> Optional[str]
+        """"""
+        return self.properties.get("ColorTag", None)
+
+    @property
+    def content_type_id(self):
+        # type: () -> Optional[str]
+        """"""
+        return self.properties.get("ContentTypeId", ContentTypeId())
+
     @property
     def entity_type_name(self):
         return "SP.Sharing.SharedDocumentInfo"
diff --git a/office365/sharepoint/sitehealth/summary.py b/office365/sharepoint/sitehealth/summary.py
@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.sharepoint.entity import Entity
 from office365.sharepoint.sitehealth.result import SiteHealthResult
@@ -6,6 +8,24 @@
 class SiteHealthSummary(Entity):
     """Specifies a summary of the results of running a set of site collection health rules."""
 
+    @property
+    def failed_error_count(self):
+        # type: () -> Optional[int]
+        """Specifies the number of site collection health rules that failed with an error."""
+        return self.properties.get("FailedErrorCount", None)
+
+    @property
+    def failed_warning_count(self):
+        # type: () -> Optional[int]
+        """Specifies the number of site collection health rules that failed with a warning."""
+        return self.properties.get("FailedWarningCount", None)
+
+    @property
+    def passed_count(self):
+        # type: () -> Optional[int]
+        """Specifies the number of site collection health rules that passed."""
+        return self.properties.get("PassedCount", None)
+
     @property
     def results(self):
         """Specifies a list of site collection health rule results, one for each site collection health rule that
diff --git a/office365/sharepoint/sites/site.py b/office365/sharepoint/sites/site.py
@@ -88,6 +88,18 @@ def _site_resolved():
         self.ensure_properties(["Url", "GroupId", "Id"], _site_resolved)
         return self
 
+    def check_is_deletable(self):
+        """Check Site Is Deletable"""
+        return_type = ClientResult(self.context, bool())
+
+        def _check_is_deletable():
+            SPPolicyStoreProxy.check_site_is_deletable_by_id(
+                self.context, self.id, return_type
+            )
+
+        self.ensure_property("Id", _check_is_deletable)
+        return return_type
+
     def extend_upgrade_reminder_date(self):
         """
         Extend the upgrade reminder date for this site collection, so that site collection administrators will
diff --git a/office365/sharepoint/tenant/administration/group.py b/office365/sharepoint/tenant/administration/group.py
@@ -0,0 +1,17 @@
+from office365.runtime.paths.resource_path import ResourcePath
+from office365.sharepoint.entity import Entity
+
+
+class SPOGroup(Entity):
+    """ """
+
+    def __init__(self, context, resource_path=None):
+        if resource_path is None:
+            resource_path = ResourcePath(
+                "Microsoft.Online.SharePoint.TenantAdministration.SPOGroup"
+            )
+        super(SPOGroup, self).__init__(context, resource_path)
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Online.SharePoint.TenantAdministration.SPOGroup"
diff --git a/office365/sharepoint/tenant/administration/powerapps/environment.py b/office365/sharepoint/tenant/administration/powerapps/environment.py
@@ -0,0 +1,31 @@
+from office365.runtime.client_value import ClientValue
+
+
+class PowerAppsEnvironment(ClientValue):
+    """ """
+
+    def __init__(
+        self,
+        AllocatedAICredits=None,
+        DisplayName=None,
+        IsDefault=None,
+        Name=None,
+        PurchasedAICredits=None,
+    ):
+        # type: (float, str, bool, str, float) -> None
+        self.AllocatedAICredits = AllocatedAICredits
+        self.DisplayName = DisplayName
+        self.IsDefault = IsDefault
+        self.Name = Name
+        self.PurchasedAICredits = PurchasedAICredits
+
+    def __str__(self):
+        return self.DisplayName or self.entity_type_name
+
+    def __repr__(self):
+        return self.Name or self.entity_type_name
+
+    @property
+    def entity_type_name(self):
+        # type: () -> str
+        return "Microsoft.Online.SharePoint.TenantAdministration.PowerAppsEnvironment"
diff --git a/office365/sharepoint/tenant/administration/recent_admin_action_report.py b/office365/sharepoint/tenant/administration/recent_admin_action_report.py
@@ -0,0 +1,14 @@
+from office365.runtime.client_value import ClientValue
+
+
+class RecentAdminActionReport(ClientValue):
+    """ """
+
+    def __init__(self, actions=None, createdByEmail=None):
+        # type: (str, str) -> None
+        self.actions = actions
+        self.createdByEmail = createdByEmail
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.Administration.TenantAdmin.RecentAdminActionReport"
diff --git a/office365/sharepoint/tenant/administration/recent_admin_action_report_payload.py b/office365/sharepoint/tenant/administration/recent_admin_action_report_payload.py
@@ -0,0 +1,10 @@
+from office365.runtime.client_value import ClientValue
+
+
+class RecentAdminActionReportPayload(ClientValue):
+    """ """
+
+    @property
+    def entity_type_name(self):
+        # type: () -> str
+        return "Microsoft.Online.SharePoint.TenantAdministration.RecentAdminActionReportPayload"
diff --git a/office365/sharepoint/tenant/administration/siteinfo_for_site_picker.py b/office365/sharepoint/tenant/administration/siteinfo_for_site_picker.py
@@ -2,8 +2,12 @@
 
 
 class SiteInfoForSitePicker(ClientValue):
-    def __init__(self, site_name=None):
+    def __init__(self, Error=None, site_id=None, site_name=None, Url=None):
+        # type: (str, str, str, str) -> None
+        self.Error = Error
+        self.SiteId = site_id
         self.SiteName = site_name
+        self.Url = Url
 
     @property
     def entity_type_name(self):
diff --git a/office365/sharepoint/tenant/administration/sites/creation_default_storage_quota.py b/office365/sharepoint/tenant/administration/sites/creation_default_storage_quota.py
@@ -2,6 +2,11 @@
 
 
 class SiteCreationDefaultStorageQuota(ClientValue):
+    def __init__(self, IsReadOnly=None, Value=None):
+        # type: (bool, int) -> None
+        self.IsReadOnly = IsReadOnly
+        self.Value = Value
+
     @property
     def entity_type_name(self):
         return "Microsoft.Online.SharePoint.TenantAdministration.SiteCreationDefaultStorageQuota"
diff --git a/office365/sharepoint/tenant/administration/sites/creation_source.py b/office365/sharepoint/tenant/administration/sites/creation_source.py
diff --git a/office365/sharepoint/tenant/administration/sites/properties_collection.py b/office365/sharepoint/tenant/administration/sites/properties_collection.py
diff --git a/office365/sharepoint/tenant/administration/sites/state_properties.py b/office365/sharepoint/tenant/administration/sites/state_properties.py
diff --git a/office365/sharepoint/tenant/administration/tenant.py b/office365/sharepoint/tenant/administration/tenant.py
diff --git a/office365/sharepoint/workflow/manager.py b/office365/sharepoint/workflow/manager.py
diff --git a/tests/sharepoint/test_multigeo.py b/tests/sharepoint/test_multigeo.py
diff --git a/tests/sharepoint/test_site.py b/tests/sharepoint/test_site.py
diff --git a/tests/sharepoint/test_tenant.py b/tests/sharepoint/test_tenant.py

Original file line number	Diff line number	Diff line change
`@@ -16,7 +16,7 @@`
`16`	`16`	`)`
`17`	`17`	`# items = client.me.drive.root.get_files(False).execute_query()`
`18`	`18`	`site = client.sites.get_by_url(test_team_site_url)`
`19`		`-items = site.lists["Documents"].drive.root.get_files(True, 1000).execute_query()`
	`19`	`+items = site.lists["Documents"].drive.root.get_files(False, 1000).execute_query()`
`20`	`20`	`print("{0} files found".format(len(items)))`
`21`	`21`	`for file_item in items:`
`22`	`22`	`print(file_item.web_url)`
Original file line number	Diff line number	Diff line change
`@@ -15,4 +15,5 @@`
`15`	`15`	`)`
`16`	`16`
`17`	`17`	`for version in file_with_versions.versions:`
	`18`	`+ # print(version.properties.get("Created"))`
`18`	`19`	`print(version.version_label)`
Original file line number	Diff line number	Diff line change
`@@ -19,7 +19,7 @@ def __init__(self, context, resource_path=None, parent=None):`
`19`	`19`	`)`
`20`	`20`
`21`	`21`	`def add(self, attachment_file_information):`
`22`		`- # type: (AttachmentCreationInformation) -> Attachment`
	`22`	`+ # type: (AttachmentCreationInformation\|dict) -> Attachment`
`23`	`23`	`"""`
`24`	`24`	`Adds the attachment represented by the file name and stream in the specified parameter to the list item.`
`25`	`25`