recommend requests library (closes #23989)

Patch by Van Lindberg.

diff --git a/Doc/library/httplib.rst b/Doc/library/httplib.rst
index a4bff4f230a56c756f1f42d261367f01b139fe71..03f4fb299d5eab7fff852d3aa338442e93373dfc 100644 (file)
--- a/Doc/library/httplib.rst
+++ b/Doc/library/httplib.rst
@@ -24,6 +24,11 @@ This module defines classes which implement the client side of the HTTP and
 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
index b2a817db469f89ce757c0e20f9add4ab0ee83d42..d0cc54865165cebd4f7d98d0d6e6c456ff509347 100644 (file)
--- a/Doc/library/urllib.rst
+++ b/Doc/library/urllib.rst
@@ -24,6 +24,11 @@ built-in function :func:`open`, but accepts Universal Resource Locators (URLs)
 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
index f599894adcbc2555dd4bb6b678196007d3ac2a84..3fe4f25015a65a6b504d4c1168321bccd3cb9ad9 100644 (file)
--- a/Doc/library/urllib2.rst
+++ b/Doc/library/urllib2.rst
@@ -18,6 +18,11 @@ The :mod:`urllib2` module defines functions and classes which help in opening
 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: