urllib.error — Классы исключений, генерируемые urllib.request

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

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

Следующие исключения генерируются urllib.error при необходимости:

exception urllib.error.URLError

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

reason

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

Изменено в версии 3.3: URLError раньше был подтипом IOError, который сейчас является псевдонимом OSError.

exception urllib.error.HTTPError(url, code, msg, hdrs, fp)

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

url

Содержит URL запроса. Псевдоним атрибута filename.

code

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

reason

Обычно это строка, объясняющая причину ошибки. Псевдоним атрибута msg.

headers

HTTP-заголовки ответа для HTTP-запроса, который вызвал HTTPError. Псевдоним атрибута hdrs.

Добавлен в версии 3.4.

fp

Объект, похожий на файл, из которого можно считать тело HTTP-ошибки.

exception urllib.error.ContentTooShortError(msg, content)

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

content

Загруженные (и предположительно усечённые) данные.