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

office365/runtime/odata/v4/batch_request.py

@@ -1,22 +1,22 @@
 import json
+from typing import Any, Dict, Iterator, List, Optional, Tuple
 
-import requests
+from requests import Response
 from requests.structures import CaseInsensitiveDict
 
 from office365.runtime.http.http_method import HttpMethod
 from office365.runtime.http.request_options import RequestOptions
 from office365.runtime.odata.request import ODataRequest
+from office365.runtime.queries.batch import BatchQuery
+from office365.runtime.queries.client_query import ClientQuery
 
 
 class ODataV4BatchRequest(ODataRequest):
     """JSON batch request"""
 
     def build_request(self, query):
-        """
-        Builds a batch request
-
-        :type query: office365.runtime.queries.batch.BatchQuery
-        """
+        # type: (BatchQuery) -> RequestOptions
+        """Builds a batch request"""
         request = RequestOptions(query.url)
         request.method = HttpMethod.Post
         request.ensure_header("Content-Type", "application/json")
@@ -25,24 +25,19 @@ class ODataV4BatchRequest(ODataRequest):
         return request
 
     def process_response(self, response, query):
-        """Parses an HTTP response.
-
-        :type response: requests.Response
-        :type query: office365.runtime.queries.batch.BatchQuery
-        """
+        # type: (Response, BatchQuery) -> None
+        """Parses an HTTP response."""
         for sub_qry, sub_resp in self._extract_response(response, query):
             sub_resp.raise_for_status()
             super(ODataV4BatchRequest, self).process_response(sub_resp, sub_qry)
 
     @staticmethod
     def _extract_response(response, query):
-        """
-        :type response: requests.Response
-        :type query: office365.runtime.queries.batch.BatchQuery
-        """
+        # type: (Response, BatchQuery) -> Iterator[Tuple[ClientQuery, Response]]
+        """ """
         json_responses = response.json()
         for json_resp in json_responses["responses"]:
-            resp = requests.Response()
+            resp = Response()
             resp.status_code = int(json_resp["status"])
             resp.headers = CaseInsensitiveDict(json_resp["headers"])
             resp._content = json.dumps(json_resp["body"]).encode("utf-8")
@@ -65,11 +60,8 @@ class ODataV4BatchRequest(ODataRequest):
 
     @staticmethod
     def _normalize_request(query, query_id, depends_on=None):
