path: root/modules/calendar/e-task-shell-sidebar.c

/*
 * e-task-shell-sidebar.c
 *
 * This program 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 of the License, or (at your option) version 3.
 *
 * This program 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 the program; if not, see <http://www.gnu.org/licenses/>
 *
 *
 * Copyright (C) 1999-2008 Novell, Inc. (www.novell.com)
 *
 */

#ifdef HAVE_CONFIG_H
#include <config.h>
#endif

#include "e-task-shell-sidebar.h"

#include <string.h>
#include <glib/gi18n.h>

#include "e-util/e-util.h"
#include "calendar/gui/e-task-list-selector.h"
#include "calendar/gui/misc.h"

#define E_TASK_SHELL_SIDEBAR_GET_PRIVATE(obj) \
    (G_TYPE_INSTANCE_GET_PRIVATE \
    ((obj), E_TYPE_TASK_SHELL_SIDEBAR, ETaskShellSidebarPrivate))

typedef struct _ConnectClosure ConnectClosure;

struct _ETaskShellSidebarPrivate {
    GtkWidget *selector;

    /* The default client is for ECalModel.  It follows the
     * sidebar's primary selection, even if the highlighted
     * source is not selected.  The tricky part is we don't
     * update the property until the client is successfully
     * opened.  So the user first highlights a source, then
     * sometime later we update our default-client property
     * which is bound by an EBinding to ECalModel. */
    EClient *default_client;

    /* Not referenced, only for pointer comparison. */
    ESource *connecting_default_source_instance;

    EActivity *connecting_default_client;
};

struct _ConnectClosure {
    ETaskShellSidebar *task_shell_sidebar;
    EActivity *activity;

    /* For error messages. */
    gchar *unique_display_name;
};

enum {
    PROP_0,
    PROP_DEFAULT_CLIENT,
    PROP_SELECTOR
};

enum {
    CLIENT_ADDED,
    CLIENT_REMOVED,
    LAST_SIGNAL
};

static guint signals[LAST_SIGNAL];

G_DEFINE_DYNAMIC_TYPE (
    ETaskShellSidebar,
    e_task_shell_sidebar,
    E_TYPE_SHELL_SIDEBAR)

static ConnectClosure *
connect_closure_new (ETaskShellSidebar *task_shell_sidebar,
                     ESource *source)
{
    ConnectClosure *closure;
    EAlertSink *alert_sink;
    GCancellable *cancellable;
    ESourceRegistry *registry;
    ESourceSelector *selector;
    EShellView *shell_view;
    EShellBackend *shell_backend;
    EShellContent *shell_content;
    EShellSidebar *shell_sidebar;
    gchar *text;

    shell_sidebar = E_SHELL_SIDEBAR (task_shell_sidebar);
    shell_view = e_shell_sidebar_get_shell_view (shell_sidebar);
    shell_backend = e_shell_view_get_shell_backend (shell_view);
    shell_content = e_shell_view_get_shell_content (shell_view);

    selector = e_task_shell_sidebar_get_selector (task_shell_sidebar);
    registry = e_source_selector_get_registry (selector);

    closure = g_slice_new0 (ConnectClosure);
    closure->task_shell_sidebar = g_object_ref (task_shell_sidebar);
    closure->activity = e_activity_new ();
    closure->unique_display_name =
        e_source_registry_dup_unique_display_name (
        registry, source, E_SOURCE_EXTENSION_TASK_LIST);

    text = g_strdup_printf (
        _("Opening task list '%s'"),
        closure->unique_display_name);
    e_activity_set_text (closure->activity, text);
    g_free (text);

    alert_sink = E_ALERT_SINK (shell_content);
    e_activity_set_alert_sink (closure->activity, alert_sink);

    cancellable = g_cancellable_new ();
    e_activity_set_cancellable (closure->activity, cancellable);
    g_object_unref (cancellable);

    e_shell_backend_add_activity (shell_backend, closure->activity);

    return closure;
}

static void
connect_closure_free (ConnectClosure *closure)
{
    g_clear_object (&closure->task_shell_sidebar);
    g_clear_object (&closure->activity);

    g_free (closure->unique_display_name);

    g_slice_free (ConnectClosure, closure);
}

