1 /* -*- indent-tabs-mode: nil; tab-width: 4; c-basic-offset: 4; -*-
3 obt/link.c for the Openbox window manager
4 Copyright (c) 2009 Dana Jansens
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.
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.
16 See the COPYING file for a copy of the GNU General Public License.
20 #include "obt/ddparse.h"
21 #include "obt/paths.h"
28 gchar *name; /*!< Specific name for the object (eg Firefox) */
29 gboolean display; /*<! When false, do not display this link in menus or
31 gboolean deleted; /*<! When true, the Link could exist but is deleted
32 for the current user */
33 gchar *generic; /*!< Generic name for the object (eg Web Browser) */
34 gchar *comment; /*!< Comment/description to display for the object */
35 gchar *icon; /*!< Name/path for an icon for the object */
36 guint env_required; /*!< The environments that must be present to use this
38 guint env_restricted; /*!< The environments that must _not_ be present to
43 gchar *exec; /*!< Executable to run for the app */
44 gchar *wdir; /*!< Working dir to run the app in */
45 gboolean term; /*!< Run the app in a terminal or not */
48 /* XXX gchar**? or something better, a mime struct.. maybe
49 glib has something i can use. */
50 gchar **mime; /*!< Mime types the app can open */
52 GQuark *categories; /*!< Array of quarks representing the
53 application's categories */
55 ObtLinkAppStartup startup;
56 gchar *startup_wmclass;
66 ObtLink* obt_link_from_ddfile(const gchar *ddname, GSList *paths,
70 GHashTable *groups, *keys;
74 /* parse the file, and get a hash table of the groups */
75 groups = obt_ddparse_file(ddname, paths);
76 if (!groups) return NULL; /* parsing failed */
77 /* grab the Desktop Entry group */
78 g = g_hash_table_lookup(groups, "Desktop Entry");
80 /* grab the keys that appeared in the Desktop Entry group */
81 keys = obt_ddparse_group_keys(g);
83 /* build the ObtLink (we steal all strings from the parser) */
84 link = g_slice_new0(ObtLink);
88 v = g_hash_table_lookup(keys, "Type");
90 link->type = v->value.enumerable;
92 if ((v = g_hash_table_lookup(keys, "Hidden")))
93 link->deleted = v->value.boolean;
95 if ((v = g_hash_table_lookup(keys, "NoDisplay")))
96 link->display = !v->value.boolean;
98 if ((v = g_hash_table_lookup(keys, "GenericName")))
99 link->generic = v->value.string, v->value.string = NULL;
101 if ((v = g_hash_table_lookup(keys, "Comment")))
102 link->comment = v->value.string, v->value.string = NULL;
104 if ((v = g_hash_table_lookup(keys, "Icon")))
105 link->icon = v->value.string, v->value.string = NULL;
107 if ((v = g_hash_table_lookup(keys, "OnlyShowIn")))
108 link->env_required = v->value.environments;
110 link->env_required = 0;
112 if ((v = g_hash_table_lookup(keys, "NotShowIn")))
113 link->env_restricted = v->value.environments;
115 link->env_restricted = 0;
117 /* type-specific keys */
119 if (link->type == OBT_LINK_TYPE_APPLICATION) {
123 v = g_hash_table_lookup(keys, "Exec");
125 link->d.app.exec = v->value.string;
126 v->value.string = NULL;
128 /* parse link->d.app.exec to determine link->d.app.open */
130 for (c = link->d.app.exec; *c; ++c) {
131 if (*c == '%') percent = !percent;
134 case 'f': link->d.app.open = OBT_LINK_APP_SINGLE_LOCAL; break;
135 case 'F': link->d.app.open = OBT_LINK_APP_MULTI_LOCAL; break;
136 case 'u': link->d.app.open = OBT_LINK_APP_SINGLE_URL; break;
137 case 'U': link->d.app.open = OBT_LINK_APP_MULTI_URL; break;
142 if ((v = g_hash_table_lookup(keys, "TryExec"))) {
143 /* XXX spawn a thread to check TryExec? */
144 link->display = link->display &&
145 obt_paths_try_exec(p, v->value.string);
148 if ((v = g_hash_table_lookup(keys, "Path"))) {
149 /* steal the string */
150 link->d.app.wdir = v->value.string;
151 v->value.string = NULL;
154 if ((v = g_hash_table_lookup(keys, "Terminal")))
155 link->d.app.term = v->value.boolean;
157 if ((v = g_hash_table_lookup(keys, "StartupNotify")))
158 link->d.app.startup = v->value.boolean ?
159 OBT_LINK_APP_STARTUP_PROTOCOL_SUPPORT :
160 OBT_LINK_APP_STARTUP_NO_SUPPORT;
162 link->d.app.startup = OBT_LINK_APP_STARTUP_LEGACY_SUPPORT;
163 if ((v = g_hash_table_lookup(keys, "StartupWMClass"))) {
164 /* steal the string */
165 link->d.app.startup_wmclass = v->value.string;
166 v->value.string = NULL;
170 if ((v = g_hash_table_lookup(keys, "Categories"))) {
174 link->d.app.categories = g_new(GQuark, v->value.strings.n);
176 c = end = v->value.strings.s;
177 for (i = 0; i < v->value.strings.n; ++i) {
179 link->d.app.categories[i] = g_quark_from_string(c);
180 c = end = end+1; /* next */
184 /* XXX do something with mime types */
186 else if (link->type == OBT_LINK_TYPE_URL) {
187 v = g_hash_table_lookup(keys, "URL");
189 link->d.url.addr = v->value.string;
190 v->value.string = NULL;
193 /* destroy the parsing info */
194 g_hash_table_destroy(groups);
199 void obt_link_ref(ObtLink *dd)
204 void obt_link_unref(ObtLink *dd)
211 if (dd->type == OBT_LINK_TYPE_APPLICATION) {
212 g_free(dd->d.app.exec);
213 g_free(dd->d.app.wdir);
214 g_free(dd->d.app.categories);
215 g_free(dd->d.app.startup_wmclass);
217 else if (dd->type == OBT_LINK_TYPE_URL)
218 g_free(dd->d.url.addr);
219 g_slice_free(ObtLink, dd);