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

office365/onedrive/workbooks/ranges/format.py

@@ -1,5 +1,10 @@
+from typing import Optional
+
 from office365.entity import Entity
+from office365.entity_collection import EntityCollection
+from office365.onedrive.workbooks.ranges.border import WorkbookRangeBorder
 from office365.onedrive.workbooks.ranges.fill import WorkbookRangeFill
+from office365.onedrive.workbooks.ranges.font import WorkbookRangeFont
 from office365.onedrive.workbooks.ranges.format_protection import (
     WorkbookFormatProtection,
 )
@@ -9,6 +14,53 @@ from office365.runtime.paths.resource_path import ResourcePath
 class WorkbookRangeFormat(Entity):
     """A format object encapsulating the range's font, fill, borders, alignment, and other properties."""
 
+    @property
+    def column_width(self):
+        # type: () -> Optional[float]
+        """Gets or sets the width of all columns within the range. If the column widths aren't uniform,
+        null will be returned."""
+        return self.properties.get("columnWidth", None)
+
+    @property
+    def horizontal_alignment(self):
+        # type: () -> Optional[str]
+        """Represents the horizontal alignment for the specified object"""
+        return self.properties.get("horizontalAlignment", None)
+
+    @property
+    def row_height(self):
+        # type: () -> Optional[float]
+        """Gets or sets the height of all rows in the range. If the row heights aren't uniform null will be returned."""
+        return self.properties.get("rowHeight", None)
+
+    @property
+    def vertical_alignment(self):
+        # type: () -> Optional[str]
+        """Represents the vertical alignment for the specified object.
+        Possible values are: Top, Center, Bottom, Justify, Distributed."""
+        return self.properties.get("verticalAlignment", None)
+
+    @property
+    def wrap_text(self):
+        # type: () -> Optional[bool]
+        """Indicates if Excel wraps the text in the object.
+        A null value indicates that the entire range doesn't have uniform wrap setting
+        """
+        return self.properties.get("wrapText", None)
+
+    @property
+    def borders(self):
+        # type: () -> EntityCollection[WorkbookRangeBorder]
+        """Collection of border objects that apply to the overall range selected."""
+        return self.properties.get(
+            "borders",
+            EntityCollection(
+                self.context,
+                WorkbookRangeBorder,
+                ResourcePath("borders", self.resource_path),
+            ),
+        )
+
     @property
     def fill(self):
         """Returns the fill object defined on the overall range"""
@@ -17,6 +69,14 @@ class WorkbookRangeFormat(Entity):
             WorkbookRangeFill(self.context, ResourcePath("fill", self.resource_path)),
         )
 
+    @property
+    def font(self):
+        """Returns the font object defined on the overall range selected"""
+        return self.properties.get(
+            "font",
+            WorkbookRangeFont(self.context, ResourcePath("font", self.resource_path)),
+        )
+
     @property
     def protection(self):
         """Returns the format protection object for a range"""

office365/onedrive/workbooks/ranges/range.py

@@ -82,6 +82,18 @@ class WorkbookRange(Entity):
         """Represents the total number of columns in the range. Read-only."""
         return self.properties.get("columnCount", None)
 
+    @property
+    def column_hidden(self):
+        # type: () -> Optional[bool]
+        """Represents if all columns of the current range are hidden."""
+        return self.properties.get("columnHidden", None)
+
+    @property
+    def column_index(self):
+        # type: () -> Optional[int]
+        """Represents the column number of the first cell in the range. Zero-indexed. Read-only."""
+        return self.properties.get("columnIndex", None)
+
     @property
     def format(self):
         """Returns a format object, encapsulating the range's font, fill, borders, alignment, and other properties"""

office365/onedrive/workbooks/ranges/reference.py

@@ -3,3 +3,9 @@ from office365.runtime.client_value import ClientValue
 
 class WorkbookRangeReference(ClientValue):
     """"""
+
+    def __init__(self, address=None):
+        """
+        :param str address:
+        """
+        self.address = address

