Office365-REST-Python-Client 2.5.6__py3-none-any.whl → 2.5.8__py3-none-any.whl

office365/sharepoint/activities/action_facet.py

@@ -7,8 +7,15 @@ from office365.sharepoint.activities.facets.delete import DeleteFacet
 from office365.sharepoint.activities.facets.discard_checkout import DiscardCheckoutFacet
 from office365.sharepoint.activities.facets.edit import EditFacet
 from office365.sharepoint.activities.facets.get_comment import GetCommentFacet
+from office365.sharepoint.activities.facets.get_mention import GetMentionFacet
+from office365.sharepoint.activities.facets.move import MoveFacet
+from office365.sharepoint.activities.facets.point_in_time_restore import (
+    PointInTimeRestoreFacet,
+)
 from office365.sharepoint.activities.facets.rename import RenameFacet
 from office365.sharepoint.activities.facets.sharing import SharingFacet
+from office365.sharepoint.activities.facets.task_completed import TaskCompletedFacet
+from office365.sharepoint.activities.facets.version import VersionFacet
 
 
 class ActionFacet(ClientValue):
@@ -22,8 +29,13 @@ class ActionFacet(ClientValue):
         delete=DeleteFacet(),
         discard_checkout=DiscardCheckoutFacet(),
         edit=EditFacet(),
+        mention=GetMentionFacet(),
+        move=MoveFacet(),
+        pointInTimeRestore=PointInTimeRestoreFacet(),
         rename=RenameFacet(),
         share=SharingFacet(),
+        taskCompleted=TaskCompletedFacet(),
+        version=VersionFacet(),
     ):
         """
         :param AddToOneDriveFacet add_to_one_drive:
@@ -42,8 +54,13 @@ class ActionFacet(ClientValue):
         self.delete = delete
         self.discardCheckout = discard_checkout
         self.edit = edit
+        self.mention = mention
+        self.move = move
+        self.pointInTimeRestore = pointInTimeRestore
         self.rename = rename
         self.share = share
+        self.taskCompleted = taskCompleted
+        self.version = version
 
     def __repr__(self):
         return self.facet_type

office365/sharepoint/activities/client_request.py

@@ -1,7 +1,11 @@
 from office365.runtime.client_value import ClientValue
+from office365.sharepoint.activities.facets.revision_set import RevisionSetFacet
 
 
 class ActivityClientRequest(ClientValue):
+    def __init__(self, revisionSet=RevisionSetFacet()):
+        self.revisionSet = revisionSet
+
     @property
     def entity_type_name(self):
         return "Microsoft.SharePoint.Activities.ActivityClientRequest"

office365/sharepoint/activities/client_response.py

@@ -4,6 +4,14 @@ from office365.runtime.client_value import ClientValue
 class ActivityClientResponse(ClientValue):
     """"""
 
+    def __init__(self, id_, message=None, serverId=None, status=None):
+        # type: (str, str, str, int) -> None
+        """ """
+        self.id = id_
+        self.message = message
+        self.serverId = serverId
+        self.status = status
+
     @property
     def entity_type_name(self):
         return "Microsoft.SharePoint.Activities.ActivityClientResponse"

office365/sharepoint/activities/entity.py

@@ -34,6 +34,16 @@ class SPActivityEntity(Entity):
     def times(self):
         return self.properties.get("times", ActivityTimeFacet())
 
+    @property
+    def property_ref_name(self):
+        return "id"
+
     @property
     def entity_type_name(self):
         return "Microsoft.SharePoint.Activities.SPActivityEntity"
+
+    def set_property(self, name, value, persist_changes=True):
+        super(SPActivityEntity, self).set_property(name, value, persist_changes)
+        if name == self.property_ref_name:
+            self._resource_path.patch(value)
+        return self

office365/sharepoint/activities/facets/delete.py

@@ -5,6 +5,7 @@ class DeleteFacet(ClientValue):
     """"""
 
     def __init__(self, name=None):
+        # type: (str) -> None
         self.name = name
 
     @property

office365/sharepoint/activities/facets/get_mention.py

@@ -0,0 +1,10 @@
+from office365.runtime.client_value import ClientValue
+from office365.runtime.client_value_collection import ClientValueCollection
+from office365.sharepoint.activities.identity import ActivityIdentity
+
+
+class GetMentionFacet(ClientValue):
+    """"""
+
+    def __init__(self, mentionees=None):
+        self.mentionees = ClientValueCollection(ActivityIdentity, mentionees)

office365/sharepoint/activities/facets/in_doc.py

@@ -4,6 +4,10 @@ from office365.runtime.client_value import ClientValue
 class InDocFacet(ClientValue):
     """"""
 
+    def __init__(self, contentId=None, navigationId=None):
+        self.contentId = contentId
+        self.navigationId = navigationId
+
     @property
     def entity_type_name(self):
         return "Microsoft.SharePoint.Activities.InDocFacet"

office365/sharepoint/activities/facets/move.py

@@ -0,0 +1,14 @@
+from office365.runtime.client_value import ClientValue
+from office365.sharepoint.types.resource_path import ResourcePath as SPResPath
+
+
+class MoveFacet(ClientValue):
+    """"""
+
+    def __init__(self, from_=SPResPath(), to=SPResPath()):
+        self.from_ = from_
+        self.to = to
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.Activities.MoveFacet"

office365/sharepoint/activities/facets/point_in_time_restore.py

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

office365/sharepoint/activities/facets/revision_set.py

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

office365/sharepoint/activities/facets/task_completed.py

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

office365/sharepoint/activities/facets/version.py

@@ -0,0 +1,12 @@
+from office365.runtime.client_value import ClientValue
+
+
+class VersionFacet(ClientValue):
+    """"""
+
+    def __init__(self, fromVersion=None):
+        self.fromVersion = fromVersion
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.Activities.VersionFacet"

office365/sharepoint/activities/identity_item.py

@@ -2,11 +2,26 @@ from office365.runtime.client_value import ClientValue
 
 
 class ActivityIdentityItem(ClientValue):
-    def __init__(self, client_id=None):
+    def __init__(
+        self,
+        client_id=None,
+        clientIdProvider=None,
+        displayName=None,
+        email=None,
+        userPrincipalName=None,
+    ):
         """
         :param str client_id:
