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

office365/teams/associated_info.py

@@ -0,0 +1,12 @@
+from office365.teams.info import TeamInfo
+
+
+class AssociatedTeamInfo(TeamInfo):
+    """
+    Represents a team that is associated with a user.
+
+    Currently, a user can be associated with a team in two different ways:
+
+        - A user can be a direct member of a team.
+        - A user can be a member of a shared channel that is hosted inside a team.
+    """

office365/teams/channels/channel.py

@@ -8,8 +8,8 @@ from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.queries.function import FunctionQuery
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.teams.channels.provision_email_result import ProvisionChannelEmailResult
+from office365.teams.chats.messages.message import ChatMessage
 from office365.teams.members.conversation import ConversationMember
-from office365.teams.chats.message import ChatMessage
 from office365.teams.tabs.tab import TeamsTab
 
 
@@ -125,6 +125,5 @@ class Channel(Entity):
         super(Channel, self).set_property(name, value, persist_changes)
         # fallback: fix resource path
         if name == "id":
-            channel_id = quote(value)
-            self._resource_path = ResourcePath(channel_id, self.resource_path.parent)
+            self._resource_path = ResourcePath(quote(value), self.resource_path.parent)
         return self

office365/teams/channels/collection.py

@@ -1,7 +1,7 @@
 from office365.entity_collection import EntityCollection
 from office365.runtime.queries.function import FunctionQuery
 from office365.teams.channels.channel import Channel
-from office365.teams.chats.message import ChatMessage
+from office365.teams.chats.messages.message import ChatMessage
 
 
 class ChannelCollection(EntityCollection):

office365/teams/channels/iIdentity.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class ChannelIdentity(ClientValue):
+    """Contains basic identification information about a channel in Microsoft Teams."""

office365/teams/chats/chat.py

@@ -2,7 +2,9 @@ from office365.entity import Entity
 from office365.entity_collection import EntityCollection
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.teams.apps.installation import TeamsAppInstallation
-from office365.teams.chats.message import ChatMessage
+from office365.teams.chats.messages.message import ChatMessage
+
+from office365.teams.chats.messages.info import ChatMessageInfo
 from office365.teams.members.conversation_collection import ConversationMemberCollection
 from office365.teams.operations.async_operation import TeamsAsyncOperation
 from office365.teams.tabs.tab import TeamsTab
@@ -24,6 +26,13 @@ class Chat(Entity):
                                    EntityCollection(self.context, TeamsAppInstallation,
                                                     ResourcePath("installedApps", self.resource_path)))
 
+    @property
+    def last_message_preview(self):
+        """Preview of the last message sent in the chat. Null if no messages have been sent in the chat."""
+        return self.properties.get('lastMessagePreview',
+                                   ChatMessageInfo(self.context,
+                                                   ResourcePath("lastMessagePreview", self.resource_path)))
+
     @property
     def members(self):
         """A collection of membership records associated with the chat.
@@ -56,7 +65,8 @@ class Chat(Entity):
     def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {
-                "installedApps": self.installed_apps
+                "installedApps": self.installed_apps,
+                "lastMessagePreview": self.last_message_preview
             }
             default_value = property_mapping.get(name, None)
         return super(Chat, self).get_property(name, default_value)

office365/teams/chats/collection.py

@@ -18,6 +18,5 @@ class ChatCollection(EntityCollection):
         :param str chat_type: Specifies the type of chat. Possible values are: group and oneOnOne.
         :rtype: Chat
         """
-        return super(ChatCollection, self).add(chatType=chat_type)
-
 
+        return super(ChatCollection, self).add(chatType=chat_type)

office365/teams/chats/messages/info.py

@@ -0,0 +1,14 @@
+from office365.entity import Entity
+from office365.outlook.mail.item_body import ItemBody
+
+
+class ChatMessageInfo(Entity):
+    """Represents a preview of a chatMessage resource. This object can only be fetched as part of a list of chats."""
+
+    @property
+    def body(self):
+        """
+        Body of the chatMessage. This will still contain markers for @mentions and attachments even though the
+        object does not return @mentions and attachments..
+        """
+        return self.properties.get("body", ItemBody())

office365/teams/chats/{message.py → messages/message.py}

@@ -1,8 +1,10 @@
 from office365.entity import Entity
 from office365.entity_collection import EntityCollection
+from office365.outlook.mail.item_body import ItemBody
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.runtime.paths.resource_path import ResourcePath
-from office365.teams.chats.message_attachment import ChatMessageAttachment
+from office365.teams.channels.iIdentity import ChannelIdentity
+from office365.teams.chats.messages.attachment import ChatMessageAttachment
 
 
 class ChatMessage(Entity):
