Finish up classes under telegram/**/

Except `inputmedia.py` classes and `Bot`
python-telegram-bot · aelkheir · Aug 19, 2026 · Aug 19, 2026 · Aug 21, 2026 · Aug 19, 2026
commit ea65eeaad906f7ac2876cfe940f737938794fb9e
diff --git a/docs/auxil/sphinx_hooks.py b/docs/auxil/sphinx_hooks.py
@@ -50,7 +50,6 @@
 PRIVATE_BASE_CLASSES = {
     "_ChatUserBaseFilter": "MessageFilter",
     "_Dice": "MessageFilter",
-    "_BaseThumbedMedium": "TelegramObject",
     "_BaseMedium": "TelegramObject",
     "_CredentialsBase": "TelegramObject",
     "_ChatBase": "TelegramObject",

diff --git a/docs/source/telegram.animation.rst b/docs/source/telegram.animation.rst
@@ -1,7 +1,7 @@
 Animation
 =========
 
-.. Also lists methods of _BaseThumbedMedium, but not the ones of TelegramObject
+.. Also lists methods of _BaseMedium, but not the ones of TelegramObject
 
 .. autoclass:: telegram.Animation
     :members:

diff --git a/docs/source/telegram.audio.rst b/docs/source/telegram.audio.rst
@@ -1,7 +1,7 @@
 Audio
 =====
 
-.. Also lists methods of _BaseThumbedMedium, but not the ones of TelegramObject
+.. Also lists methods of _BaseMedium, but not the ones of TelegramObject
 
 .. autoclass:: telegram.Audio
     :members:

diff --git a/docs/source/telegram.document.rst b/docs/source/telegram.document.rst
@@ -1,6 +1,6 @@
 Document
 ========
-.. Also lists methods of _BaseThumbedMedium, but not the ones of TelegramObject
+.. Also lists methods of _BaseMedium, but not the ones of TelegramObject
 
 .. autoclass:: telegram.Document
     :members:

diff --git a/docs/source/telegram.sticker.rst b/docs/source/telegram.sticker.rst
@@ -1,7 +1,7 @@
 Sticker
 =======
 
-.. Also lists methods of _BaseThumbedMedium, but not the ones of TelegramObject
+.. Also lists methods of _BaseMedium, but not the ones of TelegramObject
 
 .. autoclass:: telegram.Sticker
     :members:

diff --git a/docs/source/telegram.video.rst b/docs/source/telegram.video.rst
@@ -1,7 +1,7 @@
 Video
 =====
 
-.. Also lists methods of _BaseThumbedMedium, but not the ones of TelegramObject
+.. Also lists methods of _BaseMedium, but not the ones of TelegramObject
 
 .. autoclass:: telegram.Video
     :members:

diff --git a/docs/source/telegram.videonote.rst b/docs/source/telegram.videonote.rst
@@ -1,7 +1,7 @@
 VideoNote
 =========
 
-.. Also lists methods of _BaseThumbedMedium, but not the ones of TelegramObject
+.. Also lists methods of _BaseMedium, but not the ones of TelegramObject
 
 .. autoclass:: telegram.VideoNote
     :members:

diff --git a/docs/source/telegram.voice.rst b/docs/source/telegram.voice.rst
@@ -1,7 +1,7 @@
 Voice
 =====
 
-.. Also lists methods of _BaseThumbedMedium, but not the ones of TelegramObject
+.. Also lists methods of _BaseMedium, but not the ones of TelegramObject
 
 .. autoclass:: telegram.Voice
     :members:

diff --git a/src/telegram/_files/_basemedium.py b/src/telegram/_files/_basemedium.py
@@ -21,13 +21,15 @@
 from typing import TYPE_CHECKING
 
 from telegram._telegramobject import TelegramObject
+from telegram._utils.dataclass import tg_dataclass, tg_field
 from telegram._utils.defaultvalue import DEFAULT_NONE
 from telegram._utils.types import JSONDict, ODVInput
 
 if TYPE_CHECKING:
     from telegram import File
 
 
+@tg_dataclass()
 class _BaseMedium(TelegramObject):
     """Base class for objects representing the various media file types.
     Objects of this class are comparable in terms of equality. Two objects of this class are
@@ -39,36 +41,18 @@ class _BaseMedium(TelegramObject):
         file_unique_id (:obj:`str`): Unique identifier for this file, which
             is supposed to be the same over time and for different bots.
             Can't be used to download or reuse the file.
-        file_size (:obj:`int`, optional): File size.
 
     Attributes:
         file_id (:obj:`str`): File identifier.
         file_unique_id (:obj:`str`): Unique identifier for this file, which
             is supposed to be the same over time and for different bots.
             Can't be used to download or reuse the file.
-        file_size (:obj:`int`): Optional. File size.
 
     """
 
-    __slots__ = ("file_id", "file_size", "file_unique_id")
-
-    def __init__(
-        self,
-        file_id: str,
-        file_unique_id: str,
-        file_size: int | None = None,
-        *,
-        api_kwargs: JSONDict | None = None,
-    ):
-        super().__init__(api_kwargs=api_kwargs)
-
-        # Required
-        self.file_id: str = str(file_id)
-        self.file_unique_id: str = str(file_unique_id)
-        # Optionals
-        self.file_size: int | None = file_size
-
-        self._id_attrs = (self.file_unique_id,)
+    # Required
+    file_id: str = tg_field()
+    file_unique_id: str = tg_field(compare=True)
 
     async def get_file(
         self,

diff --git a/src/telegram/_files/_basethumbedmedium.py b/src/telegram/_files/_basethumbedmedium.py
diff --git a/src/telegram/_files/animation.py b/src/telegram/_files/animation.py
@@ -20,14 +20,15 @@
 
 import datetime as dtm
 
-from telegram._files._basethumbedmedium import _BaseThumbedMedium
+from telegram._files._basemedium import _BaseMedium
 from telegram._files.photosize import PhotoSize
 from telegram._utils.argumentparsing import to_timedelta
+from telegram._utils.dataclass import tg_dataclass, tg_field
 from telegram._utils.datetime import get_timedelta_value
-from telegram._utils.types import JSONDict, TimePeriod
 
 
-class Animation(_BaseThumbedMedium):
+@tg_dataclass()
+class Animation(_BaseMedium):
     """This object represents an animation file (GIF or H.264/MPEG-4 AVC video without sound).
 
     Objects of this class are comparable in terms of equality. Two objects of this class are
@@ -80,37 +81,15 @@ class Animation(_BaseThumbedMedium):
 
     """
 
-    __slots__ = ("_duration", "file_name", "height", "mime_type", "width")
-
-    def __init__(
-        self,
-        file_id: str,
-        file_unique_id: str,
-        width: int,
-        height: int,
-        duration: TimePeriod,
-        file_name: str | None = None,
-        mime_type: str | None = None,
-        file_size: int | None = None,
-        thumbnail: PhotoSize | None = None,
-        *,
-        api_kwargs: JSONDict | None = None,
-    ):
-        super().__init__(
-            file_id=file_id,
-            file_unique_id=file_unique_id,
-            file_size=file_size,
-            api_kwargs=api_kwargs,
-            thumbnail=thumbnail,
-        )
-        with self._unfrozen():
-            # Required
-            self.width: int = width
-            self.height: int = height
-            self._duration: dtm.timedelta = to_timedelta(duration)
-            # Optional
-            self.mime_type: str | None = mime_type
-            self.file_name: str | None = file_name
+    # Required
+    width: int = tg_field()
+    height: int = tg_field()
+    _duration: dtm.timedelta = tg_field(alias="duration", converter=to_timedelta)
+    # Optional
+    file_name: str | None = tg_field(default=None)
+    mime_type: str | None = tg_field(default=None)
+    file_size: int | None = tg_field(default=None)
+    thumbnail: PhotoSize | None = tg_field(default=None)
 
     @property
     def duration(self) -> int | dtm.timedelta:

diff --git a/src/telegram/_files/audio.py b/src/telegram/_files/audio.py
@@ -20,14 +20,15 @@
 
 import datetime as dtm
 
-from telegram._files._basethumbedmedium import _BaseThumbedMedium
+from telegram._files._basemedium import _BaseMedium
 from telegram._files.photosize import PhotoSize
 from telegram._utils.argumentparsing import to_timedelta
+from telegram._utils.dataclass import tg_dataclass, tg_field
 from telegram._utils.datetime import get_timedelta_value
-from telegram._utils.types import JSONDict, TimePeriod
 
 
-class Audio(_BaseThumbedMedium):
+@tg_dataclass()
+class Audio(_BaseMedium):
     """This object represents an audio file to be treated as music by the Telegram clients.
 
     Objects of this class are comparable in terms of equality. Two objects of this class are
@@ -82,37 +83,15 @@ class Audio(_BaseThumbedMedium):
 
     """
 
-    __slots__ = ("_duration", "file_name", "mime_type", "performer", "title")
-
-    def __init__(
-        self,
-        file_id: str,
-        file_unique_id: str,
-        duration: TimePeriod,
-        performer: str | None = None,
-        title: str | None = None,
-        mime_type: str | None = None,
-        file_size: int | None = None,
-        file_name: str | None = None,
-        thumbnail: PhotoSize | None = None,
-        *,
-        api_kwargs: JSONDict | None = None,
-    ):
-        super().__init__(
-            file_id=file_id,
-            file_unique_id=file_unique_id,
-            file_size=file_size,
-            thumbnail=thumbnail,
-            api_kwargs=api_kwargs,
-        )
-        with self._unfrozen():
-            # Required
-            self._duration: dtm.timedelta = to_timedelta(duration)
-            # Optional
-            self.performer: str | None = performer
-            self.title: str | None = title
-            self.mime_type: str | None = mime_type
-            self.file_name: str | None = file_name
+    # Required
+    _duration: dtm.timedelta = tg_field(alias="duration", converter=to_timedelta)
+    # Optional
+    performer: str | None = tg_field(default=None)
+    title: str | None = tg_field(default=None)
+    mime_type: str | None = tg_field(default=None)
+    file_size: int | None = tg_field(default=None)
+    file_name: str | None = tg_field(default=None)
+    thumbnail: PhotoSize | None = tg_field(default=None)
 
     @property
     def duration(self) -> int | dtm.timedelta: