@@ -3,41 +3,41 @@ Httplib2
33--------------------------------------------------------------------
44Introduction
55
6- A comprehensive HTTP client library, httplib2.py supports many
6+ A comprehensive HTTP client library, httplib2.py supports many
77features left out of other HTTP libraries.
88
99HTTP and HTTPS
10- HTTPS support is only available if the socket module was
11- compiled with SSL support.
10+ HTTPS support is only available if the socket module was
11+ compiled with SSL support.
1212Keep-Alive
13- Supports HTTP 1.1 Keep-Alive, keeping the socket open and
14- performing multiple requests over the same connection if
15- possible.
13+ Supports HTTP 1.1 Keep-Alive, keeping the socket open and
14+ performing multiple requests over the same connection if
15+ possible.
1616Authentication
17- The following three types of HTTP Authentication are
17+ The following three types of HTTP Authentication are
1818 supported. These can be used over both HTTP and HTTPS.
1919
2020 * Digest
2121 * Basic
2222 * WSSE
2323
2424Caching
25- The module can optionally operate with a private cache that
26- understands the Cache-Control: header and uses both the ETag
27- and Last-Modified cache validators.
25+ The module can optionally operate with a private cache that
26+ understands the Cache-Control: header and uses both the ETag
27+ and Last-Modified cache validators.
2828All Methods
29- The module can handle any HTTP request method, not just GET
29+ The module can handle any HTTP request method, not just GET
3030 and POST.
3131Redirects
3232 Automatically follows 3XX redirects on GETs.
3333Compression
3434 Handles both 'deflate' and 'gzip' types of compression.
3535Lost update support
36- Automatically adds back ETags into PUT requests to resources
37- we have already cached. This implements Section 3.2 of
36+ Automatically adds back ETags into PUT requests to resources
37+ we have already cached. This implements Section 3.2 of
3838 Detecting the Lost Update Problem Using Unreserved Checkout.
3939Unit Tested
40- A large and growing set of unit tests.
40+ A large and growing set of unit tests.
4141
4242
4343For more information on this module, see:
@@ -63,16 +63,16 @@ A simple retrieval:
6363 h = httplib2.Http(".cache")
6464 (resp_headers, content) = h.request("http://example.org/", "GET")
6565
66- The 'content' is the content retrieved from the URL. The content
66+ The 'content' is the content retrieved from the URL. The content
6767is already decompressed or unzipped if necessary.
6868
6969To PUT some content to a server that uses SSL and Basic authentication:
7070
7171 import httplib2
7272 h = httplib2.Http(".cache")
7373 h.add_credentials('name', 'password')
74- (resp, content) = h.request("https://example.org/chapter/2",
75- "PUT", body="This is text",
74+ (resp, content) = h.request("https://example.org/chapter/2",
75+ "PUT", body="This is text",
7676 headers={'content-type':'text/plain'} )
7777
7878Use the Cache-Control: header to control how the caching operates.
@@ -81,42 +81,42 @@ Use the Cache-Control: header to control how the caching operates.
8181 h = httplib2.Http(".cache")
8282 (resp, content) = h.request("http://bitworking.org/", "GET")
8383 ...
84- (resp, content) = h.request("http://bitworking.org/", "GET",
84+ (resp, content) = h.request("http://bitworking.org/", "GET",
8585 headers={'cache-control':'no-cache'})
8686
87- The first request will be cached and since this is a request
88- to bitworking.org it will be set to be cached for two hours,
89- because that is how I have my server configured. Any subsequent
90- GET to that URI will return the value from the on-disk cache
91- and no request will be made to the server. You can use the
92- Cache-Control: header to change the caches behavior and in
93- this example the second request adds the Cache-Control:
94- header with a value of 'no-cache' which tells the library
95- that the cached copy must not be used when handling this request.
87+ The first request will be cached and since this is a request
88+ to bitworking.org it will be set to be cached for two hours,
89+ because that is how I have my server configured. Any subsequent
90+ GET to that URI will return the value from the on-disk cache
91+ and no request will be made to the server. You can use the
92+ Cache-Control: header to change the caches behavior and in
93+ this example the second request adds the Cache-Control:
94+ header with a value of 'no-cache' which tells the library
95+ that the cached copy must not be used when handling this request.
9696
9797
9898--------------------------------------------------------------------
9999Httplib2 Software License
100100
101101Copyright (c) 2006 by Joe Gregorio
102102
103- Permission is hereby granted, free of charge, to any person
104- obtaining a copy of this software and associated documentation
105- files (the "Software"), to deal in the Software without restriction,
106- including without limitation the rights to use, copy, modify, merge,
107- publish, distribute, sublicense, and/or sell copies of the Software,
108- and to permit persons to whom the Software is furnished to do so,
103+ Permission is hereby granted, free of charge, to any person
104+ obtaining a copy of this software and associated documentation
105+ files (the "Software"), to deal in the Software without restriction,
106+ including without limitation the rights to use, copy, modify, merge,
107+ publish, distribute, sublicense, and/or sell copies of the Software,
108+ and to permit persons to whom the Software is furnished to do so,
109109subject to the following conditions:
110110
111- The above copyright notice and this permission notice shall be
111+ The above copyright notice and this permission notice shall be
112112included in all copies or substantial portions of the Software.
113113
114- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
115- EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
116- OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
117- NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
118- BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
119- ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
120- CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
114+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
115+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
116+ OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
117+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
118+ BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
119+ ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
120+ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
121121SOFTWARE.
122122
0 commit comments