Httpx

Changed

* The logging behaviour has been changed 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/httpcore648)
* 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)

Fixed

* Version 0.23.2 accidentally included stricter type checking on query parameters. This shouldn've have been included in a minor version bump, and is now reverted. (2523, 2539)

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)

**Note**: The 0.23.1 release should have used a proper version bump, rather than a minor point release.
There are API surface area changes that may affect some users.
See the "Removed" section of these release notes for details.

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

* Upload files *must* always be opened in binary mode. (2400)
* Drop `.read`/`.aread` from `SyncByteStream`/`AsyncByteStream`. (2407)
* Drop `RawURL`. (2241)

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](https://www.python-httpx.org/advanced/#character-set-encodings-and-auto-detection). (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)

Added

* Support for [the SOCKS5 proxy protocol](https://www.python-httpx.org/advanced/#socks) via [the `socksio` package](https://github.com/sethmlarson/socksio). (#2034)
* Support for custom headers in multipart/form-data requests (1936)

Fixed

* Don't perform unreliable close/warning on `__del__` with unclosed clients. (2026)
* Fix `Headers.update(...)` to correctly handle repeated headers (2038)