diff --git a/docs/community/recommended.rst b/docs/community/recommended.rst new file mode 100644 index 00000000..cbd18c26 --- /dev/null +++ b/docs/community/recommended.rst @@ -0,0 +1,26 @@ +.. _recommended: + +Recommended Packages +==================== + +Requests has a great variety of powerful and useful third-party extensions. +This page provides an overview of some of the best of them. + +CacheControl +------------ + +`CacheControl`_ is an extension that adds a full HTTP cache to requests. This +makes your web requests substantially more efficient, and should be used +whenever you're making a lot of web requests. + +.. _CacheControl: https://cachecontrol.readthedocs.org/en/latest/ + +Requests-Oauthlib +----------------- + +`requests-oauthlib`_ makes it possible to do the OAuth dance from requests +automatically. This is useful for the large number of websites that use OAuth +to provide authentication. It also provides a lot of tweaks that handle ways +that specific OAuth providers differ from the standard specifications. + +.. _requests-oauthlib: https://requests-oauthlib.readthedocs.org/en/latest/ diff --git a/docs/index.rst b/docs/index.rst index f013414b..12b24c9e 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -114,6 +114,7 @@ Requests ecosystem and community. :maxdepth: 1 community/faq + community/recommended community/out-there.rst community/support community/vulnerabilities