Install & Compatibility
Where this runs
tested against v1.4.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 17.8MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 1.7s · import 0.000s · 18MB
16MB installed
● package 16MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
InsecurePlatformWarning
✓ from requestsexceptions import InsecurePlatformWarning
✗ from requestsexceptions import ConnectionError
InsecureRequestWarning
✓ from requestsexceptions import InsecureRequestWarning
squelch_warnings
✓ from requestsexceptions import squelch_warnings
This quickstart demonstrates how to use `requestsexceptions` to catch various network and HTTP-related errors when making requests using the 'requests' library. It covers `ConnectionError`, `Timeout`, `HTTPError`, and the general `RequestException`.
import requests
from requestsexceptions import ConnectionError, Timeout, HTTPError, RequestException
def fetch_url(url):
try:
response = requests.get(url, timeout=1)
response.raise_for_status() # Raises HTTPError for bad responses (4xx or 5xx)
print(f"Successfully fetched {url}, status: {response.status_code}")
except ConnectionError:
print(f"Connection error occurred for {url}.")
except Timeout:
print(f"Request timed out for {url}.")
except HTTPError as e:
print(f"HTTP error for {url}: {e.response.status_code}")
except RequestException as e:
print(f"An unexpected Requests error occurred for {url}: {e}")
except Exception as e:
print(f"An non-Requests error occurred for {url}: {e}")
fetch_url('https://httpbin.org/status/200')
fetch_url('https://httpbin.org/status/404')
fetch_url('http://nonexistent.domain.xyz')
fetch_url('https://httpbin.org/delay/5')
Debug
Known issues
deprecatedThe `requestsexceptions` library was last updated in February 2018 (version 1.4.0). The 'requests' library has undergone significant development since then, including standardizing its internal exception handling (e.g., `requests.exceptions.JSONDecodeError` was introduced in `requests` 2.27.0).fixFor new projects or when using modern `requests` versions (2.27.0+), it is generally recommended to directly import exceptions from `requests.exceptions` (e.g., `from requests.exceptions import ConnectionError`), as `requests`' own exception module is now quite stable. Evaluate if `requestsexceptions` is truly necessary for your specific `requests` version and environment.
affects: All versions of `requestsexceptions` (1.x)
gotchaThe primary problem `requestsexceptions` solves is the potential inconsistency in exception paths due to 'requests' bundling/unbundling `urllib3`. For many common use cases, especially with recent and stable 'requests' installations, directly importing from `requests.exceptions` is robust enough and may not require this extra abstraction.fixBefore integrating `requestsexceptions`, test direct imports from `requests.exceptions` in your target environment. If `requests.exceptions.ConnectionError` (and other specific exceptions you need) resolves correctly and behaves as expected, `requestsexceptions` might be an unnecessary dependency.
affects: All versions of `requestsexceptions` (1.x)
gotchaThe library's long-term maintenance status is unclear, with its official GitHub being a mirror of opendev.org. No recent commits or releases indicate active development to keep pace with 'requests' library changes.fixConsider the potential risks of relying on an unmaintained library. For critical applications, prefer the native `requests.exceptions` or a more actively maintained solution if `requests.exceptions` proves insufficient in very specific, legacy, or highly customized environments.
affects: All versions of `requestsexceptions` (1.x)
Upgrade
Version history
1.4.0latest on PyPI · released Feb 1, 2018
Audit
Dependencies
requestsrequiredThis library is designed to work with the 'requests' library's exceptions. 'requests' is a de-facto dependency for its usage.