@@ -16,6 +18,21 @@ class ChatMessage(Entity):
         """The collection of replies."""
         return self.properties.get("attachments", ClientValueCollection(ChatMessageAttachment))
 
+    @property
+    def body(self):
+        """
+        Plaintext/HTML representation of the content of the chat message. Representation is specified by the
+        contentType inside the body. The content is always in HTML if the chat message contains a chatMessageMention.
+        """
+        return self.properties.get("body", ItemBody())
+
+    @property
+    def channel_identity(self):
+        """
+        If the message was sent in a channel, represents identity of the channel.
+        """
+        return self.properties.get("channelIdentity", ChannelIdentity())
+
     @property
     def replies(self):
         """
@@ -29,7 +46,6 @@ class ChatMessage(Entity):
     def web_url(self):
         """
         Link to the message in Microsoft Teams.
-
         :rtype: str
         """
         return self.properties.get("webUrl", None)
@@ -38,7 +54,6 @@ class ChatMessage(Entity):
     def importance(self):
         """
         The importance of the chat message. The possible values are: normal, high, urgent.
-
         :rtype: str
         """
         return self.properties.get("importance", None)

office365/teams/info.py

@@ -0,0 +1,20 @@
+from office365.entity import Entity
+from office365.runtime.paths.resource_path import ResourcePath
+
+
+class TeamInfo(Entity):
+    """Represents a team with basic information."""
+
+    @property
+    def display_name(self):
+        """
+        The name of the team.
+        :rtype: str or None
+        """
+        return self.properties.get('displayName', None)
+
+    @property
+    def team(self):
+        from office365.teams.team import Team
+        return self.properties.get('team',
+                                   Team(self.context, ResourcePath("team", self.resource_path)))

office365/teams/members/aad_user_conversation.py

@@ -7,8 +7,8 @@ class AadUserConversationMember(ConversationMember):
 
     @property
     def user_id(self):
-        """The guid of the user.
-
+        """
+        The guid of the user.
         :rtype: str or None
         """
         return self.properties.get("userId", None)

office365/teams/members/conversation_collection.py

@@ -7,16 +7,16 @@ class ConversationMemberCollection(EntityCollection):
     def __init__(self, context, resource_path=None):
         super(ConversationMemberCollection, self).__init__(context, ConversationMember, resource_path)
 
-    def add(self, user, roles, visible_history_start_date_time=None):
+    def add(self, user, roles, visible_history_start_datetime=None):
         """
         Add a conversationMember.
 
-        :param str  or office365.directory.users.user.User user: The conversation members that should be added.
+        :param str or office365.directory.users.user.User user: The conversation members that should be added.
             Every user who will participate in the chat, including the user who initiates the create request,
             must be specified in this list.
             Each member must be assigned a role of owner or guest. Guest tenant members must be assigned the guest role
         :param list[str] roles: The roles for that user.
-        :param datetime.datetime visible_history_start_date_time:
+        :param datetime.datetime visible_history_start_datetime:
 
         :rtype: ConversationMember
         """

office365/teams/schedule/change_request.py

@@ -6,7 +6,9 @@ class ScheduleChangeRequest(ChangeTrackedEntity):
 
     def approve(self, message):
         """
-        :param str message:
+        Approve an ScheduleChangeRequest object.
+
+        :param str message: A custom approval message.
         """
         qry = ServiceOperationQuery(self, "approve", None, {"message": message})
         self.context.add_query(qry)
@@ -14,7 +16,7 @@ class ScheduleChangeRequest(ChangeTrackedEntity):
 
     def decline(self, message):
         """
-        :param str message:
+        :param str message: A custom approval message.
         """
         qry = ServiceOperationQuery(self, "decline", None, {"message": message})
         self.context.add_query(qry)

office365/teams/schedule/change_tracked_entity.py

@@ -1,3 +1,5 @@
+from datetime import datetime
+
 from office365.directory.permissions.identity_set import IdentitySet
 from office365.entity import Entity
 
@@ -11,7 +13,7 @@ class ChangeTrackedEntity(Entity):
         The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.
         For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
         """
-        return self.properties.get('createdDateTime', None)
+        return self.properties.get('createdDateTime', datetime.min)
 
     @property
     def last_modified_datetime(self):
@@ -19,9 +21,16 @@ class ChangeTrackedEntity(Entity):
         The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.
         For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
         """
