d5db022cfc6487d41127db8993eca5f1d36d32c3
[modest] / src / modest-conf.c
1 /* Copyright (c) 2006, Nokia Corporation
2  * All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are
6  * met:
7  *
8  * * Redistributions of source code must retain the above copyright
9  *   notice, this list of conditions and the following disclaimer.
10  * * Redistributions in binary form must reproduce the above copyright
11  *   notice, this list of conditions and the following disclaimer in the
12  *   documentation and/or other materials provided with the distribution.
13  * * Neither the name of the Nokia Corporation nor the names of its
14  *   contributors may be used to endorse or promote products derived from
15  *   this software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
18  * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
19  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
20  * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
21  * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
22  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
23  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
24  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
25  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
26  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
27  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28  */
29
30 #include <gconf/gconf-client.h>
31 #include <string.h>
32 #include "modest-conf.h"
33 #include "modest-marshal.h"
34
35 static void   modest_conf_class_init     (ModestConfClass *klass);
36 static void   modest_conf_init           (ModestConf *obj);
37 static void   modest_conf_finalize       (GObject *obj);
38 static void   modest_conf_on_change      (GConfClient *client, guint conn_id,
39                                           GConfEntry *entry, gpointer data);
40 /* list my signals */
41 enum {
42         KEY_CHANGED_SIGNAL,
43         LAST_SIGNAL
44 };
45 static guint signals[LAST_SIGNAL] = {0}; 
46
47
48 typedef struct _ModestConfPrivate ModestConfPrivate;
49 struct _ModestConfPrivate {
50         GConfClient *gconf_client;
51 };
52 #define MODEST_CONF_GET_PRIVATE(o)      (G_TYPE_INSTANCE_GET_PRIVATE((o), \
53                                          MODEST_TYPE_CONF, \
54                                          ModestConfPrivate))
55 /* globals */
56 static GObjectClass *parent_class = NULL;
57
58 GType
59 modest_conf_get_type (void)
60 {
61         static GType my_type = 0;
62         if (!my_type) {
63                 static const GTypeInfo my_info = {
64                         sizeof(ModestConfClass),
65                         NULL,           /* base init */
66                         NULL,           /* base finalize */
67                         (GClassInitFunc) modest_conf_class_init,
68                         NULL,           /* class finalize */
69                         NULL,           /* class data */
70                         sizeof(ModestConf),
71                         1,              /* n_preallocs */
72                         (GInstanceInitFunc) modest_conf_init,
73                         NULL
74                 };
75                 my_type = g_type_register_static (G_TYPE_OBJECT,
76                                                   "ModestConf",
77                                                   &my_info, 0);
78         }
79         return my_type;
80 }
81
82 static void
83 modest_conf_class_init (ModestConfClass *klass)
84 {
85         GObjectClass *gobject_class;
86         gobject_class = (GObjectClass*) klass;
87
88         parent_class            = g_type_class_peek_parent (klass);
89         gobject_class->finalize = modest_conf_finalize;
90
91         g_type_class_add_private (gobject_class, sizeof(ModestConfPrivate));
92         
93         signals[KEY_CHANGED_SIGNAL] =
94                 g_signal_new ("key_changed",
95                               G_TYPE_FROM_CLASS (gobject_class),
96                               G_SIGNAL_RUN_FIRST,
97                               G_STRUCT_OFFSET (ModestConfClass,key_changed),
98                               NULL, NULL,
99                               modest_marshal_VOID__STRING_INT,
100                               G_TYPE_NONE, 2, G_TYPE_STRING, G_TYPE_INT); 
101 }
102
103 static void
104 modest_conf_init (ModestConf *obj)
105 {
106         GConfClient *conf = NULL;
107         ModestConfPrivate *priv = MODEST_CONF_GET_PRIVATE(obj);
108         GError *err      = NULL;
109         
110         priv->gconf_client = NULL;
111         
112         conf = gconf_client_get_default ();
113         if (!conf) {
114                 g_printerr ("modest: could not get gconf client\n");
115                 return;
116         }
117
118         gconf_client_add_dir (conf,MODEST_CONF_NAMESPACE,
119                               GCONF_CLIENT_PRELOAD_NONE,
120                               &err);
121         if (err) {
122                 g_printerr ("modest: error %d with gconf_client_add_dir: '%s'\n",
123                             err->code, err->message);
124                 g_object_unref (conf);
125                 g_error_free (err);
126                 return;
127         }
128         
129         gconf_client_notify_add (conf, MODEST_CONF_NAMESPACE,
130                                  modest_conf_on_change,
131                                  obj, NULL, &err);
132         if (err) {
133                 g_printerr ("modest: gconf_client_notify_add error %d: '%s'\n",
134                             err->code, err->message);
135                 g_object_unref (conf);
136                 g_error_free (err);
137                 return;
138         }
139         
140         priv->gconf_client = conf;      /* all went well! */
141 }
142
143 static void
144 modest_conf_finalize (GObject *obj)
145 {
146         ModestConfPrivate *priv = MODEST_CONF_GET_PRIVATE(obj);
147         if (priv->gconf_client) {
148
149                 gconf_client_suggest_sync (priv->gconf_client, NULL);
150
151                 g_object_unref (priv->gconf_client);
152                 priv->gconf_client = NULL;
153         }       
154
155         G_OBJECT_CLASS(parent_class)->finalize (obj);
156 }
157
158 ModestConf*
159 modest_conf_new (void)
160 {
161         ModestConf *conf;
162         ModestConfPrivate *priv;
163         
164         conf = MODEST_CONF(g_object_new(MODEST_TYPE_CONF, NULL));
165         if (!conf) {
166                 g_printerr ("modest: failed to init ModestConf (GConf)\n");
167                 return NULL;
168         }
169
170         priv = MODEST_CONF_GET_PRIVATE(conf);
171         if (!priv->gconf_client) {
172                 g_printerr ("modest: failed to init gconf\n");
173                 g_object_unref (conf);
174                 return NULL;
175         }
176         
177         return conf;
178 }
179
180
181 gchar*
182 modest_conf_get_string (ModestConf* self, const gchar* key, GError **err)
183 {
184         ModestConfPrivate *priv;
185         
186         g_return_val_if_fail (self, NULL);
187         g_return_val_if_fail (key,  NULL);
188
189         priv = MODEST_CONF_GET_PRIVATE(self);
190         return gconf_client_get_string (priv->gconf_client, key, err);
191 }
192
193
194 gint
195 modest_conf_get_int (ModestConf* self, const gchar* key, GError **err)
196 {
197         ModestConfPrivate *priv;
198
199         g_return_val_if_fail (self, -1);
200         g_return_val_if_fail (key, -1);
201
202         priv = MODEST_CONF_GET_PRIVATE(self);
203         
204         return gconf_client_get_int (priv->gconf_client, key, err);
205 }
206
207
208 gboolean
209 modest_conf_get_bool (ModestConf* self, const gchar* key, GError **err)
210 {
211         ModestConfPrivate *priv;
212
213         g_return_val_if_fail (self, FALSE);
214         g_return_val_if_fail (key, FALSE);
215
216         priv = MODEST_CONF_GET_PRIVATE(self);
217         
218         return gconf_client_get_bool (priv->gconf_client, key, err);
219 }
220
221
222 GSList * 
223 modest_conf_get_list (ModestConf* self, const gchar* key, ModestConfValueType list_type,
224                       GError **err)
225 {
226        ModestConfPrivate *priv;
227        GConfValueType gconf_type;
228        
229        g_return_val_if_fail (self, NULL);
230        g_return_val_if_fail (key,  NULL);
231
232        priv = MODEST_CONF_GET_PRIVATE(self);
233
234        switch (list_type) {
235        case MODEST_CONF_VALUE_INT:
236                gconf_type = GCONF_VALUE_INT;
237                break;
238        case MODEST_CONF_VALUE_BOOL:
239                gconf_type = GCONF_VALUE_BOOL;
240                break;
241        case MODEST_CONF_VALUE_FLOAT:
242                gconf_type = GCONF_VALUE_FLOAT;
243                break;
244        case MODEST_CONF_VALUE_STRING:
245                gconf_type = GCONF_VALUE_STRING;
246                break;
247        default:
248                g_printerr ("modest: invalid list type %d requested\n", list_type);
249                /* FIXME: fill GError */
250                return NULL;
251        }
252        return gconf_client_get_list (priv->gconf_client, key, gconf_type, err);
253 }
254
255
256
257
258 gboolean
259 modest_conf_set_string (ModestConf* self, const gchar* key, const gchar* val,
260                         GError **err)
261 {
262         ModestConfPrivate *priv;
263                 
264         g_return_val_if_fail (self,FALSE);
265         g_return_val_if_fail (key, FALSE);
266         
267         priv = MODEST_CONF_GET_PRIVATE(self);
268
269         if (!gconf_client_key_is_writable(priv->gconf_client,key,err)) {
270                 g_printerr ("modest: '%s' is not writable\n", key);
271                 return FALSE;
272         }
273                         
274         return gconf_client_set_string (priv->gconf_client, key, val, err);     
275 }
276
277
278 gboolean
279 modest_conf_set_int  (ModestConf* self, const gchar* key, gint val,
280                       GError **err)
281 {
282         ModestConfPrivate *priv;
283                 
284         g_return_val_if_fail (self,FALSE);
285         g_return_val_if_fail (key, FALSE);
286         
287         priv = MODEST_CONF_GET_PRIVATE(self);
288
289         if (!gconf_client_key_is_writable(priv->gconf_client,key,err)) {
290                 g_printerr ("modest: '%s' is not writable\n", key);
291                 return FALSE;
292         }
293                         
294         return gconf_client_set_int (priv->gconf_client, key, val, err);        
295 }
296
297
298 gboolean
299 modest_conf_set_bool (ModestConf* self, const gchar* key, gboolean val,
300                       GError **err)
301 {
302         ModestConfPrivate *priv;
303                 
304         g_return_val_if_fail (self,FALSE);
305         g_return_val_if_fail (key, FALSE);
306         
307         priv = MODEST_CONF_GET_PRIVATE(self);
308
309         if (!gconf_client_key_is_writable(priv->gconf_client,key, err)) {
310                 g_warning ("modest: '%s' is not writable\n", key);
311                 return FALSE;
312         }
313                         
314         return gconf_client_set_bool (priv->gconf_client,key,val, err);
315 }
316
317
318
319
320 GSList*
321 modest_conf_list_subkeys (ModestConf* self, const gchar* key, GError **err)
322 {
323         ModestConfPrivate *priv;
324                 
325         g_return_val_if_fail (self,FALSE);
326         g_return_val_if_fail (key, FALSE);
327         
328         priv = MODEST_CONF_GET_PRIVATE(self);
329                         
330         return gconf_client_all_dirs (priv->gconf_client,key,err);
331 }
332
333
334 gboolean
335 modest_conf_remove_key (ModestConf* self, const gchar* key, GError **err)
336 {
337         ModestConfPrivate *priv;
338         gboolean retval;
339         
340         g_return_val_if_fail (self,FALSE);
341         g_return_val_if_fail (key, FALSE);
342         
343         priv = MODEST_CONF_GET_PRIVATE(self);
344                         
345         retval = gconf_client_recursive_unset (priv->gconf_client,key,0,err);
346         gconf_client_suggest_sync (priv->gconf_client, NULL);
347
348         return retval;
349 }
350
351
352 gboolean
353 modest_conf_key_exists (ModestConf* self, const gchar* key, GError **err)
354 {
355         ModestConfPrivate *priv;
356         GConfValue *val;
357
358         g_return_val_if_fail (self,FALSE);
359         g_return_val_if_fail (key, FALSE);
360         
361         priv = MODEST_CONF_GET_PRIVATE(self);
362
363         /* the fast way... */
364         if (gconf_client_dir_exists (priv->gconf_client,key,err))
365                 return TRUE;
366         
367         val = gconf_client_get (priv->gconf_client, key, NULL);
368         if (!val)
369                 return FALSE;
370         else {
371                 gconf_value_free (val);
372                 return TRUE;
373         }       
374 }
375
376
377 gchar*
378 modest_conf_key_escape (const gchar* key)
379 {
380         g_return_val_if_fail (key, NULL);
381
382         return gconf_escape_key (key, strlen(key));
383 }
384
385
386 gchar*
387 modest_conf_key_unescape (const gchar* key)
388 {
389         g_return_val_if_fail (key, NULL);
390
391         return gconf_unescape_key (key, strlen(key));
392 }
393
394
395
396 static void
397 modest_conf_on_change (GConfClient *client, guint conn_id, GConfEntry *entry,
398                        gpointer data)
399 {
400         ModestConfEvent event;
401         const gchar* key;
402
403         event = (entry->value) ? MODEST_CONF_EVENT_KEY_CHANGED : MODEST_CONF_EVENT_KEY_UNSET;
404         key    = gconf_entry_get_key (entry);
405
406         g_signal_emit (G_OBJECT(data),
407                        signals[KEY_CHANGED_SIGNAL], 0,
408                        key, event);
409 }
410