office365/onedrive/workbooks/sort_field.py

@@ -0,0 +1,26 @@
+from office365.onedrive.workbooks.icon import WorkbookIcon
+from office365.runtime.client_value import ClientValue
+
+
+class WorkbookSortField(ClientValue):
+    """Represents a condition in a sorting operation."""
+
+    def __init__(
+        self, ascending=None, color=None, dataOption=None, icon=WorkbookIcon(), key=None
+    ):
+        """
+        :param bool ascending: Represents whether the sorting is done in an ascending fashion.
+        :param str color: Represents the color that is the target of the condition if the sorting is on font
+             or cell color.
+        :param str dataOption: Represents additional sorting options for this field.
+             Possible values are: Normal, TextAsNumber.
+        :param WorkbookIcon icon: Represents the icon that is the target of the condition if the sorting
+             is on the cell's icon.
+        :param str key: Represents the column (or row, depending on the sort orientation) that the condition is on.
+              Represented as an offset from the first column (or row).
+        """
+        self.ascending = ascending
+        self.color = color
+        self.dataOption = dataOption
+        self.icon = icon
+        self.key = key

office365/onedrive/workbooks/tables/pivot_table_collection.py

@@ -0,0 +1,16 @@
+from office365.entity_collection import EntityCollection
+from office365.onedrive.workbooks.tables.pivot_table import WorkbookPivotTable
+from office365.runtime.queries.service_operation import ServiceOperationQuery
+
+
+class WorkbookPivotTableCollection(EntityCollection[WorkbookPivotTable]):
+    def __init__(self, context, resource_path=None):
+        super(WorkbookPivotTableCollection, self).__init__(
+            context, WorkbookPivotTable, resource_path
+        )
+
+    def refresh_all(self):
+        """Refreshes the PivotTable."""
+        qry = ServiceOperationQuery(self, "refreshAll")
+        self.context.add_query(qry)
+        return self

office365/onedrive/workbooks/tables/sort.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class WorkbookTableSort(Entity):
+    """Manages sorting operations on Table objects."""

office365/onedrive/workbooks/tables/table.py

@@ -8,6 +8,7 @@ from office365.onedrive.workbooks.tables.columns.collection import (
 from office365.onedrive.workbooks.tables.rows.collection import (
     WorkbookTableRowCollection,
 )
+from office365.onedrive.workbooks.tables.sort import WorkbookTableSort
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.queries.function import FunctionQuery
 from office365.runtime.queries.service_operation import ServiceOperationQuery
@@ -56,12 +57,59 @@ class WorkbookTable(Entity):
         self.context.add_query(qry)
         return self
 
+    @property
+    def highlight_first_column(self):
+        # type: () -> Optional[bool]
+        """Indicates whether the first column contains special formatting."""
+        return self.properties.get("highlightFirstColumn", None)
+
+    @property
+    def highlight_last_column(self):
+        # type: () -> Optional[bool]
+        """Indicates whether the last column contains special formatting."""
+        return self.properties.get("highlightLastColumn", None)
+
+    @property
+    def legacy_id(self):
+        # type: () -> Optional[str]
+        """Legacy Id used in older Excel clients. The value of the identifier remains the same even when the table
+        is renamed. This property should be interpreted as an opaque string value and shouldn't be parsed to any
+        other type."""
+        return self.properties.get("legacyId", None)
+
     @property
     def name(self):
         # type: () -> Optional[str]
         """Name of the table."""
         return self.properties.get("name", None)
 
+    @property
+    def show_banded_columns(self):
+        # type: () -> Optional[bool]
+        """Indicates whether the columns show banded formatting in which odd columns are highlighted differently
+        from even ones to make reading the table easier."""
+        return self.properties.get("showBandedColumns", None)
+
+    @property
+    def show_banded_rows(self):
+        # type: () -> Optional[bool]
+        """Indicates whether the rows show banded formatting in which odd rows are highlighted differently from even
+        ones to make reading the table easier."""
+        return self.properties.get("showBandedRows", None)
+
+    @property
+    def show_filter_button(self):
+        # type: () -> Optional[bool]
+        """Indicates whether the filter buttons are visible at the top of each column header. Setting this is only
+        allowed if the table contains a header row."""
+        return self.properties.get("showFilterButton", None)
+
+    @property
+    def show_headers(self):
+        # type: () -> Optional[bool]
+        """Indicates whether the header row is visible or not. This value can be set to show or remove the header row"""
+        return self.properties.get("showHeaders", None)
+
     @property
     def columns(self):
         # type: () -> WorkbookTableColumnCollection
@@ -84,6 +132,15 @@ class WorkbookTable(Entity):
             ),
         )
 
