[evolution-data-server] Add OAuth2Support D-Bus interface.

[Matthew Barnes <mbarnes src gnome org>]

commit 841f8d77ef4428c9ff2109bc705bf0a51a3a518e
Author: Matthew Barnes <mbarnes redhat com>
Date:   Fri Dec 28 08:37:39 2012 -0500

    Add OAuth2Support D-Bus interface.
    
    Backends will be able to obtain OAuth 2.0 access tokens through this
    interface instead of talking directly to an "online accounts" service.

 docs/reference/private/libedbus-private-docs.sgml  |    2 +
 .../private/libedbus-private-sections.txt          |   52 ++++++++++++++++++++
 docs/reference/private/libedbus-private.types      |    3 +
 private/Makefile.am                                |    1 +
 private/org.gnome.evolution.dataserver.Source.xml  |   25 +++++++++
 5 files changed, 83 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/private/libedbus-private-docs.sgml b/docs/reference/private/libedbus-private-docs.sgml
index ce338ba..a08b865 100644
--- a/docs/reference/private/libedbus-private-docs.sgml
+++ b/docs/reference/private/libedbus-private-docs.sgml
@@ -16,6 +16,7 @@
     <xi:include href="xml/e-dbus-source-writable.xml"/>
     <xi:include href="xml/e-dbus-source-remote-creatable.xml"/>
     <xi:include href="xml/e-dbus-source-remote-deletable.xml"/>
+    <xi:include href="xml/e-dbus-source-oauth2-support.xml"/>
     <xi:include href="xml/e-dbus-source-manager.xml"/>
     <xi:include href="xml/e-dbus-object-manager-client.xml"/>
     <xi:include href="xml/e-dbus-authenticator.xml"/>
@@ -29,6 +30,7 @@
     <xi:include href="../../../private/e-dbus-source-org.gnome.evolution.dataserver.Source.Writable.xml"/>
     <xi:include href="../../../private/e-dbus-source-org.gnome.evolution.dataserver.Source.RemoteCreatable.xml"/>
     <xi:include href="../../../private/e-dbus-source-org.gnome.evolution.dataserver.Source.RemoteDeletable.xml"/>
+    <xi:include href="../../../private/e-dbus-source-org.gnome.evolution.dataserver.Source.OAuth2Support.xml"/>
     <xi:include href="../../../private/e-dbus-source-manager-org.gnome.evolution.dataserver.SourceManager.xml"/>
     <xi:include href="../../../private/e-dbus-authenticator-org.gnome.evolution.dataserver.Authenticator.xml"/>
     <xi:include href="../../../private/e-dbus-user-prompter-org.gnome.evolution.dataserver.UserPrompter.xml"/>
diff --git a/docs/reference/private/libedbus-private-sections.txt b/docs/reference/private/libedbus-private-sections.txt
index 891b79f..fdae9fd 100644
--- a/docs/reference/private/libedbus-private-sections.txt
+++ b/docs/reference/private/libedbus-private-sections.txt
@@ -75,6 +75,8 @@ e_dbus_object_get_source_remote_creatable
 e_dbus_object_peek_source_remote_creatable
 e_dbus_object_get_source_remote_deletable
 e_dbus_object_peek_source_remote_deletable
+e_dbus_object_get_source_oauth2_support
+e_dbus_object_peek_source_oauth2_support
 <SUBSECTION Proxy>
 EDBusObjectProxy
 e_dbus_object_proxy_new
@@ -86,6 +88,7 @@ e_dbus_object_skeleton_set_source_writable
 e_dbus_object_skeleton_set_source_removable
 e_dbus_object_skeleton_set_source_remote_creatable
 e_dbus_object_skeleton_set_source_remote_deletable
+e_dbus_object_skeleton_set_source_oauth2_support
 <SUBSECTION Standard>
 E_DBUS_OBJECT
 E_DBUS_IS_OBJECT
@@ -256,6 +259,55 @@ EDBusSourceManagerSkeletonPrivate
 </SECTION>
 
 <SECTION>
