httpx._client.BaseClient

class documentation

class BaseClient:

Known subclasses: httpx.AsyncClient, httpx.Client

Undocumented

Method	`__init__`	Undocumented
Method	`auth.setter`	Undocumented
Method	`base_url.setter`	Undocumented
Method	`build_request`	Build and return a request instance.
Method	`cookies.setter`	Undocumented
Method	`event_hooks.setter`	Undocumented
Method	`headers.setter`	Undocumented
Method	`params.setter`	Undocumented
Method	`timeout.setter`	Undocumented
Instance Variable	`follow_redirects`	Undocumented
Instance Variable	`max_redirects`	Undocumented
Property	`auth`	Authentication class used when none is passed at the request-level.
Property	`base_url`	Base URL to use when sending requests with relative URLs.
Property	`cookies`	Cookie values to include when sending requests.
Property	`event_hooks`	Undocumented
Property	`headers`	HTTP headers to include when sending requests.
Property	`is_closed`	Check if the client being closed
Property	`params`	Query parameters to include in the URL when sending requests.
Property	`timeout`	Undocumented
Property	`trust_env`	Undocumented
Method	`_build_auth`	Undocumented
Method	`_build_redirect_request`	Given a request and a redirect response, return a new request that should be used to effect the redirect.
Method	`_build_request_auth`	Undocumented
Method	`_enforce_trailing_slash`	Undocumented
Method	`_get_proxy_map`	Undocumented
Method	`_merge_cookies`	Merge a cookies argument together with any cookies on the client, to create the cookies used for the outgoing request.
Method	`_merge_headers`	Merge a headers argument together with any headers on the client, to create the headers used for the outgoing request.
Method	`_merge_queryparams`	Merge a queryparams argument together with any queryparams on the client, to create the queryparams used for the outgoing request.
Method	`_merge_url`	Merge a URL argument together with any 'base_url' on the client, to create the URL used for the outgoing request.
Method	`_redirect_headers`	Return the headers that should be used for the redirect request.
Method	`_redirect_method`	When being redirected we may want to change the method of the request based on certain specs or browser behavior.
Method	`_redirect_stream`	Return the body that should be used for the redirect request.
Method	`_redirect_url`	Return the URL for the redirect to follow.
Instance Variable	`_auth`	Undocumented
Instance Variable	`_base_url`	Undocumented
Instance Variable	`_cookies`	Undocumented
Instance Variable	`_event_hooks`	Undocumented
Instance Variable	`_headers`	Undocumented
Instance Variable	`_netrc`	Undocumented
Instance Variable	`_params`	Undocumented
Instance Variable	`_state`	Undocumented
Instance Variable	`_timeout`	Undocumented
Instance Variable	`_trust_env`	Undocumented

def __init__(self, *, auth=None, params=None, headers=None, cookies=None, timeout=DEFAULT_TIMEOUT_CONFIG, follow_redirects=False, max_redirects=DEFAULT_MAX_REDIRECTS, event_hooks=None, base_url='', trust_env=True):

overridden in httpx.AsyncClient, httpx.Client

Undocumented

Parameters
auth:`AuthTypes`	Undocumented
params:`QueryParamTypes`	Undocumented
headers:`HeaderTypes`	Undocumented
cookies:`CookieTypes`	Undocumented
timeout:`TimeoutTypes`	Undocumented
follow_redirects:`bool`	Undocumented
max_redirects:`int`	Undocumented
event_hooks:`typing.Mapping[str, typing.List[typing.Callable]]`	Undocumented
base_url:`URLTypes`	Undocumented
trust_env:`bool`	Undocumented

@auth.setter
def auth(self, auth):

Undocumented

Parameters
auth:`AuthTypes`	Undocumented

@base_url.setter
def base_url(self, url):

Undocumented

Parameters
url:`URLTypes`	Undocumented

def build_request(self, method, url, *, content=None, data=None, files=None, json=None, params=None, headers=None, cookies=None, timeout=USE_CLIENT_DEFAULT, extensions=None):

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 [Authentication][0].