+    @property
+    def sort(self):
+        # type: () -> WorkbookTableSort
+        """Represents the sorting for the table."""
+        return self.properties.get(
+            "sort",
+            WorkbookTableSort(self.context, ResourcePath("sort", self.resource_path)),
+        )
+
     @property
     def worksheet(self):
         """The worksheet containing the current table."""

office365/onedrive/workbooks/worksheets/protection.py

@@ -1,7 +1,26 @@
 from office365.entity import Entity
+from office365.onedrive.workbooks.worksheets.protection_options import (
+    WorkbookWorksheetProtectionOptions,
+)
+from office365.runtime.queries.service_operation import ServiceOperationQuery
 
 
 class WorkbookWorksheetProtection(Entity):
     """Represents the protection of a sheet object."""
 
-    pass
+    def protect(self, options=None):
+        """Protect a worksheet. It throws if the worksheet has been protected."""
+        qry = ServiceOperationQuery(self, "protect", parameters_type=options)
+        self.context.add_query(qry)
+        return self
+
+    def unprotect(self):
+        """Unprotect a worksheet"""
+        qry = ServiceOperationQuery(self, "unprotect")
+        self.context.add_query(qry)
+        return self
+
+    @property
+    def options(self):
+        """ """
+        return self.properties.get("options", WorkbookWorksheetProtectionOptions())

office365/onedrive/workbooks/worksheets/protection_options.py

@@ -3,3 +3,13 @@ from office365.runtime.client_value import ClientValue
 
 class WorkbookWorksheetProtectionOptions(ClientValue):
     """Represents the protection of a sheet object."""
+
+    def __init__(
+        self, allowAutoFilter=None, allowDeleteColumns=None, allowDeleteRows=None
+    ):
+        """
+        :param bool allowAutoFilter:
+        """
+        self.allowAutoFilter = allowAutoFilter
+        self.allowDeleteColumns = allowDeleteColumns
+        self.allowDeleteRows = allowDeleteRows

office365/onedrive/workbooks/worksheets/worksheet.py

@@ -6,7 +6,9 @@ from office365.onedrive.workbooks.charts.chart import WorkbookChart
 from office365.onedrive.workbooks.names.named_item import WorkbookNamedItem
 from office365.onedrive.workbooks.ranges.range import WorkbookRange
 from office365.onedrive.workbooks.tables.collection import WorkbookTableCollection
-from office365.onedrive.workbooks.tables.pivot_table import WorkbookPivotTable
+from office365.onedrive.workbooks.tables.pivot_table_collection import (
+    WorkbookPivotTableCollection,
+)
 from office365.onedrive.workbooks.worksheets.protection import (
     WorkbookWorksheetProtection,
 )
@@ -94,13 +96,12 @@ class WorkbookWorksheet(Entity):
 
     @property
     def pivot_tables(self):
