From e51cf6274b70afc92d00dbc1167f24b06ab1b4b4 Mon Sep 17 00:00:00 2001 From: Glen Keane Date: Tue, 2 Sep 2025 11:22:20 +0100 Subject: [PATCH] Update compatibility.md with documentation of exceptions differences --- docs/compatibility.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/compatibility.md b/docs/compatibility.md index 52e9389a79..9686167574 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/).