Requests

------------------

**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/psf/requests/issues/2249))

------------------

**Improvements**

- FINALLY! Add json parameter for uploads!
([\2258](https://github.com/psf/requests/pull/2258))
- Support for bytestring URLs on Python 3.x
([\2238](https://github.com/psf/requests/pull/2238))

**Bugfixes**

- Avoid getting stuck in a loop
([\2244](https://github.com/psf/requests/pull/2244))
- Multiple calls to iter\* fail with unhelpful error.
([\2240](https://github.com/psf/requests/issues/2240),
[\2241](https://github.com/psf/requests/issues/2241))

**Documentation**

- Correct redirection introduction
([\2245](https://github.com/psf/requests/pull/2245/))
- Added example of how to send multiple files in one request.
([\2227](https://github.com/psf/requests/pull/2227/))
- Clarify how to pass a custom set of CAs
([\2248](https://github.com/psf/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.