/*
* gal-view-collection.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
*
*/
#include "gal-view-collection.h"
#include
#include
#include
#include
#include
#include
#include "e-unicode.h"
#include "e-xml-utils.h"
#define GAL_VIEW_COLLECTION_GET_PRIVATE(obj) \
(G_TYPE_INSTANCE_GET_PRIVATE \
((obj), GAL_TYPE_VIEW_COLLECTION, GalViewCollectionPrivate))
struct _GalViewCollectionPrivate {
GalViewCollectionItem **view_data;
gint view_count;
GalViewCollectionItem **removed_view_data;
gint removed_view_count;
gboolean default_view_built_in;
gchar *system_directory;
gchar *user_directory;
gchar *default_view;
};
enum {
PROP_0,
PROP_SYSTEM_DIRECTORY,
PROP_USER_DIRECTORY
};
enum {
CHANGED,
LAST_SIGNAL
};
static guint signals[LAST_SIGNAL];
G_DEFINE_TYPE (GalViewCollection, gal_view_collection, G_TYPE_OBJECT)
static void
gal_view_collection_changed (GalViewCollection *collection)
{
g_return_if_fail (GAL_IS_VIEW_COLLECTION (collection));
g_signal_emit (collection, signals[CHANGED], 0);
}
static void
gal_view_collection_item_free (GalViewCollectionItem *item)
{
g_free (item->id);
if (item->view) {
if (item->view_changed_id)
g_signal_handler_disconnect (
item->view,
item->view_changed_id);
g_object_unref (item->view);
}
g_free (item);
}
static gchar *
gal_view_generate_string (GalViewCollection *collection,
GalView *view,
gint which)
{
gchar *ret_val;
gchar *pointer;
if (which == 1)
ret_val = g_strdup (gal_view_get_title (view));
else
ret_val = g_strdup_printf ("%s_%d", gal_view_get_title (view), which);
for (pointer = ret_val; *pointer; pointer = g_utf8_next_char (pointer)) {
if (!g_unichar_isalnum (g_utf8_get_char (pointer))) {
gchar *ptr = pointer;
for (; ptr < g_utf8_next_char (pointer); *ptr = '_', ptr++)
;
}
}
return ret_val;
}
static gint
gal_view_check_string (GalViewCollection *collection,
gchar *string)
{
gint i;
if (!strcmp (string, "current_view"))
return FALSE;
for (i = 0; i < collection->priv->view_count; i++) {
if (!strcmp (string, collection->priv->view_data[i]->id))
return FALSE;
}
for (i = 0; i < collection->priv->removed_view_count; i++) {
if (!strcmp (string, collection->priv->removed_view_data[i]->id))
return FALSE;
}
return TRUE;
}
static gchar *
gal_view_generate_id (GalViewCollection *collection,
GalView *view)
{
gint i;
for (i = 1; TRUE; i++) {
gchar *try;
try = gal_view_generate_string (collection, view, i);
if (gal_view_check_string (collection, try))
return try;
g_free (try);
}
}
static void
view_collection_check_type (GType type,
gpointer user_data)
{
GalViewClass *class;
struct {
const gchar *type_code;
GType type;
} *closure = user_data;
class = g_type_class_ref (type);
g_return_if_fail (class != NULL);
if (g_strcmp0 (class->type_code, closure->type_code) == 0)
closure->type = type;
g_type_class_unref (class);
}
/* Use factory list to load a GalView file. */
static GalView *
gal_view_collection_real_load_view_from_file (GalViewCollection *collection,
const gchar *type,
const gchar *title,
const gchar *dir,
const gchar *filename)
{
GalView *view = NULL;
struct {
const gchar *type_code;
GType type;
} closure;
closure.type_code = type;
closure.type = G_TYPE_INVALID;
/* Find the appropriate GalView subtype for the "type_code" string. */
e_type_traverse (GAL_TYPE_VIEW, view_collection_check_type, &closure);
if (g_type_is_a (closure.type, GAL_TYPE_VIEW)) {
view = g_object_new (closure.type, "title", title, NULL);
gal_view_load (view, filename);
}
return view;
}
static void
view_changed (GalView *view,
GalViewCollectionItem *item)
{
item->changed = TRUE;
item->ever_changed = TRUE;
g_signal_handler_block (item->view, item->view_changed_id);
gal_view_collection_changed (item->collection);
g_signal_handler_unblock (item->view, item->view_changed_id);
}
static GalViewCollectionItem *
load_single_file (GalViewCollection *collection,
const gchar *dir,
gboolean local,
xmlNode *node)
{
GalViewCollectionItem *item;
item = g_new (GalViewCollectionItem, 1);
item->ever_changed = local;
item->changed = FALSE;
item->built_in = !local;
item->id = e_xml_get_string_prop_by_name (node, (const guchar *)"id");
item->filename = e_xml_get_string_prop_by_name (node, (const guchar *)"filename");
item->title = e_xml_get_translated_utf8_string_prop_by_name (node, (const guchar *)"title");
item->type = e_xml_get_string_prop_by_name (node, (const guchar *)"type");
item->collection = collection;
item->view_changed_id = 0;
if (item->filename) {
gchar *fullpath;
fullpath = g_build_filename (dir, item->filename, NULL);
item->view = gal_view_collection_real_load_view_from_file (collection, item->type, item->title, dir, fullpath);
g_free (fullpath);
if (item->view) {
item->view_changed_id = g_signal_connect (
item->view, "changed",
G_CALLBACK (view_changed), item);
}
}
return item;
}
static void
load_single_dir (GalViewCollection *collection,
const gchar *dir,
gboolean local)
{
xmlDoc *doc = NULL;
xmlNode *root;
xmlNode *child;
gchar *filename = g_build_filename (dir, "galview.xml", NULL);
gchar *default_view;
if (g_file_test (filename, G_FILE_TEST_IS_REGULAR)) {
#ifdef G_OS_WIN32
gchar *locale_filename = g_win32_locale_filename_from_utf8 (filename);
if (locale_filename != NULL)
doc = xmlParseFile (locale_filename);
g_free (locale_filename);
#else
doc = xmlParseFile (filename);
#endif
}
if (!doc) {
g_free (filename);
return;
}
root = xmlDocGetRootElement (doc);
for (child = root->xmlChildrenNode; child; child = child->next) {
gchar *id;
gboolean found = FALSE;
gint i;
if (!strcmp ((gchar *) child->name, "text"))
continue;
id = e_xml_get_string_prop_by_name (child, (const guchar *)"id");
for (i = 0; i < collection->priv->view_count; i++) {
if (!strcmp (id, collection->priv->view_data[i]->id)) {
if (!local)
collection->priv->view_data[i]->built_in = TRUE;
found = TRUE;
break;
}
}
if (!found) {
for (i = 0; i < collection->priv->removed_view_count; i++) {
if (!strcmp (id, collection->priv->removed_view_data[i]->id)) {
if (!local)
collection->priv->removed_view_data[i]->built_in = TRUE;
found = TRUE;
break;
}
}
}
if (!found) {
GalViewCollectionItem *item = load_single_file (collection, dir, local, child);
if (item->filename && *item->filename) {
collection->priv->view_data = g_renew (GalViewCollectionItem *, collection->priv->view_data, collection->priv->view_count + 1);
collection->priv->view_data[collection->priv->view_count] = item;
collection->priv->view_count++;
} else {
collection->priv->removed_view_data = g_renew (GalViewCollectionItem *, collection->priv->removed_view_data, collection->priv->removed_view_count + 1);
collection->priv->removed_view_data[collection->priv->removed_view_count] = item;
collection->priv->removed_view_count++;
}
}
g_free (id);
}
default_view = e_xml_get_string_prop_by_name (root, (const guchar *)"default-view");
if (default_view) {
if (local)
collection->priv->default_view_built_in = FALSE;
else
collection->priv->default_view_built_in = TRUE;
g_free (collection->priv->default_view);
collection->priv->default_view = default_view;
}
g_free (filename);
xmlFreeDoc (doc);
}
static void
gal_view_collection_set_system_directory (GalViewCollection *collection,
const gchar *system_directory)
{
g_return_if_fail (system_directory != NULL);
g_return_if_fail (collection->priv->system_directory == NULL);
collection->priv->system_directory = g_strdup (system_directory);
}
static void
gal_view_collection_set_user_directory (GalViewCollection *collection,
const gchar *user_directory)
{
g_return_if_fail (user_directory != NULL);
g_return_if_fail (collection->priv->user_directory == NULL);
collection->priv->user_directory = g_strdup (user_directory);
}
static void
gal_view_collection_set_property (GObject *object,
guint property_id,
const GValue *value,
GParamSpec *pspec)
{
switch (property_id) {
case PROP_SYSTEM_DIRECTORY:
gal_view_collection_set_system_directory (
GAL_VIEW_COLLECTION (object),
g_value_get_string (value));
return;
case PROP_USER_DIRECTORY:
gal_view_collection_set_user_directory (
GAL_VIEW_COLLECTION (object),
g_value_get_string (value));
return;
}
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
}
static void
gal_view_collection_get_property (GObject *object,
guint property_id,
GValue *value,
GParamSpec *pspec)
{
switch (property_id) {
case PROP_SYSTEM_DIRECTORY:
g_value_set_string (
value,
gal_view_collection_get_system_directory (
GAL_VIEW_COLLECTION (object)));
return;
case PROP_USER_DIRECTORY:
g_value_set_string (
value,
gal_view_collection_get_user_directory (
GAL_VIEW_COLLECTION (object)));
return;
}
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
}
static void
gal_view_collection_dispose (GObject *object)
{
GalViewCollectionPrivate *priv;
gint ii;
priv = GAL_VIEW_COLLECTION_GET_PRIVATE (object);
for (ii = 0; ii < priv->view_count; ii++)
gal_view_collection_item_free (priv->view_data[ii]);
g_free (priv->view_data);
priv->view_data = NULL;
priv->view_count = 0;
for (ii = 0; ii < priv->removed_view_count; ii++)
gal_view_collection_item_free (priv->removed_view_data[ii]);
g_free (priv->removed_view_data);
priv->removed_view_data = NULL;
priv->removed_view_count = 0;
/* Chain up to parent's dispose() method. */
G_OBJECT_CLASS (gal_view_collection_parent_class)->dispose (object);
}
static void
gal_view_collection_finalize (GObject *object)
{
GalViewCollectionPrivate *priv;
priv = GAL_VIEW_COLLECTION_GET_PRIVATE (object);
g_free (priv->system_directory);
g_free (priv->user_directory);
g_free (priv->default_view);
/* Chain up to parent's finalize() method. */
G_OBJECT_CLASS (gal_view_collection_parent_class)->finalize (object);
}
static void
gal_view_collection_constructed (GObject *object)
{
GalViewCollection *collection;
const gchar *directory;
collection = GAL_VIEW_COLLECTION (object);
/* Chain up to parent's constructed() method. */
G_OBJECT_CLASS (gal_view_collection_parent_class)->constructed (object);
/* XXX Maybe this should implement GInitable, since creating
* directories and reading files can fail. Although, we
* would probably just abort Evolution on error anyway. */
directory = gal_view_collection_get_user_directory (collection);
g_mkdir_with_parents (directory, 0700);
load_single_dir (collection, directory, TRUE);
directory = gal_view_collection_get_system_directory (collection);
load_single_dir (collection, directory, FALSE);
}
static void
gal_view_collection_class_init (GalViewCollectionClass *class)
{
GObjectClass *object_class;
g_type_class_add_private (class, sizeof (GalViewCollectionPrivate));
object_class = G_OBJECT_CLASS (class);
object_class->set_property = gal_view_collection_set_property;
object_class->get_property = gal_view_collection_get_property;
object_class->dispose = gal_view_collection_dispose;
object_class->finalize = gal_view_collection_finalize;
object_class->constructed = gal_view_collection_constructed;
g_object_class_install_property (
object_class,
PROP_SYSTEM_DIRECTORY,
g_param_spec_string (
"system-directory",
"System Directory",
"Directory from which to load built-in views",
NULL,
G_PARAM_READWRITE |
G_PARAM_CONSTRUCT_ONLY |
G_PARAM_STATIC_STRINGS));
g_object_class_install_property (
object_class,
PROP_USER_DIRECTORY,
g_param_spec_string (
"user-directory",
"User Directory",
"Directory from which to load user-created views",
NULL,
G_PARAM_READWRITE |
G_PARAM_CONSTRUCT_ONLY |
G_PARAM_STATIC_STRINGS));
signals[CHANGED] = g_signal_new (
"changed",
G_OBJECT_CLASS_TYPE (object_class),
G_SIGNAL_RUN_LAST,
G_STRUCT_OFFSET (GalViewCollectionClass, changed),
NULL, NULL,
g_cclosure_marshal_VOID__VOID,
G_TYPE_NONE, 0);
}
static void
gal_view_collection_init (GalViewCollection *collection)
{
collection->priv = GAL_VIEW_COLLECTION_GET_PRIVATE (collection);
collection->priv->default_view_built_in = TRUE;
}
/**
* gal_view_collection_new:
* @system_directory: directory from which to load built-in views
* @user_directory: directory from which to load user-created views
*
* Creates a #GalViewCollection and loads ".galview" files from
* @system_directory and @user_directory.
*/
GalViewCollection *
gal_view_collection_new (const gchar *system_directory,
const gchar *user_directory)
{
g_return_val_if_fail (system_directory != NULL, NULL);
g_return_val_if_fail (user_directory != NULL, NULL);
return g_object_new (
GAL_TYPE_VIEW_COLLECTION,
"system-directory", system_directory,
"user-directory", user_directory, NULL);
}
/**
* gal_view_collection_get_system_directory:
* @collection: a #GalViewCollection
*
* Returns the directory from which built-in views were loaded.
*
* Returns: the system directory for @collection
**/
const gchar *
gal_view_collection_get_system_directory (GalViewCollection *collection)
{
g_return_val_if_fail (GAL_IS_VIEW_COLLECTION (collection), NULL);
return collection->priv->system_directory;
}
/**
* gal_view_collection_get_user_directory:
* @collection: a #GalViewCollection
*
* Returns the directory from which user-created views were loaded.
*
* Returns: the user directory for @collection
**/
const gchar *
gal_view_collection_get_user_directory (GalViewCollection *collection)
{
g_return_val_if_fail (GAL_IS_VIEW_COLLECTION (collection), NULL);
return collection->priv->user_directory;
}
GalView *
gal_view_collection_load_view_from_file (GalViewCollection *collection,
const gchar *type,
const gchar *filename)
{
return gal_view_collection_real_load_view_from_file (
collection, type, "",
collection->priv->user_directory, filename);
}
/**
* gal_view_collection_save
* @collection: The view collection to save information for
*
* Saves the data to the user directory specified in set storage
* directories. This is primarily for internal use by other parts of
* gal_view.
*/
void
gal_view_collection_save (GalViewCollection *collection)
{
gint i;
xmlDoc *doc;
xmlNode *root;
gchar *filename;
const gchar *user_directory;
g_return_if_fail (GAL_IS_VIEW_COLLECTION (collection));
user_directory = gal_view_collection_get_user_directory (collection);
g_return_if_fail (user_directory != NULL);
doc = xmlNewDoc ((const guchar *)"1.0");
root = xmlNewNode (NULL, (const guchar *)"GalViewCollection");
xmlDocSetRootElement (doc, root);
if (collection->priv->default_view && !collection->priv->default_view_built_in) {
e_xml_set_string_prop_by_name (root, (const guchar *)"default-view", collection->priv->default_view);
}
for (i = 0; i < collection->priv->view_count; i++) {
xmlNode *child;
GalViewCollectionItem *item;
item = collection->priv->view_data[i];
if (item->ever_changed) {
child = xmlNewChild (root, NULL, (const guchar *)"GalView", NULL);
e_xml_set_string_prop_by_name (child, (const guchar *)"id", item->id);
e_xml_set_string_prop_by_name (child, (const guchar *)"title", item->title);
e_xml_set_string_prop_by_name (child, (const guchar *)"filename", item->filename);
e_xml_set_string_prop_by_name (child, (const guchar *)"type", item->type);
if (item->changed) {
filename = g_build_filename (user_directory, item->filename, NULL);
gal_view_save (item->view, filename);
g_free (filename);
}
}
}
for (i = 0; i < collection->priv->removed_view_count; i++) {
xmlNode *child;
GalViewCollectionItem *item;
item = collection->priv->removed_view_data[i];
child = xmlNewChild (root, NULL, (const guchar *)"GalView", NULL);
e_xml_set_string_prop_by_name (child, (const guchar *)"id", item->id);
e_xml_set_string_prop_by_name (child, (const guchar *)"title", item->title);
e_xml_set_string_prop_by_name (child, (const guchar *)"type", item->type);
}
filename = g_build_filename (user_directory, "galview.xml", NULL);
if (e_xml_save_file (filename, doc) == -1)
g_warning ("Unable to save view to %s - %s", filename, g_strerror (errno));
xmlFreeDoc (doc);
g_free (filename);
}
/**
* gal_view_collection_get_count
* @collection: The view collection to count
*
* Calculates the number of views in the given collection.
*
* Returns: The number of views in the collection.
*/
gint
gal_view_collection_get_count (GalViewCollection *collection)
{
g_return_val_if_fail (GAL_IS_VIEW_COLLECTION (collection), -1);
return collection->priv->view_count;
}
/**
* gal_view_collection_get_view
* @collection: The view collection to query
* @n: The view to get.
*
* Returns: The nth view in the collection
*/
GalView *
gal_view_collection_get_view (GalViewCollection *collection,
gint n)
{
g_return_val_if_fail (GAL_IS_VIEW_COLLECTION (collection), NULL);
g_return_val_if_fail (n < collection->priv->view_count, NULL);
g_return_val_if_fail (n >= 0, NULL);
return collection->priv->view_data[n]->view;
}
/**
* gal_view_collection_get_view_item
* @collection: The view collection to query
* @n: The view item to get.
*
* Returns: The nth view item in the collection
*/
GalViewCollectionItem *
gal_view_collection_get_view_item (GalViewCollection *collection,
gint n)
{
g_return_val_if_fail (GAL_IS_VIEW_COLLECTION (collection), NULL);
g_return_val_if_fail (n < collection->priv->view_count, NULL);
g_return_val_if_fail (n >= 0, NULL);
return collection->priv->view_data[n];
}
gint
gal_view_collection_get_view_index_by_id (GalViewCollection *collection,
const gchar *view_id)
{
gint ii;
g_return_val_if_fail (GAL_IS_VIEW_COLLECTION (collection), -1);
g_return_val_if_fail (view_id != NULL, -1);
for (ii = 0; ii < collection->priv->view_count; ii++) {
if (!strcmp (collection->priv->view_data[ii]->id, view_id))
return ii;
}
return -1;
}
void
gal_view_collection_delete_view (GalViewCollection *collection,
gint i)
{
GalViewCollectionItem *item;
g_return_if_fail (GAL_IS_VIEW_COLLECTION (collection));
g_return_if_fail (i >= 0 && i < collection->priv->view_count);
item = collection->priv->view_data[i];
memmove (collection->priv->view_data + i, collection->priv->view_data + i + 1, (collection->priv->view_count - i - 1) * sizeof (GalViewCollectionItem *));
collection->priv->view_count--;
if (item->built_in) {
g_free (item->filename);
item->filename = NULL;
collection->priv->removed_view_data = g_renew (GalViewCollectionItem *, collection->priv->removed_view_data, collection->priv->removed_view_count + 1);
collection->priv->removed_view_data[collection->priv->removed_view_count] = item;
collection->priv->removed_view_count++;
} else {
gal_view_collection_item_free (item);
}
gal_view_collection_changed (collection);
}
const gchar *
gal_view_collection_append_with_title (GalViewCollection *collection,
const gchar *title,
GalView *view)
{
GalViewCollectionItem *item;
GalViewClass *view_class;
g_return_val_if_fail (GAL_IS_VIEW_COLLECTION (collection), NULL);
g_return_val_if_fail (GAL_IS_VIEW (view), NULL);
view_class = GAL_VIEW_GET_CLASS (view);
gal_view_set_title (view, title);
item = g_new (GalViewCollectionItem, 1);
item->ever_changed = TRUE;
item->changed = TRUE;
item->built_in = FALSE;
item->title = g_strdup (gal_view_get_title (view));
item->type = g_strdup (view_class->type_code);
item->id = gal_view_generate_id (collection, view);
item->filename = g_strdup_printf ("%s.galview", item->id);
item->view = view;
item->collection = collection;
g_object_ref (view);
item->view_changed_id = g_signal_connect (
item->view, "changed",
G_CALLBACK (view_changed), item);
collection->priv->view_data = g_renew (GalViewCollectionItem *, collection->priv->view_data, collection->priv->view_count + 1);
collection->priv->view_data[collection->priv->view_count] = item;
collection->priv->view_count++;
gal_view_collection_changed (collection);
return item->id;
}
const gchar *
gal_view_collection_set_nth_view (GalViewCollection *collection,
gint i,
GalView *view)
{
GalViewCollectionItem *item;
GalViewClass *view_class;
g_return_val_if_fail (GAL_IS_VIEW_COLLECTION (collection), NULL);
g_return_val_if_fail (GAL_IS_VIEW (view), NULL);
g_return_val_if_fail (i >= 0, NULL);
g_return_val_if_fail (i < collection->priv->view_count, NULL);
view_class = GAL_VIEW_GET_CLASS (view);
item = collection->priv->view_data[i];
gal_view_set_title (view, item->title);
g_object_ref (view);
if (item->view) {
g_signal_handler_disconnect (
item->view,
item->view_changed_id);
g_object_unref (item->view);
}
item->view = view;
item->ever_changed = TRUE;
item->changed = TRUE;
item->type = g_strdup (view_class->type_code);
item->view_changed_id = g_signal_connect (
item->view, "changed",
G_CALLBACK (view_changed), item);
gal_view_collection_changed (collection);
return item->id;
}
const gchar *
gal_view_collection_get_default_view (GalViewCollection *collection)
{
g_return_val_if_fail (GAL_IS_VIEW_COLLECTION (collection), NULL);
return collection->priv->default_view;
}