Coverage Report

Created: 2025-06-13 06:55

/src/glib/gio/gdbusactiongroup.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * Copyright © 2010 Codethink Limited
3
 * Copyright © 2011 Canonical Limited
4
 *
5
 * SPDX-License-Identifier: LGPL-2.1-or-later
6
 *
7
 * This library is free software; you can redistribute it and/or
8
 * modify it under the terms of the GNU Lesser General Public
9
 * License as published by the Free Software Foundation; either
10
 * version 2.1 of the License, or (at your option) any later version.
11
 *
12
 * This library is distributed in the hope that it will be useful,
13
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15
 * Lesser General Public License for more details.
16
 *
17
 * You should have received a copy of the GNU Lesser General
18
 * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
19
 *
20
 * Authors: Ryan Lortie <desrt@desrt.ca>
21
 */
22
23
#include "config.h"
24
25
#include "gdbusactiongroup-private.h"
26
27
#include "gremoteactiongroup.h"
28
#include "gdbusconnection.h"
29
#include "gactiongroup.h"
30
31
/**
32
 * SECTION:gdbusactiongroup
33
 * @title: GDBusActionGroup
34
 * @short_description: A D-Bus GActionGroup implementation
35
 * @include: gio/gio.h
36
 * @see_also: [GActionGroup exporter][gio-GActionGroup-exporter]
37
 *
38
 * #GDBusActionGroup is an implementation of the #GActionGroup
39
 * interface that can be used as a proxy for an action group
40
 * that is exported over D-Bus with g_dbus_connection_export_action_group().
41
 */
42
43
/**
44
 * GDBusActionGroup:
45
 *
46
 * #GDBusActionGroup is an opaque data structure and can only be accessed
47
 * using the following functions.
48
 */
49
50
struct _GDBusActionGroup
51
{
52
  GObject parent_instance;
53
54
  GDBusConnection *connection;
55
  gchar           *bus_name;
56
  gchar           *object_path;
57
  guint            subscription_id;
58
  GHashTable      *actions;
59
60
  /* The 'strict' flag indicates that the non-existence of at least one
61
   * action has potentially been observed through the API.  This means
62
   * that we should always emit 'action-added' signals for all new
63
   * actions.
64
   *
65
   * The user can observe the non-existence of an action by listing the
66
   * actions or by performing a query (such as parameter type) on a
67
   * non-existent action.
68
   *
69
   * If the user has no way of knowing that a given action didn't
70
   * already exist then we can skip emitting 'action-added' signals
71
   * since they have no way of knowing that it wasn't there from the
72
   * start.
73
   */
74
  gboolean         strict;
75
};
76
77
typedef GObjectClass GDBusActionGroupClass;
78
79
typedef struct
80
{
81
  gchar        *name;
82
  GVariantType *parameter_type;
83
  gboolean      enabled;
84
  GVariant     *state;
85
} ActionInfo;
86
87
static void
88
action_info_free (gpointer user_data)
89
0
{
90
0
  ActionInfo *info = user_data;
91
92
0
  g_free (info->name);
93
94
0
  if (info->state)
95
0
    g_variant_unref (info->state);
96
97
0
  if (info->parameter_type)
98
0
    g_variant_type_free (info->parameter_type);
99
100
0
  g_slice_free (ActionInfo, info);
101
0
}
102
103
static ActionInfo *
104
action_info_new_from_iter (GVariantIter *iter)
105
0
{
106
0
  const gchar *param_str;
107
0
  ActionInfo *info;
108
0
  gboolean enabled;
109
0
  GVariant *state;
110
0
  gchar *name;
111
112
0
  if (!g_variant_iter_next (iter, "{s(b&g@av)}", &name,
113
0
                            &enabled, &param_str, &state))
114
0
    return NULL;
115
116
0
  info = g_slice_new (ActionInfo);
117
0
  info->name = name;
118
0
  info->enabled = enabled;
119
120
0
  if (g_variant_n_children (state))
121
0
    g_variant_get_child (state, 0, "v", &info->state);
122
0
  else
123
0
    info->state = NULL;
124
0
  g_variant_unref (state);
125
126
0
  if (param_str[0])
127
0
    info->parameter_type = g_variant_type_copy ((GVariantType *) param_str);
128
0
  else
129
0
    info->parameter_type = NULL;
130
131
0
  return info;
132
0
}
133
134
static void g_dbus_action_group_remote_iface_init (GRemoteActionGroupInterface *iface);
135
static void g_dbus_action_group_iface_init        (GActionGroupInterface       *iface);
136
G_DEFINE_TYPE_WITH_CODE (GDBusActionGroup, g_dbus_action_group, G_TYPE_OBJECT,
137
  G_IMPLEMENT_INTERFACE (G_TYPE_ACTION_GROUP, g_dbus_action_group_iface_init)
138
  G_IMPLEMENT_INTERFACE (G_TYPE_REMOTE_ACTION_GROUP, g_dbus_action_group_remote_iface_init))
