Index: tools/telemetry/docs/telemetry.page.cloud_storage.html |
diff --git a/tools/telemetry/docs/telemetry.page.cloud_storage.html b/tools/telemetry/docs/telemetry.page.cloud_storage.html |
index 153583d1323e45b14ac77001fe01d037ddb4f7ba..982ab017d2b016c4653db73f14035276af35d0c2 100644 |
--- a/tools/telemetry/docs/telemetry.page.cloud_storage.html |
+++ b/tools/telemetry/docs/telemetry.page.cloud_storage.html |
@@ -18,13 +18,271 @@ |
<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td> |
<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="cStringIO.html">cStringIO</a><br> |
+<a href="hashlib.html">hashlib</a><br> |
<a href="logging.html">logging</a><br> |
</td><td width="25%" valign=top><a href="os.html">os</a><br> |
<a href="subprocess.html">subprocess</a><br> |
-</td><td width="25%" valign=top><a href="sys.html">sys</a><br> |
-<a href="tarfile.html">tarfile</a><br> |
-</td><td width="25%" valign=top><a href="urllib2.html">urllib2</a><br> |
+<a href="sys.html">sys</a><br> |
+</td><td width="25%" valign=top><a href="tarfile.html">tarfile</a><br> |
+<a href="urllib2.html">urllib2</a><br> |
<a href="telemetry.core.util.html">telemetry.core.util</a><br> |
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p> |
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
+<tr bgcolor="#ee77aa"> |
+<td colspan=3 valign=bottom> <br> |
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr> |
+ |
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td> |
+<td width="100%"><dl> |
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>) |
+</font></dt><dd> |
+<dl> |
+<dt><font face="helvetica, arial"><a href="telemetry.page.cloud_storage.html#CloudStorageError">CloudStorageError</a> |
+</font></dt><dd> |
+<dl> |
+<dt><font face="helvetica, arial"><a href="telemetry.page.cloud_storage.html#CredentialsError">CredentialsError</a> |
+</font></dt><dt><font face="helvetica, arial"><a href="telemetry.page.cloud_storage.html#NotFoundError">NotFoundError</a> |
+</font></dt><dt><font face="helvetica, arial"><a href="telemetry.page.cloud_storage.html#PermissionError">PermissionError</a> |
+</font></dt></dl> |
+</dd> |
+</dl> |
+</dd> |
+</dl> |
+ <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="CloudStorageError">class <strong>CloudStorageError</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr> |
+ |
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td> |
+<td width="100%"><dl><dt>Method resolution order:</dt> |
+<dd><a href="telemetry.page.cloud_storage.html#CloudStorageError">CloudStorageError</a></dd> |
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd> |
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd> |
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd> |
+</dl> |
+<hr> |
+Data descriptors defined here:<br> |
+<dl><dt><strong>__weakref__</strong></dt> |
+<dd><tt>list of weak references to the object (if defined)</tt></dd> |
+</dl> |
+<hr> |
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> |
+<dl><dt><a name="CloudStorageError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#CloudStorageError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> |
+ |
+<hr> |
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> |
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#CloudStorageError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl> |
+ |
+<hr> |
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br> |
+<dl><dt><a name="CloudStorageError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#CloudStorageError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl> |
+ |
+<dl><dt><a name="CloudStorageError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#CloudStorageError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl> |
+ |
+<dl><dt><a name="CloudStorageError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CloudStorageError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl> |
+ |
+<dl><dt><a name="CloudStorageError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#CloudStorageError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br> |
+ <br> |
+Use of negative indices is not supported.</tt></dd></dl> |
+ |
+<dl><dt><a name="CloudStorageError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl> |
+ |
+<dl><dt><a name="CloudStorageError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#CloudStorageError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl> |
+ |
+<dl><dt><a name="CloudStorageError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#CloudStorageError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl> |
+ |
+<dl><dt><a name="CloudStorageError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl> |
+ |
+<dl><dt><a name="CloudStorageError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#CloudStorageError-__str__">__str__</a>() <==> str(x)</tt></dd></dl> |
+ |
+<dl><dt><a name="CloudStorageError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl> |
+ |
+<hr> |
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br> |
+<dl><dt><strong>__dict__</strong></dt> |
+</dl> |
+<dl><dt><strong>args</strong></dt> |
+</dl> |
+<dl><dt><strong>message</strong></dt> |
+</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="CredentialsError">class <strong>CredentialsError</strong></a>(<a href="telemetry.page.cloud_storage.html#CloudStorageError">CloudStorageError</a>)</font></td></tr> |
+ |
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td> |
+<td width="100%"><dl><dt>Method resolution order:</dt> |
+<dd><a href="telemetry.page.cloud_storage.html#CredentialsError">CredentialsError</a></dd> |
+<dd><a href="telemetry.page.cloud_storage.html#CloudStorageError">CloudStorageError</a></dd> |
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd> |
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd> |
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd> |
+</dl> |
+<hr> |
+Methods defined here:<br> |
+<dl><dt><a name="CredentialsError-__init__"><strong>__init__</strong></a>(self, gsutil_path)</dt></dl> |
+ |
+<hr> |
+Data descriptors inherited from <a href="telemetry.page.cloud_storage.html#CloudStorageError">CloudStorageError</a>:<br> |
+<dl><dt><strong>__weakref__</strong></dt> |
+<dd><tt>list of weak references to the object (if defined)</tt></dd> |
+</dl> |
+<hr> |
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> |
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#CredentialsError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl> |
+ |
+<hr> |
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br> |
+<dl><dt><a name="CredentialsError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#CredentialsError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl> |
+ |
+<dl><dt><a name="CredentialsError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#CredentialsError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl> |
+ |
+<dl><dt><a name="CredentialsError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CredentialsError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl> |
+ |
+<dl><dt><a name="CredentialsError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#CredentialsError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br> |
+ <br> |
+Use of negative indices is not supported.</tt></dd></dl> |
+ |
+<dl><dt><a name="CredentialsError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl> |
+ |
+<dl><dt><a name="CredentialsError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#CredentialsError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl> |
+ |
+<dl><dt><a name="CredentialsError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#CredentialsError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl> |
+ |
+<dl><dt><a name="CredentialsError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl> |
+ |
+<dl><dt><a name="CredentialsError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#CredentialsError-__str__">__str__</a>() <==> str(x)</tt></dd></dl> |
+ |
+<dl><dt><a name="CredentialsError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl> |
+ |
+<hr> |
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br> |
+<dl><dt><strong>__dict__</strong></dt> |
+</dl> |
+<dl><dt><strong>args</strong></dt> |
+</dl> |
+<dl><dt><strong>message</strong></dt> |
+</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="NotFoundError">class <strong>NotFoundError</strong></a>(<a href="telemetry.page.cloud_storage.html#CloudStorageError">CloudStorageError</a>)</font></td></tr> |
+ |
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td> |
+<td width="100%"><dl><dt>Method resolution order:</dt> |
+<dd><a href="telemetry.page.cloud_storage.html#NotFoundError">NotFoundError</a></dd> |
+<dd><a href="telemetry.page.cloud_storage.html#CloudStorageError">CloudStorageError</a></dd> |
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd> |
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd> |
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd> |
+</dl> |
+<hr> |
+Data descriptors inherited from <a href="telemetry.page.cloud_storage.html#CloudStorageError">CloudStorageError</a>:<br> |
+<dl><dt><strong>__weakref__</strong></dt> |
+<dd><tt>list of weak references to the object (if defined)</tt></dd> |
+</dl> |
+<hr> |
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> |
+<dl><dt><a name="NotFoundError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#NotFoundError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> |
+ |
+<hr> |
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> |
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#NotFoundError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl> |
+ |
+<hr> |
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br> |
+<dl><dt><a name="NotFoundError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NotFoundError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl> |
+ |
+<dl><dt><a name="NotFoundError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#NotFoundError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl> |
+ |
+<dl><dt><a name="NotFoundError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#NotFoundError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl> |
+ |
+<dl><dt><a name="NotFoundError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#NotFoundError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br> |
+ <br> |
+Use of negative indices is not supported.</tt></dd></dl> |
+ |
+<dl><dt><a name="NotFoundError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl> |
+ |
+<dl><dt><a name="NotFoundError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#NotFoundError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl> |
+ |
+<dl><dt><a name="NotFoundError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NotFoundError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl> |
+ |
+<dl><dt><a name="NotFoundError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl> |
+ |
+<dl><dt><a name="NotFoundError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#NotFoundError-__str__">__str__</a>() <==> str(x)</tt></dd></dl> |
+ |
+<dl><dt><a name="NotFoundError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl> |
+ |
+<hr> |
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br> |
+<dl><dt><strong>__dict__</strong></dt> |
+</dl> |
+<dl><dt><strong>args</strong></dt> |
+</dl> |
+<dl><dt><strong>message</strong></dt> |
+</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="PermissionError">class <strong>PermissionError</strong></a>(<a href="telemetry.page.cloud_storage.html#CloudStorageError">CloudStorageError</a>)</font></td></tr> |
+ |
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td> |
+<td width="100%"><dl><dt>Method resolution order:</dt> |
+<dd><a href="telemetry.page.cloud_storage.html#PermissionError">PermissionError</a></dd> |
+<dd><a href="telemetry.page.cloud_storage.html#CloudStorageError">CloudStorageError</a></dd> |
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd> |
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd> |
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd> |
+</dl> |
+<hr> |
+Methods defined here:<br> |
+<dl><dt><a name="PermissionError-__init__"><strong>__init__</strong></a>(self, gsutil_path)</dt></dl> |
+ |
+<hr> |
+Data descriptors inherited from <a href="telemetry.page.cloud_storage.html#CloudStorageError">CloudStorageError</a>:<br> |
+<dl><dt><strong>__weakref__</strong></dt> |
+<dd><tt>list of weak references to the object (if defined)</tt></dd> |
+</dl> |
+<hr> |
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> |
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#PermissionError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl> |
+ |
+<hr> |
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br> |
+<dl><dt><a name="PermissionError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#PermissionError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl> |
+ |
+<dl><dt><a name="PermissionError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#PermissionError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl> |
+ |
+<dl><dt><a name="PermissionError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#PermissionError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl> |
+ |
+<dl><dt><a name="PermissionError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#PermissionError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br> |
+ <br> |
+Use of negative indices is not supported.</tt></dd></dl> |
+ |
+<dl><dt><a name="PermissionError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl> |
+ |
+<dl><dt><a name="PermissionError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#PermissionError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl> |
+ |
+<dl><dt><a name="PermissionError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#PermissionError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl> |
+ |
+<dl><dt><a name="PermissionError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl> |
+ |
+<dl><dt><a name="PermissionError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#PermissionError-__str__">__str__</a>() <==> str(x)</tt></dd></dl> |
+ |
+<dl><dt><a name="PermissionError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl> |
+ |
+<hr> |
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br> |
+<dl><dt><strong>__dict__</strong></dt> |
+</dl> |
+<dl><dt><strong>args</strong></dt> |
+</dl> |
+<dl><dt><strong>message</strong></dt> |
+</dl> |
</td></tr></table></td></tr></table><p> |
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
<tr bgcolor="#eeaa77"> |
@@ -33,8 +291,29 @@ |
<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td> |
<td width="100%"><dl><dt><a name="-Delete"><strong>Delete</strong></a>(bucket, remote_path)</dt></dl> |
+ <dl><dt><a name="-Exists"><strong>Exists</strong></a>(bucket, remote_path)</dt></dl> |
+ <dl><dt><a name="-FindGsutil"><strong>FindGsutil</strong></a>()</dt><dd><tt>Return the gsutil executable path. If we can't find it, download it.</tt></dd></dl> |
<dl><dt><a name="-Get"><strong>Get</strong></a>(bucket, remote_path, local_path)</dt></dl> |
- <dl><dt><a name="-Insert"><strong>Insert</strong></a>(bucket, remote_path, local_path)</dt></dl> |
+ <dl><dt><a name="-GetHash"><strong>GetHash</strong></a>(file_path)</dt><dd><tt>Calculates and returns the hash of the file at file_path.</tt></dd></dl> |
+ <dl><dt><a name="-GetIfChanged"><strong>GetIfChanged</strong></a>(file_path, bucket<font color="#909090">=None</font>)</dt><dd><tt>Gets the file at file_path if it has a hash file that doesn't match.<br> |
+ <br> |
+If the file is not in Cloud Storage, log a warning instead of raising an<br> |
+exception. We assume that the user just hasn't uploaded the file yet.<br> |
+ <br> |
+Returns:<br> |
+ True if the binary was changed.</tt></dd></dl> |
+ <dl><dt><a name="-Insert"><strong>Insert</strong></a>(bucket, remote_path, local_path, publicly_readable<font color="#909090">=False</font>)</dt></dl> |
<dl><dt><a name="-List"><strong>List</strong></a>(bucket)</dt></dl> |
-</td></tr></table> |
+ <dl><dt><a name="-Move"><strong>Move</strong></a>(bucket1, bucket2, remote_path)</dt></dl> |
+ <dl><dt><a name="-SupportsProdaccess"><strong>SupportsProdaccess</strong></a>(gsutil_path)</dt></dl> |
+</td></tr></table><p> |
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
+<tr bgcolor="#55aa55"> |
+<td colspan=3 valign=bottom> <br> |
+<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>INTERNAL_BUCKET</strong> = 'chrome-telemetry'<br> |
+<strong>PARTNER_BUCKET</strong> = 'chrome-partner-telemetry'<br> |
+<strong>PUBLIC_BUCKET</strong> = 'chromium-telemetry'</td></tr></table> |
</body></html> |