Exceptions

Custom exceptions defined by urllib3

exception urllib3.exceptions.ClosedPoolError(pool, message)

Raised when a request enters a pool after the pool has been closed.

exception urllib3.exceptions.ConnectTimeoutError

Raised when a socket timeout occurs while connecting to a server

urllib3.exceptions.ConnectionError

Renamed to ProtocolError but aliased for backwards compatibility.

alias of ProtocolError

exception urllib3.exceptions.DecodeError

Raised when automatic decoding based on Content-Type fails.

exception urllib3.exceptions.EmptyPoolError(pool, message)

Raised when a pool runs out of connections and no more are allowed.

exception urllib3.exceptions.HTTPError

Base exception used by this module.

exception urllib3.exceptions.HTTPWarning

Base warning used by this module.

exception urllib3.exceptions.HostChangedError(pool, url, retries=3)

Raised when an existing pool gets a request for a foreign host.

exception urllib3.exceptions.InsecureRequestWarning

Warned when making an unverified HTTPS request.

exception urllib3.exceptions.LocationParseError(location)

Raised when get_host or similar fails to parse the URL input.

exception urllib3.exceptions.LocationValueError

Raised when there is something wrong with a given URL input.

exception urllib3.exceptions.MaxRetryError(pool, url, reason=None)

Raised when the maximum number of retries is exceeded.

exception urllib3.exceptions.PoolError(pool, message)

Base exception for errors caused within a pool.

exception urllib3.exceptions.ProtocolError

Raised when something unexpected happens mid-request/response.

exception urllib3.exceptions.ProxyError

Raised when the connection to a proxy fails.

exception urllib3.exceptions.ReadTimeoutError(pool, url, message)

Raised when a socket timeout occurs while receiving data from a server

exception urllib3.exceptions.RequestError(pool, url, message)

Base exception for PoolErrors that have associated URLs.

exception urllib3.exceptions.SSLError

Raised when SSL certificate fails in an HTTPS connection.

exception urllib3.exceptions.TimeoutError

Raised when a socket timeout error occurs.

Catching this error will catch both ReadTimeoutErrors and ConnectTimeoutErrors.

exception urllib3.exceptions.TimeoutStateError

Raised when passing an invalid state to a timeout