PKG-INFO 39 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021
  1. Metadata-Version: 1.1
  2. Name: urllib3
  3. Version: 1.22
  4. Summary: HTTP library with thread-safe connection pooling, file post, and more.
  5. Home-page: https://urllib3.readthedocs.io/
  6. Author: Andrey Petrov
  7. Author-email: andrey.petrov@shazow.net
  8. License: MIT
  9. Description: urllib3
  10. =======
  11. .. image:: https://travis-ci.org/shazow/urllib3.svg?branch=master
  12. :alt: Build status on Travis
  13. :target: https://travis-ci.org/shazow/urllib3
  14. .. image:: https://img.shields.io/appveyor/ci/shazow/urllib3/master.svg
  15. :alt: Build status on AppVeyor
  16. :target: https://ci.appveyor.com/project/shazow/urllib3
  17. .. image:: https://readthedocs.org/projects/urllib3/badge/?version=latest
  18. :alt: Documentation Status
  19. :target: https://urllib3.readthedocs.io/en/latest/
  20. .. image:: https://img.shields.io/codecov/c/github/shazow/urllib3.svg
  21. :alt: Coverage Status
  22. :target: https://codecov.io/gh/shazow/urllib3
  23. .. image:: https://img.shields.io/pypi/v/urllib3.svg?maxAge=86400
  24. :alt: PyPI version
  25. :target: https://pypi.python.org/pypi/urllib3
  26. .. image:: https://www.bountysource.com/badge/tracker?tracker_id=192525
  27. :alt: Bountysource
  28. :target: https://www.bountysource.com/trackers/192525-urllib3?utm_source=192525&utm_medium=shield&utm_campaign=TRACKER_BADGE
  29. urllib3 is a powerful, *sanity-friendly* HTTP client for Python. Much of the
  30. Python ecosystem already uses urllib3 and you should too.
  31. urllib3 brings many critical features that are missing from the Python
  32. standard libraries:
  33. - Thread safety.
  34. - Connection pooling.
  35. - Client-side SSL/TLS verification.
  36. - File uploads with multipart encoding.
  37. - Helpers for retrying requests and dealing with HTTP redirects.
  38. - Support for gzip and deflate encoding.
  39. - Proxy support for HTTP and SOCKS.
  40. - 100% test coverage.
  41. urllib3 is powerful and easy to use::
  42. >>> import urllib3
  43. >>> http = urllib3.PoolManager()
  44. >>> r = http.request('GET', 'http://httpbin.org/robots.txt')
  45. >>> r.status
  46. 200
  47. >>> r.data
  48. 'User-agent: *\nDisallow: /deny\n'
  49. Installing
  50. ----------
  51. urllib3 can be installed with `pip <https://pip.pypa.io>`_::
  52. $ pip install urllib3
  53. Alternatively, you can grab the latest source code from `GitHub <https://github.com/shazow/urllib3>`_::
  54. $ git clone git://github.com/shazow/urllib3.git
  55. $ python setup.py install
  56. Documentation
  57. -------------
  58. urllib3 has usage and reference documentation at `urllib3.readthedocs.io <https://urllib3.readthedocs.io>`_.
  59. Contributing
  60. ------------
  61. urllib3 happily accepts contributions. Please see our
  62. `contributing documentation <https://urllib3.readthedocs.io/en/latest/contributing.html>`_
  63. for some tips on getting started.
  64. Maintainers
  65. -----------
  66. - `@lukasa <https://github.com/lukasa>`_ (Cory Benfield)
  67. - `@sigmavirus24 <https://github.com/sigmavirus24>`_ (Ian Cordasco)
  68. - `@shazow <https://github.com/shazow>`_ (Andrey Petrov)
  69. 👋
  70. Sponsorship
  71. -----------
  72. If your company benefits from this library, please consider `sponsoring its
  73. development <https://urllib3.readthedocs.io/en/latest/contributing.html#sponsorship>`_.
  74. Changes
  75. =======
  76. 1.22 (2017-07-20)
  77. -----------------
  78. * Fixed missing brackets in ``HTTP CONNECT`` when connecting to IPv6 address via
  79. IPv6 proxy. (Issue #1222)
  80. * Made the connection pool retry on ``SSLError``. The original ``SSLError``
  81. is available on ``MaxRetryError.reason``. (Issue #1112)
  82. * Drain and release connection before recursing on retry/redirect. Fixes
  83. deadlocks with a blocking connectionpool. (Issue #1167)
  84. * Fixed compatibility for cookiejar. (Issue #1229)
  85. * pyopenssl: Use vendored version of ``six``. (Issue #1231)
  86. 1.21.1 (2017-05-02)
  87. -------------------
  88. * Fixed SecureTransport issue that would cause long delays in response body
  89. delivery. (Pull #1154)
  90. * Fixed regression in 1.21 that threw exceptions when users passed the
  91. ``socket_options`` flag to the ``PoolManager``. (Issue #1165)
  92. * Fixed regression in 1.21 that threw exceptions when users passed the
  93. ``assert_hostname`` or ``assert_fingerprint`` flag to the ``PoolManager``.
  94. (Pull #1157)
  95. 1.21 (2017-04-25)
  96. -----------------
  97. * Improved performance of certain selector system calls on Python 3.5 and
  98. later. (Pull #1095)
  99. * Resolved issue where the PyOpenSSL backend would not wrap SysCallError
  100. exceptions appropriately when sending data. (Pull #1125)
  101. * Selectors now detects a monkey-patched select module after import for modules
  102. that patch the select module like eventlet, greenlet. (Pull #1128)
  103. * Reduced memory consumption when streaming zlib-compressed responses
  104. (as opposed to raw deflate streams). (Pull #1129)
  105. * Connection pools now use the entire request context when constructing the
  106. pool key. (Pull #1016)
  107. * ``PoolManager.connection_from_*`` methods now accept a new keyword argument,
  108. ``pool_kwargs``, which are merged with the existing ``connection_pool_kw``.
  109. (Pull #1016)
  110. * Add retry counter for ``status_forcelist``. (Issue #1147)
  111. * Added ``contrib`` module for using SecureTransport on macOS:
  112. ``urllib3.contrib.securetransport``. (Pull #1122)
  113. * urllib3 now only normalizes the case of ``http://`` and ``https://`` schemes:
  114. for schemes it does not recognise, it assumes they are case-sensitive and
  115. leaves them unchanged.
  116. (Issue #1080)
  117. 1.20 (2017-01-19)
  118. -----------------
  119. * Added support for waiting for I/O using selectors other than select,
  120. improving urllib3's behaviour with large numbers of concurrent connections.
  121. (Pull #1001)
  122. * Updated the date for the system clock check. (Issue #1005)
  123. * ConnectionPools now correctly consider hostnames to be case-insensitive.
  124. (Issue #1032)
  125. * Outdated versions of PyOpenSSL now cause the PyOpenSSL contrib module
  126. to fail when it is injected, rather than at first use. (Pull #1063)
  127. * Outdated versions of cryptography now cause the PyOpenSSL contrib module
  128. to fail when it is injected, rather than at first use. (Issue #1044)
  129. * Automatically attempt to rewind a file-like body object when a request is
  130. retried or redirected. (Pull #1039)
  131. * Fix some bugs that occur when modules incautiously patch the queue module.
  132. (Pull #1061)
  133. * Prevent retries from occuring on read timeouts for which the request method
  134. was not in the method whitelist. (Issue #1059)
  135. * Changed the PyOpenSSL contrib module to lazily load idna to avoid
  136. unnecessarily bloating the memory of programs that don't need it. (Pull
  137. #1076)
  138. * Add support for IPv6 literals with zone identifiers. (Pull #1013)
  139. * Added support for socks5h:// and socks4a:// schemes when working with SOCKS
  140. proxies, and controlled remote DNS appropriately. (Issue #1035)
  141. 1.19.1 (2016-11-16)
  142. -------------------
  143. * Fixed AppEngine import that didn't function on Python 3.5. (Pull #1025)
  144. 1.19 (2016-11-03)
  145. -----------------
  146. * urllib3 now respects Retry-After headers on 413, 429, and 503 responses when
  147. using the default retry logic. (Pull #955)
  148. * Remove markers from setup.py to assist ancient setuptools versions. (Issue
  149. #986)
  150. * Disallow superscripts and other integerish things in URL ports. (Issue #989)
  151. * Allow urllib3's HTTPResponse.stream() method to continue to work with
  152. non-httplib underlying FPs. (Pull #990)
  153. * Empty filenames in multipart headers are now emitted as such, rather than
  154. being supressed. (Issue #1015)
  155. * Prefer user-supplied Host headers on chunked uploads. (Issue #1009)
  156. 1.18.1 (2016-10-27)
  157. -------------------
  158. * CVE-2016-9015. Users who are using urllib3 version 1.17 or 1.18 along with
  159. PyOpenSSL injection and OpenSSL 1.1.0 *must* upgrade to this version. This
  160. release fixes a vulnerability whereby urllib3 in the above configuration
  161. would silently fail to validate TLS certificates due to erroneously setting
  162. invalid flags in OpenSSL's ``SSL_CTX_set_verify`` function. These erroneous
  163. flags do not cause a problem in OpenSSL versions before 1.1.0, which
  164. interprets the presence of any flag as requesting certificate validation.
  165. There is no PR for this patch, as it was prepared for simultaneous disclosure
  166. and release. The master branch received the same fix in PR #1010.
  167. 1.18 (2016-09-26)
  168. -----------------
  169. * Fixed incorrect message for IncompleteRead exception. (PR #973)
  170. * Accept ``iPAddress`` subject alternative name fields in TLS certificates.
  171. (Issue #258)
  172. * Fixed consistency of ``HTTPResponse.closed`` between Python 2 and 3.
  173. (Issue #977)
  174. * Fixed handling of wildcard certificates when using PyOpenSSL. (Issue #979)
  175. 1.17 (2016-09-06)
  176. -----------------
  177. * Accept ``SSLContext`` objects for use in SSL/TLS negotiation. (Issue #835)
  178. * ConnectionPool debug log now includes scheme, host, and port. (Issue #897)
  179. * Substantially refactored documentation. (Issue #887)
  180. * Used URLFetch default timeout on AppEngine, rather than hardcoding our own.
  181. (Issue #858)
  182. * Normalize the scheme and host in the URL parser (Issue #833)
  183. * ``HTTPResponse`` contains the last ``Retry`` object, which now also
  184. contains retries history. (Issue #848)
  185. * Timeout can no longer be set as boolean, and must be greater than zero.
  186. (PR #924)
  187. * Removed pyasn1 and ndg-httpsclient from dependencies used for PyOpenSSL. We
  188. now use cryptography and idna, both of which are already dependencies of
  189. PyOpenSSL. (PR #930)
  190. * Fixed infinite loop in ``stream`` when amt=None. (Issue #928)
  191. * Try to use the operating system's certificates when we are using an
  192. ``SSLContext``. (PR #941)
  193. * Updated cipher suite list to allow ChaCha20+Poly1305. AES-GCM is preferred to
  194. ChaCha20, but ChaCha20 is then preferred to everything else. (PR #947)
  195. * Updated cipher suite list to remove 3DES-based cipher suites. (PR #958)
  196. * Removed the cipher suite fallback to allow HIGH ciphers. (PR #958)
  197. * Implemented ``length_remaining`` to determine remaining content
  198. to be read. (PR #949)
  199. * Implemented ``enforce_content_length`` to enable exceptions when
  200. incomplete data chunks are received. (PR #949)
  201. * Dropped connection start, dropped connection reset, redirect, forced retry,
  202. and new HTTPS connection log levels to DEBUG, from INFO. (PR #967)
  203. 1.16 (2016-06-11)
  204. -----------------
  205. * Disable IPv6 DNS when IPv6 connections are not possible. (Issue #840)
  206. * Provide ``key_fn_by_scheme`` pool keying mechanism that can be
  207. overridden. (Issue #830)
  208. * Normalize scheme and host to lowercase for pool keys, and include
  209. ``source_address``. (Issue #830)
  210. * Cleaner exception chain in Python 3 for ``_make_request``.
  211. (Issue #861)
  212. * Fixed installing ``urllib3[socks]`` extra. (Issue #864)
  213. * Fixed signature of ``ConnectionPool.close`` so it can actually safely be
  214. called by subclasses. (Issue #873)
  215. * Retain ``release_conn`` state across retries. (Issues #651, #866)
  216. * Add customizable ``HTTPConnectionPool.ResponseCls``, which defaults to
  217. ``HTTPResponse`` but can be replaced with a subclass. (Issue #879)
  218. 1.15.1 (2016-04-11)
  219. -------------------
  220. * Fix packaging to include backports module. (Issue #841)
  221. 1.15 (2016-04-06)
  222. -----------------
  223. * Added Retry(raise_on_status=False). (Issue #720)
  224. * Always use setuptools, no more distutils fallback. (Issue #785)
  225. * Dropped support for Python 3.2. (Issue #786)
  226. * Chunked transfer encoding when requesting with ``chunked=True``.
  227. (Issue #790)
  228. * Fixed regression with IPv6 port parsing. (Issue #801)
  229. * Append SNIMissingWarning messages to allow users to specify it in
  230. the PYTHONWARNINGS environment variable. (Issue #816)
  231. * Handle unicode headers in Py2. (Issue #818)
  232. * Log certificate when there is a hostname mismatch. (Issue #820)
  233. * Preserve order of request/response headers. (Issue #821)
  234. 1.14 (2015-12-29)
  235. -----------------
  236. * contrib: SOCKS proxy support! (Issue #762)
  237. * Fixed AppEngine handling of transfer-encoding header and bug
  238. in Timeout defaults checking. (Issue #763)
  239. 1.13.1 (2015-12-18)
  240. -------------------
  241. * Fixed regression in IPv6 + SSL for match_hostname. (Issue #761)
  242. 1.13 (2015-12-14)
  243. -----------------
  244. * Fixed ``pip install urllib3[secure]`` on modern pip. (Issue #706)
  245. * pyopenssl: Fixed SSL3_WRITE_PENDING error. (Issue #717)
  246. * pyopenssl: Support for TLSv1.1 and TLSv1.2. (Issue #696)
  247. * Close connections more defensively on exception. (Issue #734)
  248. * Adjusted ``read_chunked`` to handle gzipped, chunk-encoded bodies without
  249. repeatedly flushing the decoder, to function better on Jython. (Issue #743)
  250. * Accept ``ca_cert_dir`` for SSL-related PoolManager configuration. (Issue #758)
  251. 1.12 (2015-09-03)
  252. -----------------
  253. * Rely on ``six`` for importing ``httplib`` to work around
  254. conflicts with other Python 3 shims. (Issue #688)
  255. * Add support for directories of certificate authorities, as supported by
  256. OpenSSL. (Issue #701)
  257. * New exception: ``NewConnectionError``, raised when we fail to establish
  258. a new connection, usually ``ECONNREFUSED`` socket error.
  259. 1.11 (2015-07-21)
  260. -----------------
  261. * When ``ca_certs`` is given, ``cert_reqs`` defaults to
  262. ``'CERT_REQUIRED'``. (Issue #650)
  263. * ``pip install urllib3[secure]`` will install Certifi and
  264. PyOpenSSL as dependencies. (Issue #678)
  265. * Made ``HTTPHeaderDict`` usable as a ``headers`` input value
  266. (Issues #632, #679)
  267. * Added `urllib3.contrib.appengine <https://urllib3.readthedocs.io/en/latest/contrib.html#google-app-engine>`_
  268. which has an ``AppEngineManager`` for using ``URLFetch`` in a
  269. Google AppEngine environment. (Issue #664)
  270. * Dev: Added test suite for AppEngine. (Issue #631)
  271. * Fix performance regression when using PyOpenSSL. (Issue #626)
  272. * Passing incorrect scheme (e.g. ``foo://``) will raise
  273. ``ValueError`` instead of ``AssertionError`` (backwards
  274. compatible for now, but please migrate). (Issue #640)
  275. * Fix pools not getting replenished when an error occurs during a
  276. request using ``release_conn=False``. (Issue #644)
  277. * Fix pool-default headers not applying for url-encoded requests
  278. like GET. (Issue #657)
  279. * log.warning in Python 3 when headers are skipped due to parsing
  280. errors. (Issue #642)
  281. * Close and discard connections if an error occurs during read.
  282. (Issue #660)
  283. * Fix host parsing for IPv6 proxies. (Issue #668)
  284. * Separate warning type SubjectAltNameWarning, now issued once
  285. per host. (Issue #671)
  286. * Fix ``httplib.IncompleteRead`` not getting converted to
  287. ``ProtocolError`` when using ``HTTPResponse.stream()``
  288. (Issue #674)
  289. 1.10.4 (2015-05-03)
  290. -------------------
  291. * Migrate tests to Tornado 4. (Issue #594)
  292. * Append default warning configuration rather than overwrite.
  293. (Issue #603)
  294. * Fix streaming decoding regression. (Issue #595)
  295. * Fix chunked requests losing state across keep-alive connections.
  296. (Issue #599)
  297. * Fix hanging when chunked HEAD response has no body. (Issue #605)
  298. 1.10.3 (2015-04-21)
  299. -------------------
  300. * Emit ``InsecurePlatformWarning`` when SSLContext object is missing.
  301. (Issue #558)
  302. * Fix regression of duplicate header keys being discarded.
  303. (Issue #563)
  304. * ``Response.stream()`` returns a generator for chunked responses.
  305. (Issue #560)
  306. * Set upper-bound timeout when waiting for a socket in PyOpenSSL.
  307. (Issue #585)
  308. * Work on platforms without `ssl` module for plain HTTP requests.
  309. (Issue #587)
  310. * Stop relying on the stdlib's default cipher list. (Issue #588)
  311. 1.10.2 (2015-02-25)
  312. -------------------
  313. * Fix file descriptor leakage on retries. (Issue #548)
  314. * Removed RC4 from default cipher list. (Issue #551)
  315. * Header performance improvements. (Issue #544)
  316. * Fix PoolManager not obeying redirect retry settings. (Issue #553)
  317. 1.10.1 (2015-02-10)
  318. -------------------
  319. * Pools can be used as context managers. (Issue #545)
  320. * Don't re-use connections which experienced an SSLError. (Issue #529)
  321. * Don't fail when gzip decoding an empty stream. (Issue #535)
  322. * Add sha256 support for fingerprint verification. (Issue #540)
  323. * Fixed handling of header values containing commas. (Issue #533)
  324. 1.10 (2014-12-14)
  325. -----------------
  326. * Disabled SSLv3. (Issue #473)
  327. * Add ``Url.url`` property to return the composed url string. (Issue #394)
  328. * Fixed PyOpenSSL + gevent ``WantWriteError``. (Issue #412)
  329. * ``MaxRetryError.reason`` will always be an exception, not string.
  330. (Issue #481)
  331. * Fixed SSL-related timeouts not being detected as timeouts. (Issue #492)
  332. * Py3: Use ``ssl.create_default_context()`` when available. (Issue #473)
  333. * Emit ``InsecureRequestWarning`` for *every* insecure HTTPS request.
  334. (Issue #496)
  335. * Emit ``SecurityWarning`` when certificate has no ``subjectAltName``.
  336. (Issue #499)
  337. * Close and discard sockets which experienced SSL-related errors.
  338. (Issue #501)
  339. * Handle ``body`` param in ``.request(...)``. (Issue #513)
  340. * Respect timeout with HTTPS proxy. (Issue #505)
  341. * PyOpenSSL: Handle ZeroReturnError exception. (Issue #520)
  342. 1.9.1 (2014-09-13)
  343. ------------------
  344. * Apply socket arguments before binding. (Issue #427)
  345. * More careful checks if fp-like object is closed. (Issue #435)
  346. * Fixed packaging issues of some development-related files not
  347. getting included. (Issue #440)
  348. * Allow performing *only* fingerprint verification. (Issue #444)
  349. * Emit ``SecurityWarning`` if system clock is waaay off. (Issue #445)
  350. * Fixed PyOpenSSL compatibility with PyPy. (Issue #450)
  351. * Fixed ``BrokenPipeError`` and ``ConnectionError`` handling in Py3.
  352. (Issue #443)
  353. 1.9 (2014-07-04)
  354. ----------------
  355. * Shuffled around development-related files. If you're maintaining a distro
  356. package of urllib3, you may need to tweak things. (Issue #415)
  357. * Unverified HTTPS requests will trigger a warning on the first request. See
  358. our new `security documentation
  359. <https://urllib3.readthedocs.io/en/latest/security.html>`_ for details.
  360. (Issue #426)
  361. * New retry logic and ``urllib3.util.retry.Retry`` configuration object.
  362. (Issue #326)
  363. * All raised exceptions should now wrapped in a
  364. ``urllib3.exceptions.HTTPException``-extending exception. (Issue #326)
  365. * All errors during a retry-enabled request should be wrapped in
  366. ``urllib3.exceptions.MaxRetryError``, including timeout-related exceptions
  367. which were previously exempt. Underlying error is accessible from the
  368. ``.reason`` propery. (Issue #326)
  369. * ``urllib3.exceptions.ConnectionError`` renamed to
  370. ``urllib3.exceptions.ProtocolError``. (Issue #326)
  371. * Errors during response read (such as IncompleteRead) are now wrapped in
  372. ``urllib3.exceptions.ProtocolError``. (Issue #418)
  373. * Requesting an empty host will raise ``urllib3.exceptions.LocationValueError``.
  374. (Issue #417)
  375. * Catch read timeouts over SSL connections as
  376. ``urllib3.exceptions.ReadTimeoutError``. (Issue #419)
  377. * Apply socket arguments before connecting. (Issue #427)
  378. 1.8.3 (2014-06-23)
  379. ------------------
  380. * Fix TLS verification when using a proxy in Python 3.4.1. (Issue #385)
  381. * Add ``disable_cache`` option to ``urllib3.util.make_headers``. (Issue #393)
  382. * Wrap ``socket.timeout`` exception with
  383. ``urllib3.exceptions.ReadTimeoutError``. (Issue #399)
  384. * Fixed proxy-related bug where connections were being reused incorrectly.
  385. (Issues #366, #369)
  386. * Added ``socket_options`` keyword parameter which allows to define
  387. ``setsockopt`` configuration of new sockets. (Issue #397)
  388. * Removed ``HTTPConnection.tcp_nodelay`` in favor of
  389. ``HTTPConnection.default_socket_options``. (Issue #397)
  390. * Fixed ``TypeError`` bug in Python 2.6.4. (Issue #411)
  391. 1.8.2 (2014-04-17)
  392. ------------------
  393. * Fix ``urllib3.util`` not being included in the package.
  394. 1.8.1 (2014-04-17)
  395. ------------------
  396. * Fix AppEngine bug of HTTPS requests going out as HTTP. (Issue #356)
  397. * Don't install ``dummyserver`` into ``site-packages`` as it's only needed
  398. for the test suite. (Issue #362)
  399. * Added support for specifying ``source_address``. (Issue #352)
  400. 1.8 (2014-03-04)
  401. ----------------
  402. * Improved url parsing in ``urllib3.util.parse_url`` (properly parse '@' in
  403. username, and blank ports like 'hostname:').
  404. * New ``urllib3.connection`` module which contains all the HTTPConnection
  405. objects.
  406. * Several ``urllib3.util.Timeout``-related fixes. Also changed constructor
  407. signature to a more sensible order. [Backwards incompatible]
  408. (Issues #252, #262, #263)
  409. * Use ``backports.ssl_match_hostname`` if it's installed. (Issue #274)
  410. * Added ``.tell()`` method to ``urllib3.response.HTTPResponse`` which
  411. returns the number of bytes read so far. (Issue #277)
  412. * Support for platforms without threading. (Issue #289)
  413. * Expand default-port comparison in ``HTTPConnectionPool.is_same_host``
  414. to allow a pool with no specified port to be considered equal to to an
  415. HTTP/HTTPS url with port 80/443 explicitly provided. (Issue #305)
  416. * Improved default SSL/TLS settings to avoid vulnerabilities.
  417. (Issue #309)
  418. * Fixed ``urllib3.poolmanager.ProxyManager`` not retrying on connect errors.
  419. (Issue #310)
  420. * Disable Nagle's Algorithm on the socket for non-proxies. A subset of requests
  421. will send the entire HTTP request ~200 milliseconds faster; however, some of
  422. the resulting TCP packets will be smaller. (Issue #254)
  423. * Increased maximum number of SubjectAltNames in ``urllib3.contrib.pyopenssl``
  424. from the default 64 to 1024 in a single certificate. (Issue #318)
  425. * Headers are now passed and stored as a custom
  426. ``urllib3.collections_.HTTPHeaderDict`` object rather than a plain ``dict``.
  427. (Issue #329, #333)
  428. * Headers no longer lose their case on Python 3. (Issue #236)
  429. * ``urllib3.contrib.pyopenssl`` now uses the operating system's default CA
  430. certificates on inject. (Issue #332)
  431. * Requests with ``retries=False`` will immediately raise any exceptions without
  432. wrapping them in ``MaxRetryError``. (Issue #348)
  433. * Fixed open socket leak with SSL-related failures. (Issue #344, #348)
  434. 1.7.1 (2013-09-25)
  435. ------------------
  436. * Added granular timeout support with new ``urllib3.util.Timeout`` class.
  437. (Issue #231)
  438. * Fixed Python 3.4 support. (Issue #238)
  439. 1.7 (2013-08-14)
  440. ----------------
  441. * More exceptions are now pickle-able, with tests. (Issue #174)
  442. * Fixed redirecting with relative URLs in Location header. (Issue #178)
  443. * Support for relative urls in ``Location: ...`` header. (Issue #179)
  444. * ``urllib3.response.HTTPResponse`` now inherits from ``io.IOBase`` for bonus
  445. file-like functionality. (Issue #187)
  446. * Passing ``assert_hostname=False`` when creating a HTTPSConnectionPool will
  447. skip hostname verification for SSL connections. (Issue #194)
  448. * New method ``urllib3.response.HTTPResponse.stream(...)`` which acts as a
  449. generator wrapped around ``.read(...)``. (Issue #198)
  450. * IPv6 url parsing enforces brackets around the hostname. (Issue #199)
  451. * Fixed thread race condition in
  452. ``urllib3.poolmanager.PoolManager.connection_from_host(...)`` (Issue #204)
  453. * ``ProxyManager`` requests now include non-default port in ``Host: ...``
  454. header. (Issue #217)
  455. * Added HTTPS proxy support in ``ProxyManager``. (Issue #170 #139)
  456. * New ``RequestField`` object can be passed to the ``fields=...`` param which
  457. can specify headers. (Issue #220)
  458. * Raise ``urllib3.exceptions.ProxyError`` when connecting to proxy fails.
  459. (Issue #221)
  460. * Use international headers when posting file names. (Issue #119)
  461. * Improved IPv6 support. (Issue #203)
  462. 1.6 (2013-04-25)
  463. ----------------
  464. * Contrib: Optional SNI support for Py2 using PyOpenSSL. (Issue #156)
  465. * ``ProxyManager`` automatically adds ``Host: ...`` header if not given.
  466. * Improved SSL-related code. ``cert_req`` now optionally takes a string like
  467. "REQUIRED" or "NONE". Same with ``ssl_version`` takes strings like "SSLv23"
  468. The string values reflect the suffix of the respective constant variable.
  469. (Issue #130)
  470. * Vendored ``socksipy`` now based on Anorov's fork which handles unexpectedly
  471. closed proxy connections and larger read buffers. (Issue #135)
  472. * Ensure the connection is closed if no data is received, fixes connection leak
  473. on some platforms. (Issue #133)
  474. * Added SNI support for SSL/TLS connections on Py32+. (Issue #89)
  475. * Tests fixed to be compatible with Py26 again. (Issue #125)
  476. * Added ability to choose SSL version by passing an ``ssl.PROTOCOL_*`` constant
  477. to the ``ssl_version`` parameter of ``HTTPSConnectionPool``. (Issue #109)
  478. * Allow an explicit content type to be specified when encoding file fields.
  479. (Issue #126)
  480. * Exceptions are now pickleable, with tests. (Issue #101)
  481. * Fixed default headers not getting passed in some cases. (Issue #99)
  482. * Treat "content-encoding" header value as case-insensitive, per RFC 2616
  483. Section 3.5. (Issue #110)
  484. * "Connection Refused" SocketErrors will get retried rather than raised.
  485. (Issue #92)
  486. * Updated vendored ``six``, no longer overrides the global ``six`` module
  487. namespace. (Issue #113)
  488. * ``urllib3.exceptions.MaxRetryError`` contains a ``reason`` property holding
  489. the exception that prompted the final retry. If ``reason is None`` then it
  490. was due to a redirect. (Issue #92, #114)
  491. * Fixed ``PoolManager.urlopen()`` from not redirecting more than once.
  492. (Issue #149)
  493. * Don't assume ``Content-Type: text/plain`` for multi-part encoding parameters
  494. that are not files. (Issue #111)
  495. * Pass `strict` param down to ``httplib.HTTPConnection``. (Issue #122)
  496. * Added mechanism to verify SSL certificates by fingerprint (md5, sha1) or
  497. against an arbitrary hostname (when connecting by IP or for misconfigured
  498. servers). (Issue #140)
  499. * Streaming decompression support. (Issue #159)
  500. 1.5 (2012-08-02)
  501. ----------------
  502. * Added ``urllib3.add_stderr_logger()`` for quickly enabling STDERR debug
  503. logging in urllib3.
  504. * Native full URL parsing (including auth, path, query, fragment) available in
  505. ``urllib3.util.parse_url(url)``.
  506. * Built-in redirect will switch method to 'GET' if status code is 303.
  507. (Issue #11)
  508. * ``urllib3.PoolManager`` strips the scheme and host before sending the request
  509. uri. (Issue #8)
  510. * New ``urllib3.exceptions.DecodeError`` exception for when automatic decoding,
  511. based on the Content-Type header, fails.
  512. * Fixed bug with pool depletion and leaking connections (Issue #76). Added
  513. explicit connection closing on pool eviction. Added
  514. ``urllib3.PoolManager.clear()``.
  515. * 99% -> 100% unit test coverage.
  516. 1.4 (2012-06-16)
  517. ----------------
  518. * Minor AppEngine-related fixes.
  519. * Switched from ``mimetools.choose_boundary`` to ``uuid.uuid4()``.
  520. * Improved url parsing. (Issue #73)
  521. * IPv6 url support. (Issue #72)
  522. 1.3 (2012-03-25)
  523. ----------------
  524. * Removed pre-1.0 deprecated API.
  525. * Refactored helpers into a ``urllib3.util`` submodule.
  526. * Fixed multipart encoding to support list-of-tuples for keys with multiple
  527. values. (Issue #48)
  528. * Fixed multiple Set-Cookie headers in response not getting merged properly in
  529. Python 3. (Issue #53)
  530. * AppEngine support with Py27. (Issue #61)
  531. * Minor ``encode_multipart_formdata`` fixes related to Python 3 strings vs
  532. bytes.
  533. 1.2.2 (2012-02-06)
  534. ------------------
  535. * Fixed packaging bug of not shipping ``test-requirements.txt``. (Issue #47)
  536. 1.2.1 (2012-02-05)
  537. ------------------
  538. * Fixed another bug related to when ``ssl`` module is not available. (Issue #41)
  539. * Location parsing errors now raise ``urllib3.exceptions.LocationParseError``
  540. which inherits from ``ValueError``.
  541. 1.2 (2012-01-29)
  542. ----------------
  543. * Added Python 3 support (tested on 3.2.2)
  544. * Dropped Python 2.5 support (tested on 2.6.7, 2.7.2)
  545. * Use ``select.poll`` instead of ``select.select`` for platforms that support
  546. it.
  547. * Use ``Queue.LifoQueue`` instead of ``Queue.Queue`` for more aggressive
  548. connection reusing. Configurable by overriding ``ConnectionPool.QueueCls``.
  549. * Fixed ``ImportError`` during install when ``ssl`` module is not available.
  550. (Issue #41)
  551. * Fixed ``PoolManager`` redirects between schemes (such as HTTP -> HTTPS) not
  552. completing properly. (Issue #28, uncovered by Issue #10 in v1.1)
  553. * Ported ``dummyserver`` to use ``tornado`` instead of ``webob`` +
  554. ``eventlet``. Removed extraneous unsupported dummyserver testing backends.
  555. Added socket-level tests.
  556. * More tests. Achievement Unlocked: 99% Coverage.
  557. 1.1 (2012-01-07)
  558. ----------------
  559. * Refactored ``dummyserver`` to its own root namespace module (used for
  560. testing).
  561. * Added hostname verification for ``VerifiedHTTPSConnection`` by vendoring in
  562. Py32's ``ssl_match_hostname``. (Issue #25)
  563. * Fixed cross-host HTTP redirects when using ``PoolManager``. (Issue #10)
  564. * Fixed ``decode_content`` being ignored when set through ``urlopen``. (Issue
  565. #27)
  566. * Fixed timeout-related bugs. (Issues #17, #23)
  567. 1.0.2 (2011-11-04)
  568. ------------------
  569. * Fixed typo in ``VerifiedHTTPSConnection`` which would only present as a bug if
  570. you're using the object manually. (Thanks pyos)
  571. * Made RecentlyUsedContainer (and consequently PoolManager) more thread-safe by
  572. wrapping the access log in a mutex. (Thanks @christer)
  573. * Made RecentlyUsedContainer more dict-like (corrected ``__delitem__`` and
  574. ``__getitem__`` behaviour), with tests. Shouldn't affect core urllib3 code.
  575. 1.0.1 (2011-10-10)
  576. ------------------
  577. * Fixed a bug where the same connection would get returned into the pool twice,
  578. causing extraneous "HttpConnectionPool is full" log warnings.
  579. 1.0 (2011-10-08)
  580. ----------------
  581. * Added ``PoolManager`` with LRU expiration of connections (tested and
  582. documented).
  583. * Added ``ProxyManager`` (needs tests, docs, and confirmation that it works
  584. with HTTPS proxies).
  585. * Added optional partial-read support for responses when
  586. ``preload_content=False``. You can now make requests and just read the headers
  587. without loading the content.
  588. * Made response decoding optional (default on, same as before).
  589. * Added optional explicit boundary string for ``encode_multipart_formdata``.
  590. * Convenience request methods are now inherited from ``RequestMethods``. Old
  591. helpers like ``get_url`` and ``post_url`` should be abandoned in favour of
  592. the new ``request(method, url, ...)``.
  593. * Refactored code to be even more decoupled, reusable, and extendable.
  594. * License header added to ``.py`` files.
  595. * Embiggened the documentation: Lots of Sphinx-friendly docstrings in the code
  596. and docs in ``docs/`` and on urllib3.readthedocs.org.
  597. * Embettered all the things!
  598. * Started writing this file.
  599. 0.4.1 (2011-07-17)
  600. ------------------
  601. * Minor bug fixes, code cleanup.
  602. 0.4 (2011-03-01)
  603. ----------------
  604. * Better unicode support.
  605. * Added ``VerifiedHTTPSConnection``.
  606. * Added ``NTLMConnectionPool`` in contrib.
  607. * Minor improvements.
  608. 0.3.1 (2010-07-13)
  609. ------------------
  610. * Added ``assert_host_name`` optional parameter. Now compatible with proxies.
  611. 0.3 (2009-12-10)
  612. ----------------
  613. * Added HTTPS support.
  614. * Minor bug fixes.
  615. * Refactored, broken backwards compatibility with 0.2.
  616. * API to be treated as stable from this version forward.
  617. 0.2 (2008-11-17)
  618. ----------------
  619. * Added unit tests.
  620. * Bug fixes.
  621. 0.1 (2008-11-16)
  622. ----------------
  623. * First release.
  624. Keywords: urllib httplib threadsafe filepost http https ssl pooling
  625. Platform: UNKNOWN
  626. Classifier: Environment :: Web Environment
  627. Classifier: Intended Audience :: Developers
  628. Classifier: License :: OSI Approved :: MIT License
  629. Classifier: Operating System :: OS Independent
  630. Classifier: Programming Language :: Python
  631. Classifier: Programming Language :: Python :: 2
  632. Classifier: Programming Language :: Python :: 2.6
  633. Classifier: Programming Language :: Python :: 2.7
  634. Classifier: Programming Language :: Python :: 3
  635. Classifier: Programming Language :: Python :: 3.3
  636. Classifier: Programming Language :: Python :: 3.4
  637. Classifier: Programming Language :: Python :: 3.5
  638. Classifier: Programming Language :: Python :: 3.6
  639. Classifier: Programming Language :: Python :: Implementation :: CPython
  640. Classifier: Programming Language :: Python :: Implementation :: PyPy
  641. Classifier: Topic :: Internet :: WWW/HTTP
  642. Classifier: Topic :: Software Development :: Libraries