Office365-REST-Python-Client 2.5.5__py3-none-any.whl → 2.5.7__py3-none-any.whl

office365/sharepoint/fields/number.py

@@ -1,51 +1,38 @@
+from typing import Optional
+
 from office365.sharepoint.fields.field import Field
 
 
 class FieldNumber(Field):
-    """Specifies a field (2) that contains number values. To set properties, call the Update method
+    """Specifies a field that contains number values. To set properties, call the Update method
     (section 3.2.5.53.2.1.5)."""
 
     @property
     def display_format(self):
-        """
-        Gets the number of decimal places to be used when displaying the field.
-
-        :rtype: int or None
-        """
+        # type: () -> Optional[int]
+        """Gets the number of decimal places to be used when displaying the field."""
         return self.properties.get("DisplayFormat", None)
 
     @property
     def comma_separator(self):
-        """
-        Gets the separator used to format the value of the field.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Gets the separator used to format the value of the field."""
         return self.properties.get("CommaSeparator", None)
 
     @comma_separator.setter
     def comma_separator(self, value):
-        """
-        Sets the separator used to format the value of the field.
-
-        :type value: str
-        """
+        # type: (str) -> None
+        """Sets the separator used to format the value of the field."""
         self.set_property("CommaSeparator", value)
 
     @property
     def show_as_percentage(self):
-        """
-        Gets a Boolean value that specifies whether to render the field as a percentage.
-
-        :rtype: int or None
-        """
+        # type: () -> Optional[bool]
+        """Gets a Boolean value that specifies whether to render the field as a percentage."""
         return self.properties.get("ShowAsPercentage", None)
 
     @show_as_percentage.setter
     def show_as_percentage(self, value):
-        """
-        Sets a Boolean value that specifies whether to render the field as a percentage.
-
-        :type value: str
-        """
+        # type: (bool) -> None
+        """Sets a Boolean value that specifies whether to render the field as a percentage."""
         self.set_property("ShowAsPercentage", value)

office365/sharepoint/fields/rating_scale.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.fields.multi_choice import FieldMultiChoice
 
 
@@ -7,11 +9,8 @@ class FieldRatingScale(FieldMultiChoice):
 
     @property
     def grid_start_number(self):
-        """
-        Gets the start number for the rating scale.
-
-        :rtype: int or None
-        """
+        # type: () -> Optional[int]
+        """Gets the start number for the rating scale."""
         return self.properties.get("GridStartNumber", None)
 
     @grid_start_number.setter
@@ -25,9 +24,6 @@ class FieldRatingScale(FieldMultiChoice):
 
     @property
     def range_count(self):
-        """
-        Specifies the number of options in the rating scale.
-
-        :rtype: int or None
-        """
+        # type: () -> Optional[int]
+        """Specifies the number of options in the rating scale."""
         return self.properties.get("RangeCount", None)

office365/sharepoint/fields/related_field.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.sharepoint.entity import Entity
 
@@ -7,35 +9,26 @@ class RelatedField(Entity):
 
     @property
     def field_id(self):
-        """
-        Gets the field id of the corresponding Lookup Field.
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Gets the field id of the corresponding Lookup Field."""
         return self.properties.get("FieldId", None)
 
     @property
     def list_id(self):
-        """
-        Gets the ID of the List containing the corresponding Lookup Field.
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Gets the ID of the List containing the corresponding Lookup Field."""
         return self.properties.get("ListId", None)
 
     @property
     def web_id(self):
-        """
-        Gets the ID of the Web containing the corresponding Lookup Field.
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Gets the ID of the Web containing the corresponding Lookup Field."""
         return self.properties.get("WebId", None)
 
     @property
     def relationship_delete_behavior(self):
-        """
-        Gets delete behavior of the corresponding Lookup Field.
-
-        :rtype: int or None
-        """
+        # type: () -> Optional[int]
+        """Gets delete behavior of the corresponding Lookup Field."""
         return self.properties.get("RelationshipDeleteBehavior", None)
 
     @property

office365/sharepoint/fields/url.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.fields.field import Field
 
 
@@ -6,9 +8,6 @@ class FieldUrl(Field):
 
     @property
     def display_format(self):
-        """
-        Gets the number of decimal places to be used when displaying the field.
-
-        :rtype: int or None
-        """
+        # type: () -> Optional[int]
+        """Gets the number of decimal places to be used when displaying the field."""
         return self.properties.get("DisplayFormat", None)

office365/sharepoint/fields/user.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.fields.lookup import FieldLookup
 
 
@@ -6,41 +8,40 @@ class FieldUser(FieldLookup):
 
     @property
     def presence(self):
-        """Gets a value that specifies whether presence is enabled on the field.
-
-        :rtype: bool or None
-        """
+        # type: () -> Optional[bool]
+        """Gets a value that specifies whether presence is enabled on the field."""
         return self.properties.get("Presence", None)
 
     @presence.setter
     def presence(self, val):
+        # type: (bool) -> None
         """Sets a value that specifies whether presence is enabled on the field."""
         self.properties.get("Presence", val)
 
     @property
     def allow_display(self):
-        """Gets a value that specifies whether to display the name of the user in a survey list.
-
-        :rtype: bool or None
-        """
+        # type: () -> Optional[bool]
+        """Gets a value that specifies whether to display the name of the user in a survey list."""
         return self.properties.get("AllowDisplay", None)
 
     @allow_display.setter
     def allow_display(self, val):
+        # type: (bool) -> None
         """Sets a value that specifies whether to display the name of the user in a survey list."""
         self.properties.get("AllowDisplay", val)
 
     @property
     def selection_group(self):
+        # type: () -> Optional[int]
         """
         Gets a value that specifies the identifier of the SharePoint group whose members can be selected
         as values of the field.
