imported patch docs
diff --git a/docs/apiclient.http.html b/docs/apiclient.http.html
index 5c5aa78..69a1cad 100644
--- a/docs/apiclient.http.html
+++ b/docs/apiclient.http.html
@@ -8,7 +8,7 @@
<td valign=bottom> <br>
<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="apiclient.html"><font color="#ffffff">apiclient</font></a>.http</strong></big></big></font></td
><td align=right valign=bottom
-><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/home/jcgregorio/projects/apiclient-release/apiclient/http.py">/home/jcgregorio/projects/apiclient-release/apiclient/http.py</a></font></td></tr></table>
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/home/jcgregorio/projects/clean/apiclient/http.py">/home/jcgregorio/projects/clean/apiclient/http.py</a></font></td></tr></table>
<p><tt>Classes to encapsulate a single HTTP request.<br>
<br>
The classes implement a command pattern, with every<br>
@@ -54,6 +54,7 @@
<dl>
<dt><font face="helvetica, arial"><a href="apiclient.http.html#MediaFileUpload">MediaFileUpload</a>
</font></dt><dt><font face="helvetica, arial"><a href="apiclient.http.html#MediaInMemoryUpload">MediaInMemoryUpload</a>
+</font></dt><dt><font face="helvetica, arial"><a href="apiclient.http.html#MediaIoBaseUpload">MediaIoBaseUpload</a>
</font></dt></dl>
</dd>
<dt><font face="helvetica, arial"><a href="apiclient.http.html#MediaUploadProgress">MediaUploadProgress</a>
@@ -254,7 +255,11 @@
<br>
Returns:<br>
(status, body): (ResumableMediaStatus, <a href="__builtin__.html#object">object</a>)<br>
- The body will be None until the resumable media is fully uploaded.</tt></dd></dl>
+ The body will be None until the resumable media is fully uploaded.<br>
+ <br>
+Raises:<br>
+ apiclient.errors.HttpError if the response was not a 2xx.<br>
+ httplib2.Error if a transport error has occured.</tt></dd></dl>
<dl><dt><a name="HttpRequest-to_json"><strong>to_json</strong></a>(self)</dt><dd><tt>Returns a JSON representation of the <a href="#HttpRequest">HttpRequest</a>.</tt></dd></dl>
@@ -316,8 +321,8 @@
method. For example, if we had a service that allowed uploading images:<br>
<br>
<br>
- media = <a href="#MediaFileUpload">MediaFileUpload</a>('smiley.png', mimetype='image/png', chunksize=1000,<br>
- resumable=True)<br>
+ media = <a href="#MediaFileUpload">MediaFileUpload</a>('smiley.png', mimetype='image/png',<br>
+ chunksize=1024*1024, resumable=True)<br>
service.objects().insert(<br>
bucket=buckets['items'][0]['id'],<br>
name='smiley.png',<br>
@@ -330,7 +335,7 @@
</dl>
<hr>
Methods defined here:<br>
-<dl><dt><a name="MediaFileUpload-__init__"><strong>__init__</strong></a>(self, filename, mimetype<font color="#909090">=None</font>, chunksize<font color="#909090">=262144</font>, resumable<font color="#909090">=False</font>)</dt><dd><tt>Constructor.<br>
+<dl><dt><a name="MediaFileUpload-__init__"><strong>__init__</strong></a>(self, filename, mimetype<font color="#909090">=None</font>, chunksize<font color="#909090">=524288</font>, resumable<font color="#909090">=False</font>)</dt><dd><tt>Constructor.<br>
<br>
Args:<br>
filename: string, Name of the file.<br>
@@ -341,7 +346,10 @@
resumable: bool, True if this is a resumable upload. False means upload<br>
in a single request.</tt></dd></dl>
-<dl><dt><a name="MediaFileUpload-chunksize"><strong>chunksize</strong></a>(self)</dt></dl>
+<dl><dt><a name="MediaFileUpload-chunksize"><strong>chunksize</strong></a>(self)</dt><dd><tt>Chunk size for resumable uploads.<br>
+ <br>
+Returns:<br>
+ Chunk size in bytes.</tt></dd></dl>
<dl><dt><a name="MediaFileUpload-getbytes"><strong>getbytes</strong></a>(self, begin, length)</dt><dd><tt>Get bytes from the media.<br>
<br>
@@ -353,11 +361,20 @@
A string of bytes read. May be shorted than length if EOF was reached<br>
first.</tt></dd></dl>
-<dl><dt><a name="MediaFileUpload-mimetype"><strong>mimetype</strong></a>(self)</dt></dl>
+<dl><dt><a name="MediaFileUpload-mimetype"><strong>mimetype</strong></a>(self)</dt><dd><tt>Mime type of the body.<br>
+ <br>
+Returns:<br>
+ Mime type.</tt></dd></dl>
-<dl><dt><a name="MediaFileUpload-resumable"><strong>resumable</strong></a>(self)</dt></dl>
+<dl><dt><a name="MediaFileUpload-resumable"><strong>resumable</strong></a>(self)</dt><dd><tt>Whether this upload is resumable.<br>
+ <br>
+Returns:<br>
+ True if resumable upload or False.</tt></dd></dl>
-<dl><dt><a name="MediaFileUpload-size"><strong>size</strong></a>(self)</dt></dl>
+<dl><dt><a name="MediaFileUpload-size"><strong>size</strong></a>(self)</dt><dd><tt>Size of upload.<br>
+ <br>
+Returns:<br>
+ Size of the body, or None of the size is unknown.</tt></dd></dl>
<dl><dt><a name="MediaFileUpload-to_json"><strong>to_json</strong></a>(self)</dt><dd><tt>Creating a JSON representation of an instance of Credentials.<br>
<br>
@@ -408,7 +425,7 @@
</dl>
<hr>
Methods defined here:<br>
-<dl><dt><a name="MediaInMemoryUpload-__init__"><strong>__init__</strong></a>(self, body, mimetype<font color="#909090">='application/octet-stream'</font>, chunksize<font color="#909090">=262144</font>, resumable<font color="#909090">=False</font>)</dt><dd><tt>Create a new MediaBytesUpload.<br>
+<dl><dt><a name="MediaInMemoryUpload-__init__"><strong>__init__</strong></a>(self, body, mimetype<font color="#909090">='application/octet-stream'</font>, chunksize<font color="#909090">=524288</font>, resumable<font color="#909090">=False</font>)</dt><dd><tt>Create a new MediaBytesUpload.<br>
<br>
Args:<br>
body: string, Bytes of body content.<br>
@@ -447,7 +464,7 @@
<dl><dt><a name="MediaInMemoryUpload-size"><strong>size</strong></a>(self)</dt><dd><tt>Size of upload.<br>
<br>
Returns:<br>
- Size of the body.</tt></dd></dl>
+ Size of the body, or None of the size is unknown.</tt></dd></dl>
<dl><dt><a name="MediaInMemoryUpload-to_json"><strong>to_json</strong></a>(self)</dt><dd><tt>Create a JSON representation of a <a href="#MediaInMemoryUpload">MediaInMemoryUpload</a>.<br>
<br>
@@ -483,23 +500,141 @@
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#ffc8d8">
<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaIoBaseUpload">class <strong>MediaIoBaseUpload</strong></a>(<a href="apiclient.http.html#MediaUpload">MediaUpload</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A <a href="#MediaUpload">MediaUpload</a> for a io.Base objects.<br>
+ <br>
+Note that the Python file <a href="__builtin__.html#object">object</a> is compatible with io.Base and can be used<br>
+with this class also.<br>
+ <br>
+ <br>
+ fh = io.BytesIO('...Some data to upload...')<br>
+ media = <a href="#MediaIoBaseUpload">MediaIoBaseUpload</a>(fh, mimetype='image/png',<br>
+ chunksize=1024*1024, resumable=True)<br>
+ service.objects().insert(<br>
+ bucket='a_bucket_id',<br>
+ name='smiley.png',<br>
+ media_body=media).execute()<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="apiclient.http.html#MediaIoBaseUpload">MediaIoBaseUpload</a></dd>
+<dd><a href="apiclient.http.html#MediaUpload">MediaUpload</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="MediaIoBaseUpload-__init__"><strong>__init__</strong></a>(self, fh, mimetype, chunksize<font color="#909090">=524288</font>, resumable<font color="#909090">=False</font>)</dt><dd><tt>Constructor.<br>
+ <br>
+Args:<br>
+ fh: io.Base or file <a href="__builtin__.html#object">object</a>, The source of the bytes to upload.<br>
+ mimetype: string, Mime-type of the file. If None then a mime-type will be<br>
+ guessed from the file extension.<br>
+ chunksize: int, File will be uploaded in chunks of this many bytes. Only<br>
+ used if resumable=True.<br>
+ resumable: bool, True if this is a resumable upload. False means upload<br>
+ in a single request.</tt></dd></dl>
+
+<dl><dt><a name="MediaIoBaseUpload-chunksize"><strong>chunksize</strong></a>(self)</dt><dd><tt>Chunk size for resumable uploads.<br>
+ <br>
+Returns:<br>
+ Chunk size in bytes.</tt></dd></dl>
+
+<dl><dt><a name="MediaIoBaseUpload-getbytes"><strong>getbytes</strong></a>(self, begin, length)</dt><dd><tt>Get bytes from the media.<br>
+ <br>
+Args:<br>
+ begin: int, offset from beginning of file.<br>
+ length: int, number of bytes to read, starting at begin.<br>
+ <br>
+Returns:<br>
+ A string of bytes read. May be shorted than length if EOF was reached<br>
+ first.</tt></dd></dl>
+
+<dl><dt><a name="MediaIoBaseUpload-mimetype"><strong>mimetype</strong></a>(self)</dt><dd><tt>Mime type of the body.<br>
+ <br>
+Returns:<br>
+ Mime type.</tt></dd></dl>
+
+<dl><dt><a name="MediaIoBaseUpload-resumable"><strong>resumable</strong></a>(self)</dt><dd><tt>Whether this upload is resumable.<br>
+ <br>
+Returns:<br>
+ True if resumable upload or False.</tt></dd></dl>
+
+<dl><dt><a name="MediaIoBaseUpload-size"><strong>size</strong></a>(self)</dt><dd><tt>Size of upload.<br>
+ <br>
+Returns:<br>
+ Size of the body, or None of the size is unknown.</tt></dd></dl>
+
+<dl><dt><a name="MediaIoBaseUpload-to_json"><strong>to_json</strong></a>(self)</dt><dd><tt>This upload type is not serializable.</tt></dd></dl>
+
+<hr>
+Class methods inherited from <a href="apiclient.http.html#MediaUpload">MediaUpload</a>:<br>
+<dl><dt><a name="MediaIoBaseUpload-new_from_json"><strong>new_from_json</strong></a>(cls, s)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>Utility class method to instantiate a <a href="#MediaUpload">MediaUpload</a> subclass from a JSON<br>
+representation produced by <a href="#MediaIoBaseUpload-to_json">to_json</a>().<br>
+ <br>
+Args:<br>
+ s: string, JSON from <a href="#MediaIoBaseUpload-to_json">to_json</a>().<br>
+ <br>
+Returns:<br>
+ An instance of the subclass of <a href="#MediaUpload">MediaUpload</a> that was serialized with<br>
+ <a href="#MediaIoBaseUpload-to_json">to_json</a>().</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="apiclient.http.html#MediaUpload">MediaUpload</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
<font color="#000000" face="helvetica, arial"><a name="MediaUpload">class <strong>MediaUpload</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
<td colspan=2><tt>Describes a media <a href="__builtin__.html#object">object</a> to upload.<br>
<br>
-Base class that defines the interface of <a href="#MediaUpload">MediaUpload</a> subclasses.<br> </tt></td></tr>
+Base class that defines the interface of <a href="#MediaUpload">MediaUpload</a> subclasses.<br>
+ <br>
+Note that subclasses of <a href="#MediaUpload">MediaUpload</a> may allow you to control the chunksize<br>
+when upload a media <a href="__builtin__.html#object">object</a>. It is important to keep the size of the chunk as<br>
+large as possible to keep the upload efficient. Other factors may influence<br>
+the size of the chunk you use, particularly if you are working in an<br>
+environment where individual HTTP requests may have a hardcoded time limit,<br>
+such as under certain classes of requests under Google App Engine.<br> </tt></td></tr>
<tr><td> </td>
<td width="100%">Methods defined here:<br>
-<dl><dt><a name="MediaUpload-chunksize"><strong>chunksize</strong></a>(self)</dt></dl>
+<dl><dt><a name="MediaUpload-chunksize"><strong>chunksize</strong></a>(self)</dt><dd><tt>Chunk size for resumable uploads.<br>
+ <br>
+Returns:<br>
+ Chunk size in bytes.</tt></dd></dl>
-<dl><dt><a name="MediaUpload-getbytes"><strong>getbytes</strong></a>(self, begin, end)</dt></dl>
+<dl><dt><a name="MediaUpload-getbytes"><strong>getbytes</strong></a>(self, begin, end)</dt><dd><tt>Get bytes from the media.<br>
+ <br>
+Args:<br>
+ begin: int, offset from beginning of file.<br>
+ length: int, number of bytes to read, starting at begin.<br>
+ <br>
+Returns:<br>
+ A string of bytes read. May be shorter than length if EOF was reached<br>
+ first.</tt></dd></dl>
-<dl><dt><a name="MediaUpload-mimetype"><strong>mimetype</strong></a>(self)</dt></dl>
+<dl><dt><a name="MediaUpload-mimetype"><strong>mimetype</strong></a>(self)</dt><dd><tt>Mime type of the body.<br>
+ <br>
+Returns:<br>
+ Mime type.</tt></dd></dl>
-<dl><dt><a name="MediaUpload-resumable"><strong>resumable</strong></a>(self)</dt></dl>
+<dl><dt><a name="MediaUpload-resumable"><strong>resumable</strong></a>(self)</dt><dd><tt>Whether this upload is resumable.<br>
+ <br>
+Returns:<br>
+ True if resumable upload or False.</tt></dd></dl>
-<dl><dt><a name="MediaUpload-size"><strong>size</strong></a>(self)</dt></dl>
+<dl><dt><a name="MediaUpload-size"><strong>size</strong></a>(self)</dt><dd><tt>Size of upload.<br>
+ <br>
+Returns:<br>
+ Size of the body, or None of the size is unknown.</tt></dd></dl>
<dl><dt><a name="MediaUpload-to_json"><strong>to_json</strong></a>(self)</dt><dd><tt>Create a JSON representation of an instance of <a href="#MediaUpload">MediaUpload</a>.<br>
<br>
@@ -541,9 +676,14 @@
<br>
Args:<br>
resumable_progress: int, bytes sent so far.<br>
- total_size: int, total bytes in complete upload.</tt></dd></dl>
+ total_size: int, total bytes in complete upload, or None if the total<br>
+ upload size isn't known ahead of time.</tt></dd></dl>
-<dl><dt><a name="MediaUploadProgress-progress"><strong>progress</strong></a>(self)</dt><dd><tt>Percent of upload completed, as a float.</tt></dd></dl>
+<dl><dt><a name="MediaUploadProgress-progress"><strong>progress</strong></a>(self)</dt><dd><tt>Percent of upload completed, as a float.<br>
+ <br>
+Returns:<br>
+ the percentage complete as a float, returning 0.0 if the total size of<br>
+ the upload is unknown.</tt></dd></dl>
<hr>
Data descriptors defined here:<br>
@@ -658,7 +798,8 @@
<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
-<td width="100%"><strong>__author__</strong> = 'jcgregorio@google.com (Joe Gregorio)'</td></tr></table><p>
+<td width="100%"><strong>DEFAULT_CHUNK_SIZE</strong> = 524288<br>
+<strong>__author__</strong> = 'jcgregorio@google.com (Joe Gregorio)'</td></tr></table><p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#7799ee">
<td colspan=3 valign=bottom> <br>