Adding upstream version 43.5.upstream/43.5upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 451 insertions, 0 deletions

diff --git a/src/gs-app-details-page.c b/src/gs-app-details-page.c
new file mode 100644
index 0000000..c224f2a
--- /dev/null
+++ b/src/gs-app-details-page.c
@@ -0,0 +1,451 @@
+/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*-
+ * vi:set noexpandtab tabstop=8 shiftwidth=8:
+ *
+ * Copyright (C) 2013-2016 Richard Hughes <richard@hughsie.com>
+ * Copyright (C) 2014-2018 Kalev Lember <klember@redhat.com>
+ * Copyright (C) 2021 Purism SPC
+ *
+ * SPDX-License-Identifier: GPL-2.0+
+ */
+
+/**
+ * SECTION:gs-app-details-page
+ * @title: GsAppDetailsPage
+ * @include: gnome-software.h
+ * @stability: Stable
+ * @short_description: A small page showing an application's details
+ *
+ * This is a page from #GsUpdateDialog.
+ */
+
+#include "config.h"
+
+#include <adwaita.h>
+#include <glib/gi18n.h>
+
+#include "gs-app-details-page.h"
+#include "gs-app-row.h"
+#include "gs-update-list.h"
+#include "gs-common.h"
+
+typedef enum {
+	PROP_APP = 1,
+	PROP_SHOW_BACK_BUTTON,
+	PROP_TITLE,
+} GsAppDetailsPageProperty;
+
+enum {
+	SIGNAL_BACK_CLICKED,
+	SIGNAL_LAST
+};
+
+static GParamSpec *obj_props[PROP_TITLE + 1] = { NULL, };
+
+static guint signals[SIGNAL_LAST] = { 0 };
+
+struct _GsAppDetailsPage
+{
+	GtkBox		 parent_instance;
+
+	GtkWidget	*back_button;
+	GtkWidget	*header_bar;
+	GtkWidget	*label_details;
+	GtkWidget	*permissions_section;
+	GtkWidget	*permissions_section_list;
+	GtkWidget	*status_page;
+	AdwWindowTitle	*window_title;
+
+	GsApp		*app;  /* (owned) (nullable) */
+};
+
+G_DEFINE_TYPE (GsAppDetailsPage, gs_app_details_page, GTK_TYPE_BOX)
+
+static const struct {
+        GsAppPermissionsFlags permission;
+        const char *title;
+        const char *subtitle;
+} permission_display_data[] = {
+  { GS_APP_PERMISSIONS_FLAGS_NETWORK, N_("Network"), N_("Can communicate over the network") },
+  { GS_APP_PERMISSIONS_FLAGS_SYSTEM_BUS, N_("System Services"), N_("Can access D-Bus services on the system bus") },
+  { GS_APP_PERMISSIONS_FLAGS_SESSION_BUS, N_("Session Services"), N_("Can access D-Bus services on the session bus") },
+  { GS_APP_PERMISSIONS_FLAGS_DEVICES, N_("Devices"), N_("Can access system device files") },
+  { GS_APP_PERMISSIONS_FLAGS_HOME_FULL, N_("Home folder"), N_("Can view, edit and create files") },
+  { GS_APP_PERMISSIONS_FLAGS_HOME_READ, N_("Home folder"), N_("Can view files") },
+  { GS_APP_PERMISSIONS_FLAGS_FILESYSTEM_FULL, N_("File system"), N_("Can view, edit and create files") },
+  { GS_APP_PERMISSIONS_FLAGS_FILESYSTEM_READ, N_("File system"), N_("Can view files") },
+  /* The GS_APP_PERMISSIONS_FLAGS_FILESYSTEM_OTHER is used only as a flag, with actual files being part of the read/full lists */
+  { GS_APP_PERMISSIONS_FLAGS_DOWNLOADS_FULL, N_("Downloads folder"), N_("Can view, edit and create files") },
+  { GS_APP_PERMISSIONS_FLAGS_DOWNLOADS_READ, N_("Downloads folder"), N_("Can view files") },
+  { GS_APP_PERMISSIONS_FLAGS_SETTINGS, N_("Settings"), N_("Can view and change any settings") },
+  { GS_APP_PERMISSIONS_FLAGS_X11, N_("Legacy display system"), N_("Uses an old, insecure display system") },
+  { GS_APP_PERMISSIONS_FLAGS_ESCAPE_SANDBOX, N_("Sandbox escape"), N_("Can escape the sandbox and circumvent any other restrictions") },
+};
+
+static void
+add_permissions_row (GsAppDetailsPage *page,
+		     const gchar *title,
+		     const gchar *subtitle,
+		     gboolean is_warning_row)
+{
+	GtkWidget *row, *image;
+
+	row = adw_action_row_new ();
+	if (is_warning_row)
+		gtk_style_context_add_class (gtk_widget_get_style_context (row), "permission-row-warning");
+
+	image = gtk_image_new_from_icon_name ("dialog-warning-symbolic");
+	if (!is_warning_row)
+		gtk_widget_set_opacity (image, 0);
+
+#if ADW_CHECK_VERSION(1,2,0)
+	adw_preferences_row_set_use_markup (ADW_PREFERENCES_ROW (row), FALSE);
+#endif
+	adw_action_row_add_prefix (ADW_ACTION_ROW (row), image);
+	adw_preferences_row_set_title (ADW_PREFERENCES_ROW (row), title);
+	adw_action_row_set_subtitle (ADW_ACTION_ROW (row), subtitle);
+
+	gtk_list_box_append (GTK_LIST_BOX (page->permissions_section_list), row);
+}
+
+static void
+populate_permissions_filesystem (GsAppDetailsPage *page,
+				 const GPtrArray *titles, /* (element-type utf-8) */
+				 const gchar *subtitle,
+				 gboolean is_warning_row)
+{
+	if (titles == NULL)
+		return;
+
+	for (guint i = 0; i < titles->len; i++) {
+		const gchar *title = g_ptr_array_index (titles, i);
+		add_permissions_row (page, title, subtitle, is_warning_row);
+	}
+}
+
+static void
+populate_permissions_section (GsAppDetailsPage *page,
+			      GsAppPermissions *permissions)
+{
+	GsAppPermissionsFlags flags = gs_app_permissions_get_flags (permissions);
+
+	gs_widget_remove_all (page->permissions_section_list, (GsRemoveFunc) gtk_list_box_remove);
+
+	for (gsize i = 0; i < G_N_ELEMENTS (permission_display_data); i++) {
+		if ((flags & permission_display_data[i].permission) == 0)
+			continue;
+
+		add_permissions_row (page,
+			_(permission_display_data[i].title),
+			_(permission_display_data[i].subtitle),
+			(permission_display_data[i].permission & ~MEDIUM_PERMISSIONS) != 0);
+	}
+
+	populate_permissions_filesystem (page,
+		gs_app_permissions_get_filesystem_read (permissions),
+		_("Can view files"),
+		(GS_APP_PERMISSIONS_FLAGS_FILESYSTEM_READ & ~MEDIUM_PERMISSIONS) != 0);
+
+	populate_permissions_filesystem (page,
+		gs_app_permissions_get_filesystem_full (permissions),
+		_("Can view, edit and create files"),
+		(GS_APP_PERMISSIONS_FLAGS_FILESYSTEM_FULL & ~MEDIUM_PERMISSIONS) != 0);
+}
+
+static void
+set_updates_description_ui (GsAppDetailsPage *page, GsApp *app)
+{
+	g_autoptr(GIcon) icon = NULL;
+	guint icon_size;
+	const gchar *update_details;
+	GdkDisplay *display;
+	g_autoptr (GtkIconPaintable) paintable = NULL;
+
+	/* FIXME support app == NULL */
+
+	/* set window title */
+	adw_window_title_set_title (page->window_title, _("Update Details"));
+	g_object_notify_by_pspec (G_OBJECT (page), obj_props[PROP_TITLE]);
+
+	/* set update header */
+	update_details = gs_app_get_update_details_markup (app);
+	if (update_details == NULL) {
+		/* TRANSLATORS: this is where the packager did not write
+		 * a description for the update */
+		update_details = _("No update description available.");
+	}
+	gtk_label_set_markup (GTK_LABEL (page->label_details), update_details);
+	adw_status_page_set_title (ADW_STATUS_PAGE (page->status_page), gs_app_get_name (app));
+	adw_status_page_set_description (ADW_STATUS_PAGE (page->status_page), gs_app_get_summary (app));
+
+	/* set the icon; fall back to 64px if 96px isn’t available, which sometimes
+	 * happens at 2× scale factor (hi-DPI) */
+	icon_size = 96;
+	icon = gs_app_get_icon_for_size (app,
+					 icon_size,
+					 gtk_widget_get_scale_factor (GTK_WIDGET (page)),
+					 NULL);
+	if (icon == NULL) {
+		icon_size = 64;
+		icon = gs_app_get_icon_for_size (app,
+						 icon_size,
+						 gtk_widget_get_scale_factor (GTK_WIDGET (page)),
+						 NULL);
+	}
+	if (icon == NULL) {
+		icon_size = 96;
+		icon = gs_app_get_icon_for_size (app,
+						 icon_size,
+						 gtk_widget_get_scale_factor (GTK_WIDGET (page)),
+						 "system-component-application");
+	}
+
+	display = gdk_display_get_default ();
+	paintable = gtk_icon_theme_lookup_by_gicon (gtk_icon_theme_get_for_display (display),
+						    icon,
+						    icon_size,
+						    gtk_widget_get_scale_factor (GTK_WIDGET (page)),
+						    gtk_widget_get_direction (GTK_WIDGET (page)),
+						    GTK_ICON_LOOKUP_FORCE_REGULAR);
+	adw_status_page_set_paintable (ADW_STATUS_PAGE (page->status_page), GDK_PAINTABLE (paintable));
+
+	if (gs_app_has_quirk (app, GS_APP_QUIRK_NEW_PERMISSIONS)) {
+		g_autoptr(GsAppPermissions) permissions = gs_app_dup_update_permissions (app);
+		gtk_widget_show (page->permissions_section);
+		populate_permissions_section (page, permissions);
+	} else {
+		gtk_widget_hide (page->permissions_section);
+	}
+}
+
+/**
+ * gs_app_details_page_get_app:
+ * @page: a #GsAppDetailsPage
+ *
+ * Get the value of #GsAppDetailsPage:app.
+ *
+ * Returns: (nullable) (transfer none): the app
+ *
+ * Since: 41
+ */
+GsApp *
+gs_app_details_page_get_app (GsAppDetailsPage *page)
+{
+	g_return_val_if_fail (GS_IS_APP_DETAILS_PAGE (page), NULL);
+	return page->app;
+}
+
+/**
+ * gs_app_details_page_set_app:
+ * @page: a #GsAppDetailsPage
+ * @app: (transfer none) (nullable): new app
+ *
+ * Set the value of #GsAppDetailsPage:app.
+ *
+ * Since: 41
+ */
+void
+gs_app_details_page_set_app (GsAppDetailsPage *page, GsApp *app)
+{
+	g_return_if_fail (GS_IS_APP_DETAILS_PAGE (page));
+	g_return_if_fail (!app || GS_IS_APP (app));
+
+	if (page->app == app)
+		return;
+
+	g_set_object (&page->app, app);
+
+	set_updates_description_ui (page, app);
+
+	g_object_notify_by_pspec (G_OBJECT (page), obj_props[PROP_APP]);
+}
+
+/**
+ * gs_app_details_page_get_show_back_button:
+ * @page: a #GsAppDetailsPage
+ *
+ * Get the value of #GsAppDetailsPage:show-back-button.
+ *
+ * Returns: whether to show the back button
+ *
+ * Since: 41
+ */
+gboolean
+gs_app_details_page_get_show_back_button (GsAppDetailsPage *page)
+{
+	g_return_val_if_fail (GS_IS_APP_DETAILS_PAGE (page), FALSE);
+	return gtk_widget_get_visible (page->back_button);
+}
+
+/**
+ * gs_app_details_page_set_show_back_button:
+ * @page: a #GsAppDetailsPage
+ * @show_back_button: whether to show the back button
+ *
+ * Set the value of #GsAppDetailsPage:show-back-button.
+ *
+ * Since: 41
+ */
+void
+gs_app_details_page_set_show_back_button (GsAppDetailsPage *page, gboolean show_back_button)
+{
+	g_return_if_fail (GS_IS_APP_DETAILS_PAGE (page));
+
+	show_back_button = !!show_back_button;
+
+	if (gtk_widget_get_visible (page->back_button) == show_back_button)
+		return;
+
+	gtk_widget_set_visible (page->back_button, show_back_button);
+
+	g_object_notify_by_pspec (G_OBJECT (page), obj_props[PROP_SHOW_BACK_BUTTON]);
+}
+
+static void
+back_clicked_cb (GtkWidget *widget, GsAppDetailsPage *page)
+{
+	g_signal_emit (page, signals[SIGNAL_BACK_CLICKED], 0);
+}
+
+static void
+gs_app_details_page_dispose (GObject *object)
+{
+	GsAppDetailsPage *page = GS_APP_DETAILS_PAGE (object);
+
+	g_clear_object (&page->app);
+
+	G_OBJECT_CLASS (gs_app_details_page_parent_class)->dispose (object);
+}
+
+static void
+gs_app_details_page_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec)
+{
+	GsAppDetailsPage *page = GS_APP_DETAILS_PAGE (object);
+
+	switch ((GsAppDetailsPageProperty) prop_id) {
+	case PROP_APP:
+		g_value_set_object (value, gs_app_details_page_get_app (page));
+		break;
+	case PROP_SHOW_BACK_BUTTON:
+		g_value_set_boolean (value, gs_app_details_page_get_show_back_button (page));
+		break;
+	case PROP_TITLE:
+		g_value_set_string (value, adw_window_title_get_title (page->window_title));
+		break;
+	default:
+		G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+		break;
+	}
+}
+
+static void
+gs_app_details_page_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec)
+{
+	GsAppDetailsPage *page = GS_APP_DETAILS_PAGE (object);
+
+	switch ((GsAppDetailsPageProperty) prop_id) {
+	case PROP_APP:
+		gs_app_details_page_set_app (page, g_value_get_object (value));
+		break;
+	case PROP_SHOW_BACK_BUTTON:
+		gs_app_details_page_set_show_back_button (page, g_value_get_boolean (value));
+		break;
+	default:
+		G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+		break;
+	}
+}
+
+static void
+gs_app_details_page_init (GsAppDetailsPage *page)
+{
+	gtk_widget_init_template (GTK_WIDGET (page));
+}
+
+static void
+gs_app_details_page_class_init (GsAppDetailsPageClass *klass)
+{
+	GObjectClass *object_class = G_OBJECT_CLASS (klass);
+	GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
+
+	object_class->dispose = gs_app_details_page_dispose;
+	object_class->get_property = gs_app_details_page_get_property;
+	object_class->set_property = gs_app_details_page_set_property;
+
+	/**
+	 * GsAppDetailsPage:app: (nullable)
+	 *
+	 * The app to present.
+	 *
+	 * Since: 41
+	 */
+	obj_props[PROP_APP] =
+		g_param_spec_object ("app", NULL, NULL,
+				     GS_TYPE_APP,
+				     G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_EXPLICIT_NOTIFY);
+
+	/**
+	 * GsAppDetailsPage:show-back-button
+	 *
+	 * Whether to show the back button.
+	 *
+	 * Since: 41
+	 */
+	obj_props[PROP_SHOW_BACK_BUTTON] =
+		g_param_spec_boolean ("show-back-button", NULL, NULL,
+				     TRUE,
+				     G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_EXPLICIT_NOTIFY);
+
+	/**
+	 * GsAppDetailsPage:title
+	 *
+	 * Read-only window title.
+	 *
+	 * Since: 42
+	 */
+	obj_props[PROP_TITLE] =
+		g_param_spec_string ("title", NULL, NULL,
+				     NULL,
+				     G_PARAM_READABLE | G_PARAM_STATIC_STRINGS | G_PARAM_EXPLICIT_NOTIFY);
+
+	g_object_class_install_properties (object_class, G_N_ELEMENTS (obj_props), obj_props);
+
+	/**
+	 * GsAppDetailsPage:back-clicked:
+	 * @app: a #GsApp
+	 *
+	 * Emitted when the back button got activated and the #GsUpdateDialog
+	 * containing this page is expected to go back.
+	 *
+	 * Since: 41
+	 */
+	signals[SIGNAL_BACK_CLICKED] =
+		g_signal_new ("back-clicked",
+			      G_TYPE_FROM_CLASS (object_class), G_SIGNAL_RUN_LAST,
+			      0, NULL, NULL, g_cclosure_marshal_generic,
+			      G_TYPE_NONE, 0);
+
+	gtk_widget_class_set_template_from_resource (widget_class, "/org/gnome/Software/gs-app-details-page.ui");
+
+	gtk_widget_class_bind_template_child (widget_class, GsAppDetailsPage, back_button);
+	gtk_widget_class_bind_template_child (widget_class, GsAppDetailsPage, header_bar);
+	gtk_widget_class_bind_template_child (widget_class, GsAppDetailsPage, label_details);
+	gtk_widget_class_bind_template_child (widget_class, GsAppDetailsPage, permissions_section);
+	gtk_widget_class_bind_template_child (widget_class, GsAppDetailsPage, permissions_section_list);
+	gtk_widget_class_bind_template_child (widget_class, GsAppDetailsPage, status_page);
+	gtk_widget_class_bind_template_child (widget_class, GsAppDetailsPage, window_title);
+	gtk_widget_class_bind_template_callback (widget_class, back_clicked_cb);
+}
+
+/**
+ * gs_app_details_page_new:
+ *
+ * Create a new #GsAppDetailsPage.
+ *
+ * Returns: (transfer full): a new #GsAppDetailsPage
+ * Since: 41
+ */
+GtkWidget *
+gs_app_details_page_new (void)
+{
+	return GTK_WIDGET (g_object_new (GS_TYPE_APP_DETAILS_PAGE, NULL));
+}