Office365-REST-Python-Client 3.0.0__py3-none-any.whl → 3.2.0__py3-none-any.whl

office365/outlook/item.py

@@ -1,10 +1,9 @@
 from datetime import datetime
 from typing import Optional
 
-from typing_extensions import Self
-
 from office365.entity import Entity
 from office365.runtime.types.collections import StringCollection
+from office365.runtime.types.odata_property import odata
 
 
 class OutlookItem(Entity):
@@ -37,25 +36,18 @@ class OutlookItem(Entity):
         """
         return self.properties.get("lastModifiedDateTime", datetime.min)
 
+    @odata(name="createdDateTime")
     @property
     def created_date_time(self) -> datetime:
         """Gets the createdDateTime property"""
         return self.properties.get("createdDateTime", datetime.min)
 
+    @odata(name="lastModifiedDateTime")
     @property
     def last_modified_date_time(self) -> datetime:
         """Gets the lastModifiedDateTime property"""
         return self.properties.get("lastModifiedDateTime", datetime.min)
 
-    def get_property(self, name, default_value=None) -> Self:
-        if default_value is None:
-            property_mapping = {
-                "createdDateTime": self.created_datetime,
-                "lastModifiedDateTime": self.last_modified_datetime,
-            }
-            default_value = property_mapping.get(name, None)
-        return super().get_property(name, default_value)
-
     @property
     def entity_type_name(self) -> str:
         return "microsoft.graph.OutlookItem"

office365/outlook/locale_info.py

@@ -22,3 +22,7 @@ class LocaleInfo(ClientValue):
 
     def __repr__(self):
         return self.locale or ""
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.LocaleInfo"

office365/outlook/mail/attachments/attachment_item.py

@@ -14,6 +14,9 @@ class AttachmentItem(ClientValue):
     attachmentType: AttachmentType | None = None
     name: str | None = None
     size: int | None = None
+    contentId: str | None = None
+    contentType: str | None = None
+    isInline: bool | None = None
 
     @staticmethod
     def create_file(path: str) -> "AttachmentItem":
@@ -22,3 +25,7 @@ class AttachmentItem(ClientValue):
         from office365.outlook.mail.attachments.type import AttachmentType
 
         return AttachmentItem(attachmentType=AttachmentType.file, name=file_name, size=file_size)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.AttachmentItem"

office365/outlook/mail/attachments/collection.py

@@ -11,11 +11,11 @@ from office365.outlook.mail.attachments.attachment import Attachment
 from office365.outlook.mail.attachments.attachment_item import AttachmentItem
 from office365.runtime.client_result import ClientResult
 from office365.runtime.http.request_options import RequestOptions
+from office365.runtime.http.url import parse_query_param
 from office365.runtime.odata.v4.upload_session import UploadSession
 from office365.runtime.odata.v4.upload_session_request import UploadSessionRequest
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.queries.upload_session import UploadSessionQuery
-from office365.runtime.utilities import parse_query_param
 
 if TYPE_CHECKING:
     from office365.graph_client import GraphClient
@@ -33,34 +33,49 @@ class AttachmentCollection(EntityCollection[Attachment]):
         name: str,
         content: bytes | str | None = None,
         content_type: str | None = None,
-        base64_content: bytes | None = None,
     ):
-        """Attach a file to message
+        """Build a FileAttachment and register it as a child (inline attachments).
+
+        Use this for a draft that is about to be created. For an existing message
+        use :meth:`Message.add_file_attachment`, which POSTs the file to the
+        message's ``attachments`` collection instead.
+
+        Args:
+            name (str): The name of the file.
+            content (str or bytes): The file content — text (str) or raw bytes.
+            content_type (str or None): The content type of the attachment.
+
+        Returns:
+            The built FileAttachment.
+        """
+        attachment = self.create_file(name, content, content_type)
+        self.add_child(attachment)
+        return attachment
+
+    def create_file(
+        self,
+        name: str,
+        content: bytes | str | None = None,
+        content_type: str | None = None,
+    ):
+        """Build a FileAttachment without registering it (for a direct create).
 
         Args:
-            name (str): The name representing the text that is displayed below the icon representing the embedded
-              attachment
-            content (str or None): The contents of the file
+            name (str): The name of the file.
+            content (str or bytes): The file content — text (str) or raw bytes.
             content_type (str or None): The content type of the attachment.
-            base64_content (str or None): The contents of the file in the form of a base64 string.
         """