static gboolean
task_shell_sidebar_map_uid_to_source (GValue *value,
                                      GVariant *variant,
                                      gpointer user_data)
{
    ESourceRegistry *registry;
    ESource *source;
    const gchar *uid;

    registry = E_SOURCE_REGISTRY (user_data);
    uid = g_variant_get_string (variant, NULL);
    if (uid != NULL && *uid != '\0')
        source = e_source_registry_ref_source (registry, uid);
    else
        source = e_source_registry_ref_default_task_list (registry);
    g_value_take_object (value, source);

    return (source != NULL);
}

static GVariant *
task_shell_sidebar_map_source_to_uid (const GValue *value,
                                      const GVariantType *expected_type,
                                      gpointer user_data)
{
    GVariant *variant = NULL;
    ESource *source;

    source = g_value_get_object (value);

    if (source != NULL) {
        const gchar *uid;

        uid = e_source_get_uid (source);
        variant = g_variant_new_string (uid);
    }

    return variant;
}

static void
task_shell_sidebar_emit_client_added (ETaskShellSidebar *task_shell_sidebar,
                                      EClient *client)
{
    guint signal_id = signals[CLIENT_ADDED];

    g_signal_emit (task_shell_sidebar, signal_id, 0, client);
}

static void
task_shell_sidebar_emit_client_removed (ETaskShellSidebar *task_shell_sidebar,
                                        EClient *client)
{
    guint signal_id = signals[CLIENT_REMOVED];

    g_signal_emit (task_shell_sidebar, signal_id, 0, client);
}

static void
task_shell_sidebar_handle_connect_error (EActivity *activity,
                                         const gchar *unique_display_name,
                                         const GError *error)
{
    EAlertSink *alert_sink;
    gboolean offline_error;

    alert_sink = e_activity_get_alert_sink (activity);

    offline_error = g_error_matches (
        error, E_CLIENT_ERROR, E_CLIENT_ERROR_REPOSITORY_OFFLINE);

    if (e_activity_handle_cancellation (activity, error)) {
        /* do nothing */
    } else if (offline_error) {
        e_alert_submit (
            alert_sink,
            "calendar:prompt-no-contents-offline-tasks",
            unique_display_name,
            NULL);
    } else {
        e_alert_submit (
            alert_sink,
            "calendar:failed-open-tasks",
            unique_display_name,
            error->message,
            NULL);
    }
}

static void
task_shell_sidebar_client_connect_cb (GObject *source_object,
                                      GAsyncResult *result,
                                      gpointer user_data)
{
    EClient *client;
    ConnectClosure *closure = user_data;
    GError *error = NULL;

    client = e_client_selector_get_client_finish (
        E_CLIENT_SELECTOR (source_object), result, &error);

    /* Sanity check. */
    g_return_if_fail (
        ((client != NULL) && (error == NULL)) ||
        ((client == NULL) && (error != NULL)));

    if (error != NULL) {
        task_shell_sidebar_handle_connect_error (
            closure->activity,
            closure->unique_display_name,
            error);
        g_error_free (error);
        goto exit;
    }

    e_activity_set_state (closure->activity, E_ACTIVITY_COMPLETED);

    e_task_shell_sidebar_add_client (closure->task_shell_sidebar, client);

    g_object_unref (client);

exit:
    connect_closure_free (closure);
}

static void
task_shell_sidebar_default_connect_cb (GObject *source_object,
                                       GAsyncResult *result,
                                       gpointer user_data)
{
    EClient *client;
    ESource *source;
    ConnectClosure *closure = user_data;
    ETaskShellSidebarPrivate *priv;
    GError *error = NULL;

    priv = E_TASK_SHELL_SIDEBAR_GET_PRIVATE (closure->task_shell_sidebar);

    client = e_client_selector_get_client_finish (
        E_CLIENT_SELECTOR (source_object), result, &error);

    /* Sanity check. */
    g_return_if_fail (
        ((client != NULL) && (error == NULL)) ||
        ((client == NULL) && (error != NULL)));

    g_clear_object (&priv->connecting_default_client);

    if (error != NULL) {
        task_shell_sidebar_handle_connect_error (
            closure->activity,
            closure->unique_display_name,
            error);
        g_error_free (error);
        goto exit;
    }

    e_activity_set_state (closure->activity, E_ACTIVITY_COMPLETED);

    source = e_client_get_source (client);

    if (source == priv->connecting_default_source_instance)
        priv->connecting_default_source_instance = NULL;

    if (priv->default_client != NULL)
        g_object_unref (priv->default_client);

    priv->default_client = g_object_ref (client);

    g_object_notify (
        G_OBJECT (closure->task_shell_sidebar), "default-client");

    g_object_unref (client);

exit:
    connect_closure_free (closure);
}