+        :param str clientIdProvider:
+        :param str displayName:
+        :param str email:
+        :param str userPrincipalName:
         """
         self.clientId = client_id
+        self.clientIdProvider = clientIdProvider
+        self.displayName = displayName
+        self.email = email
+        self.userPrincipalName = userPrincipalName
 
     @property
     def entity_type_name(self):

office365/sharepoint/alerts/collection.py

@@ -5,7 +5,7 @@ from office365.sharepoint.alerts.alert import Alert
 from office365.sharepoint.entity_collection import EntityCollection
 
 
-class AlertCollection(EntityCollection):
+class AlertCollection(EntityCollection[Alert]):
     """Content Type resource collection"""
 
     def __init__(self, context, resource_path=None):
@@ -26,6 +26,7 @@ class AlertCollection(EntityCollection):
         return return_type
 
     def contains(self, id_alert):
+        # type: (str) -> ClientResult[bool]
         """
         Returns true if the given alert exists in the alert collection. False otherwise.
 

office365/sharepoint/attachments/attachment.py

@@ -10,6 +10,9 @@ from office365.sharepoint.types.resource_path import ResourcePath as SPResPath
 class Attachment(Entity):
     """Represents an attachment file in a SharePoint List Item."""
 
+    def __repr__(self):
+        return self.server_relative_url or self.entity_type_name
+
     def download(self, file_object, use_path=True):
         """Download attachment file
 
@@ -76,16 +79,12 @@ class Attachment(Entity):
     @property
     def file_name(self):
         # type: () -> Optional[str]
-        """
-        Specifies the file name of the list item attachment.
-        """
+        """Specifies the file name of the list item attachment."""
         return self.properties.get("FileName", None)
 
     @property
     def file_name_as_path(self):
-        """
-        The file name of the attachment as a SP.ResourcePath.
-        """
+        """The file name of the attachment as a SP.ResourcePath."""
         return self.properties.get("FileNameAsPath", SPResPath())
 
     @property
@@ -96,9 +95,7 @@ class Attachment(Entity):
 
     @property
     def server_relative_path(self):
-        """
-        The server-relative-path of the attachment.
-        """
+        """The server-relative-path of the attachment."""
         return self.properties.get("ServerRelativePath", SPResPath())
 
     @property

office365/sharepoint/attachments/collection.py

@@ -1,4 +1,5 @@
-from typing import AnyStr
+import os
+from typing import IO, AnyStr
 
 from office365.runtime.paths.service_operation import ServiceOperationPath
 from office365.runtime.queries.service_operation import ServiceOperationQuery
@@ -55,14 +56,35 @@ class AttachmentCollection(EntityCollection[Attachment]):
         :param str content_stream: Stream containing the content of the attachment.
         """
         return_type = Attachment(self.context)
