From: Glen Keane Date: Fri, 5 Sep 2025 14:19:37 +0000 (+0100) Subject: Update compatibility.md with documentation of exceptions differences (#3649) X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=bc00d2bd9f715b3b848925e0c259887409bceabc;p=thirdparty%2Fhttpx.git Update compatibility.md with documentation of exceptions differences (#3649) Co-authored-by: Kim Christie --- diff --git a/docs/compatibility.md b/docs/compatibility.md index 52e9389a..96861675 100644 --- a/docs/compatibility.md +++ b/docs/compatibility.md @@ -226,3 +226,7 @@ For both query params (`params=`) and form data (`data=`), `requests` supports s In HTTPX, event hooks may access properties of requests and responses, but event hook callbacks cannot mutate the original request/response. If you are looking for more control, consider checking out [Custom Transports](advanced/transports.md#custom-transports). + +## Exceptions and Errors + +`requests` exception hierarchy is slightly different to the `httpx` exception hierarchy. `requests` exposes a top level `RequestException`, where as `httpx` exposes a top level `HTTPError`. see the exceptions exposes in requests [here](https://requests.readthedocs.io/en/latest/_modules/requests/exceptions/). See the `httpx` error hierarchy [here](https://www.python-httpx.org/exceptions/).