`urllib.request.md`

895 строк · 98.9 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.5/library/urllib.request.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 21.6. [`urllib.request`](https://python-all.ru/3.5/library/urllib.request.html#module-urllib.request) – расширяемая библиотека для открытия URL89**Исходный код:** [Lib/urllib/request.py](https://python-all.ru/src/3.5/Lib/urllib/request.py)1011---1213Модуль [`urllib.request`](https://python-all.ru/3.5/library/urllib.request.html#module-urllib.request) определяет функции и классы, которые помогают открывать URL (в основном HTTP) в сложном мире – базовая и дайджест-аутентификация, перенаправления, куки и многое другое.1415> **См. также**16>17> Для высокоуровневого интерфейса HTTP-клиента рекомендуется [пакет Requests](https://python-all.ru/3.5/library/urllib.request.html).1819Модуль [`urllib.request`](https://python-all.ru/3.5/library/urllib.request.html#module-urllib.request) определяет следующие функции:2021#### `urllib.request.urlopen(url, data=None, [timeout, ]*, cafile=None, capath=None, cadefault=False, context=None)`2223Открывает URL *url*, который может быть строкой или объектом [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request).2425*data* должен быть объектом bytes, задающим дополнительные данные для отправки на сервер, или `None`, если такие данные не нужны. *data* также может быть итерируемым объектом, и в этом случае значение Content-Length должно быть указано в заголовках. В настоящее время только HTTP-запросы используют *data*; при передаче параметра *data* HTTP-запрос будет POST вместо GET.2627*data* должен быть буфером в стандартном формате *application/x-www-form-urlencoded*. Функция [`urllib.parse.urlencode()`](https://python-all.ru/3.5/library/urllib.parse.html#urllib.parse.urlencode) принимает отображение или последовательность 2-кортежей и возвращает строку ASCII-текста в этом формате. Её следует закодировать в bytes перед использованием в качестве параметра *data*.2829Модуль urllib.request использует HTTP/1.1 и включает заголовок `Connection:close` в свои HTTP-запросы.3031Необязательный параметр *timeout* задает таймаут в секундах для блокирующих операций, таких как попытка подключения (если не указан, используется глобальная настройка таймаута по умолчанию). Это на самом деле работает только для HTTP, HTTPS и FTP-соединений.3233Если указан *context*, он должен быть экземпляром [`ssl.SSLContext`](https://python-all.ru/3.5/library/ssl.html#ssl.SSLContext), описывающим различные параметры SSL. Подробнее см. [`HTTPSConnection`](https://python-all.ru/3.5/library/http.client.html#http.client.HTTPSConnection).3435Необязательные параметры *cafile* и *capath* задают набор доверенных сертификатов ЦС для HTTPS-запросов. *cafile* должен указывать на один файл, содержащий набор сертификатов ЦС, а *capath* должен указывать на каталог хешированных файлов сертификатов. Дополнительную информацию можно найти в [`ssl.SSLContext.load_verify_locations()`](https://python-all.ru/3.5/library/ssl.html#ssl.SSLContext.load_verify_locations).3637Параметр *cadefault* игнорируется.3839Эта функция всегда возвращает объект, который может работать как [менеджер контекста](https://python-all.ru/3.5/glossary.html#term-context-manager) и имеет такие методы, как4041- `geturl()` – возвращает URL полученного ресурса, обычно используется для определения, был ли выполнен редирект42- `info()` – возвращает метаинформацию страницы, например заголовки, в виде экземпляра [`email.message_from_string()`](https://python-all.ru/3.5/library/email.parser.html#email.message_from_string) (см. [Краткий справочник по заголовкам HTTP](https://python-all.ru/3.5/library/urllib.request.html))43- `getcode()` – возвращает HTTP статус-код ответа.4445Для HTTP и HTTPS URL эта функция возвращает слегка измененный объект [`http.client.HTTPResponse`](https://python-all.ru/3.5/library/http.client.html#http.client.HTTPResponse). В дополнение к трем новым методам, указанным выше, атрибут msg содержит ту же информацию, что и атрибут [`reason`](https://python-all.ru/3.5/library/http.client.html#http.client.HTTPResponse.reason) – фразу причины, возвращаемую сервером – вместо заголовков ответа, как указано в документации для [`HTTPResponse`](https://python-all.ru/3.5/library/http.client.html#http.client.HTTPResponse).4647Для URL с протоколами FTP, file и data, а также для запросов, явно обрабатываемых устаревшими классами [`URLopener`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.URLopener) и [`FancyURLopener`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.FancyURLopener), эта функция возвращает объект `urllib.response.addinfourl`.4849Возбуждает [`URLError`](https://python-all.ru/3.5/library/urllib.error.html#urllib.error.URLError) при ошибках протокола.5051Обратите внимание, что может быть возвращен `None`, если ни один обработчик не обрабатывает запрос (хотя установленный по умолчанию глобальный [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector) использует [`UnknownHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.UnknownHandler), чтобы гарантировать, что этого никогда не произойдет).5253Кроме того, если обнаружены настройки прокси (например, когда установлена переменная окружения `*_proxy` такая, как `http_proxy`), [`ProxyHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.ProxyHandler) устанавливается по умолчанию и обрабатывает запросы через прокси.5455Устаревшая функция `urllib.urlopen` из Python 2.6 и более ранних версий была прекращена; [`urllib.request.urlopen()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlopen) соответствует старому `urllib2.urlopen`. Обработка прокси, которая осуществлялась передачей словаря в параметр функции `urllib.urlopen`, может быть получена с помощью объектов [`ProxyHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.ProxyHandler).5657Изменено в версии 3.2: добавлены *cafile* и *capath*.5859Изменено в версии 3.2: Теперь, если возможно, поддерживаются виртуальные хосты HTTPS (то есть если [`ssl.HAS_SNI`](https://python-all.ru/3.5/library/ssl.html#ssl.HAS_SNI) истинно).6061Новое в версии 3.2: Параметр *data* может быть итерируемым объектом.6263Изменено в версии 3.3: добавлен *cadefault*.6465Изменено в версии 3.4.3: добавлен *context*.6667#### `urllib.request.install_opener(opener)`6869Устанавливает экземпляр [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector) в качестве глобального открывателя по умолчанию. Установка открывателя необходима только в том случае, если требуется, чтобы urlopen использовал именно его; в противном случае просто вызывайте [`OpenerDirector.open()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector.open) вместо [`urlopen()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlopen). Код не проверяет, является ли объект настоящим [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector); подойдет любой класс с соответствующим интерфейсом.7071#### `urllib.request.build_opener([handler, ...])`7273Возвращает экземпляр [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector), который объединяет обработчики в заданном порядке. *обработчик*и могут быть либо экземплярами [`BaseHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler), либо подклассами [`BaseHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler) (в этом случае должна быть возможность вызвать конструктор без параметров). Экземпляры следующих классов будут помещены перед *обработчик*ами, если только *обработчик*и не содержат их, их экземпляры или подклассы: [`ProxyHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.ProxyHandler) (если обнаружены настройки прокси), [`UnknownHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.UnknownHandler), [`HTTPHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPHandler), [`HTTPDefaultErrorHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPDefaultErrorHandler), [`HTTPRedirectHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPRedirectHandler), [`FTPHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.FTPHandler), [`FileHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.FileHandler), [`HTTPErrorProcessor`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPErrorProcessor).7475Если установка Python поддерживает SSL (т.е. если модуль [`ssl`](https://python-all.ru/3.5/library/ssl.html#module-ssl) может быть импортирован), [`HTTPSHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPSHandler) также будет добавлен.7677Подкласс [`BaseHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler) также может изменить свой атрибут `handler_order`, чтобы изменить свою позицию в списке обработчиков.7879#### `urllib.request.pathname2url(path)`8081Преобразует имя пути *path* из локального синтаксиса в форму, используемую в компоненте пути URL. Эта функция не создает полный URL. Возвращаемое значение уже будет закодировано с помощью функции [`quote()`](https://python-all.ru/3.5/library/urllib.parse.html#urllib.parse.quote).8283#### `urllib.request.url2pathname(path)`8485Преобразует компонент пути *path* из процентно-кодированного URL в локальный синтаксис пути. Эта функция не принимает полный URL. Для декодирования *path* используется [`unquote()`](https://python-all.ru/3.5/library/urllib.parse.html#urllib.parse.unquote).8687#### `urllib.request.getproxies()`8889Эта вспомогательная функция возвращает словарь, отображающий схемы в URL-адреса прокси-серверов. Она сканирует окружение на наличие переменных с именем `<scheme>_proxy`, без учета регистра, сначала для всех операционных систем, а если не находит, ищет информацию о прокси в настройках System Configuration для Mac OS X и в реестре для Windows. Если существуют обе переменные окружения – в нижнем и верхнем регистре (и они различаются), предпочтение отдается нижнему регистру.9091> **Примечание**92>93> Если установлена переменная окружения `REQUEST_METHOD`, что обычно указывает на выполнение скрипта в CGI-среде, переменная окружения `HTTP_PROXY` (в верхнем регистре `_PROXY`) будет проигнорирована. Это связано с тем, что эта переменная может быть вставлена клиентом через HTTP-заголовок «Proxy:». Если необходимо использовать HTTP-прокси в CGI-среде, либо явно используйте `ProxyHandler`, либо убедитесь, что имя переменной указано в нижнем регистре (или, по крайней мере, суффикс `_proxy`).9495Предоставляются следующие классы:9697#### `class urllib.request.Request(url, data=None, headers={}, origin_req_host=None, unverifiable=False, method=None)`9899Этот класс представляет абстракцию URL-запроса.100101*url* должен быть строкой, содержащей корректный URL.102103*data* должен быть объектом bytes, задающим дополнительные данные для отправки на сервер, или `None`, если такие данные не нужны. В настоящее время только HTTP-запросы используют *data*; HTTP-запрос будет POST вместо GET, когда указан параметр *data*. *data* должен быть буфером в стандартном формате *application/x-www-form-urlencoded*. Функция [`urllib.parse.urlencode()`](https://python-all.ru/3.5/library/urllib.parse.html#urllib.parse.urlencode) принимает отображение или последовательность 2-кортежей и возвращает строку ASCII в этом формате. Эту строку следует закодировать в bytes перед использованием в качестве параметра *data*.104105*headers* должен быть словарём, и будет обрабатываться так, как если бы [`add_header()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request.add_header) был вызван с каждым ключом и значением в качестве аргументов. Это часто используется для «подмены» значения заголовка `User-Agent`, который используется браузером для самоидентификации – некоторые HTTP-серверы разрешают запросы только от распространённых браузеров, а не от скриптов. Например, Mozilla Firefox может идентифицировать себя как `"Mozilla/5.0 (X11; U; Linux i686) Gecko/20071127 Firefox/2.0.0.11"`, в то время как строка пользовательского агента по умолчанию для [`urllib`](https://python-all.ru/3.5/library/urllib.html#module-urllib) – это `"Python-urllib/2.6"` (на Python 2.6).106107Пример использования заголовка `Content-Type` с аргументом *data* – это отправка словаря вида `{"Content-Type": "application/x-www-form-urlencoded"}`.108109Последние два аргумента представляют интерес только для корректной обработки сторонних HTTP-куки:110111*origin\_req\_host* should be the request-host of the origin transaction, as defined by [**RFC 2965**](https://python-all.ru/3.5/library/urllib.request.html). It defaults to `http.cookiejar.request_host(self)`. This is the host name or IP address of the original request that was initiated by the user. For example, if the request is for an image in an HTML document, this should be the request-host of the request for the page containing the image.112113*unverifiable* должен указывать, является ли запрос непроверяемым, как определено в RFC 2965. По умолчанию `False`. Непроверяемый запрос – это запрос, URL которого пользователь не имел возможности подтвердить. Например, если запрос выполняется для изображения в HTML- документе и у пользователя не было возможности подтвердить автоматическую загрузку изображения, это должно быть true.114115*method* должен быть строкой, указывающей метод HTTP-запроса, который будет использован (например, `'HEAD'`). Если параметр указан, его значение сохраняется в атрибуте [`method`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request.method) и используется методом [`get_method()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request.get_method). Подклассы могут задать метод по умолчанию, установив атрибут [`method`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request.method) в самом классе.116117Изменено в версии 3.3: Добавлен аргумент [`Request.method`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request.method) в класс Request.118119Изменено в версии 3.4: Метод по умолчанию [`Request.method`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request.method) может быть указан на уровне класса.120121#### `class urllib.request.OpenerDirector`122123Класс [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector) открывает URL-адреса через цепочку [`BaseHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler). Он управляет объединением обработчиков в цепочку и восстановлением после ошибок.124125#### `class urllib.request.BaseHandler`126127Это базовый класс для всех зарегистрированных обработчиков – он отвечает только за простую механику регистрации.128129#### `class urllib.request.HTTPDefaultErrorHandler`130131Класс, определяющий обработчик по умолчанию для HTTP-ответов с ошибками; все ответы преобразуются в исключения [`HTTPError`](https://python-all.ru/3.5/library/urllib.error.html#urllib.error.HTTPError).132133#### `class urllib.request.HTTPRedirectHandler`134135Класс для обработки перенаправлений.136137#### `class urllib.request.HTTPCookieProcessor(cookiejar=None)`138139Класс для обработки HTTP-куки.140141#### `class urllib.request.ProxyHandler(proxies=None)`142143Заставляет запросы проходить через прокси. Если указан *proxies*, он должен быть словарём, сопоставляющим имена протоколов с URL-адресами прокси. По умолчанию список прокси читается из переменных окружения `<protocol>_proxy`. Если переменные окружения для прокси не заданы, то в среде Windows настройки прокси берутся из раздела Internet Settings реестра, а в среде Mac OS X информация о прокси получается из фреймворка OS X System Configuration.144145Чтобы отключить автоматически обнаруженный прокси, передайте пустой словарь.146147Переменная окружения `no_proxy` может использоваться для указания узлов, к которым не следует обращаться через прокси; если она задана, то должна представлять собой разделённый запятыми список суффиксов имён узлов, опционально с добавленным `:port`, например `cern.ch,ncsa.uiuc.edu,some.host:8080`.148149> > **Примечание**150> >151> > `HTTP_PROXY` будет игнорироваться, если задана переменная `REQUEST_METHOD`; см. документацию по [`getproxies()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.getproxies).152153#### `class urllib.request.HTTPPasswordMgr`154155Хранит базу данных соответствий `(realm, uri) -> (user, password)`.156157#### `class urllib.request.HTTPPasswordMgrWithDefaultRealm`158159Хранит базу данных соответствий `(realm, uri) -> (user, password)`. Область (realm) `None` считается универсальной областью, которая используется, если не подходит ни одна другая.160161#### `class urllib.request.HTTPPasswordMgrWithPriorAuth`162163Вариант [`HTTPPasswordMgrWithDefaultRealm`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPPasswordMgrWithDefaultRealm), который также содержит базу данных соответствий `uri -> is_authenticated`. Может использоваться обработчиком BasicAuth для определения, когда отправлять учётные данные аутентификации немедленно, не дожидаясь сначала ответа `401`.164165Новое в версии 3.5.166167#### `class urllib.request.AbstractBasicAuthHandler(password_mgr=None)`168169Это миксин-класс, который помогает с HTTP-аутентификацией как на удалённом хосте, так и через прокси. Если передан *password\_mgr*, он должен быть совместимым с [`HTTPPasswordMgr`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPPasswordMgr); обратитесь к разделу [HTTPPasswordMgr Objects](https://python-all.ru/3.5/library/urllib.request.html#http-password-mgr) для получения информации об интерфейсе, который необходимо поддерживать. Если *passwd\_mgr* также предоставляет методы `is_authenticated` и `update_authenticated` (см. [HTTPPasswordMgrWithPriorAuth Objects](https://python-all.ru/3.5/library/urllib.request.html#http-password-mgr-with-prior-auth)), то обработчик будет использовать результат `is_authenticated` для заданного URI, чтобы определить, следует ли отправлять учётные данные аутентификации вместе с запросом. Если `is_authenticated` возвращает `True` для URI, учётные данные отправляются. Если `is_authenticated` равно `False`, учётные данные не отправляются, и после получения ответа `401` запрос отправляется повторно с учётными данными аутентификации. Если аутентификация прошла успешно, вызывается `update_authenticated` для установки `is_authenticated` `True` для URI, так что последующие запросы к этому URI или любым его супер-URI будут автоматически включать учётные данные аутентификации.170171Новое в версии 3.5: Добавлена поддержка `is_authenticated`.172173#### `class urllib.request.HTTPBasicAuthHandler(password_mgr=None)`174175Обрабатывает аутентификацию на удалённом хосте. Если передан *password\_mgr*, он должен быть совместим с [`HTTPPasswordMgr`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPPasswordMgr); обратитесь к разделу [HTTPPasswordMgr Objects](https://python-all.ru/3.5/library/urllib.request.html#http-password-mgr) для получения информации об интерфейсе, который необходимо поддерживать. HTTPBasicAuthHandler вызовет [`ValueError`](https://python-all.ru/3.5/library/exceptions.html#ValueError) при получении неправильной схемы аутентификации.176177#### `class urllib.request.ProxyBasicAuthHandler(password_mgr=None)`178179Управляет аутентификацией с прокси. *password\_mgr*, если указан, должен быть совместим с [`HTTPPasswordMgr`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPPasswordMgr); обращайтесь к разделу [HTTPPasswordMgr Objects](https://python-all.ru/3.5/library/urllib.request.html#http-password-mgr) за информацией об интерфейсе, который должен поддерживаться.180181#### `class urllib.request.AbstractDigestAuthHandler(password_mgr=None)`182183Это миксин-класс, который помогает с HTTP-аутентификацией как на удалённом хосте, так и через прокси. Если передан *password\_mgr*, он должен быть совместимым с [`HTTPPasswordMgr`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPPasswordMgr); обратитесь к разделу [HTTPPasswordMgr Objects](https://python-all.ru/3.5/library/urllib.request.html#http-password-mgr) для получения информации об интерфейсе, который необходимо поддерживать.184185#### `class urllib.request.HTTPDigestAuthHandler(password_mgr=None)`186187Управляет аутентификацией с удалённым хостом. *password\_mgr*, если указан, должен быть совместим с [`HTTPPasswordMgr`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPPasswordMgr); обращайтесь к разделу [HTTPPasswordMgr Objects](https://python-all.ru/3.5/library/urllib.request.html#http-password-mgr) за информацией об интерфейсе, который должен поддерживаться. Когда добавлены обработчик дайджест-аутентификации (Digest Authentication Handler) и обработчик базовой аутентификации (Basic Authentication Handler), дайджест-аутентификация всегда выполняется первой. Если дайджест-аутентификация снова возвращает ответ 40x, он передаётся обработчику базовой аутентификации. Этот метод обработчика вызовет исключение [`ValueError`](https://python-all.ru/3.5/library/exceptions.html#ValueError) при использовании схемы аутентификации, отличной от Digest или Basic.188189Изменено в версии 3.3: Возбуждает исключение [`ValueError`](https://python-all.ru/3.5/library/exceptions.html#ValueError) при неподдерживаемой схеме аутентификации.190191#### `class urllib.request.ProxyDigestAuthHandler(password_mgr=None)`192193Управляет аутентификацией с прокси. *password\_mgr*, если указан, должен быть совместим с [`HTTPPasswordMgr`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPPasswordMgr); обращайтесь к разделу [HTTPPasswordMgr Objects](https://python-all.ru/3.5/library/urllib.request.html#http-password-mgr) за информацией об интерфейсе, который должен поддерживаться.194195#### `class urllib.request.HTTPHandler`196197Класс для открытия HTTP-URL.198199#### `class urllib.request.HTTPSHandler(debuglevel=0, context=None, check_hostname=None)`200201Класс для открытия HTTPS-URL. *context* и *check\_hostname* имеют то же значение, что и в [`http.client.HTTPSConnection`](https://python-all.ru/3.5/library/http.client.html#http.client.HTTPSConnection).202203Изменено в версии 3.2: Добавлены параметры *context* и *check\_hostname*.204205#### `class urllib.request.FileHandler`206207Открывает локальные файлы.208209#### `class urllib.request.DataHandler`210211Открывает data-URL.212213Новое в версии 3.4.214215#### `class urllib.request.FTPHandler`216217Открывает FTP-URL.218219#### `class urllib.request.CacheFTPHandler`220221Открывает FTP-URL, сохраняя кеш открытых FTP-соединений для минимизации задержек.222223#### `class urllib.request.UnknownHandler`224225Универсальный класс для обработки неизвестных URL.226227#### `class urllib.request.HTTPErrorProcessor`228229Обрабатывает ошибочные HTTP-ответы.230231## 21.6.1. Объекты запросов232233Следующие методы описывают открытый интерфейс [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request), поэтому все они могут быть переопределены в подклассах. Также определяет несколько открытых атрибутов, которые могут использоваться клиентами для анализа разобранного запроса.234235#### `Request.full_url`236237Оригинальный URL, переданный конструктору.238239Изменено в версии 3.4.240241Request.full\_url – это свойство с сеттером, геттером и делитером. При получении [`full_url`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request.full_url) возвращает оригинальный URL запроса вместе с фрагментом, если он присутствовал.242243#### `Request.type`244245Схема URI.246247#### `Request.host`248249Авторитетная часть URI, обычно хост, но может также содержать порт, отделённый двоеточием.250251#### `Request.origin_req_host`252253Исходный хост запроса, без порта.254255#### `Request.selector`256257Путь URI. Если [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request) использует прокси, то selector будет содержать полный URL, который передаётся прокси.258259#### `Request.data`260261Тело сущности запроса или `None`, если не задано.262263Изменено в версии 3.4: Изменение значения [`Request.data`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request.data) теперь удаляет заголовок “Content-Length” , если он был ранее установлен или вычислен.264265#### `Request.unverifiable`266267логическое значение, указывает, является ли запрос непроверяемым, как определено в RFC 2965.268269#### `Request.method`270271HTTP-метод запроса. По умолчанию его значение равно [`None`](https://python-all.ru/3.5/library/constants.html#None), что означает, что [`get_method()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request.get_method) выполнит обычное вычисление метода. Значение можно задать (тем самым переопределив вычисление по умолчанию в [`get_method()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request.get_method)), либо установив значение по умолчанию на уровне класса в подклассе [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request), либо передав значение в конструктор [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request) через аргумент *method*.272273Новое в версии 3.3.274275Изменено в версии 3.4: Теперь значение по умолчанию можно задавать в подклассах; ранее его можно было установить только через аргумент конструктора.276277#### `Request.get_method()`278279Возвращает строку, указывающую HTTP-метод запроса. Если [`Request.method`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request.method) не равно `None`, возвращается его значение; иначе возвращается `'GET'`, если [`Request.data`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request.data) равно `None`, или `'POST'` в противном случае. Это имеет смысл только для HTTP-запросов.280281Изменено в версии 3.3: get\_method теперь учитывает значение [`Request.method`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request.method).282283#### `Request.add_header(key, val)`284285Добавляет ещё один заголовок к запросу. В настоящее время заголовки игнорируются всеми обработчиками, кроме HTTP-обработчиков, где они добавляются в список заголовков, отправляемых серверу. Обратите внимание, что не может быть более одного заголовка с одним и тем же именем, и последующие вызовы перезапишут предыдущие в случае совпадения *ключа*. В настоящее время это не приводит к потере функциональности HTTP, поскольку все заголовки, имеющие смысл при многократном использовании, имеют (специфичный для заголовка) способ достижения той же функциональности с помощью только одного заголовка.286287#### `Request.add_unredirected_header(key, header)`288289Добавляет заголовок, который не будет добавлен в перенаправленный запрос.290291#### `Request.has_header(header)`292293Возвращает, имеет ли экземпляр указанный заголовок (проверяет как обычные, так и неперенаправленные).294295#### `Request.remove_header(header)`296297Удаляет указанный заголовок из экземпляра запроса (как из обычных, так и из неперенаправленных заголовков).298299Новое в версии 3.4.300301#### `Request.get_full_url()`302303Возвращает URL, переданный в конструктор.304305Изменено в версии 3.4.306307Возвращает [`Request.full_url`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request.full_url)308309#### `Request.set_proxy(host, type)`310311Подготавливает запрос, подключаясь к прокси-серверу. *host* и *type* заменят соответствующие значения экземпляра, а selector экземпляра будет содержать исходный URL, переданный в конструктор.312313#### `Request.get_header(header_name, default=None)`314315Возвращает значение указанного заголовка. Если заголовок отсутствует, возвращает значение по умолчанию.316317#### `Request.header_items()`318319Возвращает список кортежей (имя\_заголовка, значение\_заголовка) заголовков запроса.320321Изменено в версии 3.4:Методы запроса add\_data, has\_data, get\_data, get\_type, get\_host, get\_selector, get\_origin\_req\_host и is\_unverifiable, которые были объявлены устаревшими начиная с версии 3.3, удалены.322323## 21.6.2. Объекты OpenerDirector324325Экземпляры [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector) имеют следующие методы:326327#### `OpenerDirector.add_handler(handler)`328329*handler* должен быть экземпляром [`BaseHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler). Следующие методы ищутся и добавляются к возможным цепочкам (ошибки HTTP – особый случай).330331- `protocol_open()` – сигнал о том, что обработчик умеет открывать URL *протокол*.332- `http_error_type()` – сигнал о том, что обработчик умеет обрабатывать ошибки HTTP с кодом ошибки HTTP *type*.333- `protocol_error()` – сигнал о том, что обработчик умеет обрабатывать ошибки от (не-`http`) *протокол*.334- `protocol_request()` – сигнал о том, что обработчик умеет предварительно обрабатывать запросы *протокол*.335- `protocol_response()` – сигнал о том, что обработчик умеет постобрабатывать ответы *протокол*.336337#### `OpenerDirector.open(url, data=None[, timeout])`338339Открывает указанный *url* (может быть объектом запроса или строкой), опционально передавая указанные *data*. Аргументы, возвращаемые значения и исключения такие же, как у [`urlopen()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlopen) (которая просто вызывает метод [`open()`](https://python-all.ru/3.5/library/functions.html#open) на текущем установленном глобальном [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector)). Необязательный параметр *timeout* задаёт тайм-аут в секундах для блокирующих операций, таких как попытка соединения (если не указан, будет использоваться глобальная настройка тайм-аута по умолчанию). Функция тайм-аута фактически работает только для соединений HTTP, HTTPS и FTP.340341#### `OpenerDirector.error(proto, *args)`342343Обрабатывает ошибку указанного протокола. Вызывает зарегистрированные обработчики ошибок для данного протокола с указанными аргументами (зависящими от протокола). Протокол HTTP является особым случаем: для определения конкретного обработчика ошибок используется код ответа HTTP; обратитесь к методам `http_error_*()` классов обработчиков.344345Возвращаемые значения и вызываемые исключения такие же, как у [`urlopen()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlopen).346347Объекты OpenerDirector открывают URL в три этапа:348349Порядок вызова этих методов в каждом этапе определяется сортировкой экземпляров обработчиков.3503511. Каждый обработчик, имеющий метод с именем `protocol_request()`, вызывает этот метод для предварительной обработки запроса.3522. Обработчики, имеющие метод с именем `protocol_open()`, вызываются для обработки запроса. Этот этап завершается, когда обработчик либо возвращает значение, отличное от [`None`](https://python-all.ru/3.5/library/constants.html#None) (т.е. ответ), либо вызывает исключение (обычно [`URLError`](https://python-all.ru/3.5/library/urllib.error.html#urllib.error.URLError)). Исключения могут распространяться дальше.353354   На самом деле, описанный выше алгоритм сначала применяется для методов с именем `default_open()`. Если все такие методы возвращают [`None`](https://python-all.ru/3.5/library/constants.html#None), алгоритм повторяется для методов с именем `protocol_open()`. Если все такие методы возвращают [`None`](https://python-all.ru/3.5/library/constants.html#None), алгоритм повторяется для методов с именем `unknown_open()`.355356   Обратите внимание, что реализация этих методов может включать вызовы методов [`open()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector.open) и [`error()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector.error) родительского экземпляра [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector).3573. Каждый обработчик, имеющий метод с именем `protocol_response()`, вызывает этот метод для постобработки ответа.358359## 21.6.3. Объекты BaseHandler360361Объекты [`BaseHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler) предоставляют несколько методов, которые непосредственно полезны, а также другие методы, предназначенные для использования производными классами. Они предназначены для прямого использования:362363#### `BaseHandler.add_parent(director)`364365Добавляет директор в качестве родителя.366367#### `BaseHandler.close()`368369Удаляет всех родителей.370371Следующие атрибут и методы должны использоваться только классами, производными от [`BaseHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler).372373> **Примечание**374>375> Принято соглашение, что подклассы, определяющие методы `protocol_request()` или `protocol_response()`, называются `*Processor`; все остальные называются `*Handler`.376377#### `BaseHandler.parent`378379Действительный [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector), который можно использовать для открытия через другой протокол или для обработки ошибок.380381#### `BaseHandler.default_open(req)`382383Этот метод *не* определён в [`BaseHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler), но подклассы должны определить его, если хотят перехватывать все URL.384385Этот метод, если он реализован, будет вызван родительским [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector). Он должен вернуть файлоподобный объект, как описано в возвращаемом значении [`open()`](https://python-all.ru/3.5/library/functions.html#open) из [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector), или `None`. Он должен возбуждать [`URLError`](https://python-all.ru/3.5/library/urllib.error.html#urllib.error.URLError), если только не происходит действительно исключительная ситуация (например, [`MemoryError`](https://python-all.ru/3.5/library/exceptions.html#MemoryError) не следует отображать в `URLError`).386387Этот метод будет вызван перед любым методом открытия, специфичным для протокола.388389#### `BaseHandler.protocol_open(req)`390391Этот метод *не* определён в [`BaseHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler), но подклассы должны определить его, если хотят обрабатывать URL с указанным протоколом.392393Если этот метод определён, он будет вызван родительским [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector). Возвращаемые значения должны быть такими же, как для [`default_open()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler.default_open).394395#### `BaseHandler.unknown_open(req)`396397Этот метод *не* определён в [`BaseHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler), но подклассы должны определить его, если хотят перехватывать все URL, для которых нет зарегистрированного обработчика для открытия.398399Если этот метод реализован, он будет вызван [`parent`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler.parent) [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector). Возвращаемые значения должны быть такими же, как для [`default_open()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler.default_open).400401#### `BaseHandler.http_error_default(req, fp, code, msg, hdrs)`402403Этот метод *не* определён в [`BaseHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler), но подклассы должны переопределить его, если они намерены обеспечить всеобъемлющую обработку для иначе необработанных HTTP-ошибок. Он будет автоматически вызван [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector) при получении ошибки и обычно не должен вызываться в других обстоятельствах.404405*req* будет объектом [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request), *fp* будет файлоподобным объектом с телом HTTP-ошибки, *code* будет трёхзначным кодом ошибки, *msg* будет видимым пользователю пояснением кода, а *hdrs* будет объектом отображения, содержащим заголовки ошибки.406407Возвращаемые значения и вызываемые исключения должны быть такими же, как у [`urlopen()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlopen).408409#### `BaseHandler.http_error_nnn(req, fp, code, msg, hdrs)`410411*nnn* должен быть трёхзначным HTTP-кодом ошибки. Этот метод также не определён в [`BaseHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler), но будет вызван, если он существует, на экземпляре подкласса, когда возникает HTTP-ошибка с кодом *nnn*.412413Подклассы должны переопределить этот метод для обработки конкретных HTTP-ошибок.414415Аргументы, возвращаемые значения и вызываемые исключения должны быть такими же, как для [`http_error_default()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler.http_error_default).416417#### `BaseHandler.protocol_request(req)`418419Этот метод *не* определён в [`BaseHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler), но подклассы должны определить его, если хотят предварительно обрабатывать запросы заданного протокола.420421Если этот метод определён, он будет вызван родительским [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector). *req* будет объектом [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request). Возвращаемое значение должно быть объектом [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request).422423#### `BaseHandler.protocol_response(req, response)`424425Этот метод *не* определён в [`BaseHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.BaseHandler), но подклассы должны определить его, если хотят выполнять постобработку ответов заданного протокола.426427Этот метод, если он определён, будет вызван родительским [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector). *req* будет объектом [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request). *response* будет объектом, реализующим тот же интерфейс, что и возвращаемое значение [`urlopen()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlopen). Возвращаемое значение должно реализовывать тот же интерфейс, что и возвращаемое значение [`urlopen()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlopen).428429## 21.6.4. Объекты HTTPRedirectHandler430431> **Примечание**432>433> Некоторые HTTP-перенаправления требуют действий от клиентского кода этого модуля. В таком случае возбуждается [`HTTPError`](https://python-all.ru/3.5/library/urllib.error.html#urllib.error.HTTPError). См. [**RFC 2616**](https://python-all.ru/3.5/library/urllib.request.html) для подробностей о точном значении различных кодов перенаправления.434>435> Исключение `HTTPError`, возбуждаемое по соображениям безопасности, если HTTPRedirectHandler получает URL перенаправления, который не является HTTP, HTTPS или FTP URL.436437#### `HTTPRedirectHandler.redirect_request(req, fp, code, msg, hdrs, newurl)`438439Возвращает [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request) или `None` в ответ на перенаправление. Этот метод вызывается реализациями по умолчанию методов `http_error_30*()`, когда от сервера получено перенаправление. Если перенаправление должно произойти, верните новый [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request), чтобы `http_error_30*()` смог выполнить перенаправление на *newurl*. В противном случае возбудите [`HTTPError`](https://python-all.ru/3.5/library/urllib.error.html#urllib.error.HTTPError), если никакой другой обработчик не должен пытаться обработать этот URL, или верните `None`, если вы не можете, но другой обработчик смог бы.440441> **Примечание**442>443> Реализация по умолчанию этого метода не следует строго [**RFC 2616**](https://python-all.ru/3.5/library/urllib.request.html), который говорит, что ответы 301 и 302 на запросы `POST` не должны автоматически перенаправляться без подтверждения пользователем. В действительности браузеры разрешают автоматическое перенаправление таких ответов, меняя POST на `GET`, и реализация по умолчанию воспроизводит такое поведение.444445#### `HTTPRedirectHandler.http_error_301(req, fp, code, msg, hdrs)`446447Перенаправляет на URL `Location:` или `URI:`. Этот метод вызывается родительским [`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector) при получении HTTP-ответа «Moved Permanently».448449#### `HTTPRedirectHandler.http_error_302(req, fp, code, msg, hdrs)`450451То же, что и [`http_error_301()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPRedirectHandler.http_error_301), но вызывается для ответа «Found».452453#### `HTTPRedirectHandler.http_error_303(req, fp, code, msg, hdrs)`454455То же, что и [`http_error_301()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPRedirectHandler.http_error_301), но вызывается для ответа «See Other».456457#### `HTTPRedirectHandler.http_error_307(req, fp, code, msg, hdrs)`458459То же, что и [`http_error_301()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPRedirectHandler.http_error_301), но вызывается для ответа «временное перенаправление».460461## 21.6.5. Объекты HTTPCookieProcessor462463Экземпляры [`HTTPCookieProcessor`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPCookieProcessor) имеют один атрибут:464465#### `HTTPCookieProcessor.cookiejar`466467[`http.cookiejar.CookieJar`](https://python-all.ru/3.5/library/http.cookiejar.html#http.cookiejar.CookieJar), в котором хранятся куки.468469## 21.6.6. Объекты ProxyHandler470471#### `ProxyHandler.protocol_open(request)`472473Объект [`ProxyHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.ProxyHandler) будет иметь метод `protocol_open()` для каждого *протокол*, для которого есть прокси в словаре *proxies*, переданном в конструктор. Метод будет изменять запросы для прохождения через прокси, вызывая `request.set_proxy()`, и вызывать следующий обработчик в цепочке для непосредственного выполнения протокола.474475## 21.6.7. Объекты HTTPPasswordMgr476477Эти методы доступны у объектов [`HTTPPasswordMgr`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPPasswordMgr) и [`HTTPPasswordMgrWithDefaultRealm`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPPasswordMgrWithDefaultRealm).478479#### `HTTPPasswordMgr.add_password(realm, uri, user, passwd)`480481*uri* может быть как одним URI, так и последовательностью URI. *realm*, *user* и *passwd* должны быть строками. В результате `(user, passwd)` будет использоваться в качестве токенов аутентификации, когда запрашивается аутентификация для *realm* и супер-URI любого из заданных URI.482483#### `HTTPPasswordMgr.find_user_password(realm, authuri)`484485Получает имя пользователя/пароль для заданных realm и URI, если они есть. Этот метод вернёт `(None, None)`, если нет соответствующей пары пользователь/пароль.486487Для объектов [`HTTPPasswordMgrWithDefaultRealm`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPPasswordMgrWithDefaultRealm) область `None` будет проверена, если заданная *realm* не имеет соответствующей пары пользователь/пароль.488489## 21.6.8. Объекты HTTPPasswordMgrWithPriorAuth490491Этот менеджер паролей расширяет [`HTTPPasswordMgrWithDefaultRealm`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPPasswordMgrWithDefaultRealm), чтобы поддерживать отслеживание URI, для которых учётные данные аутентификации должны всегда отправляться.492493#### `HTTPPasswordMgrWithPriorAuth.add_password(realm, uri, user, passwd, is_authenticated=False)`494495*realm*, *uri*, *user*, *passwd* – как и для [`HTTPPasswordMgr.add_password()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPPasswordMgr.add_password). *is\_authenticated* устанавливает начальное значение флага `is_authenticated` для указанного URI или списка URI. Если *is\_authenticated* указан как `True`, *realm* игнорируется.496497#### `HTTPPasswordMgr.find_user_password(realm, authuri)`498499То же, что и для объектов [`HTTPPasswordMgrWithDefaultRealm`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPPasswordMgrWithDefaultRealm)500501#### `HTTPPasswordMgrWithPriorAuth.update_authenticated(self, uri, is_authenticated=False)`502503Обновляет флаг `is_authenticated` для указанного *uri* или списка URI.504505#### `HTTPPasswordMgrWithPriorAuth.is_authenticated(self, authuri)`506507Возвращает текущее состояние флага `is_authenticated` для указанного URI.508509## 21.6.9. Объекты AbstractBasicAuthHandler510511#### `AbstractBasicAuthHandler.http_error_auth_reqed(authreq, host, req, headers)`512513Обрабатывает запрос аутентификации, получая пару пользователь/пароль и повторяя запрос. *authreq* должен быть именем заголовка, в котором содержится информация о realm в запросе, *host* указывает URL и путь для аутентификации, *req* должен быть (неудачным) объектом [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request), а *headers* – заголовками ошибки.514515*host* – это либо authority (например, `"python.org"`), либо URL, содержащий компонент authority (например, `"http://python.org/"`). В любом случае, authority не должен содержать компонент userinfo (поэтому `"python.org"` и `"python.org:80"` подходят, а `"joe:password@python.org"` – нет).516517## 21.6.10. Объекты HTTPBasicAuthHandler518519#### `HTTPBasicAuthHandler.http_error_401(req, fp, code, msg, hdrs)`520521Повторяет запрос с информацией аутентификации, если она доступна.522523## 21.6.11. Объекты ProxyBasicAuthHandler524525#### `ProxyBasicAuthHandler.http_error_407(req, fp, code, msg, hdrs)`526527Повторяет запрос с информацией аутентификации, если она доступна.528529## 21.6.12. Объекты AbstractDigestAuthHandler530531#### `AbstractDigestAuthHandler.http_error_auth_reqed(authreq, host, req, headers)`532533*authreq* должен быть именем заголовка, в котором содержится информация о realm в запросе, *host* должен быть хостом для аутентификации, *req* должен быть (неудачным) объектом [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request), а *headers* – заголовками ошибки.534535## 21.6.13. Объекты HTTPDigestAuthHandler536537#### `HTTPDigestAuthHandler.http_error_401(req, fp, code, msg, hdrs)`538539Повторяет запрос с информацией аутентификации, если она доступна.540541## 21.6.14. Объекты ProxyDigestAuthHandler542543#### `ProxyDigestAuthHandler.http_error_407(req, fp, code, msg, hdrs)`544545Повторяет запрос с информацией аутентификации, если она доступна.546547## 21.6.15. Объекты HTTPHandler548549#### `HTTPHandler.http_open(req)`550551Отправляет HTTP-запрос, который может быть GET или POST, в зависимости от `req.has_data()`.552553## 21.6.16. Объекты HTTPSHandler554555#### `HTTPSHandler.https_open(req)`556557Отправляет HTTPS-запрос, который может быть GET или POST, в зависимости от `req.has_data()`.558559## 21.6.17. Объекты FileHandler560561#### `FileHandler.file_open(req)`562563Открывает файл локально, если имя хоста отсутствует или равно `'localhost'`.564565Изменено в версии 3.2: Этот метод применим только для локальных имен хоста. Если указано удаленное имя хоста, возникает исключение [`URLError`](https://python-all.ru/3.5/library/urllib.error.html#urllib.error.URLError).566567## 21.6.18. Объекты DataHandler568569#### `DataHandler.data_open(req)`570571Читает data URL. Такой URL содержит контент, закодированный в самом URL. Синтаксис data URL описан в [**RFC 2397**](https://python-all.ru/3.5/library/urllib.request.html). Данная реализация игнорирует пробелы в data URL, закодированных в base64, поэтому URL может быть перенесен в любом исходном файле, откуда он взят. Но хотя некоторые браузеры не обращают внимания на отсутствие дополнения в конце URL в base64, эта реализация в таком случае возбудит исключение [`ValueError`](https://python-all.ru/3.5/library/exceptions.html#ValueError).572573## 21.6.19. Объекты FTPHandler574575#### `FTPHandler.ftp_open(req)`576577Открывает FTP-файл, указанный *req*. Вход всегда выполняется с пустыми именем пользователя и паролем.578579## 21.6.20. Объекты CacheFTPHandler580581Объекты [`CacheFTPHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.CacheFTPHandler) являются объектами [`FTPHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.FTPHandler) со следующими дополнительными методами:582583#### `CacheFTPHandler.setTimeout(t)`584585Устанавливает тайм-аут соединений равным *t* секунд.586587#### `CacheFTPHandler.setMaxConns(m)`588589Устанавливает максимальное количество кэшированных соединений равным *m*.590591## 21.6.21. Объекты UnknownHandler592593#### `UnknownHandler.unknown_open()`594595Вызывает исключение [`URLError`](https://python-all.ru/3.5/library/urllib.error.html#urllib.error.URLError).596597## 21.6.22. Объекты HTTPErrorProcessor598599#### `HTTPErrorProcessor.http_response()`600601Обрабатывает ошибочные HTTP-ответы.602603Для кода 200 объект ответа возвращается немедленно.604605Для кодов ошибок, отличных от 200, этот метод просто передаёт задачу методам обработчика `protocol_error_code()` через [`OpenerDirector.error()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector.error). В конечном счёте, [`HTTPDefaultErrorHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPDefaultErrorHandler) вызовет исключение [`HTTPError`](https://python-all.ru/3.5/library/urllib.error.html#urllib.error.HTTPError), если ни один другой обработчик не обработает ошибку.606607#### `HTTPErrorProcessor.https_response()`608609Обрабатывает ошибочные HTTPS-ответы.610611Поведение аналогично [`http_response()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.HTTPErrorProcessor.http_response).612613## 21.6.23. Примеры614615В дополнение к примерам ниже, больше примеров приведено в [HOWTO Fetch Internet Resources Using The urllib Package](https://python-all.ru/3.5/howto/urllib2.html#urllib-howto).616617Этот пример получает главную страницу python.org и отображает первые 300 байт этой страницы.618619```python620>>> import urllib.request621>>> with urllib.request.urlopen('http://www.python.org/') as f:622...     print(f.read(300))623...624b'<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"625"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\n\n\n<html626xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">\n\n<head>\n627<meta http-equiv="content-type" content="text/html; charset=utf-8" />\n628<title>Python Programming '629```630631Обратите внимание, что urlopen возвращает объект bytes. Это связано с тем, что urlopen не может автоматически определить кодировку байтового потока, полученного от HTTP-сервера. Как правило, программа декодирует возвращённый объект bytes в строку, как только определит или угадает подходящую кодировку.632633Следующий документ W3C, [https://www.w3.org/International/O-charset](https://python-all.ru/3.5/library/urllib.request.html), перечисляет различные способы, которыми (X)HTML или XML-документ может задать информацию о своей кодировке.634635Поскольку веб-сайт python.org использует кодировку *utf-8*, как указано в его метатеге, мы будем использовать ту же кодировку для декодирования объекта bytes.636637```python638>>> with urllib.request.urlopen('http://www.python.org/') as f:639...     print(f.read(100).decode('utf-8'))640...641<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"642"http://www.w3.org/TR/xhtml1/DTD/xhtm643```644645Тот же результат можно получить и без использования [менеджера контекста](https://python-all.ru/3.5/glossary.html#term-context-manager) подхода.646647```python648>>> import urllib.request649>>> f = urllib.request.urlopen('http://www.python.org/')650>>> print(f.read(100).decode('utf-8'))651<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"652"http://www.w3.org/TR/xhtml1/DTD/xhtm653```654655В следующем примере мы отправляем поток данных на стандартный ввод CGI и читаем данные, которые он возвращает. Обратите внимание: этот пример будет работать только в том случае, если установка Python поддерживает SSL.656657```python658>>> import urllib.request659>>> req = urllib.request.Request(url='https://localhost/cgi-bin/test.cgi',660...                       data=b'This data is passed to stdin of the CGI')661>>> with urllib.request.urlopen(req) as f:662...     print(f.read().decode('utf-8'))663...664Got Data: "This data is passed to stdin of the CGI"665```666667Код образца CGI, использованного в приведённом выше примере:668669```python670#!/usr/bin/env python671import sys672data = sys.stdin.read()673print('Content-type: text/plain\n\nGot Data: "%s"' % data)674```675676Вот пример выполнения запроса `PUT` с помощью [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request):677678```python679import urllib.request680DATA = b'some data'681req = urllib.request.Request(url='http://localhost:8080', data=DATA,method='PUT')682with urllib.request.urlopen(req) as f:683    pass684print(f.status)685print(f.reason)686```687688Использование базовой HTTP-аутентификации:689690```python691import urllib.request692# Создать OpenerDirector с поддержкой базовой HTTP-аутентификации...693auth_handler = urllib.request.HTTPBasicAuthHandler()694auth_handler.add_password(realm='PDQ Application',695                          uri='https://mahler:8092/site-updates.py',696                          user='klem',697                          passwd='kadidd!ehopper')698opener = urllib.request.build_opener(auth_handler)699# ...и установить его глобально, чтобы его можно было использовать с urlopen.700urllib.request.install_opener(opener)701urllib.request.urlopen('http://www.example.com/login.html')702```703704[`build_opener()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.build_opener) предоставляет множество обработчиков по умолчанию, включая [`ProxyHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.ProxyHandler). По умолчанию [`ProxyHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.ProxyHandler) использует переменные окружения с именами `<scheme>_proxy`, где `<scheme>` – это схема URL. Например, переменная окружения `http_proxy` читается для получения URL HTTP-прокси.705706В этом примере стандартный [`ProxyHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.ProxyHandler) заменяется на тот, который использует программно заданные URL прокси, а также добавляется поддержка авторизации прокси с помощью [`ProxyBasicAuthHandler`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.ProxyBasicAuthHandler).707708```python709proxy_handler = urllib.request.ProxyHandler({'http': 'http://www.example.com:3128/'})710proxy_auth_handler = urllib.request.ProxyBasicAuthHandler()711proxy_auth_handler.add_password('realm', 'host', 'username', 'password')712713opener = urllib.request.build_opener(proxy_handler, proxy_auth_handler)714# На этот раз, вместо установки OpenerDirector, используется напрямую:715opener.open('http://www.example.com/login.html')716```717718Добавление HTTP-заголовков:719720Используйте аргумент *headers* конструктора [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request) или:721722```python723import urllib.request724req = urllib.request.Request('http://www.example.com/')725req.add_header('Referer', 'http://www.python.org/')726# Настроить значение заголовка User-Agent по умолчанию:727req.add_header('User-Agent', 'urllib-example/0.1 (Contact: . . .)')728r = urllib.request.urlopen(req)729```730731[`OpenerDirector`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector) автоматически добавляет заголовок *User-Agent* к каждому запросу [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request). Чтобы изменить это:732733```python734import urllib.request735opener = urllib.request.build_opener()736opener.addheaders = [('User-agent', 'Mozilla/5.0')]737opener.open('http://www.example.com/')738```739740Также помните, что несколько стандартных заголовков (*Content-Length*, *Content-Type* и *Host*) добавляются, когда [`Request`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.Request) передаётся в [`urlopen()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlopen) (или [`OpenerDirector.open()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.OpenerDirector.open)).741742Вот пример сеанса, в котором используется метод `GET` для получения URL с параметрами:743744```python745>>> import urllib.request746>>> import urllib.parse747>>> params = urllib.parse.urlencode({'spam': 1, 'eggs': 2, 'bacon': 0})748>>> url = "http://www.musi-cal.com/cgi-bin/query?%s" % params749>>> with urllib.request.urlopen(url) as f:750...     print(f.read().decode('utf-8'))751...752```753754В следующем примере вместо этого используется метод `POST`. Обратите внимание, что вывод параметров из urlencode кодируется в байты перед отправкой в urlopen в качестве данных:755756```python757>>> import urllib.request758>>> import urllib.parse759>>> data = urllib.parse.urlencode({'spam': 1, 'eggs': 2, 'bacon': 0})760>>> data = data.encode('ascii')761>>> with urllib.request.urlopen("http://requestb.in/xrbl82xr", data) as f:762...     print(f.read().decode('utf-8'))763...764```765766В следующем примере используется явно указанный HTTP-прокси, переопределяющий настройки окружения:767768```python769>>> import urllib.request770>>> proxies = {'http': 'http://proxy.example.com:8080/'}771>>> opener = urllib.request.FancyURLopener(proxies)772>>> with opener.open("http://www.python.org") as f:773...     f.read().decode('utf-8')774...775```776777В следующем примере прокси не используются вовсе, переопределяя настройки окружения:778779```python780>>> import urllib.request781>>> opener = urllib.request.FancyURLopener({})782>>> with opener.open("http://www.python.org/") as f:783...     f.read().decode('utf-8')784...785```786787## 21.6.24. Устаревший интерфейс788789Следующие функции и классы перенесены из модуля Python 2 `urllib` (в отличие от `urllib2`). В будущем они могут стать устаревшими.790791#### `urllib.request.urlretrieve(url, filename=None, reporthook=None, data=None)`792793Копирует сетевой объект, заданный URL, в локальный файл. Если URL указывает на локальный файл, объект не будет скопирован, если не указан filename. Возвращает кортеж `(filename, headers)`, где *filename* – это имя локального файла, под которым можно найти объект, а *headers* – то, что вернул метод `info()` объекта, возвращённого [`urlopen()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlopen) (для удалённого объекта). Исключения те же, что и для [`urlopen()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlopen).794795Второй аргумент, если он задан, указывает, в какой файл копировать данные (если отсутствует, данные будут записаны во временный файл с автоматически сгенерированным именем). Третий аргумент, если он задан, – это функция-обработчик, которая будет вызвана один раз при установке сетевого соединения и затем после каждого прочитанного блока. Функция будет получать три аргумента: количество переданных блоков, размер блока в байтах и общий размер файла. Третий аргумент может быть `-1` на старых FTP-серверах, которые не возвращают размер файла в ответ на запрос получения.796797Следующий пример иллюстрирует наиболее распространённый сценарий использования:798799```python800>>> import urllib.request801>>> local_filename, headers = urllib.request.urlretrieve('http://python.org/')802>>> html = open(local_filename)803>>> html.close()804```805806Если *url* использует идентификатор схемы `http:`, необязательный аргумент *data* может быть передан для указания запроса `POST` (обычно тип запроса – `GET`). Аргумент *data* должен быть байтовым объектом в стандартном формате *application/x-www-form-urlencoded*; см. функцию [`urllib.parse.urlencode()`](https://python-all.ru/3.5/library/urllib.parse.html#urllib.parse.urlencode).807808[`urlretrieve()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlretrieve) вызовет исключение `ContentTooShortError`, когда обнаружит, что объём доступных данных меньше ожидаемого (который указан в заголовке *Content-Length*). Это может произойти, например, при прерывании загрузки.809810Заголовок *Content-Length* рассматривается как нижняя граница: если доступно больше данных для чтения, urlretrieve читает больше данных, но если данных меньше, он вызывает исключение.811812В этом случае вы всё ещё можете получить загруженные данные – они хранятся в атрибуте `content` экземпляра исключения.813814Если заголовок *Content-Length* не был передан, urlretrieve не может проверить размер загруженных данных и просто возвращает их. В этом случае остаётся только предполагать, что загрузка прошла успешно.815816#### `urllib.request.urlcleanup()`817818Очищает временные файлы, которые могли остаться от предыдущих вызовов [`urlretrieve()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlretrieve).819820#### `class urllib.request.URLopener(proxies=None, **x509)`821822Устарело с версии 3.3.823824Базовый класс для открытия и чтения URL. Если не требуется поддержка открытия объектов с использованием схем, отличных от `http:`, `ftp:` или `file:`, вероятно, стоит использовать [`FancyURLopener`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.FancyURLopener).825826По умолчанию класс [`URLopener`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.URLopener) отправляет заголовок *User-Agent* со значением `urllib/VVV`, где *VVV* – это номер версии [`urllib`](https://python-all.ru/3.5/library/urllib.html#module-urllib). Приложения могут задать собственный заголовок *User-Agent*, создав подкласс [`URLopener`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.URLopener) или [`FancyURLopener`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.FancyURLopener) и установив атрибут класса [`version`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.URLopener.version) в соответствующее строковое значение в определении подкласса.827828Необязательный параметр *proxies* должен быть словарём, сопоставляющим имена схем с URL прокси. Пустой словарь полностью отключает прокси. Значение по умолчанию – `None`; в этом случае используются настройки прокси из окружения (если они есть), как описано выше в определении [`urlopen()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlopen).829830Дополнительные именованные параметры, собранные в *x509*, могут использоваться для аутентификации клиента при использовании схемы `https:`. Поддерживаются ключевые слова *key\_file* и *cert\_file* для указания SSL-ключа и сертификата; оба необходимы для поддержки аутентификации клиента.831832Объекты [`URLopener`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.URLopener) возбуждают исключение [`OSError`](https://python-all.ru/3.5/library/exceptions.html#OSError), если сервер возвращает код ошибки.833834#### `open(fullurl, data=None)`835836Открывает *fullurl*, используя соответствующий протокол. Этот метод настраивает кеш и информацию о прокси, а затем вызывает соответствующий метод open с переданными аргументами. Если схема не распознана, вызывается [`open_unknown()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.URLopener.open_unknown). Аргумент *data* имеет то же значение, что и аргумент *data* метода [`urlopen()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlopen).837838#### `open_unknown(fullurl, data=None)`839840Переопределяемый интерфейс для открытия неизвестных типов URL.841842#### `retrieve(url, filename=None, reporthook=None, data=None)`843844Извлекает содержимое *url* и помещает его в *filename*. Возвращаемое значение – кортеж из локального имени файла и либо объекта [`email.message.Message`](https://python-all.ru/3.5/library/email.message.html#email.message.Message), содержащего заголовки ответа (для удалённых URL), либо `None` (для локальных URL). После этого вызывающий код должен открыть и прочитать содержимое *filename*. Если *filename* не указан и URL ссылается на локальный файл, возвращается имя входного файла. Если URL не является локальным и *filename* не указан, имя файла формируется вызовом [`tempfile.mktemp()`](https://python-all.ru/3.5/library/tempfile.html#tempfile.mktemp) с суффиксом, соответствующим суффиксу последнего компонента пути входного URL. Если передан *reporthook*, это должна быть функция, принимающая три числовых параметра: номер чанка, максимальный размер читаемых чанков и общий размер загрузки (-1, если неизвестен). Она будет вызвана один раз в начале и после каждого чтения чанка данных из сети. Для локальных URL параметр *reporthook* игнорируется.845846Если *url* использует идентификатор схемы `http:`, можно указать необязательный аргумент *data* для задания `POST`-запроса (обычно тип запроса – `GET`). Аргумент *data* должен быть в стандартном формате *application/x-www-form-urlencoded*; см. функцию [`urllib.parse.urlencode()`](https://python-all.ru/3.5/library/urllib.parse.html#urllib.parse.urlencode).847848#### `version`849850Переменная, задающая пользовательский агент объекта opener. Чтобы [`urllib`](https://python-all.ru/3.5/library/urllib.html#module-urllib) сообщал серверам, что он является определённым пользовательским агентом, установите это значение в подклассе как переменную класса или в конструкторе перед вызовом конструктора базового класса.851852#### `class urllib.request.FancyURLopener(...)`853854Устарело с версии 3.3.855856[`FancyURLopener`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.FancyURLopener) является подклассом [`URLopener`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.URLopener), обеспечивающим стандартную обработку следующих HTTP-кодов ответа: 301, 302, 303, 307 и 401. Для перечисленных кодов 30x используется заголовок *Location* для получения фактического URL. Для кода 401 (требуется аутентификация) выполняется базовая HTTP-аутентификация. Для кодов 30x количество рекурсий ограничено значением атрибута *maxtries*, которое по умолчанию равно 10.857858Для всех остальных кодов ответа вызывается метод `http_error_default()`, который можно переопределить в подклассах для соответствующей обработки ошибки.859860> **Примечание**861>862> В соответствии с буквой [**RFC 2616**](https://python-all.ru/3.5/library/urllib.request.html), ответы 301 и 302 на POST-запросы не должны автоматически перенаправляться без подтверждения пользователем. На практике браузеры всё же допускают автоматическое перенаправление таких ответов, заменяя POST на GET, и [`urllib`](https://python-all.ru/3.5/library/urllib.html#module-urllib) воспроизводит это поведение.863864Параметры конструктора такие же, как для [`URLopener`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.URLopener).865866> **Примечание**867>868> При выполнении базовой аутентификации экземпляр [`FancyURLopener`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.FancyURLopener) вызывает свой метод [`prompt_user_passwd()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.FancyURLopener.prompt_user_passwd). Реализация по умолчанию запрашивает у пользователя необходимую информацию на управляющем терминале. Подкласс может переопределить этот метод для обеспечения более подходящего поведения, если это необходимо.869870Класс [`FancyURLopener`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.FancyURLopener) предоставляет один дополнительный метод, который следует перегрузить для обеспечения соответствующего поведения:871872#### `prompt_user_passwd(host, realm)`873874Возвращает информацию, необходимую для аутентификации пользователя на указанном хосте в заданной области безопасности. Возвращаемое значение должно быть кортежем `(user, password)`, который можно использовать для базовой аутентификации.875876Реализация запрашивает эту информацию на терминале; приложение должно переопределить этот метод, чтобы использовать подходящую модель взаимодействия в локальной среде.877878## 21.6.25. [`urllib.request`](https://python-all.ru/3.5/library/urllib.request.html#module-urllib.request) Ограничения879880>881882- В настоящее время поддерживаются только следующие протоколы: HTTP (версии 0.9 и 1.0), FTP, локальные файлы и data-URL.883884  Изменено в версии 3.4: Добавлена поддержка data-URL.885- Функция кэширования [`urlretrieve()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlretrieve) отключена, пока не будет реализована правильная обработка заголовков Expiration time.886- Должна быть функция для проверки, находится ли определённый URL в кэше.887- Для обратной совместимости, если URL указывает на локальный файл, но файл не удаётся открыть, URL интерпретируется заново с использованием протокола FTP. Это иногда может приводить к запутанным сообщениям об ошибках.888- Функции [`urlopen()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlopen) и [`urlretrieve()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlretrieve) могут вызывать произвольно длинные задержки при ожидании установки сетевого соединения. Это означает, что с помощью этих функций сложно построить интерактивный веб-клиент без использования потоков.889- Данные, возвращаемые [`urlopen()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlopen) или [`urlretrieve()`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.urlretrieve), представляют собой необработанные данные, возвращённые сервером. Это могут быть бинарные данные (например, изображение), обычный текст или, к примеру, HTML. Протокол HTTP передаёт информацию о типе в заголовке ответа, который можно проверить, взглянув на заголовок *Content-Type*. Если возвращённые данные являются HTML, можно использовать модуль [`html.parser`](https://python-all.ru/3.5/library/html.parser.html#module-html.parser) для его разбора.890- Код, обрабатывающий протокол FTP, не может различить файл и каталог. Это может привести к неожиданному поведению при попытке чтения URL, указывающего на недоступный файл. Если URL заканчивается на `/`, предполагается, что он ссылается на каталог, и будет обработан соответствующим образом. Но если попытка чтения файла приводит к ошибке 550 (означает, что URL не найден или недоступен, часто из-за прав доступа), то путь рассматривается как каталог, чтобы обработать случай, когда каталог указан URL, но завершающий `/` опущен. Это может привести к вводящим в заблуждение результатам при попытке получить файл, права на чтение которого делают его недоступным; FTP-код попытается прочитать его, завершится ошибкой 550, а затем выполнит вывод списка каталога для этого недоступного файла. Если требуется тонкий контроль, стоит рассмотреть использование модуля [`ftplib`](https://python-all.ru/3.5/library/ftplib.html#module-ftplib), создание подкласса [`FancyURLopener`](https://python-all.ru/3.5/library/urllib.request.html#urllib.request.FancyURLopener) или изменение *\_urlopener* в соответствии со своими потребностями.891892# 21.7. [`urllib.response`](https://python-all.ru/3.5/library/urllib.request.html#module-urllib.response) – Классы ответов urllib893894Модуль [`urllib.response`](https://python-all.ru/3.5/library/urllib.request.html#module-urllib.response) определяет функции и классы, реализующие минимальный файлоподобный интерфейс, включая `read()` и `readline()`. Типичный объект ответа – это экземпляр addinfourl, который определяет метод `info()`, возвращающий заголовки, и метод `geturl()`, возвращающий URL. Функции, определённые в этом модуле, используются внутри модуля [`urllib.request`](https://python-all.ru/3.5/library/urllib.request.html#module-urllib.request).895