Office365-REST-Python-Client 2.5.13__py3-none-any.whl → 2.6.0__py3-none-any.whl

office365/graph_request.py

@@ -1,30 +1,89 @@
+from typing import Callable, Optional
+
+from office365.azure_env import AzureEnvironment
+from office365.runtime.auth.entra.authentication_context import AuthenticationContext
+from office365.runtime.http.request_options import RequestOptions
 from office365.runtime.odata.request import ODataRequest
 from office365.runtime.odata.v4.json_format import V4JsonFormat
 
-environments_endpoints = {
-    "GCCH": {
-        "graph_url": "https://graph.microsoft.com",
-        "entra_url": "https://login.microsoftonline.com",
-    },
-    "GCC High": {
-        "graph_url": "https://graph.microsoft.us",
-        "entra_url": "https://login.microsoftonline.us",
-    },
-    "DoD": {
-        "graph_url": "https://dod-graph.microsoft.us",
-        "entra_url": "https://login.chinacloudapi.cn",
-    },
-}
-
 
 class GraphRequest(ODataRequest):
-    def __init__(self, version="v1.0", environment="GCCH"):
-        # type: (str, str) -> None
+    def __init__(
+        self, version="v1.0", tenant=None, environment=AzureEnvironment.Global
+    ):
+        # type: (str, str, str) -> None
         super(GraphRequest, self).__init__(V4JsonFormat())
         self._version = version
-        self._environment_endpoints = environments_endpoints.get(environment, None)
+        self._environment = environment
+        self._auth_context = AuthenticationContext(
+            environment=environment, tenant=tenant
+        )
+        self.beforeExecute += self.authenticate_request
+
+    def with_access_token(self, token_callback):
+        # type: (Callable[[], dict]) -> "GraphRequest"
+        """
+        Initializes the confidential client with token callback.
+        """
+        self._auth_context.with_access_token(token_callback)
+        return self
+
+    def with_certificate(self, client_id, thumbprint, private_key):
+        # type: (str, str, str) -> "GraphRequest"
+        """
+        Initializes the confidential client with client certificate
+
+        :param str client_id: The OAuth client id of the calling application.
+        :param str thumbprint: Thumbprint
+        :param str private_key: Private key
+        """
+        self._auth_context.with_certificate(client_id, thumbprint, private_key)
+        return self
+
+    def with_client_secret(self, client_id, client_secret):
+        # type: (str, str) -> "GraphRequest"
+        """
+        Initializes the confidential client with client secret
+
+        :param str client_id: The OAuth client id of the calling application.
+        :param str client_secret: Client secret
+        """
+        self._auth_context.with_client_secret(client_id, client_secret)
+        return self
+
+    def with_token_interactive(self, client_id, username=None):
+        # type: (str, Optional[str]) -> "GraphRequest"
+        """
+        Initializes the client via user credentials
+        Note: only works if your app is registered with redirect_uri as http://localhost
+
+
+        :param str client_id: The OAuth client id of the calling application.
+        :param str username: Typically a UPN in the form of an email address.
+        """
+        self._auth_context.with_token_interactive(client_id, username)
+        return self
+
+    def with_username_and_password(self, client_id, username, password):
+        # type: (str, str, str) -> "GraphRequest"
+        """
+        Initializes the client via user credentials
+        :param str client_id: The OAuth client id of the calling application.
+        :param str username: Typically a UPN in the form of an email address.
+        :param str password: The password.
+        """
+        self._auth_context.with_username_and_password(client_id, username, password)
+        return self
+
+    def authenticate_request(self, request):
+        # type: (RequestOptions) -> None
+        """Authenticate request"""
+        token = self._auth_context.acquire_token()
+        request.ensure_header("Authorization", "Bearer {0}".format(token.accessToken))
 
     @property
     def service_root_url(self):
         # type: () -> str
-        return "https://graph.microsoft.com/{0}".format(self._version)
+        return "{0}/{1}".format(
+            AzureEnvironment.get_graph_authority(self._environment), self._version
+        )

office365/intune/servicecommunications/health/health.py

