U Wi @sZddlmZddlZddlZddlZddlZddlZddlmZm Z ddl m Z ddl m Z ddl mZmZmZddlmZmZmZmZmZmZdd lmZdd lmZmZmZmZdd lm Z m!Z!m"Z"m#Z#dd l$m%Z%dd l&m'Z'ddl(m)Z)m*Z*ddl+m,Z,m-Z-ddl.m/Z/ddl0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;mZ>m?Z?ddl@mAZAmBZBddlCmDZDmEZEmFZFmGZGmHZHdddgZIejJdddZKejJdddZLGdddZMeMZNeOdZPde ZQdRdd eSDZTGd!d"d"ejUZVGd#d$d$e=ZWGd%d&d&e1ZXejYd'ejZfZ[Gd(d)d)Z\Gd*dde\Z]Gd+dde\Z^dS),) annotationsN)asynccontextmanagercontextmanager) TracebackType) __version__)Auth BasicAuth FunctionAuth)DEFAULT_LIMITSDEFAULT_MAX_REDIRECTSDEFAULT_TIMEOUT_CONFIGLimitsProxyTimeout)SUPPORTED_DECODERS) InvalidURLRemoteProtocolErrorTooManyRedirectsrequest_context)CookiesHeadersRequestResponse)codes) ASGITransport)AsyncBaseTransport BaseTransport)AsyncHTTPTransport HTTPTransport) WSGITransport)AsyncByteStream AuthTypes CertTypes CookieTypes HeaderTypes ProxiesTypes ProxyTypesQueryParamTypesRequestContent RequestDataRequestExtensions RequestFilesSyncByteStream TimeoutTypes VerifyTypes)URL QueryParams)Timer URLPatternget_environment_proxiesis_https_redirect same_originUSE_CLIENT_DEFAULT AsyncClientClientT)boundUc@seZdZdZdS)UseClientDefaulta< For some parameters such as `auth=...` and `timeout=...` we need to be able to indicate the default "unset" state, in a way that is distinctly different to using `None`. The default "unset" state indicates that whatever default is set on the client should be used. This is different to setting `None`, which explicitly disables the parameter, possibly overriding a client default. For example we use `timeout=USE_CLIENT_DEFAULT` in the `request()` signature. Omitting the `timeout` parameter will send a request using whatever default timeout has been configured on the client. Including `timeout=None` will ensure no timeout is used. Note that user code shouldn't need to use the `USE_CLIENT_DEFAULT` constant, but it is used internally when a parameter is not included. N)__name__ __module__ __qualname____doc__rBrBS/home/afrizal/public_html/fastapi/venv/lib/python3.8/site-packages/httpx/_client.pyr=Dsr=Zhttpxz python-httpx/z, cCsg|]}|dkr|qS)identityrB).0keyrBrBrC _srGc@seZdZdZdZdZdS) ClientStaterN)r>r?r@UNOPENEDOPENEDCLOSEDrBrBrBrCrHcsrHc@s@eZdZdZdddddddZd d d d Zdd d dZdS)BoundSyncStreamz A byte stream that is bound to a given response instance, and that ensures the `response.elapsed` is set once the response is closed. r-rr2NonestreamresponsetimerreturncCs||_||_||_dSN_stream _response_timerselfrQrRrSrBrBrC__init__wszBoundSyncStream.__init__ztyping.Iterator[bytes]rTccs|jD] }|VqdSrUrWr[chunkrBrBrC__iter__~s zBoundSyncStream.__iter__cCs(|j}tj|d|j_|jdSN)seconds)rYZ sync_elapseddatetime timedeltarXelapsedrWcloser[rcrBrBrCrgs zBoundSyncStream.closeN)r>r?r@rAr\rargrBrBrBrCrNqsrNc@s@eZdZdZdddddddZd d d d Zdd d dZdS)BoundAsyncStreamz An async byte stream that is bound to a given response instance, and that ensures the `response.elapsed` is set once the response is closed. r!rr2rOrPcCs||_||_||_dSrUrVrZrBrBrCr\szBoundAsyncStream.__init__ztyping.AsyncIterator[bytes]r]cCs |j2z3dHW}|Vq6dSrUr^r_rBrBrC __aiter__szBoundAsyncStream.__aiter__cs4|jIdH}tj|d|j_|jIdHdSrb)rYZ async_elapsedrdrerXrfrWacloserhrBrBrCrkszBoundAsyncStream.acloseN)r>r?r@rAr\rjrkrBrBrBrCrisri.c@seZdZddddededdddd ddd d d d d ddd ddd ddZed dddZed dddZdddddZ dd dd d!d"Z ed#dd$d%Z e j d dd&d'd%Z ed(dd)d*Z e j d(dd+d,d*Z ed-dd.d/Zej d0dd1d2d/Zeddd3d4Zej dddd5d4Zed6dd7d8Zej d9dd:d;d8ZedZej d?dd@dAd>ZedBddCdDZej dEddFdGdDZdddddddeddH dIddJdKdLdMdd d dNdOdPdQ dRdSZddddTdUZdud d d@dVdWZdvd d d:dXdYZdwdddFdZd[Zdd-d1d\d]ZefdPd^d_d`dadbZdPdcdPdddedfZdPdcdIdddgdhZdPdcddddidjZdPddId6dkdldmZdPdIdndodpdqZdPddrdsdtZ dS)x BaseClientNFTutf-8 authparamsheaderscookiestimeoutfollow_redirects max_redirects event_hooksbase_url trust_envdefault_encodingAuthTypes | NoneQueryParamTypes | NoneHeaderTypes | NoneCookieTypes | Noner.boolint+None | typing.Mapping[str, list[EventHook]] URL | str#str | typing.Callable[[bytes], str]rO) rprqrrrsrtrurvrwrxryrzrTc Cs|dkr in|}|t| |_|||_t||_t||_t ||_ t ||_ ||_ ||_t|dgt|dgd|_| |_| |_tj|_dSNrequestrR)rrR)_enforce_trailing_slashr0 _base_url _build_auth_authr1_paramsrrrr_cookiesr_timeoutrurvlistget _event_hooks _trust_env_default_encodingrHrK_state) r[rprqrrrsrtrurvrwrxryrzrBrBrCr\s     zBaseClient.__init__r]cCs |jtjkS)z2 Check if the client being closed )rrHrMr[rBrBrC is_closedszBaseClient.is_closedcCs|jSrU)rrrBrBrCryszBaseClient.trust_envr0urlrTcCs"|jdr|S|j|jddS)N/raw_path)rendswith copy_withr[rrBrBrCrs z"BaseClient._enforce_trailing_slashProxiesTypes | Nonezdict[str, Proxy | None])proxiesallow_env_proxiesrTcCs|dkr$|r ddtDSiSt|trpi}|D]0\}}t|ttfrZt|dn|}||t|<q:|St|ttfrt|dn|}d|iSdS)NcSs(i|] \}}||dkrdnt|dqS)Nr)r)rErFrrBrBrC sz-BaseClient._get_proxy_map..rzall://)r4items isinstancedictstrr0r)r[rr new_proxiesrFvalueproxyrBrBrC_get_proxy_maps zBaseClient._get_proxy_maprcCs|jSrU)rrrBrBrCrtszBaseClient.timeout)rtrTcCst||_dSrU)rr)r[rtrBrBrCrtszdict[str, list[EventHook]]cCs|jSrU)rrrBrBrCrwszBaseClient.event_hooks)rwrTcCs(t|dgt|dgd|_dSr)rrr)r[rwrBrBrCrwsz Auth | NonecCs|jS)z Authentication class used when none is passed at the request-level. See also [Authentication][0]. [0]: /quickstart/#authentication )rrrBrBrCrps zBaseClient.authr")rprTcCs|||_dSrU)rrr[rprBrBrCrpscCs|jS)zK Base URL to use when sending requests with relative URLs. )rrrBrBrCrx szBaseClient.base_urlcCs|t||_dSrU)rr0rrrBrBrCrxsrcCs|jS)z@ HTTP headers to include when sending requests. )_headersrrBrBrCrrszBaseClient.headersr%)rrrTcCs2tdtddtdd}||||_dS)Ns*/*asciis keep-alive)sAcceptsAccept-Encodings Connections User-Agent)rACCEPT_ENCODINGencode USER_AGENTupdater)r[rrZclient_headersrBrBrCrrs rcCs|jS)zA Cookie values to include when sending requests. )rrrBrBrCrs*szBaseClient.cookiesr$)rsrTcCst||_dSrU)rr)r[rsrBrBrCrs1sr1cCs|jS)zO Query parameters to include in the URL when sending requests. )rrrBrBrCrq5szBaseClient.paramsr()rqrTcCst||_dSrU)r1r)r[rqrBrBrCrq<s) contentdatafilesjsonrqrrrsrt extensionsrRequestContent | NoneRequestData | NoneRequestFiles | Nonetyping.Any | NoneTimeoutTypes | UseClientDefaultRequestExtensions | Noner) methodrrrrrrqrrrsrtrrTc Cs||}||}|| } ||}| dkr4in| } d| krnt| trP|jnt| } tf| d| i} t ||||||||| | d S)aR Build and return a request instance. * The `params`, `headers` and `cookies` arguments are merged with any values set on the client. * The `url` argument is merged with any `base_url` set on the client. See also: [Request instances][0] [0]: /advanced/clients/#request-instances Nrt)rrrrrqrrrsr) _merge_url_merge_headers_merge_cookies_merge_queryparamsrr=rtrras_dictr) r[rrrrrrrqrrrsrtrrBrBrC build_request@s.    zBaseClient.build_requestcCs4t|}|jr0|jj|jd}|jj|dS|S)z Merge a URL argument together with any 'base_url' on the client, to create the URL used for the outgoing request. rr)r0is_relative_urlrxrlstripr)r[rZ merge_urlZmerge_raw_pathrBrBrCrss  zBaseClient._merge_urlcCs&|s |jr"t|j}|||S|S)z Merge a cookies argument together with any cookies on the client, to create the cookies used for the outgoing request. )rsrr)r[rsmerged_cookiesrBrBrCrs    zBaseClient._merge_cookiescCst|j}|||S)z Merge a headers argument together with any headers on the client, to create the headers used for the outgoing request. )rrrr)r[rrZmerged_headersrBrBrCrs  zBaseClient._merge_headerscCs"|s |jrt|j}||S|S)z Merge a queryparams argument together with any queryparams on the client, to create the queryparams used for the outgoing request. )rqr1merge)r[rqZmerged_queryparamsrBrBrCrs   zBaseClient._merge_queryparamscCs\|dkr dSt|tr*t|d|ddSt|tr8|St|rJt|dStd|dS)Nrrusernamepassword)funczInvalid "auth" argument: )rtupler rcallabler TypeErrorrrBrBrCrs   zBaseClient._build_auth#AuthTypes | UseClientDefault | Noner)rrprTcCsRt|tr|jn||}|dk r&|S|jj|jj}}|s@|rLt||dStS)Nr) rr=rrrrrr r)r[rrprrrBrBrC_build_request_auths zBaseClient._build_request_authr)rrRrTcCsR|||}|||}||||}|||}t|j}t||||||jdS)z Given a request and a redirect response, return a new request that should be used to effect the redirect. )rrrrrsrQr)_redirect_method _redirect_url_redirect_headers_redirect_streamrrsrr)r[rrRrrrrrQrsrBrBrC_build_redirect_requests    z"BaseClient._build_redirect_requestcCsR|j}|jtjkr|dkrd}|jtjkr6|dkr6d}|jtjkrN|dkrNd}|S)z When being redirected we may want to change the method of the request based on certain specs or browser behavior. HEADGETPOST)r status_coder SEE_OTHERFOUNDMOVED_PERMANENTLY)r[rrRrrBrBrCrszBaseClient._redirect_methodc Cs|jd}z t|}Wn8tk rN}ztd|d|ddW5d}~XYnX|jrl|jsl|j|jjd}|jr~|j |}|jj r|j s|j|jj d}|S)z< Return the URL for the redirect to follow. ZLocationz Invalid URL in location header: .rN)host)fragment) rrr0rrschemerrrrjoinr)r[rrRlocationrexcrBrBrCrs"     zBaseClient._redirect_url)rrrrTcCsxt|j}t||js>t|j|s.|dd|jd|d<||jkrh|dkrh|dd|dd|dd|S) zR Return the headers that should be used for the redirect request. AuthorizationNrHostrzContent-LengthzTransfer-EncodingCookie) rrrr6rr5popnetlocdecoder)r[rrrrrrBrBrCrs       zBaseClient._redirect_headersz'SyncByteStream | AsyncByteStream | None)rrrTcCs||jkr|dkrdS|jS)zO Return the body that should be used for the redirect request. rN)rrQ)r[rrrBrBrCr)szBaseClient._redirect_streamrrTcCsDd|jkr@t|jtr|jnt|j}tf|jd|i|_dS)Nrt)rrrtr=rrr)r[rrtrBrBrC _set_timeout4s   zBaseClient._set_timeout)N)N)N)!r>r?r@r r r\propertyrryrrrtsetterrwrprxrrrsrqr7rrrrrrrrrrrrrrBrBrBrCrls("  (3    rlcs~eZdZdZdddddddddddedeeddddddddd d d d d dddddddddddddddddfddZddddedddfd d dddddddd d d!Zddddedfd"d d dddddd#d$d%Z d&dd'd(d)Z ddddddde e e dd* d+dd,d-d.d/d d d d0d1d2d3d4d5d6d7Z e ddddddde e e dd* d+dd,d-d.d/d d d d0d1d2d3d8d5d9d:Zde e d;dd?Zd>> client = httpx.Client() >>> response = client.get('https://example.org') ``` **Parameters:** * **auth** - *(optional)* An authentication class to use when sending requests. * **params** - *(optional)* Query parameters to include in request URLs, as a string, dictionary, or sequence of two-tuples. * **headers** - *(optional)* Dictionary of HTTP headers to include when sending requests. * **cookies** - *(optional)* Dictionary of Cookie items to include when sending requests. * **verify** - *(optional)* SSL certificates (a.k.a CA bundle) used to verify the identity of requested hosts. Either `True` (default CA bundle), a path to an SSL certificate file, an `ssl.SSLContext`, or `False` (which will disable verification). * **cert** - *(optional)* An SSL certificate used by the requested host to authenticate the client. Either a path to an SSL certificate file, or two-tuple of (certificate file, key file), or a three-tuple of (certificate file, key file, password). * **http2** - *(optional)* A boolean indicating if HTTP/2 support should be enabled. Defaults to `False`. * **proxy** - *(optional)* A proxy URL where all the traffic should be routed. * **proxies** - *(optional)* A dictionary mapping proxy keys to proxy URLs. * **timeout** - *(optional)* The timeout configuration to use when sending requests. * **limits** - *(optional)* The limits configuration to use. * **max_redirects** - *(optional)* The maximum number of redirect responses that should be followed. * **base_url** - *(optional)* A URL to use as the base when building request URLs. * **transport** - *(optional)* A transport class to use for sending requests over the network. * **app** - *(optional)* An WSGI application to send requests to, rather than sending actual network requests. * **trust_env** - *(optional)* Enables or disables usage of environment variables for configuration. * **default_encoding** - *(optional)* The default encoding to use for decoding response text, if no charset information is included in a response Content-Type header. Set to a callable for automatic character set detection. Default: "utf-8". NTFrmrnrprqrrrsverifycerthttp1http2rrmountsrtrulimitsrvrwrx transportappryrzr{r|r}r~r/CertTypes | NonerProxyTypes | Nonerz0None | typing.Mapping[str, BaseTransport | None]r.rrrrzBaseTransport | None'typing.Callable[..., typing.Any] | NonerrOrprqrrrsrrrrrrrrtrurrvrwrxrrryrzrTc s&tj||||| | ||||d rRz ddl}Wntk rPtddYnX| rrd}t|t| rrtd|rd}t|to|dko|dk}| p| |}j ||d_ fdd | D_ | dk rj d d | Dttj _ dS) NroruUsing http2=True, but the 'h2' package is not installed. Make sure to install httpx using `pip install httpx[http2]`.JThe 'proxies' argument is now deprecated. Use 'proxy' or 'mounts' instead.*Use either `proxy` or 'proxies', not both.zhThe 'app' shortcut is now deprecated. Use the explicit style 'transport=WSGITransport(app=...)' instead.rrrrrrrryc s:i|]2\}}t||dkrdnj|dqSNrrrrrryr3_init_proxy_transportrErFrrrrrr[ryrrBrCrs z#Client.__init__..cSsi|]\}}t||qSrBr3rErFrrBrBrCrssuperr\h2 ImportErrorwarningswarnDeprecationWarning RuntimeErrorr_init_transport _transportr_mountsrrsortedr[rprqrrrsrrrrrrrrtrurrvrwrxrrryrzr messagerZ proxy_map __class__rrCr\tsh      zClient.__init__r rrrrrrrryrTc Cs2|dk r |S|dk rt|dSt||||||dSN)rr)r r r[rrrrrrrryrBrBrCrs  zClient._init_transportrrrrrrrryrTc Cst|||||||dSN)rrrrrryr)rr[rrrrrrryrBrBrCrs zClient._init_proxy_transportr0rcCs:|jD](\}}||r |dkr*|jn|Sq |jSz Returns the transport instance that should be used for a given URL. This will either be the standard connection pool, or a proxy. Nrrmatchesrr[rpatternrrBrBrC_transport_for_urls zClient._transport_for_url rrrrrqrrrsrprurtrrrrrrrbool | UseClientDefaultrrrrrrrrrrqrrrsrprurtrrTc  CsH| dk rd}t|t|j||||||||| | | d }|j|| | dS)a Build and send a request. Equivalent to: ```python request = client.build_request(...) response = client.send(request, ...) ``` See `Client.build_request()`, `Client.send()` and [Merging of configuration][0] for how the various parameters are merged with client-level configuration. [0]: /advanced/clients/#merging-of-configuration NSetting per-request cookies=<...> is being deprecated, because the expected behaviour on cookie persistence is ambiguous. Set cookies directly on the client instance instead. rrrrrrrqrrrsrtrrprur r r rsendr[rrrrrrrqrrrsrprurtrrrrBrBrCrs$!  zClient.requestztyping.Iterator[Response]c  csL|j||||||||| | | d }|j|| | dd}z |VW5|XdSa  Alternative to `httpx.request()` that streams the response body instead of loading it into memory at once. **Parameters**: See `httpx.request`. See also: [Streaming Responses][0] [0]: /quickstart#streaming-responses r'T)rrprurQN)rr*rgr[rrrrrrrqrrrsrprurtrrrRrBrBrCrQGs,  z Client.streamrQrprurrrQrprurTc Cs|jtjkrtdtj|_t|tr,|jn|}||| ||}|j |||gd}z|sf| |WSt k r}z| |W5d}~XYnXdS)a Send a request. The request is sent as-is, unmodified. Typically you'll want to build one with `Client.build_request()` so that any client-level configuration is merged into the request, but passing an explicit `httpx.Request()` is supported as well. See also: [Request instances][0] [0]: /advanced/clients/#request-instances 5Cannot send a request, as the client has been closed.rpruhistoryN)rrHrMrrLrr=rurr_send_handling_authread BaseExceptionrgr[rrQrprurRrrBrBrCr*{s,   z Client.sendrlist[Response]rrprur2rTc Cs||}zt|}|j|||d}zRz||}Wntk rR|YWW\SXt||_||}| |Wqt k r}z||W5d}~XYqXqW5|XdSN)rur2) Zsync_auth_flowrgnext_send_handling_redirectsr* StopIterationrr2r4appendr5 r[rrprur2Z auth_flowrR next_requestrrBrBrCr3s*  zClient._send_handling_authrrur2rTc Cst||jkrtd|d|jdD] }||q$||}zb|jdD] }||qHt||_|jsl|WS|||}||g}|r| n ||_ |WSWqt k r}z| |W5d}~XYqXqdSNz#Exceeded maximum allowed redirects.rrrR) lenrvrr_send_single_requestrr2has_redirect_locationrr4r?r5rgr[rrur2hookrRrrBrBrCr;s.        zClient._send_handling_redirectsrc Cs||j}t}|t|jts.tdt|d| |}W5QRXt|jts^t ||_ t |j||d|_|j ||j|_td|j|j|j|j|j|S)L Sends a single request, without handling any redirections. z?Attempted to send an async request with a sync Client instance.rrRrSHTTP Request: %s %s "%s %d %s")r"rr2Z sync_startrrQr-rrhandle_requestAssertionErrorrrNrsextract_cookiesrrzloggerinfor http_versionr reason_phraser[rrrSrRrBrBrCrCs6     zClient._send_single_requestrqrrrsrprurtr rrqrrrsrprurtrrTc Cs|jd||||||||d S)U Send a `GET` request. **Parameters**: See `httpx.request`. rrRr r[rrqrrrsrprurtrrBrBrCrsz Client.getAuthTypes | UseClientDefaultc Cs|jd||||||||d S)Z Send an `OPTIONS` request. **Parameters**: See `httpx.request`. OPTIONSrRrrUrBrBrCoptions6szClient.optionsc Cs|jd||||||||d S)V Send a `HEAD` request. **Parameters**: See `httpx.request`. rrRrrUrBrBrCheadSsz Client.head rrrrrrqrrrsrprurtrrTc Cs$|jd||||||||| | | | d S)V Send a `POST` request. **Parameters**: See `httpx.request`. rr#r r[rrrrrrqrrrsrprurtrrBrBrCpostpsz Client.postc Cs$|jd||||||||| | | | d S)U Send a `PUT` request. **Parameters**: See `httpx.request`. PUTr#rr^rBrBrCputsz Client.putc Cs$|jd||||||||| | | | d S)W Send a `PATCH` request. **Parameters**: See `httpx.request`. PATCHr#rr^rBrBrCpatchsz Client.patchc Cs|jd||||||||d S)X Send a `DELETE` request. **Parameters**: See `httpx.request`. DELETErRrrUrBrBrCdeletesz Client.deleter]cCsB|jtjkr>tj|_|j|jD]}|dk r(|q(dSz. Close transport and proxies. N)rrHrMrrgrvalues)r[rrBrBrCrgs   z Client.closer:r[rTcCs`|jtjkr*tjdtjdi|j}t|tj|_|j|j D]}|dk rF|qF|SNz-Cannot open a client instance more than once.z9Cannot reopen a client instance, once it has been closed.) rrHrKrLrMrr __enter__rrj)r[msgrrBrBrCrms   zClient.__enter__type[BaseException] | NoneBaseException | NoneTracebackType | Noneexc_type exc_value tracebackrTcCsBtj|_|j||||jD]}|dk r"||||q"dSrU)rHrMrr__exit__rrj)r[rsrtrurrBrBrCrvs zClient.__exit__)NNN)r>r?r@rAr r r r\rrr"r7rrrQr*r3r;rCrrYr[r_rbrerhrgrmrv __classcell__rBrBrrCr9>s$8@d ,8.73"%("!"!"!*)*)*)" cs~eZdZdZdddddddddddedeeddddddddd d d d d dddddddddddddddddfddZddddedddfd d dddddddd d d!Zddddedfd"d d dddddd#d$d%Z d&dd'd(d)Z ddddddde e e dd* d+dd,d-d.d/d d d d0d1d2d3d4d5d6d7Z e ddddddde e e dd* d+dd,d-d.d/d d d d0d1d2d3d8d5d9d:Zde e d;dd?Zd>> async with httpx.AsyncClient() as client: >>> response = await client.get('https://example.org') ``` **Parameters:** * **auth** - *(optional)* An authentication class to use when sending requests. * **params** - *(optional)* Query parameters to include in request URLs, as a string, dictionary, or sequence of two-tuples. * **headers** - *(optional)* Dictionary of HTTP headers to include when sending requests. * **cookies** - *(optional)* Dictionary of Cookie items to include when sending requests. * **verify** - *(optional)* SSL certificates (a.k.a CA bundle) used to verify the identity of requested hosts. Either `True` (default CA bundle), a path to an SSL certificate file, an `ssl.SSLContext`, or `False` (which will disable verification). * **cert** - *(optional)* An SSL certificate used by the requested host to authenticate the client. Either a path to an SSL certificate file, or two-tuple of (certificate file, key file), or a three-tuple of (certificate file, key file, password). * **http2** - *(optional)* A boolean indicating if HTTP/2 support should be enabled. Defaults to `False`. * **proxy** - *(optional)* A proxy URL where all the traffic should be routed. * **proxies** - *(optional)* A dictionary mapping HTTP protocols to proxy URLs. * **timeout** - *(optional)* The timeout configuration to use when sending requests. * **limits** - *(optional)* The limits configuration to use. * **max_redirects** - *(optional)* The maximum number of redirect responses that should be followed. * **base_url** - *(optional)* A URL to use as the base when building request URLs. * **transport** - *(optional)* A transport class to use for sending requests over the network. * **app** - *(optional)* An ASGI application to send requests to, rather than sending actual network requests. * **trust_env** - *(optional)* Enables or disables usage of environment variables for configuration. * **default_encoding** - *(optional)* The default encoding to use for decoding response text, if no charset information is included in a response Content-Type header. Set to a callable for automatic character set detection. Default: "utf-8". NTFrmrnrr{r|r}r~r/rrrrz5None | typing.Mapping[str, AsyncBaseTransport | None]r.rrrrzAsyncBaseTransport | NonerrrOrc s&tj||||| | ||||d rRz ddl}Wntk rPtddYnX| rrd}t|t| rrtd|rd}t|to|dko|dk}| p| |}j ||d_ fdd | D_ | dk rj d d | Dttj _ dS) NrorrrrzhThe 'app' shortcut is now deprecated. Use the explicit style 'transport=ASGITransport(app=...)' instead.rc s:i|]2\}}t||dkrdnj|dqSrrrrrBrCrs z(AsyncClient.__init__..cSsi|]\}}t||qSrBrrrBrBrCrsrrrrrCr\_sh      zAsyncClient.__init__rrc Cs2|dk r |S|dk rt|dSt||||||dSr)rrrrBrBrCrs  zAsyncClient._init_transportrrc Cst|||||||dSr)rrrBrBrCrs z!AsyncClient._init_proxy_transportr0rcCs:|jD](\}}||r |dkr*|jn|Sq |jSrrr rBrBrCr"s zAsyncClient._transport_for_urlr#rrrrrrr$rrrr%c  sN| dk rd}t|t|j||||||||| | | d }|j|| | dIdHS)a Build and send a request. Equivalent to: ```python request = client.build_request(...) response = await client.send(request, ...) ``` See `AsyncClient.build_request()`, `AsyncClient.send()` and [Merging of configuration][0] for how the various parameters are merged with client-level configuration. [0]: /advanced/clients/#merging-of-configuration Nr&r'r(r)r+rBrBrCrs$"  zAsyncClient.requestztyping.AsyncIterator[Response]c  CsX|j||||||||| | | d }|j|| | ddIdH}z |VW5|IdHXdSr,)rr*rkr-rBrBrCrQ3s,   zAsyncClient.streamr.rr/c s|jtjkrtdtj|_t|tr,|jn|}||| ||}|j |||gdIdH}z|sr| IdH|WSt k r}z| IdH|W5d}~XYnXdS)a Send a request. The request is sent as-is, unmodified. Typically you'll want to build one with `AsyncClient.build_request()` so that any client-level configuration is merged into the request, but passing an explicit `httpx.Request()` is supported as well. See also: [Request instances][0] [0]: /advanced/clients/#request-instances r0r1N)rrHrMrrLrr=rurrr3areadr5rkr6rBrBrCr*gs,    zAsyncClient.sendrr7r8c s||}z|IdH}|j|||dIdH}z^z||IdH}Wntk rd|YWWhSXt||_|IdH|}| |Wqt k r}z|IdH|W5d}~XYqXqW5|IdHXdSr9) Zasync_auth_flowrk __anext__r;asendStopAsyncIterationrr2rxr=r5r>rBrBrCr3s*   zAsyncClient._send_handling_authr@c st||jkrtd|d|jdD]}||IdHq$||IdH}zn|jdD]}||IdHqTt||_|js~|WS|||}||g}|r| IdHn ||_ |WSWqt k r}z| IdH|W5d}~XYqXqdSrA) rBrvrrrCrr2rDrrxr?r5rkrErBrBrCr;s.    z$AsyncClient._send_handling_redirectsrc s||j}t}|IdHt|jts4tdt|d| |IdH}W5QRXt|jtsjt ||_ t |j||d|_|j ||j|_td|j|j|j|j|j|S)rGNz?Attempted to send an sync request with an AsyncClient instance.rrHrI)r"rr2Z async_startrrQr!rrZhandle_async_requestrKrrirsrLrrzrMrNrrOrrPrQrBrBrCrCs6     z AsyncClient._send_single_requestrRrSc s"|jd||||||||d IdHS)rTrrRNrrUrBrBrCrszAsyncClient.getrVc s"|jd||||||||d IdHS)rWrXrRNrrUrBrBrCrY"szAsyncClient.optionsc s"|jd||||||||d IdHS)rZrrRNrrUrBrBrCr[?szAsyncClient.headr\c s*|jd||||||||| | | | d IdHS)r]rr#Nrr^rBrBrCr_\szAsyncClient.postc s*|jd||||||||| | | | d IdHS)r`rar#Nrr^rBrBrCrbszAsyncClient.putc s*|jd||||||||| | | | d IdHS)rcrdr#Nrr^rBrBrCreszAsyncClient.patchc s"|jd||||||||d IdHS)rfrgrRNrrUrBrBrCrhszAsyncClient.deleter]csN|jtjkrJtj|_|jIdH|jD]}|dk r.|IdHq.dSri)rrHrMrrkrrj)r[rrBrBrCrks  zAsyncClient.acloser<rkcsl|jtjkr*tjdtjdi|j}t|tj|_|jIdH|j D]}|dk rL|IdHqL|Srl) rrHrKrLrMrr __aenter__rrj)r[rnrrBrBrCr|s zAsyncClient.__aenter__rorprqrrcsNtj|_|j|||IdH|jD] }|dk r(||||IdHq(dSrU)rHrMrr __aexit__rrj)r[rsrtrurrBrBrCr}s zAsyncClient.__aexit__)NNN)r>r?r@rAr r r r\rrr"r7rrrQr*r3r;rCrrYr[r_rbrerhrkr|r}rwrBrBrrCr8(s$9@d ,9.73"&'"!"!"!*)*)*)" )_ __future__rrdenumloggingtypingr  contextlibrrtypesrrrrr r _configr r r rrr _decodersr _exceptionsrrrrZ_modelsrrrrZ _status_codesrZ_transports.asgirZ_transports.baserrZ_transports.defaultrrZ_transports.wsgir _typesr!r"r#r$r%r&r'r(r)r*r+r,r-r.r/Z_urlsr0r1Z_utilsr2r3r4r5r6__all__TypeVarr:r<r=r7 getLoggerrMrrkeysrEnumrHrNriCallableAnyZ EventHookrlr9r8rBrBrBrCs\        D   o