Version 0.28.0

[tomchristie]

Hey team. 👋🏼

Alrighty we've got ourselves a release here. I think this strikes the right balance between pushing forwards towards an improved and simplified 1.0 release while minimising disruption in getting there.

---

0.28.0 (15th November, 2024)

The 0.28 release includes a limited set of backwards incompatible changes.

Backwards incompatible changes:

SSL configuration has been significantly simplified.

• The verify argument no longer accepts string arguments.
• The cert argument has now been removed.
• The SSL_CERT_FILE and SSL_CERT_DIR environment variables are no longer automatically used.

For users of the standard verify=True or verify=False cases this should require no changes.

For information on configuring more complex SSL cases, please see the SSL documentation.

The following changes are also included:

• The undocumented URL.raw property has now been deprecated, and will raise warnings.
• The deprecated proxies argument has now been removed.
• The deprecated app argument has now been removed.
• Ensure JSON request bodies are compact. (Ensure JSON representation is compact. #3363)
• Review URL percent escape sets, based on WHATWG spec. (Review URL percent escaping sets, from whatwg. #3371, Review urlescape percent-safe set, and use + behavior for form spaces. #3373)
• Ensure certifi and httpcore are only imported if required. (made dependencies on certifi and httpcore only load when required #3377)
• Treat socks5h as a valid proxy scheme. (add socks5h proxy support #3178)
• Cleanup Request() method signature in line with client.request() and httpx.request(). (Cleanup Request method parameter. #3378)