i3dZddlmZddlmZddlZddlmZddlm Z ddl m Z m Z m Z ddlmZmZdd lmZdd lmZe ed ZGd d eZdS) zSThis module contains methods to make POST and GET requests using the httpx library.) Collection)AnyN) DefaultValue) get_logger) HTTPVersionODVInput SocketOpt) NetworkErrorTimedOut) BaseRequest) RequestData HTTPXRequestceZdZdZdZ dd ed edzd edzd edzd edzdedee dzde e j ze j zdzdedzdee efdzfdZede fdZededzfdZde jfdZddZddZdejejejejfde de dedzd eed eed eed eedeeeffdZdS) raImplementation of :class:`~telegram.request.BaseRequest` using the library `httpx `_. .. versionadded:: 20.0 .. versionchanged:: 22.0 Removed the deprecated parameter ``proxy_url``. Use :paramref:`proxy` instead. Args: connection_pool_size (:obj:`int`, optional): Number of connections to keep in the connection pool. Defaults to ``256``. .. versionchanged:: 22.4 Set the default to ``256``. Stopped applying to ``httpx.Limits.max_keepalive_connections``. Now only applies to ``httpx.Limits.max_connections``. See `Resource Limits `_ read_timeout (:obj:`float` | :obj:`None`, optional): If passed, specifies the maximum amount of time (in seconds) to wait for a response from Telegram's server. This value is used unless a different value is passed to :meth:`do_request`. Defaults to ``5``. write_timeout (:obj:`float` | :obj:`None`, optional): If passed, specifies the maximum amount of time (in seconds) to wait for a write operation to complete (in terms of a network socket; i.e. POSTing a request or uploading a file). This value is used unless a different value is passed to :meth:`do_request`. Defaults to ``5``. Hint: This timeout is used for all requests except for those that upload media/files. For the latter, :paramref:`media_write_timeout` is used. connect_timeout (:obj:`float` | :obj:`None`, optional): If passed, specifies the maximum amount of time (in seconds) to wait for a connection attempt to a server to succeed. This value is used unless a different value is passed to :meth:`do_request`. Defaults to ``5``. pool_timeout (:obj:`float` | :obj:`None`, optional): If passed, specifies the maximum amount of time (in seconds) to wait for a connection to become available. This value is used unless a different value is passed to :meth:`do_request`. Defaults to ``1``. Warning: With a finite pool timeout, you must expect :exc:`telegram.error.TimedOut` exceptions to be thrown when more requests are made simultaneously than there are connections in the connection pool! http_version (:obj:`str`, optional): If ``"2"`` or ``"2.0"``, HTTP/2 will be used instead of HTTP/1.1. Defaults to ``"1.1"``. .. versionadded:: 20.1 .. versionchanged:: 20.2 Reset the default version to 1.1. .. versionchanged:: 20.5 Accept ``"2"`` as a valid value. socket_options (Collection[:obj:`tuple`], optional): Socket options to be passed to the underlying `library `_. Note: The values accepted by this parameter depend on the operating system. This is a low-level parameter and should only be used if you are familiar with these concepts. .. versionadded:: 20.7 proxy (:obj:`str` | ``httpx.Proxy`` | ``httpx.URL``, optional): The URL to a proxy server, a ``httpx.Proxy`` object or a ``httpx.URL`` object. For example ``'http://127.0.0.1:3128'`` or ``'socks5://127.0.0.1:3128'``. Defaults to :obj:`None`. Note: * The proxy URL can also be set via the environment variables ``HTTPS_PROXY`` or ``ALL_PROXY``. See `the docs of httpx`_ for more info. * HTTPS proxies can be configured by passing a ``httpx.Proxy`` object with a corresponding ``ssl_context``. * For Socks5 support, additional dependencies are required. Make sure to install PTB via :command:`pip install "python-telegram-bot[socks]"` in this case. * Socks5 proxies can not be set via environment variables. .. _the docs of httpx: https://www.python-httpx.org/environment_variables/#proxies .. versionadded:: 20.7 media_write_timeout (:obj:`float` | :obj:`None`, optional): Like :paramref:`write_timeout`, but used only for requests that upload media/files. This value is used unless a different value is passed to :paramref:`do_request.write_timeout` of :meth:`do_request`. Defaults to ``20`` seconds. .. versionadded:: 21.0 httpx_kwargs (dict[:obj:`str`, Any], optional): Additional keyword arguments to be passed to the `httpx.AsyncClient `_ constructor. Warning: This parameter is intended for advanced users that want to fine-tune the behavior of the underlying ``httpx`` client. The values passed here will override all the defaults set by ``python-telegram-bot`` and all other parameters passed to :class:`HTTPXRequest`. The only exception is the :paramref:`media_write_timeout` parameter, which is not passed to the client constructor. No runtime warnings will be issued about parameters that are overridden in this way. .. versionadded:: 21.6 )_client_client_kwargs _http_version_media_write_timeout@?1.1N4@connection_pool_size read_timeout write_timeoutconnect_timeout pool_timeout http_versionsocket_optionsproxymedia_write_timeout httpx_kwargsc ||_| |_tj||||} tj|} |dvrt d|dk} | | d}|rtj|nd}| || |d|| pi|_ ||_ dS#t$rY}d t|vrd t|vrd t|vrtd |td |d}~wwxYw) Nconnectreadwritepool)max_connections)r2z2.0z2`http_version` must be either '1.1', '2.0' or '2'.r)http1http2)r)timeoutr limits transportz httpx[http2]z httpx[socks]z\To use Socks5 proxies, PTB must be installed via `pip install "python-telegram-bot[socks]"`.zTTo use HTTP/2, PTB must be installed via `pip install "python-telegram-bot[http2]"`.) rrhttpxTimeoutLimits ValueErrorAsyncHTTPTransportr _build_clientr ImportErrorstr RuntimeError)selfrrrrrrrr r!r"r-r.r+ http_kwargsr/excs ^/Users/shanyulin/my-agent/.venv/lib/python3.11/site-packages/telegram/request/_httpxrequest.py__init__zHTTPXRequest.__init__s*$7!-#     0    2 2 2QRR R% %E ::  E $-     "     !r   --//DLLL   SXX--.C2P2PS))"51  sB"" D,ADDreturnc|jS)zn :obj:`str`: Used HTTP version, see :paramref:`http_version`. .. versionadded:: 20.2 )rr9s r<rzHTTPXRequest.http_versions !!c$|jjjS)zSee :attr:`BaseRequest.read_timeout`. Returns: :obj:`float` | :obj:`None`: The default read timeout in seconds as passed to :paramref:`HTTPXRequest.read_timeout`. )rr-r&r@s r<rzHTTPXRequest.read_timeouts|#((rAc.tjdi|jS)N)r0 AsyncClientrr@s r<r5zHTTPXRequest._build_clients 774#6777rAcXK|jjr||_dSdS)z#See :meth:`BaseRequest.initialize`.N)r is_closedr5r@s r< initializezHTTPXRequest.initializes4 < ! 0--//DLLL 0 0rAcK|jjrtddS|jd{VdS)z!See :meth:`BaseRequest.shutdown`.z2This HTTPXRequest is already shut down. Returning.N)rrG_LOGGERdebugacloser@s r<shutdownzHTTPXRequest.shutdownsW < !  MMN O O O Fl!!###########rAurlmethod request_datacLK|jjrtd|r|jnd}|r|jnd} t |t r|jjj}t |t r|jjj }t |t r|jjj }t |t r|s|jjj n|j }tj||||} |j||d|ji| || d{V} n|#tj$r8} t | tjrt'd| t&| d} ~ wtj$r%} t+d| jjd | | d} ~ wwxYw| j| jfS) z#See :meth:`BaseRequest.do_request`.z%This HTTPXRequest is not initialized!Nr$z User-Agent)rOrNheadersr-filesdatazPool timeout: All connections in the connection pool are occupied. Request was *not* sent to Telegram. Consider adjusting the connection pool size or the pool timeout.)messagezhttpx.z: )rrGr8multipart_datajson_parameters isinstancerr-r&r%r(r'rr0r1request USER_AGENTTimeoutException PoolTimeoutr HTTPErrorr __class____name__ status_codecontent) r9rNrOrPrrrrrSrTr-reserrs r< do_requestzHTTPXRequest.do_requests  < ! HFGG G/;E ++/;E|++ lL 1 1 5</4L o| 4 4 ;"l2:O lL 1 1 5</4L m\ 2 2 c>CbDL066IbM-#     R ,,%t7 -CC% $ $ $#u011 9   # R R R G (>GG#GGHHc Q  R ++s$.-DF+3EF0 FF) rrrrrrNNrN)r>N)r_ __module__ __qualname____doc__ __slots__intfloatrrr r7r0ProxyURLdictrr=propertyrrrEr5rHrMr DEFAULT_NONEr rtuplebytesrdrDrAr<rr)s=ccJWI%(%(&)(+%($)7;6:,0.2<<!<dl<t| <  < dl <"<#9-4<U[ 59,t3<#T\<38nt+<<<<|"c"""X")edl)))X)8u088880000 $$$$,0(3(@)4)A+6+C(3(@?,?, ?,?,"D( ?, uo ?,   ?,"%?,uo?, sEz ?,?,?,?,?,?,rA)rgcollections.abcrtypingrr0telegram._utils.defaultvaluertelegram._utils.loggingrtelegram._utils.typesrrr telegram.errorr r telegram.request._baserequestr telegram.request._requestdatar r_rJrrDrAr<rzs &ZY&&&&&& 555555......BBBBBBBBBB11111111555555555555 *X~ . .H,H,H,H,H,;H,H,H,H,H,rA