-        payload = {"DecodedUrl": decoded_url, "contentStream": content_stream}
+        params = {"DecodedUrl": decoded_url}
         qry = ServiceOperationQuery(
-            self, "AddUsingPath", None, payload, None, return_type
+            self, "AddUsingPath", params, content_stream, None, return_type
         )
         self.context.add_query(qry)
         self.add_child(return_type)
         return return_type
 
+    def delete_all(self):
+        """Deletes all attachments"""
+
+        def _delete_all(return_type):
+            # type: ("AttachmentCollection") -> None
+            [a.delete_object() for a in return_type]
+
+        self.get().after_execute(_delete_all)
+        return self
+
+    def upload(self, file, use_path=True):
+        # type: (IO, bool) -> Attachment
+        """
+        Uploads the attachment
+        """
+        info = AttachmentCreationInformation(os.path.basename(file.name), file.read())
+        if use_path:
+            return self.add_using_path(info.filename, info.content)
+        else:
+            return self.add(info)
+
     def get_by_filename(self, filename):
         """Retrieve Attachment file object by filename
 

office365/sharepoint/client_context.py

@@ -82,8 +82,9 @@ class ClientContext(ClientRuntimeContext):
         cert_path=None,
         private_key=None,
         scopes=None,
+        passphrase=None,
     ):
-        # type: (str, str, str, Optional[str], Optional[str], Optional[List[str]]) -> Self
+        # type: (str, str, str, Optional[str], Optional[str], Optional[List[str]], Optional[str]) -> Self
         """
         Creates authenticated SharePoint context via certificate credentials
 
@@ -93,9 +94,10 @@ class ClientContext(ClientRuntimeContext):
         :param str thumbprint: Hex encoded thumbprint of the certificate.
         :param str client_id: The OAuth client id of the calling application.
         :param list[str] or None scopes:  Scopes requested to access a protected API (a resource)
+        :param str passphrase: Passphrase if the private_key is encrypted
         """
         self.authentication_context.with_client_certificate(
-            tenant, client_id, thumbprint, cert_path, private_key, scopes
+            tenant, client_id, thumbprint, cert_path, private_key, scopes, passphrase
         )
         return self
 
@@ -408,6 +410,16 @@ class ClientContext(ClientRuntimeContext):
 
         return AnnouncementsController(self, ResourcePath("Announcements"))
 
+    @property
+    def client_people_picker(self):
+        """Query principals service alias"""
+
+        from office365.sharepoint.ui.applicationpages.peoplepicker.web_service_interface import (
+            ClientPeoplePickerWebServiceInterface,
+        )
+
+        return ClientPeoplePickerWebServiceInterface(self)
+
     @property
     def consumer_permissions(self):
         """Consumer permissions alias"""
@@ -429,6 +441,15 @@ class ClientContext(ClientRuntimeContext):
 
         return EmployeeEngagement(self)
 
+    @property
+    def directory_provider(self):
+        """Alias to SharePointDirectoryProvider"""
+        from office365.sharepoint.directory.provider.provider import (
+            SharePointDirectoryProvider,
+        )
+
+        return SharePointDirectoryProvider(self)
+
     @property
     def employee_experience(self):
         """Alias to EmployeeExperience"""
@@ -610,6 +631,16 @@ class ClientContext(ClientRuntimeContext):
 
         return SPHSite(self, ResourcePath("SPHSite"))
 
+    @property
+    def people_picker(self):
+        """Query principals service alias"""
+
+        from office365.sharepoint.ui.applicationpages.peoplepicker.web_service_interface import (
+            PeoplePickerWebServiceInterface,
+        )
+
+        return PeoplePickerWebServiceInterface(self)
+
     @property
     def publications(self):
         from office365.sharepoint.contentcenter.machinelearning.publications.publication import (

office365/sharepoint/comments/collection.py

@@ -4,7 +4,7 @@ from office365.sharepoint.comments.comment import Comment
 from office365.sharepoint.entity_collection import EntityCollection
 
 
-class CommentCollection(EntityCollection):
+class CommentCollection(EntityCollection[Comment]):
     def __init__(self, context, resource_path=None):
         super(CommentCollection, self).__init__(context, Comment, resource_path)
 

office365/sharepoint/compliance/store_proxy.py

@@ -1,3 +1,5 @@
+from typing import TYPE_CHECKING, Optional
+
 from office365.runtime.client_result import ClientResult
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.runtime.queries.service_operation import ServiceOperationQuery
@@ -5,8 +7,49 @@ from office365.runtime.types.collections import StringCollection
 from office365.sharepoint.compliance.tag import ComplianceTag
 from office365.sharepoint.entity import Entity
 
+if TYPE_CHECKING:
+    from office365.sharepoint.client_context import ClientContext
+
 
 class SPPolicyStoreProxy(Entity):
+    @staticmethod
+    def check_site_is_deletable_by_id(context, site_id, return_type=None):
+        # type: (ClientContext, str, Optional[ClientResult[bool]]) -> ClientResult[bool]
+        """ """
+        if return_type is None:
+            return_type = ClientResult(context, bool())
+        payload = {"siteId": site_id}
+        qry = ServiceOperationQuery(
+            SPPolicyStoreProxy(context),
+            "CheckSiteIsDeletableById",
+            None,
+            payload,
+            None,
+            return_type,
+            True,
+        )
+        context.add_query(qry)
+        return return_type
+
+    @staticmethod
+    def is_site_deletable(context, site_url, return_type=None):
+        # type: (ClientContext, str, Optional[ClientResult[bool]]) -> ClientResult[bool]
+        """ """
+        if return_type is None:
+            return_type = ClientResult(context, bool())
+        payload = {"siteUrl": site_url}
+        qry = ServiceOperationQuery(
+            SPPolicyStoreProxy(context),
+            "IsSiteDeletable",
+            None,
+            payload,
+            None,
+            return_type,
+            True,
+        )
+        context.add_query(qry)
+        return return_type
+
     @staticmethod
     def get_available_tags_for_site(context, site_url, return_type=None):
         """