-        return self.properties.get('lastModifiedDateTime', None)
+        return self.properties.get('lastModifiedDateTime', datetime.min)
 
     @property
     def last_modified_by(self):
         """Identity of the person who last modified the entity."""
         return self.properties.get('lastModifiedBy', IdentitySet())
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {
+            }
+            default_value = property_mapping.get(name, None)
+        return super(ChangeTrackedEntity, self).get_property(name, default_value)

office365/teams/summary.py

@@ -0,0 +1,15 @@
+from office365.runtime.client_value import ClientValue
+
+
+class TeamSummary(ClientValue):
+    """Contains information about a team in Microsoft Teams, including number of owners, members, and guests."""
+
+    def __init__(self, guests_count=None, members_count=None, owners_count=None):
+        """
+        :param int guests_count: Count of guests in a team.
+        :param int members_count: Count of members in a team.
+        :param int owners_count: Count of owners in a team.
+        """
+        self.guestsCount = guests_count
+        self.membersCount = members_count
+        self.ownersCount = owners_count

office365/teams/tabs/configuration.py

@@ -6,4 +6,15 @@ class TeamsTabConfiguration(ClientValue):
     When a tab is interactively configured, this information is set by the tab provider application.
     In addition to the properties below, some tab provider applications specify additional custom properties.
     """
-    pass
+
+    def __init__(self, content_url=None, entity_id=None, remove_url=None, website_url=None):
+        """
+        :param str content_url: Url used for rendering tab contents in Teams.
+        :param str entity_id: Identifier for the entity hosted by the tab provider.
+        :param str remove_url: Url called by Teams client when a Tab is removed using the Teams Client.
+        :param str website_url: Url for showing tab contents outside of Teams.
+        """
+        self.contentUrl = content_url
+        self.entityId = entity_id
+        self.removeUrl = remove_url
+        self.websiteUrl = website_url

office365/teams/tabs/tab.py

@@ -19,7 +19,6 @@ class TeamsTab(Entity):
     def configuration(self):
         """
         Container for custom settings applied to a tab. The tab is considered configured only once this property is set.
-        :rtype: TeamsTabConfiguration
         """
         return self.properties.get("configuration", TeamsTabConfiguration())
 

office365/teams/team.py

@@ -4,14 +4,17 @@ from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.teams.channels.channel import Channel
 from office365.teams.channels.collection import ChannelCollection
+from office365.teams.members.settings import TeamMemberSettings
 from office365.teams.schedule.schedule import Schedule
 from office365.teams.fun_settings import TeamFunSettings
 from office365.teams.guest_settings import TeamGuestSettings
-from office365.teams.member_settings import TeamMemberSettings
 from office365.teams.messaging_settings import TeamMessagingSettings
 from office365.teams.apps.installation import TeamsAppInstallation
 from office365.teams.operations.async_operation import TeamsAsyncOperation
+from office365.teams.summary import TeamSummary
+from office365.teams.teamwork.tags.tag import TeamworkTag
 from office365.teams.template import TeamsTemplate
+from office365.directory.permissions.grants.resource_specific import ResourceSpecificPermissionGrant
 
 
 class Team(Entity):
@@ -166,6 +169,35 @@ class Team(Entity):
                                           EntityCollection(self.context, TeamsAsyncOperation,
                                                            ResourcePath("operations", self.resource_path)))
 
+    @property
+    def permission_grants(self):
+        """
+        List all resource-specific permission grants
+        """
+        return self.properties.setdefault('permissionGrants',
+                                          EntityCollection(self.context, ResourceSpecificPermissionGrant,
+                                                           ResourcePath("permissionGrants")))
+
+    @property
+    def summary(self):
+        """Contains summary information about the team, including number of owners, members, and guests."""
+        return self.properties.get("summary", TeamSummary())
+
+    @property
+    def tenant_id(self):
+        """
+        The ID of the Azure Active Directory tenant.
+        :rtype: str
+        """
+        return self.properties.get("tenantId", None)
+
+    @property
+    def tags(self):
+        """	The tags associated with the team."""
+        return self.properties.get('tags',
+                                   EntityCollection(self.context, TeamworkTag,
+                                                    ResourcePath("tags", self.resource_path)))
+
     @property
     def template(self):
         """The template this team was created from
@@ -229,6 +261,7 @@ class Team(Entity):
                 "allChannels": self.all_channels,
                 "incomingChannels": self.incoming_channels,
                 "installedApps": self.installed_apps,
