Функция install_opener() модуля urllib.request в Python

Установка глобального обработчика URL-адреса

Синтаксис:

import urllib.request

urllib.request.install_opener(opener)

Параметры:

• opener - экземпляр OpenerDirector.

Описание:

Функция install_opener() модуля urllib.request устанавливает экземпляр OpenerDirector в качестве глобального средства открытия URL-адреса по умолчанию.

Установка открывателя OpenerDirector нужна только в том случае, если необходимо, чтобы функция urllib.request.urlopen() использовала его. В противном случае можно просто вызвать OpenerDirector.open() вместо urllib.request.urlopen().

Код не будет проверять наличие реального экземпляра обработчика открытия URL-адреса OpenerDirector, соответственно будет работать любой класс с соответствующим интерфейсом.

Пример использования urllib.request.install_opener():

В примере функция urllib.request.install_opener() устанавливает экземпляр auth_handler в качестве глобального средства открытия URL-адреса для базовой HTTP-аутентификации:

import urllib.request
# Создаем экземпляр `OpenerDirector` с поддержкой 
# базовой HTTP-аутентификации ...
auth_handler = urllib.request.HTTPBasicAuthHandler()
auth_handler.add_password(realm='PDQ Application',
                          uri='https://mahler:8092/site-updates.py',
                          user='klem',
                          passwd='kadidd!ehopper')
opener = urllib.request.build_opener(auth_handler)
# Установим `auth_handler` глобально, чтобы его можно 
# было использовать с функцией `urlopen()`.
urllib.request.install_opener(opener)
urllib.request.urlopen('http://www.example.com/login.html')