| OLD | NEW |
| (Empty) |
| 1 # urllib3/exceptions.py | |
| 2 # Copyright 2008-2013 Andrey Petrov and contributors (see CONTRIBUTORS.txt) | |
| 3 # | |
| 4 # This module is part of urllib3 and is released under | |
| 5 # the MIT License: http://www.opensource.org/licenses/mit-license.php | |
| 6 | |
| 7 | |
| 8 ## Base Exceptions | |
| 9 | |
| 10 class HTTPError(Exception): | |
| 11 "Base exception used by this module." | |
| 12 pass | |
| 13 | |
| 14 | |
| 15 class PoolError(HTTPError): | |
| 16 "Base exception for errors caused within a pool." | |
| 17 def __init__(self, pool, message): | |
| 18 self.pool = pool | |
| 19 HTTPError.__init__(self, "%s: %s" % (pool, message)) | |
| 20 | |
| 21 def __reduce__(self): | |
| 22 # For pickling purposes. | |
| 23 return self.__class__, (None, None) | |
| 24 | |
| 25 | |
| 26 class RequestError(PoolError): | |
| 27 "Base exception for PoolErrors that have associated URLs." | |
| 28 def __init__(self, pool, url, message): | |
| 29 self.url = url | |
| 30 PoolError.__init__(self, pool, message) | |
| 31 | |
| 32 def __reduce__(self): | |
| 33 # For pickling purposes. | |
| 34 return self.__class__, (None, self.url, None) | |
| 35 | |
| 36 | |
| 37 class SSLError(HTTPError): | |
| 38 "Raised when SSL certificate fails in an HTTPS connection." | |
| 39 pass | |
| 40 | |
| 41 | |
| 42 class ProxyError(HTTPError): | |
| 43 "Raised when the connection to a proxy fails." | |
| 44 pass | |
| 45 | |
| 46 | |
| 47 class DecodeError(HTTPError): | |
| 48 "Raised when automatic decoding based on Content-Type fails." | |
| 49 pass | |
| 50 | |
| 51 | |
| 52 ## Leaf Exceptions | |
| 53 | |
| 54 class MaxRetryError(RequestError): | |
| 55 "Raised when the maximum number of retries is exceeded." | |
| 56 | |
| 57 def __init__(self, pool, url, reason=None): | |
| 58 self.reason = reason | |
| 59 | |
| 60 message = "Max retries exceeded with url: %s" % url | |
| 61 if reason: | |
| 62 message += " (Caused by %s: %s)" % (type(reason), reason) | |
| 63 else: | |
| 64 message += " (Caused by redirect)" | |
| 65 | |
| 66 RequestError.__init__(self, pool, url, message) | |
| 67 | |
| 68 | |
| 69 class HostChangedError(RequestError): | |
| 70 "Raised when an existing pool gets a request for a foreign host." | |
| 71 | |
| 72 def __init__(self, pool, url, retries=3): | |
| 73 message = "Tried to open a foreign host with url: %s" % url | |
| 74 RequestError.__init__(self, pool, url, message) | |
| 75 self.retries = retries | |
| 76 | |
| 77 | |
| 78 class TimeoutStateError(HTTPError): | |
| 79 """ Raised when passing an invalid state to a timeout """ | |
| 80 pass | |
| 81 | |
| 82 | |
| 83 class TimeoutError(HTTPError): | |
| 84 """ Raised when a socket timeout error occurs. | |
| 85 | |
| 86 Catching this error will catch both :exc:`ReadTimeoutErrors | |
| 87 <ReadTimeoutError>` and :exc:`ConnectTimeoutErrors <ConnectTimeoutError>`. | |
| 88 """ | |
| 89 pass | |
| 90 | |
| 91 | |
| 92 class ReadTimeoutError(TimeoutError, RequestError): | |
| 93 "Raised when a socket timeout occurs while receiving data from a server" | |
| 94 pass | |
| 95 | |
| 96 | |
| 97 # This timeout error does not have a URL attached and needs to inherit from the | |
| 98 # base HTTPError | |
| 99 class ConnectTimeoutError(TimeoutError): | |
| 100 "Raised when a socket timeout occurs while connecting to a server" | |
| 101 pass | |
| 102 | |
| 103 | |
| 104 class EmptyPoolError(PoolError): | |
| 105 "Raised when a pool runs out of connections and no more are allowed." | |
| 106 pass | |
| 107 | |
| 108 | |
| 109 class ClosedPoolError(PoolError): | |
| 110 "Raised when a request enters a pool after the pool has been closed." | |
| 111 pass | |
| 112 | |
| 113 | |
| 114 class LocationParseError(ValueError, HTTPError): | |
| 115 "Raised when get_host or similar fails to parse the URL input." | |
| 116 | |
| 117 def __init__(self, location): | |
| 118 message = "Failed to parse: %s" % location | |
| 119 HTTPError.__init__(self, message) | |
| 120 | |
| 121 self.location = location | |
| OLD | NEW |