office365/sharepoint/contenttypes/content_type.py

@@ -20,7 +20,7 @@ class ContentType(Entity):
     """
 
     def __str__(self):
-        return self.name
+        return self.name or self.entity_type_name
 
     def __repr__(self):
         return self.string_id or str(self.id) or self.entity_type_name
@@ -111,6 +111,12 @@ class ContentType(Entity):
         """
         return self.properties.get("Id", ContentTypeId())
 
+    @property
+    def scope(self):
+        # type: () -> Optional[str]
+        """Specifies a server-relative path to the content type scope of the content type."""
+        return self.properties.get("Scope", None)
+
     @property
     def sealed(self):
         # type: () -> Optional[bool]
@@ -142,6 +148,12 @@ class ContentType(Entity):
         item forms"""
         return self.properties.get("NewFormClientSideComponentProperties", None)
 
+    @property
+    def new_form_url(self):
+        # type: () -> Optional[str]
+        """Specifies the URL of a custom new form to use for list items that have been assigned the content type."""
+        return self.properties.get("NewFormUrl", None)
+
     @property
     def description(self):
         # type: () -> Optional[str]

office365/sharepoint/contenttypes/fieldlinks/collection.py

@@ -7,7 +7,7 @@ from office365.sharepoint.entity_collection import EntityCollection
 from office365.sharepoint.fields.field import Field
 
 
-class FieldLinkCollection(EntityCollection):
+class FieldLinkCollection(EntityCollection[FieldLink]):
     """Specifies a Collection for field links."""
 
     def __init__(self, context, resource_path=None):

office365/sharepoint/directory/helper.py

@@ -1,6 +1,7 @@
 from office365.runtime.client_result import ClientResult
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.sharepoint.client_context import ClientContext
 from office365.sharepoint.directory.members_info import MembersInfo
 from office365.sharepoint.directory.membership_result import MembershipResult
 from office365.sharepoint.directory.my_groups_result import MyGroupsResult
@@ -32,6 +33,7 @@ class SPHelper(Entity):
 
     @staticmethod
     def check_site_availability(context, site_url):
+        # type: (ClientContext, str) -> ClientResult[bool]
         """
         :param str site_url: Site Url
         :param office365.sharepoint.client_context.ClientContext context: SharePoint context

office365/sharepoint/directory/provider/alternate_id_data.py

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

office365/sharepoint/directory/provider/notification.py

@@ -0,0 +1,15 @@
+from office365.runtime.paths.resource_path import ResourcePath
+from office365.sharepoint.entity import Entity
+
+
+class DirectoryNotification(Entity):
+    """"""
+
+    def __init__(self, context, resource_path=None):
+        if resource_path is None:
+            resource_path = ResourcePath("SP.Directory.Provider.DirectoryNotification")
+        super(DirectoryNotification, self).__init__(context, resource_path)
+
+    @property
+    def entity_type_name(self):
+        return "SP.Directory.Provider.DirectoryNotification"

