summaryrefslogtreecommitdiff
path: root/ref
diff options
context:
space:
mode:
authorjcgregorio <devnull@localhost>2007-05-03 13:20:38 +0000
committerjcgregorio <devnull@localhost>2007-05-03 13:20:38 +0000
commit88ada9a2bb559b7d79806075a363cea3ac3f7d9c (patch)
tree3f8a9d46745c334d1c5c432179080834939e13fc /ref
parent2f1e1428092ec5d2758286f20eda8fd24c3b584c (diff)
downloadhttplib2-88ada9a2bb559b7d79806075a363cea3ac3f7d9c.tar.gz
Updated docs for 'follow_redirects'
Diffstat (limited to 'ref')
-rw-r--r--ref/about.html39
-rw-r--r--ref/cache-objects.html73
-rw-r--r--ref/contents.html61
-rw-r--r--ref/http-objects.html100
-rw-r--r--ref/httplib2-example.html73
-rw-r--r--ref/img1.pngbin166 -> 147 bytes
-rw-r--r--ref/index.html71
-rw-r--r--ref/module-httplib2.html173
-rw-r--r--ref/node2.html67
-rw-r--r--ref/ref.html71
-rw-r--r--ref/response-objects.html79
11 files changed, 414 insertions, 393 deletions
diff --git a/ref/about.html b/ref/about.html
index dee4004..b452de2 100644
--- a/ref/about.html
+++ b/ref/about.html
@@ -8,26 +8,27 @@
<link rel='help' href='about.html' title='About this document...' />
<link rel="prev" href="node2.html" />
<link rel="parent" href="ref.html" />
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name='aesop' content='information' />
<title>About this document ...</title>
</head>
<body>
-<DIV CLASS="navigation">
+<div class="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="1.1.4 Examples"
href="httplib2-example.html"><img src='previous.png'
- border='0' height='32' alt='Previous Page' width='32' /></A></td>
+ border='0' height='32' alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="The httplib2 Library"
href="ref.html"><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></A></td>
+ border='0' height='32' alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><img src='next.png'
border='0' height='32' alt='Next Page' width='32' /></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -35,17 +36,17 @@
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
-<a class="sectref" rel="prev" href="httplib2-example.html">1.1.4 Examples</A>
+<a class="sectref" rel="prev" href="httplib2-example.html">1.1.4 Examples</a>
<b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" href="ref.html">The httplib2 Library</A>
+<a class="sectref" rel="parent" href="ref.html">The httplib2 Library</a>
</div>
<hr /></div>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-<H1><A NAME="SECTION003000000000000000000">
-About this document ...</A>
-</H1>
+<h1><a name="SECTION003000000000000000000">
+About this document ...</a>
+</h1>
<strong>The httplib2 Library</strong>,
Mar 8, 2007, Release 0.3
<p> This document was generated using the <a
@@ -73,23 +74,23 @@ Mar 8, 2007, Release 0.3
Petrilli.
</p>
-<DIV CLASS="navigation">
+<div class="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="1.1.4 Examples"
href="httplib2-example.html"><img src='previous.png'
- border='0' height='32' alt='Previous Page' width='32' /></A></td>
+ border='0' height='32' alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="The httplib2 Library"
href="ref.html"><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></A></td>
+ border='0' height='32' alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><img src='next.png'
border='0' height='32' alt='Next Page' width='32' /></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -97,15 +98,15 @@ Mar 8, 2007, Release 0.3
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
-<a class="sectref" rel="prev" href="httplib2-example.html">1.1.4 Examples</A>
+<a class="sectref" rel="prev" href="httplib2-example.html">1.1.4 Examples</a>
<b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" href="ref.html">The httplib2 Library</A>
+<a class="sectref" rel="parent" href="ref.html">The httplib2 Library</a>
</div>
</div>
<hr />
<span class="release-info">Release 0.3, documentation updated on Mar 8, 2007.</span>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-</BODY>
-</HTML>
+</body>
+</html>
diff --git a/ref/cache-objects.html b/ref/cache-objects.html
index b10324d..a891915 100644
--- a/ref/cache-objects.html
+++ b/ref/cache-objects.html
@@ -10,27 +10,28 @@
<link rel="prev" href="http-objects.html" />
<link rel="parent" href="module-httplib2.html" />
<link rel="next" href="response-objects.html" />
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name='aesop' content='information' />
<title>1.1.2 Cache Objects</title>
</head>
<body>
-<DIV CLASS="navigation">
+<div class="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
-<td class='online-navigation'><a rel="prev" title="1.1.1 Http Objects"
+<td class='online-navigation'><a rel="prev" title="1.1.1 http Objects"
href="http-objects.html"><img src='previous.png'
- border='0' height='32' alt='Previous Page' width='32' /></A></td>
+ border='0' height='32' alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="1.1 httplib2 A comprehensive"
href="module-httplib2.html"><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></A></td>
-<td class='online-navigation'><a rel="next" title="1.1.3 Response Objects"
+ border='0' height='32' alt='Up one Level' width='32' /></a></td>
+<td class='online-navigation'><a rel="next" title="1.1.3 response Objects"
href="response-objects.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -38,73 +39,73 @@
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
-<a class="sectref" rel="prev" href="http-objects.html">1.1.1 Http Objects</A>
+<a class="sectref" rel="prev" href="http-objects.html">1.1.1 Http Objects</a>
<b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" href="module-httplib2.html">1.1 httplib2 A comprehensive</A>
+<a class="sectref" rel="parent" href="module-httplib2.html">1.1 httplib2 A comprehensive</a>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="response-objects.html">1.1.3 Response Objects</A>
+<a class="sectref" rel="next" href="response-objects.html">1.1.3 Response Objects</a>
</div>
<hr /></div>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-<H2><A NAME="SECTION002120000000000000000"></A>
-<A NAME="cache-objects"></A>
-<BR>
+<h2><a name="SECTION002120000000000000000"></a>
+<a name="cache-objects"></a>
+<br>
1.1.2 Cache Objects
-</H2>
+</h2>
-<P>
+<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="module">memcache</tt> module
supports this interface natively.
-<P>
+<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
- <td><nobr><b><tt id='l2h-21' xml:id='l2h-21' class="method">get</tt></b>(</nobr></td>
+ <td><nobr><b><tt id='l2h-22' xml:id='l2h-22' class="method">get</tt></b>(</nobr></td>
<td><var>key</var>)</td></tr></table></dt>
<dd>
Takes a string <var>key</var> and returns the value as a string.
</dl>
-<P>
+<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
- <td><nobr><b><tt id='l2h-22' xml:id='l2h-22' class="method">set</tt></b>(</nobr></td>
+ <td><nobr><b><tt id='l2h-23' xml:id='l2h-23' class="method">set</tt></b>(</nobr></td>
<td><var>key, value</var>)</td></tr></table></dt>
<dd>
Takes a string <var>key</var> and <var>value</var> and stores it in the cache.
</dl>
-<P>
+<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
- <td><nobr><b><tt id='l2h-23' xml:id='l2h-23' class="method">delete</tt></b>(</nobr></td>
+ <td><nobr><b><tt id='l2h-24' xml:id='l2h-24' class="method">delete</tt></b>(</nobr></td>
<td><var>key</var>)</td></tr></table></dt>
<dd>
Deletes the cached value stored at <var>key</var>. The value
of <var>key</var> is a string.
</dl>
-<P>
+<p>
-<DIV CLASS="navigation">
+<div class="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
-<td class='online-navigation'><a rel="prev" title="1.1.1 Http Objects"
+<td class='online-navigation'><a rel="prev" title="1.1.1 http Objects"
href="http-objects.html"><img src='previous.png'
- border='0' height='32' alt='Previous Page' width='32' /></A></td>
+ border='0' height='32' alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="1.1 httplib2 A comprehensive"
href="module-httplib2.html"><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></A></td>
-<td class='online-navigation'><a rel="next" title="1.1.3 Response Objects"
+ border='0' height='32' alt='Up one Level' width='32' /></a></td>
+<td class='online-navigation'><a rel="next" title="1.1.3 response Objects"
href="response-objects.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -112,17 +113,17 @@ of <var>key</var> is a string.
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
-<a class="sectref" rel="prev" href="http-objects.html">1.1.1 Http Objects</A>
+<a class="sectref" rel="prev" href="http-objects.html">1.1.1 Http Objects</a>
<b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" href="module-httplib2.html">1.1 httplib2 A comprehensive</A>
+<a class="sectref" rel="parent" href="module-httplib2.html">1.1 httplib2 A comprehensive</a>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="response-objects.html">1.1.3 Response Objects</A>
+<a class="sectref" rel="next" href="response-objects.html">1.1.3 Response Objects</a>
</div>
</div>
<hr />
<span class="release-info">Release 0.3, documentation updated on Mar 8, 2007.</span>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-</BODY>
-</HTML>
+</body>
+</html>
diff --git a/ref/contents.html b/ref/contents.html
index e4fc819..cfee565 100644
--- a/ref/contents.html
+++ b/ref/contents.html
@@ -10,23 +10,24 @@
<link rel="prev" href="ref.html" />
<link rel="parent" href="ref.html" />
<link rel="next" href="node2.html" />
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name='aesop' content='information' />
<title>Contents</title>
</head>
<body>
-<DIV CLASS="navigation">
+<div class="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="The httplib2 Library"
href="ref.html"><img src='previous.png'
- border='0' height='32' alt='Previous Page' width='32' /></A></td>
+ border='0' height='32' alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="The httplib2 Library"
href="ref.html"><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></A></td>
+ border='0' height='32' alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><a rel="next" title="1. Reference"
href="node2.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
@@ -37,47 +38,47 @@
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
-<a class="sectref" rel="prev" href="ref.html">The httplib2 Library</A>
+<a class="sectref" rel="prev" href="ref.html">The httplib2 Library</a>
<b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" href="ref.html">The httplib2 Library</A>
+<a class="sectref" rel="parent" href="ref.html">The httplib2 Library</a>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="node2.html">1. Reference</A>
+<a class="sectref" rel="next" href="node2.html">1. Reference</a>
</div>
<hr /></div>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-<BR><h2><A NAME="SECTION001000000000000000000">
-Contents</A>
+<br><h2><a name="SECTION001000000000000000000">
+Contents</a>
</h2>
<!--Table of Contents-->
-<UL CLASS="TofC">
-<LI><A href="node2.html">1. Reference</a>
-<UL>
-<LI><A href="module-httplib2.html">1.1 httplib2 A comprehensive HTTP client library.</a>
-<UL>
-<LI><A href="http-objects.html">1.1.1 Http Objects</a>
-<LI><A href="cache-objects.html">1.1.2 Cache Objects</a>
-<LI><A href="response-objects.html">1.1.3 Response Objects</a>
-<LI><A href="httplib2-example.html">1.1.4 Examples</a>
+<ul class="TofC">
+<li><a href="node2.html">1. Reference</a>
+<ul>
+<li><a href="module-httplib2.html">1.1 httplib2 A comprehensive HTTP client library.</a>
+<ul>
+<li><a href="http-objects.html">1.1.1 Http Objects</a>
+<li><a href="cache-objects.html">1.1.2 Cache Objects</a>
+<li><a href="response-objects.html">1.1.3 Response Objects</a>
+<li><a href="httplib2-example.html">1.1.4 Examples</a>
</ul></ul></ul>
<!--End of Table of Contents-->
-<P>
+<p>
-<DIV CLASS="navigation">
+<div class="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="The httplib2 Library"
href="ref.html"><img src='previous.png'
- border='0' height='32' alt='Previous Page' width='32' /></A></td>
+ border='0' height='32' alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="The httplib2 Library"
href="ref.html"><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></A></td>
+ border='0' height='32' alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><a rel="next" title="1. Reference"
href="node2.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
@@ -88,17 +89,17 @@ Contents</A>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
-<a class="sectref" rel="prev" href="ref.html">The httplib2 Library</A>
+<a class="sectref" rel="prev" href="ref.html">The httplib2 Library</a>
<b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" href="ref.html">The httplib2 Library</A>
+<a class="sectref" rel="parent" href="ref.html">The httplib2 Library</a>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="node2.html">1. Reference</A>
+<a class="sectref" rel="next" href="node2.html">1. Reference</a>
</div>
</div>
<hr />
<span class="release-info">Release 0.3, documentation updated on Mar 8, 2007.</span>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-</BODY>
-</HTML>
+</body>
+</html>
diff --git a/ref/http-objects.html b/ref/http-objects.html
index 0bcce37..f09715a 100644
--- a/ref/http-objects.html
+++ b/ref/http-objects.html
@@ -10,27 +10,28 @@
<link rel="prev" href="module-httplib2.html" />
<link rel="parent" href="module-httplib2.html" />
<link rel="next" href="cache-objects.html" />
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name='aesop' content='information' />
<title>1.1.1 Http Objects</title>
</head>
<body>
-<DIV CLASS="navigation">
+<div class="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="1.1 httplib2 A comprehensive"
href="module-httplib2.html"><img src='previous.png'
- border='0' height='32' alt='Previous Page' width='32' /></A></td>
+ border='0' height='32' alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="1.1 httplib2 A comprehensive"
href="module-httplib2.html"><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></A></td>
-<td class='online-navigation'><a rel="next" title="1.1.2 Cache Objects"
+ border='0' height='32' alt='Up one Level' width='32' /></a></td>
+<td class='online-navigation'><a rel="next" title="1.1.2 cache Objects"
href="cache-objects.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -38,26 +39,26 @@
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
-<a class="sectref" rel="prev" href="module-httplib2.html">1.1 httplib2 A comprehensive</A>
+<a class="sectref" rel="prev" href="module-httplib2.html">1.1 httplib2 A comprehensive</a>
<b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" href="module-httplib2.html">1.1 httplib2 A comprehensive</A>
+<a class="sectref" rel="parent" href="module-httplib2.html">1.1 httplib2 A comprehensive</a>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="cache-objects.html">1.1.2 Cache Objects</A>
+<a class="sectref" rel="next" href="cache-objects.html">1.1.2 Cache Objects</a>
</div>
<hr /></div>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-<H2><A NAME="SECTION002110000000000000000"></A>
-<A NAME="http-objects"></A>
-<BR>
+<h2><a name="SECTION002110000000000000000"></a>
+<a name="http-objects"></a>
+<br>
1.1.1 Http Objects
-</H2>
+</h2>
-<P>
+<p>
Http objects have the following methods:
-<P>
+<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
<td><nobr><b><tt id='l2h-14' xml:id='l2h-14' class="method">request</tt></b>(</nobr></td>
<td><var>uri, </var><big>[</big><var>method="GET", body=None, headers=None, redirections=DEFAULT_MAX_REDIRECTS</var><big>]</big><var></var>)</td></tr></table></dt>
@@ -65,27 +66,27 @@ Http objects have the following methods:
Performs a single HTTP request.
The <var>uri</var> is the URI of the HTTP resource and can begin with either <code>http</code> or <code>https</code>. The value of <var>uri</var> must be an absolute URI.
-<P>
+<p>
The <var>method</var> is the HTTP method to perform, such as <code>GET</code>, <code>POST</code>, <code>DELETE</code>, etc. There is no restriction
on the methods allowed.
-<P>
+<p>
The <var>body</var> 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
<var>headers</var> dictionary.
-<P>
+<p>
The maximum number of redirect to follow before raising an exception is <var>redirections</var>. The default is 5.
-<P>
+<p>
The return value is a tuple of (response, content), the first being and instance of the
<tt class="class">Response</tt> class, the second being a string that contains the response entity body.
</dl>
-<P>
+<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
<td><nobr><b><tt id='l2h-15' xml:id='l2h-15' class="method">add_credentials</tt></b>(</nobr></td>
<td><var>name, password, </var><big>[</big><var>domain=None</var><big>]</big><var></var>)</td></tr></table></dt>
@@ -97,7 +98,7 @@ domain. If <var>domain</var> is not specified then the given credentials will
be used to try to satisfy every HTTP 401 challenge.
</dl>
-<P>
+<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
<td><nobr><b><tt id='l2h-16' xml:id='l2h-16' class="method">add_certificate</tt></b>(</nobr></td>
<td><var>key, cert, domain</var>)</td></tr></table></dt>
@@ -107,7 +108,7 @@ to the specified domain. <var>keyfile</var> is the name of a PEM formatted
file that contains your private key. <var>certfile</var> is a PEM formatted certificate chain file.
</dl>
-<P>
+<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
<td><nobr><b><tt id='l2h-17' xml:id='l2h-17' class="method">clear_credentials</tt></b>(</nobr></td>
<td><var></var>)</td></tr></table></dt>
@@ -115,27 +116,38 @@ file that contains your private key. <var>certfile</var> is a PEM formatted cert
Remove all the names and passwords used for authentication.
</dl>
-<P>
-<dl><dt><b><tt id='l2h-18' xml:id='l2h-18' class="member">follow_all_redirects</tt></b></dt>
+<p>
+<dl><dt><b><tt id='l2h-18' xml:id='l2h-18' class="member">follow_redirects</tt></b></dt>
+<dd>
+If <code>True</code>, which is the default, safe redirects are followed, where
+safe means that the client is only doing a <code>GET</code> or <code>HEAD</code> on the
+URI to which it is being redirected. If <code>False</code> 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 by True.
+</dl>
+
+<p>
+<dl><dt><b><tt id='l2h-19' xml:id='l2h-19' class="member">follow_all_redirects</tt></b></dt>
<dd>
If <code>False</code>, which is the default, only safe redirects are followed, where
safe means that the client is only doing a <code>GET</code> or <code>HEAD</code> on the
URI to which it is being redirected. If <code>True</code> then all redirects are followed.
</dl>
-<P>
-<dl><dt><b><tt id='l2h-19' xml:id='l2h-19' class="member">force_exception_to_status_code</tt></b></dt>
+<p>
+<dl><dt><b><tt id='l2h-20' xml:id='l2h-20' class="member">force_exception_to_status_code</tt></b></dt>
<dd>
If <code>True</code>, which is the default, then no <tt class="module">httplib2</tt> exceptions will be thrown. Instead,
those error conditions will be turned into <tt class="class">Response</tt> objects
that will be returned normally.
-<P>
+<p>
If <code>False</code>, then exceptions will be thrown.
</dl>
-<P>
-<dl><dt><b><tt id='l2h-20' xml:id='l2h-20' class="member">ignore_etag</tt></b></dt>
+<p>
+<dl><dt><b><tt id='l2h-21' xml:id='l2h-21' class="member">ignore_etag</tt></b></dt>
<dd>
Defaults to <code>False</code>. If <code>True</code>, then any etags present in the cached response
are ignored when processing the current request, i.e. httplib2 does <strong>not</strong> use
@@ -143,26 +155,26 @@ are ignored when processing the current request, i.e. httplib2 does <strong>not<
is mainly to deal with broken servers which supply an etag, but change it capriciously.
</dl>
-<P>
+<p>
-<DIV CLASS="navigation">
+<div class="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="1.1 httplib2 A comprehensive"
href="module-httplib2.html"><img src='previous.png'
- border='0' height='32' alt='Previous Page' width='32' /></A></td>
+ border='0' height='32' alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="1.1 httplib2 A comprehensive"
href="module-httplib2.html"><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></A></td>
-<td class='online-navigation'><a rel="next" title="1.1.2 Cache Objects"
+ border='0' height='32' alt='Up one Level' width='32' /></a></td>
+<td class='online-navigation'><a rel="next" title="1.1.2 cache Objects"
href="cache-objects.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -170,17 +182,17 @@ is mainly to deal with broken servers which supply an etag, but change it capric
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
-<a class="sectref" rel="prev" href="module-httplib2.html">1.1 httplib2 A comprehensive</A>
+<a class="sectref" rel="prev" href="module-httplib2.html">1.1 httplib2 A comprehensive</a>
<b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" href="module-httplib2.html">1.1 httplib2 A comprehensive</A>
+<a class="sectref" rel="parent" href="module-httplib2.html">1.1 httplib2 A comprehensive</a>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="cache-objects.html">1.1.2 Cache Objects</A>
+<a class="sectref" rel="next" href="cache-objects.html">1.1.2 Cache Objects</a>
</div>
</div>
<hr />
<span class="release-info">Release 0.3, documentation updated on Mar 8, 2007.</span>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-</BODY>
-</HTML>
+</body>
+</html>
diff --git a/ref/httplib2-example.html b/ref/httplib2-example.html
index 1b245a1..0543074 100644
--- a/ref/httplib2-example.html
+++ b/ref/httplib2-example.html
@@ -9,27 +9,28 @@
<link rel="prev" href="response-objects.html" />
<link rel="parent" href="module-httplib2.html" />
<link rel="next" href="about.html" />
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name='aesop' content='information' />
<title>1.1.4 Examples </title>
</head>
<body>
-<DIV CLASS="navigation">
+<div class="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
-<td class='online-navigation'><a rel="prev" title="1.1.3 Response Objects"
+<td class='online-navigation'><a rel="prev" title="1.1.3 response Objects"
href="response-objects.html"><img src='previous.png'
- border='0' height='32' alt='Previous Page' width='32' /></A></td>
+ border='0' height='32' alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="1.1 httplib2 A comprehensive"
href="module-httplib2.html"><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></A></td>
+ border='0' height='32' alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><a rel="next" title="About this document ..."
href="about.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -37,26 +38,26 @@
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
-<a class="sectref" rel="prev" href="response-objects.html">1.1.3 Response Objects</A>
+<a class="sectref" rel="prev" href="response-objects.html">1.1.3 Response Objects</a>
<b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" href="module-httplib2.html">1.1 httplib2 A comprehensive</A>
+<a class="sectref" rel="parent" href="module-httplib2.html">1.1 httplib2 A comprehensive</a>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="about.html">About this document ...</A>
+<a class="sectref" rel="next" href="about.html">About this document ...</a>
</div>
<hr /></div>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-<H2><A NAME="SECTION002140000000000000000"></A><A NAME="httplib2-example"></A>
-<BR>
+<h2><a name="SECTION002140000000000000000"></a><a name="httplib2-example"></a>
+<br>
1.1.4 Examples
-</H2>
+</h2>
-<P>
+<p>
To do a simple <code>GET</code> request just supply the absolute URI
of the resource:
-<P>
+<p>
<div class="verbatim"><pre>
import httplib2
h = httplib2.Http()
@@ -65,13 +66,13 @@ assert resp.status == 200
assert resp['content-type'] == 'text/html'
</pre></div>
-<P>
+<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 <code>.cache</code>.
-<P>
+<p>
<div class="verbatim"><pre>
import httplib2
h = httplib2.Http(".cache")
@@ -81,11 +82,11 @@ resp, content = h.request("https://example.org/chap/2",
headers={'content-type':'text/plain'} )
</pre></div>
-<P>
+<p>
Here is an example that connects to a server that
supports the Atom Publishing Protocol.
-<P>
+<p>
<div class="verbatim"><pre>
import httplib2
h = httplib2.Http()
@@ -105,13 +106,13 @@ uri = "http://www.example.com/collection/"
resp, content = h.request(uri, "POST", body=body, headers=headers)
</pre></div>
-<P>
+<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>
+<p>
<div class="verbatim"><pre>
&gt;&gt;&gt; import httplib2
&gt;&gt;&gt; import urllib
@@ -123,34 +124,34 @@ body for a POST request.
&gt;&gt;&gt; resp, content = h.request("http://example.com", method="POST", body=body)
</pre></div>
-<P>
+<p>
<IMG
WIDTH="556" HEIGHT="20" ALIGN="BOTTOM" BORDER="0"
SRC="img1.png"
ALT="\begin{center}\vbox{\input{modref.ind}
}\end{center}">
-<P>
+<p>
-<P>
+<p>
-<DIV CLASS="navigation">
+<div class="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
-<td class='online-navigation'><a rel="prev" title="1.1.3 Response Objects"
+<td class='online-navigation'><a rel="prev" title="1.1.3 response Objects"
href="response-objects.html"><img src='previous.png'
- border='0' height='32' alt='Previous Page' width='32' /></A></td>
+ border='0' height='32' alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="1.1 httplib2 A comprehensive"
href="module-httplib2.html"><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></A></td>
+ border='0' height='32' alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><a rel="next" title="About this document ..."
href="about.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -158,17 +159,17 @@ body for a POST request.
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
-<a class="sectref" rel="prev" href="response-objects.html">1.1.3 Response Objects</A>
+<a class="sectref" rel="prev" href="response-objects.html">1.1.3 Response Objects</a>
<b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" href="module-httplib2.html">1.1 httplib2 A comprehensive</A>
+<a class="sectref" rel="parent" href="module-httplib2.html">1.1 httplib2 A comprehensive</a>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="about.html">About this document ...</A>
+<a class="sectref" rel="next" href="about.html">About this document ...</a>
</div>
</div>
<hr />
<span class="release-info">Release 0.3, documentation updated on Mar 8, 2007.</span>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-</BODY>
-</HTML>
+</body>
+</html>
diff --git a/ref/img1.png b/ref/img1.png
index a337539..c9ce471 100644
--- a/ref/img1.png
+++ b/ref/img1.png
Binary files differ
diff --git a/ref/index.html b/ref/index.html
index eab247b..3627a94 100644
--- a/ref/index.html
+++ b/ref/index.html
@@ -7,25 +7,26 @@
<link rel='last' href='about.html' title='About this document...' />
<link rel='help' href='about.html' title='About this document...' />
<link rel="next" href="contents.html" />
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name='aesop' content='information' />
<title>The httplib2 Library</title>
</head>
<body>
-<DIV CLASS="navigation">
+<div class="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><img src='previous.png'
border='0' height='32' alt='Previous Page' width='32' /></td>
<td class='online-navigation'><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></td>
+ border='0' height='32' alt='Up one Level' width='32' /></td>
<td class='online-navigation'><a rel="next" title="Contents"
href="contents.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -33,13 +34,13 @@
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="contents.html">Contents</A>
+<a class="sectref" rel="next" href="contents.html">Contents</a>
</div>
<hr /></div>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-<P>
+<p>
<div class="titlepage">
<div class='center'>
@@ -54,46 +55,46 @@ Email: <span class="email">joe@bitworking.org</span>
</div>
</div>
-<P>
+<p>
-<H3>Abstract:</H3>
-<DIV CLASS="ABSTRACT">
+<h3>Abstract:</h3>
+<div class="ABSTRACT">
-<P>
+<p>
The <tt class="module">httplib2</tt> module is a comprehensive HTTP client library
that handles caching, keep-alive, compression, redirects and
many kinds of authentication.
-<P>
-</DIV>
-<P>
+<p>
+</div>
+<p>
-<P>
+<p>
<p><br /></p><hr class='online-navigation' />
<div class='online-navigation'>
<!--Table of Child-Links-->
-<A NAME="CHILD_LINKS"></a>
+<a name="CHILD_LINKS"></a>
-<UL CLASS="ChildLinks">
-<LI><A href="contents.html">Contents</a>
-<LI><A href="node2.html">1. Reference</a>
-<UL>
-<LI><A href="module-httplib2.html">1.1 <tt class="module">httplib2</tt>
+<ul class="ChildLinks">
+<li><a href="contents.html">Contents</a>
+<li><a href="node2.html">1. Reference</a>
+<ul>
+<li><a href="module-httplib2.html">1.1 <tt class="module">httplib2</tt>
A comprehensive HTTP client library.</a>
-<UL>
-<LI><A href="http-objects.html">1.1.1 Http Objects</a>
-<LI><A href="cache-objects.html">1.1.2 Cache Objects</a>
-<LI><A href="response-objects.html">1.1.3 Response Objects</a>
-<LI><A href="httplib2-example.html">1.1.4 Examples</a>
+<ul>
+<li><a href="http-objects.html">1.1.1 Http Objects</a>
+<li><a href="cache-objects.html">1.1.2 Cache Objects</a>
+<li><a href="response-objects.html">1.1.3 Response Objects</a>
+<li><a href="httplib2-example.html">1.1.4 Examples</a>
</ul>
</ul>
-<LI><A href="about.html">About this document ...</a>
+<li><a href="about.html">About this document ...</a>
</ul>
<!--End of Table of Child-Links-->
</div>
-<DIV CLASS="navigation">
+<div class="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
@@ -101,14 +102,14 @@ A comprehensive HTTP client library.</a>
<td class='online-navigation'><img src='previous.png'
border='0' height='32' alt='Previous Page' width='32' /></td>
<td class='online-navigation'><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></td>
+ border='0' height='32' alt='Up one Level' width='32' /></td>
<td class='online-navigation'><a rel="next" title="Contents"
href="contents.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -116,13 +117,13 @@ A comprehensive HTTP client library.</a>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="contents.html">Contents</A>
+<a class="sectref" rel="next" href="contents.html">Contents</a>
</div>
</div>
<hr />
<span class="release-info">Release 0.3, documentation updated on Mar 8, 2007.</span>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-</BODY>
-</HTML>
+</body>
+</html>
diff --git a/ref/module-httplib2.html b/ref/module-httplib2.html
index 254aaff..e574ff0 100644
--- a/ref/module-httplib2.html
+++ b/ref/module-httplib2.html
@@ -9,27 +9,28 @@
<link rel="prev" href="node2.html" />
<link rel="parent" href="node2.html" />
<link rel="next" href="http-objects.html" />
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name='aesop' content='information' />
<title>1.1 httplib2 A comprehensive HTTP client library. </title>
</head>
<body>
-<DIV CLASS="navigation">
+<div class="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="1. Reference"
href="node2.html"><img src='previous.png'
- border='0' height='32' alt='Previous Page' width='32' /></A></td>
+ border='0' height='32' alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="1. Reference"
href="node2.html"><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></A></td>
-<td class='online-navigation'><a rel="next" title="1.1.1 Http Objects"
+ border='0' height='32' alt='Up one Level' width='32' /></a></td>
+<td class='online-navigation'><a rel="next" title="1.1.1 http Objects"
href="http-objects.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -37,136 +38,136 @@
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
-<a class="sectref" rel="prev" href="node2.html">1. Reference</A>
+<a class="sectref" rel="prev" href="node2.html">1. Reference</a>
<b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" href="node2.html">1. Reference</A>
+<a class="sectref" rel="parent" href="node2.html">1. Reference</a>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="http-objects.html">1.1.1 Http Objects</A>
+<a class="sectref" rel="next" href="http-objects.html">1.1.1 Http Objects</a>
</div>
<hr /></div>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-<H1><A NAME="SECTION002100000000000000000">
+<h1><a name="SECTION002100000000000000000">
1.1 <tt class="module">httplib2</tt>
- A comprehensive HTTP client library. </A>
-</H1>
+ A comprehensive HTTP client library. </a>
+</h1>
-<P>
-<A NAME="module-httplib2"></A>
-<P>
+<p>
+<a name="module-httplib2"></a>
+<p>
-<P>
+<p>
-<P>
+<p>
The <tt class="module">httplib2</tt> module is a comprehensive HTTP client library with the following features:
-<P>
-<DL>
-<DT><STRONG>HTTP and HTTPS</STRONG></DT>
-<DD>HTTPS support is only available if the socket module was compiled with SSL support.
-</DD>
-<DT><STRONG>Keep-Alive</STRONG></DT>
-<DD>Supports HTTP 1.1 Keep-Alive, keeping the socket open and performing multiple requests over the same connection if possible.
-</DD>
-<DT><STRONG>Authentication</STRONG></DT>
-<DD>The following three types of HTTP Authentication are supported. These can be used over both HTTP and HTTPS.
+<p>
+<dl>
+<dt><strong>HTTP and HTTPS</strong></dt>
+<dd>HTTPS support is only available if the socket module was compiled with SSL support.
+</dd>
+<dt><strong>Keep-Alive</strong></dt>
+<dd>Supports HTTP 1.1 Keep-Alive, keeping the socket open and performing multiple requests over the same connection if possible.
+</dd>
+<dt><strong>Authentication</strong></dt>
+<dd>The following three types of HTTP Authentication are supported. These can be used over both HTTP and HTTPS.
-<UL>
-<LI>Digest
-</LI>
-<LI>Basic
-</LI>
-<LI>WSSE
+<ul>
+<li>Digest
+</li>
+<li>Basic
+</li>
+<li>WSSE
-</LI>
-</UL>
-</DD>
-<DT><STRONG>Caching</STRONG></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>
-<DT><STRONG>All Methods</STRONG></DT>
-<DD>The module can handle any HTTP request method, not just GET and POST.
-</DD>
-<DT><STRONG>Redirects</STRONG></DT>
-<DD>Automatically follows 3XX redirects on GETs.
-</DD>
-<DT><STRONG>Compression</STRONG></DT>
-<DD>Handles both 'deflate' and 'gzip' types of compression.
-</DD>
-<DT><STRONG>Lost update support</STRONG></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>
+</li>
+</ul>
+</dd>
+<dt><strong>Caching</strong></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>
+<dt><strong>All Methods</strong></dt>
+<dd>The module can handle any HTTP request method, not just GET and POST.
+</dd>
+<dt><strong>Redirects</strong></dt>
+<dd>Automatically follows 3XX redirects on GETs.
+</dd>
+<dt><strong>Compression</strong></dt>
+<dd>Handles both 'deflate' and 'gzip' types of compression.
+</dd>
+<dt><strong>Lost update support</strong></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>
+<p>
The <tt class="module">httplib2</tt> module defines the following variables:
-<P>
+<p>
<dl><dt><b><tt id='l2h-2' xml:id='l2h-2'>debuglevel</tt></b></dt>
<dd>
The amount of debugging information to print. The default is 0.
</dd></dl>
-<P>
+<p>
The <tt class="module">httplib2</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 <tt class="member">Http.force_exception_to_status_code</tt>
-<P>
+<p>
<dl><dt><b><span class="typelabel">exception</span>&nbsp;<tt id='l2h-3' xml:id='l2h-3' class="exception">HttpLib2Error</tt></b></dt>
<dd>
The Base Exception for all exceptions raised by httplib2.
</dd></dl>
-<P>
+<p>
<dl><dt><b><span class="typelabel">exception</span>&nbsp;<tt id='l2h-4' xml:id='l2h-4' class="exception">RedirectMissingLocation</tt></b></dt>
<dd>
A 3xx redirect response code was provided but no Location: header
was provided to point to the new location.
</dd></dl>
-<P>
+<p>
<dl><dt><b><span class="typelabel">exception</span>&nbsp;<tt id='l2h-5' xml:id='l2h-5' class="exception">RedirectLimit</tt></b></dt>
<dd>
The maximum number of redirections was reached without coming to a final URI.
</dd></dl>
-<P>
+<p>
<dl><dt><b><span class="typelabel">exception</span>&nbsp;<tt id='l2h-6' xml:id='l2h-6' class="exception">ServerNotFoundError</tt></b></dt>
<dd>
Unable to resolve the host name given.
</dd></dl>
-<P>
+<p>
<dl><dt><b><span class="typelabel">exception</span>&nbsp;<tt id='l2h-7' xml:id='l2h-7' class="exception">RelativeURIError</tt></b></dt>
<dd>
A relative, as opposed to an absolute URI, was passed into request().
</dd></dl>
-<P>
+<p>
<dl><dt><b><span class="typelabel">exception</span>&nbsp;<tt id='l2h-8' xml:id='l2h-8' class="exception">FailedToDecompressContent</tt></b></dt>
<dd>
The headers claimed that the content of the response was compressed but the
decompression algorithm applied to the content failed.
</dd></dl>
-<P>
+<p>
<dl><dt><b><span class="typelabel">exception</span>&nbsp;<tt id='l2h-9' xml:id='l2h-9' class="exception">UnimplementedDigestAuthOptionError</tt></b></dt>
<dd>
The server requested a type of Digest authentication that we
are unfamiliar with.
</dd></dl>
-<P>
+<p>
<dl><dt><b><span class="typelabel">exception</span>&nbsp;<tt id='l2h-10' xml:id='l2h-10' class="exception">UnimplementedHmacDigestAuthOptionError</tt></b></dt>
<dd>
The server requested a type of HMACDigest authentication that we
are unfamiliar with.
</dd></dl>
-<P>
+<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
<td><nobr><b><span class="typelabel">class</span>&nbsp;<tt id='l2h-11' xml:id='l2h-11' class="class">Http</tt></b>(</nobr></td>
<td><var></var><big>[</big><var>cache=None</var><big>]</big><var>, </var><big>[</big><var>timeout=None</var><big>]</big><var></var>)</td></tr></table></dt>
@@ -178,7 +179,7 @@ implements the required caching interface.
The <var>timeout</var> parameter is the socket level timeout.
</dl>
-<P>
+<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
<td><nobr><b><span class="typelabel">class</span>&nbsp;<tt id='l2h-12' xml:id='l2h-12' class="class">Response</tt></b>(</nobr></td>
<td><var>info</var>)</td></tr></table></dt>
@@ -189,7 +190,7 @@ to Http.request. The <var>info</var> parameter is either
an <tt class="class">rfc822.Message</tt> or an <tt class="class">httplib.HTTPResponse</tt> object.
</dl>
-<P>
+<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
<td><nobr><b><span class="typelabel">class</span>&nbsp;<tt id='l2h-13' xml:id='l2h-13' class="class">FileCache</tt></b>(</nobr></td>
<td><var>dir_name, </var><big>[</big><var>safe=safename</var><big>]</big><var></var>)</td></tr></table></dt>
@@ -204,40 +205,40 @@ constructed and used for caching when you pass a directory name
into the constructor of <tt class="class">Http</tt>.
</dl>
-<P>
+<p>
<p><br /></p><hr class='online-navigation' />
<div class='online-navigation'>
<!--Table of Child-Links-->
-<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a>
+<a name="CHILD_LINKS"><strong>Subsections</strong></a>
-<UL CLASS="ChildLinks">
-<LI><A href="http-objects.html">1.1.1 Http Objects</a>
-<LI><A href="cache-objects.html">1.1.2 Cache Objects</a>
-<LI><A href="response-objects.html">1.1.3 Response Objects</a>
-<LI><A href="httplib2-example.html">1.1.4 Examples</a>
+<ul class="ChildLinks">
+<li><a href="http-objects.html">1.1.1 Http Objects</a>
+<li><a href="cache-objects.html">1.1.2 Cache Objects</a>
+<li><a href="response-objects.html">1.1.3 Response Objects</a>
+<li><a href="httplib2-example.html">1.1.4 Examples</a>
</ul>
<!--End of Table of Child-Links-->
</div>
-<DIV CLASS="navigation">
+<div class="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="1. Reference"
href="node2.html"><img src='previous.png'
- border='0' height='32' alt='Previous Page' width='32' /></A></td>
+ border='0' height='32' alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="1. Reference"
href="node2.html"><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></A></td>
-<td class='online-navigation'><a rel="next" title="1.1.1 Http Objects"
+ border='0' height='32' alt='Up one Level' width='32' /></a></td>
+<td class='online-navigation'><a rel="next" title="1.1.1 http Objects"
href="http-objects.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -245,17 +246,17 @@ into the constructor of <tt class="class">Http</tt>.
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
-<a class="sectref" rel="prev" href="node2.html">1. Reference</A>
+<a class="sectref" rel="prev" href="node2.html">1. Reference</a>
<b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" href="node2.html">1. Reference</A>
+<a class="sectref" rel="parent" href="node2.html">1. Reference</a>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="http-objects.html">1.1.1 Http Objects</A>
+<a class="sectref" rel="next" href="http-objects.html">1.1.1 Http Objects</a>
</div>
</div>
<hr />
<span class="release-info">Release 0.3, documentation updated on Mar 8, 2007.</span>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-</BODY>
-</HTML>
+</body>
+</html>
diff --git a/ref/node2.html b/ref/node2.html
index 2f910b1..e7f5de6 100644
--- a/ref/node2.html
+++ b/ref/node2.html
@@ -10,27 +10,28 @@
<link rel="prev" href="contents.html" />
<link rel="parent" href="ref.html" />
<link rel="next" href="module-httplib2.html" />
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name='aesop' content='information' />
<title>1. Reference</title>
</head>
<body>
-<DIV CLASS="navigation">
+<div class="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="Contents"
href="contents.html"><img src='previous.png'
- border='0' height='32' alt='Previous Page' width='32' /></A></td>
+ border='0' height='32' alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="The httplib2 Library"
href="ref.html"><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></A></td>
+ border='0' height='32' alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><a rel="next" title="1.1 httplib2 A comprehensive"
href="module-httplib2.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -38,59 +39,59 @@
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
-<a class="sectref" rel="prev" href="contents.html">Contents</A>
+<a class="sectref" rel="prev" href="contents.html">Contents</a>
<b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" href="ref.html">The httplib2 Library</A>
+<a class="sectref" rel="parent" href="ref.html">The httplib2 Library</a>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="module-httplib2.html">1.1 httplib2 A comprehensive</A>
+<a class="sectref" rel="next" href="module-httplib2.html">1.1 httplib2 A comprehensive</a>
</div>
<hr /></div>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-<H1><A NAME="SECTION002000000000000000000">
-1. Reference</A>
-</H1>
+<h1><a name="SECTION002000000000000000000">
+1. Reference</a>
+</h1>
-<P>
+<p>
-<P>
+<p>
<p><br /></p><hr class='online-navigation' />
<div class='online-navigation'>
<!--Table of Child-Links-->
-<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a>
+<a name="CHILD_LINKS"><strong>Subsections</strong></a>
-<UL CLASS="ChildLinks">
-<LI><A href="module-httplib2.html">1.1 <tt class="module">httplib2</tt>
+<ul class="ChildLinks">
+<li><a href="module-httplib2.html">1.1 <tt class="module">httplib2</tt>
A comprehensive HTTP client library.</a>
-<UL>
-<LI><A href="http-objects.html">1.1.1 Http Objects</a>
-<LI><A href="cache-objects.html">1.1.2 Cache Objects</a>
-<LI><A href="response-objects.html">1.1.3 Response Objects</a>
-<LI><A href="httplib2-example.html">1.1.4 Examples</a>
+<ul>
+<li><a href="http-objects.html">1.1.1 Http Objects</a>
+<li><a href="cache-objects.html">1.1.2 Cache Objects</a>
+<li><a href="response-objects.html">1.1.3 Response Objects</a>
+<li><a href="httplib2-example.html">1.1.4 Examples</a>
</ul></ul>
<!--End of Table of Child-Links-->
</div>
-<DIV CLASS="navigation">
+<div class="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="Contents"
href="contents.html"><img src='previous.png'
- border='0' height='32' alt='Previous Page' width='32' /></A></td>
+ border='0' height='32' alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="The httplib2 Library"
href="ref.html"><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></A></td>
+ border='0' height='32' alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><a rel="next" title="1.1 httplib2 A comprehensive"
href="module-httplib2.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -98,17 +99,17 @@ A comprehensive HTTP client library.</a>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
-<a class="sectref" rel="prev" href="contents.html">Contents</A>
+<a class="sectref" rel="prev" href="contents.html">Contents</a>
<b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" href="ref.html">The httplib2 Library</A>
+<a class="sectref" rel="parent" href="ref.html">The httplib2 Library</a>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="module-httplib2.html">1.1 httplib2 A comprehensive</A>
+<a class="sectref" rel="next" href="module-httplib2.html">1.1 httplib2 A comprehensive</a>
</div>
</div>
<hr />
<span class="release-info">Release 0.3, documentation updated on Mar 8, 2007.</span>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-</BODY>
-</HTML>
+</body>
+</html>
diff --git a/ref/ref.html b/ref/ref.html
index eab247b..3627a94 100644
--- a/ref/ref.html
+++ b/ref/ref.html
@@ -7,25 +7,26 @@
<link rel='last' href='about.html' title='About this document...' />
<link rel='help' href='about.html' title='About this document...' />
<link rel="next" href="contents.html" />
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name='aesop' content='information' />
<title>The httplib2 Library</title>
</head>
<body>
-<DIV CLASS="navigation">
+<div class="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><img src='previous.png'
border='0' height='32' alt='Previous Page' width='32' /></td>
<td class='online-navigation'><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></td>
+ border='0' height='32' alt='Up one Level' width='32' /></td>
<td class='online-navigation'><a rel="next" title="Contents"
href="contents.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -33,13 +34,13 @@
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="contents.html">Contents</A>
+<a class="sectref" rel="next" href="contents.html">Contents</a>
</div>
<hr /></div>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-<P>
+<p>
<div class="titlepage">
<div class='center'>
@@ -54,46 +55,46 @@ Email: <span class="email">joe@bitworking.org</span>
</div>
</div>
-<P>
+<p>
-<H3>Abstract:</H3>
-<DIV CLASS="ABSTRACT">
+<h3>Abstract:</h3>
+<div class="ABSTRACT">
-<P>
+<p>
The <tt class="module">httplib2</tt> module is a comprehensive HTTP client library
that handles caching, keep-alive, compression, redirects and
many kinds of authentication.
-<P>
-</DIV>
-<P>
+<p>
+</div>
+<p>
-<P>
+<p>
<p><br /></p><hr class='online-navigation' />
<div class='online-navigation'>
<!--Table of Child-Links-->
-<A NAME="CHILD_LINKS"></a>
+<a name="CHILD_LINKS"></a>
-<UL CLASS="ChildLinks">
-<LI><A href="contents.html">Contents</a>
-<LI><A href="node2.html">1. Reference</a>
-<UL>
-<LI><A href="module-httplib2.html">1.1 <tt class="module">httplib2</tt>
+<ul class="ChildLinks">
+<li><a href="contents.html">Contents</a>
+<li><a href="node2.html">1. Reference</a>
+<ul>
+<li><a href="module-httplib2.html">1.1 <tt class="module">httplib2</tt>
A comprehensive HTTP client library.</a>
-<UL>
-<LI><A href="http-objects.html">1.1.1 Http Objects</a>
-<LI><A href="cache-objects.html">1.1.2 Cache Objects</a>
-<LI><A href="response-objects.html">1.1.3 Response Objects</a>
-<LI><A href="httplib2-example.html">1.1.4 Examples</a>
+<ul>
+<li><a href="http-objects.html">1.1.1 Http Objects</a>
+<li><a href="cache-objects.html">1.1.2 Cache Objects</a>
+<li><a href="response-objects.html">1.1.3 Response Objects</a>
+<li><a href="httplib2-example.html">1.1.4 Examples</a>
</ul>
</ul>
-<LI><A href="about.html">About this document ...</a>
+<li><a href="about.html">About this document ...</a>
</ul>
<!--End of Table of Child-Links-->
</div>
-<DIV CLASS="navigation">
+<div class="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
@@ -101,14 +102,14 @@ A comprehensive HTTP client library.</a>
<td class='online-navigation'><img src='previous.png'
border='0' height='32' alt='Previous Page' width='32' /></td>
<td class='online-navigation'><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></td>
+ border='0' height='32' alt='Up one Level' width='32' /></td>
<td class='online-navigation'><a rel="next" title="Contents"
href="contents.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -116,13 +117,13 @@ A comprehensive HTTP client library.</a>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="contents.html">Contents</A>
+<a class="sectref" rel="next" href="contents.html">Contents</a>
</div>
</div>
<hr />
<span class="release-info">Release 0.3, documentation updated on Mar 8, 2007.</span>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-</BODY>
-</HTML>
+</body>
+</html>
diff --git a/ref/response-objects.html b/ref/response-objects.html
index 8430539..e70dc01 100644
--- a/ref/response-objects.html
+++ b/ref/response-objects.html
@@ -10,27 +10,28 @@
<link rel="prev" href="cache-objects.html" />
<link rel="parent" href="module-httplib2.html" />
<link rel="next" href="httplib2-example.html" />
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name='aesop' content='information' />
<title>1.1.3 Response Objects</title>
</head>
<body>
-<DIV CLASS="navigation">
+<div class="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
-<td class='online-navigation'><a rel="prev" title="1.1.2 Cache Objects"
+<td class='online-navigation'><a rel="prev" title="1.1.2 cache Objects"
href="cache-objects.html"><img src='previous.png'
- border='0' height='32' alt='Previous Page' width='32' /></A></td>
+ border='0' height='32' alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="1.1 httplib2 A comprehensive"
href="module-httplib2.html"><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></A></td>
+ border='0' height='32' alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><a rel="next" title="1.1.4 Examples"
href="httplib2-example.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -38,55 +39,55 @@
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
-<a class="sectref" rel="prev" href="cache-objects.html">1.1.2 Cache Objects</A>
+<a class="sectref" rel="prev" href="cache-objects.html">1.1.2 Cache Objects</a>
<b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" href="module-httplib2.html">1.1 httplib2 A comprehensive</A>
+<a class="sectref" rel="parent" href="module-httplib2.html">1.1 httplib2 A comprehensive</a>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="httplib2-example.html">1.1.4 Examples</A>
+<a class="sectref" rel="next" href="httplib2-example.html">1.1.4 Examples</a>
</div>
<hr /></div>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-<H2><A NAME="SECTION002130000000000000000"></A>
-<A NAME="response-objects"></A>
-<BR>
+<h2><a name="SECTION002130000000000000000"></a>
+<a name="response-objects"></a>
+<br>
1.1.3 Response Objects
-</H2>
+</h2>
-<P>
+<p>
Response objects are derived from <tt class="class">dict</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>
-<dl><dt><b><tt id='l2h-24' xml:id='l2h-24' class="member">fromcache</tt></b></dt>
+<p>
+<dl><dt><b><tt id='l2h-25' xml:id='l2h-25' class="member">fromcache</tt></b></dt>
<dd>
If <code>true</code> the the response was returned from the cache.
</dl>
-<P>
-<dl><dt><b><tt id='l2h-25' xml:id='l2h-25' class="member">version</tt></b></dt>
+<p>
+<dl><dt><b><tt id='l2h-26' xml:id='l2h-26' class="member">version</tt></b></dt>
<dd>
The version of HTTP that the server supports. A value
of 11 means '1.1'.
</dl>
-<P>
-<dl><dt><b><tt id='l2h-26' xml:id='l2h-26' class="member">status</tt></b></dt>
+<p>
+<dl><dt><b><tt id='l2h-27' xml:id='l2h-27' class="member">status</tt></b></dt>
<dd>
The numerical HTTP status code returned in the response.
</dl>
-<P>
-<dl><dt><b><tt id='l2h-27' xml:id='l2h-27' class="member">reason</tt></b></dt>
+<p>
+<dl><dt><b><tt id='l2h-28' xml:id='l2h-28' class="member">reason</tt></b></dt>
<dd>
The human readable component of the HTTP response status code.
</dl>
-<P>
-<dl><dt><b><tt id='l2h-28' xml:id='l2h-28' class="member">previous</tt></b></dt>
+<p>
+<dl><dt><b><tt id='l2h-29' xml:id='l2h-29' class="member">previous</tt></b></dt>
<dd>
If redirects are followed then the <tt class="class">Response</tt> object returned
is just for the very last HTTP request and <var>previous</var> points to
@@ -95,7 +96,7 @@ going back through the responses to the very first response.
Will be <code>None</code> if there are no previous respones.
</dl>
-<P>
+<p>
The Response object also populates the header <code>content-location</code>, that
contains the URI that was ultimately requested. This is useful if
redirects were encountered, you can determine the ultimate URI that
@@ -107,26 +108,26 @@ of redirects then the <tt class="class">Response</tt> object will report the err
in the status code, but the complete chain of previous responses will
still be in tact.
-<P>
+<p>
-<DIV CLASS="navigation">
+<div class="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
-<td class='online-navigation'><a rel="prev" title="1.1.2 Cache Objects"
+<td class='online-navigation'><a rel="prev" title="1.1.2 cache Objects"
href="cache-objects.html"><img src='previous.png'
- border='0' height='32' alt='Previous Page' width='32' /></A></td>
+ border='0' height='32' alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="1.1 httplib2 A comprehensive"
href="module-httplib2.html"><img src='up.png'
- border='0' height='32' alt='Up One Level' width='32' /></A></td>
+ border='0' height='32' alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><a rel="next" title="1.1.4 Examples"
href="httplib2-example.html"><img src='next.png'
- border='0' height='32' alt='Next Page' width='32' /></A></td>
+ border='0' height='32' alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">The httplib2 Library</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.png'
- border='0' height='32' alt='Contents' width='32' /></A></td>
+ border='0' height='32' alt='Contents' width='32' /></a></td>
<td class='online-navigation'><img src='blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
@@ -134,17 +135,17 @@ still be in tact.
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
-<a class="sectref" rel="prev" href="cache-objects.html">1.1.2 Cache Objects</A>
+<a class="sectref" rel="prev" href="cache-objects.html">1.1.2 Cache Objects</a>
<b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" href="module-httplib2.html">1.1 httplib2 A comprehensive</A>
+<a class="sectref" rel="parent" href="module-httplib2.html">1.1 httplib2 A comprehensive</a>
<b class="navlabel">Next:</b>
-<a class="sectref" rel="next" href="httplib2-example.html">1.1.4 Examples</A>
+<a class="sectref" rel="next" href="httplib2-example.html">1.1.4 Examples</a>
</div>
</div>
<hr />
<span class="release-info">Release 0.3, documentation updated on Mar 8, 2007.</span>
-</DIV>
+</div>
<!--End of Navigation Panel-->
-</BODY>
-</HTML>
+</body>
+</html>