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.
- 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