a begin that works

2025-07-19 16:14:29 +02:00
parent d39a8fe644
commit 5790346ff9
2085 changed files with 374513 additions and 0 deletions
--- a/venv/lib/python3.12/site-packages/telegram/_files/videonote.py
+++ b/venv/lib/python3.12/site-packages/telegram/_files/videonote.py
@@ -0,0 +1,107 @@
+#!/usr/bin/env python
+#
+# A library that provides a Python interface to the Telegram Bot API
+# Copyright (C) 2015-2025
+# Leandro Toledo de Souza <devs@python-telegram-bot.org>
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser Public License for more details.
+#
+# You should have received a copy of the GNU Lesser Public License
+# along with this program.  If not, see [http://www.gnu.org/licenses/].
+"""This module contains an object that represents a Telegram VideoNote."""
+
+import datetime as dtm
+from typing import Optional, Union
+
+from telegram._files._basethumbedmedium import _BaseThumbedMedium
+from telegram._files.photosize import PhotoSize
+from telegram._utils.argumentparsing import to_timedelta
+from telegram._utils.datetime import get_timedelta_value
+from telegram._utils.types import JSONDict, TimePeriod
+
+
+class VideoNote(_BaseThumbedMedium):
+    """This object represents a video message (available in Telegram apps as of v.4.0).
+
+    Objects of this class are comparable in terms of equality. Two objects of this class are
+    considered equal, if their :attr:`file_unique_id` is equal.
+
+    .. versionchanged:: 20.5
+      |removed_thumb_note|
+
+    Args:
+        file_id (:obj:`str`): Identifier for this file, which can be used to download
+            or reuse the file.
+        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.
+        length (:obj:`int`): Video width and height (diameter of the video message) as defined
+            by sender.
+        duration (:obj:`int` | :class:`datetime.timedelta`): Duration of the video in
+            seconds as defined by the sender.
+
+            .. versionchanged:: v22.2
+                |time-period-input|
+        file_size (:obj:`int`, optional): File size in bytes.
+        thumbnail (:class:`telegram.PhotoSize`, optional): Video thumbnail.
+
+            .. versionadded:: 20.2
+
+    Attributes:
+        file_id (:obj:`str`): Identifier for this file, which can be used to download
+            or reuse the file.
+        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.
+        length (:obj:`int`): Video width and height (diameter of the video message) as defined
+            by sender.
+        duration (:obj:`int` | :class:`datetime.timedelta`): Duration of the video in seconds as
+            defined by the sender.
+
+            .. deprecated:: v22.2
+                |time-period-int-deprecated|
+        file_size (:obj:`int`): Optional. File size in bytes.
+        thumbnail (:class:`telegram.PhotoSize`): Optional. Video thumbnail.
+
+            .. versionadded:: 20.2
+
+    """
+
+    __slots__ = ("_duration", "length")
+
+    def __init__(
+        self,
+        file_id: str,
+        file_unique_id: str,
+        length: int,
+        duration: TimePeriod,
+        file_size: Optional[int] = None,
+        thumbnail: Optional[PhotoSize] = None,
+        *,
+        api_kwargs: Optional[JSONDict] = 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.length: int = length
+            self._duration: dtm.timedelta = to_timedelta(duration)
+
+    @property
+    def duration(self) -> Union[int, dtm.timedelta]:
+        return get_timedelta_value(  # type: ignore[return-value]
+            self._duration, attribute="duration"
+        )