static void
task_shell_sidebar_set_default (ETaskShellSidebar *task_shell_sidebar,
                                ESource *source)
{
    ETaskShellSidebarPrivate *priv;
    ESourceSelector *selector;
    ConnectClosure *closure;

    priv = task_shell_sidebar->priv;

    selector = e_task_shell_sidebar_get_selector (task_shell_sidebar);

    /* already loading that source as default source */
    if (source == priv->connecting_default_source_instance)
        return;

    /* Cancel the previous request if unfinished. */
    if (priv->connecting_default_client != NULL) {
        e_activity_cancel (priv->connecting_default_client);
        g_object_unref (priv->connecting_default_client);
        priv->connecting_default_client = NULL;
    }

    closure = connect_closure_new (task_shell_sidebar, source);

    /* it's only for pointer comparison, no need to ref it */
    priv->connecting_default_source_instance = source;
    priv->connecting_default_client = g_object_ref (closure->activity);

    e_client_selector_get_client (
        E_CLIENT_SELECTOR (selector), source,
        e_activity_get_cancellable (closure->activity),
        task_shell_sidebar_default_connect_cb, closure);
}

static void
task_shell_sidebar_row_changed_cb (ETaskShellSidebar *task_shell_sidebar,
                                   GtkTreePath *tree_path,
                                   GtkTreeIter *tree_iter,
                                   GtkTreeModel *tree_model)
{
    ESourceSelector *selector;
    ESource *source;

    selector = e_task_shell_sidebar_get_selector (task_shell_sidebar);
    source = e_source_selector_ref_source_by_path (selector, tree_path);

    /* XXX This signal gets emitted a lot while the model is being
     *     rebuilt, during which time we won't get a valid ESource.
     *     ESourceSelector should probably block this signal while
     *     rebuilding the model, but we'll be forgiving and not
     *     emit a warning. */
    if (source == NULL)
        return;

    if (e_source_selector_source_is_selected (selector, source))
        e_task_shell_sidebar_add_source (task_shell_sidebar, source);
    else
        e_task_shell_sidebar_remove_source (task_shell_sidebar, source);

    g_object_unref (source);
}

static void
task_shell_sidebar_primary_selection_changed_cb (ETaskShellSidebar *task_shell_sidebar,
                                                 ESourceSelector *selector)
{
    ESource *source;

    source = e_source_selector_ref_primary_selection (selector);
    if (source == NULL)
        return;

    task_shell_sidebar_set_default (task_shell_sidebar, source);

    g_object_unref (source);
}

static void
task_shell_sidebar_restore_state_cb (EShellWindow *shell_window,
                                     EShellView *shell_view,
                                     EShellSidebar *shell_sidebar)
{
    ETaskShellSidebarPrivate *priv;
    ESourceRegistry *registry;
    ESourceSelector *selector;
    GSettings *settings;
    GtkTreeModel *model;

    priv = E_TASK_SHELL_SIDEBAR_GET_PRIVATE (shell_sidebar);

    selector = E_SOURCE_SELECTOR (priv->selector);
    registry = e_source_selector_get_registry (selector);
    model = gtk_tree_view_get_model (GTK_TREE_VIEW (selector));

    g_signal_connect_swapped (
        registry, "source-removed",
        G_CALLBACK (e_task_shell_sidebar_remove_source), shell_sidebar);

    g_signal_connect_swapped (
        model, "row-changed",
        G_CALLBACK (task_shell_sidebar_row_changed_cb),
        shell_sidebar);

    g_signal_connect_swapped (
        selector, "primary-selection-changed",
        G_CALLBACK (task_shell_sidebar_primary_selection_changed_cb),
        shell_sidebar);

    /* This will trigger our "row-changed" signal handler for each
     * task list source, so the appropriate ECalClients get added to
     * the ECalModel, which will then create view objects to display
     * the task list content.  This all happens asynchronously. */
    e_source_selector_update_all_rows (selector);

    /* Bind GObject properties to settings keys. */

    settings = g_settings_new ("org.gnome.evolution.calendar");

    g_settings_bind_with_mapping (
        settings, "primary-tasks",
        selector, "primary-selection",
        G_SETTINGS_BIND_DEFAULT,
        task_shell_sidebar_map_uid_to_source,
        task_shell_sidebar_map_source_to_uid,
        g_object_ref (registry),
        (GDestroyNotify) g_object_unref);

    g_object_unref (settings);
}

