Urllib3-future

================

* Contrib: Optional SNI support for Py2 using PyOpenSSL. (Issue 156)

* ``ProxyManager`` automatically adds ``Host: ...`` header if not given.

* Improved SSL-related code. ``cert_req`` now optionally takes a string like
"REQUIRED" or "NONE". Same with ``ssl_version`` takes strings like "SSLv23"
The string values reflect the suffix of the respective constant variable.
(Issue 130)

* Vendored ``socksipy`` now based on Anorov's fork which handles unexpectedly
closed proxy connections and larger read buffers. (Issue 135)

* Ensure the connection is closed if no data is received, fixes connection leak
on some platforms. (Issue 133)

* Added SNI support for SSL/TLS connections on Py32+. (Issue 89)

* Tests fixed to be compatible with Py26 again. (Issue 125)

* Added ability to choose SSL version by passing an ``ssl.PROTOCOL_*`` constant
to the ``ssl_version`` parameter of ``HTTPSConnectionPool``. (Issue 109)

* Allow an explicit content type to be specified when encoding file fields.
(Issue 126)

* Exceptions are now pickleable, with tests. (Issue 101)

* Fixed default headers not getting passed in some cases. (Issue 99)

* Treat "content-encoding" header value as case-insensitive, per RFC 2616
Section 3.5. (Issue 110)

* "Connection Refused" SocketErrors will get retried rather than raised.
(Issue 92)

* Updated vendored ``six``, no longer overrides the global ``six`` module
namespace. (Issue 113)

* ``urllib3.exceptions.MaxRetryError`` contains a ``reason`` property holding
the exception that prompted the final retry. If ``reason is None`` then it
was due to a redirect. (Issue 92, 114)

* Fixed ``PoolManager.urlopen()`` from not redirecting more than once.
(Issue 149)

* Don't assume ``Content-Type: text/plain`` for multi-part encoding parameters
that are not files. (Issue 111)

* Pass `strict` param down to ``httplib.HTTPConnection``. (Issue 122)

* Added mechanism to verify SSL certificates by fingerprint (md5, sha1) or
against an arbitrary hostname (when connecting by IP or for misconfigured
servers). (Issue 140)

* Streaming decompression support. (Issue 159)

================

* Added ``urllib3.add_stderr_logger()`` for quickly enabling STDERR debug
logging in urllib3.

* Native full URL parsing (including auth, path, query, fragment) available in
``urllib3.util.parse_url(url)``.

* Built-in redirect will switch method to 'GET' if status code is 303.
(Issue 11)

* ``urllib3.PoolManager`` strips the scheme and host before sending the request
uri. (Issue 8)

* New ``urllib3.exceptions.DecodeError`` exception for when automatic decoding,
based on the Content-Type header, fails.

* Fixed bug with pool depletion and leaking connections (Issue 76). Added
explicit connection closing on pool eviction. Added
``urllib3.PoolManager.clear()``.

* 99% -> 100% unit test coverage.

================

* Minor AppEngine-related fixes.

* Switched from ``mimetools.choose_boundary`` to ``uuid.uuid4()``.

* Improved url parsing. (Issue 73)

* IPv6 url support. (Issue 72)

================

* Removed pre-1.0 deprecated API.

* Refactored helpers into a ``urllib3.util`` submodule.

* Fixed multipart encoding to support list-of-tuples for keys with multiple
values. (Issue 48)

* Fixed multiple Set-Cookie headers in response not getting merged properly in
Python 3. (Issue 53)

* AppEngine support with Py27. (Issue 61)

* Minor ``encode_multipart_formdata`` fixes related to Python 3 strings vs
bytes.

==================

* Fixed packaging bug of not shipping ``test-requirements.txt``. (Issue 47)

==================

* Fixed another bug related to when ``ssl`` module is not available. (Issue 41)

* Location parsing errors now raise ``urllib3.exceptions.LocationParseError``
which inherits from ``ValueError``.