Ruffruffs

++++++++++++++++++

**Behavioural Changes**

- Only catch HTTPErrors in raise_for_status (2382)

**Bugfixes**

- Handle LocationParseError from urllib3 (2344)
- Handle file-like object filenames that are not strings (2379)
- Unbreak HTTPDigestAuth handler. Allow new nonces to be negotiated (2389)

++++++++++++++++++

**Improvements**

- Allow usage of urllib3's Retry object with HTTPAdapters (2216)
- The ``iter_lines`` method on a response now accepts a delimiter with which
to split the content (2295)

**Behavioural Changes**

- Add deprecation warnings to functions in requests.utils that will be removed
in 3.0 (2309)
- Sessions used by the functional API are always closed (2326)
- Restrict requests to HTTP/1.1 and HTTP/1.0 (stop accepting HTTP/0.9) (2323)

**Bugfixes**

- Only parse the URL once (2353)
- Allow Content-Length header to always be overridden (2332)
- Properly handle files in HTTPDigestAuth (2333)
- Cap redirect_cache size to prevent memory abuse (2299)
- Fix HTTPDigestAuth handling of redirects after authenticating successfully
(2253)
- Fix crash with custom method parameter to Session.request (2317)
- Fix how Link headers are parsed using the regular expression library (2271)

**Documentation**

- Add more references for interlinking (2348)
- Update CSS for theme (2290)
- Update width of buttons and sidebar (2289)
- Replace references of Gittip with Gratipay (2282)
- Add link to changelog in sidebar (2273)

++++++++++++++++++

**Bugfixes**

- Unicode URL improvements for Python 2.
- Re-order JSON param for backwards compat.
- Automatically defrag authentication schemes from host/pass URIs. (`2249 <https://github.com/kennethreitz/requests/issues/2249>`_)

++++++++++++++++++

**Improvements**

- FINALLY! Add json parameter for uploads! (`2258 <https://github.com/kennethreitz/requests/pull/2258>`_)
- Support for bytestring URLs on Python 3.x (`2238 <https://github.com/kennethreitz/requests/pull/2238>`_)

**Bugfixes**

- Avoid getting stuck in a loop (`2244 <https://github.com/kennethreitz/requests/pull/2244>`_)
- Multiple calls to iter* fail with unhelpful error. (`2240 <https://github.com/kennethreitz/requests/issues/2240>`_, `2241 <https://github.com/kennethreitz/requests/issues/2241>`_)

**Documentation**

- Correct redirection introduction (`2245 <https://github.com/kennethreitz/requests/pull/2245/>`_)
- Added example of how to send multiple files in one request. (`2227 <https://github.com/kennethreitz/requests/pull/2227/>`_)
- Clarify how to pass a custom set of CAs (`2248 <https://github.com/kennethreitz/requests/pull/2248/>`_)

++++++++++++++++++

- Now has a "security" package extras set, ``$ pip install requests[security]``
- Requests will now use Certifi if it is available.
- Capture and re-raise urllib3 ProtocolError
- Bugfix for responses that attempt to redirect to themselves forever (wtf?).

++++++++++++++++++

**Behavioral Changes**

- ``Connection: keep-alive`` header is now sent automatically.

**Improvements**

- Support for connect timeouts! Timeout now accepts a tuple (connect, read) which is used to set individual connect and read timeouts.
- Allow copying of PreparedRequests without headers/cookies.
- Updated bundled urllib3 version.
- Refactored settings loading from environment -- new `Session.merge_environment_settings`.
- Handle socket errors in iter_content.