@@ -2,4 +2,4 @@ from office365.entity import Entity
 
 
 class ServiceHealth(Entity):
-    """Represents the health information of a service subscribed by a tenant."""
+    """Represents the sitehealth information of a service subscribed by a tenant."""

office365/intune/servicecommunications/issues/issue.py

@@ -7,9 +7,9 @@ from office365.runtime.queries.function import FunctionQuery
 
 class ServiceHealthIssue(ServiceAnnouncementBase):
     """
-    Represents a service health issue in a service.
+    Represents a service sitehealth issue in a service.
 
-    The service health issue can be a service incident or service advisory. For example:
+    The service sitehealth issue can be a service incident or service advisory. For example:
 
        - Service incident: "Exchange mailbox service is down".
        - Service advisory: "Users may experience delays in emails reception".

office365/onedrive/columns/definition.py

@@ -1,6 +1,6 @@
 from typing import Optional
 
-from office365.base_item import BaseItem
+from office365.onedrive.base_item import BaseItem
 from office365.onedrive.columns.boolean import BooleanColumn
 from office365.onedrive.columns.calculated import CalculatedColumn
 from office365.onedrive.columns.choice import ChoiceColumn

office365/onedrive/contenttypes/content_type.py

@@ -1,7 +1,7 @@
 from typing import Optional
 
-from office365.base_item import BaseItem
 from office365.entity_collection import EntityCollection
+from office365.onedrive.base_item import BaseItem
 from office365.onedrive.columns.column_link import ColumnLink
 from office365.onedrive.columns.definition import ColumnDefinition
 from office365.onedrive.contenttypes.order import ContentTypeOrder

office365/onedrive/driveitems/driveItem.py

@@ -9,11 +9,11 @@ from typing import IO, AnyStr, Callable, Optional, TypeVar
 import requests
 from typing_extensions import Self
 
-from office365.base_item import BaseItem
 from office365.delta_path import DeltaPath
 from office365.entity_collection import EntityCollection
 from office365.onedrive.analytics.item_activity_stat import ItemActivityStat
 from office365.onedrive.analytics.item_analytics import ItemAnalytics
+from office365.onedrive.base_item import BaseItem
 from office365.onedrive.driveitems.audio import Audio
 from office365.onedrive.driveitems.conflict_behavior import ConflictBehavior
 from office365.onedrive.driveitems.geo_coordinates import GeoCoordinates
@@ -66,6 +66,7 @@ class DriveItem(BaseItem):
     OneDrive and SharePoint are returned as driveItem resources"""
 
     def get_files(self, recursive=False, page_size=None):
+        # type: (bool, Optional[int]) -> EntityCollection["DriveItem"]
         """Retrieves files
         :param bool recursive: Determines whether to enumerate folders recursively
         :param int page_size: Page size
@@ -94,6 +95,7 @@ class DriveItem(BaseItem):
         return return_type
 
     def get_folders(self, recursive=False, page_size=None):
+        # type: (bool, Optional[int]) -> EntityCollection["DriveItem"]
         """Retrieves folders
         :param bool recursive: Determines whether to enumerate folders recursively
         :param int page_size: Page size
@@ -177,6 +179,16 @@ class DriveItem(BaseItem):
         self.context.add_query(qry)
         return return_type
 
