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

Bases: Exception

Base exception used by this module.

exception urllib3.exceptions.HTTPWarning

Bases: Warning

Base warning used by this module.

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 pool

  • url (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 and ConnectTimeoutErrors.

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