139
140
static void
141
g_dbus_action_group_changed (GDBusConnection *connection,
142
                             const gchar     *sender,
143
                             const gchar     *object_path,
144
                             const gchar     *interface_name,
145
                             const gchar     *signal_name,
146
                             GVariant        *parameters,
147
                             gpointer         user_data)
148
0
{
149
0
  GDBusActionGroup *group = user_data;
150
0
  GActionGroup *g_group = user_data;
151
152
  /* make sure that we've been fully initialised */
153
0
  if (group->actions == NULL)
154
0
    return;
155
156
0
  if (g_str_equal (signal_name, "Changed") &&
157
0
      g_variant_is_of_type (parameters, G_VARIANT_TYPE ("(asa{sb}a{sv}a{s(bgav)})")))
158
0
    {
159
      /* Removes */
160
0
      {
161
0
        GVariantIter *iter;
162
0
        const gchar *name;
163
164
0
        g_variant_get_child (parameters, 0, "as", &iter);
165
0
        while (g_variant_iter_next (iter, "&s", &name))
166
0
          {
167
0
            if (g_hash_table_lookup (group->actions, name))
168
0
              {
169
0
                g_hash_table_remove (group->actions, name);
170
0
                g_action_group_action_removed (g_group, name);
171
0
              }
172
0
          }
173
0
        g_variant_iter_free (iter);
174
0
      }
175
176
      /* Enable changes */
177
0
      {
178
0
        GVariantIter *iter;
179
0
        const gchar *name;
180
0
        gboolean enabled;
181
182
0
        g_variant_get_child (parameters, 1, "a{sb}", &iter);
183
0
        while (g_variant_iter_next (iter, "{&sb}", &name, &enabled))
184
0
          {
185
0
            ActionInfo *info;
186
187
0
            info = g_hash_table_lookup (group->actions, name);
188
189
0
            if (info && info->enabled != enabled)
190
0
              {
191
0
                info->enabled = enabled;
192
0
                g_action_group_action_enabled_changed (g_group, name, enabled);
193
0
              }
194
0
          }
195
0
        g_variant_iter_free (iter);
196
0
      }
197
198
      /* State changes */
199
0
      {
200
0
        GVariantIter *iter;
201
0
        const gchar *name;
202
0
        GVariant *state;
203
204
0
        g_variant_get_child (parameters, 2, "a{sv}", &iter);
205
0
        while (g_variant_iter_next (iter, "{&sv}", &name, &state))
206
0
          {
207
0
            ActionInfo *info;
208
209
0
            info = g_hash_table_lookup (group->actions, name);
210
211
0
            if (info && info->state && !g_variant_equal (state, info->state) &&
212
0
                g_variant_is_of_type (state, g_variant_get_type (info->state)))
213
0
              {
214
0
                g_variant_unref (info->state);
215
0
                info->state = g_variant_ref (state);
216
217
0
                g_action_group_action_state_changed (g_group, name, state);
218
0
              }
219
220
0
            g_variant_unref (state);
221
0
          }
222
0
        g_variant_iter_free (iter);
223
0
      }
224
225
      /* Additions */
226
0
      {
227
0
        GVariantIter *iter;
228
0
        ActionInfo *info;
229
230
0
        g_variant_get_child (parameters, 3, "a{s(bgav)}", &iter);
231
0
        while ((info = action_info_new_from_iter (iter)))
232
0
          {
233
0
            if (!g_hash_table_lookup (group->actions, info->name))
234
0
              {
235
0
                g_hash_table_insert (group->actions, info->name, info);
236
237
0
                if (group->strict)
238
0
                  g_action_group_action_added (g_group, info->name);
239
0
              }
240
0
            else
241
0
              action_info_free (info);
242
0
          }
243
0
        g_variant_iter_free (iter);
244
0
      }
245
0
    }
246
0
}
247
248
249
static void
250
g_dbus_action_group_describe_all_done (GObject      *source,
251
                                       GAsyncResult *result,
252
                                       gpointer      user_data)
