o GChw@sdZddlZddlmZddlmZddlmZddlmZm Z ddl m Z ddl m Z mZdd lmZdd lmZdd lmZdd lmZdd lmZe edddddGdddZdS)z[This module contains a class that describes a single parameter of a request to the Bot API.N)Sequence) dataclass)datetime)Optionalfinal) InputFile) InputMediaInputPaidMedia) InputSticker)TelegramObject) to_timestamp) StringEnum)UploadFileDictTF)repreqorderfrozenc@seZdZUdZdZeed<eed<ee e ed<e deefddZ e dee fd d Zededeee e ffd d Zed ededdfddZdS)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_filesnamevaluerrrreturncCs,t|jtr |jS|jdurdSt|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) isinstancerstrjsondumpsselfr[/var/www/html/govbot/env/lib/python3.10/site-packages/telegram/request/_requestparameter.py json_valueCs   zRequestParameter.json_valuecsjsdSfddjDS)zA dict with the file data to upload, if any. .. versionchanged:: 21.5 Content may now be a file handle. Ncsi|] }|jp j|jqSr) attach_namer field_tuple).0 input_filerrr Xsz3RequestParameter.multipart_data..)rrrrrmultipart_dataOs  zRequestParameter.multipart_datacCs6t|tr t|gfSt|tr|jgfSt|tr(|jr#|j|gfSd|gfSt|ttfrqt|j trq| }|j jrD|j j|d<n| dd| dd}t|trk|jr^|j|d<n| dd||j |gfS||j gfSt|t rt|jtr| }|jj|d<||jgfSt|tr| 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 thumbnailsticker)rrr r rr attach_urirr r'to_dictpopgetr r)r )rdatar(rrr!_value_and_input_files_from_input]s6                 z2RequestParameter._value_and_input_files_from_inputkeycCst|ttfs7t|tr7g}g}|D]}||\}}|dur$||||qt|||r3|dSddS||\}}t|||rG|dSddS)zBuilds an instance of this class for a given key-value pair that represents the raw input as passed along from a method of :class:`telegram.Bot`. N)rrr)rrbytesrr/appendextendr)clsr0r param_valuesrobj param_valuer$rrr from_inputs&    zRequestParameter.from_inputN)__name__ __module__ __qualname____doc__ __slots__r__annotations__objectrlistrpropertyr rr& staticmethodtupler/ classmethodr8rrrrr#s$    =r)r<rcollections.abcr dataclassesrrtypingrrtelegram._files.inputfilertelegram._files.inputmediarr telegram._files.inputstickerr telegram._telegramobjectr telegram._utils.datetimer telegram._utils.enumr telegram._utils.typesrrrrrrs