static void
task_shell_sidebar_get_property (GObject *object,
                                 guint property_id,
                                 GValue *value,
                                 GParamSpec *pspec)
{
    switch (property_id) {
        case PROP_DEFAULT_CLIENT:
            g_value_set_object (
                value,
                e_task_shell_sidebar_get_default_client (
                E_TASK_SHELL_SIDEBAR (object)));
            return;

        case PROP_SELECTOR:
            g_value_set_object (
                value,
                e_task_shell_sidebar_get_selector (
                E_TASK_SHELL_SIDEBAR (object)));
            return;
    }

    G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
}

static void
task_shell_sidebar_dispose (GObject *object)
{
    ETaskShellSidebarPrivate *priv;

    priv = E_TASK_SHELL_SIDEBAR_GET_PRIVATE (object);

    if (priv->selector != NULL) {
        g_object_unref (priv->selector);
        priv->selector = NULL;
    }

    if (priv->default_client != NULL) {
        g_object_unref (priv->default_client);
        priv->default_client = NULL;
    }

    if (priv->connecting_default_client != NULL) {
        e_activity_cancel (priv->connecting_default_client);
        g_object_unref (priv->connecting_default_client);
        priv->connecting_default_client = NULL;
    }

    /* Chain up to parent's dispose() method. */
    G_OBJECT_CLASS (e_task_shell_sidebar_parent_class)->dispose (object);
}

static void
task_shell_sidebar_constructed (GObject *object)
{
    ETaskShellSidebarPrivate *priv;
    EShell *shell;
    EShellView *shell_view;
    EShellWindow *shell_window;
    EShellSidebar *shell_sidebar;
    EClientCache *client_cache;
    GtkContainer *container;
    GtkWidget *widget;
    AtkObject *a11y;

    priv = E_TASK_SHELL_SIDEBAR_GET_PRIVATE (object);

    /* Chain up to parent's constructed() method. */
    G_OBJECT_CLASS (e_task_shell_sidebar_parent_class)->constructed (object);

    shell_sidebar = E_SHELL_SIDEBAR (object);
    shell_view = e_shell_sidebar_get_shell_view (shell_sidebar);
    shell_window = e_shell_view_get_shell_window (shell_view);
    shell = e_shell_window_get_shell (shell_window);

    container = GTK_CONTAINER (shell_sidebar);

    widget = gtk_scrolled_window_new (NULL, NULL);
    gtk_scrolled_window_set_policy (
        GTK_SCROLLED_WINDOW (widget),
        GTK_POLICY_AUTOMATIC, GTK_POLICY_AUTOMATIC);
    gtk_scrolled_window_set_shadow_type (
        GTK_SCROLLED_WINDOW (widget), GTK_SHADOW_IN);
    gtk_container_add (container, widget);
    gtk_widget_show (widget);

    container = GTK_CONTAINER (widget);

    client_cache = e_shell_get_client_cache (shell);
    widget = e_task_list_selector_new (client_cache, shell_view);
    gtk_container_add (container, widget);
    a11y = gtk_widget_get_accessible (widget);
    atk_object_set_name (a11y, _("Task List Selector"));
    priv->selector = g_object_ref (widget);
    gtk_widget_show (widget);

    /* Restore widget state from the last session once
     * the shell view is fully initialized and visible. */
    g_signal_connect (
        shell_window, "shell-view-created::tasks",
        G_CALLBACK (task_shell_sidebar_restore_state_cb),
        shell_sidebar);
}