253
0
{
254
0
  GDBusActionGroup *group= user_data;
255
0
  GVariant *reply;
256
257
0
  g_assert (group->actions == NULL);
258
0
  group->actions = g_hash_table_new_full (g_str_hash, g_str_equal, NULL, action_info_free);
259
260
0
  g_assert (group->connection == (gpointer) source);
261
0
  reply = g_dbus_connection_call_finish (group->connection, result, NULL);
262
263
0
  if (reply != NULL)
264
0
    {
265
0
      GVariantIter *iter;
266
0
      ActionInfo *action;
267
268
0
      g_variant_get (reply, "(a{s(bgav)})", &iter);
269
0
      while ((action = action_info_new_from_iter (iter)))
270
0
        {
271
0
          g_hash_table_insert (group->actions, action->name, action);
272
273
0
          if (group->strict)
274
0
            g_action_group_action_added (G_ACTION_GROUP (group), action->name);
275
0
        }
276
0
      g_variant_iter_free (iter);
277
0
      g_variant_unref (reply);
278
0
    }
279
280
0
  g_object_unref (group);
281
0
}
282
283
284
static void
285
g_dbus_action_group_async_init (GDBusActionGroup *group)
286
0
{
287
0
  if (group->subscription_id != 0)
288
0
    return;
289
290
0
  group->subscription_id =
291
0
    g_dbus_connection_signal_subscribe (group->connection, group->bus_name, "org.gtk.Actions", "Changed", group->object_path,
292
0
                                        NULL, G_DBUS_SIGNAL_FLAGS_NONE, g_dbus_action_group_changed, group, NULL);
293
294
0
  g_dbus_connection_call (group->connection, group->bus_name, group->object_path, "org.gtk.Actions", "DescribeAll", NULL,
295
0
                          G_VARIANT_TYPE ("(a{s(bgav)})"), G_DBUS_CALL_FLAGS_NONE, -1, NULL,
296
0
                          g_dbus_action_group_describe_all_done, g_object_ref (group));
297
0
}
298
299
static gchar **
300
g_dbus_action_group_list_actions (GActionGroup *g_group)
301
0
{
302
0
  GDBusActionGroup *group = G_DBUS_ACTION_GROUP (g_group);
303
0
  gchar **keys;
304
305
0
  if (group->actions != NULL)
306
0
    {
307
0
      GHashTableIter iter;
308
0
      gint n, i = 0;
309
0
      gpointer key;
310
311
0
      n = g_hash_table_size (group->actions);
312
0
      keys = g_new (gchar *, n + 1);
313
314
0
      g_hash_table_iter_init (&iter, group->actions);
315
0
      while (g_hash_table_iter_next (&iter, &key, NULL))
316
0
        keys[i++] = g_strdup (key);
317
0
      g_assert_cmpint (i, ==, n);
318
0
      keys[n] = NULL;
319
0
    }
320
0
  else
321
0
    {
322
0
      g_dbus_action_group_async_init (group);
323
0
      keys = g_new0 (gchar *, 1);
324
0
    }
325
326
0
  group->strict = TRUE;
327
328
0
  return keys;
329
0
}
330
331
static gboolean
332
g_dbus_action_group_query_action (GActionGroup        *g_group,
333
                                  const gchar         *action_name,
334
                                  gboolean            *enabled,
335
                                  const GVariantType **parameter_type,
336
                                  const GVariantType **state_type,
337
                                  GVariant           **state_hint,
338
                                  GVariant           **state)
