2 * Copyright © 2010 Codethink Limited
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the licence, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
19 * Author: Ryan Lortie <desrt@desrt.ca>
31 contained (const gchar * const *items,
35 if (strcmp (*items++, item) == 0)
42 is_schema (const gchar *schema)
44 return contained (g_settings_list_schemas (), schema);
48 is_relocatable_schema (const gchar *schema)
50 return contained (g_settings_list_relocatable_schemas (), schema);
54 check_relocatable_schema (const gchar *schema)
56 if (is_relocatable_schema (schema))
59 if (is_schema (schema))
60 g_printerr (_("Schema '%s' is not relocatable "
61 "(path must not be specified)\n"),
65 g_printerr (_("No such schema '%s'\n"), schema);
71 check_schema (const gchar *schema)
73 if (is_schema (schema))
76 if (is_relocatable_schema (schema))
77 g_printerr (_("Schema '%s' is relocatable "
78 "(path must be specified)\n"),
82 g_printerr (_("No such schema '%s'\n"), schema);
88 check_path (const gchar *path)
92 g_printerr (_("Empty path given.\n"));
98 g_printerr (_("Path must begin with a slash (/)\n"));
102 if (!g_str_has_suffix (path, "/"))
104 g_printerr (_("Path must end with a slash (/)\n"));
108 if (strstr (path, "//"))
110 g_printerr (_("Path must not contain two adjacent slashes (//)\n"));
118 check_key (GSettings *settings,
124 keys = g_settings_list_keys (settings);
125 good = contained ((const gchar **) keys, key);
131 g_printerr (_("No such key '%s'\n"), key);
137 output_list (const gchar * const *list)
141 for (i = 0; list[i]; i++)
142 g_print ("%s\n", list[i]);
146 gsettings_list_schemas (GSettings *settings,
150 output_list (g_settings_list_schemas ());
154 gsettings_list_relocatable_schemas (GSettings *settings,
158 output_list (g_settings_list_relocatable_schemas ());
162 gsettings_list_keys (GSettings *settings,
168 keys = g_settings_list_keys (settings);
169 output_list ((const gchar **) keys);
174 gsettings_list_children (GSettings *settings,
182 children = g_settings_list_children (settings);
183 for (i = 0; children[i]; i++)
184 if (strlen (children[i]) > max)
185 max = strlen (children[i]);
187 for (i = 0; children[i]; i++)
193 child = g_settings_get_child (settings, children[i]);
199 if (is_schema (schema))
200 g_print ("%-*s %s\n", max, children[i], schema);
202 g_print ("%-*s %s:%s\n", max, children[i], schema, path);
204 g_object_unref (child);
209 g_strfreev (children);
213 enumerate (GSettings *settings)
219 g_object_get (settings, "schema", &schema, NULL);
221 keys = g_settings_list_keys (settings);
222 for (i = 0; keys[i]; i++)
227 value = g_settings_get_value (settings, keys[i]);
228 printed = g_variant_print (value, TRUE);
229 g_print ("%s %s %s\n", schema, keys[i], printed);
230 g_variant_unref (value);
239 gsettings_list_recursively (GSettings *settings,
246 enumerate (settings);
248 children = g_settings_list_children (settings);
250 for (i = 0; children[i]; i++)
255 child = g_settings_get_child (settings, children[i]);
256 g_object_get (child, "schema", &schema, NULL);
258 if (is_schema (schema))
261 g_object_unref (child);
265 g_strfreev (children);
269 gsettings_range (GSettings *settings,
273 GVariant *range, *detail;
276 range = g_settings_get_range (settings, key);
277 g_variant_get (range, "(&sv)", &type, &detail);
279 if (strcmp (type, "type") == 0)
280 g_print ("type %s\n", g_variant_get_type_string (detail) + 1);
282 else if (strcmp (type, "range") == 0)
287 g_variant_get (detail, "(**)", &min, &max);
288 smin = g_variant_print (min, FALSE);
289 smax = g_variant_print (max, FALSE);
291 g_print ("range %s %s %s\n",
292 g_variant_get_type_string (min), smin, smax);
293 g_variant_unref (min);
294 g_variant_unref (max);
299 else if (strcmp (type, "enum") == 0 || strcmp (type, "flags") == 0)
304 g_print ("%s\n", type);
306 g_variant_iter_init (&iter, detail);
307 while (g_variant_iter_loop (&iter, "*", &item))
311 printed = g_variant_print (item, FALSE);
312 g_print ("%s\n", printed);
317 g_variant_unref (detail);
318 g_variant_unref (range);
322 gsettings_get (GSettings *settings,
329 value = g_settings_get_value (settings, key);
330 printed = g_variant_print (value, TRUE);
331 g_print ("%s\n", printed);
332 g_variant_unref (value);
337 gsettings_reset (GSettings *settings,
341 g_settings_reset (settings, key);
346 gsettings_writable (GSettings *settings,
351 g_settings_is_writable (settings, key) ?
356 value_changed (GSettings *settings,
363 value = g_settings_get_value (settings, key);
364 printed = g_variant_print (value, TRUE);
365 g_print ("%s: %s\n", key, printed);
366 g_variant_unref (value);
371 gsettings_monitor (GSettings *settings,
379 name = g_strdup_printf ("changed::%s", key);
380 g_signal_connect (settings, name, G_CALLBACK (value_changed), NULL);
383 g_signal_connect (settings, "changed", G_CALLBACK (value_changed), NULL);
385 g_main_loop_run (g_main_loop_new (NULL, FALSE));
389 gsettings_set (GSettings *settings,
393 const GVariantType *type;
394 GError *error = NULL;
397 gchar *freeme = NULL;
399 existing = g_settings_get_value (settings, key);
400 type = g_variant_get_type (existing);
402 new = g_variant_parse (type, value, NULL, NULL, &error);
404 /* A common error is to specify a string with single quotes
405 * (or use completion for that), and forget that the shell
406 * will eat one level of quoting, resulting in 'unknown keyword'
407 * error from the gvariant parser.
408 * To handle this case, try to parse again with an extra level
412 g_error_matches (error, G_VARIANT_PARSE_ERROR,
413 G_VARIANT_PARSE_ERROR_UNKNOWN_KEYWORD))
415 value = freeme = g_strdup_printf ("\"%s\"", value);
416 new = g_variant_parse (type, value, NULL, NULL, NULL);
418 g_clear_error (&error);
423 g_printerr ("%s\n", error->message);
427 if (!g_settings_range_check (settings, key, new))
429 g_printerr (_("The provided value is outside of the valid range\n"));
430 g_variant_unref (new);
434 g_settings_set_value (settings, key, new);
435 g_variant_unref (existing);
436 g_variant_unref (new);
444 gsettings_help (gboolean requested,
445 const gchar *command)
447 const gchar *description;
448 const gchar *synopsis;
451 string = g_string_new (NULL);
456 else if (strcmp (command, "help") == 0)
458 description = _("Print help");
459 synopsis = "[COMMAND]";
462 else if (strcmp (command, "list-schemas") == 0)
464 description = _("List the installed (non-relocatable) schemas");
468 else if (strcmp (command, "list-relocatable-schemas") == 0)
470 description = _("List the installed relocatable schemas");
474 else if (strcmp (command, "list-keys") == 0)
476 description = _("List the keys in SCHEMA");
477 synopsis = N_("SCHEMA[:PATH]");
480 else if (strcmp (command, "list-children") == 0)
482 description = _("List the children of SCHEMA");
483 synopsis = N_("SCHEMA[:PATH]");
486 else if (strcmp (command, "list-recursively") == 0)
488 description = _("List keys and values, recursively");
489 synopsis = N_("SCHEMA[:PATH]");
492 else if (strcmp (command, "get") == 0)
494 description = _("Get the value of KEY");
495 synopsis = N_("SCHEMA[:PATH] KEY");
498 else if (strcmp (command, "range") == 0)
500 description = _("Query the range of valid values for KEY");
501 synopsis = N_("SCHEMA[:PATH] KEY");
504 else if (strcmp (command, "set") == 0)
506 description = _("Set the value of KEY to VALUE");
507 synopsis = N_("SCHEMA[:PATH] KEY VALUE");
510 else if (strcmp (command, "reset") == 0)
512 description = _("Reset KEY to its default value");
513 synopsis = N_("SCHEMA[:PATH] KEY");
516 else if (strcmp (command, "writable") == 0)
518 description = _("Check if KEY is writable");
519 synopsis = N_("SCHEMA[:PATH] KEY");
522 else if (strcmp (command, "monitor") == 0)
524 description = _("Monitor KEY for changes.\n"
525 "If no KEY is specified, monitor all keys in SCHEMA.\n"
526 "Use ^C to stop monitoring.\n");
527 synopsis = N_("SCHEMA[:PATH] [KEY]");
531 g_string_printf (string, _("Unknown command %s\n\n"), command);
538 g_string_append (string,
540 " gsettings COMMAND [ARGS...]\n"
543 " help Show this information\n"
544 " list-schemas List installed schemas\n"
545 " list-relocatable-schemas List relocatable schemas\n"
546 " list-keys List keys in a schema\n"
547 " list-children List children of a schema\n"
548 " list-recursively List keys and values, recursively\n"
549 " range Queries the range of a key\n"
550 " get Get the value of a key\n"
551 " set Set the value of a key\n"
552 " reset Reset the value of a key\n"
553 " writable Check if a key is writable\n"
554 " monitor Watch for changes\n"
556 "Use 'gsettings help COMMAND' to get detailed help.\n\n"));
560 g_string_append_printf (string, _("Usage:\n gsettings %s %s\n\n%s\n\n"),
561 command, synopsis[0] ? _(synopsis) : "", description);
565 g_string_append (string, _("Arguments:\n"));
567 if (strstr (synopsis, "[COMMAND]"))
568 g_string_append (string,
569 _(" COMMAND The (optional) command to explain\n"));
571 else if (strstr (synopsis, "SCHEMA"))
572 g_string_append (string,
573 _(" SCHEMA The name of the schema\n"
574 " PATH The path, for relocatable schemas\n"));
576 if (strstr (synopsis, "[KEY]"))
577 g_string_append (string,
578 _(" KEY The (optional) key within the schema\n"));
580 else if (strstr (synopsis, "KEY"))
581 g_string_append (string,
582 _(" KEY The key within the schema\n"));
584 if (strstr (synopsis, "VALUE"))
585 g_string_append (string,
586 _(" VALUE The value to set\n"));
588 g_string_append (string, "\n");
593 g_print ("%s", string->str);
595 g_printerr ("%s\n", string->str);
597 g_string_free (string, TRUE);
599 return requested ? 0 : 1;
604 main (int argc, char **argv)
606 void (* function) (GSettings *, const gchar *, const gchar *);
610 setlocale (LC_ALL, "");
611 textdomain (GETTEXT_PACKAGE);
614 gchar *tmp = _glib_get_locale_dir ();
615 bindtextdomain (GETTEXT_PACKAGE, tmp);
618 bindtextdomain (GETTEXT_PACKAGE, GLIB_LOCALE_DIR);
621 #ifdef HAVE_BIND_TEXTDOMAIN_CODESET
622 bind_textdomain_codeset (GETTEXT_PACKAGE, "UTF-8");
626 return gsettings_help (FALSE, NULL);
628 else if (strcmp (argv[1], "help") == 0)
629 return gsettings_help (TRUE, argv[2]);
631 else if (argc == 2 && strcmp (argv[1], "list-schemas") == 0)
632 function = gsettings_list_schemas;
634 else if (argc == 2 && strcmp (argv[1], "list-relocatable-schemas") == 0)
635 function = gsettings_list_relocatable_schemas;
637 else if (argc == 3 && strcmp (argv[1], "list-keys") == 0)
638 function = gsettings_list_keys;
640 else if (argc == 3 && strcmp (argv[1], "list-children") == 0)
641 function = gsettings_list_children;
643 else if (argc == 3 && strcmp (argv[1], "list-recursively") == 0)
644 function = gsettings_list_recursively;
646 else if (argc == 4 && strcmp (argv[1], "range") == 0)
647 function = gsettings_range;
649 else if (argc == 4 && strcmp (argv[1], "get") == 0)
650 function = gsettings_get;
652 else if (argc == 5 && strcmp (argv[1], "set") == 0)
653 function = gsettings_set;
655 else if (argc == 4 && strcmp (argv[1], "reset") == 0)
656 function = gsettings_reset;
658 else if (argc == 4 && strcmp (argv[1], "writable") == 0)
659 function = gsettings_writable;
661 else if ((argc == 3 || argc == 4) && strcmp (argv[1], "monitor") == 0)
662 function = gsettings_monitor;
665 return gsettings_help (FALSE, argv[1]);
673 if (argv[2][0] == '\0')
675 g_printerr (_("Empty schema name given\n"));
679 parts = g_strsplit (argv[2], ":", 2);
683 if (!check_relocatable_schema (parts[0]) || !check_path (parts[1]))
686 settings = g_settings_new_with_path (parts[0], parts[1]);
690 if (!check_schema (parts[0]))
693 settings = g_settings_new (parts[0]);
703 if (!check_key (settings, argv[3]))
711 (* function) (settings, key, argc > 4 ? argv[4] : NULL);
713 if (settings != NULL)
714 g_object_unref (settings);