-        if not content and not base64_content:
-            raise TypeError("Either content or base64_content is required")
+        if not content:
+            raise TypeError("Content is required")
         from office365.outlook.mail.attachments.file import FileAttachment
 
+        raw = content.encode("utf-8") if isinstance(content, str) else content
         return_type = FileAttachment(self.context)
         return_type.name = name
-        if base64_content:
-            content_bytes: bytes = base64_content
-        else:
-            assert content is not None
-            content_str = content if isinstance(content, str) else content.decode("utf-8")
-            content_bytes = base64.b64encode(content_str.encode("utf-8"))
-        return_type.content_bytes = content_bytes
+        return_type.content_bytes = base64.b64encode(raw)
         if content_type:
             return_type.content_type = content_type
-        self.add_child(return_type)
-        return self
+        return return_type
 
     def resumable_upload(
         self,

office365/outlook/mail/automaticreplies/mailtips.py

@@ -15,3 +15,7 @@ class AutomaticRepliesMailTips(ClientValue):
     messageLanguage: LocaleInfo = field(default_factory=LocaleInfo)
     scheduledEndTime: DateTimeTimeZone = field(default_factory=DateTimeTimeZone)
     scheduledStartTime: DateTimeTimeZone = field(default_factory=DateTimeTimeZone)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.AutomaticRepliesMailTips"

office365/outlook/mail/automaticreplies/setting.py

@@ -19,3 +19,7 @@ class AutomaticRepliesSetting(ClientValue):
     scheduledEndDateTime: DateTimeTimeZone = field(default_factory=DateTimeTimeZone)
     scheduledStartDateTime: DateTimeTimeZone = field(default_factory=DateTimeTimeZone)
     status: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.AutomaticRepliesSetting"

office365/outlook/mail/email_details.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from office365.runtime.client_value import ClientValue
+
+
+@dataclass
+class EmailDetails(ClientValue):
+    body: str | None = None
+    senderEmailAddress: str | None = None
+    subject: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.EmailDetails"

office365/outlook/mail/export_item_response.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+from office365.directory.security.stream import Stream
+from office365.outlook.mail.tips.error import MailTipsError
+from office365.runtime.client_value import ClientValue
+
+
+@dataclass
+class ExportItemResponse(ClientValue):
+    changeKey: str | None = None
+    data: Stream = field(default_factory=Stream)
+    error: MailTipsError = field(default_factory=MailTipsError)
+    itemId: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.ExportItemResponse"

office365/outlook/mail/folders/folder.py

@@ -15,6 +15,7 @@ from office365.outlook.mail.messages.collection import MessageCollection
 from office365.outlook.mail.messages.rules.collection import MessageRuleCollection
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.runtime.types.odata_property import odata
 
 
 class MailFolder(Entity):
@@ -110,6 +111,7 @@ class MailFolder(Entity):
         """The number of items in the mailFolder marked as unread."""
         return self.properties.get("unreadItemCount", None)
 
+    @odata(name="childFolders")
     @property
     def child_folders(self) -> EntityCollection[MailFolder]:
         """The collection of child folders in the mailFolder."""
@@ -117,6 +119,7 @@ class MailFolder(Entity):
             "childFolders", EntityCollection(self.context, MailFolder, ResourcePath("childFolders", self.resource_path))
         )
 
+    @odata(name="messageRules")
     @property
     def message_rules(self) -> MessageRuleCollection:
         """"""
@@ -131,6 +134,7 @@ class MailFolder(Entity):
             "messages", MessageCollection(self.context, ResourcePath("messages", self.resource_path))
         )
 
+    @odata(name="multiValueExtendedProperties")
     @property
     def multi_value_extended_properties(self) -> EntityCollection[MultiValueLegacyExtendedProperty]:
         """The collection of multi-value extended properties defined for the MailFolder."""
@@ -143,6 +147,7 @@ class MailFolder(Entity):
             ),
         )
 
