httpx Updates & Release Notes

0.28.0 (28th November, 2024)

The 0.28 release includes a limited set of deprecations.

Deprecations

We are working towards a simplified SSL configuration API.

For users of the standard verify=True or verify=False cases, or verify=<ssl_context> case this should require no changes. The following cases have been deprecated...

The verify argument as a string argument is now deprecated and will raise warnings.

The cert argument is now deprecated and will raise warnings.

Our revised SSL documentation covers how to implement the same behaviour with a more constrained API.

The following changes are also included:

The deprecated proxies argument has now been removed.

The deprecated app argument has now been removed.

• JSON request bodies use a compact representation. (#3363)
• Review URL percent escape sets, based on WHATWG spec. (#3371, #3373)
• Ensure certifi and httpcore are only imported if required. (#3377)
• Treat socks5h as a valid proxy scheme. (#3178)
• Cleanup Request() method signature in line with client.request() and httpx.request(). (#3378)
• Bugfix: When passing params={}, always strictly update rather than merge with an existing querystring. (#3364)

0.26.0 (20th December, 2023)

Added

The proxy argument was added. You should use the proxy argument instead of the deprecated proxies, or use mounts= for more complex configurations. (#2879)

Deprecated

The proxies argument is now deprecated. It will still continue to work, but it will be removed in the future. (#2879)

Fixed

Fix cases of double escaping of URL path components. Allow / as a safe character in the query portion. (#2990)

Handle NO_PROXY envvar cases when a fully qualified URL is supplied as the value. (#2741)

Allow URLs where username or password contains unescaped '@'. (#2986)

Ensure ASGI raw_path does not include URL query component. (#2999)

Ensure Response.iter_text() cannot yield empty strings. (#2998)

0.25.0 (11th Sep, 2023)

Removed

• Drop support for Python 3.7. (#2813)

Added

• Support HTTPS proxies. (#2845)
• Change the type of Extensions from Mapping[Str, Any] to MutableMapping[Str, Any]. (#2803)
• Add socket_options argument to httpx.HTTPTransport and httpx.AsyncHTTPTransport classes. (#2716)
• The Response.raise_for_status() method now returns the response instance. For example: data = httpx.get('...').raise_for_status().json(). (#2776)

Fixed

• Return 500 error response instead of exceptions when raise_app_exceptions=False is set on ASGITransport. (#2669)
• Ensure all WSGITransport environs have a SERVER_PROTOCOL. (#2708)
• Always encode forward slashes as %2F in query parameters (#2723)
• Use Mozilla documentation instead of httpstatuses.com for HTTP error reference (#2768)

0.24.1 (17th May, 2023)

Added

Provide additional context in some InvalidURL exceptions. (#2675)

Fixed

Fix optional percent-encoding behaviour. (#2671)

More robust checking for opening upload files in binary mode. (#2630)

Properly support IP addresses in NO_PROXY environment variable. (#2659)

Set default file for NetRCAuth() to None to use the stdlib default. (#2667)

Set logging request lines to INFO level for async requests, in line with sync requests. (#2656)

Fix which gen-delims need to be escaped for path/query/fragment components in URL. (#2701)