-        :rtype: int or None
         """
         return self.properties.get("SelectionGroup", None)
 
     @selection_group.setter
     def selection_group(self, val):
+        # type: (int) -> None
         """Sets a value that specifies the identifier of the SharePoint group whose members can be selected as
         values of the field.
         """

office365/sharepoint/files/collection.py

@@ -45,7 +45,7 @@ class FileCollection(EntityCollection[File]):
     def upload_with_checksum(self, file_object, chunk_size=1024):
         # type: (IO, int) -> File
         """ """
-        h = hashlib.sha1()  # hashlib.md5()
+        h = hashlib.md5()
         file_name = os.path.basename(file_object.name)
         upload_id = str(uuid.uuid4())
 
@@ -53,9 +53,10 @@ class FileCollection(EntityCollection[File]):
             # type: (File) -> None
             content = file_object.read(chunk_size)
             h.update(content)
+
             return_type.upload_with_checksum(
                 upload_id, h.hexdigest(), content
-            ).after_execute(_upload_session)
+            )  # .after_execute(_upload_session)
 
         return self.add(file_name, None, True).after_execute(_upload_session)
 
@@ -80,37 +81,38 @@ class FileCollection(EntityCollection[File]):
         file_name = file_name if file_name else os.path.basename(file.name)
         upload_id = str(uuid.uuid4())
 
-        def _upload_session(return_type, return_file):
-            # type: (File|ClientResult, File) -> None
-            if return_file is None:
-                return_file = return_type
+        def _upload(return_type):
+            # type: (File) -> None
+
+            def _after_uploaded(result):
+                # type: (ClientResult) -> None
+                _upload(return_type)
 
             uploaded_bytes = file.tell()
             if callable(chunk_uploaded):
                 chunk_uploaded(uploaded_bytes, **kwargs)
 
+            content = file.read(chunk_size)
             if uploaded_bytes == file_size:
                 if auto_close and not file.closed:
                     file.close()
                 return
 
-            content = file.read(chunk_size)
-
             if uploaded_bytes == 0:
-                return_file.start_upload(upload_id, content).after_execute(
-                    _upload_session, return_file
+                return_type.start_upload(upload_id, content).after_execute(
+                    _after_uploaded
                 )
             elif uploaded_bytes + len(content) < file_size:
-                return_file.continue_upload(
+                return_type.continue_upload(
                     upload_id, uploaded_bytes, content
-                ).after_execute(_upload_session, return_file)
+                ).after_execute(_after_uploaded)
             else:
-                return_file.finish_upload(
+                return_type.finish_upload(
                     upload_id, uploaded_bytes, content
-                ).after_execute(_upload_session, return_file)
+                ).after_execute(_upload)
 
         if file_size > chunk_size:
-            return self.add(file_name, None, True).after_execute(_upload_session, None)
+            return self.add(file_name, None, True).after_execute(_upload)
         else:
             return self.add(file_name, file.read(), True)
 

office365/sharepoint/files/file.py

@@ -59,10 +59,7 @@ class File(AbstractFile):
     or a file in a folder."""
 
     def __repr__(self):
