Office365-REST-Python-Client 2.4.2__py3-none-any.whl → 2.4.4__py3-none-any.whl

office365/sharepoint/tenant/apps/information.py

@@ -4,10 +4,12 @@ from office365.runtime.client_value import ClientValue
 class TenantAppInformation(ClientValue):
     """Specifies the information for the tenant-scoped app."""
 
-    def __init__(self, app_principal_id=None, app_web_full_url=None):
+    def __init__(self, app_principal_id=None, app_web_full_url=None, creation_time=None):
         """
         :param str app_principal_id: Specifies the OAuth Id for the tenant-scoped app.
         :param str app_web_full_url: Specifies the web full URL for the tenant-scoped app.
+        :param datetime.datetime creation_time: Specifies the creation time for the tenant-scoped app.
         """
         self.AppPrincipalId = app_principal_id
         self.AppWebFullUrl = app_web_full_url
+        self.CreationTime = creation_time

office365/sharepoint/tenant/management/office365_tenant.py

@@ -151,24 +151,28 @@ class Office365Tenant(BaseEntity):
         self.context.add_query(qry)
         return self
 
-    def revoke_all_user_sessions(self, user_or_username):
+    def revoke_all_user_sessions(self, user):
         """
         Provides IT administrators the ability to invalidate a particular users' O365 sessions across all their devices.
 
-        :param str or User user_or_username: Specifies a user name
+        :param str or User user: Specifies a user name or user object
               (for example, user1@contoso.com) or User object
         """
         return_type = SPOUserSessionRevocationResult(self.context)
-        if isinstance(user_or_username, User):
-            def _user_loaded():
-                next_qry = ServiceOperationQuery(self, "RevokeAllUserSessions", [user_or_username.login_name], None,
-                                                 None, return_type)
-                self.context.add_query(next_qry)
 
-            user_or_username.ensure_property("LoginName", _user_loaded)
-        else:
-            qry = ServiceOperationQuery(self, "RevokeAllUserSessions", [user_or_username], None, None, return_type)
+        def _revoke_all_user_sessions(login_name):
+            """
+            :type login_name: str
+            """
+            qry = ServiceOperationQuery(self, "RevokeAllUserSessions", [login_name], None, None, return_type)
             self.context.add_query(qry)
+
+        if isinstance(user, User):
+            def _user_loaded():
+                _revoke_all_user_sessions(user.login_name)
+            user.ensure_property("LoginName", _user_loaded)
+        else:
+            _revoke_all_user_sessions(user)
         return return_type
 
     def get_external_users(self, position=0, page_size=50, _filter=None, sort_order=0):