339
0
{
340
0
  GDBusActionGroup *group = G_DBUS_ACTION_GROUP (g_group);
341
0
  ActionInfo *info;
342
343
0
  if (group->actions != NULL)
344
0
    {
345
0
      info = g_hash_table_lookup (group->actions, action_name);
346
347
0
      if (info == NULL)
348
0
        {
349
0
          group->strict = TRUE;
350
0
          return FALSE;
351
0
        }
352
353
0
      if (enabled)
354
0
        *enabled = info->enabled;
355
356
0
      if (parameter_type)
357
0
        *parameter_type = info->parameter_type;
358
359
0
      if (state_type)
360
0
        *state_type = info->state ? g_variant_get_type (info->state) : NULL;
361
362
0
      if (state_hint)
363
0
        *state_hint = NULL;
364
365
0
      if (state)
366
0
        *state = info->state ? g_variant_ref (info->state) : NULL;
367
368
0
      return TRUE;
369
0
    }
370
0
  else
371
0
    {
372
0
      g_dbus_action_group_async_init (group);
373
0
      group->strict = TRUE;
374
375
0
      return FALSE;
376
0
    }
377
0
}
378
379
static void
380
g_dbus_action_group_activate_action_full (GRemoteActionGroup *remote,
381
                                          const gchar        *action_name,
382
                                          GVariant           *parameter,
383
                                          GVariant           *platform_data)
384
0
{
385
0
  GDBusActionGroup *group = G_DBUS_ACTION_GROUP (remote);
386
0
  GVariantBuilder builder;
387
388
0
  g_variant_builder_init (&builder, G_VARIANT_TYPE ("av"));
389
390
0
  if (parameter)
391
0
    g_variant_builder_add (&builder, "v", parameter);
392
393
0
  g_dbus_connection_call (group->connection, group->bus_name, group->object_path, "org.gtk.Actions", "Activate",
394
0
                          g_variant_new ("(sav@a{sv})", action_name, &builder, platform_data),
395
0
                          NULL, G_DBUS_CALL_FLAGS_NONE, -1, NULL, NULL, NULL);
396
0
}
397
398
static void
399
g_dbus_action_group_change_action_state_full (GRemoteActionGroup *remote,
400
                                              const gchar        *action_name,
401
                                              GVariant           *value,
402
                                              GVariant           *platform_data)
403
0
{
404
0
  GDBusActionGroup *group = G_DBUS_ACTION_GROUP (remote);
405
406
0
  g_dbus_connection_call (group->connection, group->bus_name, group->object_path, "org.gtk.Actions", "SetState",
407
0
                          g_variant_new ("(sv@a{sv})", action_name, value, platform_data),
408
0
                          NULL, G_DBUS_CALL_FLAGS_NONE, -1, NULL, NULL, NULL);
409
0
}
410
411
static void
412
g_dbus_action_group_change_state (GActionGroup *group,
413
                                  const gchar  *action_name,
414
                                  GVariant     *value)
415
0
{
416
0
  g_dbus_action_group_change_action_state_full (G_REMOTE_ACTION_GROUP (group),
417
0
                                                action_name, value, g_variant_new ("a{sv}", NULL));
418
0
}
419
420
static void
421
g_dbus_action_group_activate (GActionGroup *group,
422
                              const gchar  *action_name,
423
                              GVariant     *parameter)
