Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(109)

Unified Diff: recipe_engine/third_party/requests/docs/community/faq.rst

Issue 2164713003: Vendor requests. (Closed) Base URL: https://chromium.googlesource.com/external/github.com/luci/recipes-py@master
Patch Set: Fix deps.pyl Created 4 years, 5 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: recipe_engine/third_party/requests/docs/community/faq.rst
diff --git a/recipe_engine/third_party/requests/docs/community/faq.rst b/recipe_engine/third_party/requests/docs/community/faq.rst
deleted file mode 100644
index f869ee9a43d9d7fa07254c6207ffcb15168ea660..0000000000000000000000000000000000000000
--- a/recipe_engine/third_party/requests/docs/community/faq.rst
+++ /dev/null
@@ -1,88 +0,0 @@
-.. _faq:
-
-Frequently Asked Questions
-==========================
-
-This part of the documentation answers common questions about Requests.
-
-Encoded Data?
--------------
-
-Requests automatically decompresses gzip-encoded responses, and does
-its best to decode response content to unicode when possible.
-
-You can get direct access to the raw response (and even the socket),
-if needed as well.
-
-
-Custom User-Agents?
--------------------
-
-Requests allows you to easily override User-Agent strings, along with
-any other HTTP Header.
-
-
-Why not Httplib2?
------------------
-
-Chris Adams gave an excellent summary on
-`Hacker News <http://news.ycombinator.com/item?id=2884406>`_:
-
- httplib2 is part of why you should use requests: it's far more respectable
- as a client but not as well documented and it still takes way too much code
- for basic operations. I appreciate what httplib2 is trying to do, that
- there's a ton of hard low-level annoyances in building a modern HTTP
- client, but really, just use requests instead. Kenneth Reitz is very
- motivated and he gets the degree to which simple things should be simple
- whereas httplib2 feels more like an academic exercise than something
- people should use to build production systems[1].
-
- Disclosure: I'm listed in the requests AUTHORS file but can claim credit
- for, oh, about 0.0001% of the awesomeness.
-
- 1. http://code.google.com/p/httplib2/issues/detail?id=96 is a good example:
- an annoying bug which affect many people, there was a fix available for
- months, which worked great when I applied it in a fork and pounded a couple
- TB of data through it, but it took over a year to make it into trunk and
- even longer to make it onto PyPI where any other project which required "
- httplib2" would get the working version.
-
-
-Python 3 Support?
------------------
-
-Yes! Here's a list of Python platforms that are officially
-supported:
-
-* Python 2.6
-* Python 2.7
-* Python 3.1
-* Python 3.2
-* Python 3.3
-* Python 3.4
-* PyPy 1.9
-* PyPy 2.2
-
-What are "hostname doesn't match" errors?
------------------------------------------
-
-These errors occur when :ref:`SSL certificate verification <verification>`
-fails to match the certificate the server responds with to the hostname
-Requests thinks it's contacting. If you're certain the server's SSL setup is
-correct (for example, because you can visit the site with your browser) and
-you're using Python 2.6 or 2.7, a possible explanation is that you need
-Server-Name-Indication.
-
-`Server-Name-Indication`_, or SNI, is an official extension to SSL where the
-client tells the server what hostname it is contacting. This is important
-when servers are using `Virtual Hosting`_. When such servers are hosting
-more than one SSL site they need to be able to return the appropriate
-certificate based on the hostname the client is connecting to.
-
-Python3 and Python 2.7.9+ include native support for SNI in their SSL modules.
-For information on using SNI with Requests on Python < 2.7.9 refer to this
-`Stack Overflow answer`_.
-
-.. _`Server-Name-Indication`: https://en.wikipedia.org/wiki/Server_Name_Indication
-.. _`virtual hosting`: https://en.wikipedia.org/wiki/Virtual_hosting
-.. _`Stack Overflow answer`: https://stackoverflow.com/questions/18578439/using-requests-with-tls-doesnt-give-sni-support/18579484#18579484
« no previous file with comments | « recipe_engine/third_party/requests/docs/api.rst ('k') | recipe_engine/third_party/requests/docs/community/out-there.rst » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698