[0]: /quickstart/#authentication

@property
base_url: URL =

Base URL to use when sending requests with relative URLs.

@property
cookies: Cookies =

Cookie values to include when sending requests.

@property
event_hooks: typing.Dict[str, typing.List[typing.Callable]] =

Undocumented

@property
headers: Headers =

HTTP headers to include when sending requests.

@property
is_closed: bool =

Check if the client being closed

@property
params: QueryParams =

Query parameters to include in the URL when sending requests.

@property
timeout: Timeout =

Undocumented

@property
trust_env: bool =

Undocumented

def _build_auth(self, auth):

Undocumented

Parameters
auth:`AuthTypes`	Undocumented
Returns
`typing.Optional[Auth]`	Undocumented

def _build_redirect_request(self, request, response):

Given a request and a redirect response, return a new request that should be used to effect the redirect.

Parameters
request:`Request`	Undocumented
response:`Response`	Undocumented
Returns
`Request`	Undocumented

def _build_request_auth(self, request, auth=USE_CLIENT_DEFAULT):

Undocumented

Parameters
request:`Request`	Undocumented
auth:`typing.Union[AuthTypes, UseClientDefault]`	Undocumented
Returns
`Auth`	Undocumented

def _enforce_trailing_slash(self, url):

Undocumented

Parameters
url:`URL`	Undocumented
Returns
`URL`	Undocumented

def _get_proxy_map(self, proxies, allow_env_proxies):

Undocumented

Parameters
proxies:`typing.Optional[ProxiesTypes]`	Undocumented
allow_env_proxies:`bool`	Undocumented
Returns
`typing.Dict[str, typing.Optional[Proxy]]`	Undocumented

def _merge_cookies(self, cookies=None):

Merge a cookies argument together with any cookies on the client, to create the cookies used for the outgoing request.

Parameters
cookies:`CookieTypes`	Undocumented
Returns
`typing.Optional[CookieTypes]`	Undocumented

def _merge_headers(self, headers=None):

Merge a headers argument together with any headers on the client, to create the headers used for the outgoing request.

Parameters
headers:`HeaderTypes`	Undocumented
Returns
`typing.Optional[HeaderTypes]`	Undocumented

def _merge_queryparams(self, params=None):

Merge a queryparams argument together with any queryparams on the client, to create the queryparams used for the outgoing request.

Parameters
params:`QueryParamTypes`	Undocumented
Returns
`typing.Optional[QueryParamTypes]`	Undocumented

def _merge_url(self, url):

Merge a URL argument together with any 'base_url' on the client, to create the URL used for the outgoing request.

Parameters
url:`URLTypes`	Undocumented
Returns
`URL`	Undocumented

def _redirect_headers(self, request, url, method):

Return the headers that should be used for the redirect request.

Parameters
request:`Request`	Undocumented
url:`URL`	Undocumented
method:`str`	Undocumented
Returns
`Headers`	Undocumented

def _redirect_method(self, request, response):

When being redirected we may want to change the method of the request based on certain specs or browser behavior.

Parameters
request:`Request`	Undocumented
response:`Response`	Undocumented
Returns
`str`	Undocumented

def _redirect_stream(self, request, method):

Return the body that should be used for the redirect request.

Parameters
request:`Request`	Undocumented
method:`str`	Undocumented
Returns
`typing.Optional[typing.Union[SyncByteStream, AsyncByteStream]]`	Undocumented

def _redirect_url(self, request, response):

Return the URL for the redirect to follow.

Parameters
request:`Request`	Undocumented
response:`Response`	Undocumented
Returns
`URL`	Undocumented

_auth =

Undocumented

_base_url =

Undocumented

_cookies =

Undocumented

_event_hooks =

Undocumented

_headers =

Undocumented

_netrc =

Undocumented

_params =

Undocumented

_state =

overridden in httpx.AsyncClient, httpx.Client

Undocumented

_timeout =

Undocumented

_trust_env =

Undocumented

Parameters
event_hooks:`typing.Dict[str, typing.List[typing.Callable]]`	Undocumented