Документация Python неофициальный перевод

21.9. urllib.error – Классы исключений, генерируемые urllib.requesturllib.error – Exception classes raised by urllib.request

Исходный код: Lib/urllib/error.py


Модуль urllib.error определяет классы исключений для исключений, вызываемых urllib.request. Базовым классом исключений является URLError.

Следующие исключения вызываются urllib.error в соответствующих случаях:

exception urllib.error.URLError

Обработчики вызывают это исключение (или производные от него), когда сталкиваются с проблемой. Оно является подклассом OSError.

reason

Причина этой ошибки. Это может быть строка сообщения или другой экземпляр исключения.

Изменено в версии 3.3: URLError стал подклассом OSError вместо IOError.

exception urllib.error.HTTPError

Хотя HTTPError и является исключением (подклассом URLError), он также может выступать в роли неисключительного файлоподобного возвращаемого значения (аналогично тому, что возвращает urlopen()). Это полезно при обработке необычных HTTP-ошибок, например, запросов аутентификации.

code

Код состояния HTTP, определённый в RFC 2616. Это числовое значение соответствует значению из словаря кодов, который находится в http.server.BaseHTTPRequestHandler.responses.

reason

Обычно это строка, поясняющая причину этой ошибки.

headers

Заголовки HTTP-ответа для HTTP-запроса, вызвавшего HTTPError.

Новое в версии 3.4.

exception urllib.error.ContentTooShortError(msg, content)

Это исключение возбуждается, когда функция urlretrieve() обнаруживает, что количество загруженных данных меньше ожидаемого (заданного заголовком Content-Length). Атрибут content хранит загруженные (и предположительно усечённые) данные.