Merge branch 'master' into fix/command-decorator-typing

Author: Lulalaby

.github/workflows/docs-json-export.yml

@@ -35,7 +35,7 @@ jobs:
         id: generate-json
         run: python scripts/docs_json_exporter.py
       - name: Upload docs.json as artifact
-        uses: actions/upload-artifact@v6.0.0
+        uses: actions/upload-artifact@v7.0.0
         id: artifact-upload
         with:
           name: Pycord Docs JSON

.pre-commit-config.yaml

@@ -11,7 +11,7 @@ repos:
       - id: end-of-file-fixer
         exclude: \.(po|pot|yml|yaml)$
   - repo: https://github.com/PyCQA/autoflake
-    rev: v2.3.2
+    rev: v2.3.3
     hooks:
       - id: autoflake
   #        args:
@@ -26,7 +26,7 @@ repos:
       - id: pyupgrade
         exclude: \.(po|pot|yml|yaml)$
   - repo: https://github.com/PyCQA/isort
-    rev: 7.0.0
+    rev: 8.0.0
     hooks:
       - id: isort
         exclude: \.(po|pot|yml|yaml)$

CHANGELOG.md

@@ -29,6 +29,8 @@ These changes are available on the `master` branch, but have not yet been releas
   ([#3063](https://github.com/Pycord-Development/pycord/pull/3063))
 - Changed `User.nameplate` to be an alias for `User.collectibles.nameplate`.
   ([#3107](https://github.com/Pycord-Development/pycord/pull/3107))
+- Changed `FileComponent.name` and `FileComponent.size` to be optional.
+  ([#3115](https://github.com/Pycord-Development/pycord/pull/3115))
 
 ### Fixed
 

discord/components.py

@@ -1127,9 +1127,9 @@ class FileComponent(Component):
     ----------
     file: :class:`UnfurledMediaItem`
         The file's media item.
-    name: :class:`str`
+    name: Optional[:class:`str`]
         The file's name.
-    size: :class:`int`
+    size: Optional[:class:`int`]
         The file's size in bytes.
     spoiler: Optional[:class:`bool`]
         Whether the file has the spoiler overlay.
@@ -1148,8 +1148,8 @@ class FileComponent(Component):
     def __init__(self, data: FileComponentPayload, state=None):
         self.type: ComponentType = try_enum(ComponentType, data["type"])
         self.id: int = data.get("id")
-        self.name: str = data.get("name")
-        self.size: int = data.get("size")
+        self.name: str | None = data.get("name")
+        self.size: int | None = data.get("size")
         self.file: UnfurledMediaItem = UnfurledMediaItem.from_dict(
             data.get("file", {}), state=state
         )

discord/types/components.py

@@ -142,8 +142,8 @@ class FileComponent(BaseComponent):
     type: Literal[13]
     file: UnfurledMediaItem
     spoiler: NotRequired[bool]
-    name: str
-    size: int
+    name: NotRequired[str]
+    size: NotRequired[int]
 
 
 class SeparatorComponent(BaseComponent):

discord/ui/file.py

@@ -119,12 +119,12 @@ def spoiler(self, spoiler: bool) -> None:
         self.underlying.spoiler = spoiler
 
     @property
-    def name(self) -> str:
+    def name(self) -> str | None:
         """The name of this file, if provided by Discord."""
         return self.underlying.name
 
     @property
-    def size(self) -> int:
+    def size(self) -> int | None:
         """The size of this file in bytes, if provided by Discord."""
         return self.underlying.size