Yi=SrSSKrSSKJr SSKJr SSKJr SSK J r J r J r SSK Jr SSKJr SSKJr SS KJr SS KJrJrJr \ (aSS KJr "S S \5rg)z?This module contains an object that represents a Telegram File.N) b64decode)Path) TYPE_CHECKINGBinaryIOOptional)decrypt)TelegramObject) DEFAULT_NONE) is_local_file) FilePathInputJSONDictODVInput)FileCredentialsc^\rSrSrSrSrSSS.S\S\S\\S \\S \\ 4 U4S jjjjr S \4S jr S\ S \ 4Sjr S\\\\S.S\\S\\S\\S\\S\\S \4 Sjjjr\\\\S.S\S\\S\\S\\S\\S S4 SjjrS\\\\S.S\\S\\S\\S\\S\\S \4 SjjjrSSjrSrU=r$)File$a4 This object represents a file ready to be downloaded. The file can be e.g. downloaded with :attr:`download_to_drive`. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling :meth:`telegram.Bot.get_file`. 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.0 ``download`` was split into :meth:`download_to_drive` and :meth:`download_to_memory`. Note: * Maximum file size to download is :tg-const:`telegram.constants.FileSizeLimit.FILESIZE_DOWNLOAD`. * If you obtain an instance of this class from :attr:`telegram.PassportFile.get_file`, then it will automatically be decrypted as it downloads when you call e.g. :meth:`download_to_drive`. 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. file_size (:obj:`int`, optional): File size in bytes, if known. file_path (:obj:`str`, optional): File path. Use e.g. :meth:`download_to_drive` to get the file. 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. file_size (:obj:`int`): Optional. File size in bytes, if known. file_path (:obj:`str`): Optional. File path. Use e.g. :meth:`download_to_drive` to get the file. ) _credentialsfile_id file_path file_sizefile_unique_idN api_kwargsrrrrrc>[TU]US9 [U5Ul[U5UlX0lX@lSUlUR4UlUR5 g)Nr) super__init__strrrrrr _id_attrs_freeze)selfrrrrr __class__s ?/app/.venv/lib/python3.13/site-packages/telegram/_files/file.pyr File.__init__TsZ J/ L #&~#6(1(17;--/ returnc <[R"[UR55n[R"[R "UR UR[R"UR5URUR55$)zPConvert any UTF-8 char in :obj:`File.file_path` into a url encoded ASCII string.) urllib_parseurlsplitrr urlunsplit SplitResultschemenetlocquotepathqueryfragment)r sress r"_get_encoded_urlFile._get_encoded_urllsi$$S%89&&  $ $ T[[,*<*r?c# UR(d [S5e[UR5nU(aSOUR5nU(aUR(a[ UR5nUR UR55n Ub [ U5n O.[ [UR5S-UR-5n U RU 5 U $Ub<U(a5[R"UR[U55 [ U5$U(a [ U5n ODU(a[ UR5$[ [ UR5R5n UR5RR!UUUUUS9IShvN n UR(aUR U 5n U RU 5 U $N97f)a Download this file. By default, the file is saved in the current working directory with :attr:`file_path` as file name. If :paramref:`custom_path` is supplied as a :obj:`str` or :obj:`pathlib.Path`, it will be saved to that path. Note: If :paramref:`custom_path` isn't provided and :attr:`file_path` is the path of a local file (which is the case when a Bot API Server is running in local mode), this method will just return the path. The only exception to this are encrypted files (e.g. a passport file). For these, a file with the prefix `decrypted_` will be created in the same directory as the original file in order to decrypt the file without changing the existing one in-place. .. seealso:: :wiki:`Working with Files and Media ` .. versionchanged:: 20.0 * :paramref:`custom_path` parameter now also accepts :class:`pathlib.Path` as argument. * Returns :class:`pathlib.Path` object in cases where previously a :obj:`str` was returned. * This method was previously called ``download``. It was split into :meth:`download_to_drive` and :meth:`download_to_memory`. .. versionchanged:: 21.7 Raises :exc:`RuntimeError` if :attr:`file_path` is not set. Note that files without a :attr:`file_path` could never be downloaded, as this attribute is mandatory for that operation. Args: custom_path (:class:`pathlib.Path` | :obj:`str` , optional): The path where the file will be saved to. If not specified, will be saved in the current working directory with :attr:`file_path` as file name or the :attr:`file_id` if :attr:`file_path` is not set. Keyword Args: read_timeout (:obj:`float` | :obj:`None`, optional): Value to pass to :paramref:`telegram.request.BaseRequest.post.read_timeout`. Defaults to :attr:`~telegram.request.BaseRequest.DEFAULT_NONE`. write_timeout (:obj:`float` | :obj:`None`, optional): Value to pass to :paramref:`telegram.request.BaseRequest.post.write_timeout`. Defaults to :attr:`~telegram.request.BaseRequest.DEFAULT_NONE`. connect_timeout (:obj:`float` | :obj:`None`, optional): Value to pass to :paramref:`telegram.request.BaseRequest.post.connect_timeout`. Defaults to :attr:`~telegram.request.BaseRequest.DEFAULT_NONE`. pool_timeout (:obj:`float` | :obj:`None`, optional): Value to pass to :paramref:`telegram.request.BaseRequest.post.pool_timeout`. Defaults to :attr:`~telegram.request.BaseRequest.DEFAULT_NONE`. Returns: :class:`pathlib.Path`: Returns the Path object the file was downloaded to. Raises: RuntimeError: If :attr:`file_path` is not set. 9No `file_path` available for this file. Can not download.Nz /decrypted_r;)r RuntimeErrorr r2rrr9 read_bytesrparentname write_bytesshutilcopyfileget_botrequestretrieve) r r@r<r=r>r? local_fileurlfile_to_decryptr4r.filenames r"download_to_driveFile.download_to_drivexsD~~Z[ ["4>>2  dd&;&;&= $++"4>>2O''(B(B(DEC&K(C 6 67-G/J^J^^_   S !K  "z OODNNC ,< = $ $ K(H ' 'D0556HLLN**33 %'+% 4     '',CS! sF+G)-G'.:G)outc# UR(d [S5e[UR5nU(aSOUR5nU(a[ UR5OSnU(aUR 5n O3UR 5RRUUUUUS9IShvN n UR(aURU 5n URU 5 gN87f)a Download this file into memory. :paramref:`out` needs to be supplied with a :obj:`io.BufferedIOBase`, the file contents will be saved to that object using the :obj:`out.write` method. .. seealso:: :wiki:`Working with Files and Media ` Hint: If you want to immediately read the data from ``out`` after calling this method, you should call ``out.seek(0)`` first. See also :meth:`io.IOBase.seek`. .. versionadded:: 20.0 .. versionchanged:: 21.7 Raises :exc:`RuntimeError` if :attr:`file_path` is not set. Note that files without a :attr:`file_path` could never be downloaded, as this attribute is mandatory for that operation. Args: out (:obj:`io.BufferedIOBase`): A file-like object. Must be opened for writing in binary mode. Keyword Args: read_timeout (:obj:`float` | :obj:`None`, optional): Value to pass to :paramref:`telegram.request.BaseRequest.post.read_timeout`. Defaults to :attr:`~telegram.request.BaseRequest.DEFAULT_NONE`. write_timeout (:obj:`float` | :obj:`None`, optional): Value to pass to :paramref:`telegram.request.BaseRequest.post.write_timeout`. Defaults to :attr:`~telegram.request.BaseRequest.DEFAULT_NONE`. connect_timeout (:obj:`float` | :obj:`None`, optional): Value to pass to :paramref:`telegram.request.BaseRequest.post.connect_timeout`. Defaults to :attr:`~telegram.request.BaseRequest.DEFAULT_NONE`. pool_timeout (:obj:`float` | :obj:`None`, optional): Value to pass to :paramref:`telegram.request.BaseRequest.post.pool_timeout`. Defaults to :attr:`~telegram.request.BaseRequest.DEFAULT_NONE`. Raises: RuntimeError: If :attr:`file_path` is not set. rBNr;) rrCr r2rrDrJrKrLrr9write) r rSr<r=r>r?rMrNr.r4s r"download_to_memoryFile.download_to_memorys`~~Z[ ["4>>2  dd&;&;&='1tDNN#t //#C ..77)+ /) 8C   '',C #sB/C,1C*29C,c# UR(d [S5eUc [5n[UR5(a$[ UR5R 5nOAUR 5RRUR5UUUUS9IShvN nUR(a"URURU55 U$URU5 U$NJ7f)a%Download this file and return it as a bytearray. .. versionchanged:: 21.7 Raises :exc:`RuntimeError` if :attr:`file_path` is not set. Note that files without a :attr:`file_path` could never be downloaded, as this attribute is mandatory for that operation. Args: buf (:obj:`bytearray`, optional): Extend the given bytearray with the downloaded data. Keyword Args: read_timeout (:obj:`float` | :obj:`None`, optional): Value to pass to :paramref:`telegram.request.BaseRequest.post.read_timeout`. Defaults to :attr:`~telegram.request.BaseRequest.DEFAULT_NONE`. .. versionadded:: 20.0 write_timeout (:obj:`float` | :obj:`None`, optional): Value to pass to :paramref:`telegram.request.BaseRequest.post.write_timeout`. Defaults to :attr:`~telegram.request.BaseRequest.DEFAULT_NONE`. .. versionadded:: 20.0 connect_timeout (:obj:`float` | :obj:`None`, optional): Value to pass to :paramref:`telegram.request.BaseRequest.post.connect_timeout`. Defaults to :attr:`~telegram.request.BaseRequest.DEFAULT_NONE`. .. versionadded:: 20.0 pool_timeout (:obj:`float` | :obj:`None`, optional): Value to pass to :paramref:`telegram.request.BaseRequest.post.pool_timeout`. Defaults to :attr:`~telegram.request.BaseRequest.DEFAULT_NONE`. .. versionadded:: 20.0 Returns: :obj:`bytearray`: The same object as :paramref:`buf` if it was specified. Otherwise a newly allocated :obj:`bytearray`. Raises: RuntimeError: If :attr:`file_path` is not set. rBNr;) rrC bytearrayr rrDrJrKrLr2rextendr9)r r4r<r=r>r? bytes_datas r"download_as_bytearrayFile.download_as_bytearray&sb~~Z[ [ ;+C  ( (dnn-88:J#||~55>>%%')+ /) ? J    JJt,,Z8 9  JJz " sB$C3&C1'A C3cXlg)zySets the passport credentials for the file. Args: credentials (:class:`telegram.FileCredentials`): The credentials. N)r)r credentialss r"set_credentialsFile.set_credentialsms (r$)rrrrrr)NNr6)r_rr%N)__name__ __module__ __qualname____firstlineno____doc__ __slots__rrintr rr2bytesr9r r rfloatrrQrrVrYr\r`__static_attributes__ __classcell__)r!s@r"rr$s%NI$(#' *.C=  C= X&0 # dEded 04h)5)5+7(4hm,huo h   h "% huoh h\)5)5+7(4B Buo B   B "% BuoB BL$(E)5)5+7(4E i Euo E   E "% EuoE EN((r$r)rfrH urllib.parseparser'base64rpathlibrtypingrrrtelegram._passport.credentialsrtelegram._telegramobjectr telegram._utils.defaultvaluer telegram._utils.filesr telegram._utils.typesr r rtelegramrrr$r"rysC&F #44235/CC(O(>O(r$