-        if self.server_relative_path:
-            return repr(self.server_relative_path)
-        else:
-            return self.serverRelativeUrl or self.unique_id or self.entity_type_name
+        return self.serverRelativeUrl or self.unique_id or self.entity_type_name
 
     def __str__(self):
         return self.name or self.entity_type_name
@@ -132,6 +129,19 @@ class File(AbstractFile):
         self.context.add_query(qry)
         return return_type
 
+    def get_pre_authorized_access_url(self, expiration_hours):
+        # type: (int) -> ClientResult[str]
+        """Returns a link for downloading the file without authentication.
+        :param int expiration_hours: The number of hours until the link expires. If the maximum expiration time
+        defined in the web application is less than the specified expiration time, the maximum expiration time
+        takes precedence.
+        """
+        return_type = ClientResult(self.context, str())
+        params = {"expirationHours": expiration_hours}
+        qry = FunctionQuery(self, "GetPreAuthorizedAccessUrl", params, return_type)
+        self.context.add_query(qry)
+        return return_type
+
     def get_absolute_url(self):
         # type: () -> ClientResult[str]
         """Gets absolute url of a File"""
@@ -332,19 +342,18 @@ class File(AbstractFile):
         :param int flag: Specifies the kind of move operation.
         """
 
-        def _update_file(return_type, new_file_url):
-            return_type.set_property("ServerRelativeUrl", new_file_url)
-
         def _moveto(destination_folder):
-            """
-            :type destination_folder: Folder
-            """
-            file_path = "/".join([str(destination_folder.serverRelativeUrl), self.name])
+            # type: (Folder) -> None
+            file_url = "/".join([str(destination_folder.serverRelativeUrl), self.name])
 
-            params = {"newurl": file_path, "flags": flag}
+            params = {"newurl": file_url, "flags": flag}
             qry = ServiceOperationQuery(self, "moveto", params)
             self.context.add_query(qry)
-            self.context.after_query_execute(_update_file, self, file_path)
+
+            def _update_file(return_type):
+                self.set_property("ServerRelativeUrl", file_url)
+
+            self.context.after_query_execute(_update_file)
 
         def _source_file_resolved():
             if isinstance(destination, Folder):
@@ -366,10 +375,6 @@ class File(AbstractFile):
         :param int flag: Specifies the kind of move operation.
         """
 
-        def _update_file(return_type, new_file_url):
-            # type: (File, str) -> None
-            return_type.set_property("ServerRelativePath", new_file_url)
-
         def _move_to_using_path(destination_folder):
             # type: (Folder) -> None
             file_path = "/".join(
@@ -377,9 +382,12 @@ class File(AbstractFile):
             )
             params = {"DecodedUrl": file_path, "moveOperations": flag}
             qry = ServiceOperationQuery(self, "MoveToUsingPath", params)
-            self.context.add_query(qry).after_query_execute(
-                _update_file, self, file_path
-            )
+
+            def _update_file(return_type):
+                # type: (File) -> None
+                self.set_property("ServerRelativePath", file_path)
+
+            self.context.add_query(qry).after_query_execute(_update_file)
 
         def _source_file_resolved():
             if isinstance(destination, Folder):
@@ -493,6 +501,7 @@ class File(AbstractFile):
         return return_type
 
     def upload_with_checksum(self, upload_id, checksum, stream):
+        # type: (str, str, bytes) -> File
         """
         :param str upload_id: The upload session ID.
         :param str checksum:
@@ -924,9 +933,7 @@ class File(AbstractFile):
 
     @property
     def parent_folder(self):
-        """
-        :rtype: office365.sharepoint.folders.folder.Folder
-        """
+        # type: () -> Optional[Folder]
         if self.parent_collection is None:
             return None
         return self.parent_collection.parent

office365/sharepoint/folders/collection.py

@@ -1,7 +1,10 @@
+import os
+
 from office365.runtime.paths.service_operation import ServiceOperationPath
 from office365.runtime.paths.v3.entity import EntityPath
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.entity_collection import EntityCollection
+from office365.sharepoint.folders.coloring_information import FolderColoringInformation
 from office365.sharepoint.folders.folder import Folder
 from office365.sharepoint.types.resource_path import ResourcePath as SPResPath
 
@@ -42,14 +45,28 @@ class FolderCollection(EntityCollection[Folder]):
             folder = folder.add(name)
         return folder
 
-    def add(self, name):
+    def add(self, name, color_hex=None):
         """Adds the folder that is located at the specified URL to the collection.