+    @odata(name="singleValueExtendedProperties")
     @property
     def single_value_extended_properties(self) -> EntityCollection[SingleValueLegacyExtendedProperty]:
         """The collection of single-value extended properties defined for the MailFolder."""
@@ -155,17 +160,6 @@ class MailFolder(Entity):
             ),
         )
 
-    def get_property(self, name, default_value=None):
-        if default_value is None:
-            property_mapping = {
-                "childFolders": self.child_folders,
-                "messageRules": self.message_rules,
-                "multiValueExtendedProperties": self.multi_value_extended_properties,
-                "singleValueExtendedProperties": self.single_value_extended_properties,
-            }
-            default_value = property_mapping.get(name, None)
-        return super().get_property(name, default_value)
-
     @property
     def entity_type_name(self) -> str:
         return "microsoft.graph.MailFolder"

office365/outlook/mail/location.py

@@ -29,5 +29,5 @@ class Location(ClientValue):
     uniqueIdType: str | None = None
 
     @property
-    def entity_type_name(self):
+    def entity_type_name(self) -> str:
         return "microsoft.graph.Location"

office365/outlook/mail/location_constraint_item.py

@@ -1,5 +1,12 @@
+from __future__ import annotations
+
 from office365.outlook.mail.location import Location
 
 
 class LocationConstraintItem(Location):
-    """The conditions stated by a client for the location of a meeting."""
+    resolveAvailability: bool | None = None
+    "The conditions stated by a client for the location of a meeting."
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.LocationConstraintItem"

office365/outlook/mail/mailbox_item_import_session.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from datetime import datetime
+
+from office365.runtime.client_value import ClientValue
+
+
+@dataclass
+class MailboxItemImportSession(ClientValue):
+    expirationDateTime: datetime | None = field(default_factory=lambda: datetime.min)
+    importUrl: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.MailboxItemImportSession"

office365/outlook/mail/messages/collection.py

@@ -66,6 +66,6 @@ class MessageCollection(DeltaCollection["Message"]):
 
         assert self.resource_path is not None
         return_type = MessageCollection(self.context, self.resource_path)
-        return_type.query_options.custom["search"] = query_text
+        return_type.query_options.custom["$search"] = query_text
         return_type.get()
         return return_type

office365/outlook/mail/messages/followup_flag.py

@@ -23,3 +23,7 @@ class FollowupFlag(ClientValue):
     dueDateTime: DateTimeTimeZone = field(default_factory=DateTimeTimeZone)
     flagStatus: str | None = None
     startDateTime: DateTimeTimeZone = field(default_factory=DateTimeTimeZone)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.FollowupFlag"

office365/outlook/mail/messages/internet_header.py

@@ -14,3 +14,7 @@ class InternetMessageHeader(ClientValue):
 
     name: str | None = None
     value: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.InternetMessageHeader"

office365/outlook/mail/messages/message.py

@@ -82,19 +82,33 @@ class Message(OutlookItem):
         self.context.add_query(qry)
         return return_type
 
-    def add_file_attachment(self, name: str, content=None, content_type=None, base64_content=None):
-        """Attach a file to message
+    def add_file_attachment(self, name: str, content: bytes | str | None = None, content_type: str | None = None):
+        """Attach a file to a message.
+
+        For a **new draft** (message not yet created) the attachment rides along
+        with the message ``POST`` (inline ``attachments``). For an **existing**
+        message it queues a ``POST`` to the message's ``attachments`` collection,
+        so a subsequent ``execute_query()`` uploads it.
 
         Args:
             name (str): The name representing the text that is displayed below the icon representing the embedded
               attachment
-            content (str or None): The contents of the file
+            content (str or bytes): The file content — text (str) or raw bytes.
             content_type (str or None): The content type of the attachment.
