/*
* Copyright (C) 2010, 2011 Igalia S.L.
*
* Contact: Iago Toral Quiroga <itoral@igalia.com>
*
* 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; 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
*
*/
/**
* SECTION:grilo
* @short_description: Metadata library supporting several services
*
* Grilo is a metadata retrieval library. Given a search or browse operation,
* the library will retrieve a set of metadata related to the operation from a
* set of on-line services.
*
* The Grilo library should be initialized with grl_init() before it can be used.
* You should pass pointers to the main argc and argv variables so that Grilo can
* process its own command line options.
*
* After using it, in order to close cleanly all the resources opened either by
* the core library or the sources, call grl_deinit().
*/
#include "grilo.h"
#include "grl-metadata-key-priv.h"
#include "grl-operation-priv.h"
#include "grl-registry-priv.h"
#include "grl-log-priv.h"
#include "config.h"
#include <glib/gi18n-lib.h>
static gboolean grl_initialized = FALSE;
static const gchar *plugin_path = NULL;
static const gchar *plugin_list = NULL;
static const gchar *
get_default_plugin_dir (void)
{
#ifdef G_OS_WIN32
static gchar *plugin_dir = NULL;
gchar *run_directory;
if (plugin_dir)
return plugin_dir;
run_directory = g_win32_get_package_installation_directory_of_module (NULL);
plugin_dir = g_build_filename (run_directory,
"lib", GRL_NAME,
NULL);
g_free (run_directory);
return plugin_dir;
#else
return GRL_PLUGINS_DIR;
#endif
}
static gboolean
pre_parse_hook_cb (GOptionContext *context,
GOptionGroup *group,
gpointer data,
GError **error)
{
/* Initialize i18n */
bindtextdomain (GETTEXT_PACKAGE, LOCALEDIR);
bind_textdomain_codeset (GETTEXT_PACKAGE, "UTF-8");
/* Initialize operations */
grl_operation_init ();
return TRUE;
}
static gboolean
post_parse_hook_cb (GOptionContext *context,
GOptionGroup *group,
gpointer data,
GError **error)
{
GrlRegistry *registry;
gchar **split_element;
gchar **split_list;
/* Initialize GModule */
if (!g_module_supported ()) {
GRL_ERROR ("GModule not supported in this system");
}
/* Setup core log domains */
_grl_log_init_core_domains ();
/* Register default metadata keys */
registry = grl_registry_get_default ();
grl_metadata_key_setup_system_keys (registry);
/* Set default plugin directories */
if (!plugin_path) {
plugin_path = g_getenv (GRL_PLUGIN_PATH_VAR);
}
if (!plugin_path) {
plugin_path = get_default_plugin_dir ();
}
split_list = g_strsplit (plugin_path, G_SEARCHPATH_SEPARATOR_S, 0);
for (split_element = split_list; *split_element; split_element++) {
grl_registry_add_directory (registry, *split_element);
}
g_strfreev (split_list);
/* Restrict plugins to load */
if (!plugin_list) {
plugin_list = g_getenv (GRL_PLUGIN_LIST_VAR);
}
if (plugin_list) {
split_list = g_strsplit (plugin_list, ":", 0);
grl_registry_restrict_plugins (registry, split_list);
g_strfreev (split_list);
}
grl_initialized = TRUE;
return TRUE;
}
/**
* grl_init:
* @argc: (inout) (allow-none): number of input arguments, length of @argv
* @argv: (inout) (element-type utf8) (array length=argc) (allow-none) (transfer none): list of arguments
*
* Initializes the Grilo library
*
* Since: 0.1.6
*/
void
grl_init (gint *argc,
gchar **argv[])
{
GOptionContext *ctx;
GOptionGroup *group;
if (grl_initialized) {
GRL_DEBUG ("already initialized grl");
return;
}
/* Check options */
ctx = g_option_context_new ("- Grilo initialization");
g_option_context_set_ignore_unknown_options (ctx, TRUE);
group = grl_init_get_option_group ();
g_option_context_add_group (ctx, group);
g_option_context_parse (ctx, argc, argv, NULL);
g_option_context_free (ctx);
}
/**
* grl_deinit:
*
* Deinitializes the Grilo library.
*
* Call this function after finalizing using Grilo, in order to free and clean
* up all the resources created.
*
* Since: 0.2.8
*/
void
grl_deinit (void)
{
GrlRegistry *registry;
if (!grl_initialized) {
GRL_WARNING ("Grilo has not been initialized");
return;
}
registry = grl_registry_get_default ();
grl_registry_shutdown (registry);
grl_initialized = FALSE;
}
/**
* grl_init_get_option_group:
*
* Returns a #GOptionGroup with Grilo's argument specifications.
*
* This function is useful if you want to integrate Grilo with other
* libraries that use the GOption commandline parser
* (see g_option_context_add_group() ).
*
* Returns: a pointer to Grilo's option group. Should be dereferenced
* after use.
*
* Since: 0.1.6
*/
GOptionGroup *
grl_init_get_option_group (void)
{
GOptionGroup *group;
static const GOptionEntry grl_args[] = {
{ "grl-plugin-path", 0, 0, G_OPTION_ARG_STRING, &plugin_path,
#ifdef G_OS_WIN32
N_("Semicolon-separated paths containing Grilo plugins"), NULL },
#else
N_("Colon-separated paths containing Grilo plugins"), NULL },
#endif
{ "grl-plugin-use", 0, 0, G_OPTION_ARG_STRING, &plugin_list,
N_("Colon-separated list of Grilo plugins to use"), NULL },
{ NULL }
};
group = g_option_group_new ("grl",
_("Grilo Options"),
_("Show Grilo Options"),
NULL,
NULL);
g_option_group_add_entries (group, grl_args);
g_option_group_set_parse_hooks (group, pre_parse_hook_cb, post_parse_hook_cb);
return group;
}