-        :param str name: Specifies the Name of the folder.
+        :param str name: Specifies the Name or Path of the folder.
+        :param str color_hex: Specifies the color of the folder.
         """
         return_type = Folder(self.context, EntityPath(name, self.resource_path))
-        self.add_child(return_type)
-        qry = ServiceOperationQuery(self, "Add", [name], None, None, return_type)
-        self.context.add_query(qry)
+        if color_hex:
+
+            def _add_coloring():
+                path = os.path.join(
+                    self.parent.properties.get("ServerRelativeUrl"), name
+                )
+                coloring_info = FolderColoringInformation(color_hex=color_hex)
+                self.context.folder_coloring.create_folder(
+                    path, coloring_info, return_type=return_type
+                )
+
+            self.parent.ensure_property("ServerRelativeUrl", _add_coloring)
+        else:
+            self.add_child(return_type)
+            qry = ServiceOperationQuery(self, "Add", [name], None, None, return_type)
+            self.context.add_query(qry)
         return return_type
 
     def get_by_url(self, url):

office365/sharepoint/folders/coloring.py

@@ -1,6 +1,10 @@
+from typing_extensions import Self
+
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.entity import Entity
+from office365.sharepoint.folders.coloring_information import FolderColoringInformation
 from office365.sharepoint.folders.folder import Folder
+from office365.sharepoint.types.resource_path import ResourcePath as SPResPath
 
 
 class FolderColoring(Entity):
@@ -9,22 +13,19 @@ class FolderColoring(Entity):
     def create_folder(
         self,
         decoded_url,
-        ensure_unique_file_name=True,
-        overwrite=True,
-        coloring_information=None,
+        coloring_information=FolderColoringInformation(color_hex="1"),
+        return_type=None,
     ):
         """
         :param str decoded_url:
-        :param bool ensure_unique_file_name:
-        :param bool overwrite:
         :param FolderColoringInformation coloring_information:
+        :param Folder return_type: Return type
         """
-        return_type = Folder(self.context)
+        if return_type is None:
+            return_type = Folder(self.context)
 
         payload = {
-            "DecodedUrl": decoded_url,
-            "EnsureUniqueFileName": ensure_unique_file_name,
-            "Overwrite": overwrite,
+            "path": SPResPath(decoded_url),
             "coloringInformation": coloring_information,
         }
         qry = ServiceOperationQuery(
@@ -34,6 +35,7 @@ class FolderColoring(Entity):
         return return_type
 
     def stamp_color(self, decoded_url, coloring_information):
+        # type: (str, FolderColoringInformation) -> Self
         """
         :param str decoded_url:
         :param FolderColoringInformation coloring_information:

office365/sharepoint/folders/coloring_information.py

@@ -1,6 +1,40 @@
 from office365.runtime.client_value import ClientValue
 
 
+class FolderColors(object):
+    Yellow = "#FFCE3C"
+
+    Grey = "#B0B7BA"
+
+    DarkRed = "#E73E29"
+
+    LightRed = "#FFBCB2"
+
+    DarkOrange = "#EE7110"
+
+    LightOrange = "#FFBF84"
+
+    DarkGreen = "#3F9F4A"
+
+    LightGreen = "#8ED290"
+
+    DarkTeal = "#27938E"
+
+    LightTeal = "#7AD1CD"
+
+    DarkBlue = "#1E84D0"
+
+    LightBlue = "#86C8F7"
+
+    DarkPurple = "#9A61C7"
+
+    LightPurple = "#D4AFF6"
+
+    DarkPink = "#CC53B4"
+
+    LightPink = "#F7AAE7"
+
+
 class FolderColoringInformation(ClientValue):
     """"""
 
@@ -13,3 +47,7 @@ class FolderColoringInformation(ClientValue):
         self.ColorHex = color_hex
         self.ColorTag = color_tag
         self.Emoji = emoji
