o "h#@sdZddlZddlZddlmZddlmZddlm Z m Z ddl m Z ddl mZddlmZmZdd lmZmZdd lmZdd lmZdd lmZdd lmZddlmZe edddddGdddZdS)z[This module contains a class that describes a single parameter of a request to the Bot API.N)Sequence) dataclass)Optionalfinal)InputStoryContent) InputFile) InputMediaInputPaidMedia)InputProfilePhotoInputProfilePhotoStatic) 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 U/var/www/html/venv/lib/python3.10/site-packages/telegram/request/_requestparameter.py json_valueEs   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! Zsz3RequestParameter.multipart_data..)rrr rr!multipart_dataQs  zRequestParameter.multipart_datacCst|tjr t|gfSt|tjr$|}|r t|gfS|gfSt|tr.|j gfSt|t rA|j r<|j |gfSd|gfSt|t t frt|jt r|}|jj r]|jj |d<n|dd|dd}t|t r|j rw|j |d<n|dd||j|gfS||jgfSt|trt|trdnd}tt||}t s|gfS|}|j ||<||gfSt|tr|j}tt||}t s|gfS|}|j ||<||gfSt|trt|jt r|}|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 thumbnailphoto animationsticker)rdtmdatetimer timedelta total_seconds is_integerintrrr attach_urirr r)to_dictpopgetr r getattrrtyper r-r )rsecondsdatar*attrr)r r r!!_value_and_input_files_from_input_s\                           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)clsr>r param_valuesrobj param_valuer&r r r! from_inputs&    zRequestParameter.from_inputN)__name__ __module__ __qualname____doc__ __slots__r__annotations__objectrlistrpropertyr"rr( staticmethodtupler= classmethodrFr r r r!r%s$    ^r) rJr/r.rcollections.abcr dataclassesrtypingrr"telegram._files._inputstorycontentrtelegram._files.inputfilertelegram._files.inputmediarr !telegram._files.inputprofilephotor r telegram._files.inputstickerr telegram._telegramobjectr telegram._utils.datetimertelegram._utils.enumrtelegram._utils.typesrrr r r r!s$