424
0
{
425
0
  g_dbus_action_group_activate_action_full (G_REMOTE_ACTION_GROUP (group),
426
0
                                            action_name, parameter, g_variant_new ("a{sv}", NULL));
427
0
}
428
429
static void
430
g_dbus_action_group_finalize (GObject *object)
431
0
{
432
0
  GDBusActionGroup *group = G_DBUS_ACTION_GROUP (object);
433
434
0
  if (group->subscription_id)
435
0
    g_dbus_connection_signal_unsubscribe (group->connection, group->subscription_id);
436
437
0
  if (group->actions)
438
0
    g_hash_table_unref (group->actions);
439
440
0
  g_object_unref (group->connection);
441
0
  g_free (group->object_path);
442
0
  g_free (group->bus_name);
443
444
0
  G_OBJECT_CLASS (g_dbus_action_group_parent_class)
445
0
    ->finalize (object);
446
0
}
447
448
static void
449
g_dbus_action_group_init (GDBusActionGroup *group)
450
0
{
451
0
}
452
453
static void
454
g_dbus_action_group_class_init (GDBusActionGroupClass *class)
455
0
{
456
0
  GObjectClass *object_class = G_OBJECT_CLASS (class);
457
458
0
  object_class->finalize = g_dbus_action_group_finalize;
459
0
}
460
461
static void
462
g_dbus_action_group_remote_iface_init (GRemoteActionGroupInterface *iface)
463
0
{
464
0
  iface->activate_action_full = g_dbus_action_group_activate_action_full;
465
0
  iface->change_action_state_full = g_dbus_action_group_change_action_state_full;
466
0
}
467
468
static void
469
g_dbus_action_group_iface_init (GActionGroupInterface *iface)
470
0
{
471
0
  iface->list_actions = g_dbus_action_group_list_actions;
472
0
  iface->query_action = g_dbus_action_group_query_action;
473
0
  iface->change_action_state = g_dbus_action_group_change_state;
474
0
  iface->activate_action = g_dbus_action_group_activate;
475
0
}
476
477
/**
478
 * g_dbus_action_group_get:
479
 * @connection: A #GDBusConnection
480
 * @bus_name: (nullable): the bus name which exports the action
481
 *     group or %NULL if @connection is not a message bus connection
482
 * @object_path: the object path at which the action group is exported
483
 *
484
 * Obtains a #GDBusActionGroup for the action group which is exported at
485
 * the given @bus_name and @object_path.
486
 *
487
 * The thread default main context is taken at the time of this call.
488
 * All signals on the menu model (and any linked models) are reported
489
 * with respect to this context.  All calls on the returned menu model
490
 * (and linked models) must also originate from this same context, with
491
 * the thread default main context unchanged.
492
 *
493
 * This call is non-blocking.  The returned action group may or may not
494
 * already be filled in.  The correct thing to do is connect the signals
495
 * for the action group to monitor for changes and then to call
496
 * g_action_group_list_actions() to get the initial list.
497
 *
498
 * Returns: (transfer full): a #GDBusActionGroup
499
 *
500
 * Since: 2.32
501
 */
502
GDBusActionGroup *
503
g_dbus_action_group_get (GDBusConnection *connection,
504
                         const gchar     *bus_name,
505
                         const gchar     *object_path)
506
0
{
507
0
  GDBusActionGroup *group;
508
509
0
  g_return_val_if_fail (bus_name != NULL || g_dbus_connection_get_unique_name (connection) == NULL, NULL);
510
511
0
  group = g_object_new (G_TYPE_DBUS_ACTION_GROUP, NULL);
512
0
  group->connection = g_object_ref (connection);
513
0
  group->bus_name = g_strdup (bus_name);
514
0
  group->object_path = g_strdup (object_path);
515
516
0
  return group;
517
0
}
518
519
gboolean
520
g_dbus_action_group_sync (GDBusActionGroup  *group,
521
                          GCancellable      *cancellable,
522
                          GError           **error)
523
0
{
524
0
  GVariant *reply;
525
526
0
  g_assert (group->subscription_id == 0);
527
528
0
  group->subscription_id =
529
0
    g_dbus_connection_signal_subscribe (group->connection, group->bus_name, "org.gtk.Actions", "Changed", group->object_path,
530
0
                                        NULL, G_DBUS_SIGNAL_FLAGS_NONE, g_dbus_action_group_changed, group, NULL);
531
532
0
  reply = g_dbus_connection_call_sync (group->connection, group->bus_name, group->object_path, "org.gtk.Actions",
533
0
                                       "DescribeAll", NULL, G_VARIANT_TYPE ("(a{s(bgav)})"),
534
0
                                       G_DBUS_CALL_FLAGS_NONE, -1, cancellable, error);
535
536
0
  if (reply != NULL)
537
0
    {
538
0
      GVariantIter *iter;
539
0
      ActionInfo *action;
540
541
0
      g_assert (group->actions == NULL);
542
0
      group->actions = g_hash_table_new_full (g_str_hash, g_str_equal, NULL, action_info_free);
543
544
0
      g_variant_get (reply, "(a{s(bgav)})", &iter);
545
0
      while ((action = action_info_new_from_iter (iter)))
546
0
        g_hash_table_insert (group->actions, action->name, action);
547
0
      g_variant_iter_free (iter);
548
0
      g_variant_unref (reply);
549
0
    }
550
551
0
  return reply != NULL;
552
0
}