[Python-checkins] cpython (2.7): recommend requests library (closes #23989)

[benjamin.peterson]

https://hg.python.org/cpython/rev/3cf2990d19ab
changeset:   95746:3cf2990d19ab
branch:      2.7
parent:      95739:8ab077c22fbf
user:        Benjamin Peterson <benjamin at python.org>
date:        Mon Apr 20 18:20:27 2015 -0400
summary:
  recommend requests library (closes #23989)

Patch by Van Lindberg.

files:
  Doc/library/httplib.rst |  5 +++++
  Doc/library/urllib.rst  |  5 +++++
  Doc/library/urllib2.rst |  5 +++++
  3 files changed, 15 insertions(+), 0 deletions(-)


diff --git a/Doc/library/httplib.rst b/Doc/library/httplib.rst
--- a/Doc/library/httplib.rst
+++ b/Doc/library/httplib.rst
@@ -24,6 +24,11 @@
 HTTPS protocols.  It is normally not used directly --- the module :mod:`urllib`
 uses it to handle URLs that use HTTP and HTTPS.
 
+.. seealso::
+
+    The `Requests package <http://requests.readthedocs.org/>`_
+    is recommended for a higher-level http client interface.
+
 .. note::
 
    HTTPS support is only available if the :mod:`socket` module was compiled with
diff --git a/Doc/library/urllib.rst b/Doc/library/urllib.rst
--- a/Doc/library/urllib.rst
+++ b/Doc/library/urllib.rst
@@ -24,6 +24,11 @@
 instead of filenames.  Some restrictions apply --- it can only open URLs for
 reading, and no seek operations are available.
 
+.. seealso::
+
+    The `Requests package <http://requests.readthedocs.org/>`_
+    is recommended for a higher-level http client interface.
+
 .. warning:: When opening HTTPS URLs, it does not attempt to validate the
    server certificate.  Use at your own risk!
 
diff --git a/Doc/library/urllib2.rst b/Doc/library/urllib2.rst
--- a/Doc/library/urllib2.rst
+++ b/Doc/library/urllib2.rst
@@ -18,6 +18,11 @@
 URLs (mostly HTTP) in a complex world --- basic and digest authentication,
 redirections, cookies and more.
 
+.. seealso::
+
+    The `Requests package <http://requests.readthedocs.org/>`_
+    is recommended for a higher-level http client interface.
+
 
 The :mod:`urllib2` module defines the following functions:
 

-- 
Repository URL: https://hg.python.org/cpython