U gi@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 eedddZ e ee dd d Zeeeee e fd d d ZeeeddddZdS)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_filesnamevaluerrr)returncCs,t|jtr|jS|jdkr dSt|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 F/tmp/pip-unpacked-wheel-swnnwir2/telegram/request/_requestparameter.py json_valueBs   zRequestParameter.json_valuecsjs dSfddjDS)zA dict with the file data to upload, if any. .. versionchanged:: 21.5 Content may now be a file handle. Ncsi|]}|jpj|jqSr )Z attach_namerZ field_tuple).0 input_filerr r! Ws z3RequestParameter.multipart_data..)rrr rr!multipart_dataNs  zRequestParameter.multipart_data)rrcCs<t|trt|gfSt|tr*|jgfSt|trP|jrF|j|gfSd|gfSt|ttfrt|j tr| }|j jr|j j|d<n | dd| dd}t|tr|jr|j|d<n | dd||j |gfS||j gfSt|t rt|jtr| }|jj|d<||jgfSt|tr4| 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 Z attach_urir r r'Zto_dictpopgetr r)r )rdatar(r r r!!_value_and_input_files_from_input\s6                 z2RequestParameter._value_and_input_files_from_input)keyrrcCst|ttfsjt|trjg}g}|D].}||\}}|dk rH||||q$t|||rb|nddS||\}}t|||r|nddS)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)clsr.rZ param_valuesrobjZ param_valuer$r r r! from_inputs&    zRequestParameter.from_inputN)__name__ __module__ __qualname____doc__ __slots__r__annotations__objectrrr propertyr"rr& staticmethodrr- classmethodr4r r r r!r"s   =r)r8rZ dataclassesrrtypingrrrrrZtelegram._files.inputfiler Ztelegram._files.inputmediar r Ztelegram._files.inputstickerr Ztelegram._telegramobjectr Ztelegram._utils.datetimerZtelegram._utils.enumrZtelegram._utils.typesrrr r r r!s