recommend requests library (closes #23989)

Patch from Van Lindberg

diff --git a/Doc/library/http.client.rst b/Doc/library/http.client.rst
index fc45103474340ee046dfbc696bc05509fe794300..632430591d93489e4edfe3782395c64126808fa2 100644 (file)
--- a/Doc/library/http.client.rst
+++ b/Doc/library/http.client.rst
@@ -19,6 +19,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.request` 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 Python was compiled with SSL support

diff --git a/Doc/library/urllib.request.rst b/Doc/library/urllib.request.rst
index 053248156b698ba4c2ec2c39780e14b3aaed8708..03ce7523da3dbf0d3ee703560a918ac3be22b6a8 100644 (file)
--- a/Doc/library/urllib.request.rst
+++ b/Doc/library/urllib.request.rst
@@ -12,6 +12,11 @@ The :mod:`urllib.request` 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:`urllib.request` module defines the following functions: