third_party/gsutil/third_party/httplib2/python3/README - Issue 1380943003: Roll version of gsutil to 4.15.

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

Issue 1380943003: Roll version of gsutil to 4.15. (Closed) Base URL: https://github.com/catapult-project/catapult.git@master

Patch Set: rebase Created 5 years 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.py ('k') | third_party/gsutil/third_party/httplib2/python3/httplib2/iri2uri.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

index 5e09bc5e5d010ed13613b6d059e3845ace71a83d..f4b4409f97daefddf48ad5135fd74dc186e07465 100644

--- a/third_party/gsutil/third_party/httplib2/python3/README

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

@@ -1,68 +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.

+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.