+    def discard_checkout(self):
+        """Discard the check out of a driveItem. This action releases a driveItem resource that was previously
+        checked out. Any changes made to the item while it was checked out are discarded.
+
+        The same user that performed the checkout must discard it. Another alternative is to use application permissions
+        """
+        qry = ServiceOperationQuery(self, "discardCheckout")
+        self.context.add_query(qry)
+        return self
+
     def extract_sensitivity_labels(self):
         # type: () -> ClientResult[ExtractSensitivityLabelsResult]
         """
@@ -366,7 +378,7 @@ class DriveItem(BaseItem):
     def download_folder(
         self, download_file, after_file_downloaded=None, recursive=True
     ):
-        # type: (IO, Callable[[File], None], bool) -> "DriveItem"
+        # type: (IO, Callable[["DriveItem"], None], bool) -> "DriveItem"
         """
         Download the folder content
         """

office365/onedrive/driveitems/retention_label.py

@@ -1,7 +1,11 @@
+from datetime import datetime
 from typing import Optional
 
 from office365.directory.permissions.identity_set import IdentitySet
 from office365.entity import Entity
+from office365.onedrive.driveitems.retention_label_settings import (
+    RetentionLabelSettings,
+)
 
 
 class ItemRetentionLabel(Entity):
@@ -23,3 +27,32 @@ class ItemRetentionLabel(Entity):
         # type: () -> Optional[IdentitySet]
         """Identity of the user who applied the label. Read-only."""
         return self.properties.get("labelAppliedBy", IdentitySet())
+
+    @property
+    def label_applied_datetime(self):
+        # type: () -> Optional[datetime]
+        """The date and time when the label was applied on the item.
+        The timestamp type represents date and time information using ISO 8601 format and is always in UTC.
+        """
+        return self.properties.get("labelAppliedDateTime", datetime.min)
+
+    @property
+    def name(self):
+        # type: () -> Optional[str]
+        """The retention label on the document. Read-write."""
+        return self.properties.get("name", None)
+
+    @property
+    def retention_settings(self):
+        # type: () -> RetentionLabelSettings
+        """The retention settings enforced on the item. Read-write."""
+        return self.properties.get("retentionSettings", RetentionLabelSettings())
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {
+                "labelAppliedBy": self.label_applied_by,
+                "retentionSettings": self.retention_settings,
+            }
+            default_value = property_mapping.get(name, None)
+        return super(ItemRetentionLabel, self).get_property(name, default_value)

office365/onedrive/driveitems/retention_label_settings.py

@@ -0,0 +1,7 @@
+from office365.runtime.client_value import ClientValue
+
+
+class RetentionLabelSettings(ClientValue):
+    """
+    Groups all the compliance retention restrictions on the item into a single structure.
+    """

office365/onedrive/drives/drive.py

@@ -1,8 +1,8 @@
 from typing import Optional
 
-from office365.base_item import BaseItem
 from office365.directory.permissions.identity_set import IdentitySet
 from office365.entity_collection import EntityCollection
+from office365.onedrive.base_item import BaseItem
 from office365.onedrive.driveitems.conflict_behavior import ConflictBehavior
 from office365.onedrive.driveitems.driveItem import DriveItem
 from office365.onedrive.driveitems.system_facet import SystemFacet

office365/onedrive/filestorage/container.py

@@ -0,0 +1,7 @@
+from office365.entity import Entity
+
+
+class FileStorageContainer(Entity):
+    """Represents a location where multiple users or a group of users can store files and access them
+    via an application. All file system objects in a fileStorageContainer are returned as driveItem resources.
+    """

office365/onedrive/filestorage/file_storage.py

@@ -0,0 +1,20 @@
+from office365.entity import Entity
+from office365.entity_collection import EntityCollection
+from office365.onedrive.filestorage.container import FileStorageContainer
+from office365.runtime.paths.resource_path import ResourcePath
+
+
+class FileStorage(Entity):
+    """Represents the structure of active and deleted fileStorageContainer objects."""
+
+    @property
+    def containers(self):
+        """The collection of active fileStorageContainers"""
+        return self.properties.get(
+            "containers",
+            EntityCollection(
+                self.context,
+                FileStorageContainer,
+                ResourcePath("containers", self.resource_path),
+            ),
+        )

office365/onedrive/listitems/field_value_set.py

@@ -1,4 +1,4 @@
-from office365.base_item import BaseItem
+from office365.onedrive.base_item import BaseItem
 
 
 class FieldValueSet(BaseItem):

office365/onedrive/listitems/list_item.py

@@ -1,6 +1,6 @@
-from office365.base_item import BaseItem
 from office365.entity_collection import EntityCollection
 from office365.onedrive.analytics.item_analytics import ItemAnalytics
+from office365.onedrive.base_item import BaseItem
 from office365.onedrive.contenttypes.info import ContentTypeInfo
 from office365.onedrive.documentsets.version import DocumentSetVersion
 from office365.onedrive.internal.queries.get_activities_by_interval import (

office365/onedrive/lists/list.py

@@ -1,7 +1,7 @@
 from typing import Optional
 
-from office365.base_item import BaseItem
 from office365.entity_collection import EntityCollection
+from office365.onedrive.base_item import BaseItem
 from office365.onedrive.columns.definition_collection import ColumnDefinitionCollection
 from office365.onedrive.contenttypes.collection import ContentTypeCollection
 from office365.onedrive.listitems.list_item import ListItem

office365/onedrive/recyclebin/item.py

@@ -0,0 +1,6 @@
+from office365.onedrive.base_item import BaseItem
+
+
+class RecycleBinItem(BaseItem):
+    """Represents information about a deleted item in a recycleBin of a SharePoint site or a SharePoint
+    Embedded fileStorageContainer."""

office365/onedrive/recyclebin/recyclebin.py

@@ -0,0 +1,29 @@
+from office365.entity_collection import EntityCollection
+from office365.onedrive.base_item import BaseItem
+from office365.onedrive.recyclebin.item import RecycleBinItem
+from office365.onedrive.recyclebin.settings import RecycleBinSettings
+from office365.runtime.paths.resource_path import ResourcePath
+
+
+class RecycleBin(BaseItem):
+    """Represents a container for a collection of recycleBinItem resources in a SharePoint site or a
+    SharePoint Embedded fileStorageContainer."""
+
+    @property
+    def items(self):
+        # type: () -> EntityCollection[RecycleBinItem]
+        """List of the recycleBinItems deleted by a user."""
+        return self.properties.setdefault(
+            "items",
+            EntityCollection(
+                self.context,
+                RecycleBinItem,
+                ResourcePath("items", self.resource_path),
+                self,
+            ),
+        )
+
+    @property
+    def settings(self):
+        """Settings for the recycleBin"""
+        return self.properties.get("settings", RecycleBinSettings())

office365/onedrive/recyclebin/settings.py

@@ -0,0 +1,13 @@
+from office365.runtime.client_value import ClientValue
+
+
+class RecycleBinSettings(ClientValue):
+    """Represents settings for the recycleBin resource type."""
+
+    def __init__(self, retention_period_override_days=None):
+        """
+        :param int retention_period_override_days: Recycle bin retention period override in days for deleted content.
+        The default value is 93; the value range is 7 to 180. The setting applies to newly deleted content only.
+        Setting this property to null reverts to its default value.
+        """
+        self.retentionPeriodOverrideDays = retention_period_override_days

office365/onedrive/shares/drive_item.py

@@ -1,6 +1,6 @@
-from office365.base_item import BaseItem
 from office365.directory.permissions.identity_set import IdentitySet
 from office365.entity_collection import EntityCollection
+from office365.onedrive.base_item import BaseItem
 from office365.onedrive.driveitems.driveItem import DriveItem
 from office365.onedrive.internal.paths.root import RootPath
 from office365.onedrive.listitems.list_item import ListItem

office365/onedrive/sitepages/base.py

@@ -1,12 +1,15 @@
 from typing import Optional
 
-from office365.base_item import BaseItem
+from office365.onedrive.base_item import BaseItem
 from office365.onedrive.driveitems.publication_facet import PublicationFacet
 
 
 class BaseSitePage(BaseItem):
     """An abstract type that represents a page in the site page library."""
 
+    def __repr__(self):
+        return self.name or self.entity_type_name
+
     @property
     def publishing_state(self):
         # type: () -> Optional[str]

office365/onedrive/sitepages/canvas_layout.py

@@ -1,7 +1,7 @@
 from office365.entity import Entity
 from office365.entity_collection import EntityCollection
-from office365.onedrive.sitepages.horizontal_section import HorizontalSection
-from office365.onedrive.sitepages.vertical_section import VerticalSection
+from office365.onedrive.sitepages.sections.horizontal import HorizontalSection
+from office365.onedrive.sitepages.sections.vertical import VerticalSection
 from office365.runtime.paths.resource_path import ResourcePath
 
 

office365/onedrive/sitepages/collection.py

@@ -10,10 +10,22 @@ class SitePageCollection(EntityCollection[SitePage]):
     def __init__(self, context, resource_path=None):
         super(SitePageCollection, self).__init__(context, SitePage, resource_path)
 
+    def get(self):
+        def _construct_request(request):
+            # type: (RequestOptions) -> None
+            # request.url += "/microsoft.graph.sitePage"
+            pass
+
+        return super(SitePageCollection, self).get().before_execute(_construct_request)
+
+    def get_by_name(self, name):
+        return self.single("name eq '{0}'".format(name))
+
     def add(self, title):
         """
         Create a new sitePage in the site pages list in a site.
 