-        # type: () -> EntityCollection[WorkbookPivotTable]
+        # type: () -> WorkbookPivotTableCollection
         """Collection of PivotTables that are part of the worksheet."""
         return self.properties.get(
             "pivotTables",
-            EntityCollection(
+            WorkbookPivotTableCollection(
                 self.context,
-                WorkbookPivotTable,
                 ResourcePath("pivotTables", self.resource_path),
             ),
         )

office365/outlook/calendar/calendar.py

@@ -135,9 +135,7 @@ class Calendar(Entity):
     @property
     def name(self):
         # type: () -> Optional[str]
-        """
-        The calendar name
-        """
+        """The calendar name"""
         return self.properties.get("name", None)
 
     @property

office365/outlook/calendar/events/event.py

@@ -8,6 +8,7 @@ from office365.directory.extensions.extension import Extension
 from office365.entity_collection import EntityCollection
 from office365.outlook.calendar.attendees.attendee import Attendee
 from office365.outlook.calendar.dateTimeTimeZone import DateTimeTimeZone
+from office365.outlook.calendar.response_status import ResponseStatus
 from office365.outlook.item import OutlookItem
 from office365.outlook.mail.attachments.collection import AttachmentCollection
 from office365.outlook.mail.item_body import ItemBody
@@ -195,6 +196,30 @@ class Event(OutlookItem):
         """The preview of the message associated with the event. It is in text format."""
         return self.properties.get("bodyPreview", None)
 
+    @property
+    def reminder_minutes_before_start(self):
+        # type: () -> Optional[int]
+        """The number of minutes before the event start time that the reminder alert occurs."""
+        return self.properties.get("reminderMinutesBeforeStart", None)
+
+    @property
+    def response_requested(self):
+        # type: () -> Optional[bool]
+        """Default is true, which represents the organizer would like an invitee to send a response to the event."""
+        return self.properties.get("responseRequested", None)
+
+    @property
+    def response_status(self):
+        # type: () -> Optional[str]
+        """Indicates the type of response sent in response to an event message."""
+        return self.properties.get("responseStatus", ResponseStatus())
+
+    @property
+    def series_master_id(self):
+        # type: () -> Optional[str]
+        """The ID for the recurring series master item, if this event is part of a recurring series."""
+        return self.properties.get("seriesMasterId", None)
+
     @property
     def subject(self):
         # type: () -> Optional[str]
@@ -212,6 +237,26 @@ class Event(OutlookItem):
         """The location of the event."""
         return self.properties.get("location", Location())
 
+    @property
+    def transaction_id(self):
+        # type: () -> Optional[str]
+        """
+        A custom identifier specified by a client app for the server to avoid redundant POST operations in case of
+        client retries to create the same event. This is useful when low network connectivity causes the client to
+        time out before receiving a response from the server for the client's prior create-event request.
+        After you set transactionId when creating an event, you cannot change transactionId in a subsequent update.
+        This property is only returned in a response payload if an app has set it
+        """
+        return self.properties.get("transactionId", None)
+
+    @property
+    def type(self):
+        # type: () -> Optional[str]
+        """
+        The event type. Possible values are: singleInstance, occurrence, exception, seriesMaster
+        """
+        return self.properties.get("type", None)
+
     @property
     def web_link(self):
         # type: () -> Optional[str]

office365/outlook/calendar/response_status.py

@@ -0,0 +1,11 @@
+from office365.runtime.client_value import ClientValue
+
+
+class ResponseStatus(ClientValue):
+    """Represents the response status of an attendee or organizer for a meeting request."""
+
+    def __init__(self, response=None):
+        """
+        :type response: str
+        """
+        self.response = response

office365/outlook/calendar/rooms/room.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.outlook.calendar.place import Place
 
 
@@ -6,3 +8,15 @@ class Room(Place):
     Represents a room in a tenant.
     In Exchange Online, each room is associated with a room mailbox. Derived from place.
     """
+
+    @property
+    def audio_device_name(self):
+        # type: () -> Optional[str]
+        """Specifies the name of the audio device in the room."""
+        return self.properties.get("audioDeviceName", None)
+
+    @property
+    def building(self):
+        # type: () -> Optional[str]
+        """Specifies the building name or building number that the room is in."""
+        return self.properties.get("building", None)

office365/outlook/mail/automatic_replies_mailtips.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class AutomaticRepliesMailTips(ClientValue):
+    """MailTips about any automatic replies that have been set up on a mailbox."""

office365/outlook/mail/conversation.py

@@ -49,9 +49,7 @@ class Conversation(Entity):
 
     @property
     def unique_senders(self):
-        """
-        All the users that sent a message to this Conversation.
-        """
+        """All the users that sent a message to this Conversation."""
         return self.properties.get("uniqueSenders", StringCollection())
 
     @property

office365/outlook/mail/folders/folder.py

@@ -86,9 +86,7 @@ class MailFolder(Entity):
     @property
     def parent_folder_id(self):
         # type: () -> Optional[str]
-        """
-        The unique identifier for the mailFolder's parent mailFolder.
-        """
+        """The unique identifier for the mailFolder's parent mailFolder."""
         return self.properties.get("parentFolderId", None)
 
     @property

office365/outlook/mail/tips.py

@@ -0,0 +1,17 @@
+from office365.outlook.mail.automatic_replies_mailtips import AutomaticRepliesMailTips
+from office365.runtime.client_value import ClientValue
+
+
+class MailTips(ClientValue):
+    """Informative messages about a recipient, that are displayed to users while they're composing a message.
+    For example, an out-of-office message as an automatic reply for a message recipient.
+    """
+
+    def __init__(self, automaticReplies=AutomaticRepliesMailTips(), customMailTip=None):
+        """
+        :param AutomaticRepliesMailTips automaticReplies: Mail tips for automatic reply if it has been set up by
+            the recipient.
+        :param str customMailTip: A custom mail tip that can be set on the recipient's mailbox.
+        """
+        self.automaticReplies = automaticReplies
+        self.customMailTip = customMailTip

office365/planner/plans/plan.py

@@ -7,6 +7,7 @@ from office365.planner.buckets.bucket import PlannerBucket
 from office365.planner.plans.container import PlannerPlanContainer
 from office365.planner.plans.details import PlannerPlanDetails
 from office365.planner.tasks.task import PlannerTask
+from office365.runtime.http.request_options import RequestOptions
 from office365.runtime.paths.resource_path import ResourcePath
 
 
@@ -18,11 +19,20 @@ class PlannerPlan(Entity):
     """
 
     def __str__(self):
-        return self.title
+        return self.title or self.entity_type_name
 
     def __repr__(self):
         return self.id or self.entity_type_name
 
+    def delete_object(self):
+        def _construct_request(request):
+            # type: (RequestOptions) -> None
+            request.set_header("If-Match", self.properties.get("__etag"))
+
+        return (
+            super(PlannerPlan, self).delete_object().before_execute(_construct_request)
+        )
+
     @property
     def container(self):
         """Identity of the user, device, or application which created the plan."""

office365/reports/root.py

@@ -11,6 +11,17 @@ from office365.runtime.queries.function import FunctionQuery
 class ReportRoot(Entity):
     """Represents a container for Azure Active Directory (Azure AD) reporting resources."""
 
+    def device_configuration_device_activity(self):
+        """
+        Metadata for the device configuration device activity report
+        """
+        return_type = ClientResult(self.context, Report())
+        qry = FunctionQuery(
+            self, "deviceConfigurationDeviceActivity", None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
     def device_configuration_user_activity(self):
         """
         Metadata for the device configuration user activity report
@@ -20,6 +31,15 @@ class ReportRoot(Entity):
         self.context.add_query(qry)
         return return_type
 
+    def managed_device_enrollment_failure_details(self):
+        """ """
+        return_type = ClientResult(self.context, Report())
+        qry = FunctionQuery(
+            self, "managedDeviceEnrollmentFailureDetails", None, return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
     def managed_device_enrollment_top_failures(self, period=None):
         """
         Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.
@@ -188,6 +208,19 @@ class ReportRoot(Entity):
         self.context.add_query(qry)
         return qry.return_type
 
+    def get_mailbox_usage_quota_status_mailbox_counts(self, period):
+        """
+
+        :param str period: Specifies the length of time over which the report is aggregated.
+            The supported values for {period_value} are: D7, D30, D90, and D180. These values follow the format
+            Dn where n represents the number of days over which the report is aggregated. Required.
+        """
+        qry = create_report_query(
+            self, "getMailboxUsageQuotaStatusMailboxCounts", period
+        )
+        self.context.add_query(qry)
+        return qry.return_type
+
     def get_sharepoint_activity_pages(self, period):
         """
         Get the number of unique pages visited by users.

office365/runtime/auth/authentication_context.py

@@ -47,6 +47,7 @@ class AuthenticationContext(object):
         cert_path=None,
         private_key=None,
         scopes=None,
+        passphrase=None,
     ):
         """Initializes a client to acquire a token via certificate credentials
 
@@ -56,6 +57,7 @@ class AuthenticationContext(object):
         :param str or None cert_path: Path to A PEM encoded certificate private key.
         :param str or None private_key: A PEM encoded certificate private key.
         :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
         """
         if scopes is None:
             resource = get_absolute_url(self.url)
@@ -70,7 +72,11 @@ class AuthenticationContext(object):
 
         def _acquire_token():
             authority_url = "https://login.microsoftonline.com/{0}".format(tenant)
-            credentials = {"thumbprint": thumbprint, "private_key": private_key}
+            credentials = {
+                "thumbprint": thumbprint,
+                "private_key": private_key,
+                "passphrase": passphrase,
+            }
             import msal
 
             app = msal.ConfidentialClientApplication(
@@ -187,7 +193,11 @@ class AuthenticationContext(object):
                 browser_mode = kwargs.get("browser_mode", False)
                 environment = kwargs.get("environment")
                 provider = SamlTokenProvider(
-                    self.url, credentials.userName, credentials.password, browser_mode, environment
+                    self.url,
+                    credentials.userName,
+                    credentials.password,
+                    browser_mode,
+                    environment,
                 )
         else:
             raise ValueError("Unknown credential type")

office365/runtime/odata/json_format.py

@@ -4,9 +4,10 @@ from abc import ABCMeta
 class ODataJsonFormat(object):
     """OData JSON format"""
 
-    def __init__(self, metadata_level=None):
-        # type: (str) -> None
+    def __init__(self, metadata_level=None, etag=None):
+        # type: (str, str) -> None
         self.metadata_level = metadata_level
+        self.etag = etag
 
     __metaclass__ = ABCMeta
 

office365/runtime/odata/request.py

@@ -25,7 +25,7 @@ class ODataRequest(ClientRequest):
         """Creates OData request"""
         super(ODataRequest, self).__init__()
         self._default_json_format = json_format
-        self.beforeExecute += self._ensure_json_format
+        self.beforeExecute += self._ensure_http_headers
 
     @property
     def json_format(self):
@@ -111,6 +111,8 @@ class ODataRequest(ClientRequest):
                                 k: v for k, v in self._next_property(value, json_format)
                             }
                         yield name, value
+                    elif name == "@odata.etag":
+                        yield "__etag", value
             else:
                 yield "__value", json
         elif json is not None:
@@ -142,8 +144,16 @@ class ODataRequest(ClientRequest):
             json = {query.parameters_name: json}
         return json
 
-    def _ensure_json_format(self, request):
+    def _ensure_http_headers(self, request):
         # type: (RequestOptions) -> None
+        """
+        Ensures that HTTP Header Fields are specified in the OData request, namely:
+           - The Content-Type header
+           - Accept request-header field
+           - The If-Match request-header field (optional)
+        """
         media_type = self.json_format.media_type
         request.ensure_header("Content-Type", media_type)
         request.ensure_header("Accept", media_type)
+        if self.json_format.etag is not None:
+            request.ensure_header("If-Match", self.json_format.etag)

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