+                "permissionGrants": self.permission_grants,
                 "primaryChannel": self.primary_channel
             }
             default_value = property_mapping.get(name, None)

office365/teams/teamwork/activity_topic.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class TeamworkActivityTopic(ClientValue):
+    """Represents the topic of an activity feed notification."""

office365/teams/teamwork/tags/identity.py

@@ -0,0 +1,6 @@
+from office365.runtime.client_value import ClientValue
+
+
+class TeamworkTagIdentity(ClientValue):
+    """Represents a tag in Microsoft Teams. Tags allow users to quickly connect to subset of users in a team.
+    For details about tag management in Microsoft Teams, see Manage tags in Microsoft Teams."""

office365/teams/teamwork/tags/member.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class TeamworkTagMember(Entity):
+    """Represents a user in a team to whom a tag is applied."""

office365/teams/teamwork/tags/tag.py

@@ -0,0 +1,15 @@
+from office365.entity import Entity
+
+
+class TeamworkTag(Entity):
+    """
+    Represents a tag associated with a team.
+
+    Tags provide a flexible way for customers to classify users or groups based on a auth attribute within a team.
+    For example, a Nurse, Manager, or Designer tag will enable users to reach groups of people in Teams without
+    having to type every single name.
+
+    When a tag is added, users can @mention it in a channel. Everyone who has been assigned that tag will receive
+    a notification just as they would if they were @mentioned individually. Users can also use a tag to start
+    a new chat with the members of that tag.
+    """

office365/{directory/security/cases_root.py → teams/viva/employee_experience_user.py}

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

office365/todo/attachments/session.py

@@ -0,0 +1,34 @@
+from datetime import datetime
+
+from office365.entity import Entity
+from office365.runtime.types.collections import StringCollection
+
+
+class AttachmentSession(Entity):
+    """Represents a resource that uploads large attachments to a todoTask."""
+
+    @property
+    def content(self):
+        """The content streams that are uploaded."""
+        return self.properties.get("content", None)
+
+    @property
+    def expiration_datetime(self):
+        """The date and time in UTC when the upload session will expire.
+        The complete file must be uploaded before this expiration time is reached."""
+        return self.properties.get("expirationDateTime", datetime.min)
+
+    @property
+    def next_expected_ranges(self):
+        """Indicates a single value {start} that represents the location in the file where the next
+        upload should begin."""
+        return self.properties.get("nextExpectedRanges", StringCollection())
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {
+                "expirationDateTime": self.expiration_datetime,
+                "nextExpectedRanges": self.next_expected_ranges
+            }
+            default_value = property_mapping.get(name, None)
+        return super(AttachmentSession, self).get_property(name, default_value)

office365/todo/linked_resource.py

@@ -8,5 +8,14 @@ class LinkedResource(Entity):
 
     @property
     def application_name(self):
-        """Field indicating the app name of the source that is sending the linkedResource."""
+        """Field indicating the app name of the source that is sending the linkedResource.
+        :rtype: str
+        """
         return self.properties.get("applicationName", None)
+
+    @property
+    def display_name(self):
+        """The title of the linkedResource..
+        :rtype: str
+        """
+        return self.properties.get("displayName", None)

office365/todo/tasks/task.py

@@ -30,6 +30,10 @@ class TodoTask(Entity):
                                    EntityCollection(self.context, LinkedResource,
                                                     ResourcePath("linkedResources", self.resource_path)))
 
