This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Add recommendation to use requests to the documentation, per summit
Type: enhancement Stage: resolved
Components: Documentation Versions: Python 3.5
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: Lukasa, VanL, christian.heimes, docs@python, gregory.p.smith, icordasc, martin.panter, python-dev
Priority: normal Keywords: patch

Created on 2015-04-17 18:33 by VanL, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
recommend_requests.patch VanL, 2015-04-17 18:33 Patch file for http.client.rst review
recommend_requests_2.patch VanL, 2015-04-20 20:47
Messages (4)
msg241349 - (view) Author: VanL (VanL) Date: 2015-04-17 18:33
Attached is a basic patch to add a recommendation to use requests to the http.client documentation for 3.5. It is implemented as a seealso at the top of the file: 

See Also: The Requests package is recommended for a higher-level http client interface.

If people are happy with the wording, I'll also add the same message to urllib.request and do the same with previous versions (2.7, 3.3, and 3.4).
msg241442 - (view) Author: Gregory P. Smith (gregory.p.smith) * (Python committer) Date: 2015-04-18 18:59
nice and simple. that wording looks good to me.
msg241685 - (view) Author: VanL (VanL) Date: 2015-04-20 20:47
Given the generally positive comments, here are patches for 2.7, 3.3, 3.4, and 3.5 (3.5 patch updated to also include urllib.request).
msg241690 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2015-04-20 22:22
New changeset c9239543235e by Benjamin Peterson in branch '3.4':
recommend requests library (closes #23989)
https://hg.python.org/cpython/rev/c9239543235e

New changeset 3cf2990d19ab by Benjamin Peterson in branch '2.7':
recommend requests library (closes #23989)
https://hg.python.org/cpython/rev/3cf2990d19ab

New changeset 65ce1d9eee30 by Benjamin Peterson in branch 'default':
merge 3.4 (#23989)
https://hg.python.org/cpython/rev/65ce1d9eee30
History
Date User Action Args
2022-04-11 14:58:15adminsetgithub: 68177
2015-04-20 22:22:43python-devsetstatus: open -> closed

nosy: + python-dev
messages: + msg241690

resolution: fixed
stage: resolved
2015-04-20 21:25:58christian.heimessetnosy: + christian.heimes
2015-04-20 20:47:44VanLsetfiles: + recommend_requests_2.patch

messages: + msg241685
2015-04-18 18:59:37gregory.p.smithsetnosy: + gregory.p.smith
messages: + msg241442
2015-04-17 23:46:30martin.pantersetnosy: + martin.panter
2015-04-17 19:39:28Lukasasetnosy: + Lukasa
2015-04-17 19:35:07icordascsetnosy: + icordasc
2015-04-17 18:33:42VanLcreate