A fix for a DeprecationWarning (#17678) had the unfortunate side effect of changing the expected interface of the request object higher up in the call stack.

For example, the documentation for CookieJar.add_cookie_header(request) states that the request object must support the methods get_full_url(), get_host(), get_type(), unverifiable(), get_origin_req_host(), has_header(), get_header(), header_items(), and add_unredirected_header(). The patch for #17678, however, changes the requirement for a get_origin_req_host() method to an origin_req_host attribute.

This breaks at least one notable third-party library (Kenneth Reitz' Requests).

Requests 1.2.1 has been released to address this issue. An origin_req_host property has been added to the request object as a workaround.

The original problem of mismatched documentation and behaviour still persists.

Hello Simon,

Thanks for bringing this to attention. Since get_origin_req_host has been under deprecation was a release, I thought it was safe to remove that. Agree that documentation of "cookiejar" methods, which had a dependency on the change should have been fixed.

Here is patch attempting to do that. If this is okay, I shall go with committing this change in 3.3 and 3.4.

New changeset 26ac5b9cffda by Senthil Kumaran in branch '3.3':
Fix #18007 : Document CookieJar.add_cookie_header request parameter changes in 3.3
http://hg.python.org/cpython/rev/26ac5b9cffda

New changeset f7992397e98d by Senthil Kumaran in branch 'default':
merge from 3.3
http://hg.python.org/cpython/rev/f7992397e98d

This change is documented. Thanks for the report.