+    @property
+    def entity_type_name(self):
+        return None
+
     def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {

office365/directory/identities/protection_root.py

@@ -1,5 +0,0 @@
-from office365.entity import Entity
-
-
-class IdentityProtectionRoot(Entity):
-    """Container for the navigation properties for Microsoft Graph identity protection resources."""

office365/directory/rbac/application.py

@@ -1,18 +0,0 @@
-from office365.directory.rbac.unified_role_assignment import UnifiedRoleAssignment
-from office365.entity import Entity
-from office365.entity_collection import EntityCollection
-from office365.runtime.paths.resource_path import ResourcePath
-
-
-class RbacApplication(Entity):
-    """Role management container for unified role definitions and role assignments for Microsoft 365 role-based
-    access control (RBAC) providers. The role assignments support only a single principal and a single scope.
-    Currently directory and entitlementManagement are the two RBAC providers supported."""
-
-    @property
-    def role_assignments(self):
-        """Resource to grant access to users or groups."""
-        return self.properties.get('roleAssignments',
-                                   EntityCollection(self.context, UnifiedRoleAssignment,
-                                                    ResourcePath("roleAssignments", self.resource_path)))
-

office365/directory/rbac/unified_role_assignment.py

@@ -1,8 +0,0 @@
-from office365.entity import Entity
-
-
-class UnifiedRoleAssignment(Entity):
-    """
-    A role assignment is used to grant access to resources. It represents a role definition assigned to a principal
-    (for example, a user or a role-assignable group) at a particular scope.
-    """

office365/external/connection.py

@@ -1,5 +0,0 @@
-from office365.entity import Entity
-
-
-class ExternalConnection(Entity):
-    """A logical container to add content from an external source into Microsoft Graph."""

office365/intune/devices/management.py

@@ -1,35 +0,0 @@
-from office365.entity import Entity
-from office365.entity_collection import EntityCollection
-from office365.intune.audit.event import AuditEventCollection
-from office365.intune.devices.managed import ManagedDevice
-from office365.runtime.paths.resource_path import ResourcePath
-
-
-class DeviceManagement(Entity):
-    """
-    The deviceManagement resource represents a tenant's collection device identities that have been pre-staged in
-    Intune, and the enrollment profiles that may be assigned to device identities that support pre-enrollment
-    configuration.
-    """
-
-    @property
-    def audit_events(self):
-        """"""
-        return self.properties.get("auditEvents", AuditEventCollection(self.context,
-                                                                       ResourcePath("auditEvents", self.resource_path)))
-
-    @property
-    def managed_devices(self):
-        """"""
-        return self.properties.get('managedDevices',
-                                   EntityCollection(self.context, ManagedDevice,
-                                                    ResourcePath("managedDevices", self.resource_path)))
-
-    def get_property(self, name, default_value=None):
-        if default_value is None:
-            property_mapping = {
-                "auditEvents": self.audit_events,
-                "managedDevices": self.managed_devices
-            }
-            default_value = property_mapping.get(name, None)
-        return super(DeviceManagement, self).get_property(name, default_value)

office365/onedrive/internal/queries/download_content.py

@@ -1,26 +0,0 @@
-from office365.runtime.client_result import ClientResult
-from office365.runtime.queries.function import FunctionQuery
-from office365.runtime.queries.service_operation import ServiceOperationQuery
-
-
-def create_download_content_query(file_item, format_name=None):
-    """
-    :type file_item: office365.onedrive.driveItem.DriveItem
-    :type format_name: str or None
-    """
-    return_type = ClientResult(file_item.context)
-    action_name = "content"
-    if format_name is not None:
-        action_name = action_name + r"?format={0}".format(format_name)
-    return FunctionQuery(file_item, action_name, None, return_type)
-
-
-def create_download_session_content_query(file_item, format_name=None):
-    """
-    :type file_item: office365.onedrive.driveItem.DriveItem
-    :type format_name: str or None
-    """
-    action_name = "content"
-    if format_name is not None:
-        action_name = action_name + r"?format={0}".format(format_name)
-    return ServiceOperationQuery(file_item, action_name)

office365/onedrive/internal/queries/upload_content.py

@@ -1,23 +0,0 @@
-from office365.onedrive.internal.paths.url import UrlPath
-from office365.runtime.http.http_method import HttpMethod
-from office365.runtime.queries.service_operation import ServiceOperationQuery
-
-
-def create_upload_content_query(folder_item, name, content=None):
-    """
-
-    :param office365.onedrive.driveItem.DriveItem folder_item: Folder (container)
-    :param str name: a file name
-    :param str content: a file content
-    """
-    from office365.onedrive.driveitems.driveItem import DriveItem
-    return_type = DriveItem(folder_item.context, UrlPath(name, folder_item.resource_path))
-    qry = ServiceOperationQuery(return_type, "content", None, content, None, return_type)
-
-    def _modify_query(request):
-        """
-        :type request: office365.runtime.http.request_options.RequestOptions
-        """
-        request.method = HttpMethod.Put
-    folder_item.context.before_execute(_modify_query)
-    return qry

office365/outlook/mail/messages/message_rule.py

@@ -1,15 +0,0 @@
-from office365.entity import Entity
-
-
-class MessageRule(Entity):
-    """A rule that applies to messages in the Inbox of a user.
-
-    In Outlook, you can set up rules for incoming messages in the Inbox to carry out specific internal
-    upon certain conditions."""
-
-    @property
-    def is_read_only(self):
-        """
-        Indicates if the rule is read-only and cannot be modified or deleted by the rules REST API.
-        """
-        return self.properties.get("isReadOnly", None)