third_party/gsutil/third_party/httplib2/python3/README - Issue 1377933002: [catapult] - Copy Telemetry's gsutilz over to third_party.

Unified Diff: third_party/gsutil/third_party/httplib2/python3/README

Issue 1377933002: [catapult] - Copy Telemetry's gsutilz over to third_party. (Closed) Base URL: https://github.com/catapult-project/catapult.git@master

Patch Set: Rename to gsutil. Created 5 years, 3 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

« no previous file with comments | « third_party/gsutil/third_party/httplib2/python2/httplib2test_appengine.py ('k') | third_party/gsutil/third_party/httplib2/python3/httplib2/__init__.py » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Hide Comments ('s')

Index: third_party/gsutil/third_party/httplib2/python3/README

diff --git a/third_party/gsutil/third_party/httplib2/python3/README b/third_party/gsutil/third_party/httplib2/python3/README

new file mode 100644

index 0000000000000000000000000000000000000000..5e09bc5e5d010ed13613b6d059e3845ace71a83d

--- /dev/null

+++ b/third_party/gsutil/third_party/httplib2/python3/README

@@ -0,0 +1,68 @@

+httplib2 for Python 3

+This directory contains a port of httplib2 to Python 3. As you may

+know, Python 3 is not backward-compatible with Python 2. The biggest

+change in Python 3 (that affects httplib2) is the distinction between

+bytes and strings.

+To successfully use http2lib for Python 3, you absolutely must

+understand the following sentence:

+** THE RESPONSE HEADERS ARE STRINGS, BUT THE CONTENT BODY IS BYTES **

+Example:

+>>> import httplib2, pprint

+>>> h = httplib2.Http(".cache")

+>>> (resp_headers, content) = h.request("http://example.org/", "GET")

+>>> pprint.pprint(resp_headers)

+{'accept-ranges': 'bytes',

+ 'connection': 'close',

+ 'content-length': '438',

+ 'content-location': 'http://example.org/',

+ 'content-type': 'text/html; charset=UTF-8',

+ 'date': 'Fri, 29 May 2009 03:57:29 GMT',

+ 'etag': '"b80f4-1b6-80bfd280"',

+ 'last-modified': 'Tue, 15 Nov 2005 13:24:10 GMT',

+ 'server': 'Apache/2.2.3 (CentOS)',

+ 'status': '200'}

+>>> type(content)

+<class 'bytes'>

+>>> content[:49]

+b'<HTML>\r\n<HEAD>\r\n <TITLE>Example Web Page</TITLE>'

+Further reading:

+ * http://diveintopython3.org/strings.html

+ * http://docs.python.org/3.0/whatsnew/3.0.html#text-vs-data-instead-of-unicode-vs-8-bit

+ * http://docs.python.org/3.0/howto/unicode.html

+--------------------------------------------------------------------

+Httplib2 Software License

+Permission is hereby granted, free of charge, to any person

+obtaining a copy of this software and associated documentation

+files (the "Software"), to deal in the Software without restriction,

+including without limitation the rights to use, copy, modify, merge,

+publish, distribute, sublicense, and/or sell copies of the Software,

+and to permit persons to whom the Software is furnished to do so,

+subject to the following conditions:

+The above copyright notice and this permission notice shall be

+included in all copies or substantial portions of the Software.

+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES

+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS

+BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN

+ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN

+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

+SOFTWARE.