static guint32
task_shell_sidebar_check_state (EShellSidebar *shell_sidebar)
{
    ETaskShellSidebar *task_shell_sidebar;
    ESourceSelector *selector;
    ESourceRegistry *registry;
    ESource *source;
    gboolean is_writable = FALSE;
    gboolean is_removable = FALSE;
    gboolean is_remote_creatable = FALSE;
    gboolean is_remote_deletable = FALSE;
    gboolean in_collection = FALSE;
    gboolean refresh_supported = FALSE;
    gboolean has_primary_source = FALSE;
    guint32 state = 0;

    task_shell_sidebar = E_TASK_SHELL_SIDEBAR (shell_sidebar);
    selector = e_task_shell_sidebar_get_selector (task_shell_sidebar);
    source = e_source_selector_ref_primary_selection (selector);
    registry = e_source_selector_get_registry (selector);

    if (source != NULL) {
        EClient *client;
        ESource *collection;

        has_primary_source = TRUE;
        is_writable = e_source_get_writable (source);
        is_removable = e_source_get_removable (source);
        is_remote_creatable = e_source_get_remote_creatable (source);
        is_remote_deletable = e_source_get_remote_deletable (source);

        collection = e_source_registry_find_extension (
            registry, source, E_SOURCE_EXTENSION_COLLECTION);
        if (collection != NULL) {
            in_collection = TRUE;
            g_object_unref (collection);
        }

        client = e_client_selector_ref_cached_client (
            E_CLIENT_SELECTOR (selector), source);

        if (client != NULL) {
            refresh_supported =
                e_client_check_refresh_supported (client);
            g_object_unref (client);
        }

        g_object_unref (source);
    }

    if (has_primary_source)
        state |= E_TASK_SHELL_SIDEBAR_HAS_PRIMARY_SOURCE;
    if (is_writable)
        state |= E_TASK_SHELL_SIDEBAR_PRIMARY_SOURCE_IS_WRITABLE;
    if (is_removable)
        state |= E_TASK_SHELL_SIDEBAR_PRIMARY_SOURCE_IS_REMOVABLE;
    if (is_remote_creatable)
        state |= E_TASK_SHELL_SIDEBAR_PRIMARY_SOURCE_IS_REMOTE_CREATABLE;
    if (is_remote_deletable)
        state |= E_TASK_SHELL_SIDEBAR_PRIMARY_SOURCE_IS_REMOTE_DELETABLE;
    if (in_collection)
        state |= E_TASK_SHELL_SIDEBAR_PRIMARY_SOURCE_IN_COLLECTION;
    if (refresh_supported)
        state |= E_TASK_SHELL_SIDEBAR_SOURCE_SUPPORTS_REFRESH;

    return state;
}

static void
task_shell_sidebar_client_removed (ETaskShellSidebar *task_shell_sidebar,
                                   ECalClient *client)
{
    ESourceSelector *selector;
    ESource *source;

    source = e_client_get_source (E_CLIENT (client));

    selector = e_task_shell_sidebar_get_selector (task_shell_sidebar);
    e_source_selector_unselect_source (selector, source);
}

static void
e_task_shell_sidebar_class_init (ETaskShellSidebarClass *class)
{
    GObjectClass *object_class;
    EShellSidebarClass *shell_sidebar_class;

    g_type_class_add_private (class, sizeof (ETaskShellSidebarPrivate));

    object_class = G_OBJECT_CLASS (class);
    object_class->get_property = task_shell_sidebar_get_property;
    object_class->dispose = task_shell_sidebar_dispose;
    object_class->constructed = task_shell_sidebar_constructed;

    shell_sidebar_class = E_SHELL_SIDEBAR_CLASS (class);
    shell_sidebar_class->check_state = task_shell_sidebar_check_state;

    class->client_removed = task_shell_sidebar_client_removed;

    g_object_class_install_property (
        object_class,
        PROP_DEFAULT_CLIENT,
        g_param_spec_object (
            "default-client",
            "Default Task ECalClient",
            "Default client for task operations",
            E_TYPE_CAL_CLIENT,
            G_PARAM_READABLE));

    g_object_class_install_property (
        object_class,
        PROP_SELECTOR,
        g_param_spec_object (
            "selector",
            "Source Selector Widget",
            "This widget displays groups of task lists",
            E_TYPE_SOURCE_SELECTOR,
            G_PARAM_READABLE));

    signals[CLIENT_ADDED] = g_signal_new (
        "client-added",
        G_OBJECT_CLASS_TYPE (object_class),
        G_SIGNAL_RUN_LAST,
        G_STRUCT_OFFSET (ETaskShellSidebarClass, client_added),
        NULL, NULL,
        g_cclosure_marshal_VOID__OBJECT,
        G_TYPE_NONE, 1,
        E_TYPE_CAL_CLIENT);

    signals[CLIENT_REMOVED] = g_signal_new (
        "client-removed",
        G_OBJECT_CLASS_TYPE (object_class),
        G_SIGNAL_RUN_LAST,
        G_STRUCT_OFFSET (ETaskShellSidebarClass, client_removed),
        NULL, NULL,
        g_cclosure_marshal_VOID__OBJECT,
        G_TYPE_NONE, 1,
        E_TYPE_CAL_CLIENT);
}