+
+    @property
+    def entity_type_name(self):
+        return "SP.FolderColoringInformation"

office365/sharepoint/folders/folder.py

@@ -30,7 +30,7 @@ class Folder(Entity):
     """Represents a folder in a SharePoint Web site."""
 
     def __str__(self):
-        return self.name
+        return self.name or self.entity_type_name
 
     def __repr__(self):
         return self.serverRelativeUrl or self.unique_id or self.entity_type_name
@@ -69,14 +69,14 @@ class Folder(Entity):
 
         return_type = FolderCollection(self.context, self.folders.resource_path, self)
 
-        def _loaded(parent):
+        def _get_folders(parent):
             # type: ("Folder") -> None
             [return_type.add_child(f) for f in parent.folders]
             if recursive:
                 for folder in parent.folders:
-                    folder.ensure_properties(["Folders"], _loaded, parent=folder)
+                    folder.ensure_properties(["Folders"], _get_folders, parent=folder)
 
-        self.ensure_properties(["Folders"], _loaded, parent=self)
+        self.ensure_properties(["Folders"], _get_folders, parent=self)
         return return_type
 
     def get_files(self, recursive=False):
@@ -88,16 +88,16 @@ class Folder(Entity):
 
         return_type = FileCollection(self.context, self.files.resource_path, self)
 
-        def _loaded(parent):
+        def _get_files(parent):
             # type: ("Folder") -> None
             [return_type.add_child(f) for f in parent.files]
             if recursive:
                 for folder in parent.folders:
                     folder.ensure_properties(
-                        ["Files", "Folders"], _loaded, parent=folder
+                        ["Files", "Folders"], _get_files, parent=folder
                     )
 
-        self.ensure_properties(["Files", "Folders"], _loaded, parent=self)
+        self.ensure_properties(["Files", "Folders"], _get_files, parent=self)
         return return_type
 
     def get_sharing_information(self):
@@ -115,18 +115,17 @@ class Folder(Entity):
             where to move a folder.
         """
 
-        def _update_folder(url):
-            self.set_property("ServerRelativeUrl", url)
-
         def _move_to(destination_folder):
             # type: ("Folder") -> None
             destination_url = "/".join(
                 [destination_folder.serverRelativeUrl, self.name]
             )
             qry = ServiceOperationQuery(self, "MoveTo", {"newUrl": destination_url})
-            self.context.add_query(qry).after_query_execute(
-                _update_folder, destination_url
-            )
+
+            def _update_folder(return_type):
+                self.set_property("ServerRelativeUrl", destination_url)
+
+            self.context.add_query(qry).after_query_execute(_update_folder)
 
         def _source_folder_resolved():
             if isinstance(destination, Folder):
@@ -146,21 +145,20 @@ class Folder(Entity):
             where to move a folder.
         """
 
-        def _update_folder(url):
-            self.set_property("ServerRelativePath", url)
-
         def _move_to_using_path(destination_folder):
             # type: ("Folder") -> None
-            destination_url = "/".join(
+            destination_path = "/".join(
                 [str(destination_folder.server_relative_path), self.name]
             )
             qry = ServiceOperationQuery(
-                self, "MoveToUsingPath", {"DecodedUrl": destination_url}
-            )
-            self.context.add_query(qry).after_query_execute(
-                _update_folder, destination_url
+                self, "MoveToUsingPath", {"DecodedUrl": destination_path}
             )
 
+            def _update_folder(url):
+                self.set_property("ServerRelativePath", destination_path)
+
+            self.context.add_query(qry).after_query_execute(_update_folder)
+
         def _source_folder_resolved():
             if isinstance(destination, Folder):
                 destination.ensure_property(
@@ -487,7 +485,9 @@ class Folder(Entity):
 
         return self.properties.get(
             "Folders",
-            FolderCollection(self.context, ResourcePath("Folders", self.resource_path)),
+            FolderCollection(
+                self.context, ResourcePath("Folders", self.resource_path), self
+            ),
         )
 
     @property
@@ -554,9 +554,7 @@ class Folder(Entity):
     @property
     def time_created(self):
         # type: () -> Optional[datetime]
-        """
-        Gets when the folder was created in UTC.
-        """
+        """Gets when the folder was created in UTC."""
         return self.properties.get("TimeCreated", datetime.min)
 
     @property