[empathy: 5/80] Copy TplActionChain from telepathy-logger

[Emilio Pozuelo Monfort <epm src gnome org>]

commit 7a393000d1dd55dc60345f0b2bb51b44215d9607
Author: Emilio Pozuelo Monfort <emilio pozuelo collabora co uk>
Date:   Wed Apr 20 09:21:49 2011 +0100

    Copy TplActionChain from telepathy-logger

 libempathy/Makefile.am             |    2 +
 libempathy/action-chain-internal.h |   47 ++++++++++
 libempathy/action-chain.c          |  169 ++++++++++++++++++++++++++++++++++++
 3 files changed, 218 insertions(+), 0 deletions(-)
---
diff --git a/libempathy/Makefile.am b/libempathy/Makefile.am
index 4884631..56ea9e7 100644
--- a/libempathy/Makefile.am
+++ b/libempathy/Makefile.am
@@ -28,6 +28,7 @@ BUILT_SOURCES = 					\
 noinst_LTLIBRARIES = libempathy.la
 
 libempathy_headers =				\
+	action-chain-internal.h			\
 	empathy-account-settings.h		\
 	empathy-auth-factory.h			\
 	empathy-channel-factory.h \
@@ -69,6 +70,7 @@ libempathy_headers =				\
 
 libempathy_la_SOURCES =					\
 	$(libempathy_headers)				\
+	action-chain.c					\
 	empathy-account-settings.c			\
 	empathy-auth-factory.c				\
 	empathy-channel-factory.c \
diff --git a/libempathy/action-chain-internal.h b/libempathy/action-chain-internal.h
new file mode 100644
index 0000000..674cc2b
--- /dev/null
+++ b/libempathy/action-chain-internal.h
@@ -0,0 +1,47 @@
+/*
+ * Copyright (C) 2009 Collabora Ltd.
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ *
+ * Authors: Cosimo Alfarano <cosimo alfarano collabora co uk>
+ */
+
+#ifndef __TPL_ACTION_CHAIN_H__
+#define __TPL_ACTION_CHAIN_H__
+
+#include <glib-object.h>
+#include <gio/gio.h>
+
+typedef struct {
+    GQueue *chain;
+    GSimpleAsyncResult *simple;
+} TplActionChain;
+
+TplActionChain *_tpl_action_chain_new_async (GObject *obj,
+    GAsyncReadyCallback cb,
+    gpointer user_data);
+void _tpl_action_chain_free (TplActionChain *self);
+typedef void (*TplPendingAction) (TplActionChain *ctx, gpointer user_data);
+void _tpl_action_chain_append (TplActionChain *self, TplPendingAction func,
+    gpointer user_data);
+void _tpl_action_chain_prepend (TplActionChain *self, TplPendingAction func,
+    gpointer user_data);
+void _tpl_action_chain_continue (TplActionChain *self);
+void _tpl_action_chain_terminate (TplActionChain *self, const GError *error);
+gpointer _tpl_action_chain_get_object (TplActionChain *self);
+gboolean _tpl_action_chain_new_finish (GObject *source,
+    GAsyncResult *result, GError **error);
+
+#endif // __TPL_ACTION_CHAIN_H__
diff --git a/libempathy/action-chain.c b/libempathy/action-chain.c
new file mode 100644
index 0000000..df792e5
--- /dev/null
+++ b/libempathy/action-chain.c
@@ -0,0 +1,169 @@
+/*
+ * Copyright (C) 2009 Collabora Ltd.
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ *
+ * Authors: Cosimo Alfarano <cosimo alfarano collabora co uk>
+ */
+
+#include "config.h"
+#include "action-chain-internal.h"
+
+typedef struct {
+  TplPendingAction action;
+  gpointer user_data;
+} TplActionLink;
+
+
+TplActionChain *
+_tpl_action_chain_new_async (GObject *obj,
+    GAsyncReadyCallback cb,
+    gpointer user_data)
+{
+  TplActionChain *ret = g_slice_new0 (TplActionChain);
+
+  ret->chain = g_queue_new ();
+  ret->simple = g_simple_async_result_new (obj, cb, user_data,
+      _tpl_action_chain_new_async);
+
+  g_object_set_data (G_OBJECT (ret->simple), "chain", ret);
+
+  return ret;
+}
+
+
+static void
+link_free (TplActionLink *l)
+{
+  g_slice_free (TplActionLink, l);
+}
+
+
+void
+_tpl_action_chain_free (TplActionChain *self)
+{
+  g_queue_foreach (self->chain, (GFunc) link_free, NULL);
+  g_queue_free (self->chain);
+  g_object_unref (self->simple);
+  g_slice_free (TplActionChain, self);
+}
+
+
+gpointer // FIXME GObject *
+_tpl_action_chain_get_object (TplActionChain *self)
+{
+  GObject *obj;
+
+  g_return_val_if_fail (self != NULL && self->simple != NULL, NULL);
+
+  obj = g_async_result_get_source_object (G_ASYNC_RESULT (self->simple));
+  g_object_unref (obj); /* don't want the extra ref */
+
+  return obj;
+}
+
+
+void
+_tpl_action_chain_prepend (TplActionChain *self,
+    TplPendingAction func,
+    gpointer user_data)
+{
+  TplActionLink *l;
+
+  l = g_slice_new0 (TplActionLink);
+  l->action = func;
+  l->user_data = user_data;
+
+  g_queue_push_head (self->chain, l);
+}
+
+
+void
+_tpl_action_chain_append (TplActionChain *self,
+    TplPendingAction func,
+    gpointer user_data)
+{
+  TplActionLink *l;
+
+  l = g_slice_new0 (TplActionLink);
+  l->action = func;
+  l->user_data = user_data;
+
+  g_queue_push_tail (self->chain, l);
+}
+
+
+void
+_tpl_action_chain_continue (TplActionChain *self)
+{
+  if (g_queue_is_empty (self->chain))
+    g_simple_async_result_complete (self->simple);
+  else
+    {
+      TplActionLink *l = g_queue_pop_head (self->chain);
+
+      l->action (self, l->user_data);
+      link_free (l);
+    }
+}
+
+
+void
+_tpl_action_chain_terminate (TplActionChain *self,
+    const GError *error)
+{
+  GSimpleAsyncResult *simple = self->simple;
+
+  g_assert (error != NULL);
+
+  g_simple_async_result_set_from_error (simple, error);
+  g_simple_async_result_complete (simple);
+}
+
+
+/**
+ * _tpl_action_chain_new_finish:
+ * @source: the #GObject pass to _tpl_action_chain_new_async()
+ * @result: the #GAsyncResult pass in callback
+ * @error: a pointer to a #GError that will be set on error, or NULL to ignore
+ *
+ * Get the result from running the action chain (%TRUE if the chain completed
+ * successfully, %FALSE with @error set if it was terminated).
+ *
+ * This function also frees the chain.
+ *
+ * Returns: %TRUE on success, %FALSE with @error set on error.
+ */
+gboolean
+_tpl_action_chain_new_finish (GObject *source,
+    GAsyncResult *result,
+    GError **error)
+{
+  TplActionChain *chain;
+
+  g_return_val_if_fail (g_simple_async_result_is_valid (result, source,
+        _tpl_action_chain_new_async), FALSE);
+
+  chain = g_object_get_data (G_OBJECT (result), "chain");
+
+  g_return_val_if_fail (chain != NULL, FALSE);
+
+  if (g_simple_async_result_propagate_error (G_SIMPLE_ASYNC_RESULT (result),
+        error))
+    return FALSE;
+
+  _tpl_action_chain_free (chain);
+  return TRUE;
+}