`urllib.request.md`

989 строк · 103.3 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.13/library/urllib.request.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# `urllib.request` – Расширяемая библиотека для открытия URL89**Исходный код:** [Lib/urllib/request.py](https://python-all.ru/src/3.13/Lib/urllib/request.py)1011---1213Модуль `urllib.request` определяет функции и классы, которые помогают открывать URL (в основном HTTP) в сложном мире – базовая и дайджест-аутентификация, перенаправления, куки и многое другое.1415> **См. также**16>17> Для высокоуровневого интерфейса HTTP-клиента рекомендуется [пакет Requests](https://python-all.ru/3.13/library/urllib.request.html).1819> **Предупреждение**20>21> В macOS использовать этот модуль в программах, использующих [`os.fork()`](https://python-all.ru/3.13/library/os.html#os.fork), небезопасно, поскольку реализация [`getproxies()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.getproxies) для macOS использует системный API более высокого уровня. Установите переменную окружения `no_proxy` в `*`, чтобы избежать этой проблемы (например, `os.environ["no_proxy"] = "*"`).2223[Доступность](https://python-all.ru/3.13/library/intro.html#availability): не WASI.2425Этот модуль не работает или недоступен на WebAssembly. Подробнее см. [платформы WebAssembly](https://python-all.ru/3.13/library/intro.html#wasm-availability).2627Модуль `urllib.request` определяет следующие функции:2829#### `urllib.request.urlopen(url, data=None, [timeout, ]*, context=None)`3031Открывает *url*, который может быть строкой, содержащей корректный, правильно закодированный URL, или объектом [`Request`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request).3233*data* должен быть объектом, задающим дополнительные данные для отправки серверу, или `None`, если такие данные не нужны. Подробнее см. [`Request`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request).3435Модуль urllib.request использует HTTP/1.1 и включает заголовок `Connection:close` в свои HTTP-запросы.3637Необязательный параметр *timeout* задает таймаут в секундах для блокирующих операций, таких как попытка подключения (если не указан, используется глобальная настройка таймаута по умолчанию). Это на самом деле работает только для HTTP, HTTPS и FTP-соединений.3839Если указан *context*, он должен быть экземпляром [`ssl.SSLContext`](https://python-all.ru/3.13/library/ssl.html#ssl.SSLContext), описывающим различные параметры SSL. Подробнее см. [`HTTPSConnection`](https://python-all.ru/3.13/library/http.client.html#http.client.HTTPSConnection).4041Эта функция всегда возвращает объект, который может работать как [контекстный менеджер](https://python-all.ru/3.13/glossary.html#term-context-manager) и имеет свойства *url*, *headers* и *status*. Подробнее об этих свойствах см. [`urllib.response.addinfourl`](https://python-all.ru/3.13/library/urllib.request.html#urllib.response.addinfourl).4243Для HTTP и HTTPS URL эта функция возвращает слегка измененный объект [`http.client.HTTPResponse`](https://python-all.ru/3.13/library/http.client.html#http.client.HTTPResponse). В дополнение к трем новым методам, указанным выше, атрибут msg содержит ту же информацию, что и атрибут [`reason`](https://python-all.ru/3.13/library/http.client.html#http.client.HTTPResponse.reason) – фразу причины, возвращаемую сервером – вместо заголовков ответа, как указано в документации для `HTTPResponse`.4445Для URL с протоколами FTP, file и data, а также для запросов, явно обрабатываемых устаревшими классами [`URLopener`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.URLopener) и [`FancyURLopener`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.FancyURLopener), эта функция возвращает объект [`urllib.response.addinfourl`](https://python-all.ru/3.13/library/urllib.request.html#urllib.response.addinfourl).4647Возбуждает [`URLError`](https://python-all.ru/3.13/library/urllib.error.html#urllib.error.URLError) при ошибках протокола.4849Обратите внимание, что может быть возвращен `None`, если ни один обработчик не обрабатывает запрос (хотя установленный по умолчанию глобальный [`OpenerDirector`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector) использует [`UnknownHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.UnknownHandler), чтобы гарантировать, что этого никогда не произойдет).5051Кроме того, если обнаружены настройки прокси (например, когда установлена переменная окружения `*_proxy`, например `http_proxy`), [`ProxyHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.ProxyHandler) устанавливается по умолчанию и гарантирует, что запросы обрабатываются через прокси.5253Устаревшая функция `urllib.urlopen` из Python 2.6 и более ранних версий была прекращена; `urllib.request.urlopen()` соответствует старому `urllib2.urlopen`. Обработка прокси, которая осуществлялась передачей словаря в параметр функции `urllib.urlopen`, может быть получена с помощью объектов [`ProxyHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.ProxyHandler).5455Стандартный открыватель возбуждает [событие аудита](https://python-all.ru/3.13/library/sys.html#auditing) `urllib.Request` с аргументами `fullurl`, `data`, `headers`, `method`, взятыми из объекта запроса.5657Изменено в версии 3.2: добавлены *cafile* и *capath*.5859Виртуальные хосты HTTPS теперь поддерживаются, если это возможно (то есть, если [`ssl.HAS_SNI`](https://python-all.ru/3.13/library/ssl.html#ssl.HAS_SNI) истинно).6061*data* может быть итерируемым объектом.6263Изменено в версии 3.3: добавлен *cadefault*.6465Изменено в версии 3.4.3: добавлен *context*.6667Изменено в версии 3.10: HTTPS-соединение теперь отправляет расширение ALPN с индикатором протокола `http/1.1`, если не указан *context*. Пользовательский *context* должен устанавливать протоколы ALPN с помощью [`set_alpn_protocols()`](https://python-all.ru/3.13/library/ssl.html#ssl.SSLContext.set_alpn_protocols).6869Изменено в версии 3.13: Удалены параметры *cafile*, *capath* и *cadefault*: вместо них используйте параметр *context*.7071#### `urllib.request.install_opener(opener)`7273Устанавливает экземпляр [`OpenerDirector`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector) в качестве глобального открывателя по умолчанию. Установка открывателя необходима только в том случае, если требуется, чтобы urlopen использовал именно его; в противном случае просто вызывайте [`OpenerDirector.open()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector.open) вместо [`urlopen()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.urlopen). Код не проверяет, является ли объект настоящим `OpenerDirector`; подойдет любой класс с соответствующим интерфейсом.7475#### `urllib.request.build_opener([handler, ...])`7677Возвращает экземпляр [`OpenerDirector`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector), который объединяет обработчики в заданном порядке. *обработчик*и могут быть либо экземплярами [`BaseHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler), либо подклассами `BaseHandler` (в этом случае должна быть возможность вызвать конструктор без параметров). Экземпляры следующих классов будут помещены перед *обработчик*ами, если только *обработчик*и не содержат их, их экземпляры или подклассы: [`ProxyHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.ProxyHandler) (если обнаружены настройки прокси), [`UnknownHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.UnknownHandler), [`HTTPHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPHandler), [`HTTPDefaultErrorHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPDefaultErrorHandler), [`HTTPRedirectHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPRedirectHandler), [`FTPHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.FTPHandler), [`FileHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.FileHandler), [`HTTPErrorProcessor`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPErrorProcessor).7879Если установка Python поддерживает SSL (т.е. если модуль [`ssl`](https://python-all.ru/3.13/library/ssl.html#module-ssl) может быть импортирован), [`HTTPSHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPSHandler) также будет добавлен.8081Подкласс [`BaseHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler) также может изменить свой атрибут `handler_order`, чтобы изменить свою позицию в списке обработчиков.8283#### `urllib.request.pathname2url(path)`8485Преобразует указанный локальный путь в URL `file:`. Эта функция использует функцию [`quote()`](https://python-all.ru/3.13/library/urllib.parse.html#urllib.parse.quote) для кодирования пути. По историческим причинам возвращаемое значение опускает префикс схемы `file:`. В этом примере показано использование функции в Windows:8687```python88>>> from urllib.request import pathname2url89>>> path = 'C:\\Program Files'90>>> 'file:' + pathname2url(path)91'file:///C:/Program%20Files'92```9394#### `urllib.request.url2pathname(url)`9596Преобразует указанный URL `file:` в локальный путь. Эта функция использует [`unquote()`](https://python-all.ru/3.13/library/urllib.parse.html#urllib.parse.unquote) для декодирования URL. По историческим причинам указанное значение *должно* опускать префикс схемы `file:`. В этом примере показано использование функции в Windows:9798```python99>>> from urllib.request import url2pathname100>>> url = 'file:///C:/Program%20Files'101>>> url2pathname(url.removeprefix('file:'))102'C:\\Program Files'103```104105#### `urllib.request.getproxies()`106107Эта вспомогательная функция возвращает словарь, отображающий схему в URL прокси-сервера. Она сканирует окружение на наличие переменных с именем `<scheme>_proxy`, без учёта регистра, сначала для всех операционных систем, а если не удаётся найти, ищет информацию о прокси в System Configuration для macOS и в реестре Windows для Windows. Если существуют и переменные в нижнем, и в верхнем регистре (и они различаются), предпочтение отдаётся нижнему регистру.108109> **Примечание**110>111> Если установлена переменная окружения `REQUEST_METHOD`, что обычно указывает на выполнение скрипта в CGI-среде, переменная окружения `HTTP_PROXY` (в верхнем регистре `_PROXY`) будет проигнорирована. Это связано с тем, что эта переменная может быть вставлена клиентом через HTTP-заголовок «Proxy:». Если необходимо использовать HTTP-прокси в CGI-среде, либо явно используйте `ProxyHandler`, либо убедитесь, что имя переменной указано в нижнем регистре (или, по крайней мере, суффикс `_proxy`).112113Предоставляются следующие классы:114115#### `class urllib.request.Request(url, data=None, headers={}, origin_req_host=None, unverifiable=False, method=None)`116117Этот класс представляет абстракцию URL-запроса.118119*url* должен быть строкой, содержащей корректный, правильно закодированный URL.120121*data* must be an object specifying additional data to send to the server, or `None` if no such data is needed. Currently HTTP requests are the only ones that use *data*. The supported object types include bytes, file-like objects, and iterables of bytes-like objects. If no `Content-Length` nor `Transfer-Encoding` header field has been provided, [`HTTPHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPHandler) will set these headers according to the type of *data*. `Content-Length` will be used to send bytes objects, while `Transfer-Encoding: chunked` as specified in [**RFC 7230**](https://python-all.ru/3.13/library/urllib.request.html), Section 3.3.1 will be used to send files and other iterables.122123Для метода запроса HTTP POST *data* должен быть буфером в стандартном формате *application/x-www-form-urlencoded*. Функция [`urllib.parse.urlencode()`](https://python-all.ru/3.13/library/urllib.parse.html#urllib.parse.urlencode) принимает отображение или последовательность кортежей из двух элементов и возвращает строку ASCII в этом формате. Перед использованием в качестве параметра *data* её следует закодировать в байты.124125*headers* должен быть словарём, и будет обрабатываться так, как если бы [`add_header()`](https://python-all.ru/3.13/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.13/library/urllib.html#module-urllib) – `"Python-urllib/2.6"` (в Python 2.6). Все ключи заголовков отправляются в верблюжьем регистре.126127Подходящий заголовок `Content-Type` следует включить, если присутствует аргумент *data*. Если этот заголовок не был предоставлен и *data* не равен `None`, по умолчанию будет добавлен `Content-Type: application/x-www-form-urlencoded`.128129Следующие два аргумента представляют интерес только для корректной обработки сторонних HTTP-куки:130131*origin\_req\_host* should be the request-host of the origin transaction, as defined by [**RFC 2965**](https://python-all.ru/3.13/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.132133*unverifiable* should indicate whether the request is unverifiable, as defined by [**RFC 2965**](https://python-all.ru/3.13/library/urllib.request.html). It defaults to `False`. An unverifiable request is one whose URL the user did not have the option to approve. For example, if the request is for an image in an HTML document, and the user had no option to approve the automatic fetching of the image, this should be true.134135*method* должен быть строкой, указывающей метод HTTP-запроса, который будет использоваться (например, `'HEAD'`). Если указан, его значение сохраняется в атрибуте [`method`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request.method) и используется [`get_method()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request.get_method). По умолчанию используется `'GET'`, если *data* равен `None`, и `'POST'` в противном случае. Подклассы могут указать другой метод по умолчанию, установив атрибут `method` в самом классе.136137> **Примечание**138>139> Запрос не будет работать должным образом, если объект data не может предоставить своё содержимое более одного раза (например, файл или итерируемый объект, который может создать содержимое только один раз), и запрос повторяется из-за HTTP-перенаправлений или аутентификации. *data* отправляется на HTTP-сервер сразу после заголовков. В библиотеке нет поддержки ожидания 100-continue.140141Изменено в версии 3.3: Добавлен аргумент [`Request.method`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request.method) в класс Request.142143Изменено в версии 3.4: Метод по умолчанию [`Request.method`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request.method) может быть указан на уровне класса.144145Изменено в версии 3.6: Не вызывать ошибку, если `Content-Length` не был предоставлен, а *data* не является ни `None`, ни объектом bytes. Вместо этого использовать чанкованное кодирование передачи.146147#### `class urllib.request.OpenerDirector`148149Класс `OpenerDirector` открывает URL-адреса через цепочку [`BaseHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler). Он управляет объединением обработчиков в цепочку и восстановлением после ошибок.150151#### `class urllib.request.BaseHandler`152153Это базовый класс для всех зарегистрированных обработчиков – он отвечает только за простую механику регистрации.154155#### `class urllib.request.HTTPDefaultErrorHandler`156157Класс, определяющий обработчик по умолчанию для HTTP-ответов с ошибками; все ответы преобразуются в исключения [`HTTPError`](https://python-all.ru/3.13/library/urllib.error.html#urllib.error.HTTPError).158159#### `class urllib.request.HTTPRedirectHandler`160161Класс для обработки перенаправлений.162163#### `class urllib.request.HTTPCookieProcessor(cookiejar=None)`164165Класс для обработки HTTP-куки.166167#### `class urllib.request.ProxyHandler(proxies=None)`168169Заставляет запросы проходить через прокси. Если передан *proxies*, это должен быть словарь, сопоставляющий имена протоколов с URL-адресами прокси. По умолчанию список прокси читается из переменных окружения `<protocol>_proxy`. Если переменные окружения для прокси не заданы, то в среде Windows настройки прокси берутся из раздела Internet Settings реестра, а в среде macOS информация о прокси извлекается из System Configuration Framework.170171Чтобы отключить автоматически обнаруженный прокси, передайте пустой словарь.172173Переменная окружения `no_proxy` может использоваться для указания узлов, к которым не следует обращаться через прокси; если она задана, то должна представлять собой разделённый запятыми список суффиксов имён узлов, опционально с добавленным `:port`, например `cern.ch,ncsa.uiuc.edu,some.host:8080`.174175> **Примечание**176>177> `HTTP_PROXY` будет игнорироваться, если задана переменная `REQUEST_METHOD`; см. документацию по [`getproxies()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.getproxies).178179#### `class urllib.request.HTTPPasswordMgr`180181Хранит базу данных соответствий `(realm, uri) -> (user, password)`.182183#### `class urllib.request.HTTPPasswordMgrWithDefaultRealm`184185Хранит базу данных соответствий `(realm, uri) -> (user, password)`. Область (realm) `None` считается универсальной областью, которая используется, если не подходит ни одна другая.186187#### `class urllib.request.HTTPPasswordMgrWithPriorAuth`188189Вариант [`HTTPPasswordMgrWithDefaultRealm`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPPasswordMgrWithDefaultRealm), который также содержит базу данных соответствий `uri -> is_authenticated`. Может использоваться обработчиком BasicAuth для определения, когда отправлять учётные данные аутентификации немедленно, не дожидаясь сначала ответа `401`.190191Добавлено в версии 3.5.192193#### `class urllib.request.AbstractBasicAuthHandler(password_mgr=None)`194195Это миксин-класс, который помогает с HTTP-аутентификацией как на удалённом хосте, так и через прокси. Если передан *password\_mgr*, он должен быть совместимым с [`HTTPPasswordMgr`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPPasswordMgr); обратитесь к разделу [HTTPPasswordMgr Objects](https://python-all.ru/3.13/library/urllib.request.html#http-password-mgr) для получения информации об интерфейсе, который необходимо поддерживать. Если *passwd\_mgr* также предоставляет методы `is_authenticated` и `update_authenticated` (см. [HTTPPasswordMgrWithPriorAuth Objects](https://python-all.ru/3.13/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 будут автоматически включать учётные данные аутентификации.196197Добавлено в версии 3.5: Добавлена поддержка `is_authenticated`.198199#### `class urllib.request.HTTPBasicAuthHandler(password_mgr=None)`200201Обрабатывает аутентификацию на удалённом хосте. Если передан *password\_mgr*, он должен быть совместим с [`HTTPPasswordMgr`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPPasswordMgr); обратитесь к разделу [HTTPPasswordMgr Objects](https://python-all.ru/3.13/library/urllib.request.html#http-password-mgr) для получения информации об интерфейсе, который необходимо поддерживать. HTTPBasicAuthHandler вызовет [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError) при получении неправильной схемы аутентификации.202203#### `class urllib.request.ProxyBasicAuthHandler(password_mgr=None)`204205Управляет аутентификацией с прокси. *password\_mgr*, если указан, должен быть совместим с [`HTTPPasswordMgr`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPPasswordMgr); обращайтесь к разделу [HTTPPasswordMgr Objects](https://python-all.ru/3.13/library/urllib.request.html#http-password-mgr) за информацией об интерфейсе, который должен поддерживаться.206207#### `class urllib.request.AbstractDigestAuthHandler(password_mgr=None)`208209Это миксин-класс, который помогает с HTTP-аутентификацией как на удалённом хосте, так и через прокси. Если передан *password\_mgr*, он должен быть совместимым с [`HTTPPasswordMgr`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPPasswordMgr); обратитесь к разделу [HTTPPasswordMgr Objects](https://python-all.ru/3.13/library/urllib.request.html#http-password-mgr) для получения информации об интерфейсе, который необходимо поддерживать.210211#### `class urllib.request.HTTPDigestAuthHandler(password_mgr=None)`212213Управляет аутентификацией с удалённым хостом. *password\_mgr*, если указан, должен быть совместим с [`HTTPPasswordMgr`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPPasswordMgr); обращайтесь к разделу [HTTPPasswordMgr Objects](https://python-all.ru/3.13/library/urllib.request.html#http-password-mgr) за информацией об интерфейсе, который должен поддерживаться. Когда добавлены обработчик дайджест-аутентификации (Digest Authentication Handler) и обработчик базовой аутентификации (Basic Authentication Handler), дайджест-аутентификация всегда выполняется первой. Если дайджест-аутентификация снова возвращает ответ 40x, он передаётся обработчику базовой аутентификации. Этот метод обработчика вызовет исключение [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError) при использовании схемы аутентификации, отличной от Digest или Basic.214215Изменено в версии 3.3: Возбуждает исключение [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError) при неподдерживаемой схеме аутентификации.216217#### `class urllib.request.ProxyDigestAuthHandler(password_mgr=None)`218219Управляет аутентификацией с прокси. *password\_mgr*, если указан, должен быть совместим с [`HTTPPasswordMgr`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPPasswordMgr); обращайтесь к разделу [HTTPPasswordMgr Objects](https://python-all.ru/3.13/library/urllib.request.html#http-password-mgr) за информацией об интерфейсе, который должен поддерживаться.220221#### `class urllib.request.HTTPHandler`222223Класс для открытия HTTP-URL.224225#### `class urllib.request.HTTPSHandler(debuglevel=0, context=None, check_hostname=None)`226227Класс для открытия HTTPS-URL. *context* и *check\_hostname* имеют то же значение, что и в [`http.client.HTTPSConnection`](https://python-all.ru/3.13/library/http.client.html#http.client.HTTPSConnection).228229Изменено в версии 3.2: Добавлены параметры *context* и *check\_hostname*.230231#### `class urllib.request.FileHandler`232233Открывает локальные файлы.234235#### `class urllib.request.DataHandler`236237Открывает data-URL.238239Добавлено в версии 3.4.240241#### `class urllib.request.FTPHandler`242243Открывает FTP-URL.244245#### `class urllib.request.CacheFTPHandler`246247Открывает FTP-URL, сохраняя кеш открытых FTP-соединений для минимизации задержек.248249#### `class urllib.request.UnknownHandler`250251Универсальный класс для обработки неизвестных URL.252253#### `class urllib.request.HTTPErrorProcessor`254255Обрабатывает ошибочные HTTP-ответы.256257## Объекты запроса258259Следующие методы описывают открытый интерфейс [`Request`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request), поэтому все они могут быть переопределены в подклассах. Также определяет несколько открытых атрибутов, которые могут использоваться клиентами для анализа разобранного запроса.260261#### `Request.full_url`262263Оригинальный URL, переданный конструктору.264265Изменено в версии 3.4.266267Request.full\_url – это свойство с сеттером, геттером и делитером. При получении `full_url` возвращает оригинальный URL запроса вместе с фрагментом, если он присутствовал.268269#### `Request.type`270271Схема URI.272273#### `Request.host`274275Авторитетная часть URI, обычно хост, но может также содержать порт, отделённый двоеточием.276277#### `Request.origin_req_host`278279Исходный хост запроса, без порта.280281#### `Request.selector`282283Путь URI. Если [`Request`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request) использует прокси, то selector будет содержать полный URL, который передаётся прокси.284285#### `Request.data`286287Тело сущности запроса или `None`, если не задано.288289Изменено в версии 3.4: Изменение значения `Request.data` теперь удаляет заголовок “Content-Length” , если он был ранее установлен или вычислен.290291#### `Request.unverifiable`292293логическое значение, указывает, является ли запрос непроверяемым, как определено в [**RFC 2965**](https://python-all.ru/3.13/library/urllib.request.html).294295#### `Request.method`296297HTTP-метод запроса. По умолчанию его значение равно [`None`](https://python-all.ru/3.13/library/constants.html#None), что означает, что [`get_method()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request.get_method) выполнит обычное вычисление метода. Значение можно задать (тем самым переопределив вычисление по умолчанию в `get_method()`), либо установив значение по умолчанию на уровне класса в подклассе [`Request`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request), либо передав значение в конструктор `Request` через аргумент *method*.298299Добавлено в версии 3.3.300301Изменено в версии 3.4: Теперь значение по умолчанию можно задавать в подклассах; ранее его можно было установить только через аргумент конструктора.302303#### `Request.get_method()`304305Возвращает строку, указывающую HTTP-метод запроса. Если [`Request.method`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request.method) не равно `None`, возвращается его значение; иначе возвращается `'GET'`, если [`Request.data`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request.data) равно `None`, или `'POST'` в противном случае. Это имеет смысл только для HTTP-запросов.306307Изменено в версии 3.3: get\_method теперь учитывает значение [`Request.method`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request.method).308309#### `Request.add_header(key, val)`310311Добавляет ещё один заголовок в запрос. В настоящее время заголовки игнорируются всеми обработчиками, кроме HTTP-обработчиков, где они добавляются в список заголовков, отправляемых серверу. Обратите внимание, что не может быть более одного заголовка с одним и тем же именем, и последующие вызовы перезаписывают предыдущие, если *key* совпадает. В настоящее время это не приводит к потере функциональности HTTP, поскольку все заголовки, которые имеют смысл при многократном использовании, имеют (заголовок-специфичный) способ достижения той же функциональности с помощью только одного заголовка. Обратите внимание, что заголовки, добавленные этим методом, также добавляются в перенаправленные запросы.312313#### `Request.add_unredirected_header(key, header)`314315Добавляет заголовок, который не будет добавлен в перенаправленный запрос.316317#### `Request.has_header(header)`318319Возвращает, имеет ли экземпляр указанный заголовок (проверяет как обычные, так и неперенаправленные).320321#### `Request.remove_header(header)`322323Удаляет указанный заголовок из экземпляра запроса (как из обычных, так и из неперенаправленных заголовков).324325Добавлено в версии 3.4.326327#### `Request.get_full_url()`328329Возвращает URL, переданный в конструктор.330331Изменено в версии 3.4.332333Возвращает [`Request.full_url`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request.full_url)334335#### `Request.set_proxy(host, type)`336337Подготавливает запрос, подключаясь к прокси-серверу. *host* и *type* заменят соответствующие значения экземпляра, а selector экземпляра будет содержать исходный URL, переданный в конструктор.338339#### `Request.get_header(header_name, default=None)`340341Возвращает значение указанного заголовка. Если заголовок отсутствует, возвращает значение по умолчанию.342343#### `Request.header_items()`344345Возвращает список кортежей (имя\_заголовка, значение\_заголовка) заголовков запроса.346347Изменено в версии 3.4:Методы запроса add\_data, has\_data, get\_data, get\_type, get\_host, get\_selector, get\_origin\_req\_host и is\_unverifiable, которые были объявлены устаревшими начиная с версии 3.3, удалены.348349## Объекты OpenerDirector350351Экземпляры [`OpenerDirector`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector) имеют следующие методы:352353#### `OpenerDirector.add_handler(handler)`354355*handler* должен быть экземпляром [`BaseHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler). Поиск осуществляется среди следующих методов, и они добавляются в возможные цепочки (обратите внимание: ошибки HTTP являются особым случаем). Обратите внимание, что в следующих методах *протокол* следует заменить на фактический обрабатываемый протокол, например `http_response()` будет обработчиком ответа протокола HTTP. Кроме того, *type* следует заменить на фактический код HTTP, например `http_error_404()` будет обрабатывать ошибки HTTP 404.356357- `<protocol>_open()` – сигнал о том, что обработчик умеет открывать URL *протокол*.358359  Подробнее см. [`BaseHandler.<protocol>_open()`](https://python-all.ru/3.13/library/urllib.request.html#protocol-open).360- `http_error_<type>()` – сигнал о том, что обработчик умеет обрабатывать ошибки HTTP с кодом ошибки HTTP *type*.361362  Подробнее см. [`BaseHandler.http_error_<nnn>()`](https://python-all.ru/3.13/library/urllib.request.html#http-error-nnn).363- `<protocol>_error()` – сигнал о том, что обработчик умеет обрабатывать ошибки от (не-`http`) *протокол*.364- `<protocol>_request()` – сигнал о том, что обработчик умеет предварительно обрабатывать запросы *протокол*.365366  Подробнее см. [`BaseHandler.<protocol>_request()`](https://python-all.ru/3.13/library/urllib.request.html#protocol-request).367- `<protocol>_response()` – сигнал о том, что обработчик умеет постобрабатывать ответы *протокол*.368369  Подробнее см. [`BaseHandler.<protocol>_response()`](https://python-all.ru/3.13/library/urllib.request.html#protocol-response).370371#### `OpenerDirector.open(url, data=None[, timeout])`372373Открывает указанный *url* (который может быть объектом запроса или строкой), при необходимости передавая указанные *data*. Аргументы, возвращаемые значения и вызываемые исключения такие же, как у [`urlopen()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.urlopen) (который просто вызывает метод `open()` текущего установленного глобального [`OpenerDirector`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector)). Необязательный параметр *timeout* задаёт тайм-аут в секундах для блокирующих операций, таких как попытка подключения (если не указан, будет использоваться глобальная настройка тайм-аута по умолчанию). Функция тайм-аута на самом деле работает только для HTTP, HTTPS и FTP соединений.374375#### `OpenerDirector.error(proto, *args)`376377Обрабатывает ошибку указанного протокола. Вызывает зарегистрированные обработчики ошибок для данного протокола с указанными аргументами (зависящими от протокола). Протокол HTTP является особым случаем: для определения конкретного обработчика ошибок используется код ответа HTTP; обратитесь к методам `http_error_<type>()` классов обработчиков.378379Возвращаемые значения и вызываемые исключения такие же, как у [`urlopen()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.urlopen).380381Объекты OpenerDirector открывают URL в три этапа:382383Порядок вызова этих методов в каждом этапе определяется сортировкой экземпляров обработчиков.3843851. Каждый обработчик, имеющий метод с именем `<protocol>_request()`, вызывает этот метод для предварительной обработки запроса.3862. Обработчики, имеющие метод с именем `<protocol>_open()`, вызываются для обработки запроса. Этот этап завершается, когда обработчик либо возвращает значение, отличное от [`None`](https://python-all.ru/3.13/library/constants.html#None) (т.е. ответ), либо вызывает исключение (обычно [`URLError`](https://python-all.ru/3.13/library/urllib.error.html#urllib.error.URLError)). Исключения могут распространяться дальше.387388   На самом деле, описанный выше алгоритм сначала применяется для методов с именем [`default_open()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler.default_open). Если все такие методы возвращают [`None`](https://python-all.ru/3.13/library/constants.html#None), алгоритм повторяется для методов с именем `<protocol>_open()`. Если все такие методы возвращают `None`, алгоритм повторяется для методов с именем [`unknown_open()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler.unknown_open).389390   Обратите внимание, что реализация этих методов может включать вызовы методов [`open()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector.open) и [`error()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector.error) родительского экземпляра [`OpenerDirector`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector).3913. Каждый обработчик, имеющий метод с именем `<protocol>_response()`, вызывает этот метод для постобработки ответа.392393## Объекты BaseHandler394395Объекты [`BaseHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler) предоставляют несколько методов, которые непосредственно полезны, а также другие методы, предназначенные для использования производными классами. Они предназначены для прямого использования:396397#### `BaseHandler.add_parent(director)`398399Добавляет директор в качестве родителя.400401#### `BaseHandler.close()`402403Удаляет всех родителей.404405Следующие атрибут и методы должны использоваться только классами, производными от [`BaseHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler).406407> **Примечание**408>409> Принято соглашение, что подклассы, определяющие методы `<protocol>_request()` или `<protocol>_response()`, называются `*Processor`; все остальные называются `*Handler`.410411#### `BaseHandler.parent`412413Действительный [`OpenerDirector`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector), который можно использовать для открытия через другой протокол или для обработки ошибок.414415#### `BaseHandler.default_open(req)`416417Этот метод *не* определён в [`BaseHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler), но подклассы должны определить его, если хотят перехватывать все URL.418419Если этот метод реализован, он будет вызван родительским [`OpenerDirector`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector). Он должен возвращать файлоподобный объект, как описано в возвращаемом значении метода [`open()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector.open) класса `OpenerDirector`, или `None`. Он должен вызывать исключение [`URLError`](https://python-all.ru/3.13/library/urllib.error.html#urllib.error.URLError), если не происходит действительно исключительной ситуации (например, [`MemoryError`](https://python-all.ru/3.13/library/exceptions.html#MemoryError) не должен отображаться на `URLError`).420421Этот метод будет вызван перед любым методом открытия, специфичным для протокола.422423#### `BaseHandler.<protocol>_open(req)`424425Этот метод *не* определён в [`BaseHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler), но подклассы должны определить его, если хотят обрабатывать URL с указанным протоколом.426427Если этот метод определён, он будет вызван родительским [`OpenerDirector`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector). Возвращаемые значения должны быть такими же, как для [`default_open()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler.default_open).428429#### `BaseHandler.unknown_open(req)`430431Этот метод *не* определён в [`BaseHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler), но подклассы должны определить его, если хотят перехватывать все URL, для которых нет зарегистрированного обработчика для открытия.432433Если этот метод реализован, он будет вызван [`parent`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler.parent) [`OpenerDirector`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector). Возвращаемые значения должны быть такими же, как для [`default_open()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler.default_open).434435#### `BaseHandler.http_error_default(req, fp, code, msg, hdrs)`436437Этот метод *не* определён в [`BaseHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler), но подклассы должны переопределить его, если они намерены обеспечить всеобъемлющую обработку для иначе необработанных HTTP-ошибок. Он будет автоматически вызван [`OpenerDirector`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector) при получении ошибки и обычно не должен вызываться в других обстоятельствах.438439[`OpenerDirector`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector) вызовет этот метод с пятью позиционными аргументами:4404411. объект [`Request`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request),4422. файлоподобный объект с телом HTTP-ошибки,4433. трёхзначный код ошибки в виде строки,4444. понятное пользователю объяснение кода в виде строки и4455. заголовки ошибки в виде объекта отображения.446447Возвращаемые значения и вызываемые исключения должны быть такими же, как у [`urlopen()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.urlopen).448449#### `BaseHandler.http_error_<nnn>(req, fp, code, msg, hdrs)`450451*nnn* должен быть трёхзначным HTTP-кодом ошибки. Этот метод также не определён в [`BaseHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler), но будет вызван, если он существует, на экземпляре подкласса, когда возникает HTTP-ошибка с кодом *nnn*.452453Подклассы должны переопределить этот метод для обработки конкретных HTTP-ошибок.454455Аргументы, возвращаемые значения и вызываемые исключения должны быть такими же, как для [`http_error_default()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler.http_error_default).456457#### `BaseHandler.<protocol>_request(req)`458459Этот метод *не* определён в [`BaseHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler), но подклассы должны определить его, если хотят предварительно обрабатывать запросы заданного протокола.460461Если этот метод определён, он будет вызван родительским [`OpenerDirector`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector). *req* будет объектом [`Request`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request). Возвращаемое значение должно быть объектом `Request`.462463#### `BaseHandler.<protocol>_response(req, response)`464465Этот метод *не* определён в [`BaseHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler), но подклассы должны определить его, если хотят выполнять постобработку ответов заданного протокола.466467Этот метод, если он определён, будет вызван родительским [`OpenerDirector`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector). *req* будет объектом [`Request`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request). *response* будет объектом, реализующим тот же интерфейс, что и возвращаемое значение [`urlopen()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.urlopen). Возвращаемое значение должно реализовывать тот же интерфейс, что и возвращаемое значение `urlopen()`.468469## Объекты HTTPRedirectHandler470471> **Примечание**472>473> Некоторые HTTP-перенаправления требуют действий от клиентского кода этого модуля. В таком случае возбуждается [`HTTPError`](https://python-all.ru/3.13/library/urllib.error.html#urllib.error.HTTPError). См. [**RFC 2616**](https://python-all.ru/3.13/library/urllib.request.html) для подробностей о точном значении различных кодов перенаправления.474>475> Исключение [`HTTPError`](https://python-all.ru/3.13/library/urllib.error.html#urllib.error.HTTPError), возбуждаемое по соображениям безопасности, если HTTPRedirectHandler получает URL перенаправления, который не является HTTP, HTTPS или FTP URL.476477#### `HTTPRedirectHandler.redirect_request(req, fp, code, msg, hdrs, newurl)`478479Возвращает [`Request`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request) или `None` в ответ на перенаправление. Этот метод вызывается реализациями по умолчанию методов `http_error_30*()`, когда от сервера получено перенаправление. Если перенаправление должно произойти, верните новый `Request`, чтобы `http_error_30*()` смог выполнить перенаправление на *newurl*. В противном случае возбудите [`HTTPError`](https://python-all.ru/3.13/library/urllib.error.html#urllib.error.HTTPError), если никакой другой обработчик не должен пытаться обработать этот URL, или верните `None`, если вы не можете, но другой обработчик смог бы.480481> **Примечание**482>483> Реализация по умолчанию этого метода не следует строго [**RFC 2616**](https://python-all.ru/3.13/library/urllib.request.html), который говорит, что ответы 301 и 302 на запросы `POST` не должны автоматически перенаправляться без подтверждения пользователем. В действительности браузеры разрешают автоматическое перенаправление таких ответов, меняя POST на `GET`, и реализация по умолчанию воспроизводит такое поведение.484485#### `HTTPRedirectHandler.http_error_301(req, fp, code, msg, hdrs)`486487Перенаправляет на URL `Location:` или `URI:`. Этот метод вызывается родительским [`OpenerDirector`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector) при получении HTTP-ответа «Moved Permanently».488489#### `HTTPRedirectHandler.http_error_302(req, fp, code, msg, hdrs)`490491То же, что и [`http_error_301()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPRedirectHandler.http_error_301), но вызывается для ответа «Found».492493#### `HTTPRedirectHandler.http_error_303(req, fp, code, msg, hdrs)`494495То же, что и [`http_error_301()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPRedirectHandler.http_error_301), но вызывается для ответа «See Other».496497#### `HTTPRedirectHandler.http_error_307(req, fp, code, msg, hdrs)`498499То же, что и [`http_error_301()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPRedirectHandler.http_error_301), но вызывается для ответа «Temporary Redirect». Не разрешает изменять метод запроса с `POST` на `GET`.500501#### `HTTPRedirectHandler.http_error_308(req, fp, code, msg, hdrs)`502503То же, что и [`http_error_301()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPRedirectHandler.http_error_301), но вызывается для ответа «Permanent Redirect». Не разрешает изменять метод запроса с `POST` на `GET`.504505Добавлено в версии 3.12.506507## Объекты HTTPCookieProcessor508509Экземпляры [`HTTPCookieProcessor`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPCookieProcessor) имеют один атрибут:510511#### `HTTPCookieProcessor.cookiejar`512513[`http.cookiejar.CookieJar`](https://python-all.ru/3.13/library/http.cookiejar.html#http.cookiejar.CookieJar), в котором хранятся куки.514515## Объекты ProxyHandler516517#### `ProxyHandler.<protocol>_open(request)`518519Объект [`ProxyHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.ProxyHandler) будет иметь метод `<protocol>_open()` для каждого *протокол*, для которого есть прокси в словаре *proxies*, переданном в конструктор. Метод будет изменять запросы для прохождения через прокси, вызывая `request.set_proxy()`, и вызывать следующий обработчик в цепочке для непосредственного выполнения протокола.520521## Объекты HTTPPasswordMgr522523Эти методы доступны у объектов [`HTTPPasswordMgr`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPPasswordMgr) и [`HTTPPasswordMgrWithDefaultRealm`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPPasswordMgrWithDefaultRealm).524525#### `HTTPPasswordMgr.add_password(realm, uri, user, passwd)`526527*uri* может быть как одним URI, так и последовательностью URI. *realm*, *user* и *passwd* должны быть строками. В результате `(user, passwd)` будет использоваться в качестве токенов аутентификации, когда запрашивается аутентификация для *realm* и супер-URI любого из заданных URI.528529#### `HTTPPasswordMgr.find_user_password(realm, authuri)`530531Получает имя пользователя/пароль для заданных realm и URI, если они есть. Этот метод вернёт `(None, None)`, если нет соответствующей пары пользователь/пароль.532533Для объектов [`HTTPPasswordMgrWithDefaultRealm`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPPasswordMgrWithDefaultRealm) область `None` будет проверена, если заданная *realm* не имеет соответствующей пары пользователь/пароль.534535## Объекты HTTPPasswordMgrWithPriorAuth536537Этот менеджер паролей расширяет [`HTTPPasswordMgrWithDefaultRealm`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPPasswordMgrWithDefaultRealm), чтобы поддерживать отслеживание URI, для которых учётные данные аутентификации должны всегда отправляться.538539#### `HTTPPasswordMgrWithPriorAuth.add_password(realm, uri, user, passwd, is_authenticated=False)`540541*realm*, *uri*, *user*, *passwd* – как и для [`HTTPPasswordMgr.add_password()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPPasswordMgr.add_password). *is\_authenticated* устанавливает начальное значение флага `is_authenticated` для указанного URI или списка URI. Если *is\_authenticated* указан как `True`, *realm* игнорируется.542543#### `HTTPPasswordMgrWithPriorAuth.find_user_password(realm, authuri)`544545То же, что и для объектов [`HTTPPasswordMgrWithDefaultRealm`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPPasswordMgrWithDefaultRealm)546547#### `HTTPPasswordMgrWithPriorAuth.update_authenticated(self, uri, is_authenticated=False)`548549Обновляет флаг `is_authenticated` для указанного *uri* или списка URI.550551#### `HTTPPasswordMgrWithPriorAuth.is_authenticated(self, authuri)`552553Возвращает текущее состояние флага `is_authenticated` для указанного URI.554555## Объекты AbstractBasicAuthHandler556557#### `AbstractBasicAuthHandler.http_error_auth_reqed(authreq, host, req, headers)`558559Обрабатывает запрос аутентификации, получая пару пользователь/пароль и повторяя запрос. *authreq* должен быть именем заголовка, в котором содержится информация о realm в запросе, *host* указывает URL и путь для аутентификации, *req* должен быть (неудачным) объектом [`Request`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request), а *headers* – заголовками ошибки.560561*host* – это либо authority (например, `"python.org"`), либо URL, содержащий компонент authority (например, `"https://python.org/"`). В любом случае, authority не должен содержать компонент userinfo (поэтому `"python.org"` и `"python.org:80"` подходят, а `"joe:password@python.org"` – нет).562563## Объекты HTTPBasicAuthHandler564565#### `HTTPBasicAuthHandler.http_error_401(req, fp, code, msg, hdrs)`566567Повторяет запрос с информацией аутентификации, если она доступна.568569## Объекты ProxyBasicAuthHandler570571#### `ProxyBasicAuthHandler.http_error_407(req, fp, code, msg, hdrs)`572573Повторяет запрос с информацией аутентификации, если она доступна.574575## Объекты AbstractDigestAuthHandler576577#### `AbstractDigestAuthHandler.http_error_auth_reqed(authreq, host, req, headers)`578579*authreq* должен быть именем заголовка, в котором содержится информация о realm в запросе, *host* должен быть хостом для аутентификации, *req* должен быть (неудачным) объектом [`Request`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request), а *headers* – заголовками ошибки.580581## Объекты HTTPDigestAuthHandler582583#### `HTTPDigestAuthHandler.http_error_401(req, fp, code, msg, hdrs)`584585Повторяет запрос с информацией аутентификации, если она доступна.586587## Объекты ProxyDigestAuthHandler588589#### `ProxyDigestAuthHandler.http_error_407(req, fp, code, msg, hdrs)`590591Повторяет запрос с информацией аутентификации, если она доступна.592593## Объекты HTTPHandler594595#### `HTTPHandler.http_open(req)`596597Отправляет HTTP-запрос, который может быть GET или POST, в зависимости от `req.data`.598599## Объекты HTTPSHandler600601#### `HTTPSHandler.https_open(req)`602603Отправляет HTTPS-запрос, который может быть GET или POST, в зависимости от `req.data`.604605## Объекты FileHandler606607#### `FileHandler.file_open(req)`608609Открывает файл локально, если имя хоста отсутствует или равно `'localhost'`.610611Изменено в версии 3.2: Этот метод применим только для локальных имён хостов. При указании удалённого имени хоста вызывается исключение [`URLError`](https://python-all.ru/3.13/library/urllib.error.html#urllib.error.URLError).612613## Объекты DataHandler614615#### `DataHandler.data_open(req)`616617Читает data URL. Такой URL содержит содержимое, закодированное непосредственно в самом URL. Синтаксис data URL описан в [**RFC 2397**](https://python-all.ru/3.13/library/urllib.request.html). Эта реализация игнорирует пробелы в data URL с base64-кодированием, поэтому URL может быть перенесён в любом исходном файле, откуда он берётся. Но даже если некоторые браузеры не обращают внимания на отсутствие дополнения (padding) в конце base64-кодированного data URL, данная реализация в таком случае вызовет исключение [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError).618619## Объекты FTPHandler620621#### `FTPHandler.ftp_open(req)`622623Открывает FTP-файл, указанный *req*. Вход всегда выполняется с пустыми именем пользователя и паролем.624625## Объекты CacheFTPHandler626627Объекты [`CacheFTPHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.CacheFTPHandler) являются объектами [`FTPHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.FTPHandler) со следующими дополнительными методами:628629#### `CacheFTPHandler.setTimeout(t)`630631Устанавливает тайм-аут соединений равным *t* секунд.632633#### `CacheFTPHandler.setMaxConns(m)`634635Устанавливает максимальное количество кэшированных соединений равным *m*.636637## Объекты UnknownHandler638639#### `UnknownHandler.unknown_open()`640641Вызывает исключение [`URLError`](https://python-all.ru/3.13/library/urllib.error.html#urllib.error.URLError).642643## Объекты HTTPErrorProcessor644645#### `HTTPErrorProcessor.http_response(request, response)`646647Обрабатывает ошибочные HTTP-ответы.648649Для кода 200 объект ответа возвращается немедленно.650651Для кодов ошибок, отличных от 200, этот метод просто передаёт задачу методам обработчика `http_error_<type>()` через [`OpenerDirector.error()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector.error). В конечном счёте, [`HTTPDefaultErrorHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPDefaultErrorHandler) вызовет исключение [`HTTPError`](https://python-all.ru/3.13/library/urllib.error.html#urllib.error.HTTPError), если ни один другой обработчик не обработает ошибку.652653#### `HTTPErrorProcessor.https_response(request, response)`654655Обрабатывает ошибочные HTTPS-ответы.656657Поведение аналогично [`http_response()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.HTTPErrorProcessor.http_response).658659## Примеры660661В дополнение к примерам ниже, больше примеров приведено в [HOWTO Fetch Internet Resources Using The urllib Package](https://python-all.ru/3.13/howto/urllib2.html#urllib-howto).662663Этот пример получает главную страницу python.org и отображает первые 300 байт.664665```python666>>> import urllib.request667>>> with urllib.request.urlopen('https://www.python.org/') as f:668...     # Ответ может быть сжат (например, 'gzip').669...     print(f.headers.get('Content-Encoding'))670...     data = f.read()671...     if f.headers.get('Content-Encoding') == 'gzip':672...         import gzip673...         data = gzip.decompress(data)674...     print(data[:300].decode('utf-8', errors='replace'))675```676677Обратите внимание, что urlopen возвращает объект bytes. Это связано с тем, что urlopen не может автоматически определить кодировку байтового потока, полученного от HTTP-сервера. Как правило, программа декодирует возвращённый объект bytes в строку, как только определит или угадает подходящую кодировку.678679В следующем документе спецификации HTML, [https://html.spec.whatwg.org/#charset](https://python-all.ru/3.13/library/urllib.request.html), перечислены различные способы указания информации о кодировке в HTML- или XML-документе.680681Дополнительную информацию см. в документе W3C: [https://www.w3.org/International/questions/qa-html-encoding-declarations](https://python-all.ru/3.13/library/urllib.request.html).682683Поскольку на сайте python.org используется кодировка *utf-8*, как указано в его мета-теге, мы будем использовать её же для декодирования байтового объекта:684685```python686>>> with urllib.request.urlopen('https://www.python.org/') as f:687...     # Проверить сжатие и декодировать соответствующим образом.688...     enc = f.headers.get('Content-Encoding')689...     data = f.read()690...     if enc == 'gzip':691...         import gzip692...         data = gzip.decompress(data)693...     print(data[:100].decode('utf-8', errors='replace'))694...695```696697Тот же результат можно получить и без использования подхода [контекстного менеджера](https://python-all.ru/3.13/glossary.html#term-context-manager):698699```python700>>> import urllib.request701>>> f = urllib.request.urlopen('https://www.python.org/')702>>> try:703...     enc = f.headers.get('Content-Encoding')704...     data = f.read()705...     if enc == 'gzip':706...         import gzip707...         data = gzip.decompress(data)708...     print(data[:100].decode('utf-8', errors='replace'))709... finally:710...     f.close()711```712713В следующем примере мы отправляем поток данных на стандартный ввод CGI и читаем данные, которые он возвращает. Обратите внимание: этот пример будет работать только в том случае, если установка Python поддерживает SSL.714715```python716>>> import urllib.request717>>> req = urllib.request.Request(url='https://localhost/cgi-bin/test.cgi',718...                       data=b'This data is passed to stdin of the CGI')719>>> with urllib.request.urlopen(req) as f:720...     print(f.read().decode('utf-8'))721...722Got Data: "This data is passed to stdin of the CGI"723```724725Код образца CGI, использованного в приведённом выше примере:726727```python728#!/usr/bin/env python729import sys730data = sys.stdin.read()731print('Content-type: text/plain\n\nGot Data: "%s"' % data)732```733734Вот пример выполнения запроса `PUT` с помощью [`Request`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request):735736```python737import urllib.request738DATA = b'some data'739req = urllib.request.Request(url='http://localhost:8080', data=DATA, method='PUT')740with urllib.request.urlopen(req) as f:741    pass742print(f.status)743print(f.reason)744```745746Использование базовой HTTP-аутентификации:747748```python749import urllib.request750# Создать OpenerDirector с поддержкой базовой HTTP-аутентификации...751auth_handler = urllib.request.HTTPBasicAuthHandler()752auth_handler.add_password(realm='PDQ Application',753                          uri='https://mahler:8092/site-updates.py',754                          user='klem',755                          passwd='kadidd!ehopper')756opener = urllib.request.build_opener(auth_handler)757# ...и установить его глобально, чтобы его можно было использовать с urlopen.758urllib.request.install_opener(opener)759with urllib.request.urlopen('http://www.example.com/login.html') as f:760    print(f.read().decode('utf-8'))761```762763[`build_opener()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.build_opener) предоставляет множество обработчиков по умолчанию, включая [`ProxyHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.ProxyHandler). По умолчанию `ProxyHandler` использует переменные окружения с именами `<scheme>_proxy`, где `<scheme>` – это используемая схема URL. Например, переменная окружения `http_proxy` читается для получения URL HTTP-прокси.764765Этот пример заменяет обработчик по умолчанию [`ProxyHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.ProxyHandler) на тот, который использует программно заданные URL прокси, и добавляет поддержку авторизации прокси с помощью [`ProxyBasicAuthHandler`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.ProxyBasicAuthHandler).766767```python768proxy_handler = urllib.request.ProxyHandler({'http': 'http://www.example.com:3128/'})769proxy_auth_handler = urllib.request.ProxyBasicAuthHandler()770proxy_auth_handler.add_password('realm', 'host', 'username', 'password')771772opener = urllib.request.build_opener(proxy_handler, proxy_auth_handler)773# На этот раз, вместо установки OpenerDirector, используется напрямую:774with opener.open('http://www.example.com/login.html') as f:775   print(f.read().decode('utf-8'))776```777778Добавление HTTP-заголовков:779780Используйте аргумент *headers* конструктора [`Request`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request) или:781782```python783import urllib.request784req = urllib.request.Request('http://www.example.com/')785req.add_header('Referer', 'https://www.python.org/')786# Настроить значение заголовка User-Agent по умолчанию:787req.add_header('User-Agent', 'urllib-example/0.1 (Contact: . . .)')788with urllib.request.urlopen(req) as f:789    print(f.read().decode('utf-8'))790```791792[`OpenerDirector`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector) автоматически добавляет заголовок *User-Agent* к каждому запросу [`Request`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request). Чтобы изменить это:793794```python795import urllib.request796opener = urllib.request.build_opener()797opener.addheaders = [('User-agent', 'Mozilla/5.0')]798with opener.open('http://www.example.com/') as f:799   print(f.read().decode('utf-8'))800```801802Также помните, что несколько стандартных заголовков (*Content-Length*, *Content-Type* и *Host*) добавляются, когда [`Request`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.Request) передаётся в [`urlopen()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.urlopen) (или [`OpenerDirector.open()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.OpenerDirector.open)).803804Вот пример сеанса, в котором используется метод `GET` для получения URL с параметрами:805806```python807>>> import urllib.request808>>> import urllib.parse809>>> params = urllib.parse.urlencode({'spam': 1, 'eggs': 2, 'bacon': 0})810>>> url = "https://www.python.org/?%s" % params811>>> with urllib.request.urlopen(url) as f:812...     print(f.read().decode('utf-8'))813...814```815816В следующем примере вместо этого используется метод `POST`. Обратите внимание, что вывод параметров из urlencode кодируется в байты перед отправкой в urlopen в качестве данных:817818```python819>>> import urllib.request820>>> import urllib.parse821>>> data = urllib.parse.urlencode({'spam': 1, 'eggs': 2, 'bacon': 0})822>>> data = data.encode('ascii')823>>> with urllib.request.urlopen("https://httpbin.org/post", data) as f:824...     print(f.read().decode('utf-8'))825...826```827828В следующем примере используется явно указанный HTTP-прокси, переопределяющий настройки окружения:829830```python831>>> import urllib.request832>>> proxies = {'http': 'http://proxy.example.com:8080/'}833>>> opener = urllib.request.build_opener(urllib.request.ProxyHandler(proxies))834>>> with opener.open("https://www.python.org") as f:835...     f.read().decode('utf-8')836...837```838839В следующем примере прокси не используются вовсе, переопределяя настройки окружения:840841```python842>>> import urllib.request843>>> opener = urllib.request.build_opener(urllib.request.ProxyHandler({}))844>>> with opener.open("https://www.python.org/") as f:845...     f.read().decode('utf-8')846...847```848849## Устаревший интерфейс850851Следующие функции и классы перенесены из модуля Python 2 `urllib` (в отличие от `urllib2`). В будущем они могут стать устаревшими.852853#### `urllib.request.urlretrieve(url, filename=None, reporthook=None, data=None)`854855Копирует сетевой объект, заданный URL, в локальный файл. Если URL указывает на локальный файл, объект не будет скопирован, если не указан filename. Возвращает кортеж `(filename, headers)`, где *filename* – это имя локального файла, под которым можно найти объект, а *headers* – то, что вернул метод `info()` объекта, возвращённого [`urlopen()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.urlopen) (для удалённого объекта). Исключения те же, что и для `urlopen()`.856857Второй аргумент, если присутствует, задаёт местоположение файла для копирования (если отсутствует, местоположением будет временный файл с автоматически сгенерированным именем). Третий аргумент, если присутствует, является вызываемым объектом, который будет вызван один раз при установлении сетевого соединения и один раз после каждого последующего чтения блока. Вызываемый объект будет получать три аргумента: количество переданных блоков на данный момент, размер блока в байтах и общий размер файла. Третий аргумент может быть `-1` на старых FTP-серверах, которые не возвращают размер файла в ответ на запрос получения.858859Следующий пример иллюстрирует наиболее распространённый сценарий использования:860861```python862>>> import urllib.request863>>> local_filename, headers = urllib.request.urlretrieve('https://python.org/')864>>> html = open(local_filename)865>>> html.close()866```867868Если *url* использует идентификатор схемы `http:`, необязательный аргумент *data* может быть передан для указания запроса `POST` (обычно тип запроса – `GET`). Аргумент *data* должен быть байтовым объектом в стандартном формате *application/x-www-form-urlencoded*; см. функцию [`urllib.parse.urlencode()`](https://python-all.ru/3.13/library/urllib.parse.html#urllib.parse.urlencode).869870`urlretrieve()` вызовет исключение [`ContentTooShortError`](https://python-all.ru/3.13/library/urllib.error.html#urllib.error.ContentTooShortError), когда обнаружит, что объём доступных данных меньше ожидаемого (который указан в заголовке *Content-Length*). Это может произойти, например, при прерывании загрузки.871872Заголовок *Content-Length* рассматривается как нижняя граница: если доступно больше данных для чтения, urlretrieve читает больше данных, но если данных меньше, он вызывает исключение.873874В этом случае вы всё ещё можете получить загруженные данные, они хранятся в атрибуте `content` экземпляра исключения.875876Если заголовок *Content-Length* не был передан, urlretrieve не может проверить размер загруженных данных и просто возвращает их. В этом случае остаётся только предполагать, что загрузка прошла успешно.877878#### `urllib.request.urlcleanup()`879880Очищает временные файлы, которые могли остаться от предыдущих вызовов [`urlretrieve()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.urlretrieve).881882#### `class urllib.request.URLopener(proxies=None, **x509)`883884Устарело с версии 3.3.885886Базовый класс для открытия и чтения URL. Если не требуется поддержка открытия объектов с использованием схем, отличных от `http:`, `ftp:` или `file:`, вероятно, стоит использовать [`FancyURLopener`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.FancyURLopener).887888По умолчанию класс `URLopener` отправляет заголовок *User-Agent* со значением `urllib/VVV`, где *VVV* – это номер версии [`urllib`](https://python-all.ru/3.13/library/urllib.html#module-urllib). Приложения могут задать собственный заголовок *User-Agent*, создав подкласс `URLopener` или [`FancyURLopener`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.FancyURLopener) и установив атрибут класса [`version`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.URLopener.version) в соответствующее строковое значение в определении подкласса.889890Необязательный параметр *proxies* должен быть словарём, сопоставляющим имена схем с URL прокси. Пустой словарь полностью отключает прокси. Значение по умолчанию – `None`; в этом случае используются настройки прокси из окружения (если они есть), как описано выше в определении [`urlopen()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.urlopen).891892Дополнительные именованные параметры, собранные в *x509*, могут использоваться для аутентификации клиента при использовании схемы `https:`. Поддерживаются ключевые слова *key\_file* и *cert\_file* для указания SSL-ключа и сертификата; оба необходимы для поддержки аутентификации клиента.893894Объекты `URLopener` возбуждают исключение [`OSError`](https://python-all.ru/3.13/library/exceptions.html#OSError), если сервер возвращает код ошибки.895896#### `open(fullurl, data=None)`897898Открывает *fullurl*, используя соответствующий протокол. Этот метод настраивает кеш и информацию о прокси, а затем вызывает соответствующий метод open с переданными аргументами. Если схема не распознана, вызывается [`open_unknown()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.URLopener.open_unknown). Аргумент *data* имеет то же значение, что и аргумент *data* метода [`urlopen()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.urlopen).899900Этот метод всегда экранирует *fullurl* с помощью [`quote()`](https://python-all.ru/3.13/library/urllib.parse.html#urllib.parse.quote).901902#### `open_unknown(fullurl, data=None)`903904Переопределяемый интерфейс для открытия неизвестных типов URL.905906#### `retrieve(url, filename=None, reporthook=None, data=None)`907908Извлекает содержимое *url* и помещает его в *filename*. Возвращаемое значение – кортеж из локального имени файла и либо объекта [`email.message.Message`](https://python-all.ru/3.13/library/email.compat32-message.html#email.message.Message), содержащего заголовки ответа (для удалённых URL), либо `None` (для локальных URL). После этого вызывающий код должен открыть и прочитать содержимое *filename*. Если *filename* не указан и URL ссылается на локальный файл, возвращается имя входного файла. Если URL не является локальным и *filename* не указан, имя файла формируется вызовом [`tempfile.mktemp()`](https://python-all.ru/3.13/library/tempfile.html#tempfile.mktemp) с суффиксом, соответствующим суффиксу последнего компонента пути входного URL. Если передан *reporthook*, это должна быть функция, принимающая три числовых параметра: номер чанка, максимальный размер читаемых чанков и общий размер загрузки (-1, если неизвестен). Она будет вызвана один раз в начале и после каждого чтения чанка данных из сети. Для локальных URL параметр *reporthook* игнорируется.909910Если *url* использует идентификатор схемы `http:`, можно указать необязательный аргумент *data* для задания `POST`-запроса (обычно тип запроса – `GET`). Аргумент *data* должен быть в стандартном формате *application/x-www-form-urlencoded*; см. функцию [`urllib.parse.urlencode()`](https://python-all.ru/3.13/library/urllib.parse.html#urllib.parse.urlencode).911912#### `version`913914Переменная, задающая пользовательский агент объекта opener. Чтобы [`urllib`](https://python-all.ru/3.13/library/urllib.html#module-urllib) сообщал серверам, что он является определённым пользовательским агентом, установите это значение в подклассе как переменную класса или в конструкторе перед вызовом конструктора базового класса.915916#### `class urllib.request.FancyURLopener(...)`917918Устарело с версии 3.3.919920`FancyURLopener` является подклассом [`URLopener`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.URLopener), обеспечивающим стандартную обработку следующих HTTP-кодов ответа: 301, 302, 303, 307 и 401. Для перечисленных кодов 30x используется заголовок *Location* для получения фактического URL. Для кода 401 (требуется аутентификация) выполняется базовая HTTP-аутентификация. Для кодов 30x количество рекурсий ограничено значением атрибута *maxtries*, которое по умолчанию равно 10.921922Для всех остальных кодов ответа вызывается метод [`http_error_default()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.BaseHandler.http_error_default), который можно переопределить в подклассах для соответствующей обработки ошибки.923924> **Примечание**925>926> В соответствии с буквой [**RFC 2616**](https://python-all.ru/3.13/library/urllib.request.html), ответы 301 и 302 на POST-запросы не должны автоматически перенаправляться без подтверждения пользователем. На практике браузеры всё же допускают автоматическое перенаправление таких ответов, заменяя POST на GET, и [`urllib`](https://python-all.ru/3.13/library/urllib.html#module-urllib) воспроизводит это поведение.927928Параметры конструктора такие же, как для [`URLopener`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.URLopener).929930> **Примечание**931>932> При выполнении базовой аутентификации экземпляр `FancyURLopener` вызывает свой метод [`prompt_user_passwd()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.FancyURLopener.prompt_user_passwd). Реализация по умолчанию запрашивает у пользователя необходимую информацию на управляющем терминале. Подкласс может переопределить этот метод для обеспечения более подходящего поведения, если это необходимо.933934Класс `FancyURLopener` предоставляет один дополнительный метод, который следует перегрузить для обеспечения соответствующего поведения:935936#### `prompt_user_passwd(host, realm)`937938Возвращает информацию, необходимую для аутентификации пользователя на указанном хосте в заданной области безопасности. Возвращаемое значение должно быть кортежем `(user, password)`, который можно использовать для базовой аутентификации.939940Реализация запрашивает эту информацию на терминале; приложение должно переопределить этот метод, чтобы использовать подходящую модель взаимодействия в локальной среде.941942## Ограничения `urllib.request`943944- В настоящее время поддерживаются только следующие протоколы: HTTP (версии 0.9 и 1.0), FTP, локальные файлы и data-URL.945946  Изменено в версии 3.4: Добавлена поддержка data-URL.947- Функция кэширования [`urlretrieve()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.urlretrieve) отключена, пока не будет реализована правильная обработка заголовков Expiration time.948- Должна быть функция для проверки, находится ли определённый URL в кэше.949- Для обратной совместимости, если URL указывает на локальный файл, но файл не удаётся открыть, URL интерпретируется заново с использованием протокола FTP. Это иногда может приводить к запутанным сообщениям об ошибках.950- Функции [`urlopen()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.urlopen) и [`urlretrieve()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.urlretrieve) могут вызывать сколь угодно длительные задержки при ожидании установки сетевого соединения. Это означает, что создать интерактивный веб-клиент с помощью этих функций без использования потоков сложно.951- Данные, возвращаемые [`urlopen()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.urlopen) или [`urlretrieve()`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.urlretrieve), представляют собой необработанные данные, возвращённые сервером. Это могут быть бинарные данные (например, изображение), обычный текст или, к примеру, HTML. Протокол HTTP передаёт информацию о типе в заголовке ответа, который можно проверить, взглянув на заголовок *Content-Type*. Если возвращённые данные являются HTML, можно использовать модуль [`html.parser`](https://python-all.ru/3.13/library/html.parser.html#module-html.parser) для его разбора.952- Код, обрабатывающий протокол FTP, не может различить файл и каталог. Это может привести к неожиданному поведению при попытке чтения URL, указывающего на недоступный файл. Если URL заканчивается на `/`, предполагается, что он ссылается на каталог, и будет обработан соответствующим образом. Но если попытка чтения файла приводит к ошибке 550 (означает, что URL не найден или недоступен, часто из-за прав доступа), то путь рассматривается как каталог, чтобы обработать случай, когда каталог указан URL, но завершающий `/` опущен. Это может привести к вводящим в заблуждение результатам при попытке получить файл, права на чтение которого делают его недоступным; FTP-код попытается прочитать его, завершится ошибкой 550, а затем выполнит вывод списка каталога для этого недоступного файла. Если требуется тонкий контроль, стоит рассмотреть использование модуля [`ftplib`](https://python-all.ru/3.13/library/ftplib.html#module-ftplib), создание подкласса [`FancyURLopener`](https://python-all.ru/3.13/library/urllib.request.html#urllib.request.FancyURLopener) или изменение *\_urlopener* в соответствии со своими потребностями.953954# `urllib.response` – Классы ответов, используемые urllib955956Модуль `urllib.response` определяет функции и классы, которые предоставляют минимальный файлоподобный интерфейс, включая `read()` и `readline()`. Функции, определённые в этом модуле, используются внутри модуля [`urllib.request`](https://python-all.ru/3.13/library/urllib.request.html#module-urllib.request). Типичный объект ответа – экземпляр [`urllib.response.addinfourl`](https://python-all.ru/3.13/library/urllib.request.html#urllib.response.addinfourl):957958#### `class urllib.response.addinfourl`959960#### `url`961962URL полученного ресурса, обычно используется для определения, был ли выполнен редирект.963964#### `headers`965966Возвращает заголовки ответа в виде экземпляра [`EmailMessage`](https://python-all.ru/3.13/library/email.message.html#email.message.EmailMessage).967968#### `status`969970Добавлено в версии 3.9.971972Код состояния, возвращаемый сервером.973974#### `geturl()`975976Устарело с версии 3.9: Устарело в пользу [`url`](https://python-all.ru/3.13/library/urllib.request.html#urllib.response.addinfourl.url).977978#### `info()`979980Устарело с версии 3.9: Устарело в пользу [`headers`](https://python-all.ru/3.13/library/urllib.request.html#urllib.response.addinfourl.headers).981982#### `code`983984Устарело с версии 3.9: Устарело в пользу [`status`](https://python-all.ru/3.13/library/urllib.request.html#urllib.response.addinfourl.status).985986#### `getcode()`987988Устарело с версии 3.9: Устарело в пользу [`status`](https://python-all.ru/3.13/library/urllib.request.html#urllib.response.addinfourl.status).989