+        :param str title:
         """
 
         def _construct_request(request):

office365/onedrive/sitepages/{horizontal_section.py → sections/horizontal.py}

@@ -1,6 +1,6 @@
 from office365.entity import Entity
 from office365.entity_collection import EntityCollection
-from office365.onedrive.sitepages.horizontal_section_column import (
+from office365.onedrive.sitepages.sections.horizontal_column import (
     HorizontalSectionColumn,
 )
 from office365.runtime.paths.resource_path import ResourcePath

office365/onedrive/sitepages/site_page.py

@@ -15,23 +15,23 @@ class SitePage(BaseSitePage):
     webParts."""
 
     def get_web_parts_by_position(
-        self, webPartIndex, horizontalSectionId, isInVerticalSection, columnId
+        self, web_part_index, horizontal_section_id, is_in_vertical_section, column_id
     ):
         """
         Get a collection of webPart by providing webPartPosition information.
 
-        :param float webPartIndex: Index of the current WebPart. Represents the order of WebPart in this column or
+        :param float web_part_index: Index of the current WebPart. Represents the order of WebPart in this column or
              section. Only works if either columnId or isInVerticalSection is provided.
-        :param float horizontalSectionId: Indicate the horizontal section where the WebPart located in.
-        :param bool isInVerticalSection: Indicate whether the WebPart located in the vertical section.
-        :param float columnId: Indicate the identifier of the column where the WebPart located in. Only works
+        :param float horizontal_section_id: Indicate the horizontal section where the WebPart located in.
+        :param bool is_in_vertical_section: Indicate whether the WebPart located in the vertical section.
+        :param float column_id: Indicate the identifier of the column where the WebPart located in. Only works
              if horizontalSectionId is provided.
         """
         params = {
-            "webPartIndex": webPartIndex,
-            "horizontalSectionId": horizontalSectionId,
-            "isInverticalSection": isInVerticalSection,
-            "columnId": columnId,
+            "webPartIndex": web_part_index,
+            "horizontalSectionId": horizontal_section_id,
+            "isInverticalSection": is_in_vertical_section,
+            "columnId": column_id,
         }
         return_type = EntityCollection(
             self.context, WebPart, ResourcePath("webParts", self.resource_path)

office365/onedrive/sitepages/webparts/data.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class WebPartData(ClientValue):
+    """"""

office365/onedrive/sitepages/webparts/position.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class WebPartPosition(ClientValue):
+    """Represents the position information of the given web part to the current page"""

office365/onedrive/sitepages/webparts/standard.py

@@ -1,5 +1,14 @@
+from typing import Optional
+
+from office365.onedrive.sitepages.webparts.data import WebPartData
 from office365.onedrive.sitepages.webparts.web_part import WebPart
 
 
 class StandardWebPart(WebPart):
     """Represents a standard web part instance on a SharePoint page."""
+
+    @property
+    def data(self):
+        # type: () -> Optional[WebPartData]
+        """Data of the webPart."""
+        return self.properties.get("data", WebPartData())

office365/onedrive/sitepages/webparts/web_part.py

@@ -1,5 +1,17 @@
 from office365.entity import Entity
+from office365.onedrive.sitepages.webparts.position import WebPartPosition
+from office365.runtime.client_result import ClientResult
+from office365.runtime.queries.service_operation import ServiceOperationQuery
 
 
 class WebPart(Entity):
     """Represents a specific web part instance on a SharePoint page."""
+
+    def get_position_of_web_part(self):
+        """Returns the position of the specified web part in the page."""
+        return_type = ClientResult(self.context, WebPartPosition())
+        qry = ServiceOperationQuery(
+            self, "getPositionOfWebPart", return_type=return_type
+        )
+        self.context.add_query(qry)
+        return self

office365/onedrive/sites/archival_details.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class SiteArchivalDetails(ClientValue):
+    """Represents the archival details of a siteCollection."""

office365/onedrive/sites/site.py

@@ -1,10 +1,10 @@
 from datetime import datetime
 from typing import Optional
 
-from office365.base_item import BaseItem
 from office365.entity_collection import EntityCollection
 from office365.onedrive.analytics.item_activity_stat import ItemActivityStat
 from office365.onedrive.analytics.item_analytics import ItemAnalytics
+from office365.onedrive.base_item import BaseItem
 from office365.onedrive.columns.definition_collection import ColumnDefinitionCollection
 from office365.onedrive.contenttypes.collection import ContentTypeCollection
 from office365.onedrive.drives.drive import Drive

office365/onedrive/sites/site_collection.py

@@ -1,17 +1,26 @@
+from office365.onedrive.sites.archival_details import SiteArchivalDetails
 from office365.runtime.client_value import ClientValue
 
 
 class SiteCollection(ClientValue):
     """The siteCollection resource provides more information about a site collection."""
 
-    def __init__(self, root=None, hostname=None, data_location_code=None):
+    def __init__(
+        self,
+        root=None,
+        hostname=None,
+        data_location_code=None,
+        archival_details=SiteArchivalDetails(),
+    ):
         """
 
         :param office365.onedrive.root.Root root: The hostname for the site collection.
         :param str hostname: The hostname for the site collection.
         :param str data_location_code: The geographic region code for where this site collection resides
+        :param str archival_details: Represents the archival details of a siteCollection.
         """
         super(SiteCollection, self).__init__()
         self.root = root
         self.hostname = hostname
         self.dataLocationCode = data_location_code
+        self.archivalDetails = archival_details

office365/onedrive/storage/storage.py

@@ -1,5 +1,15 @@
 from office365.entity import Entity
+from office365.onedrive.filestorage.file_storage import FileStorage
+from office365.runtime.paths.resource_path import ResourcePath
 
 
 class Storage(Entity):
     """Facilitates the structures of fileStorageContainers."""
+
+    @property
+    def file_storage(self):
+        """FileStorageContainer"""
+        return self.properties.get(
+            "fileStorage",
+            FileStorage(self.context, ResourcePath("fileStorage", self.resource_path)),
+        )

office365/onedrive/workbooks/charts/axes.py

@@ -1,7 +1,47 @@
 from office365.entity import Entity
+from office365.onedrive.workbooks.charts.axis import WorkbookChartAxis
+from office365.runtime.paths.resource_path import ResourcePath
 
 
 class WorkbookChartAxes(Entity):
     """Represents the chart axes."""
 
-    pass
+    @property
+    def category_axis(self):
+        """Represents the category axis in a chart."""
+        return self.properties.get(
+            "categoryAxis",
+            WorkbookChartAxis(
+                self.context, ResourcePath("categoryAxis", self.resource_path)
+            ),
+        )
+
+    @property
+    def series_axis(self):
+        """Represents the series axis of a 3-dimensional chart."""
+        return self.properties.get(
+            "seriesAxis",
+            WorkbookChartAxis(
+                self.context, ResourcePath("seriesAxis", self.resource_path)
+            ),
+        )
+
+    @property
+    def value_axis(self):
+        """Represents the value axis in an axis."""
+        return self.properties.get(
+            "valueAxis",
+            WorkbookChartAxis(
+                self.context, ResourcePath("valueAxis", self.resource_path)
+            ),
+        )
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {
+                "categoryAxis": self.category_axis,
+                "seriesAxis": self.series_axis,
+                "valueAxis": self.value_axis,
+            }
+            default_value = property_mapping.get(name, None)
+        return super(WorkbookChartAxes, self).get_property(name, default_value)