o /hi@sdZddlZddlmZddlmZddlmZmZmZm Z m Z ddl m Z ddl mZmZddlmZdd lmZdd lmZdd lmZdd lmZe ed ddd dGdddZdS)z[This module contains a class that describes a single parameter of a request to the Bot API.N) dataclass)datetime)ListOptionalSequenceTuplefinal) 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_valueBs   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_filerr r! Wsz3RequestParameter.multipart_data..)rrr rr!multipart_dataNs  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)rrrrrr attach_urir r r)to_dictpopgetr r+r )rdatar*r r r!!_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)rrbytesrr1appendextendr)clsr2r param_valuesrobj param_valuer&r r r! from_inputs&    zRequestParameter.from_inputN)__name__ __module__ __qualname____doc__ __slots__r__annotations__objectrrr propertyr"rr( staticmethodrr1 classmethodr:r r r r!r"s$    =r)r>r dataclassesrrtypingrrrrrtelegram._files.inputfiler telegram._files.inputmediar r telegram._files.inputstickerr telegram._telegramobjectr telegram._utils.datetimertelegram._utils.enumrtelegram._utils.typesrrr r r r!s