@@ -238,7 +242,6 @@ class Office365Tenant(BaseEntity):
     def delete_tenant_theme(self, name):
         """
         Removes a theme from tenant
-
         :type name: str
         """
         payload = {

office365/sharepoint/types/resource_path.py

@@ -17,6 +17,7 @@ class ResourcePath(ClientValue):
     @staticmethod
     def create_absolute(site_url, path):
         """
+        Creates absolute path
         :param str site_url: Site url
         :param str path: Resource path
         """
@@ -29,11 +30,12 @@ class ResourcePath(ClientValue):
     @staticmethod
     def create_relative(site_url, path):
         """
+        Creates server relative path
         :param str site_url: Site url
         :param str path: Resource path
         """
         site_path = urlparse(site_url).path
-        if not path.startswith(site_path):
+        if not path.lower().startswith(site_path.lower()):
             return ResourcePath("/".join([site_path, path]))
         else:
             return ResourcePath(path)

office365/sharepoint/userprofiles/people_manager.py

@@ -265,8 +265,6 @@ class PeopleManager(BaseEntity):
     def set_multi_valued_profile_property(self, account_name, property_name, property_values):
         """
         Sets the value of a multivalued user profile property.
-
-
         :param str account_name: Specifies the user by account name.
         :param str property_name: The name of the property to set.
         :param list[str] property_values: The values being set on the property.

office365/sharepoint/userprofiles/sharedwithme/document.py

@@ -1,3 +1,5 @@
+from datetime import datetime
+
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.sharepoint.base_entity import BaseEntity
 from office365.sharepoint.userprofiles.sharedwithme.document_user import SharedWithMeDocumentUser
@@ -15,12 +17,16 @@ class SharedWithMeDocument(BaseEntity):
 
     @property
     def caller_stack(self):
+        """
+        :rtype: str
+        """
         return self.properties.get('CallerStack', None)
 
     @property
     def content_type_id(self):
         """
         Specifies the identifier of the content type of the document.
+        :rtype: str
         """
         return self.properties.get('ContentTypeId', None)
 
@@ -28,6 +34,7 @@ class SharedWithMeDocument(BaseEntity):
     def doc_id(self):
         """
         Specifies the document identifier.
+        :rtype: str
         """
         return self.properties.get('DocId', None)
 
@@ -37,3 +44,12 @@ class SharedWithMeDocument(BaseEntity):
         Specifies a list of users that can edit the document.
         """
         return self.properties.get('Editors', ClientValueCollection(SharedWithMeDocumentUser))
+
+    @property
+    def modified(self):
+        """Specifies the date and time when the document was last modified."""
+        return self.properties.get("Modified", datetime.min)
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.Portal.UserProfiles.SharedWithMeDocument"

office365/sharepoint/userprofiles/sharedwithme/document_user.py

@@ -4,6 +4,18 @@ from office365.runtime.client_value import ClientValue
 class SharedWithMeDocumentUser(ClientValue):
     """Represents a user of a document that is shared with the current user."""
 
+    def __init__(self, _id=None, login_name=None, sip_address=None, title=None):
+        """
+        :param str _id: Identifier
+        :param str login_name: Specifies the login name of the user.
+        :param str sip_address: Specifies the sip address of the user.
+        :param str title: Specifies the title of the user.
+        """
+        self.Id = _id
+        self.LoginName = login_name
+        self.SipAddress = sip_address
+        self.Title = title
+
     @property
     def entity_type_name(self):
         return "Microsoft.SharePoint.Portal.UserProfiles.SharedWithMeDocumentUser"

office365/sharepoint/userprofiles/sharedwithme/item_collection.py

@@ -0,0 +1,41 @@
+from office365.runtime.client_result import ClientResult
+from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.sharepoint.base_entity import BaseEntity
+
+
+class SharedWithMeItemCollection(BaseEntity):
+    """"""
+
+    @staticmethod
+    def get_shared_with_me_external_items(context, top):
+        """
+        :param office365.sharepoint.client_context.ClientContext context: Client context
+        :param int top:
+        """
+        binding_type = SharedWithMeItemCollection(context)
+        return_type = ClientResult(context, str())
+        params = {"top": top}
+        qry = ServiceOperationQuery(binding_type, "GetSharedWithMeExternalItems", params,
+                                    return_type=return_type, is_static=True)
+        context.add_query(qry)
+        return return_type
+
+    @staticmethod
+    def get_shared_with_me_items(context, top, skip_token=None, include_sharing_history=None):
+        """
+        :param office365.sharepoint.client_context.ClientContext context: Client context
+        :param int top:
+        :param str skip_token:
+        :param bool include_sharing_history:
+        """
+        binding_type = SharedWithMeItemCollection(context)
+        return_type = ClientResult(context, str())
+        params = {
+            "top": top,
+            "skiptoken": skip_token,
+            "includeSharingHistory": include_sharing_history
+        }
+        qry = ServiceOperationQuery(binding_type, "GetSharedWithMeItems", None, params,
+                                    return_type=return_type, is_static=True)
+        context.add_query(qry)
+        return return_type

office365/sharepoint/userprofiles/sharedwithme/items.py

@@ -1,5 +1,22 @@
+from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.base_entity import BaseEntity
+from office365.sharepoint.base_entity_collection import BaseEntityCollection
+from office365.sharepoint.userprofiles.sharedwithme.document import SharedWithMeDocument
 
 
 class SharedWithMeItems(BaseEntity):
-    pass
+
+    @staticmethod
+    def shared_with_me(context):
+        """
+        :param office365.sharepoint.client_context.ClientContext context: Client context
+        """
+        binding_type = SharedWithMeItems(context)
+        return_type = BaseEntityCollection(context, SharedWithMeDocument)
+        qry = ServiceOperationQuery(binding_type, "SharedWithMe", return_type=return_type, is_static=True)
+        context.add_query(qry)
+        return return_type
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.Portal.UserProfiles.SharedWithMeItems"

office365/sharepoint/viva/site_manager.py

@@ -0,0 +1,14 @@
+from office365.runtime.paths.resource_path import ResourcePath
+from office365.sharepoint.base_entity import BaseEntity
+
+
+class VivaSiteManager(BaseEntity):
+    """"""
+    def __init__(self, content, resource_path=None):
+        if resource_path is None:
+            resource_path = ResourcePath("Microsoft.SharePoint.Portal.VivaSiteManager")
+        super().__init__(content, resource_path)
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.Portal.VivaSiteManager"

office365/sharepoint/webhooks/subscription_collection.py

@@ -22,20 +22,19 @@ class SubscriptionCollection(BaseEntityCollection):
         return_type = Subscription(self.context)
         self.add_child(return_type)
 
-        def _create_query(information):
+        def _create_and_add_query(information):
             """
             :type information: SubscriptionInformation
             """
             payload = {"parameters": information}
-            return ServiceOperationQuery(self, "Add", None, payload, None, return_type)
+            qry = ServiceOperationQuery(self, "Add", None, payload, None, return_type)
+            self.context.add_query(qry)
 
         if isinstance(parameters, SubscriptionInformation):
-            qry = _create_query(parameters)
-            self.context.add_query(qry)
+            _create_and_add_query(parameters)
         else:
             def _parent_loaded():
-                next_qry = _create_query(SubscriptionInformation(parameters, self._parent.properties["Id"]))
-                self.context.add_query(next_qry)
+                _create_and_add_query(SubscriptionInformation(parameters, self._parent.properties["Id"]))
             self._parent.ensure_property("Id", _parent_loaded)
         return return_type
 

office365/sharepoint/webparts/definition.py

@@ -20,7 +20,7 @@ class WebPartDefinition(BaseEntity):
 
     @property
     def web_part(self):
-        """The WebPart object (1), as specified in section 3.2.5.148, associated with this WebPartDefinition.
+        """The WebPart object, as specified in section 3.2.5.148, associated with this WebPartDefinition.
         The WebPart object (1) contains additional properties relating to the Web Part represented by this
         WebPartDefinition object"""
         return self.properties.get('WebPart',

office365/sharepoint/webparts/webpart.py

@@ -2,7 +2,21 @@ from office365.sharepoint.base_entity import BaseEntity
 
 
 class WebPart(BaseEntity):
-    """The WebPart object, as specified in section 3.2.5.148, associated with this WebPartDefinition.
-    The WebPart object (1) contains additional properties relating to the Web Part represented by this
-    WebPartDefinition object."""
-    pass
+    """
+    A reusable component that contains or generates web-based content such as XML, HTML, and scripting code.
+    It has a standard property schema and displays that content in a cohesive unit on a webpage. See also Web Parts Page
+    """
+
+    @property
+    def zone_index(self):
+        """
+        An integer that specifies the relative position of a Web Part in a Web Part zone.
+        Web Parts are positioned from the smallest to the largest zone index. If two or more Web Parts have the
+        same zone index they are positioned adjacent to each other in an undefined order
+        :rtype: int or None
+        """
+        return self.properties.get("ZoneIndex", None)
+
+    @property
+    def entity_type_name(self):
+        return "SP.WebParts.WebPart"

office365/sharepoint/webs/context_web_information.py

@@ -9,7 +9,8 @@ class ContextWebInformation(ClientValue):
 
     def __init__(self, form_digest_value=None, form_digest_timeout_secs=None):
         """
-        :param str form_digest_value: Specifies a valid form digest for the site
+        :param str form_digest_value: An object that is inserted into a page and is used by a protocol server
+             to validate client requests. The validation is specific to a user, site, and time period.
         :param int form_digest_timeout_secs: Specifies the amount of time in seconds before security validation expires.
         """
         super(ContextWebInformation, self).__init__()
@@ -21,9 +22,6 @@ class ContextWebInformation(ClientValue):
         self.WebFullUrl = None
         self._valid_from = time.time()
 
-    def reset(self):
-        pass
-
     @property
     def is_valid(self):
         """

office365/sharepoint/webs/web.py

@@ -26,11 +26,13 @@ from office365.sharepoint.flows.synchronization_result import FlowSynchronizatio
 from office365.sharepoint.folders.folder import Folder
 from office365.sharepoint.folders.collection import FolderCollection
 from office365.sharepoint.listitems.listitem import ListItem
+from office365.sharepoint.lists.creation_information import ListCreationInformation
 from office365.sharepoint.lists.document_library_information import DocumentLibraryInformation
 from office365.sharepoint.lists.get_parameters import GetListsParameters
 from office365.sharepoint.lists.list import List
 from office365.sharepoint.lists.collection import ListCollection
 from office365.sharepoint.lists.template_collection import ListTemplateCollection
+from office365.sharepoint.lists.template_type import ListTemplateType
 from office365.sharepoint.marketplace.corporatecuratedgallery.available_addins_response import SPAvailableAddinsResponse
 from office365.sharepoint.navigation.navigation import Navigation
 from office365.sharepoint.permissions.base_permissions import BasePermissions
@@ -74,8 +76,13 @@ from office365.sharepoint.webs.theme_info import ThemeInfo
 
 
 class Web(SecurableObject):
-    """Represents a SharePoint site. A site is a type of SP.SecurableObject.
-    Refer this link https://msdn.microsoft.com/en-us/library/office/dn499819.aspx for a details"""
+    """
+    Represents a SharePoint site. A site is a type of SecurableObject.
+
+    A group of related webpages that is hosted by a server on the World Wide Web or an intranet.
+    Each website has its own entry points, metadata, administration settings, and workflows.
+    Also referred to as web site.
+    """
 
     def __init__(self, context, resource_path=None):
         """
@@ -89,6 +96,16 @@ class Web(SecurableObject):
         super(Web, self).__init__(context, resource_path)
         self._web_url = None
 
+    def add_list(self, title, template_type=ListTemplateType.GenericList):
+        """
+        Creates a new list and adds it to the web.
+
+        :param str title: Specifies the display name of the new list.
+        :param int template_type: Specifies the list server template of the new list.
+        """
+        info = ListCreationInformation(title, None, template_type)
+        return self.lists.add(info)
+
     def available_addins(self, server_relative_urls=None):
         """
         :param list[str] server_relative_urls:
@@ -131,6 +148,7 @@ class Web(SecurableObject):
         return result
 
     def consent_to_power_platform(self):
+        """"""
         return_type = FlowSynchronizationResult(self.context)
         qry = ServiceOperationQuery(self, "ConsentToPowerPlatform", None, None, None, return_type)
         self.context.add_query(qry)
@@ -185,19 +203,21 @@ class Web(SecurableObject):
         """
         return_type = PushNotificationSubscriberCollection(self.context)
 
-        def _create_query(login_name):
-            return ServiceOperationQuery(self, "GetPushNotificationSubscribersByUser",
-                                         [login_name], None, None, return_type)
+        def _create_and_add_query(login_name):
+            """
+            :type login_name: str
+            """
+            qry = ServiceOperationQuery(self, "GetPushNotificationSubscribersByUser",
+                                        [login_name], None, None, return_type)
+            self.context.add_query(qry)
 
         if isinstance(user, User):
             def _user_loaded():
-                next_qry = _create_query(user.login_name)
-                self.context.add_query(next_qry)
+                _create_and_add_query(user.login_name)
 
             user.ensure_property("LoginName", _user_loaded)
         else:
-            qry = _create_query(user)
-            self.context.add_query(qry)
+            _create_and_add_query(user)
         return return_type
 
     @staticmethod
@@ -369,7 +389,6 @@ class Web(SecurableObject):
     def add_supported_ui_language(self, lcid):
         """
         Adds a supported UI language by its language identifier.
-
         :param int lcid: Specifies the language identifier to be added.
         """
         qry = ServiceOperationQuery(self, "AddSupportedUILanguage", {"lcid": lcid})
@@ -1396,8 +1415,8 @@ class Web(SecurableObject):
 
     @property
     def allow_rss_feeds(self):
-        """Gets a Boolean value that specifies whether the site collection allows RSS feeds.
-
+        """
+        Gets a Boolean value that specifies whether the site collection allows RSS feeds.
         :rtype: str
         """
         return self.properties.get("AllowRssFeeds", None)

office365/sharepoint/workflowservices/manager.py

@@ -6,7 +6,6 @@ from office365.sharepoint.base_entity import BaseEntity
 class WorkflowServicesManager(BaseEntity):
     """Describes the workflow host configuration states and provides service objects that interact with the workflow."""
 
-
     def get_workflow_instance_service(self):
         """Returns the WorkflowInstanceService (manages and reads workflow instances from the workflow host),
         which manages workflow instances."""
@@ -16,7 +15,6 @@ class WorkflowServicesManager(BaseEntity):
         self.context.add_query(qry)
         return return_type
 
-
     @staticmethod
     def current(context):
         """

office365/subscriptions/collection.py

@@ -0,0 +1,42 @@
+from office365.entity_collection import EntityCollection
+from office365.runtime.queries.create_entity import CreateEntityQuery
+from office365.subscriptions.subscription import Subscription
+
+
+class SubscriptionCollection(EntityCollection):
+
+    def __init__(self, context, resource_path=None):
+        super(SubscriptionCollection, self).__init__(context, Subscription, resource_path)
+
+    def add(self, change_type, notification_url, resource_path, expiration, client_state=None,
+            latest_supported_tls_version=None):
+        """
+        Subscribes a listener application to receive change notifications when the requested type of changes occur
+        to the specified resource in Microsoft Graph.
+
+        :param str change_type: Indicates the type of change in the subscribed resource that will raise a change
+           notification
+        :param str notification_url: The URL of the endpoint that will receive the change notifications.
+            This URL must make use of the HTTPS protocol. Any query string parameter included in the notificationUrl
+            property will be included in the HTTP POST request when Microsoft Graph sends the change notifications.
+        :param office365.runtime.paths.resource_path.ResourcePath or str resource_path:
+        :param datetime.datetime expiration:  Specifies the date and time when the webhook subscription expires.
+        :param str client_state: Specifies the value of the clientState property sent by the service in each change
+            notification
+        :param str latest_supported_tls_version:  Specifies the latest version of Transport Layer Security (TLS) that
+            the notification endpoint, specified by notificationUrl, supports.
+            The possible values are: v1_0, v1_1, v1_2, v1_3.
+        """
+        return_type = Subscription(self.context)
+        self.add_child(return_type)
+        payload = {
+            "changeType": change_type,
+            "notificationUrl": notification_url,
+            "resource": str(resource_path),
+            "expirationDateTime": expiration.isoformat() + "Z",
+            "clientState": client_state,
+            "latestSupportedTlsVersion": latest_supported_tls_version
+        }
+        qry = CreateEntityQuery(self, payload, return_type)
+        self.context.add_query(qry)
+        return return_type

office365/subscriptions/subscription.py

@@ -1,3 +1,5 @@
+import datetime
+
 from office365.entity import Entity
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 
@@ -6,7 +8,7 @@ class Subscription(Entity):
     """A subscription allows a client app to receive change notifications about changes to data in Microsoft Graph"""
 
     def reauthorize(self):
-        """"""
+        """Reauthorize a subscription when you receive a reauthorizationRequired challenge."""
         qry = ServiceOperationQuery(self, "reauthorize")
         self.context.add_query(qry)
         return self
@@ -15,11 +17,119 @@ class Subscription(Entity):
     def application_id(self):
         """
         Identifier of the application used to create the subscription.
-
         :rtype: str or None
         """
         return self.properties.get("applicationId", None)
 
+    @property
+    def change_type(self):
+        """
+        Required. Indicates the type of change in the subscribed resource that will raise a change notification.
+        The supported values are: created, updated, deleted.
+        Multiple values can be combined using a comma-separated list.
+
+        Note:
+        Drive root item and list change notifications support only the updated changeType.
+        User and group change notifications support updated and deleted changeType. Use updated to receive
+        notifications when user or group is created, updated or soft deleted. Use deleted to receive notifications
+        when user or group is permanently deleted.
+        :rtype: str or None
+        """
+        return self.properties.get("changeType", None)
+
+    @property
+    def client_state(self):
+        """
+        Required. Specifies the value of the clientState property sent by the service in each change notification.
+        The maximum length is 128 characters. The client can check that the change notification came from the service
+        by comparing the value of the clientState property sent with the subscription with the value of the clientState
+        property received with each change notification.
+        :rtype: str or None
+        """
+        return self.properties.get("clientState", None)
+
+    @property
+    def creator_id(self):
+        """
+        Optional. Identifier of the user or service principal that created the subscription. If the app used
+        delegated permissions to create the subscription, this field contains the id of the signed-in user the app
+        called on behalf of. If the app used application permissions, this field contains the id of the service
+        principal corresponding to the app. Read-only.
+        :rtype: str or None
+        """
+        return self.properties.get("creatorId", None)
+
+    @property
+    def encryption_certificate(self):
+        """
+        Optional. A base64-encoded representation of a certificate with a public key used to encrypt resource data in
+        change notifications. Optional but required when includeResourceData is true.
+        :rtype: str or None
+        """
+        return self.properties.get("encryptionCertificate", None)
+
+    @property
+    def encryption_certificate_id(self):
+        """
+        Optional. A custom app-provided identifier to help identify the certificate needed to decrypt resource data.
+        :rtype: str or None
+        """
+        return self.properties.get("encryptionCertificateId", None)
+
+    @property
+    def expiration_datetime(self):
+        """
+        Required. Specifies the date and time when the webhook subscription expires. The time is in UTC, and can be
+        an amount of time from subscription creation that varies for the resource subscribed to
+        """
+        return self.properties.get("expirationDateTime", datetime.datetime)
+
+    @property
+    def include_resource_data(self):
+        """
+        Optional. When set to true, change notifications include resource data (such as content of a chat message).
+        :rtype: bool
+        """
+        return self.properties.get("includeResourceData", None)
+
+    @property
+    def latest_supported_tls_version(self):
+        """
+        Optional. Specifies the latest version of Transport Layer Security (TLS) that the notification endpoint,
+        specified by notificationUrl, supports. The possible values are: v1_0, v1_1, v1_2, v1_3.
+
+        For subscribers whose notification endpoint supports a version lower than the currently recommended
+        version (TLS 1.2), specifying this property by a set timeline allows them to temporarily use their deprecated
+        version of TLS before completing their upgrade to TLS 1.2. For these subscribers, not setting this property
+        per the timeline would result in subscription operations failing.
+
+        For subscribers whose notification endpoint already supports TLS 1.2, setting this property is optional.
+        In such cases, Microsoft Graph defaults the property to v1_2.
+        :rtype: str
+        """
+        return self.properties.get("latestSupportedTlsVersion", None)
+
+    @property
+    def lifecycle_notification_url(self):
+        """
+        Required for Teams resources if the expirationDateTime value is more than 1 hour from now; optional otherwise.
+        The URL of the endpoint that receives lifecycle notifications, including subscriptionRemoved,
+        reauthorizationRequired, and missed notifications. This URL must make use of the HTTPS protocol.
+        For more information, see Reduce missing subscriptions and change notifications.
+        :rtype: str or None
+        """
+        return self.properties.get("lifecycleNotificationUrl", None)
+
+    @property
+    def notification_url(self):
+        """
+        Required. The URL of the endpoint that will receive the change notifications. This URL must make use of
+        the HTTPS protocol. Any query string parameter included in the notificationUrl property will be included
+        in the HTTP POST request when Microsoft Graph sends the change notifications.
+        :rtype: str or None
+        """
+        return self.properties.get("notificationUrl", None)
+
     @property
     def resource(self):
         """
@@ -30,3 +140,11 @@ class Subscription(Entity):
         :rtype: str or None
         """
         return self.properties.get("resource", None)
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {
+                "expirationDateTime": self.expiration_datetime,
+            }
+            default_value = property_mapping.get(name, None)
+        return super(Subscription, self).get_property(name, default_value)

office365/teams/apps/catalog.py

@@ -0,0 +1,23 @@
+from office365.entity import Entity
+from office365.entity_collection import EntityCollection
+from office365.runtime.paths.resource_path import ResourcePath
+from office365.teams.apps.app import TeamsApp
+
+
+class AppCatalogs(Entity):
+    """A container for apps from the Microsoft Teams app catalog"""
+
+    @property
+    def teams_apps(self):
+        """List apps from the Microsoft Teams app catalog."""
+        return self.properties.get('teamsApps',
+                                   EntityCollection(self.context, TeamsApp,
+                                                    ResourcePath("teamsApps", self.resource_path)))
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {
+                "teamsApps": self.teams_apps
+            }
+            default_value = property_mapping.get(name, None)
+        return super(AppCatalogs, self).get_property(name, default_value)