-            base64_content (str or None): The contents of the file in the form of a base64 string.
         """
-        if not content and (not base64_content):
-            raise TypeError("Either content or base64_content is required")
-        self.attachments.add_file(name, content, content_type, base64_content)
+        if not content:
+            raise TypeError("Content is required")
+
+        attachment = self.attachments.create_file(name, content, content_type)
+        if self.id is not None:
+            # existing message: upload via POST /messages/{id}/attachments
+            from office365.runtime.queries.create_entity import CreateEntityQuery
+
+            qry = CreateEntityQuery(self.attachments, attachment, attachment)
+            self.context.add_query(qry)
+        else:
+            # new draft (no id yet): register inline so it rides the message create
+            self.attachments.add_child(attachment)
         return self
 
     def upload_attachment(self, file_path: str, chunk_uploaded: Optional[Callable[[int], None]] = None):

office365/outlook/mail/messages/rules/actions.py

@@ -24,3 +24,7 @@ class MessageRuleActions(ClientValue):
     permanentDelete: bool | None = None
     redirectTo: ClientValueCollection = field(default_factory=lambda: ClientValueCollection(Recipient))
     stopProcessingRules: bool | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.MessageRuleActions"

office365/outlook/mail/messages/rules/predicates.py

@@ -2,6 +2,9 @@ from __future__ import annotations
 
 from dataclasses import dataclass, field
 
+from office365.outlook.calendar.events.sensitivity import Sensitivity
+from office365.outlook.mail.messages.actionflag import MessageActionFlag
+from office365.outlook.mail.messages.rules.size_range import SizeRange
 from office365.outlook.mail.recipient import Recipient
 from office365.runtime.client_value import ClientValue
 from office365.runtime.client_value_collection import ClientValueCollection
@@ -20,3 +23,29 @@ class MessageRulePredicates(ClientValue):
     headerContains: StringCollection = field(default_factory=StringCollection)
     importance: str | None = None
     isApprovalRequest: bool | None = None
+    isAutomaticForward: bool | None = None
+    isAutomaticReply: bool | None = None
+    isEncrypted: bool | None = None
+    isMeetingRequest: bool | None = None
+    isMeetingResponse: bool | None = None
+    isNonDeliveryReport: bool | None = None
+    isPermissionControlled: bool | None = None
+    isReadReceipt: bool | None = None
+    isSigned: bool | None = None
+    isVoicemail: bool | None = None
+    messageActionFlag: MessageActionFlag = MessageActionFlag.any
+    notSentToMe: bool | None = None
+    recipientContains: StringCollection = field(default_factory=StringCollection)
+    senderContains: StringCollection = field(default_factory=StringCollection)
+    sensitivity: Sensitivity = Sensitivity.normal
+    sentCcMe: bool | None = None
+    sentOnlyToMe: bool | None = None
+    sentToAddresses: ClientValueCollection[Recipient] = field(default_factory=lambda: ClientValueCollection(Recipient))
+    sentToMe: bool | None = None
+    sentToOrCcMe: bool | None = None
+    subjectContains: StringCollection = field(default_factory=StringCollection)
+    withinSizeRange: SizeRange = field(default_factory=SizeRange)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.MessageRulePredicates"

office365/outlook/mail/messages/rules/rule.py

@@ -16,7 +16,7 @@ class MessageRule(Entity):
     @property
     def actions(self) -> MessageRuleActions:
         """Actions to be taken on a message when the corresponding conditions are fulfilled."""
-        return self.properties.get("actions", MessageRuleActions())
+        return self.properties.setdefault("actions", MessageRuleActions())
 
     @odata(name="conditions")
     @property

office365/outlook/mail/messages/rules/size_range.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from office365.runtime.client_value import ClientValue
+
+
+@dataclass
+class SizeRange(ClientValue):
+    maximumSize: int | None = None
+    minimumSize: int | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.SizeRange"

office365/outlook/mail/patterned_recurrence.py

@@ -20,3 +20,7 @@ class PatternedRecurrence(ClientValue):
 
     pattern: RecurrencePattern = field(default_factory=RecurrencePattern)
     range: RecurrenceRange = field(default_factory=RecurrenceRange)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.PatternedRecurrence"

office365/outlook/mail/recurrence_pattern.py

@@ -19,3 +19,7 @@ class RecurrencePattern(ClientValue):
     interval: int | None = None
     month: int | None = None
     type: RecurrencePatternType | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.RecurrencePattern"

office365/outlook/mail/recurrence_range.py

@@ -19,3 +19,7 @@ class RecurrenceRange(ClientValue):
     recurrenceTimeZone: str | None = None
     startDate: datetime.date | None = None
     type: RecurrenceRangeType | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.RecurrenceRange"

office365/outlook/mail/tips/error.py

@@ -7,4 +7,10 @@ from office365.runtime.client_value import ClientValue
 
 @dataclass
 class MailTipsError(ClientValue):
-    """"""
+    code: str | None = None
+    message: str | None = None
+    ""
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.MailTipsError"

office365/outlook/people/person_type.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from office365.runtime.client_value import ClientValue
+
+
+@dataclass
+class PersonType(ClientValue):
+    subclass: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.PersonType"

office365/outlook/place_feature_enablement.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from enum import Enum
+
+
+class PlaceFeatureEnablement(Enum):
+    unknown = "0"
+    enabled = "1"
+    disabled = "2"
+    unknownFutureValue = "3"
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.PlaceFeatureEnablement"

office365/outlook/resource_link.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from office365.outlook.resource_link_type import ResourceLinkType
+from office365.runtime.client_value import ClientValue
+
+
+@dataclass
+class ResourceLink(ClientValue):
+    linkType: ResourceLinkType = ResourceLinkType.url
+    name: str | None = None
+    value: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.ResourceLink"

office365/outlook/resource_link_type.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from enum import Enum
+
+
+class ResourceLinkType(Enum):
+    url = "0"
+    unknownFutureValue = "1"
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.ResourceLinkType"

office365/outlook/scored_email_address.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from office365.outlook.selectionlikelihoodinfo import SelectionLikelihoodInfo
+from office365.runtime.client_value import ClientValue
+
+
+@dataclass
+class ScoredEmailAddress(ClientValue):
+    address: str | None = None
+    itemId: str | None = None
+    relevanceScore: float | None = None
+    selectionLikelihood: SelectionLikelihoodInfo = SelectionLikelihoodInfo.notSpecified
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.ScoredEmailAddress"

office365/outlook/timezones/information.py

@@ -20,3 +20,7 @@ class TimeZoneInformation(ClientValue):
 
     def __repr__(self) -> str:
         return self.displayName or ""
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.TimeZoneInformation"

office365/outlook/timezones/standard_time_zone_offset.py

@@ -0,0 +1,20 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from datetime import time
+
+from office365.outlook.calendar.dayofweek import DayOfWeek
+from office365.runtime.client_value import ClientValue
+
+
+@dataclass
+class StandardTimeZoneOffset(ClientValue):
+    dayOccurrence: int | None = None
+    dayOfWeek: DayOfWeek = DayOfWeek.sunday
+    month: int | None = None
+    time: time | None = None
+    year: int | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.StandardTimeZoneOffset"

office365/partners/billing/attribute_set.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+from enum import Enum
+
+
+class AttributeSet(Enum):
+    full = "1"
+    basic = "2"
+    unknownFutureValue = "3"
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.partners.billing.AttributeSet"

office365/partners/billing/billing_period.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+from enum import Enum
+
+
+class BillingPeriod(Enum):
+    current = "1"
+    last = "2"
+    unknownFutureValue = "3"
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.partners.billing.BillingPeriod"

office365/partners/partners.py

@@ -11,7 +11,8 @@ class Partners(Entity):
         """
         Represents billing details for billed and unbilled data.
         """
-        return self.properties.get(
-            "billing",
-            Billing(self.context, ResourcePath("billing", self.resource_path)),
-        )
+        return self.properties.get("billing", Billing(self.context, ResourcePath("billing", self.resource_path)))
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.Partners"

office365/planner/buckets/collection.py

@@ -1,12 +1,12 @@
 from __future__ import annotations
 
-from office365.entity_collection import EntityCollection
+from office365.delta_collection import DeltaCollection
 from office365.planner.buckets.bucket import PlannerBucket
 from office365.planner.plans.plan import PlannerPlan
 from office365.runtime.queries.create_entity import CreateEntityQuery
 
 
-class PlannerBucketCollection(EntityCollection[PlannerBucket]):
+class PlannerBucketCollection(DeltaCollection[PlannerBucket]):
     def __init__(self, context, resource_path=None):
         super().__init__(context, PlannerBucket, resource_path)