i` dZddlmZddlmZmZmZmZmZddl m Z m Z erddlm Z ddl mZmZedd Zed eed eed zeffd Zed ed ed effdZd dd eed zdffdZd e d ed zfdZd e d zd efdZ ddddedd zded zdeded df dZd S)aThis module contains helper functions related to handling of files. .. versionchanged:: 20.0 Previously, the contents of this module were available through the (no longer existing) module ``telegram._utils.helpers``. Warning: Contents of this module are intended to be used internally by the library and *not* by the user. Changes to this module are not considered breaking changes and may not be documented in the changelog. )Path)IO TYPE_CHECKINGTypeVarcastoverload) FileInput FilePathInput)Any) InputFileTelegramObject_Tz%bytes | InputFile | str | Path | None)boundobjreturnNcdSNrs U/Users/shanyulin/my-agent/.venv/lib/python3.11/site-packages/telegram/_utils/files.py load_filer,s;>3cdSrrrs rrr0s+.3rzFileInput | Nonec|dS |}n"#t$rdtd|fcYSwxYwt|}||fS)ztIf the input is a file handle, read the data and name and return it. Otherwise, return the input unchanged. N)NNzbytes | InputFile | str | Path)readAttributeErrorrguess_file_name)rcontentsfilenames rrr4sx  {zA88:: AAAT:C@@@@@@As##H X s ::ct|dr3t|jtst |jjSdS)zgIf the input is a file handle, read name and return it. Otherwise, return the input unchanged. nameN)hasattr isinstancer!intrrs rrrGs?sF#Jsx$=$=#CH~~"" 4rct|dSt|} |S#t$rYdSwxYw)zw Checks if a given string is a file on local system. Args: obj (:obj:`str`): The string to check. NF)ris_file Exception)rpaths r is_local_filer)QsN {u 99D||~~ uus ) 77F file_inputzFileInput | TelegramObjecttg_typer rattach local_modezstr | InputFile | Anycddlm}t|tr(|dr|st d|St|tt zrt|rst |}|r&| S| d5}||||cdddS#1swxYwY|St|tr||||St|d r|td |||S|rt||r|jS|S) a Parses input for sending files: * For string input, if the input is an absolute path of a local file: * if ``local_mode`` is ``True``, adds the ``file://`` prefix. If the input is a relative path of a local file, computes the absolute path and adds the ``file://`` prefix. * if ``local_mode`` is ``False``, loads the file as binary data and builds an :class:`InputFile` from that Returns the input unchanged, otherwise. * :class:`pathlib.Path` objects are treated the same way as strings. * For IO and bytes input, returns an :class:`telegram.InputFile`. * If :attr:`tg_type` is specified and the input is of that type, returns the ``file_id`` attribute. Args: file_input (:obj:`str` | :obj:`bytes` | :term:`file object` | :class:`~telegram.InputFile` | Telegram media object): The input to parse. tg_type (:obj:`type`, optional): The Telegram media type the input can be. E.g. :class:`telegram.Animation`. filename (:obj:`str`, optional): The filename. Only relevant in case an :class:`telegram.InputFile` is returned. attach (:obj:`bool`, optional): Pass :obj:`True` if the parameter this file belongs to in the request to Telegram should point to the multipart data via an ``attach://`` URI. Defaults to `False`. Only relevant if an :class:`telegram.InputFile` is returned. local_mode (:obj:`bool`, optional): Pass :obj:`True` if the bot is running an api server in ``--local`` mode. Returns: :obj:`str` | :class:`telegram.InputFile` | :obj:`object`: The parsed input or the untouched :attr:`file_input`, in case it's no valid file input. r)r zfile://zBSpecified file input is a file URI, but local mode is not enabled.rb)mode)rr,Nrr)telegramr r#str startswith ValueErrorrr)absoluteas_uriopenbytesr"rfile_id)r*r+rr,r-r r( file_handles rparse_file_inputr;bsR#"""""*c""z'<'rCs&  ==============::::::::322222222 WT@AAA >2e9>sTz5'8!9>>> > .2.%b/... .  3:> >?&sTz}t+&.2 >>,> " #d *>Dj>  >  >  >>>>>>r