HTTPX 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)

0.24.0 (6th April, 2023)

Changed

• The logging behaviour has been change to be more in-line with other standard Python logging usages. We no longer have a custom TRACE log level, and we no longer use the HTTPX_LOG_LEVEL environment variable to auto-configure logging. We now have a significant amount of DEBUG logging available at the network level. Full documentation is available at https://www.python-httpx.org/logging/ (#2547, encode/httpcore#648)
• The Response.iter_lines() method now matches the stdlib behaviour and does not include the newline characters. It also resolves a performance issue. (#2423)
• Query parameter encoding switches from using + for spaces and %2F for forward slash, to instead using %20 for spaces and treating forward slash as a safe, unescaped character. This differs from requests, but is in line with browser behavior in Chrome, Safari, and Firefox. Both options are RFC valid. (#2543)
• NetRC authentication is no longer automatically handled, but is instead supported by an explicit httpx.NetRCAuth() authentication class. See the documentation at https://www.python-httpx.org/advanced/#netrc-support (#2525)

Removed

• The rfc3986 dependancy has been removed. (#2252)

0.23.2 (2nd Jan, 2023)

Added

• Support digest auth nonce counting to avoid multiple auth requests. (#2463)

Fixed

• Multipart file uploads where the file length cannot be determine now use chunked transfer encoding, rather than loading the entire file into memory in order to determine the Content-Length. (#2382)
• Raise TypeError if content is passed a dict-instance. (#2495)
• Partially revert the API breaking change in 0.23.1, which removed RawURL. We continue to expose a url.raw property which is now a plain named-tuple. This API is still expected to be deprecated, but we will do so with a major version bump. (#2481)

0.23.1

Added

• Support for Python 3.11. (#2420)
• Allow setting an explicit multipart boundary in Content-Type header. (#2278)
• Allow tuple or list for multipart values, not just list. (#2355)
• Allow str content for multipart upload files. (#2400)
• Support connection upgrades. See https://www.encode.io/httpcore/extensions/#upgrade-requests

Fixed

• Don't drop empty query parameters. (#2354)

Removed

• Drop .read/.aread from SyncByteStream/AsyncByteStream (#2407)
• Drop RawURL. (#2241)

0.23.0 (23rd May, 2022)

Changed

• Drop support for Python 3.6. (#2097)
• Use utf-8 as the default character set, instead of falling back to charset-normalizer for auto-detection. To enable automatic character set detection, see the documentation. (#2165)

Fixed

• Fix URL.copy_with for some oddly formed URL cases. (#2185)
• Digest authentication should use case-insensitive comparison for determining which algorithm is being used. (#2204)
• Fix console markup escaping in command line client. (#1866)
• When files are used in multipart upload, ensure we always seek to the start of the file. (#2065)
• Ensure that iter_bytes never yields zero-length chunks. (#2068)
• Preserve Authorization header for redirects that are to the same origin, but are an http-to-https upgrade. (#2074)
• When responses have binary output, don't print the output to the console in the command line client. Use output like <16086 bytes of binary data> instead. (#2076)
• Fix display of --proxies argument in the command line client help. (#2125)
• Close responses when task cancellations occur during stream reading. (#2156)
• Fix type error on accessing .request on HTTPError exceptions. (#2158)

0.21.0 (15th November, 2021)

The 0.21.0 release integrates against a newly redesigned httpcore backend.

Both packages ought to automatically update to the required versions, but if you are seeing any issues, you should ensure that you have httpx==0.21.* and httpcore==0.14.* installed.

Added

• The command-line client will now display connection information when -v/--verbose is used.
• The command-line client will now display server certificate information when -v/--verbose is used.
• The command-line client is now able to properly detect if the outgoing request should be formatted as HTTP/1.1 or HTTP/2, based on the result of the HTTP/2 negotiation.