Added in rst documentation from Waldemar Osuch (issue #23), and allow over-riding accept-encoding: (issue #27), added 'b' to all open file attributes (issue #20), made changes to digest auth to be more flexible, hopefully fixing (issue #20)
diff --git a/doc/html/libhttplib2.html b/doc/html/libhttplib2.html
new file mode 100644
index 0000000..e477cad
--- /dev/null
+++ b/doc/html/libhttplib2.html
@@ -0,0 +1,441 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+ <title>httplib2 A comprehensive HTTP client library. — httplib2 v0.4 documentation</title>
+ <link rel="stylesheet" href="_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: '',
+ VERSION: '0.4',
+ COLLAPSE_MODINDEX: false,
+ FILE_SUFFIX: ''
+ };
+ </script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/interface.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <link rel="contents" title="Global table of contents" href="contents.html" />
+ <link rel="index" title="Global index" href="genindex.html" />
+ <link rel="search" title="Search" href="search.html" />
+ <link rel="top" title="httplib2 v0.4 documentation" href="index.html" />
+ <link rel="prev" title="The httplib2 Library" href="index.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="modindex.html" title="Global Module Index"
+ accesskey="M">modules</a> |</li>
+ <li class="right" >
+ <a href="index.html" title="The httplib2 Library"
+ accesskey="P">previous</a> |</li>
+ <li><a href="index.html">httplib2 v0.4 documentation</a> »</li>
+ </ul>
+ </div>
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+
+ <div class="section" id="module-httplib2">
+<h1 id="module-httplib2"><tt class="xref docutils literal"><span class="pre">httplib2</span></tt> A comprehensive HTTP client library.<a class="headerlink" href="#module-httplib2" title="Permalink to this headline">¶</a></h1>
+<p>The <tt class="xref docutils literal"><span class="pre">httplib2</span></tt> module is a comprehensive HTTP client library with the
+following features:</p>
+<dl class="describe">
+<dt>
+<tt class="descname">HTTP and HTTPS</tt></dt>
+<dd>HTTPS support is only available if the socket module was compiled with SSL
+support.</dd></dl>
+
+<dl class="describe">
+<dt>
+<tt class="descname">Keep-Alive</tt></dt>
+<dd>Supports HTTP 1.1 Keep-Alive, keeping the socket open and performing multiple
+requests over the same connection if possible.</dd></dl>
+
+<dl class="describe">
+<dt>
+<tt class="descname">Authentication</tt></dt>
+<dd><p>The following three types of HTTP Authentication are supported. These can be
+used over both HTTP and HTTPS.</p>
+<blockquote>
+<ul class="simple">
+<li>Digest</li>
+<li>Basic</li>
+<li>WSSE</li>
+</ul>
+</blockquote>
+</dd></dl>
+
+<dl class="describe">
+<dt>
+<tt class="descname">Caching</tt></dt>
+<dd>The module can optionally operate with a private cache that understands the
+Cache-Control: header and uses both the ETag and Last-Modified cache validators.</dd></dl>
+
+<dl class="describe">
+<dt>
+<tt class="descname">All Methods</tt></dt>
+<dd>The module can handle any HTTP request method, not just GET and POST.</dd></dl>
+
+<dl class="describe">
+<dt>
+<tt class="descname">Redirects</tt></dt>
+<dd>Automatically follows 3XX redirects on GETs.</dd></dl>
+
+<dl class="describe">
+<dt>
+<tt class="descname">Compression</tt></dt>
+<dd>Handles both <tt class="docutils literal"><span class="pre">deflate</span></tt> and <tt class="docutils literal"><span class="pre">gzip</span></tt> types of compression.</dd></dl>
+
+<dl class="describe">
+<dt>
+<tt class="descname">Lost update support</tt></dt>
+<dd>Automatically adds back ETags into PUT requests to resources we have already
+cached. This implements Section 3.2 of Detecting the Lost Update Problem Using
+Unreserved Checkout</dd></dl>
+
+<p>The <tt class="xref docutils literal"><span class="pre">httplib2</span></tt> module defines the following variables:</p>
+<dl class="data">
+<dt id="httplib2.debuglevel">
+<!--[httplib2.debuglevel]--><tt class="descclassname">httplib2.</tt><tt class="descname">debuglevel</tt><a class="headerlink" href="#httplib2.debuglevel" title="Permalink to this definition">¶</a></dt>
+<dd>The amount of debugging information to print. The default is 0.</dd></dl>
+
+<p>The <tt class="xref docutils literal"><span class="pre">httplib2</span></tt> module may raise the following Exceptions. Note that there
+is an option that turns exceptions into normal responses with an HTTP status
+code indicating an error occured. See
+<a title="httplib2.Http.force_exception_to_status_code" class="reference internal" href="#httplib2.Http.force_exception_to_status_code"><tt class="xref docutils literal"><span class="pre">Http.force_exception_to_status_code</span></tt></a></p>
+<dl class="exception">
+<dt id="httplib2.HttpLib2Error">
+<!--[httplib2.HttpLib2Error]-->exception <tt class="descclassname">httplib2.</tt><tt class="descname">HttpLib2Error</tt><a class="headerlink" href="#httplib2.HttpLib2Error" title="Permalink to this definition">¶</a></dt>
+<dd>The Base Exception for all exceptions raised by httplib2.</dd></dl>
+
+<dl class="exception">
+<dt id="httplib2.RedirectMissingLocation">
+<!--[httplib2.RedirectMissingLocation]-->exception <tt class="descclassname">httplib2.</tt><tt class="descname">RedirectMissingLocation</tt><a class="headerlink" href="#httplib2.RedirectMissingLocation" title="Permalink to this definition">¶</a></dt>
+<dd>A 3xx redirect response code was provided but no Location: header was provided
+to point to the new location.</dd></dl>
+
+<dl class="exception">
+<dt id="httplib2.RedirectLimit">
+<!--[httplib2.RedirectLimit]-->exception <tt class="descclassname">httplib2.</tt><tt class="descname">RedirectLimit</tt><a class="headerlink" href="#httplib2.RedirectLimit" title="Permalink to this definition">¶</a></dt>
+<dd>The maximum number of redirections was reached without coming to a final URI.</dd></dl>
+
+<dl class="exception">
+<dt id="httplib2.ServerNotFoundError">
+<!--[httplib2.ServerNotFoundError]-->exception <tt class="descclassname">httplib2.</tt><tt class="descname">ServerNotFoundError</tt><a class="headerlink" href="#httplib2.ServerNotFoundError" title="Permalink to this definition">¶</a></dt>
+<dd>Unable to resolve the host name given.</dd></dl>
+
+<dl class="exception">
+<dt id="httplib2.RelativeURIError">
+<!--[httplib2.RelativeURIError]-->exception <tt class="descclassname">httplib2.</tt><tt class="descname">RelativeURIError</tt><a class="headerlink" href="#httplib2.RelativeURIError" title="Permalink to this definition">¶</a></dt>
+<dd>A relative, as opposed to an absolute URI, was passed into request().</dd></dl>
+
+<dl class="exception">
+<dt id="httplib2.FailedToDecompressContent">
+<!--[httplib2.FailedToDecompressContent]-->exception <tt class="descclassname">httplib2.</tt><tt class="descname">FailedToDecompressContent</tt><a class="headerlink" href="#httplib2.FailedToDecompressContent" title="Permalink to this definition">¶</a></dt>
+<dd>The headers claimed that the content of the response was compressed but the
+decompression algorithm applied to the content failed.</dd></dl>
+
+<dl class="exception">
+<dt id="httplib2.UnimplementedDigestAuthOptionError">
+<!--[httplib2.UnimplementedDigestAuthOptionError]-->exception <tt class="descclassname">httplib2.</tt><tt class="descname">UnimplementedDigestAuthOptionError</tt><a class="headerlink" href="#httplib2.UnimplementedDigestAuthOptionError" title="Permalink to this definition">¶</a></dt>
+<dd>The server requested a type of Digest authentication that we are unfamiliar
+with.</dd></dl>
+
+<dl class="exception">
+<dt id="httplib2.UnimplementedHmacDigestAuthOptionError">
+<!--[httplib2.UnimplementedHmacDigestAuthOptionError]-->exception <tt class="descclassname">httplib2.</tt><tt class="descname">UnimplementedHmacDigestAuthOptionError</tt><a class="headerlink" href="#httplib2.UnimplementedHmacDigestAuthOptionError" title="Permalink to this definition">¶</a></dt>
+<dd>The server requested a type of HMACDigest authentication that we are unfamiliar
+with.</dd></dl>
+
+<dl class="class">
+<dt id="httplib2.Http">
+<!--[httplib2.Http]-->class <tt class="descclassname">httplib2.</tt><tt class="descname">Http</tt><big>(</big><span class="optional">[</span><em>cache=None</em><span class="optional">]</span><span class="optional">[</span>, <em>timeout=None</em><span class="optional">]</span><big>)</big><a class="headerlink" href="#httplib2.Http" title="Permalink to this definition">¶</a></dt>
+<dd>The class that represents a client HTTP interface. The <em>cache</em> parameter is
+either the name of a directory to be used as a flat file cache, or it must an
+object that implements the required caching interface. The <em>timeout</em> parameter
+is the socket level timeout.</dd></dl>
+
+<dl class="class">
+<dt id="httplib2.Response">
+<!--[httplib2.Response]-->class <tt class="descclassname">httplib2.</tt><tt class="descname">Response</tt><big>(</big><em>info</em><big>)</big><a class="headerlink" href="#httplib2.Response" title="Permalink to this definition">¶</a></dt>
+<dd>Response is a subclass of <tt class="xref docutils literal"><span class="pre">dict</span></tt> and instances of this class are
+returned from calls to Http.request. The <em>info</em> parameter is either an
+<tt class="xref docutils literal"><span class="pre">rfc822.Message</span></tt> or an <tt class="xref docutils literal"><span class="pre">httplib.HTTPResponse</span></tt> object.</dd></dl>
+
+<dl class="class">
+<dt id="httplib2.FileCache">
+<!--[httplib2.FileCache]-->class <tt class="descclassname">httplib2.</tt><tt class="descname">FileCache</tt><big>(</big><em>dir_name</em><span class="optional">[</span>, <em>safe=safename</em><span class="optional">]</span><big>)</big><a class="headerlink" href="#httplib2.FileCache" title="Permalink to this definition">¶</a></dt>
+<dd>FileCache implements a Cache as a directory of files. The <em>dir_name</em> parameter
+is the name of the directory to use. If the directory does not exist then
+FileCache attempts to create the directory. The optional <em>safe</em> parameter is a
+funtion which generates the cache filename for each URI. A FileCache object is
+constructed and used for caching when you pass a directory name into the
+constructor of <a title="httplib2.Http" class="reference internal" href="#httplib2.Http"><tt class="xref docutils literal"><span class="pre">Http</span></tt></a>.</dd></dl>
+
+<p>Http objects have the following methods:</p>
+<div class="section" id="id1">
+<span id="http-objects"></span><h2 id="id1"><span id="http-objects"></span>Http Objects<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
+<dl class="method">
+<dt id="httplib2.Http.request">
+<!--[httplib2.Http.request]--><tt class="descclassname">Http.</tt><tt class="descname">request</tt><big>(</big><em>uri</em><span class="optional">[</span>, <em>method="GET"</em>, <em>body=None</em>, <em>headers=None</em>, <em>redirections=DEFAULT_MAX_REDIRECTS</em>, <em>connection_type=None</em><span class="optional">]</span><big>)</big><a class="headerlink" href="#httplib2.Http.request" title="Permalink to this definition">¶</a></dt>
+<dd><p>Performs a single HTTP request. The <em>uri</em> is the URI of the HTTP resource and
+can begin with either <tt class="docutils literal"><span class="pre">http</span></tt> or <tt class="docutils literal"><span class="pre">https</span></tt>. The value of <em>uri</em> must be an
+absolute URI.</p>
+<p>The <em>method</em> is the HTTP method to perform, such as <tt class="docutils literal"><span class="pre">GET</span></tt>, <tt class="docutils literal"><span class="pre">POST</span></tt>,
+<tt class="docutils literal"><span class="pre">DELETE</span></tt>, etc. There is no restriction on the methods allowed.</p>
+<p>The <em>body</em> is the entity body to be sent with the request. It is a string
+object.</p>
+<p>Any extra headers that are to be sent with the request should be provided in the
+<em>headers</em> dictionary.</p>
+<p>The maximum number of redirect to follow before raising an exception is
+<em>redirections</em>. The default is 5.</p>
+<p>The <em>connection_type</em> is the type of connection object to use. The supplied
+class should implement the interface of httplib.HTTPConnection.</p>
+<p>The return value is a tuple of (response, content), the first being and instance
+of the <a title="httplib2.Response" class="reference internal" href="#httplib2.Response"><tt class="xref docutils literal"><span class="pre">Response</span></tt></a> class, the second being a string that contains the
+response entity body.</p>
+</dd></dl>
+
+<dl class="method">
+<dt id="httplib2.Http.add_credentials">
+<!--[httplib2.Http.add_credentials]--><tt class="descclassname">Http.</tt><tt class="descname">add_credentials</tt><big>(</big><em>name</em>, <em>password</em><span class="optional">[</span>, <em>domain=None</em><span class="optional">]</span><big>)</big><a class="headerlink" href="#httplib2.Http.add_credentials" title="Permalink to this definition">¶</a></dt>
+<dd>Adds a name and password that will be used when a request requires
+authentication. Supplying the optional <em>domain</em> name will restrict these
+credentials to only be sent to the specified domain. If <em>domain</em> is not
+specified then the given credentials will be used to try to satisfy every HTTP
+401 challenge.</dd></dl>
+
+<dl class="method">
+<dt id="httplib2.Http.add_certificate">
+<!--[httplib2.Http.add_certificate]--><tt class="descclassname">Http.</tt><tt class="descname">add_certificate</tt><big>(</big><em>key</em>, <em>cert</em>, <em>domain</em><big>)</big><a class="headerlink" href="#httplib2.Http.add_certificate" title="Permalink to this definition">¶</a></dt>
+<dd>Add a <em>key</em> and <em>cert</em> that will be used for an SSL connection to the specified
+domain. <em>keyfile</em> is the name of a PEM formatted file that contains your
+private key. <em>certfile</em> is a PEM formatted certificate chain file.</dd></dl>
+
+<dl class="method">
+<dt id="httplib2.Http.clear_credentials">
+<!--[httplib2.Http.clear_credentials]--><tt class="descclassname">Http.</tt><tt class="descname">clear_credentials</tt><big>(</big><big>)</big><a class="headerlink" href="#httplib2.Http.clear_credentials" title="Permalink to this definition">¶</a></dt>
+<dd>Remove all the names and passwords used for authentication.</dd></dl>
+
+<dl class="attribute">
+<dt id="httplib2.Http.follow_redirects">
+<!--[httplib2.Http.follow_redirects]--><tt class="descclassname">Http.</tt><tt class="descname">follow_redirects</tt><a class="headerlink" href="#httplib2.Http.follow_redirects" title="Permalink to this definition">¶</a></dt>
+<dd>If <tt class="xref docutils literal"><span class="pre">True</span></tt>, which is the default, safe redirects are followed, where safe means
+that the client is only doing a <tt class="docutils literal"><span class="pre">GET</span></tt> or <tt class="docutils literal"><span class="pre">HEAD</span></tt> on the URI to which it is
+being redirected. If <tt class="xref docutils literal"><span class="pre">False</span></tt> then no redirects are followed. Note that a False
+‘follow_redirects’ takes precedence over a True ‘follow_all_redirects’. Another
+way of saying that is for ‘follow_all_redirects’ to have any affect,
+‘follow_redirects’ must be True.</dd></dl>
+
+<dl class="attribute">
+<dt id="httplib2.Http.follow_all_redirects">
+<!--[httplib2.Http.follow_all_redirects]--><tt class="descclassname">Http.</tt><tt class="descname">follow_all_redirects</tt><a class="headerlink" href="#httplib2.Http.follow_all_redirects" title="Permalink to this definition">¶</a></dt>
+<dd>If <tt class="xref docutils literal"><span class="pre">False</span></tt>, which is the default, only safe redirects are followed, where safe
+means that the client is only doing a <tt class="docutils literal"><span class="pre">GET</span></tt> or <tt class="docutils literal"><span class="pre">HEAD</span></tt> on the URI to which it
+is being redirected. If <tt class="xref docutils literal"><span class="pre">True</span></tt> then all redirects are followed. Note that a
+False ‘follow_redirects’ takes precedence over a True ‘follow_all_redirects’.
+Another way of saying that is for ‘follow_all_redirects’ to have any affect,
+‘follow_redirects’ must be True.</dd></dl>
+
+<dl class="attribute">
+<dt id="httplib2.Http.force_exception_to_status_code">
+<!--[httplib2.Http.force_exception_to_status_code]--><tt class="descclassname">Http.</tt><tt class="descname">force_exception_to_status_code</tt><a class="headerlink" href="#httplib2.Http.force_exception_to_status_code" title="Permalink to this definition">¶</a></dt>
+<dd><p>If <tt class="xref docutils literal"><span class="pre">True</span></tt>, which is the default, then no <tt class="xref docutils literal"><span class="pre">httplib2</span></tt> exceptions will be
+thrown. Instead, those error conditions will be turned into <a title="httplib2.Response" class="reference internal" href="#httplib2.Response"><tt class="xref docutils literal"><span class="pre">Response</span></tt></a>
+objects that will be returned normally.</p>
+<p>If <tt class="xref docutils literal"><span class="pre">False</span></tt>, then exceptions will be thrown.</p>
+</dd></dl>
+
+<dl class="attribute">
+<dt id="httplib2.Http.ignore_etag">
+<!--[httplib2.Http.ignore_etag]--><tt class="descclassname">Http.</tt><tt class="descname">ignore_etag</tt><a class="headerlink" href="#httplib2.Http.ignore_etag" title="Permalink to this definition">¶</a></dt>
+<dd>Defaults to <tt class="xref docutils literal"><span class="pre">False</span></tt>. If <tt class="xref docutils literal"><span class="pre">True</span></tt>, then any etags present in the cached
+response are ignored when processing the current request, i.e. httplib2 does
+<strong>not</strong> use ‘if-match’ for PUT or ‘if-none-match’ when GET or HEAD requests are
+made. This is mainly to deal with broken servers which supply an etag, but
+change it capriciously.</dd></dl>
+
+<p>If you wish to supply your own caching implementation then you will need to pass
+in an object that supports the following methods. Note that the <tt class="xref docutils literal"><span class="pre">memcache</span></tt>
+module supports this interface natively.</p>
+</div>
+<div class="section" id="id2">
+<span id="cache-objects"></span><h2 id="id2"><span id="cache-objects"></span>Cache Objects<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
+<dl class="method">
+<dt id="httplib2.Cache.get">
+<!--[httplib2.Cache.get]--><tt class="descclassname">Cache.</tt><tt class="descname">get</tt><big>(</big><em>key</em><big>)</big><a class="headerlink" href="#httplib2.Cache.get" title="Permalink to this definition">¶</a></dt>
+<dd>Takes a string <em>key</em> and returns the value as a string.</dd></dl>
+
+<dl class="method">
+<dt id="httplib2.Cache.set">
+<!--[httplib2.Cache.set]--><tt class="descclassname">Cache.</tt><tt class="descname">set</tt><big>(</big><em>key</em>, <em>value</em><big>)</big><a class="headerlink" href="#httplib2.Cache.set" title="Permalink to this definition">¶</a></dt>
+<dd>Takes a string <em>key</em> and <em>value</em> and stores it in the cache.</dd></dl>
+
+<dl class="method">
+<dt id="httplib2.Cache.delete">
+<!--[httplib2.Cache.delete]--><tt class="descclassname">Cache.</tt><tt class="descname">delete</tt><big>(</big><em>key</em><big>)</big><a class="headerlink" href="#httplib2.Cache.delete" title="Permalink to this definition">¶</a></dt>
+<dd>Deletes the cached value stored at <em>key</em>. The value of <em>key</em> is a string.</dd></dl>
+
+<p>Response objects are derived from <tt class="xref docutils literal"><span class="pre">dict</span></tt> and map header names (lower case
+with the trailing colon removed) to header values. In addition to the dict
+methods a Response object also has:</p>
+</div>
+<div class="section" id="id3">
+<span id="response-objects"></span><h2 id="id3"><span id="response-objects"></span>Response Objects<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h2>
+<dl class="attribute">
+<dt id="httplib2.Response.fromcache">
+<!--[httplib2.Response.fromcache]--><tt class="descclassname">Response.</tt><tt class="descname">fromcache</tt><a class="headerlink" href="#httplib2.Response.fromcache" title="Permalink to this definition">¶</a></dt>
+<dd>If <tt class="docutils literal"><span class="pre">true</span></tt> the the response was returned from the cache.</dd></dl>
+
+<dl class="attribute">
+<dt id="httplib2.Response.version">
+<!--[httplib2.Response.version]--><tt class="descclassname">Response.</tt><tt class="descname">version</tt><a class="headerlink" href="#httplib2.Response.version" title="Permalink to this definition">¶</a></dt>
+<dd>The version of HTTP that the server supports. A value of 11 means ‘1.1’.</dd></dl>
+
+<dl class="attribute">
+<dt id="httplib2.Response.status">
+<!--[httplib2.Response.status]--><tt class="descclassname">Response.</tt><tt class="descname">status</tt><a class="headerlink" href="#httplib2.Response.status" title="Permalink to this definition">¶</a></dt>
+<dd>The numerical HTTP status code returned in the response.</dd></dl>
+
+<dl class="attribute">
+<dt id="httplib2.Response.reason">
+<!--[httplib2.Response.reason]--><tt class="descclassname">Response.</tt><tt class="descname">reason</tt><a class="headerlink" href="#httplib2.Response.reason" title="Permalink to this definition">¶</a></dt>
+<dd>The human readable component of the HTTP response status code.</dd></dl>
+
+<dl class="attribute">
+<dt id="httplib2.Response.previous">
+<!--[httplib2.Response.previous]--><tt class="descclassname">Response.</tt><tt class="descname">previous</tt><a class="headerlink" href="#httplib2.Response.previous" title="Permalink to this definition">¶</a></dt>
+<dd>If redirects are followed then the <a title="httplib2.Response" class="reference internal" href="#httplib2.Response"><tt class="xref docutils literal"><span class="pre">Response</span></tt></a> object returned is just for
+the very last HTTP request and <em>previous</em> points to the previous
+<a title="httplib2.Response" class="reference internal" href="#httplib2.Response"><tt class="xref docutils literal"><span class="pre">Response</span></tt></a> object. In this manner they form a chain going back through
+the responses to the very first response. Will be <tt class="xref docutils literal"><span class="pre">None</span></tt> if there are no
+previous respones.</dd></dl>
+
+<p>The Response object also populates the header <tt class="docutils literal"><span class="pre">content-location</span></tt>, that
+contains the URI that was ultimately requested. This is useful if redirects were
+encountered, you can determine the ultimate URI that the request was sent to.
+All Response objects contain this key value, including <tt class="docutils literal"><span class="pre">previous</span></tt> responses so
+you can determine the entire chain of redirects. If
+<a title="httplib2.Http.force_exception_to_status_code" class="reference internal" href="#httplib2.Http.force_exception_to_status_code"><tt class="xref docutils literal"><span class="pre">Http.force_exception_to_status_code</span></tt></a> is <tt class="xref docutils literal"><span class="pre">True</span></tt> and the number of
+redirects has exceeded the number of allowed number of redirects then the
+<a title="httplib2.Response" class="reference internal" href="#httplib2.Response"><tt class="xref docutils literal"><span class="pre">Response</span></tt></a> object will report the error in the status code, but the
+complete chain of previous responses will still be in tact.</p>
+<p>To do a simple <tt class="docutils literal"><span class="pre">GET</span></tt> request just supply the absolute URI of the resource:</p>
+</div>
+<div class="section" id="examples">
+<span id="httplib2-example"></span><h2 id="examples"><span id="httplib2-example"></span>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
+<div class="highlight"><pre><span class="kn">import</span> <span class="nn">httplib2</span>
+<span class="n">h</span> <span class="o">=</span> <span class="n">httplib2</span><span class="o">.</span><span class="n">Http</span><span class="p">()</span>
+<span class="n">resp</span><span class="p">,</span> <span class="n">content</span> <span class="o">=</span> <span class="n">h</span><span class="o">.</span><span class="n">request</span><span class="p">(</span><span class="s">"http://bitworking.org/"</span><span class="p">)</span>
+<span class="k">assert</span> <span class="n">resp</span><span class="o">.</span><span class="n">status</span> <span class="o">==</span> <span class="mf">200</span>
+<span class="k">assert</span> <span class="n">resp</span><span class="p">[</span><span class="s">'content-type'</span><span class="p">]</span> <span class="o">==</span> <span class="s">'text/html'</span>
+</pre></div>
+<p>Here is more complex example that does a PUT of some text to a resource that
+requires authentication. The Http instance also uses a file cache in the
+directory <tt class="docutils literal"><span class="pre">.cache</span></tt>.</p>
+<div class="highlight"><pre><span class="kn">import</span> <span class="nn">httplib2</span>
+<span class="n">h</span> <span class="o">=</span> <span class="n">httplib2</span><span class="o">.</span><span class="n">Http</span><span class="p">(</span><span class="s">".cache"</span><span class="p">)</span>
+<span class="n">h</span><span class="o">.</span><span class="n">add_credentials</span><span class="p">(</span><span class="s">'name'</span><span class="p">,</span> <span class="s">'password'</span><span class="p">)</span>
+<span class="n">resp</span><span class="p">,</span> <span class="n">content</span> <span class="o">=</span> <span class="n">h</span><span class="o">.</span><span class="n">request</span><span class="p">(</span><span class="s">"https://example.org/chap/2"</span><span class="p">,</span>
+ <span class="s">"PUT"</span><span class="p">,</span> <span class="n">body</span><span class="o">=</span><span class="s">"This is text"</span><span class="p">,</span>
+ <span class="n">headers</span><span class="o">=</span><span class="p">{</span><span class="s">'content-type'</span><span class="p">:</span><span class="s">'text/plain'</span><span class="p">}</span> <span class="p">)</span>
+</pre></div>
+<p>Here is an example that connects to a server that supports the Atom Publishing
+Protocol.</p>
+<div class="highlight"><pre><span class="kn">import</span> <span class="nn">httplib2</span>
+<span class="n">h</span> <span class="o">=</span> <span class="n">httplib2</span><span class="o">.</span><span class="n">Http</span><span class="p">()</span>
+<span class="n">h</span><span class="o">.</span><span class="n">add_credentials</span><span class="p">(</span><span class="n">myname</span><span class="p">,</span> <span class="n">mypasswd</span><span class="p">)</span>
+<span class="n">h</span><span class="o">.</span><span class="n">follow_all_redirects</span> <span class="o">=</span> <span class="bp">True</span>
+<span class="n">headers</span> <span class="o">=</span> <span class="p">{</span><span class="s">'Content-Type'</span><span class="p">:</span> <span class="s">'application/atom+xml'</span><span class="p">}</span>
+<span class="n">body</span> <span class="o">=</span> <span class="s">"""<?xml version="1.0" ?></span>
+<span class="s"> <entry xmlns="http://www.w3.org/2005/Atom"></span>
+<span class="s"> <title>Atom-Powered Robots Run Amok</title></span>
+<span class="s"> <id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id></span>
+<span class="s"> <updated>2003-12-13T18:30:02Z</updated></span>
+<span class="s"> <author><name>John Doe</name></author></span>
+<span class="s"> <content>Some text.</content></span>
+<span class="s"></entry></span>
+<span class="s">"""</span>
+<span class="n">uri</span> <span class="o">=</span> <span class="s">"http://www.example.com/collection/"</span>
+<span class="n">resp</span><span class="p">,</span> <span class="n">content</span> <span class="o">=</span> <span class="n">h</span><span class="o">.</span><span class="n">request</span><span class="p">(</span><span class="n">uri</span><span class="p">,</span> <span class="s">"POST"</span><span class="p">,</span> <span class="n">body</span><span class="o">=</span><span class="n">body</span><span class="p">,</span> <span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">)</span>
+</pre></div>
+<p>Here is an example of providing data to an HTML form processor. In this case we
+presume this is a POST form. We need to take our data and format it as
+“application/x-www-form-urlencoded” data and use that as a body for a POST
+request.</p>
+<div class="highlight"><pre><span class="gp">>>> </span><span class="kn">import</span> <span class="nn">httplib2</span>
+<span class="gp">>>> </span><span class="kn">import</span> <span class="nn">urllib</span>
+<span class="gp">>>> </span><span class="n">data</span> <span class="o">=</span> <span class="p">{</span><span class="s">'name'</span><span class="p">:</span> <span class="s">'fred'</span><span class="p">,</span> <span class="s">'address'</span><span class="p">:</span> <span class="s">'123 shady lane'</span><span class="p">}</span>
+<span class="gp">>>> </span><span class="n">body</span> <span class="o">=</span> <span class="n">urllib</span><span class="o">.</span><span class="n">urlencode</span><span class="p">(</span><span class="n">data</span><span class="p">)</span>
+<span class="gp">>>> </span><span class="n">body</span>
+<span class="go">'name=fred&address=123+shady+lane'</span>
+<span class="gp">>>> </span><span class="n">h</span> <span class="o">=</span> <span class="n">httplib2</span><span class="o">.</span><span class="n">Http</span><span class="p">()</span>
+<span class="gp">>>> </span><span class="n">resp</span><span class="p">,</span> <span class="n">content</span> <span class="o">=</span> <span class="n">h</span><span class="o">.</span><span class="n">request</span><span class="p">(</span><span class="s">"http://example.com"</span><span class="p">,</span> <span class="n">method</span><span class="o">=</span><span class="s">"POST"</span><span class="p">,</span> <span class="n">body</span><span class="o">=</span><span class="n">body</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+ <h3>Table Of Contents</h3>
+ <ul>
+<li><a class="reference external" href=""><tt class="docutils literal"><span class="pre">httplib2</span></tt> A comprehensive HTTP client library.</a><ul>
+<li><a class="reference external" href="#id1">Http Objects</a></li>
+<li><a class="reference external" href="#id2">Cache Objects</a></li>
+<li><a class="reference external" href="#id3">Response Objects</a></li>
+<li><a class="reference external" href="#examples">Examples</a></li>
+</ul>
+</li>
+</ul>
+
+ <h4>Previous topic</h4>
+ <p class="topless"><a href="index.html" title="previous chapter">The httplib2 Library</a></p>
+ <h3>This Page</h3>
+ <ul class="this-page-menu">
+ <li><a href="_sources/libhttplib2.txt">Show Source</a></li>
+ </ul>
+ <h3>Quick search</h3>
+ <form class="search" action="search.html" method="get">
+ <input type="text" name="q" size="18" /> <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="modindex.html" title="Global Module Index"
+ accesskey="M">modules</a> |</li>
+ <li class="right" >
+ <a href="index.html" title="The httplib2 Library"
+ accesskey="P">previous</a> |</li>
+ <li><a href="index.html">httplib2 v0.4 documentation</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2008, Joe Gregorio.
+ Last updated on Sep 05, 2008.
+ Created using <a href="http://sphinx.pocoo.org/">Sphinx</a>.
+ </div>
+ </body>
+</html>
\ No newline at end of file