-        """
-        :type query: office365.runtime.queries.client_query.ClientQuery
-        :type query_id: str
-        :type depends_on:  list[str] or None
-        """
+        # type: (ClientQuery, str, Optional[List[str]]) -> Dict[str, Any]
+        """ """
         request = query.build_request()
         allowed_props = ["id", "method", "headers", "url", "body"]
         request_json = dict(

office365/runtime/queries/upload_session.py

@@ -4,6 +4,11 @@ from office365.runtime.queries.service_operation import ServiceOperationQuery
 
 
 class UploadSessionQuery(ServiceOperationQuery):
+    """
+    The UploadSession query provides information about how to upload large files to OneDrive, OneDrive for
+    Business, or SharePoint document libraries
+    """
+
     def __init__(self, binding_type, parameters_type):
         super(UploadSessionQuery, self).__init__(
             binding_type, "createUploadSession", None, parameters_type

office365/runtime/types/event_handler.py

@@ -35,7 +35,7 @@ class EventHandler:
 
     def notify(self, *args, **kwargs):
         # type: (Any, Any) -> None
-        for listener in self._listeners:
+        for listener in self._listeners[:]:
             if self._once:
                 self._listeners.remove(listener)
             listener(*args, **kwargs)

office365/search/entity.py

@@ -38,8 +38,9 @@ class SearchEntity(Entity):
             # self.context.pending_request().map_json(search_hit.resource, resource)
             # search_hit.set_property("resource", resource)
 
-        def _process_response():
-            for item in return_type.value:
+        def _process_response(result):
+            # type: (ClientResult[ClientValueCollection[SearchResponse]]) -> None
+            for item in result.value:
                 for hcs in item.hitsContainers:
                     [_patch_hit(hit) for hit in hcs.hits]
 

office365/sharepoint/activities/facets/delete.py

@@ -9,4 +9,4 @@ class DeleteFacet(ClientValue):
 
     @property
     def entity_type_name(self):
-        return "Microsoft.SharePoint.Activities.CreateFacet"
+        return "Microsoft.SharePoint.Activities.DeleteFacet"

office365/sharepoint/activities/tracked_item_service.py

@@ -3,15 +3,14 @@ from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.activities.tracked_item_updates_request import (
     TrackedItemUpdatesRequest,
 )
+from office365.sharepoint.client_context import ClientContext
 from office365.sharepoint.entity import Entity
 
 
 class TrackedItemService(Entity):
     @staticmethod
     def get_tracked_item_updates_for_user(context):
-        """
-        :type context: office365.sharepoint.client_context.ClientContext
-        """
+        # type: (ClientContext) -> ClientResult[str]
         return_type = ClientResult(context)
         payload = {"request": TrackedItemUpdatesRequest()}
         qry = ServiceOperationQuery(

office365/sharepoint/administration/web_application.py

@@ -1,5 +1,8 @@
+from typing import Optional
+
 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.entity import Entity
 from office365.sharepoint.entity_collection import EntityCollection
 from office365.sharepoint.sites.site import Site
@@ -8,10 +11,8 @@ from office365.sharepoint.sites.site import Site
 class WebApplication(Entity):
     @staticmethod
     def lookup(context, request_uri):
-        """
-        :type context
-        :type request_uri str
-        """
+        # type:  (ClientContext, str) -> WebApplication
+        """ """
         return_type = WebApplication(context)
         payload = {"requestUri": request_uri}
         qry = ServiceOperationQuery(
@@ -22,13 +23,13 @@ class WebApplication(Entity):
 
     @property
     def outbound_mail_sender_address(self):
-        """
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """ """
         return self.properties.get("OutboundMailSenderAddress", None)
 
     @property
     def sites(self):
+        # type: () -> EntityCollection[Site]
         return self.properties.get(
             "Sites",
             EntityCollection(

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

@@ -76,16 +76,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 +92,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/audit/audit.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.entity import Entity
 
 
@@ -8,11 +10,10 @@ class Audit(Entity):
 
     @property
     def allow_designer(self):
+        # type: () -> Optional[bool]
         """
         Specifies whether a designer can be used on this site collection.
         See Microsoft.SharePoint.Client.Web.AllowDesignerForCurrentUser, which is the scalar property used
         to determine the behavior for the current user. The default, if not disabled on the Web application, is "true".
-
-        :rtype: bool or None
         """
         return self.properties.get("AllowDesigner", None)

office365/sharepoint/changes/alert.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.changes.change import Change
 
 
@@ -6,7 +8,6 @@ class ChangeAlert(Change):
 
     @property
     def alert_id(self):
-        """Identifies the changed alert.
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Identifies the changed alert."""
         return self.properties.get("AlertId", None)

office365/sharepoint/changes/collection.py

@@ -9,15 +9,12 @@ class ChangeCollection(EntityCollection[Change]):
         super(ChangeCollection, self).__init__(context, Change, resource_path)
 
     def set_property(self, key, value, persist_changes=False):
-        self.resolve_change_type(value)
+        self._resolve_change_type(value)
         super(ChangeCollection, self).set_property(key, value)
 
-    def resolve_change_type(self, properties):
-        """
-        Resolves a change type
-
-        :type properties: dict
-        """
+    def _resolve_change_type(self, properties):
+        # type: (dict) -> None
+        """Resolves a change type"""
         from office365.sharepoint.changes.alert import ChangeAlert
         from office365.sharepoint.changes.content_type import ChangeContentType
         from office365.sharepoint.changes.field import ChangeField
@@ -27,10 +24,10 @@ class ChangeCollection(EntityCollection[Change]):
         from office365.sharepoint.changes.user import ChangeUser
         from office365.sharepoint.changes.web import ChangeWeb
 
-        if "ListId" in properties and "WebId" in properties:
-            self._item_type = ChangeList
-        elif "ItemId" in properties and "ListId" in properties:
+        if "ItemId" in properties and "ListId" in properties:
             self._item_type = ChangeItem
+        elif "ListId" in properties and "WebId" in properties:
+            self._item_type = ChangeList
         elif "WebId" in properties:
             self._item_type = ChangeWeb
         elif "UserId" in properties:

office365/sharepoint/changes/content_type.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.changes.change import Change
 
 
@@ -6,8 +8,6 @@ class ChangeContentType(Change):
 
     @property
     def content_type_id(self):
-        """Identifies the content type that has changed.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Identifies the content type that has changed."""
         return self.properties.get("ContentTypeId", None)

office365/sharepoint/changes/field.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.changes.change import Change
 
 
@@ -6,9 +8,6 @@ class ChangeField(Change):
 
     @property
     def field_id(self):
-        """ "
-        Identifies the changed field
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Identifies the changed field"""
         return self.properties.get("FieldId", None)

office365/sharepoint/changes/item.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.sharepoint.changes.change import Change
 from office365.sharepoint.contenttypes.content_type_id import ContentTypeId
@@ -9,19 +11,38 @@ class ChangeItem(Change):
 
     @property
     def activity_type(self):
-        """
-        Returns activity type defined in ChangeActivityType
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Returns activity type defined in ChangeActivityType"""
         return self.properties.get("ActivityType", None)
 
     @property
     def content_type_id(self):
-        """
-        Specifies an identifier for the content type
-        """
+        """Specifies an identifier for the content type"""
         return self.properties.get("ContentTypeId", ContentTypeId())
 
+    @property
+    def file_type(self):
+        # type: () -> Optional[str]
+        """Returns the list item’s file type."""
+        return self.properties.get("FileType", None)
+
+    @property
+    def item_id(self):
+        # type: () -> Optional[int]
+        """Identifies the changed item."""
+        return self.properties.get("ItemId", None)
+
+    @property
+    def is_recycle_bin_operation(self):
+        # type: () -> Optional[bool]
+        return self.properties.get("IsRecycleBinOperation", None)
+
+    @property
+    def server_relative_url(self):
+        # type: () -> Optional[str]
+        """Specifies the server-relative URL of the item."""
+        return self.properties.get("ServerRelativeUrl", None)
+
     @property
     def shared_by_user(self):
         """Return the sharedBy User Information in sharing action for change log."""
@@ -34,6 +55,12 @@ class ChangeItem(Change):
             "SharedWithUsers", ClientValueCollection(SharedWithUser)
         )
 
+    @property
+    def unique_id(self):
+        # type: () -> Optional[str]
+        """The Document identifier of the item."""
+        return self.properties.get("UniqueId", None)
+
     def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {

office365/sharepoint/changes/list.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.sharepoint.changes.change import Change
 
@@ -19,10 +21,8 @@ class ChangeList(Change):
 
     @property
     def list_id(self):
-        """
-        Identifies the changed list
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Identifies the changed list"""
         return self.properties.get("ListId", None)
 
     @property

office365/sharepoint/changes/user.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.changes.change import Change
 
 
@@ -6,21 +8,18 @@ class ChangeUser(Change):
 
     @property
     def activate(self):
+        # type: () -> Optional[bool]
         """
         Specifies whether a user has changed from an inactive state to an active state.
 
         When a user is added to a site and only has browse permissions, the user is in an inactive state.
         However, once the user can author list items, add documents, be assigned tasks, or make any contribution
         to the site, the user is in an active state.
-
-        :rtype: bool or None
         """
         return self.properties.get("Activate", None)
 
     @property
     def user_id(self):
-        """Uniquely identifies the changed user.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Uniquely identifies the changed user."""
         return self.properties.get("UserId", None)

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
 

office365/sharepoint/clientsidecomponent/component_context_info.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.entity import Entity
 
 
@@ -6,9 +8,8 @@ class ComponentContextInfo(Entity):
 
     @property
     def serialized_data(self):
-        """
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """"""
         return self.properties.get("SerializedData", None)
 
     @property

office365/sharepoint/contentcenter/machinelearning/enabled.py

@@ -1,12 +1,13 @@
+from typing import Optional
+
 from office365.sharepoint.entity import Entity
 
 
 class SPMachineLearningEnabled(Entity):
     @property
     def is_syntex_payg_enabled(self):
-        """
-        :rtype: bool or None
-        """
+        # type: () -> Optional[bool]
+        """ """
         return self.properties.get("IsSyntexPAYGEnabled", None)
 
     @property

office365/sharepoint/contentcenter/machinelearning/hub.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.runtime.client_result import ClientResult
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.runtime.paths.resource_path import ResourcePath
@@ -73,16 +75,14 @@ class SPMachineLearningHub(Entity):
 
     @property
     def is_default_content_center(self):
-        """
-        :rtype: bool
-        """
+        # type: () -> Optional[bool]
+        """ """
         return self.properties.get("IsDefaultContentCenter", None)
 
     @property
     def machine_learning_capture_enabled(self):
-        """
-        :rtype: bool
-        """
+        # type: () -> Optional[bool]
+        """ """
         return self.properties.get("MachineLearningCaptureEnabled", None)
 
     @property

office365/sharepoint/contentcenter/machinelearning/models/collection.py

@@ -5,7 +5,7 @@ from office365.sharepoint.contentcenter.machinelearning.models.model import (
 from office365.sharepoint.entity_collection import EntityCollection
 
 
-class SPMachineLearningModelCollection(EntityCollection):
+class SPMachineLearningModelCollection(EntityCollection[SPMachineLearningModel]):
     def __init__(self, context, resource_path=None):
         super(SPMachineLearningModelCollection, self).__init__(
             context, SPMachineLearningModel, resource_path

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):
@@ -21,10 +21,8 @@ class FieldLinkCollection(EntityCollection):
         :param str or office365.sharepoint.fields.field.Field field: Specifies the internal name of the field or type
         """
 
-        def _create_and_add_query(field_internal_name):
-            """
-            :type field_internal_name: str
-            """
+        def _add(field_internal_name):
+            # type: (str) -> None
             return_type.set_property("FieldInternalName", field_internal_name)
             qry = CreateEntityQuery(self, return_type, return_type)
             self.context.add_query(qry)
@@ -34,11 +32,11 @@ class FieldLinkCollection(EntityCollection):
         if isinstance(field, Field):
 
             def _field_loaded():
-                _create_and_add_query(field.internal_name)
+                _add(field.internal_name)
 
             field.ensure_property("InternalName", _field_loaded)
         else:
-            _create_and_add_query(field)
+            _add(field)
         return return_type
 
     def get_by_id(self, _id):