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

office365/booking/business/business.py

@@ -57,9 +57,8 @@ class BookingBusiness(Entity):
 
     @property
     def business_hours(self):
-        """
-        The hours of operation for the business.
-        """
+        # type: () -> ClientValueCollection[BookingWorkHours]
+        """The hours of operation for the business."""
         return self.properties.get(
             "businessHours", ClientValueCollection(BookingWorkHours)
         )
@@ -74,6 +73,7 @@ class BookingBusiness(Entity):
 
     @property
     def appointments(self):
+        # type: () -> EntityCollection[BookingAppointment]
         """All the appointments of this business. Read-only. Nullable."""
         return self.properties.get(
             "appointments",
@@ -86,6 +86,7 @@ class BookingBusiness(Entity):
 
     @property
     def calendar_view(self):
+        # type: () -> EntityCollection[BookingAppointment]
         """The set of appointments of this business in a specified date range. Read-only. Nullable."""
         return self.properties.get(
             "calendarView",
@@ -98,6 +99,7 @@ class BookingBusiness(Entity):
 
     @property
     def customers(self):
+        # type: () -> EntityCollection[BookingCustomerBase]
         """All the customers of this business. Read-only. Nullable."""
         return self.properties.get(
             "customers",

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/extensions/extended_property.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.entity import Entity
 from office365.runtime.types.collections import StringCollection
 
@@ -7,10 +9,8 @@ class SingleValueLegacyExtendedProperty(Entity):
 
     @property
     def value(self):
-        """
-        A property value.
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """A property value."""
         return self.properties.get("value", None)
 
 

office365/directory/extensions/open_type.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.directory.extensions.extension import Extension
 
 
@@ -10,8 +12,6 @@ class OpenTypeExtension(Extension):
 
     @property
     def extension_name(self):
-        """
-        A unique text identifier for an open type data extension. Optional.
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """A unique text identifier for an open type data extension."""
         return self.properties.get("extensionName", None)

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/base.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.entity import Entity
 
 
@@ -7,11 +9,11 @@ class IdentityProviderBase(Entity):
     an Azure AD B2C tenant.
     """
 
+    def __str__(self):
+        return self.display_name or self.entity_type_name
+
     @property
     def display_name(self):
-        """
-        The display name for the identity provider.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """The display name for the identity provider."""
         return self.properties.get("displayName", None)

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/identities/providers/social_identity.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.directory.identities.providers.base import IdentityProviderBase
 
 
@@ -9,27 +11,27 @@ class SocialIdentityProvider(IdentityProviderBase):
 
     @property
     def client_id(self):
+        # type: () -> Optional[str]
         """
         The client identifier for the application obtained when registering the application with the identity provider.
-        :rtype: str or None
         """
         return self.properties.get("clientId", None)
 
     @property
     def client_secret(self):
+        # type: () -> Optional[str]
         """
         The client secret for the application that is obtained when the application is registered
         with the identity provider. This is write-only. A read operation returns ****.
-        :rtype: str or None
         """
         return self.properties.get("clientSecret", None)
 
     @property
     def identity_provider_type(self):
+        # type: () -> Optional[str]
         """
         For a B2B scenario, possible values: Google, Facebook.
         For a B2C scenario, possible values: Microsoft, Google, Amazon, LinkedIn, Facebook, GitHub, Twitter, Weibo,
         QQ, WeChat.
-        :rtype: str or None
         """
         return self.properties.get("identityProviderType", None)

office365/directory/identities/userflows/b2x/user_flow.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.directory.identities.userflows.language_configuration import (
     UserFlowLanguageConfiguration,
 )
@@ -20,6 +22,7 @@ class B2XIdentityUserFlow(IdentityUserFlow):
 
     @property
     def languages(self):
+        # type: () -> EntityCollection[UserFlowLanguageConfiguration]
         """The languages supported for customization within the user flow. Language customization is enabled by default
         in self-service sign-up user flow. You cannot create custom languages in self-service sign-up user flows.
         """
@@ -34,9 +37,8 @@ class B2XIdentityUserFlow(IdentityUserFlow):
 
     @property
     def user_attribute_assignments(self):
-        """
-        The user attribute assignments included in the user flow.
-        """
+        # type: () -> IdentityUserFlowAttributeAssignmentCollection
+        """The user attribute assignments included in the user flow."""
         return self.properties.get(
             "userAttributeAssignments",
             IdentityUserFlowAttributeAssignmentCollection(
@@ -47,11 +49,10 @@ class B2XIdentityUserFlow(IdentityUserFlow):
 
     @property
     def user_flow_type(self):
+        # type: () -> Optional[str]
         """
         The type of user flow. For self-service sign-up user flows,
         the value can only be signUpOrSignIn and cannot be modified after creation.
-
-        :rtype: str or None
         """
         return self.properties.get("userFlowType", None)
 

office365/directory/identities/userflows/language_configuration.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.directory.identities.userflows.language_page import UserFlowLanguagePage
 from office365.entity import Entity
 from office365.entity_collection import EntityCollection
@@ -11,19 +13,19 @@ class UserFlowLanguageConfiguration(Entity):
     User flows for Azure Active Directory support defining the language and strings shown to users
     as they go through the journeys you configure with your user flows."""
 
+    def __str__(self):
+        return self.display_name or self.entity_type_name
+
     @property
     def display_name(self):
-        """
-        The language name to display.
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """The language name to display."""
         return self.properties.get("displayName", None)
 
     @property
     def default_pages(self):
-        """
-        Collection of pages with the default content to display in a user flow for a specified language.
-        """
+        # type: () -> EntityCollection[UserFlowLanguagePage]
+        """Collection of pages with the default content to display in a user flow for a specified language."""
         return self.properties.get(
             "defaultPages",
             EntityCollection(
@@ -35,6 +37,7 @@ class UserFlowLanguageConfiguration(Entity):
 
     @property
     def overrides_pages(self):
+        # type: () -> EntityCollection[UserFlowLanguagePage]
         """Collection of pages with the default content to display in a user flow for a specified language."""
         return self.properties.get(
             "overridesPages",

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

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.directory.licenses.service_plan_info import ServicePlanInfo
 from office365.entity import Entity
 from office365.runtime.client_value_collection import ClientValueCollection
@@ -6,29 +8,29 @@ 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)
         )
 
     @property
     def sku_id(self):
+        # type: () -> Optional[str]
         """
         Unique identifier (GUID) for the service SKU. Equal to the skuId property on the related SubscribedSku object.
-        Read-only
-        :rtype: str or None
         """
         return self.properties.get("skuId", None)
 
     @property
     def sku_part_number(self):
+        # type: () -> Optional[str]
         """
         Unique SKU display name. Equal to the skuPartNumber on the related SubscribedSku object;
         for example: "AAD_Premium". Read-only
-        :rtype: str or None
         """
         return self.properties.get("skuPartNumber", None)

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)