office365/sharepoint/directory/provider/object_data.py

@@ -0,0 +1,14 @@
+from office365.runtime.client_value import ClientValue
+from office365.sharepoint.directory.provider.alternate_id_data import AlternateIdData
+
+
+class DirectoryObjectData(ClientValue):
+    """"""
+
+    def __init__(self, AlternateId=AlternateIdData(), Id=None):
+        self.AlternateId = AlternateId
+        self.Id = Id
+
+    @property
+    def entity_type_name(self):
+        return "SP.Directory.Provider.DirectoryObjectData"

office365/sharepoint/directory/provider/provider.py

@@ -1,4 +1,7 @@
+from office365.runtime.client_result import ClientResult
 from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.sharepoint.directory.provider.object_data import DirectoryObjectData
 from office365.sharepoint.entity import Entity
 
 
@@ -10,6 +13,16 @@ class SharePointDirectoryProvider(Entity):
             )
         super(SharePointDirectoryProvider, self).__init__(context, resource_path)
 
+    def read_directory_object(self, data):
+        """"""
+        return_type = ClientResult(self.context, DirectoryObjectData())
+        payload = {"data": data}
+        qry = ServiceOperationQuery(
+            self, "ReadDirectoryObject", None, payload, None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
     @property
     def entity_type_name(self):
         return "SP.Directory.Provider.SharePointDirectoryProvider"

office365/sharepoint/entity.py

@@ -5,6 +5,7 @@ from typing_extensions import Self
 from office365.runtime.auth.client_credential import ClientCredential
 from office365.runtime.auth.user_credential import UserCredential
 from office365.runtime.client_object import ClientObject
+from office365.runtime.paths.v3.entity import EntityPath
 from office365.runtime.queries.delete_entity import DeleteEntityQuery
 from office365.runtime.queries.update_entity import UpdateEntityQuery
 
@@ -53,3 +54,17 @@ class Entity(ClientObject):
     @property
     def property_ref_name(self):
         return "Id"
+
+    def set_property(self, name, value, persist_changes=True):
+        super(Entity, self).set_property(name, value, persist_changes)
+        if name == self.property_ref_name:
+            if self.resource_path is None:
+                if self.parent_collection:
+                    self._resource_path = EntityPath(
+                        value, self.parent_collection.resource_path
+                    )
+                else:
+                    pass
+            else:
+                self._resource_path.patch(value)
+        return self

office365/sharepoint/features/collection.py

@@ -11,6 +11,7 @@ class FeatureCollection(EntityCollection[Feature]):
         super(FeatureCollection, self).__init__(context, Feature, resource_path, parent)
 
     def add(self, feature_id, force, featdef_scope, verify_if_activated=False):
+        # type: (str, bool, int, bool) -> Feature
         """
         Adds the feature to the collection of activated features and returns the added feature.
 
@@ -43,6 +44,7 @@ class FeatureCollection(EntityCollection[Feature]):
         return return_type
 
     def get_by_id(self, feature_id):
+        # type: (str) -> Feature
         """Returns the feature for the given feature identifier. Returns NULL if no feature is available for the given
             feature identifier.
 

office365/sharepoint/fields/collection.py

@@ -13,6 +13,7 @@ from office365.sharepoint.fields.number import FieldNumber
 from office365.sharepoint.fields.text import FieldText
 from office365.sharepoint.fields.type import FieldType
 from office365.sharepoint.fields.url import FieldUrl
+from office365.sharepoint.fields.user import FieldUser
 from office365.sharepoint.fields.xmlSchemaFieldCreationInformation import (
     XmlSchemaFieldCreationInformation,
 )
@@ -123,13 +124,12 @@ class FieldCollection(EntityCollection[Field]):
         :param str title: Specifies the display name of the field.
         """
         from office365.sharepoint.fields.lookup import FieldLookup
+        from office365.sharepoint.lists.list import List  # noqa
 
         return_type = FieldLookup(self.context)
 
         def _add_lookup_field(lookup_list_id):
-            """
-            :type lookup_list_id: str
-            """
+            # type: (str) -> None
             if allow_multiple_values:
                 field_schema = """
                         <Field Type="LookupMulti" Mult="TRUE" DisplayName="{title}" Required="FALSE" Hidden="TRUE" \
@@ -176,6 +176,7 @@ class FieldCollection(EntityCollection[Field]):
         return self.add_field(create_field_info)
 
     def add_user_field(self, title):
+        # type: (str) -> FieldUser
         """
         Creates a User field