diff options
author | Joe Gregorio <jcgregorio@google.com> | 2011-07-06 10:09:20 -0400 |
---|---|---|
committer | Joe Gregorio <jcgregorio@google.com> | 2011-07-06 10:09:20 -0400 |
commit | 90e7ec264106c953721380cd33e982ab45bf0047 (patch) | |
tree | 7df2e648805fcf253e7b791c1a3c36625a6028be /docs | |
parent | c47fab7a57f719fa855a1282dc6894a3575e02ea (diff) | |
download | google-api-python-client-90e7ec264106c953721380cd33e982ab45bf0047.tar.gz |
Fix up docs and how that are generated.
Diffstat (limited to 'docs')
-rw-r--r-- | docs/apiclient.errors.html | 10 | ||||
-rw-r--r-- | docs/apiclient.ext.django_orm.html | 68 | ||||
-rw-r--r-- | docs/apiclient.oauth.html | 8 | ||||
-rwxr-xr-x | docs/build.sh | 8 | ||||
-rw-r--r-- | docs/dyn/buzz.v1.activities.html | 3 | ||||
-rw-r--r-- | docs/dyn/buzz.v1.photos.html | 6 | ||||
-rw-r--r-- | docs/httplib2.html | 10 | ||||
-rw-r--r-- | docs/httplib2.socks.html | 38 | ||||
-rw-r--r-- | docs/oauth2client.appengine.html | 688 | ||||
-rw-r--r-- | docs/oauth2client.client.html | 8 | ||||
-rw-r--r-- | docs/oauth2client.django_orm.html | 68 |
11 files changed, 748 insertions, 167 deletions
diff --git a/docs/apiclient.errors.html b/docs/apiclient.errors.html index 3a31c12c4..8b7947165 100644 --- a/docs/apiclient.errors.html +++ b/docs/apiclient.errors.html @@ -67,7 +67,7 @@ Data descriptors defined here:<br> </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -189,7 +189,7 @@ Data descriptors inherited from <a href="apiclient.errors.html#Error">Error</a>: </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="InvalidJsonError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#InvalidJsonError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="InvalidJsonError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#InvalidJsonError-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -250,7 +250,7 @@ Data descriptors inherited from <a href="apiclient.errors.html#Error">Error</a>: </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="MediaUploadSizeError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#MediaUploadSizeError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="MediaUploadSizeError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#MediaUploadSizeError-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -311,7 +311,7 @@ Data descriptors inherited from <a href="apiclient.errors.html#Error">Error</a>: </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="UnacceptableMimeTypeError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#UnacceptableMimeTypeError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="UnacceptableMimeTypeError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#UnacceptableMimeTypeError-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -372,7 +372,7 @@ Data descriptors inherited from <a href="apiclient.errors.html#Error">Error</a>: </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="UnknownLinkType-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#UnknownLinkType-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="UnknownLinkType-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#UnknownLinkType-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> diff --git a/docs/apiclient.ext.django_orm.html b/docs/apiclient.ext.django_orm.html index 8dfbc6923..91b9e705d 100644 --- a/docs/apiclient.ext.django_orm.html +++ b/docs/apiclient.ext.django_orm.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>.<a href="apiclient.ext.html"><font color="#ffffff">ext</font></a>.django_orm</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/google-api-python-client/apiclient/ext/django_orm.py">/home/jcgregorio/projects/google-api-python-client/apiclient/ext/django_orm.py</a></font></td></tr></table> +><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/jcgregorio/projects/apiclient/apiclient/ext/django_orm.py">/usr/local/google/home/jcgregorio/projects/apiclient/apiclient/ext/django_orm.py</a></font></td></tr></table> <p><tt># Copyright (C) 2010 Google Inc.<br> #<br> # Licensed under the Apache License, Version 2.0 (the "License");<br> @@ -65,13 +65,9 @@ Methods defined here:<br> <dl><dt><a name="FlowThreeLeggedField-contribute_to_class"><strong>contribute_to_class</strong></a>(self, cls, name)</dt></dl> -<dl><dt><a name="FlowThreeLeggedField-db_type"><strong>db_type</strong></a> = inner(*args, **kwargs)</dt></dl> +<dl><dt><a name="FlowThreeLeggedField-db_type"><strong>db_type</strong></a>(self)</dt></dl> -<dl><dt><a name="FlowThreeLeggedField-get_db_prep_lookup"><strong>get_db_prep_lookup</strong></a> = inner(*args, **kwargs)</dt></dl> - -<dl><dt><a name="FlowThreeLeggedField-get_db_prep_save"><strong>get_db_prep_save</strong></a> = inner(*args, **kwargs)</dt></dl> - -<dl><dt><a name="FlowThreeLeggedField-get_db_prep_value"><strong>get_db_prep_value</strong></a> = inner(*args, **kwargs)</dt></dl> +<dl><dt><a name="FlowThreeLeggedField-get_db_prep_value"><strong>get_db_prep_value</strong></a>(self, value)</dt></dl> <dl><dt><a name="FlowThreeLeggedField-to_python"><strong>to_python</strong></a>(self, value)</dt></dl> @@ -86,14 +82,10 @@ Methods inherited from <a href="django.db.models.fields.html#Field">django.db.mo <dl><dt><a name="FlowThreeLeggedField-__deepcopy__"><strong>__deepcopy__</strong></a>(self, memodict)</dt></dl> -<dl><dt><a name="FlowThreeLeggedField-__init__"><strong>__init__</strong></a>(self, verbose_name<font color="#909090">=None</font>, name<font color="#909090">=None</font>, primary_key<font color="#909090">=False</font>, max_length<font color="#909090">=None</font>, unique<font color="#909090">=False</font>, blank<font color="#909090">=False</font>, null<font color="#909090">=False</font>, db_index<font color="#909090">=False</font>, rel<font color="#909090">=None</font>, default<font color="#909090">=<class django.db.models.fields.NOT_PROVIDED></font>, editable<font color="#909090">=True</font>, serialize<font color="#909090">=True</font>, unique_for_date<font color="#909090">=None</font>, unique_for_month<font color="#909090">=None</font>, unique_for_year<font color="#909090">=None</font>, choices<font color="#909090">=None</font>, help_text<font color="#909090">=''</font>, db_column<font color="#909090">=None</font>, db_tablespace<font color="#909090">=None</font>, auto_created<font color="#909090">=False</font>, validators<font color="#909090">=[]</font>, error_messages<font color="#909090">=None</font>)</dt></dl> +<dl><dt><a name="FlowThreeLeggedField-__init__"><strong>__init__</strong></a>(self, verbose_name<font color="#909090">=None</font>, name<font color="#909090">=None</font>, primary_key<font color="#909090">=False</font>, max_length<font color="#909090">=None</font>, unique<font color="#909090">=False</font>, blank<font color="#909090">=False</font>, null<font color="#909090">=False</font>, db_index<font color="#909090">=False</font>, rel<font color="#909090">=None</font>, default<font color="#909090">=<class django.db.models.fields.NOT_PROVIDED></font>, editable<font color="#909090">=True</font>, serialize<font color="#909090">=True</font>, unique_for_date<font color="#909090">=None</font>, unique_for_month<font color="#909090">=None</font>, unique_for_year<font color="#909090">=None</font>, choices<font color="#909090">=None</font>, help_text<font color="#909090">=''</font>, db_column<font color="#909090">=None</font>, db_tablespace<font color="#909090">=None</font>, auto_created<font color="#909090">=False</font>)</dt></dl> <dl><dt><a name="FlowThreeLeggedField-bind"><strong>bind</strong></a>(self, fieldmapping, original, bound_field_class)</dt></dl> -<dl><dt><a name="FlowThreeLeggedField-clean"><strong>clean</strong></a>(self, value, model_instance)</dt><dd><tt>Convert the value's type and run validation. Validation errors from to_python<br> -and validate are propagated. The correct value is returned if no error is<br> -raised.</tt></dd></dl> - <dl><dt><a name="FlowThreeLeggedField-formfield"><strong>formfield</strong></a>(self, form_class<font color="#909090">=<class 'django.forms.fields.CharField'></font>, **kwargs)</dt><dd><tt>Returns a django.forms.<a href="django.db.models.fields.html#Field">Field</a> instance for this database <a href="django.db.models.fields.html#Field">Field</a>.</tt></dd></dl> <dl><dt><a name="FlowThreeLeggedField-get_attname"><strong>get_attname</strong></a>(self)</dt></dl> @@ -107,31 +99,26 @@ as SelectField choices for this field.</tt></dd></dl> <dl><dt><a name="FlowThreeLeggedField-get_choices_default"><strong>get_choices_default</strong></a>(self)</dt></dl> +<dl><dt><a name="FlowThreeLeggedField-get_db_prep_lookup"><strong>get_db_prep_lookup</strong></a>(self, lookup_type, value)</dt><dd><tt>Returns field's value prepared for database lookup.</tt></dd></dl> + +<dl><dt><a name="FlowThreeLeggedField-get_db_prep_save"><strong>get_db_prep_save</strong></a>(self, value)</dt><dd><tt>Returns field's value prepared for saving into a database.</tt></dd></dl> + <dl><dt><a name="FlowThreeLeggedField-get_default"><strong>get_default</strong></a>(self)</dt><dd><tt>Returns the default value for this field.</tt></dd></dl> <dl><dt><a name="FlowThreeLeggedField-get_flatchoices"><strong>get_flatchoices</strong></a>(self, include_blank<font color="#909090">=True</font>, blank_choice<font color="#909090">=[('', '---------')]</font>)</dt><dd><tt>Returns flattened choices with a default blank choice included.</tt></dd></dl> <dl><dt><a name="FlowThreeLeggedField-get_internal_type"><strong>get_internal_type</strong></a>(self)</dt></dl> -<dl><dt><a name="FlowThreeLeggedField-get_prep_lookup"><strong>get_prep_lookup</strong></a>(self, lookup_type, value)</dt><dd><tt>Perform preliminary non-db specific lookup checks and conversions</tt></dd></dl> - -<dl><dt><a name="FlowThreeLeggedField-get_prep_value"><strong>get_prep_value</strong></a>(self, value)</dt><dd><tt>Perform preliminary non-db specific value checks and conversions.</tt></dd></dl> - <dl><dt><a name="FlowThreeLeggedField-get_validator_unique_lookup_type"><strong>get_validator_unique_lookup_type</strong></a>(self)</dt></dl> <dl><dt><a name="FlowThreeLeggedField-has_default"><strong>has_default</strong></a>(self)</dt><dd><tt>Returns a boolean of whether this field has a default value.</tt></dd></dl> <dl><dt><a name="FlowThreeLeggedField-pre_save"><strong>pre_save</strong></a>(self, model_instance, add)</dt><dd><tt>Returns field's value just before saving.</tt></dd></dl> -<dl><dt><a name="FlowThreeLeggedField-run_validators"><strong>run_validators</strong></a>(self, value)</dt></dl> - <dl><dt><a name="FlowThreeLeggedField-save_form_data"><strong>save_form_data</strong></a>(self, instance, data)</dt></dl> <dl><dt><a name="FlowThreeLeggedField-set_attributes_from_name"><strong>set_attributes_from_name</strong></a>(self, name)</dt></dl> -<dl><dt><a name="FlowThreeLeggedField-validate"><strong>validate</strong></a>(self, value, model_instance)</dt><dd><tt>Validates value and throws ValidationError. Subclasses should override<br> -this to provide validation logic.</tt></dd></dl> - <dl><dt><a name="FlowThreeLeggedField-value_from_object"><strong>value_from_object</strong></a>(self, obj)</dt><dd><tt>Returns the value of this field in the given model instance.</tt></dd></dl> <dl><dt><a name="FlowThreeLeggedField-value_to_string"><strong>value_to_string</strong></a>(self, obj)</dt><dd><tt>Returns a string value of this field from the passed obj.<br> @@ -147,8 +134,6 @@ Data descriptors inherited from <a href="django.db.models.fields.html#Field">dja </dl> <dl><dt><strong>choices</strong></dt> </dl> -<dl><dt><strong>description</strong></dt> -</dl> <dl><dt><strong>flatchoices</strong></dt> <dd><tt>Flattened version of choices tuple.</tt></dd> </dl> @@ -160,10 +145,6 @@ Data and other attributes inherited from <a href="django.db.models.fields.html#F <dl><dt><strong>creation_counter</strong> = 0</dl> -<dl><dt><strong>default_error_messages</strong> = {'blank': <django.utils.functional.__proxy__ object>, 'invalid_choice': <django.utils.functional.__proxy__ object>, 'null': <django.utils.functional.__proxy__ object>}</dl> - -<dl><dt><strong>default_validators</strong> = []</dl> - <dl><dt><strong>empty_strings_allowed</strong> = True</dl> </td></tr></table> <p> @@ -182,13 +163,9 @@ Data and other attributes inherited from <a href="django.db.models.fields.html#F Methods defined here:<br> <dl><dt><a name="OAuthCredentialsField-contribute_to_class"><strong>contribute_to_class</strong></a>(self, cls, name)</dt></dl> -<dl><dt><a name="OAuthCredentialsField-db_type"><strong>db_type</strong></a> = inner(*args, **kwargs)</dt></dl> +<dl><dt><a name="OAuthCredentialsField-db_type"><strong>db_type</strong></a>(self)</dt></dl> -<dl><dt><a name="OAuthCredentialsField-get_db_prep_lookup"><strong>get_db_prep_lookup</strong></a> = inner(*args, **kwargs)</dt></dl> - -<dl><dt><a name="OAuthCredentialsField-get_db_prep_save"><strong>get_db_prep_save</strong></a> = inner(*args, **kwargs)</dt></dl> - -<dl><dt><a name="OAuthCredentialsField-get_db_prep_value"><strong>get_db_prep_value</strong></a> = inner(*args, **kwargs)</dt></dl> +<dl><dt><a name="OAuthCredentialsField-get_db_prep_value"><strong>get_db_prep_value</strong></a>(self, value)</dt></dl> <dl><dt><a name="OAuthCredentialsField-to_python"><strong>to_python</strong></a>(self, value)</dt></dl> @@ -203,14 +180,10 @@ Methods inherited from <a href="django.db.models.fields.html#Field">django.db.mo <dl><dt><a name="OAuthCredentialsField-__deepcopy__"><strong>__deepcopy__</strong></a>(self, memodict)</dt></dl> -<dl><dt><a name="OAuthCredentialsField-__init__"><strong>__init__</strong></a>(self, verbose_name<font color="#909090">=None</font>, name<font color="#909090">=None</font>, primary_key<font color="#909090">=False</font>, max_length<font color="#909090">=None</font>, unique<font color="#909090">=False</font>, blank<font color="#909090">=False</font>, null<font color="#909090">=False</font>, db_index<font color="#909090">=False</font>, rel<font color="#909090">=None</font>, default<font color="#909090">=<class django.db.models.fields.NOT_PROVIDED></font>, editable<font color="#909090">=True</font>, serialize<font color="#909090">=True</font>, unique_for_date<font color="#909090">=None</font>, unique_for_month<font color="#909090">=None</font>, unique_for_year<font color="#909090">=None</font>, choices<font color="#909090">=None</font>, help_text<font color="#909090">=''</font>, db_column<font color="#909090">=None</font>, db_tablespace<font color="#909090">=None</font>, auto_created<font color="#909090">=False</font>, validators<font color="#909090">=[]</font>, error_messages<font color="#909090">=None</font>)</dt></dl> +<dl><dt><a name="OAuthCredentialsField-__init__"><strong>__init__</strong></a>(self, verbose_name<font color="#909090">=None</font>, name<font color="#909090">=None</font>, primary_key<font color="#909090">=False</font>, max_length<font color="#909090">=None</font>, unique<font color="#909090">=False</font>, blank<font color="#909090">=False</font>, null<font color="#909090">=False</font>, db_index<font color="#909090">=False</font>, rel<font color="#909090">=None</font>, default<font color="#909090">=<class django.db.models.fields.NOT_PROVIDED></font>, editable<font color="#909090">=True</font>, serialize<font color="#909090">=True</font>, unique_for_date<font color="#909090">=None</font>, unique_for_month<font color="#909090">=None</font>, unique_for_year<font color="#909090">=None</font>, choices<font color="#909090">=None</font>, help_text<font color="#909090">=''</font>, db_column<font color="#909090">=None</font>, db_tablespace<font color="#909090">=None</font>, auto_created<font color="#909090">=False</font>)</dt></dl> <dl><dt><a name="OAuthCredentialsField-bind"><strong>bind</strong></a>(self, fieldmapping, original, bound_field_class)</dt></dl> -<dl><dt><a name="OAuthCredentialsField-clean"><strong>clean</strong></a>(self, value, model_instance)</dt><dd><tt>Convert the value's type and run validation. Validation errors from to_python<br> -and validate are propagated. The correct value is returned if no error is<br> -raised.</tt></dd></dl> - <dl><dt><a name="OAuthCredentialsField-formfield"><strong>formfield</strong></a>(self, form_class<font color="#909090">=<class 'django.forms.fields.CharField'></font>, **kwargs)</dt><dd><tt>Returns a django.forms.<a href="django.db.models.fields.html#Field">Field</a> instance for this database <a href="django.db.models.fields.html#Field">Field</a>.</tt></dd></dl> <dl><dt><a name="OAuthCredentialsField-get_attname"><strong>get_attname</strong></a>(self)</dt></dl> @@ -224,31 +197,26 @@ as SelectField choices for this field.</tt></dd></dl> <dl><dt><a name="OAuthCredentialsField-get_choices_default"><strong>get_choices_default</strong></a>(self)</dt></dl> +<dl><dt><a name="OAuthCredentialsField-get_db_prep_lookup"><strong>get_db_prep_lookup</strong></a>(self, lookup_type, value)</dt><dd><tt>Returns field's value prepared for database lookup.</tt></dd></dl> + +<dl><dt><a name="OAuthCredentialsField-get_db_prep_save"><strong>get_db_prep_save</strong></a>(self, value)</dt><dd><tt>Returns field's value prepared for saving into a database.</tt></dd></dl> + <dl><dt><a name="OAuthCredentialsField-get_default"><strong>get_default</strong></a>(self)</dt><dd><tt>Returns the default value for this field.</tt></dd></dl> <dl><dt><a name="OAuthCredentialsField-get_flatchoices"><strong>get_flatchoices</strong></a>(self, include_blank<font color="#909090">=True</font>, blank_choice<font color="#909090">=[('', '---------')]</font>)</dt><dd><tt>Returns flattened choices with a default blank choice included.</tt></dd></dl> <dl><dt><a name="OAuthCredentialsField-get_internal_type"><strong>get_internal_type</strong></a>(self)</dt></dl> -<dl><dt><a name="OAuthCredentialsField-get_prep_lookup"><strong>get_prep_lookup</strong></a>(self, lookup_type, value)</dt><dd><tt>Perform preliminary non-db specific lookup checks and conversions</tt></dd></dl> - -<dl><dt><a name="OAuthCredentialsField-get_prep_value"><strong>get_prep_value</strong></a>(self, value)</dt><dd><tt>Perform preliminary non-db specific value checks and conversions.</tt></dd></dl> - <dl><dt><a name="OAuthCredentialsField-get_validator_unique_lookup_type"><strong>get_validator_unique_lookup_type</strong></a>(self)</dt></dl> <dl><dt><a name="OAuthCredentialsField-has_default"><strong>has_default</strong></a>(self)</dt><dd><tt>Returns a boolean of whether this field has a default value.</tt></dd></dl> <dl><dt><a name="OAuthCredentialsField-pre_save"><strong>pre_save</strong></a>(self, model_instance, add)</dt><dd><tt>Returns field's value just before saving.</tt></dd></dl> -<dl><dt><a name="OAuthCredentialsField-run_validators"><strong>run_validators</strong></a>(self, value)</dt></dl> - <dl><dt><a name="OAuthCredentialsField-save_form_data"><strong>save_form_data</strong></a>(self, instance, data)</dt></dl> <dl><dt><a name="OAuthCredentialsField-set_attributes_from_name"><strong>set_attributes_from_name</strong></a>(self, name)</dt></dl> -<dl><dt><a name="OAuthCredentialsField-validate"><strong>validate</strong></a>(self, value, model_instance)</dt><dd><tt>Validates value and throws ValidationError. Subclasses should override<br> -this to provide validation logic.</tt></dd></dl> - <dl><dt><a name="OAuthCredentialsField-value_from_object"><strong>value_from_object</strong></a>(self, obj)</dt><dd><tt>Returns the value of this field in the given model instance.</tt></dd></dl> <dl><dt><a name="OAuthCredentialsField-value_to_string"><strong>value_to_string</strong></a>(self, obj)</dt><dd><tt>Returns a string value of this field from the passed obj.<br> @@ -264,8 +232,6 @@ Data descriptors inherited from <a href="django.db.models.fields.html#Field">dja </dl> <dl><dt><strong>choices</strong></dt> </dl> -<dl><dt><strong>description</strong></dt> -</dl> <dl><dt><strong>flatchoices</strong></dt> <dd><tt>Flattened version of choices tuple.</tt></dd> </dl> @@ -277,10 +243,6 @@ Data and other attributes inherited from <a href="django.db.models.fields.html#F <dl><dt><strong>creation_counter</strong> = 0</dl> -<dl><dt><strong>default_error_messages</strong> = {'blank': <django.utils.functional.__proxy__ object>, 'invalid_choice': <django.utils.functional.__proxy__ object>, 'null': <django.utils.functional.__proxy__ object>}</dl> - -<dl><dt><strong>default_validators</strong> = []</dl> - <dl><dt><strong>empty_strings_allowed</strong> = True</dl> </td></tr></table></td></tr></table> diff --git a/docs/apiclient.oauth.html b/docs/apiclient.oauth.html index 192658300..b019d535b 100644 --- a/docs/apiclient.oauth.html +++ b/docs/apiclient.oauth.html @@ -115,7 +115,7 @@ Data descriptors inherited from <a href="apiclient.oauth.html#Error">Error</a>:< </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="CredentialsInvalidError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#CredentialsInvalidError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="CredentialsInvalidError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#CredentialsInvalidError-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -175,7 +175,7 @@ Data descriptors defined here:<br> </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -303,7 +303,7 @@ Data descriptors inherited from <a href="apiclient.oauth.html#Error">Error</a>:< </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="MissingParameter-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingParameter-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="MissingParameter-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingParameter-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -432,7 +432,7 @@ Data descriptors inherited from <a href="apiclient.oauth.html#Error">Error</a>:< </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="RequestError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="RequestError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> diff --git a/docs/build.sh b/docs/build.sh index 7ca373754..47367b1ac 100755 --- a/docs/build.sh +++ b/docs/build.sh @@ -25,8 +25,8 @@ export GOOGLE_APPENGINE=$HOME/projects/google_appengine export DJANGO_SETTINGS_MODULE=fakesettings export PYTHONPATH=`pwd`/..:$GOOGLE_APPENGINE -find ../apiclient/ -name "*.py" | sed "s/\/__init__.py//" | sed "s/\.py//" | sed "s/^\.\.\///" | sed "s#/#.#g" | xargs pydoc -w -find ../oauth2client/ -name "*.py" | sed "s/\/__init__.py//" | sed "s/\.py//" | sed "s/^\.\.\///" | sed "s#/#.#g" | xargs pydoc -w -find ../httplib2/ -name "*.py" | sed "s/\/__init__.py//" | sed "s/\.py//" | sed "s/^\.\.\///" | sed "s#/#.#g" | xargs pydoc -w -find ../uritemplate/ -name "*.py" | sed "s/\/__init__.py//" | sed "s/\.py//" | sed "s/^\.\.\///" | sed "s#/#.#g" | xargs pydoc -w +find ../apiclient/ -name "*.py" | sed "s/\/__init__.py//" | sed "s/\.py//" | sed "s/^\.\.\///" | sed "s#/#.#g" | xargs python `which pydoc` -w +find ../oauth2client/ -name "*.py" | sed "s/\/__init__.py//" | sed "s/\.py//" | sed "s/^\.\.\///" | sed "s#/#.#g" | xargs python `which pydoc` -w +find ../httplib2/ -name "*.py" | sed "s/\/__init__.py//" | sed "s/\.py//" | sed "s/^\.\.\///" | sed "s#/#.#g" | xargs python `which pydoc` -w +find ../uritemplate/ -name "*.py" | sed "s/\/__init__.py//" | sed "s/\.py//" | sed "s/^\.\.\///" | sed "s#/#.#g" | xargs python `which pydoc` -w diff --git a/docs/dyn/buzz.v1.activities.html b/docs/dyn/buzz.v1.activities.html index d643864ac..e512683e6 100644 --- a/docs/dyn/buzz.v1.activities.html +++ b/docs/dyn/buzz.v1.activities.html @@ -70,7 +70,8 @@ Args:<br> <dl><dt><a name="Resource-insert"><strong>insert</strong></a> = method(self, **kwargs)</dt><dd><tt>Create a new activity<br> <br> Args:<br> - body: object, The request body. (required)<br> + body: object, The request body.<br> + media_body: string, The filename of the media request body.<br> userId: string, ID of the user being referenced. (required)<br> hl: string, Language code to limit language results.<br> alt: string, Specifies an alternative representation type.<br> diff --git a/docs/dyn/buzz.v1.photos.html b/docs/dyn/buzz.v1.photos.html index c46eba931..847cc6e6a 100644 --- a/docs/dyn/buzz.v1.photos.html +++ b/docs/dyn/buzz.v1.photos.html @@ -41,7 +41,8 @@ Args:<br> <dl><dt><a name="Resource-insert"><strong>insert</strong></a> = method(self, **kwargs)</dt><dd><tt>Upload a photo to an album<br> <br> Args:<br> - body: object, The request body. (required)<br> + body: object, The request body.<br> + media_body: string, The filename of the media request body.<br> albumId: string, ID of the album to which to upload. (required)<br> userId: string, ID of the user being referenced. (required)<br> hl: string, Language code to limit language results.<br> @@ -53,7 +54,8 @@ Args:<br> <dl><dt><a name="Resource-insert2"><strong>insert2</strong></a> = method(self, **kwargs)</dt><dd><tt>Upload a photo to an album<br> <br> Args:<br> - body: object, The request body. (required)<br> + body: object, The request body.<br> + media_body: string, The filename of the media request body.<br> albumId: string, ID of the album to which to upload. (required)<br> userId: string, ID of the user being referenced. (required)<br> hl: string, Language code to limit language results.<br> diff --git a/docs/httplib2.html b/docs/httplib2.html index e6db3b2f6..e02bd394b 100644 --- a/docs/httplib2.html +++ b/docs/httplib2.html @@ -219,7 +219,7 @@ Data descriptors defined here:<br> </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="HttpLib2Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#HttpLib2Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="HttpLib2Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#HttpLib2Error-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -278,7 +278,7 @@ Data descriptors inherited from <a href="httplib2.html#HttpLib2Error">HttpLib2Er </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="ProxiesUnavailableError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxiesUnavailableError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="ProxiesUnavailableError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxiesUnavailableError-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -570,12 +570,6 @@ In either case, this is followed by: for  <dl><dt><a name="Response-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#Response-values">values</a>() -> list of D's values</tt></dd></dl> -<dl><dt><a name="Response-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#Response-viewitems">viewitems</a>() -> a set-like <a href="__builtin__.html#object">object</a> providing a view on D's items</tt></dd></dl> - -<dl><dt><a name="Response-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#Response-viewkeys">viewkeys</a>() -> a set-like <a href="__builtin__.html#object">object</a> providing a view on D's keys</tt></dd></dl> - -<dl><dt><a name="Response-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#Response-viewvalues">viewvalues</a>() -> an <a href="__builtin__.html#object">object</a> providing a view on D's values</tt></dd></dl> - <hr> Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br> <dl><dt><strong>__hash__</strong> = None</dl> diff --git a/docs/httplib2.socks.html b/docs/httplib2.socks.html index 67665604a..4f65a85c0 100644 --- a/docs/httplib2.socks.html +++ b/docs/httplib2.socks.html @@ -99,7 +99,7 @@ Data descriptors inherited from <a href="httplib2.socks.html#ProxyError">ProxyEr </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="GeneralProxyError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#GeneralProxyError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="GeneralProxyError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#GeneralProxyError-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -158,7 +158,7 @@ Data descriptors inherited from <a href="httplib2.socks.html#ProxyError">ProxyEr </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="HTTPError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#HTTPError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="HTTPError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#HTTPError-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -216,7 +216,7 @@ Data descriptors defined here:<br> </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="ProxyError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="ProxyError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -275,7 +275,7 @@ Data descriptors inherited from <a href="httplib2.socks.html#ProxyError">ProxyEr </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="Socks4Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Socks4Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="Socks4Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Socks4Error-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -334,7 +334,7 @@ Data descriptors inherited from <a href="httplib2.socks.html#ProxyError">ProxyEr </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="Socks5AuthError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Socks5AuthError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="Socks5AuthError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Socks5AuthError-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -393,7 +393,7 @@ Data descriptors inherited from <a href="httplib2.socks.html#ProxyError">ProxyEr </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="Socks5Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Socks5Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="Socks5Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Socks5Error-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -497,17 +497,17 @@ Wait for an incoming connection. Return a&nb connection, and the address of the client. For IP sockets, the address<br> info is a pair (hostaddr, port).</tt></dd></dl> -<dl><dt><a name="socksocket-bind"><strong>bind</strong></a>(...)</dt><dd><tt><a href="#socksocket-bind">bind</a>(address)<br> +<dl><dt><a name="socksocket-bind"><strong>bind</strong></a>(self, *args)</dt><dd><tt><a href="#socksocket-bind">bind</a>(address)<br> <br> Bind the socket to a local address. For IP sockets, the address is a<br> pair (host, port); the host must refer to the local host. For raw packet<br> sockets the address is a tuple (ifname, proto [,pkttype [,hatype]])</tt></dd></dl> -<dl><dt><a name="socksocket-close"><strong>close</strong></a>(self, _closedsocket<font color="#909090">=<class 'socket._closedsocket'></font>, _delegate_methods<font color="#909090">=('recv', 'recvfrom', 'recv_into', 'recvfrom_into', 'send', 'sendto')</font>, setattr<font color="#909090">=<built-in function setattr></font>)</dt><dd><tt><a href="#socksocket-close">close</a>()<br> +<dl><dt><a name="socksocket-close"><strong>close</strong></a>(self)</dt><dd><tt><a href="#socksocket-close">close</a>()<br> <br> Close the socket. It cannot be used after this call.</tt></dd></dl> -<dl><dt><a name="socksocket-connect_ex"><strong>connect_ex</strong></a>(...)</dt><dd><tt><a href="#socksocket-connect_ex">connect_ex</a>(address) -> errno<br> +<dl><dt><a name="socksocket-connect_ex"><strong>connect_ex</strong></a>(self, *args)</dt><dd><tt><a href="#socksocket-connect_ex">connect_ex</a>(address) -> errno<br> <br> This is like <a href="#socksocket-connect">connect</a>(address), but returns an error code (the errno value)<br> instead of raising an exception when an error occurs.</tt></dd></dl> @@ -516,28 +516,28 @@ instead of raising an exception when an error <br> Return a new socket object connected to the same system resource.</tt></dd></dl> -<dl><dt><a name="socksocket-fileno"><strong>fileno</strong></a>(...)</dt><dd><tt><a href="#socksocket-fileno">fileno</a>() -> integer<br> +<dl><dt><a name="socksocket-fileno"><strong>fileno</strong></a>(self, *args)</dt><dd><tt><a href="#socksocket-fileno">fileno</a>() -> integer<br> <br> Return the integer file descriptor of the socket.</tt></dd></dl> -<dl><dt><a name="socksocket-getsockname"><strong>getsockname</strong></a>(...)</dt><dd><tt><a href="#socksocket-getsockname">getsockname</a>() -> address info<br> +<dl><dt><a name="socksocket-getsockname"><strong>getsockname</strong></a>(self, *args)</dt><dd><tt><a href="#socksocket-getsockname">getsockname</a>() -> address info<br> <br> Return the address of the local endpoint. For IP sockets, the address<br> info is a pair (hostaddr, port).</tt></dd></dl> -<dl><dt><a name="socksocket-getsockopt"><strong>getsockopt</strong></a>(...)</dt><dd><tt><a href="#socksocket-getsockopt">getsockopt</a>(level, option[, buffersize]) -> value<br> +<dl><dt><a name="socksocket-getsockopt"><strong>getsockopt</strong></a>(self, *args)</dt><dd><tt><a href="#socksocket-getsockopt">getsockopt</a>(level, option[, buffersize]) -> value<br> <br> Get a socket option. See the Unix manual for level and option.<br> If a nonzero buffersize argument is given, the return value is a<br> string of that length; otherwise it is an integer.</tt></dd></dl> -<dl><dt><a name="socksocket-gettimeout"><strong>gettimeout</strong></a>(...)</dt><dd><tt><a href="#socksocket-gettimeout">gettimeout</a>() -> timeout<br> +<dl><dt><a name="socksocket-gettimeout"><strong>gettimeout</strong></a>(self, *args)</dt><dd><tt><a href="#socksocket-gettimeout">gettimeout</a>() -> timeout<br> <br> Returns the timeout in floating seconds associated with socket <br> operations. A timeout of None indicates that timeouts on socket <br> operations are disabled.</tt></dd></dl> -<dl><dt><a name="socksocket-listen"><strong>listen</strong></a>(...)</dt><dd><tt><a href="#socksocket-listen">listen</a>(backlog)<br> +<dl><dt><a name="socksocket-listen"><strong>listen</strong></a>(self, *args)</dt><dd><tt><a href="#socksocket-listen">listen</a>(backlog)<br> <br> Enable a server to accept connections. The backlog argument must be at<br> least 1; it specifies the number of unaccepted connection that the system<br> @@ -548,32 +548,32 @@ will allow before refusing new connections.</tt></dd></ Return a regular file object corresponding to the socket. The mode<br> and bufsize arguments are as for the built-in open() function.</tt></dd></dl> -<dl><dt><a name="socksocket-sendall"><strong>sendall</strong></a>(...)</dt><dd><tt><a href="#socksocket-sendall">sendall</a>(data[, flags])<br> +<dl><dt><a name="socksocket-sendall"><strong>sendall</strong></a>(self, *args)</dt><dd><tt><a href="#socksocket-sendall">sendall</a>(data[, flags])<br> <br> Send a data string to the socket. For the optional flags<br> argument, see the Unix manual. This calls <a href="#socksocket-send">send</a>() repeatedly<br> until all data is sent. If an error occurs, it's impossible<br> to tell how much data has been sent.</tt></dd></dl> -<dl><dt><a name="socksocket-setblocking"><strong>setblocking</strong></a>(...)</dt><dd><tt><a href="#socksocket-setblocking">setblocking</a>(flag)<br> +<dl><dt><a name="socksocket-setblocking"><strong>setblocking</strong></a>(self, *args)</dt><dd><tt><a href="#socksocket-setblocking">setblocking</a>(flag)<br> <br> Set the socket to blocking (flag is true) or non-blocking (false).<br> <a href="#socksocket-setblocking">setblocking</a>(True) is equivalent to <a href="#socksocket-settimeout">settimeout</a>(None);<br> <a href="#socksocket-setblocking">setblocking</a>(False) is equivalent to <a href="#socksocket-settimeout">settimeout</a>(0.0).</tt></dd></dl> -<dl><dt><a name="socksocket-setsockopt"><strong>setsockopt</strong></a>(...)</dt><dd><tt><a href="#socksocket-setsockopt">setsockopt</a>(level, option, value)<br> +<dl><dt><a name="socksocket-setsockopt"><strong>setsockopt</strong></a>(self, *args)</dt><dd><tt><a href="#socksocket-setsockopt">setsockopt</a>(level, option, value)<br> <br> Set a socket option. See the Unix manual for level and option.<br> The value argument can either be an integer or a string.</tt></dd></dl> -<dl><dt><a name="socksocket-settimeout"><strong>settimeout</strong></a>(...)</dt><dd><tt><a href="#socksocket-settimeout">settimeout</a>(timeout)<br> +<dl><dt><a name="socksocket-settimeout"><strong>settimeout</strong></a>(self, *args)</dt><dd><tt><a href="#socksocket-settimeout">settimeout</a>(timeout)<br> <br> Set a timeout on socket operations. 'timeout' can be a float,<br> giving in seconds, or None. Setting a timeout of None disables<br> the timeout feature and is equivalent to <a href="#socksocket-setblocking">setblocking</a>(1).<br> Setting a timeout of zero is the same as <a href="#socksocket-setblocking">setblocking</a>(0).</tt></dd></dl> -<dl><dt><a name="socksocket-shutdown"><strong>shutdown</strong></a>(...)</dt><dd><tt><a href="#socksocket-shutdown">shutdown</a>(flag)<br> +<dl><dt><a name="socksocket-shutdown"><strong>shutdown</strong></a>(self, *args)</dt><dd><tt><a href="#socksocket-shutdown">shutdown</a>(flag)<br> <br> Shut down the reading side of the socket (flag == SHUT_RD), the writing side<br> of the socket (flag == SHUT_WR), or both ends (flag == SHUT_RDWR).</tt></dd></dl> diff --git a/docs/oauth2client.appengine.html b/docs/oauth2client.appengine.html index 4a491adc1..6eb8d746b 100644 --- a/docs/oauth2client.appengine.html +++ b/docs/oauth2client.appengine.html @@ -19,9 +19,18 @@ Utilities for making it easier to use OAuth&n <font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr> <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="google.appengine.ext.db.html">google.appengine.ext.db</a><br> +<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="google.appengine.api.app_identity.app_identity.html">google.appengine.api.app_identity.app_identity</a><br> +<a href="base64.html">base64</a><br> +<a href="google.appengine.ext.db.html">google.appengine.ext.db</a><br> +</td><td width="25%" valign=top><a href="httplib2.html">httplib2</a><br> +<a href="logging.html">logging</a><br> +<a href="google.appengine.api.memcache.html">google.appengine.api.memcache</a><br> </td><td width="25%" valign=top><a href="pickle.html">pickle</a><br> -</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p> +<a href="simplejson.html">simplejson</a><br> +<a href="time.html">time</a><br> +</td><td width="25%" valign=top><a href="google.appengine.api.users.html">google.appengine.api.users</a><br> +<a href="google.appengine.ext.webapp.html">google.appengine.ext.webapp</a><br> +</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> @@ -29,6 +38,18 @@ Utilities for making it easier to use OAuth&n <tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td> <td width="100%"><dl> +<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a> +</font></dt><dd> +<dl> +<dt><font face="helvetica, arial"><a href="oauth2client.appengine.html#OAuth2Decorator">OAuth2Decorator</a> +</font></dt></dl> +</dd> +<dt><font face="helvetica, arial"><a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>(<a href="__builtin__.html#object">__builtin__.object</a>) +</font></dt><dd> +<dl> +<dt><font face="helvetica, arial"><a href="oauth2client.appengine.html#CredentialsModel">CredentialsModel</a> +</font></dt></dl> +</dd> <dt><font face="helvetica, arial"><a href="google.appengine.ext.db.html#Property">google.appengine.ext.db.Property</a>(<a href="__builtin__.html#object">__builtin__.object</a>) </font></dt><dd> <dl> @@ -36,6 +57,18 @@ Utilities for making it easier to use OAuth&n </font></dt><dt><font face="helvetica, arial"><a href="oauth2client.appengine.html#FlowProperty">FlowProperty</a> </font></dt></dl> </dd> +<dt><font face="helvetica, arial"><a href="google.appengine.ext.webapp.html#RequestHandler">google.appengine.ext.webapp.RequestHandler</a>(<a href="__builtin__.html#object">__builtin__.object</a>) +</font></dt><dd> +<dl> +<dt><font face="helvetica, arial"><a href="oauth2client.appengine.html#OAuth2Handler">OAuth2Handler</a> +</font></dt></dl> +</dd> +<dt><font face="helvetica, arial"><a href="oauth2client.client.html#AssertionCredentials">oauth2client.client.AssertionCredentials</a>(<a href="oauth2client.client.html#OAuth2Credentials">oauth2client.client.OAuth2Credentials</a>) +</font></dt><dd> +<dl> +<dt><font face="helvetica, arial"><a href="oauth2client.appengine.html#AppAssertionCredentials">AppAssertionCredentials</a> +</font></dt></dl> +</dd> <dt><font face="helvetica, arial"><a href="oauth2client.client.html#Storage">oauth2client.client.Storage</a>(<a href="__builtin__.html#object">__builtin__.object</a>) </font></dt><dd> <dl> @@ -47,6 +80,415 @@ Utilities for making it easier to use OAuth&n <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="AppAssertionCredentials">class <strong>AppAssertionCredentials</strong></a>(<a href="oauth2client.client.html#AssertionCredentials">oauth2client.client.AssertionCredentials</a>)</font></td></tr> + +<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td> +<td colspan=2><tt>Credentials <a href="__builtin__.html#object">object</a> for App Engine Assertion Grants<br> + <br> +This <a href="__builtin__.html#object">object</a> will allow an App Engine application to identify itself to Google<br> +and other OAuth 2.0 servers that can verify assertions. It can be used for<br> +the purpose of accessing data stored under an account assigned to the App<br> +Engine application itself. The algorithm used for generating the assertion is<br> +the Signed JSON Web Token (JWT) algorithm. Additional details can be found at<br> +the following link:<br> + <br> +<a href="http://self-issued.info/docs/draft-jones-json-web-token.html">http://self-issued.info/docs/draft-jones-json-web-token.html</a><br> + <br> +This credential does not require a flow to instantiate because it represents<br> +a two legged flow, and therefore has all of the required information to<br> +generate and refresh its own access tokens.<br> + <br> +AssertionFlowCredentials objects may be safely pickled and unpickled.<br> </tt></td></tr> +<tr><td> </td> +<td width="100%"><dl><dt>Method resolution order:</dt> +<dd><a href="oauth2client.appengine.html#AppAssertionCredentials">AppAssertionCredentials</a></dd> +<dd><a href="oauth2client.client.html#AssertionCredentials">oauth2client.client.AssertionCredentials</a></dd> +<dd><a href="oauth2client.client.html#OAuth2Credentials">oauth2client.client.OAuth2Credentials</a></dd> +<dd><a href="oauth2client.client.html#Credentials">oauth2client.client.Credentials</a></dd> +<dd><a href="__builtin__.html#object">__builtin__.object</a></dd> +</dl> +<hr> +Methods defined here:<br> +<dl><dt><a name="AppAssertionCredentials-__init__"><strong>__init__</strong></a>(self, scope, user_agent, audience<font color="#909090">='https://accounts.google.com/o/oauth2/token'</font>, assertion_type<font color="#909090">='http://oauth.net/grant_type/jwt/1.0/bearer'</font>, token_uri<font color="#909090">='https://accounts.google.com/o/oauth2/token'</font>, **kwargs)</dt><dd><tt>Constructor for <a href="#AppAssertionCredentials">AppAssertionCredentials</a><br> + <br> +Args:<br> + scope: string, scope of the credentials being requested.<br> + user_agent: string, The HTTP User-Agent to provide for this application.<br> + audience: string, The audience, or verifier of the assertion. For<br> + convenience defaults to Google's audience.<br> + assertion_type: string, Type name that will identify the format of the<br> + assertion string. For convience, defaults to the JSON Web Token (JWT)<br> + assertion type string.<br> + token_uri: string, URI for token endpoint. For convenience<br> + defaults to Google's endpoints but any OAuth 2.0 provider can be used.</tt></dd></dl> + +<hr> +Methods inherited from <a href="oauth2client.client.html#OAuth2Credentials">oauth2client.client.OAuth2Credentials</a>:<br> +<dl><dt><a name="AppAssertionCredentials-__getstate__"><strong>__getstate__</strong></a>(self)</dt><dd><tt>Trim the state down to something that can be pickled.</tt></dd></dl> + +<dl><dt><a name="AppAssertionCredentials-__setstate__"><strong>__setstate__</strong></a>(self, state)</dt><dd><tt>Reconstitute the state of the <a href="__builtin__.html#object">object</a> from being pickled.</tt></dd></dl> + +<dl><dt><a name="AppAssertionCredentials-authorize"><strong>authorize</strong></a>(self, http)</dt><dd><tt>Authorize an httplib2.Http instance with these credentials.<br> + <br> +Args:<br> + http: An instance of httplib2.Http<br> + or something that acts like it.<br> + <br> +Returns:<br> + A modified instance of http that was passed in.<br> + <br> +Example:<br> + <br> + h = httplib2.Http()<br> + h = credentials.<a href="#AppAssertionCredentials-authorize">authorize</a>(h)<br> + <br> +You can't create a new OAuth<br> +subclass of httplib2.Authenication because<br> +it never gets passed the absolute URI, which is<br> +needed for signing. So instead we have to overload<br> +'request' with a closure that adds in the<br> +Authorization header and then calls the original version<br> +of 'request()'.</tt></dd></dl> + +<dl><dt><a name="AppAssertionCredentials-set_store"><strong>set_store</strong></a>(self, store)</dt><dd><tt>Set the storage for the credential.<br> + <br> +Args:<br> + store: callable, a callable that when passed a Credential<br> + will store the credential back to where it came from.<br> + This is needed to store the latest access_token if it<br> + has expired and been refreshed.</tt></dd></dl> + +<hr> +Data descriptors inherited from <a href="oauth2client.client.html#OAuth2Credentials">oauth2client.client.OAuth2Credentials</a>:<br> +<dl><dt><strong>invalid</strong></dt> +<dd><tt>True if the credentials are invalid, such as being revoked.</tt></dd> +</dl> +<hr> +Data descriptors inherited from <a href="oauth2client.client.html#Credentials">oauth2client.client.Credentials</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="CredentialsModel">class <strong>CredentialsModel</strong></a>(<a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>)</font></td></tr> + +<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td> +<td colspan=2><tt><a href="oauth2client.client.html#Storage">Storage</a> for OAuth 2.0 Credentials<br> + <br> +<a href="oauth2client.client.html#Storage">Storage</a> of the model is keyed by the user.user_id().<br> </tt></td></tr> +<tr><td> </td> +<td width="100%"><dl><dt>Method resolution order:</dt> +<dd><a href="oauth2client.appengine.html#CredentialsModel">CredentialsModel</a></dd> +<dd><a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a></dd> +<dd><a href="__builtin__.html#object">__builtin__.object</a></dd> +</dl> +<hr> +Data descriptors defined here:<br> +<dl><dt><strong>credentials</strong></dt> +<dd><tt>App Engine datastore Property for Credentials.<br> + <br> +Utility property that allows easy storage and retrieval of<br> +oath2client.Credentials</tt></dd> +</dl> +<hr> +Methods inherited from <a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>:<br> +<dl><dt><a name="CredentialsModel-__init__"><strong>__init__</strong></a>(self, parent<font color="#909090">=None</font>, key_name<font color="#909090">=None</font>, _app<font color="#909090">=None</font>, _from_entity<font color="#909090">=False</font>, **kwds)</dt><dd><tt>Creates a new instance of this model.<br> + <br> +To create a new entity, you instantiate a model and then call <a href="#CredentialsModel-put">put</a>(),<br> +which saves the entity to the datastore:<br> + <br> + person = Person()<br> + person.name = 'Bret'<br> + person.<a href="#CredentialsModel-put">put</a>()<br> + <br> +You can initialize properties in the model in the constructor with keyword<br> +arguments:<br> + <br> + person = Person(name='Bret')<br> + <br> +We initialize all other properties to the default value (as defined by the<br> +properties in the model definition) if they are not provided in the<br> +constructor.<br> + <br> +Args:<br> + parent: Parent instance for this instance or None, indicating a top-<br> + level instance.<br> + key_name: Name for new model instance.<br> + _from_entity: Intentionally undocumented.<br> + kwds: Keyword arguments mapping to properties of model. Also:<br> + key: Key instance for this instance, if provided makes parent and<br> + key_name redundant (they do not need to be set but if they are<br> + they must match the key).</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-delete"><strong>delete</strong></a>(self, **kwargs)</dt><dd><tt>Deletes this entity from the datastore.<br> + <br> +Args:<br> + config: datastore_rpc.Configuration to use for this request.<br> + <br> +Raises:<br> + TransactionFailedError if the data could not be committed.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-dynamic_properties"><strong>dynamic_properties</strong></a>(self)</dt><dd><tt>Returns a list of all dynamic properties defined for instance.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-has_key"><strong>has_key</strong></a>(self)</dt><dd><tt>Determine if this model instance has a complete key.<br> + <br> +When not using a fully self-assigned Key, ids are not assigned until the<br> +data is saved to the Datastore, but instances with a key name always have<br> +a full key.<br> + <br> +Returns:<br> + True if the <a href="__builtin__.html#object">object</a> has been persisted to the datastore or has a key<br> + or has a key_name, otherwise False.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-instance_properties"><strong>instance_properties</strong></a>(self)</dt><dd><tt>Alias for dyanmic_properties.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-is_saved"><strong>is_saved</strong></a>(self)</dt><dd><tt>Determine if entity is persisted in the datastore.<br> + <br> +New instances of <a href="google.appengine.ext.db.html#Model">Model</a> do not start out saved in the data. Objects which<br> +are saved to or loaded from the Datastore will have a True saved state.<br> + <br> +Returns:<br> + True if <a href="__builtin__.html#object">object</a> has been persisted to the datastore, otherwise False.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-key"><strong>key</strong></a>(self)</dt><dd><tt>Unique key for this entity.<br> + <br> +This property is only available if this entity is already stored in the<br> +datastore or if it has a full key, so it is available if this entity was<br> +fetched returned from a query, or after <a href="#CredentialsModel-put">put</a>() is called the first time<br> +for new entities, or if a complete key was given when constructed.<br> + <br> +Returns:<br> + Datastore key of persisted entity.<br> + <br> +Raises:<br> + NotSavedError when entity is not persistent.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-parent"><strong>parent</strong></a>(self)</dt><dd><tt>Get the parent of the model instance.<br> + <br> +Returns:<br> + Parent of contained entity or parent provided in constructor, None if<br> + instance has no parent.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-parent_key"><strong>parent_key</strong></a>(self)</dt><dd><tt>Get the parent's key.<br> + <br> +This method is useful for avoiding a potential fetch from the datastore<br> +but still get information about the instances parent.<br> + <br> +Returns:<br> + Parent key of entity, None if there is no parent.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-put"><strong>put</strong></a>(self, **kwargs)</dt><dd><tt>Writes this model instance to the datastore.<br> + <br> +If this instance is new, we add an entity to the datastore.<br> +Otherwise, we update this instance, and the key will remain the<br> +same.<br> + <br> +Args:<br> + config: datastore_rpc.Configuration to use for this request.<br> + <br> +Returns:<br> + The key of the instance (either the existing key or a new key).<br> + <br> +Raises:<br> + TransactionFailedError if the data could not be committed.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-save"><strong>save</strong></a> = put(self, **kwargs)</dt><dd><tt>Writes this model instance to the datastore.<br> + <br> +If this instance is new, we add an entity to the datastore.<br> +Otherwise, we update this instance, and the key will remain the<br> +same.<br> + <br> +Args:<br> + config: datastore_rpc.Configuration to use for this request.<br> + <br> +Returns:<br> + The key of the instance (either the existing key or a new key).<br> + <br> +Raises:<br> + TransactionFailedError if the data could not be committed.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-to_xml"><strong>to_xml</strong></a>(self, _entity_class<font color="#909090">=<class 'google.appengine.api.datastore.Entity'></font>)</dt><dd><tt>Generate an XML representation of this model instance.<br> + <br> +atom and gd:namespace properties are converted to XML according to their<br> +respective schemas. For more information, see:<br> + <br> + <a href="http://www.atomenabled.org/developers/syndication/">http://www.atomenabled.org/developers/syndication/</a><br> + <a href="http://code.google.com/apis/gdata/common-elements.html">http://code.google.com/apis/gdata/common-elements.html</a></tt></dd></dl> + +<hr> +Class methods inherited from <a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>:<br> +<dl><dt><a name="CredentialsModel-all"><strong>all</strong></a>(cls, **kwds)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Returns a query over all instances of this model from the datastore.<br> + <br> +Returns:<br> + Query that will retrieve all instances from entity collection.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-entity_type"><strong>entity_type</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Soon to be removed alias for kind.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-fields"><strong>fields</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Soon to be removed alias for properties.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-from_entity"><strong>from_entity</strong></a>(cls, entity)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Converts the entity representation of this model to an instance.<br> + <br> +Converts datastore.Entity instance to an instance of cls.<br> + <br> +Args:<br> + entity: Entity loaded directly from datastore.<br> + <br> +Raises:<br> + KindError when cls is incorrect model for entity.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-get"><strong>get</strong></a>(cls, keys, **kwargs)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Fetch instance from the datastore of a specific <a href="google.appengine.ext.db.html#Model">Model</a> type using key.<br> + <br> +We support Key objects and string keys (we convert them to Key objects<br> +automatically).<br> + <br> +Useful for ensuring that specific instance types are retrieved from the<br> +datastore. It also helps that the source code clearly indicates what<br> +kind of <a href="__builtin__.html#object">object</a> is being retreived. Example:<br> + <br> + story = Story.<a href="#CredentialsModel-get">get</a>(story_key)<br> + <br> +Args:<br> + keys: Key within datastore entity collection to find; or string key;<br> + or list of Keys or string keys.<br> + config: datastore_rpc.Configuration to use for this request.<br> + <br> +Returns:<br> + If a single key was given: a <a href="google.appengine.ext.db.html#Model">Model</a> instance associated with key<br> + for provided class if it exists in the datastore, otherwise<br> + None; if a list of keys was given: a list whose items are either<br> + a <a href="google.appengine.ext.db.html#Model">Model</a> instance or None.<br> + <br> +Raises:<br> + KindError if any of the retreived objects are not instances of the<br> + type associated with call to 'get'.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-get_by_id"><strong>get_by_id</strong></a>(cls, ids, parent<font color="#909090">=None</font>, **kwargs)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Get instance of <a href="google.appengine.ext.db.html#Model">Model</a> class by id.<br> + <br> +Args:<br> + key_names: A single id or a list of ids.<br> + parent: Parent of instances to get. Can be a model or key.<br> + config: datastore_rpc.Configuration to use for this request.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-get_by_key_name"><strong>get_by_key_name</strong></a>(cls, key_names, parent<font color="#909090">=None</font>, **kwargs)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Get instance of <a href="google.appengine.ext.db.html#Model">Model</a> class by its key's name.<br> + <br> +Args:<br> + key_names: A single key-name or a list of key-names.<br> + parent: Parent of instances to get. Can be a model or key.<br> + config: datastore_rpc.Configuration to use for this request.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-get_or_insert"><strong>get_or_insert</strong></a>(cls, key_name, **kwds)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Transactionally retrieve or create an instance of <a href="google.appengine.ext.db.html#Model">Model</a> class.<br> + <br> +This acts much like the Python dictionary setdefault() method, where we<br> +first try to retrieve a <a href="google.appengine.ext.db.html#Model">Model</a> instance with the given key name and parent.<br> +If it's not present, then we create a new instance (using the *kwds<br> +supplied) and insert that with the supplied key name.<br> + <br> +Subsequent calls to this method with the same key_name and parent will<br> +always yield the same entity (though not the same actual <a href="__builtin__.html#object">object</a> instance),<br> +regardless of the *kwds supplied. If the specified entity has somehow<br> +been deleted separately, then the next call will create a new entity and<br> +return it.<br> + <br> +If the 'parent' keyword argument is supplied, it must be a <a href="google.appengine.ext.db.html#Model">Model</a> instance.<br> +It will be used as the parent of the new instance of this <a href="google.appengine.ext.db.html#Model">Model</a> class if<br> +one is created.<br> + <br> +This method is especially useful for having just one unique entity for<br> +a specific identifier. Insertion/retrieval is done transactionally, which<br> +guarantees uniqueness.<br> + <br> +Example usage:<br> + <br> + class WikiTopic(db.<a href="google.appengine.ext.db.html#Model">Model</a>):<br> + creation_date = db.DatetimeProperty(auto_now_add=True)<br> + body = db.TextProperty(required=True)<br> + <br> + # The first time through we'll create the new topic.<br> + wiki_word = 'CommonIdioms'<br> + topic = WikiTopic.<a href="#CredentialsModel-get_or_insert">get_or_insert</a>(wiki_word,<br> + body='This topic is totally new!')<br> + assert topic.<a href="#CredentialsModel-key">key</a>().name() == 'CommonIdioms'<br> + assert topic.body == 'This topic is totally new!'<br> + <br> + # The second time through will just retrieve the entity.<br> + overwrite_topic = WikiTopic.<a href="#CredentialsModel-get_or_insert">get_or_insert</a>(wiki_word,<br> + body='A totally different message!')<br> + assert topic.<a href="#CredentialsModel-key">key</a>().name() == 'CommonIdioms'<br> + assert topic.body == 'This topic is totally new!'<br> + <br> +Args:<br> + key_name: Key name to retrieve or create.<br> + **kwds: Keyword arguments to pass to the constructor of the model class<br> + if an instance for the specified key name does not already exist. If<br> + an instance with the supplied key_name and parent already exists, the<br> + rest of these arguments will be discarded.<br> + <br> +Returns:<br> + Existing instance of <a href="google.appengine.ext.db.html#Model">Model</a> class with the specified key_name and parent<br> + or a new one that has just been created.<br> + <br> +Raises:<br> + TransactionFailedError if the specified <a href="google.appengine.ext.db.html#Model">Model</a> instance could not be<br> + retrieved or created transactionally (due to high contention, etc).</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-gql"><strong>gql</strong></a>(cls, query_string, *args, **kwds)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Returns a query using GQL query string.<br> + <br> +See appengine/ext/gql for more information about GQL.<br> + <br> +Args:<br> + query_string: properly formatted GQL query string with the<br> + 'SELECT * FROM <entity>' part omitted<br> + *args: rest of the positional arguments used to bind numeric references<br> + in the query.<br> + **kwds: dictionary-based arguments (for named parameters).</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-kind"><strong>kind</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Returns the datastore kind we use for this model.<br> + <br> +We just use the name of the model for now, ignoring potential collisions.</tt></dd></dl> + +<dl><dt><a name="CredentialsModel-properties"><strong>properties</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Returns a dictionary of all the properties defined for this model.</tt></dd></dl> + +<hr> +Static methods inherited from <a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>:<br> +<dl><dt><a name="CredentialsModel-__new__"><strong>__new__</strong></a>(*args, **unused_kwds)</dt><dd><tt>Allow subclasses to call <a href="#CredentialsModel-__new__">__new__</a>() with arguments.<br> + <br> +Do NOT list 'cls' as the first argument, or in the case when<br> +the 'unused_kwds' dictionary contains the key 'cls', the function<br> +will complain about multiple argument values for 'cls'.<br> + <br> +Raises:<br> + TypeError if there are no positional arguments.</tt></dd></dl> + +<hr> +Data descriptors inherited from <a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</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> +<hr> +Data and other attributes inherited from <a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>:<br> +<dl><dt><strong>__metaclass__</strong> = <class 'google.appengine.ext.db.PropertiedClass'><dd><tt>Meta-class for initializing <a href="google.appengine.ext.db.html#Model">Model</a> classes properties.<br> + <br> +Used for initializing Properties defined in the context of a model.<br> +By using a meta-class much of the configuration of a <a href="google.appengine.ext.db.html#Property">Property</a><br> +descriptor becomes implicit. By using this meta-class, descriptors<br> +that are of class <a href="google.appengine.ext.db.html#Model">Model</a> are notified about which class they<br> +belong to and what attribute they are associated with and can<br> +do appropriate initialization via __property_config__.<br> + <br> +Duplicate properties are not permitted.</tt></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="CredentialsProperty">class <strong>CredentialsProperty</strong></a>(<a href="google.appengine.ext.db.html#Property">google.appengine.ext.db.Property</a>)</font></td></tr> <tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td> @@ -89,7 +531,7 @@ the arguments to this class and what they&nbs Args:<br> verbose_name: User friendly name of property.<br> name: <a href="oauth2client.client.html#Storage">Storage</a> name for property. By default, uses attribute name<br> - as it is assigned in the Model sub-class.<br> + as it is assigned in the <a href="google.appengine.ext.db.html#Model">Model</a> sub-class.<br> default: Default value for property if none is assigned.<br> required: Whether property is required.<br> validator: User provided method used for validation.<br> @@ -102,8 +544,8 @@ Configure the property so that it knows its&n it belongs to.<br> <br> Args:<br> - model_class: Model class which <a href="google.appengine.ext.db.html#Property">Property</a> will belong to.<br> - property_name: Name of property within Model instance to store property<br> + model_class: <a href="google.appengine.ext.db.html#Model">Model</a> class which <a href="google.appengine.ext.db.html#Property">Property</a> will belong to.<br> + property_name: Name of property within <a href="google.appengine.ext.db.html#Model">Model</a> instance to store property<br> values in. By default this will be the property name preceded by<br> an underscore, but may change for different subclasses.</tt></dd></dl> @@ -129,7 +571,7 @@ Data descriptors inherited from <a href="google.appengine.ext.db.html#Property"> </dl> <hr> Data and other attributes inherited from <a href="google.appengine.ext.db.html#Property">google.appengine.ext.db.Property</a>:<br> -<dl><dt><strong>creation_counter</strong> = 0</dl> +<dl><dt><strong>creation_counter</strong> = 1</dl> </td></tr></table> <p> <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> @@ -174,7 +616,7 @@ the arguments to this class and what they&nbs Args:<br> verbose_name: User friendly name of property.<br> name: <a href="oauth2client.client.html#Storage">Storage</a> name for property. By default, uses attribute name<br> - as it is assigned in the Model sub-class.<br> + as it is assigned in the <a href="google.appengine.ext.db.html#Model">Model</a> sub-class.<br> default: Default value for property if none is assigned.<br> required: Whether property is required.<br> validator: User provided method used for validation.<br> @@ -187,8 +629,8 @@ Configure the property so that it knows its&n it belongs to.<br> <br> Args:<br> - model_class: Model class which <a href="google.appengine.ext.db.html#Property">Property</a> will belong to.<br> - property_name: Name of property within Model instance to store property<br> + model_class: <a href="google.appengine.ext.db.html#Model">Model</a> class which <a href="google.appengine.ext.db.html#Property">Property</a> will belong to.<br> + property_name: Name of property within <a href="google.appengine.ext.db.html#Model">Model</a> instance to store property<br> values in. By default this will be the property name preceded by<br> an underscore, but may change for different subclasses.</tt></dd></dl> @@ -214,8 +656,215 @@ Data descriptors inherited from <a href="google.appengine.ext.db.html#Property"> </dl> <hr> Data and other attributes inherited from <a href="google.appengine.ext.db.html#Property">google.appengine.ext.db.Property</a>:<br> -<dl><dt><strong>creation_counter</strong> = 0</dl> +<dl><dt><strong>creation_counter</strong> = 1</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="OAuth2Decorator">class <strong>OAuth2Decorator</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>Utility for making OAuth 2.0 easier.<br> + <br> +Instantiate and then use with oauth_required or oauth_aware<br> +as decorators on webapp.<a href="google.appengine.ext.webapp.html#RequestHandler">RequestHandler</a> methods.<br> + <br> +Example:<br> + <br> + decorator = <a href="#OAuth2Decorator">OAuth2Decorator</a>(<br> + client_id='837...ent.com',<br> + client_secret='Qh...wwI',<br> + scope='https://www.googleapis.com/auth/buzz',<br> + user_agent='my-sample-app/1.0')<br> + <br> + <br> + class MainHandler(webapp.<a href="google.appengine.ext.webapp.html#RequestHandler">RequestHandler</a>):<br> + <br> + @decorator.oauth_required<br> + def get(self):<br> + http = decorator.<a href="#OAuth2Decorator-http">http</a>()<br> + # http is authorized with the user's Credentials and can be used<br> + # in API calls<br> </tt></td></tr> +<tr><td> </td> +<td width="100%">Methods defined here:<br> +<dl><dt><a name="OAuth2Decorator-__init__"><strong>__init__</strong></a>(self, client_id, client_secret, scope, user_agent, auth_uri<font color="#909090">='https://accounts.google.com/o/oauth2/auth'</font>, token_uri<font color="#909090">='https://accounts.google.com/o/oauth2/token'</font>)</dt><dd><tt>Constructor for <a href="#OAuth2Decorator">OAuth2Decorator</a><br> + <br> +Args:<br> + client_id: string, client identifier.<br> + client_secret: string client secret.<br> + scope: string, scope of the credentials being requested.<br> + user_agent: string, HTTP User-Agent to provide for this application.<br> + auth_uri: string, URI for authorization endpoint. For convenience<br> + defaults to Google's endpoints but any OAuth 2.0 provider can be used.<br> + token_uri: string, URI for token endpoint. For convenience<br> + defaults to Google's endpoints but any OAuth 2.0 provider can be used.</tt></dd></dl> + +<dl><dt><a name="OAuth2Decorator-authorize_url"><strong>authorize_url</strong></a>(self)</dt><dd><tt>Returns the URL to start the OAuth dance.<br> + <br> +Must only be called from with a webapp.<a href="google.appengine.ext.webapp.html#RequestHandler">RequestHandler</a> subclassed method<br> +that had been decorated with either @oauth_required or @oauth_aware.</tt></dd></dl> + +<dl><dt><a name="OAuth2Decorator-has_credentials"><strong>has_credentials</strong></a>(self)</dt><dd><tt>True if for the logged in user there are valid access Credentials.<br> + <br> +Must only be called from with a webapp.<a href="google.appengine.ext.webapp.html#RequestHandler">RequestHandler</a> subclassed method<br> +that had been decorated with either @oauth_required or @oauth_aware.</tt></dd></dl> + +<dl><dt><a name="OAuth2Decorator-http"><strong>http</strong></a>(self)</dt><dd><tt>Returns an authorized http instance.<br> + <br> +Must only be called from within an @oauth_required decorated method, or<br> +from within an @oauth_aware decorated method where <a href="#OAuth2Decorator-has_credentials">has_credentials</a>()<br> +returns True.</tt></dd></dl> + +<dl><dt><a name="OAuth2Decorator-oauth_aware"><strong>oauth_aware</strong></a>(self, method)</dt><dd><tt>Decorator that sets up for OAuth 2.0 dance, but doesn't do it.<br> + <br> +Does all the setup for the OAuth dance, but doesn't initiate it.<br> +This decorator is useful if you want to create a page that knows<br> +whether or not the user has granted access to this application.<br> +From within a method decorated with @oauth_aware the <a href="#OAuth2Decorator-has_credentials">has_credentials</a>()<br> +and <a href="#OAuth2Decorator-authorize_url">authorize_url</a>() methods can be called.<br> + <br> +Args:<br> + method: callable, to be decorated method of a webapp.<a href="google.appengine.ext.webapp.html#RequestHandler">RequestHandler</a><br> + instance.</tt></dd></dl> + +<dl><dt><a name="OAuth2Decorator-oauth_required"><strong>oauth_required</strong></a>(self, method)</dt><dd><tt>Decorator that starts the OAuth 2.0 dance.<br> + <br> +Starts the OAuth dance for the logged in user if they haven't already<br> +granted access for this application.<br> + <br> +Args:<br> + method: callable, to be decorated method of a webapp.<a href="google.appengine.ext.webapp.html#RequestHandler">RequestHandler</a><br> + instance.</tt></dd></dl> + +<hr> +Data descriptors defined here:<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="OAuth2Handler">class <strong>OAuth2Handler</strong></a>(<a href="google.appengine.ext.webapp.html#RequestHandler">google.appengine.ext.webapp.RequestHandler</a>)</font></td></tr> + +<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td> +<td colspan=2><tt>Handler for the redirect_uri of the OAuth 2.0 dance.<br> </tt></td></tr> +<tr><td> </td> +<td width="100%"><dl><dt>Method resolution order:</dt> +<dd><a href="oauth2client.appengine.html#OAuth2Handler">OAuth2Handler</a></dd> +<dd><a href="google.appengine.ext.webapp.html#RequestHandler">google.appengine.ext.webapp.RequestHandler</a></dd> +<dd><a href="__builtin__.html#object">__builtin__.object</a></dd> +</dl> +<hr> +Methods defined here:<br> +<dl><dt><a name="OAuth2Handler-get"><strong>get</strong></a> = check_login(self, *args)</dt></dl> + +<hr> +Methods inherited from <a href="google.appengine.ext.webapp.html#RequestHandler">google.appengine.ext.webapp.RequestHandler</a>:<br> +<dl><dt><a name="OAuth2Handler-delete"><strong>delete</strong></a>(self, *args)</dt><dd><tt>Handler method for DELETE requests.</tt></dd></dl> + +<dl><dt><a name="OAuth2Handler-error"><strong>error</strong></a>(self, code)</dt><dd><tt>Clears the response output stream and sets the given HTTP error code.<br> + <br> +Args:<br> + code: the HTTP status error code (e.g., 501)</tt></dd></dl> + +<dl><dt><a name="OAuth2Handler-handle_exception"><strong>handle_exception</strong></a>(self, exception, debug_mode)</dt><dd><tt>Called if this handler throws an exception during execution.<br> + <br> +The default behavior is to call <a href="#OAuth2Handler-error">error</a>(500) and print a stack trace<br> +if debug_mode is True.<br> + <br> +Args:<br> + exception: the exception that was thrown<br> + debug_mode: True if the web application is running in debug mode</tt></dd></dl> + +<dl><dt><a name="OAuth2Handler-head"><strong>head</strong></a>(self, *args)</dt><dd><tt>Handler method for HEAD requests.</tt></dd></dl> + +<dl><dt><a name="OAuth2Handler-initialize"><strong>initialize</strong></a>(self, request, response)</dt><dd><tt>Initializes this request handler with the given Request and Response.</tt></dd></dl> + +<dl><dt><a name="OAuth2Handler-options"><strong>options</strong></a>(self, *args)</dt><dd><tt>Handler method for OPTIONS requests.</tt></dd></dl> + +<dl><dt><a name="OAuth2Handler-post"><strong>post</strong></a>(self, *args)</dt><dd><tt>Handler method for POST requests.</tt></dd></dl> + +<dl><dt><a name="OAuth2Handler-put"><strong>put</strong></a>(self, *args)</dt><dd><tt>Handler method for PUT requests.</tt></dd></dl> + +<dl><dt><a name="OAuth2Handler-redirect"><strong>redirect</strong></a>(self, uri, permanent<font color="#909090">=False</font>)</dt><dd><tt>Issues an HTTP redirect to the given relative URL.<br> + <br> +Args:<br> + uri: a relative or absolute URI (e.g., '../flowers.html')<br> + permanent: if true, we use a 301 redirect instead of a 302 redirect</tt></dd></dl> + +<dl><dt><a name="OAuth2Handler-trace"><strong>trace</strong></a>(self, *args)</dt><dd><tt>Handler method for TRACE requests.</tt></dd></dl> + +<hr> +Class methods inherited from <a href="google.appengine.ext.webapp.html#RequestHandler">google.appengine.ext.webapp.RequestHandler</a>:<br> +<dl><dt><a name="OAuth2Handler-get_url"><strong>get_url</strong></a>(cls, *args, **kargs)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>Returns the url for the given handler.<br> + <br> +The default implementation uses the patterns passed to the active<br> +WSGIApplication to create a url. However, it is different from Django's<br> +urlresolvers.reverse() in the following ways:<br> + - It does not try to resolve handlers via module loading<br> + - It does not support named arguments<br> + - It performs some post-prosessing on the url to remove some regex<br> + operators.<br> + - It will try to fill in the left-most missing arguments with the args<br> + used in the active request.<br> + <br> +Args:<br> + args: Parameters for the url pattern's groups.<br> + kwargs: Optionally contains 'implicit_args' that can either be a boolean<br> + or a tuple. When it is True, it will use the arguments to the<br> + active request as implicit arguments. When it is False (default),<br> + it will not use any implicit arguments. When it is a tuple, it<br> + will use the tuple as the implicit arguments.<br> + the left-most args if some are missing from args.<br> + <br> +Returns:<br> + The url for this handler/args combination.<br> + <br> +Raises:<br> + NoUrlFoundError: No url pattern for this handler has the same<br> + number of args that were passed in.</tt></dd></dl> +<dl><dt><a name="OAuth2Handler-new_factory"><strong>new_factory</strong></a>(cls, *args, **kwargs)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>Create new request handler factory.<br> + <br> +Use factory method to create reusable request handlers that just<br> +require a few configuration parameters to construct. Also useful<br> +for injecting shared state between multiple request handler<br> +instances without relying on global variables. For example, to<br> +create a set of post handlers that will do simple text transformations<br> +you can write:<br> + <br> + class ChangeTextHandler(webapp.<a href="google.appengine.ext.webapp.html#RequestHandler">RequestHandler</a>):<br> + <br> + def <a href="#OAuth2Handler-__init__">__init__</a>(self, transform):<br> + self.<strong>transform</strong> = transform<br> + <br> + def <a href="#OAuth2Handler-post">post</a>(self):<br> + response_text = transform(<br> + self.<strong>request</strong>.request.body_file.getvalue())<br> + self.<strong>response</strong>.out.write(response_text)<br> + <br> + application = webapp.WSGIApplication(<br> + [('/to_lower', ChangeTextHandler.<a href="#OAuth2Handler-new_factory">new_factory</a>(str.lower)),<br> + ('/to_upper', ChangeTextHandler.<a href="#OAuth2Handler-new_factory">new_factory</a>(str.upper)),<br> + ],<br> + debug=True)<br> + <br> +Text POSTed to /to_lower will be lower cased.<br> +Text POSTed to /to_upper will be upper cased.</tt></dd></dl> + +<hr> +Data descriptors inherited from <a href="google.appengine.ext.webapp.html#RequestHandler">google.appengine.ext.webapp.RequestHandler</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"> @@ -238,12 +887,13 @@ are stored by key_name.<br> </tt></td></tr> </dl> <hr> Methods defined here:<br> -<dl><dt><a name="StorageByKeyName-__init__"><strong>__init__</strong></a>(self, model, key_name, property_name)</dt><dd><tt>Constructor for <a href="oauth2client.client.html#Storage">Storage</a>.<br> +<dl><dt><a name="StorageByKeyName-__init__"><strong>__init__</strong></a>(self, model, key_name, property_name, cache<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="oauth2client.client.html#Storage">Storage</a>.<br> <br> Args:<br> - model: db.Model, model class<br> + model: db.<a href="google.appengine.ext.db.html#Model">Model</a>, model class<br> key_name: string, key name for the entity that has the credentials<br> - property_name: string, name of the property that is an <a href="#CredentialsProperty">CredentialsProperty</a></tt></dd></dl> + property_name: string, name of the property that is a <a href="#CredentialsProperty">CredentialsProperty</a><br> + cache: memcache, a write-through cache to put in front of the datastore</tt></dd></dl> <dl><dt><a name="StorageByKeyName-get"><strong>get</strong></a>(self)</dt><dd><tt>Retrieve Credential from datastore.<br> <br> @@ -265,12 +915,22 @@ Data descriptors inherited from <a href="oauth2client.client.html#Storage">oauth </dl> </td></tr></table></td></tr></table><p> <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> +<tr bgcolor="#eeaa77"> +<td colspan=3 valign=bottom> <br> +<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr> + +<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td> +<td width="100%"><dl><dt><a name="-main"><strong>main</strong></a>()</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>__author__</strong> = 'jcgregorio@google.com (Joe Gregorio)'</td></tr></table><p> +<td width="100%"><strong>OAUTH2CLIENT_NAMESPACE</strong> = 'oauth2client#ns'<br> +<strong>__author__</strong> = 'jcgregorio@google.com (Joe Gregorio)'<br> +<strong>application</strong> = <google.appengine.ext.webapp.WSGIApplication object></td></tr></table><p> <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> <tr bgcolor="#7799ee"> <td colspan=3 valign=bottom> <br> diff --git a/docs/oauth2client.client.html b/docs/oauth2client.client.html index 82c750698..3c83b5632 100644 --- a/docs/oauth2client.client.html +++ b/docs/oauth2client.client.html @@ -195,7 +195,7 @@ Data descriptors inherited from <a href="oauth2client.client.html#Error">Error</ </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="AccessTokenCredentialsError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#AccessTokenCredentialsError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="AccessTokenCredentialsError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#AccessTokenCredentialsError-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -256,7 +256,7 @@ Data descriptors inherited from <a href="oauth2client.client.html#Error">Error</ </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="AccessTokenRefreshError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#AccessTokenRefreshError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="AccessTokenRefreshError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#AccessTokenRefreshError-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -425,7 +425,7 @@ Data descriptors defined here:<br> </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> @@ -502,7 +502,7 @@ Data descriptors inherited from <a href="oauth2client.client.html#Error">Error</ </dl> <hr> Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> -<dl><dt><a name="FlowExchangeError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#FlowExchangeError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> +<dl><dt><a name="FlowExchangeError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#FlowExchangeError-__init__">__init__</a>(...) initializes x; see x.__class__.__doc__ for signature</tt></dd></dl> <hr> Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> diff --git a/docs/oauth2client.django_orm.html b/docs/oauth2client.django_orm.html index cfcd431eb..2b1d7d3c0 100644 --- a/docs/oauth2client.django_orm.html +++ b/docs/oauth2client.django_orm.html @@ -8,7 +8,7 @@ <td valign=bottom> <br> <font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="oauth2client.html"><font color="#ffffff">oauth2client</font></a>.django_orm</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/google-api-python-client/oauth2client/django_orm.py">/home/jcgregorio/projects/google-api-python-client/oauth2client/django_orm.py</a></font></td></tr></table> +><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/jcgregorio/projects/apiclient/oauth2client/django_orm.py">/usr/local/google/home/jcgregorio/projects/apiclient/oauth2client/django_orm.py</a></font></td></tr></table> <p><tt>OAuth 2.0 utilities for Django.<br> <br> Utilities for using OAuth 2.0 in conjunction with<br> @@ -62,13 +62,9 @@ the Django datastore.</tt></p> Methods defined here:<br> <dl><dt><a name="CredentialsField-contribute_to_class"><strong>contribute_to_class</strong></a>(self, cls, name)</dt></dl> -<dl><dt><a name="CredentialsField-db_type"><strong>db_type</strong></a> = inner(*args, **kwargs)</dt></dl> +<dl><dt><a name="CredentialsField-db_type"><strong>db_type</strong></a>(self, connection<font color="#909090">=None</font>)</dt></dl> -<dl><dt><a name="CredentialsField-get_db_prep_lookup"><strong>get_db_prep_lookup</strong></a> = inner(*args, **kwargs)</dt></dl> - -<dl><dt><a name="CredentialsField-get_db_prep_save"><strong>get_db_prep_save</strong></a> = inner(*args, **kwargs)</dt></dl> - -<dl><dt><a name="CredentialsField-get_db_prep_value"><strong>get_db_prep_value</strong></a> = inner(*args, **kwargs)</dt></dl> +<dl><dt><a name="CredentialsField-get_db_prep_value"><strong>get_db_prep_value</strong></a>(self, value)</dt></dl> <dl><dt><a name="CredentialsField-to_python"><strong>to_python</strong></a>(self, value)</dt></dl> @@ -83,14 +79,10 @@ Methods inherited from <a href="django.db.models.fields.html#Field">django.db.mo <dl><dt><a name="CredentialsField-__deepcopy__"><strong>__deepcopy__</strong></a>(self, memodict)</dt></dl> -<dl><dt><a name="CredentialsField-__init__"><strong>__init__</strong></a>(self, verbose_name<font color="#909090">=None</font>, name<font color="#909090">=None</font>, primary_key<font color="#909090">=False</font>, max_length<font color="#909090">=None</font>, unique<font color="#909090">=False</font>, blank<font color="#909090">=False</font>, null<font color="#909090">=False</font>, db_index<font color="#909090">=False</font>, rel<font color="#909090">=None</font>, default<font color="#909090">=<class django.db.models.fields.NOT_PROVIDED></font>, editable<font color="#909090">=True</font>, serialize<font color="#909090">=True</font>, unique_for_date<font color="#909090">=None</font>, unique_for_month<font color="#909090">=None</font>, unique_for_year<font color="#909090">=None</font>, choices<font color="#909090">=None</font>, help_text<font color="#909090">=''</font>, db_column<font color="#909090">=None</font>, db_tablespace<font color="#909090">=None</font>, auto_created<font color="#909090">=False</font>, validators<font color="#909090">=[]</font>, error_messages<font color="#909090">=None</font>)</dt></dl> +<dl><dt><a name="CredentialsField-__init__"><strong>__init__</strong></a>(self, verbose_name<font color="#909090">=None</font>, name<font color="#909090">=None</font>, primary_key<font color="#909090">=False</font>, max_length<font color="#909090">=None</font>, unique<font color="#909090">=False</font>, blank<font color="#909090">=False</font>, null<font color="#909090">=False</font>, db_index<font color="#909090">=False</font>, rel<font color="#909090">=None</font>, default<font color="#909090">=<class django.db.models.fields.NOT_PROVIDED></font>, editable<font color="#909090">=True</font>, serialize<font color="#909090">=True</font>, unique_for_date<font color="#909090">=None</font>, unique_for_month<font color="#909090">=None</font>, unique_for_year<font color="#909090">=None</font>, choices<font color="#909090">=None</font>, help_text<font color="#909090">=''</font>, db_column<font color="#909090">=None</font>, db_tablespace<font color="#909090">=None</font>, auto_created<font color="#909090">=False</font>)</dt></dl> <dl><dt><a name="CredentialsField-bind"><strong>bind</strong></a>(self, fieldmapping, original, bound_field_class)</dt></dl> -<dl><dt><a name="CredentialsField-clean"><strong>clean</strong></a>(self, value, model_instance)</dt><dd><tt>Convert the value's type and run validation. Validation errors from to_python<br> -and validate are propagated. The correct value is returned if no error is<br> -raised.</tt></dd></dl> - <dl><dt><a name="CredentialsField-formfield"><strong>formfield</strong></a>(self, form_class<font color="#909090">=<class 'django.forms.fields.CharField'></font>, **kwargs)</dt><dd><tt>Returns a django.forms.<a href="django.db.models.fields.html#Field">Field</a> instance for this database <a href="django.db.models.fields.html#Field">Field</a>.</tt></dd></dl> <dl><dt><a name="CredentialsField-get_attname"><strong>get_attname</strong></a>(self)</dt></dl> @@ -104,31 +96,26 @@ as SelectField choices for this field.</tt></dd></dl> <dl><dt><a name="CredentialsField-get_choices_default"><strong>get_choices_default</strong></a>(self)</dt></dl> +<dl><dt><a name="CredentialsField-get_db_prep_lookup"><strong>get_db_prep_lookup</strong></a>(self, lookup_type, value)</dt><dd><tt>Returns field's value prepared for database lookup.</tt></dd></dl> + +<dl><dt><a name="CredentialsField-get_db_prep_save"><strong>get_db_prep_save</strong></a>(self, value)</dt><dd><tt>Returns field's value prepared for saving into a database.</tt></dd></dl> + <dl><dt><a name="CredentialsField-get_default"><strong>get_default</strong></a>(self)</dt><dd><tt>Returns the default value for this field.</tt></dd></dl> <dl><dt><a name="CredentialsField-get_flatchoices"><strong>get_flatchoices</strong></a>(self, include_blank<font color="#909090">=True</font>, blank_choice<font color="#909090">=[('', '---------')]</font>)</dt><dd><tt>Returns flattened choices with a default blank choice included.</tt></dd></dl> <dl><dt><a name="CredentialsField-get_internal_type"><strong>get_internal_type</strong></a>(self)</dt></dl> -<dl><dt><a name="CredentialsField-get_prep_lookup"><strong>get_prep_lookup</strong></a>(self, lookup_type, value)</dt><dd><tt>Perform preliminary non-db specific lookup checks and conversions</tt></dd></dl> - -<dl><dt><a name="CredentialsField-get_prep_value"><strong>get_prep_value</strong></a>(self, value)</dt><dd><tt>Perform preliminary non-db specific value checks and conversions.</tt></dd></dl> - <dl><dt><a name="CredentialsField-get_validator_unique_lookup_type"><strong>get_validator_unique_lookup_type</strong></a>(self)</dt></dl> <dl><dt><a name="CredentialsField-has_default"><strong>has_default</strong></a>(self)</dt><dd><tt>Returns a boolean of whether this field has a default value.</tt></dd></dl> <dl><dt><a name="CredentialsField-pre_save"><strong>pre_save</strong></a>(self, model_instance, add)</dt><dd><tt>Returns field's value just before saving.</tt></dd></dl> -<dl><dt><a name="CredentialsField-run_validators"><strong>run_validators</strong></a>(self, value)</dt></dl> - <dl><dt><a name="CredentialsField-save_form_data"><strong>save_form_data</strong></a>(self, instance, data)</dt></dl> <dl><dt><a name="CredentialsField-set_attributes_from_name"><strong>set_attributes_from_name</strong></a>(self, name)</dt></dl> -<dl><dt><a name="CredentialsField-validate"><strong>validate</strong></a>(self, value, model_instance)</dt><dd><tt>Validates value and throws ValidationError. Subclasses should override<br> -this to provide validation logic.</tt></dd></dl> - <dl><dt><a name="CredentialsField-value_from_object"><strong>value_from_object</strong></a>(self, obj)</dt><dd><tt>Returns the value of this field in the given model instance.</tt></dd></dl> <dl><dt><a name="CredentialsField-value_to_string"><strong>value_to_string</strong></a>(self, obj)</dt><dd><tt>Returns a string value of this field from the passed obj.<br> @@ -144,8 +131,6 @@ Data descriptors inherited from <a href="django.db.models.fields.html#Field">dja </dl> <dl><dt><strong>choices</strong></dt> </dl> -<dl><dt><strong>description</strong></dt> -</dl> <dl><dt><strong>flatchoices</strong></dt> <dd><tt>Flattened version of choices tuple.</tt></dd> </dl> @@ -157,10 +142,6 @@ Data and other attributes inherited from <a href="django.db.models.fields.html#F <dl><dt><strong>creation_counter</strong> = 0</dl> -<dl><dt><strong>default_error_messages</strong> = {'blank': <django.utils.functional.__proxy__ object>, 'invalid_choice': <django.utils.functional.__proxy__ object>, 'null': <django.utils.functional.__proxy__ object>}</dl> - -<dl><dt><strong>default_validators</strong> = []</dl> - <dl><dt><strong>empty_strings_allowed</strong> = True</dl> </td></tr></table> <p> @@ -179,13 +160,9 @@ Data and other attributes inherited from <a href="django.db.models.fields.html#F Methods defined here:<br> <dl><dt><a name="FlowField-contribute_to_class"><strong>contribute_to_class</strong></a>(self, cls, name)</dt></dl> -<dl><dt><a name="FlowField-db_type"><strong>db_type</strong></a> = inner(*args, **kwargs)</dt></dl> +<dl><dt><a name="FlowField-db_type"><strong>db_type</strong></a>(self, connection<font color="#909090">=None</font>)</dt></dl> -<dl><dt><a name="FlowField-get_db_prep_lookup"><strong>get_db_prep_lookup</strong></a> = inner(*args, **kwargs)</dt></dl> - -<dl><dt><a name="FlowField-get_db_prep_save"><strong>get_db_prep_save</strong></a> = inner(*args, **kwargs)</dt></dl> - -<dl><dt><a name="FlowField-get_db_prep_value"><strong>get_db_prep_value</strong></a> = inner(*args, **kwargs)</dt></dl> +<dl><dt><a name="FlowField-get_db_prep_value"><strong>get_db_prep_value</strong></a>(self, value)</dt></dl> <dl><dt><a name="FlowField-to_python"><strong>to_python</strong></a>(self, value)</dt></dl> @@ -200,14 +177,10 @@ Methods inherited from <a href="django.db.models.fields.html#Field">django.db.mo <dl><dt><a name="FlowField-__deepcopy__"><strong>__deepcopy__</strong></a>(self, memodict)</dt></dl> -<dl><dt><a name="FlowField-__init__"><strong>__init__</strong></a>(self, verbose_name<font color="#909090">=None</font>, name<font color="#909090">=None</font>, primary_key<font color="#909090">=False</font>, max_length<font color="#909090">=None</font>, unique<font color="#909090">=False</font>, blank<font color="#909090">=False</font>, null<font color="#909090">=False</font>, db_index<font color="#909090">=False</font>, rel<font color="#909090">=None</font>, default<font color="#909090">=<class django.db.models.fields.NOT_PROVIDED></font>, editable<font color="#909090">=True</font>, serialize<font color="#909090">=True</font>, unique_for_date<font color="#909090">=None</font>, unique_for_month<font color="#909090">=None</font>, unique_for_year<font color="#909090">=None</font>, choices<font color="#909090">=None</font>, help_text<font color="#909090">=''</font>, db_column<font color="#909090">=None</font>, db_tablespace<font color="#909090">=None</font>, auto_created<font color="#909090">=False</font>, validators<font color="#909090">=[]</font>, error_messages<font color="#909090">=None</font>)</dt></dl> +<dl><dt><a name="FlowField-__init__"><strong>__init__</strong></a>(self, verbose_name<font color="#909090">=None</font>, name<font color="#909090">=None</font>, primary_key<font color="#909090">=False</font>, max_length<font color="#909090">=None</font>, unique<font color="#909090">=False</font>, blank<font color="#909090">=False</font>, null<font color="#909090">=False</font>, db_index<font color="#909090">=False</font>, rel<font color="#909090">=None</font>, default<font color="#909090">=<class django.db.models.fields.NOT_PROVIDED></font>, editable<font color="#909090">=True</font>, serialize<font color="#909090">=True</font>, unique_for_date<font color="#909090">=None</font>, unique_for_month<font color="#909090">=None</font>, unique_for_year<font color="#909090">=None</font>, choices<font color="#909090">=None</font>, help_text<font color="#909090">=''</font>, db_column<font color="#909090">=None</font>, db_tablespace<font color="#909090">=None</font>, auto_created<font color="#909090">=False</font>)</dt></dl> <dl><dt><a name="FlowField-bind"><strong>bind</strong></a>(self, fieldmapping, original, bound_field_class)</dt></dl> -<dl><dt><a name="FlowField-clean"><strong>clean</strong></a>(self, value, model_instance)</dt><dd><tt>Convert the value's type and run validation. Validation errors from to_python<br> -and validate are propagated. The correct value is returned if no error is<br> -raised.</tt></dd></dl> - <dl><dt><a name="FlowField-formfield"><strong>formfield</strong></a>(self, form_class<font color="#909090">=<class 'django.forms.fields.CharField'></font>, **kwargs)</dt><dd><tt>Returns a django.forms.<a href="django.db.models.fields.html#Field">Field</a> instance for this database <a href="django.db.models.fields.html#Field">Field</a>.</tt></dd></dl> <dl><dt><a name="FlowField-get_attname"><strong>get_attname</strong></a>(self)</dt></dl> @@ -221,31 +194,26 @@ as SelectField choices for this field.</tt></dd></dl> <dl><dt><a name="FlowField-get_choices_default"><strong>get_choices_default</strong></a>(self)</dt></dl> +<dl><dt><a name="FlowField-get_db_prep_lookup"><strong>get_db_prep_lookup</strong></a>(self, lookup_type, value)</dt><dd><tt>Returns field's value prepared for database lookup.</tt></dd></dl> + +<dl><dt><a name="FlowField-get_db_prep_save"><strong>get_db_prep_save</strong></a>(self, value)</dt><dd><tt>Returns field's value prepared for saving into a database.</tt></dd></dl> + <dl><dt><a name="FlowField-get_default"><strong>get_default</strong></a>(self)</dt><dd><tt>Returns the default value for this field.</tt></dd></dl> <dl><dt><a name="FlowField-get_flatchoices"><strong>get_flatchoices</strong></a>(self, include_blank<font color="#909090">=True</font>, blank_choice<font color="#909090">=[('', '---------')]</font>)</dt><dd><tt>Returns flattened choices with a default blank choice included.</tt></dd></dl> <dl><dt><a name="FlowField-get_internal_type"><strong>get_internal_type</strong></a>(self)</dt></dl> -<dl><dt><a name="FlowField-get_prep_lookup"><strong>get_prep_lookup</strong></a>(self, lookup_type, value)</dt><dd><tt>Perform preliminary non-db specific lookup checks and conversions</tt></dd></dl> - -<dl><dt><a name="FlowField-get_prep_value"><strong>get_prep_value</strong></a>(self, value)</dt><dd><tt>Perform preliminary non-db specific value checks and conversions.</tt></dd></dl> - <dl><dt><a name="FlowField-get_validator_unique_lookup_type"><strong>get_validator_unique_lookup_type</strong></a>(self)</dt></dl> <dl><dt><a name="FlowField-has_default"><strong>has_default</strong></a>(self)</dt><dd><tt>Returns a boolean of whether this field has a default value.</tt></dd></dl> <dl><dt><a name="FlowField-pre_save"><strong>pre_save</strong></a>(self, model_instance, add)</dt><dd><tt>Returns field's value just before saving.</tt></dd></dl> -<dl><dt><a name="FlowField-run_validators"><strong>run_validators</strong></a>(self, value)</dt></dl> - <dl><dt><a name="FlowField-save_form_data"><strong>save_form_data</strong></a>(self, instance, data)</dt></dl> <dl><dt><a name="FlowField-set_attributes_from_name"><strong>set_attributes_from_name</strong></a>(self, name)</dt></dl> -<dl><dt><a name="FlowField-validate"><strong>validate</strong></a>(self, value, model_instance)</dt><dd><tt>Validates value and throws ValidationError. Subclasses should override<br> -this to provide validation logic.</tt></dd></dl> - <dl><dt><a name="FlowField-value_from_object"><strong>value_from_object</strong></a>(self, obj)</dt><dd><tt>Returns the value of this field in the given model instance.</tt></dd></dl> <dl><dt><a name="FlowField-value_to_string"><strong>value_to_string</strong></a>(self, obj)</dt><dd><tt>Returns a string value of this field from the passed obj.<br> @@ -261,8 +229,6 @@ Data descriptors inherited from <a href="django.db.models.fields.html#Field">dja </dl> <dl><dt><strong>choices</strong></dt> </dl> -<dl><dt><strong>description</strong></dt> -</dl> <dl><dt><strong>flatchoices</strong></dt> <dd><tt>Flattened version of choices tuple.</tt></dd> </dl> @@ -274,10 +240,6 @@ Data and other attributes inherited from <a href="django.db.models.fields.html#F <dl><dt><strong>creation_counter</strong> = 0</dl> -<dl><dt><strong>default_error_messages</strong> = {'blank': <django.utils.functional.__proxy__ object>, 'invalid_choice': <django.utils.functional.__proxy__ object>, 'null': <django.utils.functional.__proxy__ object>}</dl> - -<dl><dt><strong>default_validators</strong> = []</dl> - <dl><dt><strong>empty_strings_allowed</strong> = True</dl> </td></tr></table> <p> |