From 2c6ca8adb3739abc10e390ff497427758b6ed8c5 Mon Sep 17 00:00:00 2001 From: Benjamin Peterson Date: Mon, 20 Apr 2015 18:20:27 -0400 Subject: recommend requests library (closes #23989) Patch by Van Lindberg. --- Doc/library/httplib.rst | 5 +++++ Doc/library/urllib.rst | 5 +++++ Doc/library/urllib2.rst | 5 +++++ 3 files changed, 15 insertions(+) diff --git a/Doc/library/httplib.rst b/Doc/library/httplib.rst index a4bff4f..03f4fb2 100644 --- 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 `_ + 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 b2a817d..d0cc548 100644 --- 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 `_ + 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 f599894..3fe4f25 100644 --- 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 `_ + is recommended for a higher-level http client interface. + The :mod:`urllib2` module defines the following functions: -- cgit v0.12