Office365-REST-Python-Client 2.6.0__py3-none-any.whl → 2.6.2__py3-none-any.whl

office365/teams/teamwork/user.py

@@ -1,15 +1,59 @@
+from typing import Optional
+
 from office365.entity import Entity
 from office365.entity_collection import EntityCollection
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.teams.apps.user_scope_installation import UserScopeTeamsAppInstallation
+from office365.teams.associated_info import AssociatedTeamInfo
 
 
 class UserTeamwork(Entity):
     """A container for the range of Microsoft Teams functionalities that are available per user in the tenant."""
 
+    @property
+    def locale(self):
+        # type: () -> Optional[str]
+        """Represents the location that a user selected in Microsoft Teams and doesn't follow the Office's locale
+        setting. A user's locale is represented by their preferred language and country or region.
+        For example, en-us. The language component follows two-letter codes as defined in ISO 639-1,
+        and the country component follows two-letter codes as defined in ISO 3166-1 alpha-2.
+        """
+        return self.properties.get("locale", None)
+
+    @property
+    def region(self):
+        # type: () -> Optional[str]
+        """Represents the region of the organization or the user. For users with multigeo licenses, the property
+        contains the user's region (if available). For users without multigeo licenses, the property contains
+        the organization's region.
+
+        The region value can be any region supported by the Teams payload.
+        The possible values are: Americas, Europe and MiddleEast, Asia Pacific, UAE, Australia, Brazil, Canada,
+        Switzerland, Germany, France, India, Japan, South Korea, Norway, Singapore, United Kingdom, South Africa,
+        Sweden, Qatar, Poland, Italy, Israel, Spain, Mexico, USGov Community Cloud, USGov Community Cloud High,
+        USGov Department of Defense, and China.
+        """
+        return self.properties.get("region", None)
+
+    @property
+    def associated_teams(self):
+        # type: () -> EntityCollection[AssociatedTeamInfo]
+        """
+        The apps installed in the personal scope of this user.
+        """
+        return self.properties.get(
+            "associatedTeams",
+            EntityCollection(
+                self.context,
+                AssociatedTeamInfo,
+                ResourcePath("associatedTeams", self.resource_path),
+            ),
+        )
+
     @property
     def installed_apps(self):
+        # type: () -> EntityCollection[UserScopeTeamsAppInstallation]
         """
         The apps installed in the personal scope of this user.
         """
@@ -51,6 +95,9 @@ class UserTeamwork(Entity):
 
     def get_property(self, name, default_value=None):
         if default_value is None:
-            property_mapping = {"installedApps": self.installed_apps}
+            property_mapping = {
+                "associatedTeams": self.associated_teams,
+                "installedApps": self.installed_apps,
+            }
             default_value = property_mapping.get(name, None)
         return super(UserTeamwork, self).get_property(name, default_value)

office365/teams/teamwork/user_identity.py

@@ -0,0 +1,5 @@
+from office365.directory.permissions.identity import Identity
+
+
+class TeamworkUserIdentity(Identity):
+    """Represents a user in Microsoft Teams."""

office365/teams/viva/community.py

@@ -0,0 +1,13 @@
+from office365.entity import Entity
+
+
+class Community(Entity):
+    """Represents a community in Viva Engage that is a central place for conversations, files, events, and
+     updates for people sharing a common interest or goal.
+
+    Every community is associated with a Microsoft 365 group, but the group doesn't have the same ID as the community.
+    For more information about managing communities in Viva Engage, see Use the Microsoft Graph API to work
+    with Viva Engage.
+
+    This resource is an open type that allows other properties to be passed in.
+    """

office365/teams/viva/employee_experience.py

@@ -1,12 +1,38 @@
 from office365.entity import Entity
 from office365.entity_collection import EntityCollection
 from office365.runtime.paths.resource_path import ResourcePath
+from office365.teams.viva.community import Community
+from office365.teams.viva.learning.courses.activity import LearningCourseActivity
 from office365.teams.viva.learning.provider import LearningProvider
 
 
 class EmployeeExperience(Entity):
     """Represents a container that exposes navigation properties for employee experience resources."""
 
+    @property
+    def communities(self):
+        """A collection of communities in Viva Engage."""
+        return self.properties.get(
+            "communities",
+            EntityCollection(
+                self.context,
+                Community,
+                ResourcePath("communities", self.resource_path),
+            ),
+        )
+
+    @property
+    def learning_course_activities(self):
+        """A collection of learning course activities."""
+        return self.properties.get(
+            "learningCourseActivities",
+            EntityCollection(
+                self.context,
+                LearningCourseActivity,
+                ResourcePath("learningCourseActivities", self.resource_path),
+            ),
+        )
+
     @property
     def learning_providers(self):
         """A collection of learning providers."""
@@ -22,6 +48,7 @@ class EmployeeExperience(Entity):
     def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {
+                "learningCourseActivities": self.learning_course_activities,
                 "learningProviders": self.learning_providers,
             }
             default_value = property_mapping.get(name, None)

office365/teams/viva/employee_experience_user.py

