Exceptions¶
-
exception
urllib3.exceptions.
BodyNotHttplibCompatible
¶ Bases:
urllib3.exceptions.HTTPError
Body should be
http.client.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 forpartial
to avoid creating large objects on streamed reads.
-
exception
urllib3.exceptions.
InsecurePlatformWarning
¶ Bases:
urllib3.exceptions.SecurityWarning
Warned when certain TLS/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.
InvalidChunkLength
(response, length)¶ Bases:
urllib3.exceptions.HTTPError
,http.client.IncompleteRead
Invalid chunk length in a chunked response.
-
exception
urllib3.exceptions.
InvalidHeader
¶ Bases:
urllib3.exceptions.HTTPError
The header provided was somehow invalid.
-
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
,urllib3.exceptions.URLSchemeUnknown
ProxyManager does not support the supplied scheme
-
exception
urllib3.exceptions.
ProxySchemeUnsupported
¶ Bases:
ValueError
Fetching HTTPS resources through HTTPS proxies is unsupported
-
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.
URLSchemeUnknown
(scheme)¶ Bases:
urllib3.exceptions.LocationValueError
Raised when a URL input has an unsupported scheme.
-
exception
urllib3.exceptions.
UnrewindableBodyError
¶ Bases:
urllib3.exceptions.HTTPError
urllib3 encountered an error when trying to rewind a body