httpx._utils

module documentation

Undocumented

Class	`Logger`	Undocumented
Class	`NetRCInfo`	Undocumented
Class	`Timer`	Undocumented
Class	`URLPattern`	A utility class currently used for making lookups against proxy keys...
Function	`format_form_param`	Encode a name/value pair within a multipart form.
Function	`get_ca_bundle_from_env`	Undocumented
Function	`get_environment_proxies`	Gets proxy information from the environment
Function	`get_logger`	Get a `logging.Logger` instance, and optionally set up debug logging based on the HTTPX_LOG_LEVEL environment variable.
Function	`guess_content_type`	Undocumented
Function	`guess_json_utf`	Undocumented
Function	`is_known_encoding`	Return `True` if `encoding` is a known codec.
Function	`normalize_header_key`	Coerce str/bytes into a strictly byte-wise HTTP header key.
Function	`normalize_header_value`	Coerce str/bytes into a strictly byte-wise HTTP header value.
Function	`obfuscate_sensitive_headers`	Undocumented
Function	`parse_header_links`	No summary
Function	`peek_filelike_length`	Given a file-like stream object, return its length in number of bytes without reading it into memory.
Function	`port_or_default`	Undocumented
Function	`primitive_value_to_str`	Coerce a primitive data type into a string value.
Function	`same_origin`	Return 'True' if the given URLs share the same origin.
Function	`to_bytes`	Undocumented
Function	`to_bytes_or_str`	Undocumented
Function	`to_str`	Undocumented
Function	`unquote`	Undocumented
Constant	`SENSITIVE_HEADERS`	Undocumented
Constant	`TRACE_LOG_LEVEL`	Undocumented
Constant	`_HTML5_FORM_ENCODING_RE`	Undocumented
Constant	`_HTML5_FORM_ENCODING_REPLACEMENTS`	Undocumented
Constant	`_LOGGER_INITIALIZED`	Undocumented
Variable	`_null`	Undocumented
Variable	`_null2`	Undocumented
Variable	`_null3`	Undocumented

def format_form_param(name, value):

Encode a name/value pair within a multipart form.

Parameters
name:`str`	Undocumented
value:`typing.Union[str, bytes]`	Undocumented
Returns
`bytes`	Undocumented

def get_ca_bundle_from_env():

Undocumented

Returns
`typing.Optional[str]`	Undocumented

def get_environment_proxies():

Gets proxy information from the environment

Returns
`typing.Dict[str, typing.Optional[str]]`	Undocumented

def get_logger(name):

Get a logging.Logger instance, and optionally set up debug logging based on the HTTPX_LOG_LEVEL environment variable.

Parameters
name:`str`	Undocumented
Returns
`Logger`	Undocumented

def guess_content_type(filename):

Undocumented

Parameters
filename:`typing.Optional[str]`	Undocumented
Returns
`typing.Optional[str]`	Undocumented

def guess_json_utf(data):

Undocumented

Parameters
data:`bytes`	Undocumented
Returns
`typing.Optional[str]`	Undocumented

def is_known_encoding(encoding):

Return True if encoding is a known codec.

Parameters
encoding:`str`	Undocumented
Returns
`bool`	Undocumented

def normalize_header_key(value, lower, encoding=None):

Coerce str/bytes into a strictly byte-wise HTTP header key.

Parameters
value:`typing.Union[str, bytes]`	Undocumented
lower:`bool`	Undocumented
encoding:`str`	Undocumented
Returns
`bytes`	Undocumented

def normalize_header_value(value, encoding=None):

Coerce str/bytes into a strictly byte-wise HTTP header value.

Parameters
value:`typing.Union[str, bytes]`	Undocumented
encoding:`str`	Undocumented
Returns
`bytes`	Undocumented

def obfuscate_sensitive_headers(items):

Undocumented

Parameters
items:`typing.Iterable[typing.Tuple[typing.AnyStr, typing.AnyStr]]`	Undocumented
Returns
`typing.Iterator[typing.Tuple[typing.AnyStr, typing.AnyStr]]`	Undocumented

def parse_header_links(value):

Returns a list of parsed link headers, for more info see: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Link The generic syntax of those is: Link: < uri-reference >; param1=value1; param2="value2" So for instance: Link; '<http:/.../front.jpeg>; type="image/jpeg",<http://.../back.jpeg>;' would return

[

{"url": "http:/.../front.jpeg", "type": "image/jpeg"}, {"url": "http://.../back.jpeg"},

]

Parameters
value:`str`	HTTP Link entity-header field
Returns
`typing.List[typing.Dict[str, str]]`	list of parsed link headers

def peek_filelike_length(stream):

Given a file-like stream object, return its length in number of bytes without reading it into memory.

Parameters
stream:`typing.Any`	Undocumented
Returns
`typing.Optional[int]`	Undocumented

def port_or_default(url):

Undocumented

Parameters
url:`URL`	Undocumented
Returns
`typing.Optional[int]`	Undocumented

def primitive_value_to_str(value):

Coerce a primitive data type into a string value.

Note that we prefer JSON-style 'true'/'false' for boolean values here.

Parameters
value:`PrimitiveData`	Undocumented
Returns
`str`	Undocumented

def same_origin(url, other):

Return 'True' if the given URLs share the same origin.

Parameters
url:`URL`	Undocumented
other:`URL`	Undocumented
Returns
`bool`	Undocumented

def to_bytes(value, encoding='utf-8'):

Undocumented

Parameters
value:`typing.Union[str, bytes]`	Undocumented
encoding:`str`	Undocumented
Returns
`bytes`	Undocumented

def to_bytes_or_str(value, match_type_of):

Undocumented

Parameters
value:`str`	Undocumented
match_type_of:`typing.AnyStr`	Undocumented
Returns
`typing.AnyStr`	Undocumented

def to_str(value, encoding='utf-8'):

Undocumented

Parameters
value:`typing.Union[str, bytes]`	Undocumented
encoding:`str`	Undocumented
Returns
`str`	Undocumented

def unquote(value):

Undocumented

Parameters
value:`str`	Undocumented
Returns
`str`	Undocumented

SENSITIVE_HEADERS: set[str] =

Undocumented

Value

set(['authorization', 'proxy-authorization'])

TRACE_LOG_LEVEL: int =

Undocumented

Value

_HTML5_FORM_ENCODING_RE =

Undocumented

Value

re.compile("""|""".join([re.escape(c) for c in _HTML5_FORM_ENCODING_REPLACEMENTS↵
.keys()]))

_HTML5_FORM_ENCODING_REPLACEMENTS: dict[str, str] =

Undocumented

Value

{'"': '%22', '\\': '\\\\'}

_LOGGER_INITIALIZED: bool =

Undocumented

Value

False

_null: bytes =

Undocumented

_null2 =

Undocumented

_null3 =

Undocumented