Office365-REST-Python-Client 2.5.2__py3-none-any.whl → 2.5.3__py3-none-any.whl

office365/onedrive/termstore/groups/group.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.entity import Entity
 from office365.onedrive.termstore.sets.collection import SetCollection
 from office365.runtime.paths.resource_path import ResourcePath
@@ -6,18 +8,24 @@ from office365.runtime.paths.resource_path import ResourcePath
 class Group(Entity):
     """Term Group"""
 
+    def __str__(self):
+        return self.display_name
+
     @property
     def display_name(self):
+        # type: () -> Optional[str]
         """Name of the group."""
         return self.properties.get("displayName", None)
 
     @property
     def parent_site_id(self):
+        # type: () -> Optional[str]
         """ID of the parent site of this group."""
         return self.properties.get("parentSiteId", None)
 
     @property
     def sets(self):
+        # type: () -> SetCollection
         """Collection of all sets available in the term store."""
         return self.properties.get(
             "sets",

office365/onedrive/termstore/sets/collection.py

@@ -14,12 +14,8 @@ class SetCollection(EntityCollection[Set]):
         self._parent_group = parent_group
 
     def get_by_name(self, name):
-        """
-        Returns the TermSet specified by its name.
-
-        :param str name: Term set name
-        :rtype: Set
-        """
+        # type: (str) -> Set
+        """Returns the TermSet specified by its name."""
         return self.single("displayName eq '{0}'".format(name))
 
     def add(self, name, parent_group=None):

office365/onedrive/termstore/sets/name.py

@@ -1,3 +1,5 @@
+import json
+
 from office365.runtime.client_value import ClientValue
 
 
@@ -15,3 +17,6 @@ class LocalizedName(ClientValue):
         super(LocalizedName, self).__init__()
         self.name = name
         self.languageTag = language_tag
+
+    def __repr__(self):
+        return json.dumps(self.to_json())

office365/onedrive/termstore/sets/set.py

@@ -14,8 +14,12 @@ class Set(Entity):
     terms. A group can contain multiple sets.
     """
 
+    def __repr__(self):
+        return repr(self.localized_names)
+
     @property
     def children(self):
+        # type: () -> TermCollection
         """Children terms of set in term store."""
         return self.properties.get(
             "children",
@@ -28,6 +32,7 @@ class Set(Entity):
 
     @property
     def localized_names(self):
+        # type: () -> ClientValueCollection[LocalizedName]
         """"""
         return self.properties.get(
             "localizedNames", ClientValueCollection(LocalizedName)
@@ -45,6 +50,7 @@ class Set(Entity):
 
     @property
     def relations(self):
+        # type: () -> EntityCollection[Relation]
         """Indicates which terms have been pinned or reused directly under the set."""
         return self.properties.get(
             "relations",
@@ -55,6 +61,7 @@ class Set(Entity):
 
     @property
     def terms(self):
+        # type: () -> TermCollection
         """All the terms under the set."""
         return self.properties.get(
             "terms",

office365/onedrive/termstore/store.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.entity import Entity
 from office365.entity_collection import EntityCollection
 from office365.onedrive.termstore.groups.collection import GroupCollection
@@ -15,17 +17,13 @@ class Store(Entity):
         """Returns a collection containing a flat list of all TermSet objects."""
         return_type = EntityCollection(self.context, Set)
 
-        def _sets_loaded(group_sets):
-            """
-            :type group_sets: EntityCollection
-            """
-            [return_type.add_child(s) for s in group_sets]
+        def _sets_loaded(sets):
+            # type: (SetCollection) -> None
+            [return_type.add_child(s) for s in sets]
 
         def _groups_loaded(groups):
-            """
-            :type groups: EntityCollection
-            """
-            for g in groups:  # type: Group
+            # type: (GroupCollection) -> None
+            for g in groups:
                 self.context.load(g.sets, after_loaded=_sets_loaded)
 
         self.context.load(self.groups, after_loaded=_groups_loaded)
@@ -34,10 +32,8 @@ class Store(Entity):
 
     @property
     def default_language_tag(self):
-        """Default language of the term store.
-
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """Default language of the term store."""
         return self.properties.get("defaultLanguageTag", None)
 
     @property
@@ -47,6 +43,7 @@ class Store(Entity):
 
     @property
     def groups(self):
+        # type: () -> GroupCollection
         """Collection of all groups available in the term store."""
         return self.properties.get(
             "groups",

office365/onedrive/versions/drive_item.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.onedrive.versions.base_item import BaseItemVersion
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 
@@ -23,8 +25,8 @@ class DriveItemVersion(BaseItemVersion):
 
     @property
     def size(self):
+        # type: () -> Optional[int]
         """
         Indicates the size of the content stream for this version of the item.
-        :rtype: int
         """
         return self.properties.get("size", None)

office365/onedrive/workbooks/ranges/range.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.entity import Entity
 from office365.onedrive.workbooks.ranges.format import WorkbookRangeFormat
 from office365.onedrive.workbooks.ranges.sort import WorkbookRangeSort
@@ -18,35 +20,29 @@ class WorkbookRange(Entity):
 
     @property
     def address(self):
+        # type: () -> Optional[str]
         """
         Represents the range reference in A1-style. Address value will contain the Sheet reference
         (e.g. Sheet1!A1:B4)
-        :rtype: str or None
         """
         return self.properties.get("address", None)
 
     @property
     def address_local(self):
-        """
-        Represents range reference for the specified range in the language of the user. Read-only.
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Represents range reference for the specified range in the language of the user."""
         return self.properties.get("addressLocal", None)
 
     @property
     def cell_count(self):
-        """
-        Number of cells in the range. Read-only.
-        :rtype: int or None
-        """
+        # type: () -> Optional[int]
+        """Number of cells in the range. Read-only."""
         return self.properties.get("cellCount", None)
 
     @property
     def column_count(self):
-        """
-        Represents the total number of columns in the range. Read-only.
-        :rtype: int or None
-        """
+        # type: () -> Optional[int]
+        """Represents the total number of columns in the range. Read-only."""
         return self.properties.get("columnCount", None)
 
     @property

office365/onedrive/workbooks/ranges/view.py

@@ -8,6 +8,7 @@ class WorkbookRangeView(Entity):
 
     @property
     def rows(self):
+        # type: () -> EntityCollection[WorkbookRangeView]
         """Represents a collection of range views associated with the range."""
         return self.properties.get(
             "rows",

office365/onedrive/workbooks/tables/table.py

@@ -71,9 +71,7 @@ class WorkbookTable(Entity):
     @property
     def rows(self):
         # type: () -> WorkbookTableRowCollection
-        """
-        Represents a collection of all the rows in the table.
-        """
+        """Represents a collection of all the rows in the table."""
         return self.properties.get(
             "rows",
             WorkbookTableRowCollection(

office365/onedrive/workbooks/worksheets/worksheet.py

@@ -20,8 +20,12 @@ class WorkbookWorksheet(Entity):
     def __repr__(self):
         return self.name
 
+    def __str__(self):
+        return self.name
+
     @property
     def charts(self):
+        # type: () -> EntityCollection[WorkbookChart]
         """Returns collection of charts that are part of the worksheet"""
         return self.properties.get(
             "charts",
@@ -33,9 +37,7 @@ class WorkbookWorksheet(Entity):
     @property
     def name(self):
         # type: () -> Optional[str]
-        """
-        The display name of the worksheet.
-        """
+        """The display name of the worksheet."""
         return self.properties.get("name", None)
 
     @property

office365/onenote/pages/collection.py

@@ -1,3 +1,5 @@
+from typing import IO
+
 from office365.entity_collection import EntityCollection
 from office365.onenote.internal.multipart_page_query import OneNotePageCreateQuery
 from office365.onenote.pages.page import OnenotePage
@@ -10,12 +12,11 @@ class OnenotePageCollection(EntityCollection[OnenotePage]):
         super(OnenotePageCollection, self).__init__(context, OnenotePage, resource_path)
 
     def add(self, presentation_file, attachment_files=None):
+        # type: (IO, dict) -> OnenotePage
         """
         Create a new OneNote page.
-
         :param typing.IO presentation_file: Presentation file
         :param dict or None attachment_files: Attachment files
-        :rtype: OnenotePage
         """
         qry = OneNotePageCreateQuery(self, presentation_file, attachment_files)
         self.context.add_query(qry)

office365/onenote/resources/resource.py

@@ -1,3 +1,5 @@
+from typing import AnyStr, Optional
+
 from office365.onenote.entity_base_model import OnenoteEntityBaseModel
 from office365.runtime.client_result import ClientResult
 from office365.runtime.queries.function import FunctionQuery
@@ -7,6 +9,7 @@ class OnenoteResource(OnenoteEntityBaseModel):
     """An image or other file resource on a OneNote page."""
 
     def get_content(self):
+        # type: () -> ClientResult[AnyStr]
         """Retrieve the binary data of a file or image resource object."""
         return_type = ClientResult(self.context)
         qry = FunctionQuery(self, "content", None, return_type)
@@ -15,8 +18,6 @@ class OnenoteResource(OnenoteEntityBaseModel):
 
     @property
     def content_url(self):
-        """The URL for downloading the content
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """The URL for downloading the content"""
         return self.properties.get("contentUrl", None)

office365/onenote/sectiongroups/section_group.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.entity_collection import EntityCollection
 from office365.onenote.entity_hierarchy_model import OnenoteEntityHierarchyModel
 from office365.onenote.notebooks.notebook import Notebook
@@ -10,22 +12,21 @@ class SectionGroup(OnenoteEntityHierarchyModel):
 
     @property
     def section_groups_url(self):
-        """The URL for the sectionGroups navigation property, which returns all the section groups in the section group.
-
-        :rtype: str or None
+        # type: () -> Optional[str]
+        """
+        The URL for the sectionGroups navigation property, which returns all the section groups in the section group.
         """
         return self.properties.get("sectionGroupsUrl", None)
 
     @property
     def sections_url(self):
-        """The URL for the sections navigation property, which returns all the sections in the section group.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """The URL for the sections navigation property, which returns all the sections in the section group."""
         return self.properties.get("sectionsUrl", None)
 
     @property
     def parent_notebook(self):
+        # type: () -> Notebook
         """The notebook that contains the section group. Read-only."""
         return self.properties.get(
             "parentNotebook",
@@ -34,6 +35,7 @@ class SectionGroup(OnenoteEntityHierarchyModel):
 
     @property
     def sections(self):
+        # type: () -> EntityCollection[OnenoteSection]
         """The sections in the section group. Read-only. Nullable."""
         return self.properties.get(
             "sections",
@@ -46,6 +48,7 @@ class SectionGroup(OnenoteEntityHierarchyModel):
 
     @property
     def section_groups(self):
+        # type: () -> EntityCollection[SectionGroup]
         """Retrieve a list of onenoteSection objects from the specified notebook."""
         return self.properties.get(
             "sectionGroups",

office365/outlook/calendar/calendar.py

@@ -28,7 +28,7 @@ class Calendar(Entity):
     """
 
     def __repr__(self):
-        return self.name
+        return self.name or self.id or self.entity_type_name
 
     def allowed_calendar_sharing_roles(self, user):
         """

office365/outlook/calendar/schedule/information.py

@@ -17,7 +17,6 @@ class ScheduleInformation(ClientValue):
         working_hours=WorkingHours(),
     ):
         """
-
         :param WorkingHours working_hours: The days of the week and hours in a specific time zone that the user works.
              These are set as part of the user's mailboxSettings.
         :param str error: Error information from attempting to get the availability of the user, distribution list,

office365/outlook/contacts/contact.py

@@ -45,25 +45,19 @@ class Contact(OutlookItem):
     @manager.setter
     def manager(self, value):
         # type: (str) -> None
-        """
-        Sets name of the contact's manager.
-        """
+        """Sets name of the contact's manager."""
         self.set_property("manager", value)
 
     @property
     def mobile_phone(self):
         # type: () -> Optional[str]
-        """
-        The contact's mobile phone number.
-        """
+        """The contact's mobile phone number."""
         return self.properties.get("mobilePhone", None)
 
     @mobile_phone.setter
     def mobile_phone(self, value):
         # type: (str) -> None
-        """
-        Sets contact's mobile phone number.
-        """
+        """Sets contact's mobile phone number."""
         self.set_property("mobilePhone", value)
 
     @property

office365/outlook/contacts/folder.py

@@ -24,6 +24,7 @@ class ContactFolder(Entity):
 
     @property
     def child_folders(self):
+        # type: () -> EntityCollection["ContactFolder"]
         """The collection of child folders in the folder. Navigation property. Read-only. Nullable."""
         return self.properties.get(
             "childFolders",
@@ -36,6 +37,7 @@ class ContactFolder(Entity):
 
     @property
     def multi_value_extended_properties(self):
+        # type: () -> EntityCollection[MultiValueLegacyExtendedProperty]
         """The collection of multi-value extended properties defined for the Contact folder."""
         return self.properties.get(
             "multiValueExtendedProperties",
@@ -48,6 +50,7 @@ class ContactFolder(Entity):
 
     @property
     def single_value_extended_properties(self):
+        # type: () -> EntityCollection[SingleValueLegacyExtendedProperty]
         """The collection of single-value extended properties defined for the Contact folder."""
         return self.properties.get(
             "singleValueExtendedProperties",

office365/outlook/mail/messages/message.py

@@ -174,17 +174,30 @@ class Message(OutlookItem):
         self.context.add_query(qry)
         return self
 
-    def move(self, destination_id):
+    def move(self, destination):
         """
         Move a message to another folder within the specified user's mailbox.
         This creates a new copy of the message in the destination folder and removes the original message.
 
-        :param str destination_id: The destination folder ID, or a well-known folder name.
+        :param str or MailFolder destination: The destination folder ID, or a well-known folder name.
             For a list of supported well-known folder names, see mailFolder resource type.
         """
-        payload = {"DestinationId": destination_id}
-        qry = ServiceOperationQuery(self, "move", None, payload, None, None)
-        self.context.add_query(qry)
+        from office365.outlook.mail.folders.folder import MailFolder
+
+        def _move(destination_id):
+            # type: (str) -> None
+            payload = {"DestinationId": destination_id}
+            qry = ServiceOperationQuery(self, "move", None, payload, None, None)
+            self.context.add_query(qry)
+
+        if isinstance(destination, MailFolder):
+
+            def _loaded():
+                _move(destination.id)
+
+            destination.ensure_property("id", _loaded)
+        else:
+            _move(destination)
         return self
 
     def forward(self, to_recipients, comment=""):
@@ -205,13 +218,12 @@ class Message(OutlookItem):
 
     @property
     def has_attachments(self):
+        # type: () -> Optional[bool]
         """
         Indicates whether the message has attachments. This property doesn't include inline attachments,
         so if a message contains only inline attachments, this property is false. To verify the existence
         of inline attachments, parse the body property to look for a src attribute,
         such as <IMG src="cid:image001.jpg@01D26CD8.6C05F070">.
-
-        :rtype: bool or None
         """
         return self.properties.get("hasAttachments", None)
 
@@ -229,6 +241,7 @@ class Message(OutlookItem):
 
     @property
     def extensions(self):
+        # type: () -> EntityCollection[Extension]
         """The collection of open extensions defined for the message. Nullable."""
         return self.properties.get(
             "extensions",
@@ -253,24 +266,19 @@ class Message(OutlookItem):
     @property
     def body_preview(self):
         # type: () -> Optional[str]
-        """
-        The first 255 characters of the message body. It is in text format."""
+        """The first 255 characters of the message body. It is in text format."""
         return self.properties.get("bodyPreview", None)
 
     @property
     def conversation_id(self):
         # type: () -> Optional[str]
-        """
-        The ID of the conversation the email belongs to.
-        """
+        """The ID of the conversation the email belongs to."""
         return self.properties.get("conversationId", None)
 
     @property
     def conversation_index(self):
         # type: () -> Optional[str]
-        """
-        Indicates the position of the message within the conversation.
-        """
+        """Indicates the position of the message within the conversation."""
         return self.properties.get("conversationIndex", None)
 
     @property
@@ -292,9 +300,7 @@ class Message(OutlookItem):
     @property
     def importance(self):
         # type: () -> Optional[str]
-        """
-        The importance of the message.
-        """
+        """The importance of the message."""
         return self.properties.get("importance", None)
 
     @property
@@ -308,6 +314,7 @@ class Message(OutlookItem):
 
     @property
     def internet_message_headers(self):
+        # type: () -> ClientValueCollection[InternetMessageHeader]
         """
         A collection of message headers defined by RFC5322. The set includes message headers indicating the network
         path taken by a message from the sender to the recipient. It can also contain custom message headers that

office365/outlook/mail/recipient.py

@@ -5,10 +5,12 @@ from office365.runtime.client_value import ClientValue
 class Recipient(ClientValue):
     """Represents information about a user in the sending or receiving end of an event, message or group post."""
 
-    def __init__(self, email_address=EmailAddress()):
+    def __init__(self, email_address=None):
         """
         :param EmailAddress email_address: The recipient's email address.
         """
+        if email_address is None:
+            email_address = EmailAddress()
         super(Recipient, self).__init__()
         self.emailAddress = email_address
 

office365/runtime/auth/authentication_context.py

@@ -1,8 +1,8 @@
 import json
 import sys
-from typing import Any, Callable, TypedDict
+from typing import Any, Callable
 
-from typing_extensions import Required
+from typing_extensions import Required, TypedDict
 
 from office365.runtime.auth.client_credential import ClientCredential
 from office365.runtime.auth.providers.acs_token_provider import ACSTokenProvider

office365/runtime/auth/providers/acs_token_provider.py

@@ -1,9 +1,12 @@
+from typing import Optional
+
 import requests
 
 import office365.logger
 from office365.runtime.auth.authentication_provider import AuthenticationProvider
 from office365.runtime.auth.token_response import TokenResponse
 from office365.runtime.compat import urlparse
+from office365.runtime.http.request_options import RequestOptions
 
 
 class ACSTokenProvider(AuthenticationProvider, office365.logger.LoggerContext):
@@ -24,9 +27,7 @@ class ACSTokenProvider(AuthenticationProvider, office365.logger.LoggerContext):
         self._cached_token = None
 
     def authenticate_request(self, request):
-        """
-        :type request: office365.runtime.http.request_options.RequestOptions
-        """
+        # type: (RequestOptions) -> None
         self.ensure_app_only_access_token()
         request.set_header("Authorization", self._get_authorization_header())
 
@@ -36,9 +37,7 @@ class ACSTokenProvider(AuthenticationProvider, office365.logger.LoggerContext):
         return self._cached_token and self._cached_token.is_valid
 
     def get_app_only_access_token(self):
-        """
-        Retrieves an app-only access token from ACS
-        """
+        """Retrieves an app-only access token from ACS"""
         try:
             realm = self._get_realm_from_target_url()
             url_info = urlparse(self.url)
@@ -86,9 +85,7 @@ class ACSTokenProvider(AuthenticationProvider, office365.logger.LoggerContext):
 
     @staticmethod
     def process_realm_response(response):
-        """
-        :type response: requests.Response
-        """
+        # type: (requests.Response) -> Optional[str]
         header_key = "WWW-Authenticate"
         if header_key in response.headers:
             auth_values = response.headers[header_key].split(",")
@@ -98,6 +95,7 @@ class ACSTokenProvider(AuthenticationProvider, office365.logger.LoggerContext):
 
     @staticmethod
     def get_formatted_principal(principal_name, host_name, realm):
+        # type: (str, Optional[str], str) -> str
         if host_name:
             return "{0}/{1}@{2}".format(principal_name, host_name, realm)
         return "{0}@{1}".format(principal_name, realm)

office365/runtime/client_object.py

@@ -90,7 +90,6 @@ class ClientObject(Generic[T]):
     def is_property_available(self, name):
         # type: (str) -> bool
         """Returns a Boolean value that indicates whether the specified property has been retrieved or set.
-
         :param str name: A property name
         """
         if name in self.properties:
@@ -116,7 +115,7 @@ class ClientObject(Generic[T]):
 
     def remove_from_parent_collection(self):
         if self._parent_collection is None:
-            return
+            return self
         self._parent_collection.remove_child(self)
         return self
 
@@ -174,19 +173,12 @@ class ClientObject(Generic[T]):
 
     def ensure_property(self, name, action, *args, **kwargs):
         # type: (str, Callable[[], None], Any, Any) -> Self
-        """
-        Ensures if property is loaded
-
-        :type action: () -> None
-        :type name: str
-        """
+        """Ensures if property is loaded"""
         return self.ensure_properties([name], action, *args, **kwargs)
 
     def ensure_properties(self, names, action, *args, **kwargs):
         # type: (List[str], Callable[[Any, Any], None], Any, Any) -> Self
-        """
-        Ensure if list of properties are retrieved from the server
-        """
+        """Ensure if list of properties are retrieved from the server"""
         if self.property_ref_name is not None and self.property_ref_name not in names:
             names.append(self.property_ref_name)