libanjuta/anjuta-plugin-manager.h

   1 /* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 4; tab-width: 4 -*- */
   2 /*
   3  * anjuta-plugin-manager.h
   4  * Copyright (C) Naba Kumar  <naba@gnome.org>
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program; if not, write to the Free Software
  18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  19  */
  20
  21 #ifndef _ANJUTA_PLUGIN_MANAGER_H_
  22 #define _ANJUTA_PLUGIN_MANAGER_H_
  23
  24 #include <glib-object.h>
  25 #include <libanjuta/anjuta-status.h>
  26 #include <libanjuta/anjuta-plugin-description.h>
  27
  28 G_BEGIN_DECLS
  29
  30 #define ANJUTA_TYPE_PLUGIN_MANAGER             (anjuta_plugin_manager_get_type ())
  31 #define ANJUTA_PLUGIN_MANAGER(obj)             (G_TYPE_CHECK_INSTANCE_CAST ((obj), ANJUTA_TYPE_PLUGIN_MANAGER, AnjutaPluginManager))
  32 #define ANJUTA_PLUGIN_MANAGER_CLASS(klass)     (G_TYPE_CHECK_CLASS_CAST ((klass), ANJUTA_TYPE_PLUGIN_MANAGER, AnjutaPluginManagerClass))
  33 #define ANJUTA_IS_PLUGIN_MANAGER(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), ANJUTA_TYPE_PLUGIN_MANAGER))
  34 #define ANJUTA_IS_PLUGIN_MANAGER_CLASS(klass)  (G_TYPE_CHECK_CLASS_TYPE ((klass), ANJUTA_TYPE_PLUGIN_MANAGER))
  35 #define ANJUTA_PLUGIN_MANAGER_GET_CLASS(obj)   (G_TYPE_INSTANCE_GET_CLASS ((obj), ANJUTA_TYPE_PLUGIN_MANAGER, AnjutaPluginManagerClass))
  36 #define ANJUTA_PLUGIN_MANAGER_ERROR            (anjuta_plugin_manager_error_quark())
  37
  38 typedef enum
  39 {
  40         ANJUTA_PLUGIN_MANAGER_ERROR_INVALID_TYPE,
  41         ANJUTA_PLUGIN_MANAGER_ERROR_UNKNOWN
  42 } AnjutaPluginManagerError;
  43
  44
  45 typedef struct _AnjutaPluginManagerClass AnjutaPluginManagerClass;
  46 typedef struct _AnjutaPluginManager AnjutaPluginManager;
  47 typedef struct _AnjutaPluginManagerPriv AnjutaPluginManagerPriv;
  48
  49 struct _AnjutaPluginManagerClass
  50 {
  51         GObjectClass parent_class;
  52
  53         /* Signals */
  54         void(* plugin_activated) (AnjutaPluginManager *self,
  55                                                           AnjutaPluginDescription* plugin_desc,
  56                                                           GObject *plugin);
  57         void(* plugin_deactivated) (AnjutaPluginManager *self,
  58                                                                 AnjutaPluginDescription* plugin_desc,
  59                                                                 GObject *plugin);
  60 };
  61
  62 struct _AnjutaPluginManager
  63 {
  64         GObject parent_instance;
  65         AnjutaPluginManagerPriv *priv;
  66 };
  67
  68 GQuark anjuta_plugin_manager_error_quark (void);
  69 GType anjuta_plugin_manager_get_type (void) G_GNUC_CONST;
  70 AnjutaPluginManager* anjuta_plugin_manager_new (GObject *shell,
  71                                                                                                 AnjutaStatus *status,
  72                                                                                                 GList* plugin_search_paths);
  73
  74 /* Plugin activation, deactivation and retrival */
  75 GObject* anjuta_plugin_manager_get_plugin (AnjutaPluginManager *plugin_manager,
  76                                                                                    const gchar *iface_name);
  77 GObject* anjuta_plugin_manager_get_plugin_by_id (AnjutaPluginManager *plugin_manager,
  78                                                                                                  const gchar *plugin_id);
  79 gboolean anjuta_plugin_manager_unload_plugin (AnjutaPluginManager *plugin_manager,
  80                                                                                           GObject *plugin);
  81 gboolean anjuta_plugin_manager_unload_plugin_by_id (AnjutaPluginManager *plugin_manager,
  82                                                                                                         const gchar *plugin_id);
  83 GList* anjuta_plugin_manager_get_active_plugins (AnjutaPluginManager *plugin_manager);
  84
  85 /* Selection dialogs */
  86 GtkWidget* anjuta_plugin_manager_get_dialog (AnjutaPluginManager *plugin_manager);
  87
  88 /* Plugin queries based on meta-data */
  89 /* Returns a list of plugin Descriptions */
  90 GList* anjuta_plugin_manager_query (AnjutaPluginManager *plugin_manager,
  91                                                                         const gchar *section_name,
  92                                                                         const gchar *attribute_name,
  93                                                                         const gchar *attribute_value,
  94                                                                         ...);
  95
  96 /* Returns the plugin description that has been selected from the list */
  97 AnjutaPluginDescription* anjuta_plugin_manager_select (AnjutaPluginManager *plugin_manager,
  98                                                                                                            gchar *title, gchar *description,
  99                                                                                                            GList *plugin_descriptions);
 100
 101 /* Returns the plugin that has been selected and activated */
 102 GObject* anjuta_plugin_manager_select_and_activate (AnjutaPluginManager *plugin_manager,
 103                                                                                                         gchar *title,
 104                                                                                                         gchar *description,
 105                                                                                                         GList *plugin_descriptions);
 106
 107 void anjuta_plugin_manager_activate_plugins (AnjutaPluginManager *plugin_manager,
 108                                                                                          GList *plugin_descs);
 109
 110 void anjuta_plugin_manager_unload_all_plugins (AnjutaPluginManager *plugin_manager);
 111
 112 gchar* anjuta_plugin_manager_get_remembered_plugins (AnjutaPluginManager *plugin_manager);
 113 void anjuta_plugin_manager_set_remembered_plugins (AnjutaPluginManager *plugin_manager,
 114                                                                                                    const gchar *remembered_plugins);
 115
 116 /**
 117  * anjuta_plugin_manager_get_interface:
 118  * @plugin_manager: A #AnjutaPluginManager object
 119  * @iface_type: The interface type implemented by the object to be found
 120  * @error: Error propagation object.
 121  *
 122  * Equivalent to anjuta_plugin_manager_get_object(), but additionally
 123  * typecasts returned object to the interface type. It also takes
 124  * interface type directly. A usage of this function is:
 125  * <programlisting>
 126  * IAnjutaDocumentManager *docman =
 127  *     anjuta_plugin_manager_get_interface (plugin_manager, IAnjutaDocumentManager, error);
 128  * </programlisting>
 129  */
 130 #define anjuta_plugin_manager_get_interface(plugin_manager, iface_type, error) \
 131         (((iface_type*) anjuta_plugin_manager_get_plugin((plugin_manager), #iface_type, (error)))
 132
 133 G_END_DECLS
 134
 135 #endif /* _ANJUTA_PLUGIN_MANAGER_H_ */