Exceptions¶
-
exception
urllib3.exceptions.
BodyNotHttplibCompatible
¶ Bases:
urllib3.exceptions.HTTPError
Body should be httplib.HTTPResponse like (have an fp attribute which returns raw chunks) for read_chunked().
-
exception
urllib3.exceptions.
ClosedPoolError
(pool, message)¶ Bases:
urllib3.exceptions.PoolError
Raised when a request enters a pool after the pool has been closed.
-
exception
urllib3.exceptions.
ConnectTimeoutError
¶ Bases:
urllib3.exceptions.TimeoutError
Raised when a socket timeout occurs while connecting to a server
-
urllib3.exceptions.
ConnectionError
¶ Renamed to ProtocolError but aliased for backwards compatibility.
alias of
urllib3.exceptions.ProtocolError
-
exception
urllib3.exceptions.
DecodeError
¶ Bases:
urllib3.exceptions.HTTPError
Raised when automatic decoding based on Content-Type fails.
-
exception
urllib3.exceptions.
DependencyWarning
¶ Bases:
urllib3.exceptions.HTTPWarning
Warned when an attempt is made to import a module with missing optional dependencies.
-
exception
urllib3.exceptions.
EmptyPoolError
(pool, message)¶ Bases:
urllib3.exceptions.PoolError
Raised when a pool runs out of connections and no more are allowed.
-
exception
urllib3.exceptions.
HeaderParsingError
(defects, unparsed_data)¶ Bases:
urllib3.exceptions.HTTPError
Raised by assert_header_parsing, but we convert it to a log.warning statement.
-
exception
urllib3.exceptions.
HostChangedError
(pool, url, retries=3)¶ Bases:
urllib3.exceptions.RequestError
Raised when an existing pool gets a request for a foreign host.
-
exception
urllib3.exceptions.
IncompleteRead
(partial, expected)¶ Bases:
urllib3.exceptions.HTTPError
,http.client.IncompleteRead
Response length doesn’t match expected Content-Length
Subclass of http_client.IncompleteRead to allow int value for partial to avoid creating large objects on streamed reads.
-
exception
urllib3.exceptions.
InsecurePlatformWarning
¶ Bases:
urllib3.exceptions.SecurityWarning
Warned when certain SSL configuration is not available on a platform.
-
exception
urllib3.exceptions.
InsecureRequestWarning
¶ Bases:
urllib3.exceptions.SecurityWarning
Warned when making an unverified HTTPS request.
-
exception
urllib3.exceptions.
InvalidHeader
¶ Bases:
urllib3.exceptions.HTTPError
The header provided was somehow invalid.
-
exception
urllib3.exceptions.
InvalidProxyConfigurationWarning
¶ Bases:
urllib3.exceptions.HTTPWarning
Warned when using an HTTPS proxy and an HTTPS URL. Currently urllib3 doesn’t support HTTPS proxies and the proxy will be contacted via HTTP instead. This warning can be fixed by changing your HTTPS proxy URL into an HTTP proxy URL.
If you encounter this warning read this: https://github.com/urllib3/urllib3/issues/1850
-
exception
urllib3.exceptions.
LocationParseError
(location)¶ Bases:
urllib3.exceptions.LocationValueError
Raised when get_host or similar fails to parse the URL input.
-
exception
urllib3.exceptions.
LocationValueError
¶ Bases:
ValueError
,urllib3.exceptions.HTTPError
Raised when there is something wrong with a given URL input.
-
exception
urllib3.exceptions.
MaxRetryError
(pool, url, reason=None)¶ Bases:
urllib3.exceptions.RequestError
Raised when the maximum number of retries is exceeded.
- Parameters
pool (
HTTPConnectionPool
) – The connection poolurl (string) – The requested Url
reason (exceptions.Exception) – The underlying error
-
exception
urllib3.exceptions.
NewConnectionError
(pool, message)¶ Bases:
urllib3.exceptions.ConnectTimeoutError
,urllib3.exceptions.PoolError
Raised when we fail to establish a new connection. Usually ECONNREFUSED.
-
exception
urllib3.exceptions.
PoolError
(pool, message)¶ Bases:
urllib3.exceptions.HTTPError
Base exception for errors caused within a pool.
-
exception
urllib3.exceptions.
ProtocolError
¶ Bases:
urllib3.exceptions.HTTPError
Raised when something unexpected happens mid-request/response.
-
exception
urllib3.exceptions.
ProxyError
(message, error, *args)¶ Bases:
urllib3.exceptions.HTTPError
Raised when the connection to a proxy fails.
-
exception
urllib3.exceptions.
ProxySchemeUnknown
(scheme)¶ Bases:
AssertionError
,ValueError
ProxyManager does not support the supplied scheme
-
exception
urllib3.exceptions.
ReadTimeoutError
(pool, url, message)¶ Bases:
urllib3.exceptions.TimeoutError
,urllib3.exceptions.RequestError
Raised when a socket timeout occurs while receiving data from a server
-
exception
urllib3.exceptions.
RequestError
(pool, url, message)¶ Bases:
urllib3.exceptions.PoolError
Base exception for PoolErrors that have associated URLs.
-
exception
urllib3.exceptions.
ResponseError
¶ Bases:
urllib3.exceptions.HTTPError
Used as a container for an error reason supplied in a MaxRetryError.
-
GENERIC_ERROR
= 'too many error responses'¶
-
SPECIFIC_ERROR
= 'too many {status_code} error responses'¶
-
-
exception
urllib3.exceptions.
ResponseNotChunked
¶ Bases:
urllib3.exceptions.ProtocolError
,ValueError
Response needs to be chunked in order to read it as chunks.
-
exception
urllib3.exceptions.
SNIMissingWarning
¶ Bases:
urllib3.exceptions.HTTPWarning
Warned when making a HTTPS request without SNI available.
-
exception
urllib3.exceptions.
SSLError
¶ Bases:
urllib3.exceptions.HTTPError
Raised when SSL certificate fails in an HTTPS connection.
-
exception
urllib3.exceptions.
SecurityWarning
¶ Bases:
urllib3.exceptions.HTTPWarning
Warned when performing security reducing actions
-
exception
urllib3.exceptions.
SubjectAltNameWarning
¶ Bases:
urllib3.exceptions.SecurityWarning
Warned when connecting to a host with a certificate missing a SAN.
-
exception
urllib3.exceptions.
SystemTimeWarning
¶ Bases:
urllib3.exceptions.SecurityWarning
Warned when system time is suspected to be wrong
-
exception
urllib3.exceptions.
TimeoutError
¶ Bases:
urllib3.exceptions.HTTPError
Raised when a socket timeout error occurs.
Catching this error will catch both
ReadTimeoutErrors
andConnectTimeoutErrors
.
-
exception
urllib3.exceptions.
TimeoutStateError
¶ Bases:
urllib3.exceptions.HTTPError
Raised when passing an invalid state to a timeout
-
exception
urllib3.exceptions.
UnrewindableBodyError
¶ Bases:
urllib3.exceptions.HTTPError
urllib3 encountered an error when trying to rewind a body