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

office365/booking/virtualevents/root.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class VirtualEventsRoot(Entity):
+    """ """

office365/communications/calls/participant.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.communications.calls.invitation_participant_info import (
     InvitationParticipantInfo,
 )
@@ -68,9 +70,6 @@ class Participant(Entity):
 
     @property
     def metadata(self):
-        """
-        A blob of data provided by the participant in the roster.
-
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """A blob of data provided by the participant in the roster."""
         return self.properties.get("metadata", None)

office365/directory/applications/application.py

@@ -252,9 +252,7 @@ class Application(DirectoryObject):
 
     @property
     def public_client(self):
-        """
-        Specifies settings for installed clients such as desktop or mobile devices.
-        """
+        """Specifies settings for installed clients such as desktop or mobile devices."""
         return self.properties.get("publicClient", PublicClientApplication())
 
     @property
@@ -269,6 +267,7 @@ class Application(DirectoryObject):
 
     @property
     def created_on_behalf_of(self):
+        # type: () -> DirectoryObject
         """"""
         return self.properties.get(
             "createdOnBehalfOf",
@@ -279,6 +278,7 @@ class Application(DirectoryObject):
 
     @property
     def owners(self):
+        # type: () -> DirectoryObjectCollection
         """Directory objects that are owners of the application."""
         return self.properties.get(
             "owners",

office365/directory/applications/roles/assignment_collection.py

@@ -2,7 +2,7 @@ from office365.directory.applications.roles.assignment import AppRoleAssignment
 from office365.entity_collection import EntityCollection
 
 
-class AppRoleAssignmentCollection(EntityCollection):
+class AppRoleAssignmentCollection(EntityCollection[AppRoleAssignment]):
     def __init__(self, context, resource_path=None):
         super(AppRoleAssignmentCollection, self).__init__(
             context, AppRoleAssignment, resource_path

office365/directory/applications/roles/collection.py

@@ -8,6 +8,6 @@ class AppRoleCollection(ClientValueCollection[AppRole]):
     def __init__(self, initial_values=None):
         super(AppRoleCollection, self).__init__(AppRole, initial_values)
 
-    def __getitem__(self, name):
+    def __getitem__(self, key):
         # type: (str) -> AppRole
-        return next(iter([item for item in self._data if item.value == name]), None)
+        return next(iter([item for item in self._data if item.value == key]), None)

office365/directory/authentication/method_configuration.py

@@ -0,0 +1,9 @@
+from office365.entity import Entity
+
+
+class AuthenticationMethodConfiguration(Entity):
+    """
+    This is an abstract type that represents the settings for each authentication method. It has the configuration
+    of whether a specific authentication method is enabled or disabled for the tenant and which users and groups
+    can register and use that method.
+    """

office365/directory/authentication/method_mode_detail.py

@@ -0,0 +1,8 @@
+from office365.entity import Entity
+
+
+class AuthenticationMethodModeDetail(Entity):
+    """
+    The details of the authenticationMethodModes objects that can be defined for the allowedCombinations property
+    of the authenticationstrengthpolicy.
+    """

office365/directory/authentication/method_target.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class AuthenticationMethodTarget(Entity):
+    """"""

office365/directory/authentication/strength_root.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class AuthenticationStrengthRoot(Entity):
+    """The authenticationStrengthRoot resource is the entry point for the authentication strengths object model."""

office365/directory/certificates/auth_configuration.py

@@ -20,9 +20,7 @@ class CertificateBasedAuthConfiguration(Entity):
 
     @property
     def certificate_authorities(self):
-        """
-        Collection of certificate authorities which creates a trusted certificate chain.
-        """
+        """Collection of certificate authorities which creates a trusted certificate chain."""
         return self.properties.get(
             "certificateAuthorities", ClientValueCollection(CertificateAuthority)
         )

office365/directory/groups/group.py

@@ -380,9 +380,7 @@ class Group(DirectoryObject):
     @property
     def permission_grants(self):
         # type: () -> EntityCollection[ResourceSpecificPermissionGrant]
-        """
-        List permissions that have been granted to apps to access the group.
-        """
+        """List permissions that have been granted to apps to access the group."""
         return self.properties.setdefault(
             "permissionGrants",
             EntityCollection(
@@ -394,9 +392,7 @@ class Group(DirectoryObject):
 
     @property
     def photo(self):
-        """
-        The group's profile photo
-        """
+        """The group's profile photo"""
         return self.properties.get(
             "photo",
             ProfilePhoto(self.context, ResourcePath("photo", self.resource_path)),

office365/directory/identities/conditional_access_root.py

@@ -1,8 +1,17 @@
 from office365.entity import Entity
+from office365.runtime.paths.resource_path import ResourcePath
 
 
 class ConditionalAccessRoot(Entity):
     """The conditionalAccessRoot resource is the entry point for the Conditional Access (CA) object model.
     It doesn't contain any usable properties."""
 
-    pass
+    @property
+    def authentication_strength(self):
+        """The entry point for the Conditional Access (CA) object model."""
+        return self.properties.get(
+            "authenticationStrength",
+            ConditionalAccessRoot(
+                self.context, ResourcePath("authenticationStrength", self.resource_path)
+            ),
+        )

office365/directory/identities/container.py

@@ -18,9 +18,7 @@ class IdentityContainer(Entity):
 
     @property
     def api_connectors(self):
-        """
-        Represents entry point for API connectors.
-        """
+        """Represents entry point for API connectors."""
         return self.properties.get(
             "apiConnectors",
             EntityCollection(
@@ -52,9 +50,7 @@ class IdentityContainer(Entity):
 
     @property
     def b2x_user_flows(self):
-        """
-        Represents entry point for B2X/self-service sign-up identity userflows.
-        """
+        """Represents entry point for B2X/self-service sign-up identity userflows."""
         return self.properties.get(
             "b2xUserFlows",
             EntityCollection(
@@ -66,9 +62,7 @@ class IdentityContainer(Entity):
 
     @property
     def user_flow_attributes(self):
-        """
-        Represents entry point for identity userflow attributes.
-        """
+        """Represents entry point for identity userflow attributes."""
         return self.properties.get(
             "userFlowAttributes",
             EntityCollection(

office365/directory/identities/providers/builtin_identity.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.directory.identities.providers.base import IdentityProviderBase
 
 
@@ -8,9 +10,8 @@ class BuiltInIdentityProvider(IdentityProviderBase):
 
     @property
     def identity_provider_type(self):
+        # type: () -> Optional[str]
         """
         The identity provider type. For a B2B scenario, possible values: AADSignup, MicrosoftAccount, EmailOTP.
-
-        :rtype: str
         """
         return self.properties.get("identityProviderType", None)

office365/directory/identities/providers/saml_or_wsfed.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.directory.identities.providers.base import IdentityProviderBase
 
 
@@ -7,9 +9,6 @@ class SamlOrWsFedProvider(IdentityProviderBase):
 
     @property
     def issuer_uri(self):
-        """
-        Issuer URI of the federation server.
-
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """Issuer URI of the federation server."""
         return self.properties.get("issuerUri", None)

office365/directory/identitygovernance/governance.py

@@ -2,6 +2,9 @@ from office365.directory.identitygovernance.accessreview.set import AccessReview
 from office365.directory.identitygovernance.appconsent.approval_route import (
     AppConsentApprovalRoute,
 )
+from office365.directory.identitygovernance.privilegedaccess.root import (
+    PrivilegedAccessRoot,
+)
 from office365.directory.identitygovernance.termsofuse.container import (
     TermsOfUseContainer,
 )
@@ -35,9 +38,7 @@ class IdentityGovernance(Entity):
 
     @property
     def access_reviews(self):
-        """
-        Container for the base resources that expose the access reviews API and features.
-        """
+        """Container for the base resources that expose the access reviews API and features."""
         return self.properties.get(
             "accessReviews",
             AccessReviewSet(
@@ -45,6 +46,16 @@ class IdentityGovernance(Entity):
             ),
         )
 
+    @property
+    def privileged_access(self):
+        """Container for the base resources that expose the access reviews API and features."""
+        return self.properties.get(
+            "privilegedAccess",
+            PrivilegedAccessRoot(
+                self.context, ResourcePath("privilegedAccess", self.resource_path)
+            ),
+        )
+
     @property
     def terms_of_use(self):
         """

office365/directory/identitygovernance/privilegedaccess/root.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class PrivilegedAccessRoot(Entity):
+    """Represents the entry point for resources related to Privileged Identity Management (PIM)."""

office365/directory/key_credential.py

@@ -44,3 +44,6 @@ class KeyCredential(ClientValue):
         self.startDateTime = start_datetime
         self.type = key_type
         self.usage = usage
+
+    def __str__(self):
+        return self.displayName or self.entity_type_name

office365/directory/licenses/assignment_state.py

@@ -1,4 +1,5 @@
 from office365.runtime.client_value import ClientValue
+from office365.runtime.types.collections import StringCollection
 
 
 class LicenseAssignmentState(ClientValue):
@@ -12,8 +13,31 @@ class LicenseAssignmentState(ClientValue):
         - Error details if the assignment state is Error
     """
 
-    def __init__(self, assigned_by_group=None):
+    def __init__(
+        self,
+        assigned_by_group=None,
+        disabled_plans=None,
+        error=None,
+        lastUpdatedDateTime=None,
+        skuId=None,
+        state=None,
+    ):
         """
-        :param str assigned_by_group:
+        :param str assigned_by_group: ndicates whether the license is directly assigned or inherited from a group.
+             If directly assigned, this field is null; if inherited through a group membership, this field contains
+             the ID of the group.
+        :param list[str] disabled_plans: The service plans that are disabled in this assignment
+        :param str error: License assignment failure error. If the license is assigned successfully, this field is Null.
+             The possible values are CountViolation, MutuallyExclusiveViolation, DependencyViolation,
+             ProhibitedInUsageLocationViolation, UniquenessViolation, and Other.
+             For more information on how to identify and resolve license assignment errors, see here.
+        :param str skuId: The unique identifier for the SKU. Read-Only.
+        :param str state: Indicate the current state of this assignment. Read-Only.
+             The possible values are Active, ActiveWithError, Disabled, and Error.
         """
         self.assignedByGroup = assigned_by_group
+        self.disabledPlans = StringCollection(disabled_plans)
+        self.error = error
+        self.lastUpdatedDateTime = lastUpdatedDateTime
+        self.skuId = skuId
+        self.state = state

office365/directory/licenses/details.py

@@ -8,11 +8,12 @@ from office365.runtime.client_value_collection import ClientValueCollection
 class LicenseDetails(Entity):
     """Contains information about a license assigned to a user."""
 
+    def __repr__(self):
+        return self.sku_part_number or self.entity_type_name
+
     @property
     def service_plans(self):
-        """
-        Information about the service plans assigned with the license. Read-only, Not nullable
-        """
+        """Information about the service plans assigned with the license. Read-only, Not nullable"""
         return self.properties.get(
             "servicePlans", ClientValueCollection(ServicePlanInfo)
         )

office365/directory/licenses/subscribed_sku.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.directory.licenses.service_plan_info import ServicePlanInfo
 from office365.directory.licenses.units_detail import LicenseUnitsDetail
 from office365.entity import Entity
@@ -9,35 +11,31 @@ class SubscribedSku(Entity):
 
     @property
     def account_id(self):
-        """
-        The unique ID of the account this SKU belongs to.
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """The unique ID of the account this SKU belongs to."""
         return self.properties.get("accountId", None)
 
     @property
     def applies_to(self):
+        # type: () -> Optional[str]
         """
         The target class for this SKU. Only SKUs with target class User are assignable.
         Possible values are: "User", "Company".
-        :rtype: str
         """
         return self.properties.get("appliesTo", None)
 
     @property
     def sku_id(self):
-        """
-        The unique identifier (GUID) for the service SKU.
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """The unique identifier (GUID) for the service SKU."""
         return self.properties.get("skuId", None)
 
     @property
     def sku_part_number(self):
+        # type: () -> Optional[str]
         """
         The SKU part number; for example: "AAD_PREMIUM" or "RMSBASIC".
         To get a list of commercial subscriptions that an organization has acquired, see List subscribedSkus.
-        :rtype: str
         """
         return self.properties.get("skuPartNumber", None)
 

office365/directory/object_collection.py

@@ -1,7 +1,8 @@
+from typing_extensions import Self
+
 from office365.delta_collection import DeltaCollection
 from office365.directory.object import DirectoryObject
 from office365.entity_collection import EntityCollection
-from office365.runtime.client_result import ClientResult
 from office365.runtime.http.http_method import HttpMethod
 from office365.runtime.http.request_options import RequestOptions
 from office365.runtime.queries.service_operation import ServiceOperationQuery
@@ -15,29 +16,32 @@ class DirectoryObjectCollection(DeltaCollection[DirectoryObject]):
             context, DirectoryObject, resource_path
         )
 
-    def get_by_ids(self, ids):
+    def get_by_ids(self, ids, types=None):
         """
         Returns the directory objects specified in a list of IDs.
-
-        :type ids: list[str]
+        :param list[str] ids: A collection of IDs for which to return objects. The IDs are GUIDs, represented as
+            strings. You can specify up to 1000 IDs.
+        :param list[str] types: A collection of resource types that specifies the set of resource collections to search.
+            If not specified, the default is directoryObject, which contains all of the resource types defined in
+            the directory. Any object that derives from directoryObject may be specified in the collection;
+            for example: user, group, and device objects.
         """
-        return_type = ClientResult(self.context)
-        params = {"ids": ids}
+        return_type = DirectoryObjectCollection(self.context)
+        params = {"ids": ids, "types": types}
         qry = ServiceOperationQuery(self, "getByIds", params, None, None, return_type)
         self.context.add_query(qry)
         return return_type
 
-    def add(self, user_id):
-        """
-        Add a user to the group.
+    def add(self, directory_object):
+        # type: (DirectoryObject) -> Self
+        """Adds directory objects to the collection."""
 
-        :type user_id: str
-        """
-        payload = {
-            "@odata.id": "https://graph.microsoft.com/v1.0/users/{0}".format(user_id)
-        }
-        qry = ServiceOperationQuery(self, "$ref", None, payload)
-        self.context.add_query(qry)
+        def _add():
+            payload = {"@odata.id": directory_object.resource_url}
+            qry = ServiceOperationQuery(self, "$ref", None, payload)
+            self.context.add_query(qry)
+
+        directory_object.ensure_property("id", _add)
         return self
 
     def get_available_extension_properties(self, is_synced_from_on_premises=None):
@@ -60,19 +64,30 @@ class DirectoryObjectCollection(DeltaCollection[DirectoryObject]):
         self.context.add_query(qry)
         return return_type
 
-    def remove(self, user_id):
-        """Remove a user from the group.
-
-        :param str user_id: User identifier
+    def remove(self, directory_object):
+        # type: (DirectoryObject|str) -> Self
+        """Removes directory object from the collection.
+        :param str directory_object: Directory object or identifier
         """
 
-        qry = ServiceOperationQuery(self, "{0}/$ref".format(user_id))
+        def _remove(id_):
+            qry = ServiceOperationQuery(self, "{0}/$ref".format(id_))
+
+            def _construct_request(request):
+                # type: (RequestOptions) -> None
+                request.method = HttpMethod.Delete
+
+            self.context.add_query(qry).before_query_execute(_construct_request)
+
+        if isinstance(directory_object, DirectoryObject):
+
+            def _loaded():
+                _remove(directory_object.id)
 
-        def _construct_request(request):
-            # type: (RequestOptions) -> None
-            request.method = HttpMethod.Delete
+            directory_object.ensure_property("id", _loaded)
+        else:
+            _remove(directory_object)
 
-        self.context.add_query(qry).before_query_execute(_construct_request)
         return self
 
     def validate_properties(

office365/directory/password_credential.py

@@ -31,3 +31,6 @@ class PasswordCredential(ClientValue):
         self.keyId = key_id
         self.startDateTime = start_datetime
         self.endDateTime = end_datetime
+
+    def __str__(self):
+        return self.displayName or self.entity_type_name

office365/directory/permissions/default_user_role.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class DefaultUserRolePermissions(ClientValue):
+    """Contains certain customizable permissions of default user role in Microsoft Entra ID."""

office365/directory/permissions/grants/condition_set.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.entity import Entity
 from office365.runtime.types.collections import StringCollection
 
@@ -29,10 +31,10 @@ class PermissionGrantConditionSet(Entity):
 
     @property
     def client_applications_from_verified_publisher_only(self):
+        # type: () -> Optional[bool]
         """
         Set to true to only match on client applications with a verified publisher. Set to false to match on any client
         app, even if it does not have a verified publisher. Default is false.
-        :rtype: bool
         """
         return self.properties.get("clientApplicationsFromVerifiedPublisherOnly", None)
 
@@ -50,9 +52,9 @@ class PermissionGrantConditionSet(Entity):
 
     @property
     def resource_application(self):
+        # type: () -> Optional[str]
         """
         The appId of the resource application (e.g. the API) for which a permission is being granted, or any to match
         with any resource application or API. Default is any.
-        :rtype: str
         """
         return self.properties.get("resourceApplication", None)

office365/directory/permissions/grants/oauth2.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.entity import Entity
 
 
@@ -13,56 +15,51 @@ class OAuth2PermissionGrant(Entity):
 
     @property
     def client_id(self):
+        # type: () -> Optional[str]
         """
         The id of the client service principal for the application which is authorized to act on behalf of a signed-in
         user when accessing an API. Required. Supports $filter (eq only).
-
-        :rtype: str
         """
         return self.properties.get("clientId", None)
 
     @property
     def consent_type(self):
+        # type: () -> Optional[str]
         """
         Indicates if authorization is granted for the client application to impersonate all users or only a
         specific user. AllPrincipals indicates authorization to impersonate all users.
         Principal indicates authorization to impersonate a specific user. Consent on behalf of all users can be granted
         by an administrator. Non-admin users may be authorized to consent on behalf of themselves in some cases,
         for some delegated permissions. Required. Supports $filter (eq only).
-
-        :rtype: str
         """
         return self.properties.get("consentType", None)
 
     @property
     def principal_id(self):
+        # type: () -> Optional[str]
         """
         The id of the user on behalf of whom the client is authorized to access the resource, when consentType is
         Principal. If consentType is AllPrincipals this value is null. Required when consentType is Principal.
         Supports $filter (eq only).
-
-        :rtype: str
         """
         return self.properties.get("principalId", None)
 
     @property
     def resource_id(self):
+        # type: () -> Optional[str]
         """
         The id of the resource service principal to which access is authorized. This identifies the API which the
         client is authorized to attempt to call on behalf of a signed-in user. Supports $filter (eq only).
-
-        :rtype: str
         """
         return self.properties.get("resourceId", None)
 
     @property
     def scope(self):
+        # type: () -> Optional[str]
         """
         A space-separated list of the claim values for delegated permissions which should be included in access tokens
         for the resource application (the API). For example, openid User.Read GroupMember.Read.All. Each claim value
         should match the value field of one of the delegated permissions defined by the API, listed in the
         oauth2PermissionScopes property of the resource service principal. Must not exceed 3850 characters in length.
-
-        :rtype: str
         """
         return self.properties.get("scope", None)