brandcenter namespace new types & methods, introduced test decorator for checking app perms

Author: vgrem

examples/auth/with_adal.py

@@ -6,22 +6,19 @@
 """
 
 from office365.graph_client import GraphClient
-from tests import load_settings
+from tests import test_tenant_name, test_client_id, test_username, test_password
 
 
 def acquire_token():
     import adal  # pylint: disable=E0401
 
-    settings = load_settings()
-    authority_url = "https://login.microsoftonline.com/{0}".format(
-        settings["default"]["tenant"]
-    )
+    authority_url = "https://login.microsoftonline.com/{0}".format(test_tenant_name)
     auth_ctx = adal.AuthenticationContext(authority_url)
     token = auth_ctx.acquire_token_with_username_password(
         "https://graph.microsoft.com",
-        settings["user_credentials"]["username"],
-        settings["user_credentials"]["password"],
-        settings["client_credentials"]["client_id"],
+        test_username,
+        test_password,
+        test_client_id,
     )
     return token
 

examples/directory/applications/has_application_perms.py

@@ -20,12 +20,10 @@
 
 
 resource = client.service_principals.get_by_name("Microsoft Graph")
-app_role = "ThreatAssessment.Read.All"  # "Bookings.Read.All"
+app_role = "Place.Read.All"  # "Bookings.Read.All"
 result = resource.get_application_permissions(test_client_id).execute_query()
-if (
-    len([cur_app_role for cur_app_role in result.value if cur_app_role == app_role])
-    == 0
-):
+#if app_role not in result.value:
+if not any(role.value == app_role for role in result.value):
     print("Application permission '{0}' is not granted".format(app_role))
 else:
     print(result.value)

examples/security/run_hunting_query.py

@@ -16,7 +16,10 @@
     test_client_id, test_client_secret
 )
 query = """
-DeviceProcessEvents | where InitiatingProcessFileName =~ \"powershell.exe\" | project Timestamp, FileName, \
-InitiatingProcessFileName | order by Timestamp desc | limit 2"""
+DeviceProcessEvents
+| where InitiatingProcessFileName =~ \"powershell.exe\"
+| project Timestamp, FileName, InitiatingProcessFileName
+| order by Timestamp desc | limit 2"""
+
 result = client.security.run_hunting_query(query).execute_query()
 print(result.value)

generator/import_metadata.py

@@ -26,13 +26,13 @@ def export_to_file(path, content):
     "--endpoint",
     dest="endpoint",
     help="Import metadata endpoint",
-    default="graph",
+    default="sharepoint",
 )
 parser.add_argument(
     "-p",
     "--path",
     dest="path",
-    default="./metadata/Graph.xml",
+    default="./metadata/SharePoint.xml",
     help="Import metadata endpoint",
 )
 

office365/booking/virtualevents/__init__.py renamed to office365/backuprestore/protection/__init__.py

@@ -0,0 +1,10 @@
+from office365.entity import Entity
+
+
+class ProtectionRuleBase(Entity):
+    """Represents a protection rule specified by the client as part of a protection plan applied to
+    Microsoft 365 data in an organization. Currently, only inclusion rules, which are rules that indicate
+    that a protection policy should match the specified criteria, can be defined.
+
+    Currently, protection Rules are static in nature, meaning policy changes are applied only when the
+    rule is executed, with no automatic/dynamic updates."""

office365/backuprestore/protection/rule_base.py

@@ -4,12 +4,22 @@
 )
 from office365.entity import Entity
 from office365.entity_collection import EntityCollection
+from office365.runtime.client_result import ClientResult
 from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.queries.service_operation import ServiceOperationQuery
 
 
 class BackupRestoreRoot(Entity):
     """Represents the Microsoft 365 Backup Storage service in a tenant."""
 
+    def enable(self, app_owner_tenant_id):
+        """Enable the Microsoft 365 Backup Storage service for a tenant."""
+        return_type = ClientResult(self.context, ServiceStatus())
+        payload = {"appOwnerTenantId": app_owner_tenant_id}
+        qry = ServiceOperationQuery(self, "enable", None, payload, None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
     @property
     def service_status(self):
         """Represents the tenant-level status of the Backup Storage service."""

office365/backuprestore/root.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.entity import Entity
 
 
@@ -6,3 +8,9 @@ class BookingService(Entity):
     Represents information about a particular service provided by a bookingBusiness, such as the service name,
     price, and the staff that usually provides such service.
     """
+
+    @property
+    def additional_information(self):
+        # type: () -> Optional[str]
+        """Additional information that is sent to the customer when an appointment is confirmed."""
+        return self.properties.get("additionalInformation", None)

office365/booking/service.py

@@ -1,6 +1,7 @@
 from office365.backuprestore.root import BackupRestoreRoot
 from office365.booking.business.collection import BookingBusinessCollection
 from office365.booking.currency import BookingCurrency
+from office365.communications.virtualevents.root import VirtualEventsRoot
 from office365.entity import Entity
 from office365.entity_collection import EntityCollection
 from office365.runtime.paths.resource_path import ResourcePath
@@ -43,12 +44,25 @@ def backup_restore(self):
             ),
         )
 
+    @property
+    def virtual_events(self):
+        # type: () -> VirtualEventsRoot
+        """A collection of virtual events."""
+        return self.properties.get(
+            "virtualEvents",
+            VirtualEventsRoot(
+                self.context,
+                ResourcePath("virtualEvents", self.resource_path),
+            ),
+        )
+
     def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {
                 "bookingBusinesses": self.booking_businesses,
                 "bookingCurrencies": self.booking_currencies,
                 "backupRestore": self.backup_restore,
+                "virtualEvents": self.virtual_events,
             }
             default_value = property_mapping.get(name, None)
         return super(SolutionsRoot, self).get_property(name, default_value)

office365/booking/solutions/root.py

@@ -0,0 +1,8 @@
+from office365.booking.staff.member_base import BookingStaffMemberBase
+
+
+class BookingStaffMember(BookingStaffMemberBase):
+    """Represents a staff member who provides services in a bookingBusiness.
+
+    Staff members can be part of the Microsoft 365 tenant where the booking business is configured,
+    or they can use email services from other email providers."""