@@ -1,5 +1,21 @@
 from office365.entity import Entity
+from office365.entity_collection import EntityCollection
+from office365.runtime.paths.resource_path import ResourcePath
+from office365.teams.viva.learning.courses.activity import LearningCourseActivity
 
 
 class EmployeeExperienceUser(Entity):
     """"""
+
+    @property
+    def learning_course_activities(self):
+        # type: () -> EntityCollection[LearningCourseActivity]
+        """Get a list of the learningCourseActivity objects (assigned or self-initiated) for a user."""
+        return self.properties.get(
+            "learningCourseActivities",
+            EntityCollection(
+                self.context,
+                LearningCourseActivity,
+                ResourcePath("learningCourseActivities", self.resource_path),
+            ),
+        )

office365/teams/viva/learning/courses/self_initiated.py

@@ -0,0 +1,5 @@
+from office365.teams.viva.learning.courses.activity import LearningCourseActivity
+
+
+class LearningSelfInitiatedCourse(LearningCourseActivity):
+    """Represents the details of a learning course activity that is self-initiated by a user."""

office365/todo/attachments/task_file.py

@@ -1,3 +1,5 @@
+from typing import AnyStr, Optional
+
 from office365.todo.attachments.base import AttachmentBase
 
 
@@ -10,5 +12,6 @@ class TaskFileAttachment(AttachmentBase):
 
     @property
     def content_bytes(self):
+        # type: () -> Optional[AnyStr]
         """The base64-encoded contents of the file."""
         return self.properties.get("contentBytes", None)

office365/todo/checklist_item.py

@@ -1,6 +1,17 @@
+from typing import Optional
+
 from office365.entity import Entity
 
 
 class ChecklistItem(Entity):
     """Represents a subtask in a bigger todoTask. ChecklistItem allows breaking down a complex task into more
     actionable, smaller tasks."""
+
+    def __str__(self):
+        return self.display_name or self.entity_type_name
+
+    @property
+    def display_name(self):
+        # type: () -> Optional[str]
+        """Indicates the title of the checklistItem."""
+        return self.properties.get("displayName", None)

office365/todo/tasks/list.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.directory.extensions.extension import Extension
 from office365.entity import Entity
 from office365.entity_collection import EntityCollection
@@ -8,6 +10,15 @@ from office365.todo.tasks.task import TodoTask
 class TodoTaskList(Entity):
     """A list in Microsoft To Do that contains one or more todoTask resources."""
 
+    def __str__(self):
+        return self.display_name or self.entity_type_name
+
+    @property
+    def display_name(self):
+        # type: () -> Optional[str]
+        """The name of the task list."""
+        return self.properties.get("displayName", None)
+
     @property
     def extensions(self):
         # type: () -> EntityCollection[Extension]

office365/todo/tasks/task.py

@@ -1,7 +1,11 @@
+from typing import Optional
+
 from office365.directory.extensions.extension import Extension
 from office365.entity import Entity
 from office365.entity_collection import EntityCollection
+from office365.outlook.mail.item_body import ItemBody
 from office365.runtime.paths.resource_path import ResourcePath
+from office365.todo.attachments.base import AttachmentBase
 from office365.todo.checklist_item import ChecklistItem
 from office365.todo.linked_resource import LinkedResource
 
@@ -9,6 +13,33 @@ from office365.todo.linked_resource import LinkedResource
 class TodoTask(Entity):
     """A todoTask represents a task, such as a piece of work or personal item, that can be tracked and completed."""
 
+    def __str__(self):
+        return self.title or self.entity_type_name
+
+    @property
+    def body(self):
+        """The task body that typically contains information about the task."""
+        return self.properties.get("body", ItemBody())
+
+    @property
+    def title(self):
+        # type: () -> Optional[str]
+        """A brief description of the task."""
+        return self.properties.get("title", None)
+
+    @property
+    def attachments(self):
+        # type: () -> EntityCollection[AttachmentBase]
+        """A collection of file attachments for the task."""
+        return self.properties.get(
+            "attachments",
+            EntityCollection(
+                self.context,
+                AttachmentBase,
+                ResourcePath("attachments", self.resource_path),
+            ),
+        )
+
     @property
     def extensions(self):
         # type: () -> EntityCollection[Extension]

office365/outlook/mail/tips.py

@@ -1,17 +0,0 @@
-from office365.outlook.mail.automatic_replies_mailtips import AutomaticRepliesMailTips
-from office365.runtime.client_value import ClientValue
-
-
-class MailTips(ClientValue):
-    """Informative messages about a recipient, that are displayed to users while they're composing a message.
-    For example, an out-of-office message as an automatic reply for a message recipient.
-    """
-
-    def __init__(self, automaticReplies=AutomaticRepliesMailTips(), customMailTip=None):
-        """
-        :param AutomaticRepliesMailTips automaticReplies: Mail tips for automatic reply if it has been set up by
-            the recipient.
-        :param str customMailTip: A custom mail tip that can be set on the recipient's mailbox.
-        """
-        self.automaticReplies = automaticReplies
-        self.customMailTip = customMailTip