+<FILE>e-dbus-source-oauth2-support</FILE>
+<TITLE>EDBusSourceOAuth2Support</TITLE>
+EDBusSourceOAuth2Support
+e_dbus_source_oauth2_support_call_get_access_token_sync
+e_dbus_source_oauth2_support_call_get_access_token
+e_dbus_source_oauth2_support_call_get_access_token_finish
+e_dbus_source_oauth2_support_complete_get_access_token
+e_dbus_source_oauth2_support_interface_info
+e_dbus_source_oauth2_support_override_properties
+<SUBSECTION Proxy>
+EDBusSourceOAuth2SupportProxy
+e_dbus_source_oauth2_support_proxy_new_sync
+e_dbus_source_oauth2_support_proxy_new
+e_dbus_source_oauth2_support_proxy_new_finish
+e_dbus_source_oauth2_support_proxy_new_for_bus_sync
+e_dbus_source_oauth2_support_proxy_new_for_bus
+e_dbus_source_oauth2_support_proxy_new_for_bus_finish
+<SUBSECTION Skeleton>
+EDBusSourceOAuth2SupportSkeleton
+e_dbus_source_oauth2_support_skeleton_new
+<SUBSECTION Standard>
+E_DBUS_SOURCE_OAUTH2_SUPPORT
+E_DBUS_IS_SOURCE_OAUTH2_SUPPORT
+E_DBUS_TYPE_SOURCE_OAUTH2_SUPPORT
+E_DBUS_SOURCE_OAUTH2_SUPPORT_GET_IFACE
+E_DBUS_SOURCE_OAUTH2_SUPPORT_PROXY
+E_DBUS_IS_SOURCE_OAUTH2_SUPPORT_PROXY
+E_DBUS_TYPE_SOURCE_OAUTH2_SUPPORT_PROXY
+E_DBUS_SOURCE_OAUTH2_SUPPORT_PROXY_CLASS
+E_DBUS_IS_SOURCE_OAUTH2_SUPPORT_PROXY_CLASS
+E_DBUS_SOURCE_OAUTH2_SUPPORT_PROXY_GET_CLASS
+E_DBUS_SOURCE_OAUTH2_SUPPORT_SKELETON
+E_DBUS_IS_SOURCE_OAUTH2_SUPPORT_SKELETON
+E_DBUS_TYPE_SOURCE_OAUTH2_SUPPORT_SKELETON
+E_DBUS_SOURCE_OAUTH2_SUPPORT_SKELETON_CLASS
+E_DBUS_IS_SOURCE_OAUTH2_SUPPORT_SKELETON_CLASS
+E_DBUS_SOURCE_OAUTH2_SUPPORT_SKELETON_GET_CLASS
+EDBusSourceOAuth2SupportIface
+EDBusSourceOAuth2SupportProxyClass
+EDBusSourceOAuth2SupportSkeletonClass
+e_dbus_source_oauth2_support_get_type
+e_dbus_source_oauth2_support_proxy_get_type
+e_dbus_source_oauth2_support_skeleton_get_type
+<SUBSECTION Private>
+EDBusSourceOAuth2SupportProxyPrivate
+EDBusSourceOAuth2SupportSkeletonPrivate
+</SECTION>
+
+<SECTION>
 <FILE>e-dbus-source-remote-creatable</FILE>
 <TITLE>EDBusSourceRemoteCreatable</TITLE>
 EDBusSourceRemoteCreatable
diff --git a/docs/reference/private/libedbus-private.types b/docs/reference/private/libedbus-private.types
index 3896388..5d69a16 100644
--- a/docs/reference/private/libedbus-private.types
+++ b/docs/reference/private/libedbus-private.types
@@ -25,6 +25,9 @@ e_dbus_source_remote_creatable_skeleton_get_type
 e_dbus_source_remote_deletable_get_type
 e_dbus_source_remote_deletable_proxy_get_type
 e_dbus_source_remote_deletable_skeleton_get_type
+e_dbus_source_oauth2_support_get_type
+e_dbus_source_oauth2_support_proxy_get_type
+e_dbus_source_oauth2_support_skeleton_get_type
 e_dbus_authenticator_get_type
 e_dbus_authenticator_proxy_get_type
 e_dbus_authenticator_skeleton_get_type
diff --git a/private/Makefile.am b/private/Makefile.am
index 502fccb..a753ca1 100644
--- a/private/Makefile.am
+++ b/private/Makefile.am
@@ -45,6 +45,7 @@ GENERATED_DBUS_SOURCE = \
 	e-dbus-source-org.gnome.evolution.dataserver.Source.Writable.xml \
 	e-dbus-source-org.gnome.evolution.dataserver.Source.RemoteCreatable.xml \
 	e-dbus-source-org.gnome.evolution.dataserver.Source.RemoteDeletable.xml \
+	e-dbus-source-org.gnome.evolution.dataserver.Source.OAuth2Support.xml \
 	$(NULL)
 
 GENERATED_DBUS_SOURCE_MANAGER = \
diff --git a/private/org.gnome.evolution.dataserver.Source.xml b/private/org.gnome.evolution.dataserver.Source.xml
index 567a0e7..dc3f0f5 100644
--- a/private/org.gnome.evolution.dataserver.Source.xml
+++ b/private/org.gnome.evolution.dataserver.Source.xml
@@ -95,3 +95,28 @@
   <method name="Delete"/>
 </interface>
 
+<!--
+    org.gnome.evolution.dataserver.Source.OAuth2Support:
+    @short_description: Supports OAuth 2.0 authentication
+
+    This interface is used by data sources that support
+    <ulink url="http://oauth.net/2/";>OAuth 2.0</ulink> authentication,
+    usually backed by a desktop-wide authentication service such as
+    <ulink url="http://live.gnome.org/GnomeOnlineAccounts";>GNOME Online
+    Accounts</ulink>.
+-->
+<interface name="org.gnome.evolution.dataserver.Source.OAuth2Support">
+  <!--
+      GetAccessToken:
+      @access_token: The access token
+      @expires_in: The duration in seconds that the returned token is
+                   valid for, or 0 if unknown
+
+      Obtains an access token that can be used to access OAuth2-based
+      services for the data source.
+  -->
+  <method name="GetAccessToken">
+    <arg name="access_token" type="s" direction="out"/>
+    <arg name="expires_in" type="i" direction="out"/>
+  </method>
+</interface>