U g @srdZddlZddlmZmZmZmZmZmZddl m Z ddl m Z ddl mZddlmZeGdd d ZdS) zSThis module contains a class that holds the parameters of a request to the Bot API.N)AnyDictListOptionalUnionfinal) urlencode) TextEncoding)UploadFileDict)RequestParameterc @seZdZdZdZdeeedddZe e e e e e eee eefffddd Ze e e e fdd d Zdee e efe d d dZde ee e efe dddZe edddZe edddZdS) RequestDataa?Instances of this class collect the data needed for one request to the Bot API, including all parameters and files to be sent along with the request. .. versionadded:: 20.0 Warning: How exactly instances of this are created should be considered an implementation detail and not part of PTBs public API. Users should exclusively rely on the documented attributes, properties and methods. Attributes: contains_files (:obj:`bool`): Whether this object contains files to be uploaded via ``multipart/form-data``. ) _parameterscontains_filesN) parameterscCs$|pg|_tdd|jD|_dS)Ncss|] }|jVqdSN)Z input_files.0paramrA/tmp/pip-unpacked-wheel-swnnwir2/telegram/request/_requestdata.py 2sz'RequestData.__init__..)r anyr)selfrrrr__init__0s zRequestData.__init__)returncCsdd|jDS)aGives the parameters as mapping of parameter name to the parameter value, which can be a single object of type :obj:`int`, :obj:`float`, :obj:`str` or :obj:`bool` or any (possibly nested) composition of lists, tuples and dictionaries, where each entry, key and value is of one of the mentioned types. Returns: Dict[:obj:`str`, Union[:obj:`str`, :obj:`int`, List[any], Dict[any, any]]] cSs i|]}|jdk r|j|jqSr)valuenamerrrr >s z*RequestData.parameters..r rrrrr4s zRequestData.parameterscCsdd|jDS)aGives the parameters as mapping of parameter name to the respective JSON encoded value. Tip: By default, this property uses the standard library's :func:`json.dumps`. To use a custom library for JSON encoding, you can directly encode the keys of :attr:`parameters` - note that string valued keys should not be JSON encoded. Returns: Dict[:obj:`str`, :obj:`str`] cSs i|]}|jdk r|j|jqSr)Z json_valuerrrrrrQs z/RequestData.json_parameters..rrrrrjson_parametersDs zRequestData.json_parameters) encode_kwargsrcCs|rt|jf|St|jS)aEncodes the parameters with :func:`urllib.parse.urlencode`. Args: encode_kwargs (Dict[:obj:`str`, any], optional): Additional keyword arguments to pass along to :func:`urllib.parse.urlencode`. Returns: :obj:`str` )rr )rr!rrrurl_encoded_parametersWs z"RequestData.url_encoded_parameters)urlr!rcCs|j|d}|d|S)aShortcut for attaching the return value of :meth:`url_encoded_parameters` to the :paramref:`url`. Args: url (:obj:`str`): The URL the parameters will be attached to. encode_kwargs (Dict[:obj:`str`, any], optional): Additional keyword arguments to pass along to :func:`urllib.parse.urlencode`. Returns: :obj:`str` )r!?)r")rr#r!Zurl_parametersrrrparametrized_urles zRequestData.parametrized_urlcCst|jtjS)aThe :attr:`parameters` as UTF-8 encoded JSON payload. Tip: By default, this property uses the standard library's :func:`json.dumps`. To use a custom library for JSON encoding, you can directly encode the keys of :attr:`parameters` - note that string valued keys should not be JSON encoded. Returns: :obj:`bytes` )jsondumpsr encoder ZUTF_8rrrr json_payloadts zRequestData.json_payloadcCs(i}|jD]}|j}|r ||q |S)zGives the files contained in this object as mapping of part name to encoded content. .. versionchanged:: 21.5 Content may now be a file handle. )r multipart_dataupdate)rr*rZm_datarrrr*s   zRequestData.multipart_data)N)N)N)__name__ __module__ __qualname____doc__ __slots__rrr rpropertyrstrrintrrr r"r%bytesr)r r*rrrrr s0  r )r/r&typingrrrrrr urllib.parserZtelegram._utils.stringsr Ztelegram._utils.typesr Z"telegram.request._requestparameterr r rrrrs