blob: 11d0fea9fe8ee299ff3c10d408186fe9678aeebc [file] [log] [blame]
Joe Gregorioa8451672011-09-15 09:53:21 -04001
2<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
3<html><head><title>Python: module oauth2client.multistore_file</title>
4</head><body bgcolor="#f0f0f8">
5
6<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
7<tr bgcolor="#7799ee">
8<td valign=bottom>&nbsp;<br>
9<font color="#ffffff" face="helvetica, arial">&nbsp;<br><big><big><strong><a href="oauth2client.html"><font color="#ffffff">oauth2client</font></a>.multistore_file</strong></big></big></font></td
10><td align=right valign=bottom
Joe Gregoriod02bf5e2012-03-02 13:21:32 -080011><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/home/jcgregorio/projects/google-api-python-client/oauth2client/multistore_file.py">/home/jcgregorio/projects/google-api-python-client/oauth2client/multistore_file.py</a></font></td></tr></table>
Joe Gregorioa8451672011-09-15 09:53:21 -040012 <p><tt>Multi-credential&nbsp;file&nbsp;store&nbsp;with&nbsp;lock&nbsp;support.<br>
13&nbsp;<br>
14This&nbsp;module&nbsp;implements&nbsp;a&nbsp;JSON&nbsp;credential&nbsp;store&nbsp;where&nbsp;multiple<br>
15credentials&nbsp;can&nbsp;be&nbsp;stored&nbsp;in&nbsp;one&nbsp;file.&nbsp;&nbsp;That&nbsp;file&nbsp;supports&nbsp;locking<br>
16both&nbsp;in&nbsp;a&nbsp;single&nbsp;process&nbsp;and&nbsp;across&nbsp;processes.<br>
17&nbsp;<br>
18The&nbsp;credential&nbsp;themselves&nbsp;are&nbsp;keyed&nbsp;off&nbsp;of:<br>
19*&nbsp;client_id<br>
20*&nbsp;user_agent<br>
21*&nbsp;scope<br>
22&nbsp;<br>
23The&nbsp;format&nbsp;of&nbsp;the&nbsp;stored&nbsp;data&nbsp;is&nbsp;like&nbsp;so:<br>
24{<br>
25&nbsp;&nbsp;'file_version':&nbsp;1,<br>
26&nbsp;&nbsp;'data':&nbsp;[<br>
27&nbsp;&nbsp;&nbsp;&nbsp;{<br>
28&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'key':&nbsp;{<br>
29&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'clientId':&nbsp;'&lt;client&nbsp;id&gt;',<br>
30&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'userAgent':&nbsp;'&lt;user&nbsp;agent&gt;',<br>
31&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'scope':&nbsp;'&lt;scope&gt;'<br>
32&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
33&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'credential':&nbsp;{<br>
34&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;JSON&nbsp;serialized&nbsp;Credentials.<br>
35&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}<br>
36&nbsp;&nbsp;&nbsp;&nbsp;}<br>
37&nbsp;&nbsp;]<br>
38}</tt></p>
39<p>
40<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
41<tr bgcolor="#aa55cc">
42<td colspan=3 valign=bottom>&nbsp;<br>
43<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
44
45<tr><td bgcolor="#aa55cc"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
46<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="base64.html">base64</a><br>
Joe Gregorio3d55ac52012-02-21 10:11:19 -050047<a href="errno.html">errno</a><br>
48</td><td width="25%" valign=top><a href="fcntl.html">fcntl</a><br>
49<a href="logging.html">logging</a><br>
50</td><td width="25%" valign=top><a href="os.html">os</a><br>
51<a href="json.html">json</a><br>
52</td><td width="25%" valign=top><a href="threading.html">threading</a><br>
53</td></tr></table></td></tr></table><p>
Joe Gregorioa8451672011-09-15 09:53:21 -040054<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
55<tr bgcolor="#ee77aa">
56<td colspan=3 valign=bottom>&nbsp;<br>
57<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
58
59<tr><td bgcolor="#ee77aa"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
60<td width="100%"><dl>
61<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
62</font></dt><dd>
63<dl>
64<dt><font face="helvetica, arial"><a href="oauth2client.multistore_file.html#Error">Error</a>
65</font></dt><dd>
66<dl>
67<dt><font face="helvetica, arial"><a href="oauth2client.multistore_file.html#NewerCredentialStoreError">NewerCredentialStoreError</a>
68</font></dt></dl>
69</dd>
70</dl>
71</dd>
72</dl>
73 <p>
74<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
75<tr bgcolor="#ffc8d8">
76<td colspan=3 valign=bottom>&nbsp;<br>
77<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
78
79<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;</tt></td>
80<td colspan=2><tt>Base&nbsp;error&nbsp;for&nbsp;this&nbsp;module.<br>&nbsp;</tt></td></tr>
81<tr><td>&nbsp;</td>
82<td width="100%"><dl><dt>Method resolution order:</dt>
83<dd><a href="oauth2client.multistore_file.html#Error">Error</a></dd>
84<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
85<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
86<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
87</dl>
88<hr>
89Data descriptors defined here:<br>
90<dl><dt><strong>__weakref__</strong></dt>
91<dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
92</dl>
93<hr>
94Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
Joe Gregoriob417caf2011-12-08 12:04:24 -050095<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...)&nbsp;initializes&nbsp;x;&nbsp;see&nbsp;x.__class__.__doc__&nbsp;for&nbsp;signature</tt></dd></dl>
Joe Gregorioa8451672011-09-15 09:53:21 -040096
97<hr>
98Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
99<dl><dt><strong>__new__</strong> = &lt;built-in method __new__ of type object&gt;<dd><tt>T.<a href="#Error-__new__">__new__</a>(S,&nbsp;...)&nbsp;-&gt;&nbsp;a&nbsp;new&nbsp;object&nbsp;with&nbsp;type&nbsp;S,&nbsp;a&nbsp;subtype&nbsp;of&nbsp;T</tt></dl>
100
101<hr>
102Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
103<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name')&nbsp;&lt;==&gt;&nbsp;del&nbsp;x.name</tt></dd></dl>
104
105<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name')&nbsp;&lt;==&gt;&nbsp;x.name</tt></dd></dl>
106
107<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y)&nbsp;&lt;==&gt;&nbsp;x[y]</tt></dd></dl>
108
109<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i,&nbsp;j)&nbsp;&lt;==&gt;&nbsp;x[i:j]<br>
110&nbsp;<br>
111Use&nbsp;of&nbsp;negative&nbsp;indices&nbsp;is&nbsp;not&nbsp;supported.</tt></dd></dl>
112
113<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
114
115<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>()&nbsp;&lt;==&gt;&nbsp;repr(x)</tt></dd></dl>
116
117<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name',&nbsp;value)&nbsp;&lt;==&gt;&nbsp;x.name&nbsp;=&nbsp;value</tt></dd></dl>
118
119<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
120
121<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>()&nbsp;&lt;==&gt;&nbsp;str(x)</tt></dd></dl>
122
123<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
124
125<hr>
126Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
127<dl><dt><strong>__dict__</strong></dt>
128</dl>
129<dl><dt><strong>args</strong></dt>
130</dl>
131<dl><dt><strong>message</strong></dt>
132</dl>
133</td></tr></table> <p>
134<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
135<tr bgcolor="#ffc8d8">
136<td colspan=3 valign=bottom>&nbsp;<br>
137<font color="#000000" face="helvetica, arial"><a name="NewerCredentialStoreError">class <strong>NewerCredentialStoreError</strong></a>(<a href="oauth2client.multistore_file.html#Error">Error</a>)</font></td></tr>
138
139<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;</tt></td>
140<td colspan=2><tt>The&nbsp;credential&nbsp;store&nbsp;is&nbsp;a&nbsp;newer&nbsp;version&nbsp;that&nbsp;supported.<br>&nbsp;</tt></td></tr>
141<tr><td>&nbsp;</td>
142<td width="100%"><dl><dt>Method resolution order:</dt>
143<dd><a href="oauth2client.multistore_file.html#NewerCredentialStoreError">NewerCredentialStoreError</a></dd>
144<dd><a href="oauth2client.multistore_file.html#Error">Error</a></dd>
145<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
146<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
147<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
148</dl>
149<hr>
150Data descriptors inherited from <a href="oauth2client.multistore_file.html#Error">Error</a>:<br>
151<dl><dt><strong>__weakref__</strong></dt>
152<dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
153</dl>
154<hr>
155Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
Joe Gregoriob417caf2011-12-08 12:04:24 -0500156<dl><dt><a name="NewerCredentialStoreError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#NewerCredentialStoreError-__init__">__init__</a>(...)&nbsp;initializes&nbsp;x;&nbsp;see&nbsp;x.__class__.__doc__&nbsp;for&nbsp;signature</tt></dd></dl>
Joe Gregorioa8451672011-09-15 09:53:21 -0400157
158<hr>
159Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
160<dl><dt><strong>__new__</strong> = &lt;built-in method __new__ of type object&gt;<dd><tt>T.<a href="#NewerCredentialStoreError-__new__">__new__</a>(S,&nbsp;...)&nbsp;-&gt;&nbsp;a&nbsp;new&nbsp;object&nbsp;with&nbsp;type&nbsp;S,&nbsp;a&nbsp;subtype&nbsp;of&nbsp;T</tt></dl>
161
162<hr>
163Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
164<dl><dt><a name="NewerCredentialStoreError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NewerCredentialStoreError-__delattr__">__delattr__</a>('name')&nbsp;&lt;==&gt;&nbsp;del&nbsp;x.name</tt></dd></dl>
165
166<dl><dt><a name="NewerCredentialStoreError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#NewerCredentialStoreError-__getattribute__">__getattribute__</a>('name')&nbsp;&lt;==&gt;&nbsp;x.name</tt></dd></dl>
167
168<dl><dt><a name="NewerCredentialStoreError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#NewerCredentialStoreError-__getitem__">__getitem__</a>(y)&nbsp;&lt;==&gt;&nbsp;x[y]</tt></dd></dl>
169
170<dl><dt><a name="NewerCredentialStoreError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#NewerCredentialStoreError-__getslice__">__getslice__</a>(i,&nbsp;j)&nbsp;&lt;==&gt;&nbsp;x[i:j]<br>
171&nbsp;<br>
172Use&nbsp;of&nbsp;negative&nbsp;indices&nbsp;is&nbsp;not&nbsp;supported.</tt></dd></dl>
173
174<dl><dt><a name="NewerCredentialStoreError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
175
176<dl><dt><a name="NewerCredentialStoreError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#NewerCredentialStoreError-__repr__">__repr__</a>()&nbsp;&lt;==&gt;&nbsp;repr(x)</tt></dd></dl>
177
178<dl><dt><a name="NewerCredentialStoreError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NewerCredentialStoreError-__setattr__">__setattr__</a>('name',&nbsp;value)&nbsp;&lt;==&gt;&nbsp;x.name&nbsp;=&nbsp;value</tt></dd></dl>
179
180<dl><dt><a name="NewerCredentialStoreError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
181
182<dl><dt><a name="NewerCredentialStoreError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#NewerCredentialStoreError-__str__">__str__</a>()&nbsp;&lt;==&gt;&nbsp;str(x)</tt></dd></dl>
183
184<dl><dt><a name="NewerCredentialStoreError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
185
186<hr>
187Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
188<dl><dt><strong>__dict__</strong></dt>
189</dl>
190<dl><dt><strong>args</strong></dt>
191</dl>
192<dl><dt><strong>message</strong></dt>
193</dl>
194</td></tr></table></td></tr></table><p>
195<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
196<tr bgcolor="#eeaa77">
197<td colspan=3 valign=bottom>&nbsp;<br>
198<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
199
200<tr><td bgcolor="#eeaa77"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
201<td width="100%"><dl><dt><a name="-get_credential_storage"><strong>get_credential_storage</strong></a>(filename, client_id, user_agent, scope, warn_on_readonly<font color="#909090">=True</font>)</dt><dd><tt>Get&nbsp;a&nbsp;Storage&nbsp;instance&nbsp;for&nbsp;a&nbsp;credential.<br>
202&nbsp;<br>
203Args:<br>
204&nbsp;&nbsp;filename:&nbsp;The&nbsp;JSON&nbsp;file&nbsp;storing&nbsp;a&nbsp;set&nbsp;of&nbsp;credentials<br>
205&nbsp;&nbsp;client_id:&nbsp;The&nbsp;client_id&nbsp;for&nbsp;the&nbsp;credential<br>
206&nbsp;&nbsp;user_agent:&nbsp;The&nbsp;user&nbsp;agent&nbsp;for&nbsp;the&nbsp;credential<br>
Joe Gregorio761c4562011-10-28 14:36:24 -0400207&nbsp;&nbsp;scope:&nbsp;string&nbsp;or&nbsp;list&nbsp;of&nbsp;strings,&nbsp;Scope(s)&nbsp;being&nbsp;requested<br>
Joe Gregorioa8451672011-09-15 09:53:21 -0400208&nbsp;&nbsp;warn_on_readonly:&nbsp;if&nbsp;True,&nbsp;log&nbsp;a&nbsp;warning&nbsp;if&nbsp;the&nbsp;store&nbsp;is&nbsp;readonly<br>
209&nbsp;<br>
210Returns:<br>
211&nbsp;&nbsp;An&nbsp;object&nbsp;derived&nbsp;from&nbsp;client.Storage&nbsp;for&nbsp;getting/setting&nbsp;the<br>
212&nbsp;&nbsp;credential.</tt></dd></dl>
213</td></tr></table><p>
214<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
215<tr bgcolor="#55aa55">
216<td colspan=3 valign=bottom>&nbsp;<br>
217<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
218
219<tr><td bgcolor="#55aa55"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
220<td width="100%"><strong>__author__</strong> = 'jbeda@google.com (Joe Beda)'<br>
Joe Gregoriob417caf2011-12-08 12:04:24 -0500221<strong>logger</strong> = &lt;logging.Logger instance&gt;</td></tr></table><p>
Joe Gregorioa8451672011-09-15 09:53:21 -0400222<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
223<tr bgcolor="#7799ee">
224<td colspan=3 valign=bottom>&nbsp;<br>
225<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
226
227<tr><td bgcolor="#7799ee"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
228<td width="100%">jbeda@google.com&nbsp;(Joe&nbsp;Beda)</td></tr></table>
229</body></html>