i#dZddlZddlZddlmZddlmZddlm Z ddl m Z ddl m Z ddlmZmZdd lmZmZdd lmZdd lmZdd lmZdd lmZddlmZe eddddGddZdS)z[This module contains a class that describes a single parameter of a request to the Bot API.N)Sequence) dataclass)final)InputStoryContent) InputFile) InputMediaInputPaidMedia)InputProfilePhotoInputProfilePhotoStatic) InputSticker)TelegramObject) to_timestamp) StringEnum)UploadFileDictTF)repreqorderfrozenceZdZUdZdZeed<eed<ee dzed<e dedzfdZ e de dzfd Z ededeeee ffd Zed ededdfd ZdS) RequestParameteraInstances of this class represent a single parameter to be sent along with a request to the Bot API. .. versionadded:: 20.0 Warning: This class intended is to be used internally by the library and *not* by the user. Changes to this class are not considered breaking changes and may not be documented in the changelog. Args: name (:obj:`str`): The name of the parameter. value (:obj:`object` | :obj:`None`): The value of the parameter. Must be JSON-dumpable. input_files (list[:class:`telegram.InputFile`], optional): A list of files that should be uploaded along with this parameter. Attributes: name (:obj:`str`): The name of the parameter. value (:obj:`object` | :obj:`None`): The value of the parameter. input_files (list[:class:`telegram.InputFile` | :obj:`None`): A list of files that should be uploaded along with this parameter. ) input_filesnamevaluerrNrreturnct|jtr|jS|jdStj|jS)zThe JSON dumped :attr:`value` or :obj:`None` if :attr:`value` is :obj:`None`. The latter can currently only happen if :attr:`input_files` has exactly one element that must not be uploaded via an attach:// URI. N) isinstancerstrjsondumpsselfs b/Users/shanyulin/my-agent/.venv/lib/python3.11/site-packages/telegram/request/_requestparameter.py json_valuezRequestParameter.json_valueFs? dj# & & :  : 4z$*%%%c<jsdSfdjDS)zA dict with the file data to upload, if any. .. versionchanged:: 21.5 Content may now be a file handle. Nc8i|]}|jpj|jS) attach_namer field_tuple).0 input_filer!s r" z3RequestParameter.multipart_data..[s8    # 0ty:3I   r$)rr s`r"multipart_datazRequestParameter.multipart_dataRsC 4    ".    r$ct|tjrt|gfSt|tjr=|}|rt|gfS|gfSt|tr |j gfSt|tr|j r |j |gfSd|gfSt|ttzrt|jtr|}|jj r|jj |d<n|dd|dd}t|tr3|j r |j |d<n|dd||j|gfS||jgfSt|t$rwt|t&rdnd}tt)||x}ts|gfS|}|j ||<||gfSt|t*re|j}tt)||x}ts|gfS|}|j ||<||gfSt|t.rGt|jtr-|}|jj |d<||jgfSt|t2r|gfS|gfS)aXConverts `value` into something that we can json-dump. Returns two values: 1. the JSON-dumpable value. May be `None` in case the value is an InputFile which must not be uploaded via an attach:// URI 2. A list of InputFiles that should be uploaded for this value Note that we handle files differently depending on whether attaching them via an URI of the form attach:// is documented to be allowed or not. There was some confusion whether this worked for all files, so that we stick to the documented ways for now. See https://github.com/tdlib/telegram-bot-api/issues/167 and https://github.com/tdlib/telegram-bot-api/issues/259 This method only does some special casing for our own helper class StringEnum, but not for general enums. This is because: * tg.constants currently only uses IntEnum as second enum type and json dumping that is no problem * if a user passes a custom enum, it's unlikely that we can actually properly handle it even with some special casing. Nmedia thumbnailphoto animationsticker)rdtmdatetimer timedelta total_seconds is_integerintrrr attach_urirr r/to_dictpopgetr r getattrrtyper r3r )rsecondsdatar0attrr/s r"!_value_and_input_files_from_inputz2RequestParameter._value_and_input_files_from_input`s4. eS\ * * +&&* * eS] + + ))++G!!## (7||R''B;  eZ ( ( #;? " eY ' ' ! 1'%00%= eZ.8 9 9 'jV_>`>` '==??D{% ( % 6W $'''d33I)Y// 6'0(1(rfsm&ba $$$$$$!!!!!!@@@@@@//////AAAAAAAAXXXXXXXX555555333333111111++++++000000 eD999k k k k k k k :9k k k r$