urllib3

urllib3 е Python HTTP библиотека с резба-безопасно свързване обединяване и файл пост подкрепа.
<силни> Акценти:
& Nbsp; * Re-използват една и съща връзка гнездо за няколко заявки (HTTPConnectionPool)
& Nbsp; * File командироване (encode_multipart_formdata)
& Nbsp; * Вградени пренасочване и повторения (по желание)
& Nbsp; * Тема-безопасен
<Силен> Какво не е наред с urllib и urllib2?
Има две важни функции липсват от стандартната библиотека Python: Connection повторно използване / обединяване и файл командироване. Това не е ужасно трудно да се приложат тези себе си, но това е много по-лесно да се използва модул, който вече е направил това вместо Вас.
Питонът стандартни библиотеки urllib и urllib2 имат малко общо помежду си. Те са били предназначени да бъдат независими и самостоятелни, всяка решаване различен обхват от проблеми, и urllib3 следва в същия дух.
<Силен> Защо искам да се използва повече връзки?
Изпълнение. Когато обикновено правя на urllib повикване, отделна връзка гнездо е създаден с всяка заявка. Чрез повторно използване на съществуващи контакти (подкрепяни от HTTP 1.1), заявките ще заемат по-малко ресурси за край на сървъра, както и възможности за по-бързо време за реакция в края на клиента. С няколко прости критерии (вж тест / benchmark.py), сваляне на 15 URL адреси от google.com е около два пъти по-бързо, когато се използва HTTPConnectionPool (който използва 1 връзка), отколкото с обикновена urllib (която използва 15 връзки).
Тази библиотека е идеална за:
& Nbsp; * Да говориш на API
& Nbsp; * Индексиране на уебсайт
& Nbsp; * Всяка ситуация, в която е в състояние да публикувате файлове, да се занимават пренасочване, както и да опитате отново е полезно. Това е относително лек, така че може да се използва за нищо!
<силни> Примери:
Отиди в Примери уикито за повече хубави синтактични-подчертани примери.
Но, дълга история кратко:
от urllib3 внос HTTPConnectionPool
API_URL = "http://ajax.googleapis.com/ajax/services/search/web"
http_pool = HTTPConnectionPool.from_url (API_URL)
полета = {"V": "1.0", "Q": "urllib3"}
R = http_pool.get_url (API_URL, полета)
Принтирай r.status, r.data

Какво ново в тази версия:

• Добавена urllib3.add_stderr_logger () за бързо позволяваща STDERR дебъгване сеч в urllib3.
• Native пълния URL разбор (включително AUTH, пътека, заявка, фрагмент) на разположение в urllib3.util.parse_url (URL).
• Вградена пренасочване ще се включи метод на "GET" ако статус код е 303. (Issue # 11)
• urllib3.PoolManager ленти схемата и домакин, преди да изпратите заявка URI. (Issue # 8)
• New urllib3.exceptions.DecodeError изключение за когато автоматично декодиране, базирани на заглавната част на Content-Type, се провали.
• Фиксирана бъг с недостиг на басейн и течове връзки (брой # 76). Добавен е явна връзка затваряне на басейн изгонване. Добавено urllib3.PoolManager.clear ().
• 99% - & GT; 100% единица тест покритие.

Какво ново във версия 1.4:.

• Малки Платформата на Google, свързани с поправки
• Switched от mimetools.choose_boundary да uuid.uuid4 ().
• Подобрена URL разбор. (Issue # 73)
• IPv6 URL подкрепа. (Issue # 72)

Какво ново във версия 1.3:.

• Премахнато предварително 1.0 отхвърлена API
• Refactored помощници в urllib3.util подмодул.
• Фиксирана съставно кодиране да подкрепят списък-на-кортежи за ключове с няколко стойности. (Issue # 48)
• Фиксирани множество Set-Cookie хедъри в отговор не се получи слива правилно в Python 3. (Issue # 53)
• AppEngine подкрепа с Py27. (Issue # 61)
• Малки encode_multipart_formdata поправки, свързани с Python 3 струни срещу байта.

Какво ново във версия 1.2.2:

• Фиксирана опаковки бъг не корабоплаването изпитвателни изисквания. текст. (Issue # 47)

Какво ново във версия 1.2.1:

• Фиксирана друг бъг, свързан с когато SSL модул не е на разположение. (Issue # 41)
• Място разбор грешки сега повдигат urllib3.exceptions.LocationParseError която наследява от ValueError.

Какво ново във версия 1.2:

• Добавено Python 3 подкрепа (тестван на 3.2.2)
• Окачен Python 2.5 поддръжка (тестван на 2.6.7, 2.7.2)
• Използване select.poll вместо select.select за платформи, които го поддържат.
• Използване Queue.LifoQueue вместо Queue.Queue за по-агресивна връзка повторно използване. Конфигуриране с императивни ConnectionPool.QueueCls.
• Фиксирана ImportError време инсталирате когато SSL модул не е на разположение. (Issue # 41)
• Фиксирана PoolManager пренасочва между схеми (като HTTP - & GT; HTTPS) не завършват правилно. (Issue # 28, разкрита от Issue # 10 в v1.1)
• Пренесен dummyserver да използвате торнадо вместо webob + eventlet. Премахнати външни неподдържани Неуспех dummyserver тестване. Добавяне на тестове за контакт на ниво.
• Още тестове. Achievement Unlocked:. 99% покритие

Какво ново във версия 1.1:

• Refactored dummyserver към собствената си корени именно пространство модул (използван за тестване ).
• Добавена проверка име на хост за VerifiedHTTPSConnection от vendoring в ssl_match_hostname Py32 си. (Issue # 25)
• Фиксиран кръст-домакин HTTP пренасочвания при използване PoolManager. (Issue # 10)
• Фиксирана decode_content се пренебрегва, когато е настроен чрез urlopen. (Issue # 27)
• Фиксирани бъгове таймаут свързани. (Въпроси # 17, # 23)

Какво ново във версия 1.0.2:

• Фиксирана правописна грешка в VerifiedHTTPSConnection която ще представи само като бъг, ако ръчно с помощта на предмета. (Благодарение pyos)
• Made RecentlyUsedContainer (и следователно PoolManager) повече конци-безопасно чрез обвиване дневника за достъп в мутекс. (Благодарениеchrister)
• Made RecentlyUsedContainer по-Dict-подобни (коригиран __delitem__ и __getitem__ поведение), с тестове. Не следва да засяга основната urllib3 код.

Какво ново във версия 1.0.1:

• Фиксирана бъг, където същата връзка ще се върна в басейна на два пъти, което води до външен & quot; HttpConnectionPool е пълно & quot; влезте предупреждения.

<силни> Изисквания :

• Python