static void
e_task_shell_sidebar_class_finalize (ETaskShellSidebarClass *class)
{
}

static void
e_task_shell_sidebar_init (ETaskShellSidebar *task_shell_sidebar)
{
    task_shell_sidebar->priv =
        E_TASK_SHELL_SIDEBAR_GET_PRIVATE (task_shell_sidebar);

    /* Postpone widget construction until we have a shell view. */
}

void
e_task_shell_sidebar_type_register (GTypeModule *type_module)
{
    /* XXX G_DEFINE_DYNAMIC_TYPE declares a static type registration
     *     function, so we have to wrap it with a public function in
     *     order to register types from a separate compilation unit. */
    e_task_shell_sidebar_register_type (type_module);
}

GtkWidget *
e_task_shell_sidebar_new (EShellView *shell_view)
{
    g_return_val_if_fail (E_IS_SHELL_VIEW (shell_view), NULL);

    return g_object_new (
        E_TYPE_TASK_SHELL_SIDEBAR,
        "shell-view", shell_view, NULL);
}

ECalClient *
e_task_shell_sidebar_get_default_client (ETaskShellSidebar *task_shell_sidebar)
{
    g_return_val_if_fail (
        E_IS_TASK_SHELL_SIDEBAR (task_shell_sidebar), NULL);

    return (ECalClient *) task_shell_sidebar->priv->default_client;
}

ESourceSelector *
e_task_shell_sidebar_get_selector (ETaskShellSidebar *task_shell_sidebar)
{
    g_return_val_if_fail (
        E_IS_TASK_SHELL_SIDEBAR (task_shell_sidebar), NULL);

    return E_SOURCE_SELECTOR (task_shell_sidebar->priv->selector);
}

void
e_task_shell_sidebar_add_client (ETaskShellSidebar *task_shell_sidebar,
                                 EClient *client)
{
    ESource *source;
    ESourceSelector *selector;

    g_return_if_fail (E_IS_TASK_SHELL_SIDEBAR (task_shell_sidebar));
    g_return_if_fail (E_IS_CAL_CLIENT (client));

    source = e_client_get_source (client);

    selector = e_task_shell_sidebar_get_selector (task_shell_sidebar);
    e_source_selector_select_source (selector, source);

    task_shell_sidebar_emit_client_added (task_shell_sidebar, client);
}

void
e_task_shell_sidebar_add_source (ETaskShellSidebar *task_shell_sidebar,
                                 ESource *source)
{
    ESourceSelector *selector;
    ConnectClosure *closure;

    g_return_if_fail (E_IS_TASK_SHELL_SIDEBAR (task_shell_sidebar));
    g_return_if_fail (E_IS_SOURCE (source));

    selector = e_task_shell_sidebar_get_selector (task_shell_sidebar);

    e_source_selector_select_source (selector, source);

    closure = connect_closure_new (task_shell_sidebar, source);

    e_client_selector_get_client (
        E_CLIENT_SELECTOR (selector), source,
        e_activity_get_cancellable (closure->activity),
        task_shell_sidebar_client_connect_cb, closure);
}

void
e_task_shell_sidebar_remove_source (ETaskShellSidebar *task_shell_sidebar,
                                    ESource *source)
{
    ESourceSelector *selector;
    EClient *client;

    g_return_if_fail (E_IS_TASK_SHELL_SIDEBAR (task_shell_sidebar));
    g_return_if_fail (E_IS_SOURCE (source));

    selector = e_task_shell_sidebar_get_selector (task_shell_sidebar);

    client = e_client_selector_ref_cached_client (
        E_CLIENT_SELECTOR (selector), source);

    if (client != NULL) {
        task_shell_sidebar_emit_client_removed (
            task_shell_sidebar, client);
        g_object_unref (client);
    }
}