gplugin/gplugin
Clone
Summary
Browse
Changes
Graph
Update HACKING.OSX to detail how to get lgi to compile
19 months ago, Gary Kramlich
7ccf3db483d1
Update HACKING.OSX to detail how to get lgi to compile
Testing Done:
Made the change and say lua build on macOS
Reviewed at https://reviews.imfreedom.org/r/1844/
/*
* Copyright (C) 2022 Elliott Sales de Andrade <quantum.analyst@gmail.com>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, see <https://www.gnu.org/licenses/>.
*/
#include
<glib/gi18n-lib.h>
#include
<gplugin.h>
#include
<gplugin-gtk-plugin-closures.h>
#include
<gplugin-gtk-plugin-page.h>
/**
* GPluginGtkPluginPage:
*
* A widget that displays a single [iface@GPlugin.Plugin] in a user friendly
* way, intended to be placed in a [class@GPluginGtk4.View].
*
* Since: 0.39.0
*/
/******************************************************************************
* Structs
*****************************************************************************/
struct
_GPluginGtkPluginPage
{
GtkBox
parent
;
GPluginPlugin
*
plugin
;
};
/******************************************************************************
* Enums
*****************************************************************************/
enum
{
PROP_ZERO
,
PROP_PLUGIN
,
N_PROPERTIES
,
};
static
GParamSpec
*
properties
[
N_PROPERTIES
]
=
{
NULL
,
};
enum
{
SIG_PLUGIN_STATE_SET
,
N_SIGNALS
,
};
static
guint
signals
[
N_SIGNALS
]
=
{
0
,
};
/******************************************************************************
* Callbacks
*****************************************************************************/
static
gboolean
gplugin_gtk_plugin_page_enable_state_set_cb
(
G_GNUC_UNUSED
GtkSwitch
*
widget
,
gboolean
state
,
gpointer
data
)
{
GPluginGtkPluginPage
*
page
=
GPLUGIN_GTK_PLUGIN_PAGE
(
data
);
g_signal_emit
(
G_OBJECT
(
page
),
signals
[
SIG_PLUGIN_STATE_SET
],
0
,
state
);
return
TRUE
;
}
static
gchar
*
gplugin_gtk_plugin_page_newline_strjoinv_cb
(
G_GNUC_UNUSED
GtkClosureExpression
*
expression
,
gchar
**
str_array
,
G_GNUC_UNUSED
gpointer
data
)
{
if
(
str_array
==
NULL
)
{
return
g_strdup
(
_
(
"(none)"
));
}
return
g_strjoinv
(
"
\n
"
,
str_array
);
}
static
gchar
*
gplugin_gtk_plugin_page_lookup_website_cb
(
G_GNUC_UNUSED
GtkClosureExpression
*
expression
,
const
gchar
*
website
,
G_GNUC_UNUSED
gpointer
data
)
{
if
(
website
==
NULL
)
{
return
NULL
;
}
return
g_markup_printf_escaped
(
"<a href=
\"
%s
\"
>%s</a>"
,
website
,
website
);
}
static
gchar
*
gplugin_gtk_plugin_page_lookup_error_cb
(
G_GNUC_UNUSED
GtkClosureExpression
*
expression
,
GError
*
error
,
G_GNUC_UNUSED
gpointer
data
)
{
if
(
error
==
NULL
)
{
return
g_strdup
(
_
(
"(none)"
));
}
return
g_strdup
(
error
->
message
);
}
static
gchar
*
gplugin_gtk_plugin_page_lookup_abi_version_cb
(
G_GNUC_UNUSED
GtkClosureExpression
*
expression
,
guint32
abi_version
,
G_GNUC_UNUSED
gpointer
data
)
{
return
g_strdup_printf
(
"%08x"
,
abi_version
);
}
static
gchar
*
gplugin_gtk_plugin_page_lookup_loader_cb
(
G_GNUC_UNUSED
GtkClosureExpression
*
expression
,
GPluginPlugin
*
plugin
,
G_GNUC_UNUSED
gpointer
data
)
{
if
(
GPLUGIN_IS_PLUGIN
(
plugin
))
{
GPluginLoader
*
plugin_loader
=
gplugin_plugin_get_loader
(
plugin
);
if
(
GPLUGIN_IS_LOADER
(
plugin_loader
))
{
return
g_strdup
(
G_OBJECT_TYPE_NAME
(
plugin_loader
));
}
}
return
g_strdup
(
_
(
"Unknown"
));
}
/******************************************************************************
* GObject Implementation
*****************************************************************************/
G_DEFINE_TYPE
(
GPluginGtkPluginPage
,
gplugin_gtk_plugin_page
,
GTK_TYPE_BOX
)
static
void
gplugin_gtk_plugin_page_set_property
(
GObject
*
obj
,
guint
prop_id
,
const
GValue
*
value
,
GParamSpec
*
pspec
)
{
GPluginGtkPluginPage
*
page
=
GPLUGIN_GTK_PLUGIN_PAGE
(
obj
);
switch
(
prop_id
)
{
case
PROP_PLUGIN
:
gplugin_gtk_plugin_page_set_plugin
(
page
,
g_value_get_object
(
value
));
break
;
default
:
G_OBJECT_WARN_INVALID_PROPERTY_ID
(
obj
,
prop_id
,
pspec
);
break
;
}
}
static
void
gplugin_gtk_plugin_page_get_property
(
GObject
*
obj
,
guint
prop_id
,
GValue
*
value
,
GParamSpec
*
pspec
)
{
GPluginGtkPluginPage
*
page
=
GPLUGIN_GTK_PLUGIN_PAGE
(
obj
);
switch
(
prop_id
)
{
case
PROP_PLUGIN
:
g_value_set_object
(
value
,
gplugin_gtk_plugin_page_get_plugin
(
page
));
break
;
default
:
G_OBJECT_WARN_INVALID_PROPERTY_ID
(
obj
,
prop_id
,
pspec
);
break
;
}
}
static
void
gplugin_gtk_plugin_page_dispose
(
GObject
*
obj
)
{
GPluginGtkPluginPage
*
page
=
GPLUGIN_GTK_PLUGIN_PAGE
(
obj
);
g_clear_object
(
&
page
->
plugin
);
G_OBJECT_CLASS
(
gplugin_gtk_plugin_page_parent_class
)
->
dispose
(
obj
);
}
static
void
gplugin_gtk_plugin_page_init
(
GPluginGtkPluginPage
*
page
)
{
gtk_widget_init_template
(
GTK_WIDGET
(
page
));
}
static
void
gplugin_gtk_plugin_page_class_init
(
GPluginGtkPluginPageClass
*
klass
)
{
GtkWidgetClass
*
widget_class
=
GTK_WIDGET_CLASS
(
klass
);
GObjectClass
*
obj_class
=
G_OBJECT_CLASS
(
klass
);
obj_class
->
get_property
=
gplugin_gtk_plugin_page_get_property
;
obj_class
->
set_property
=
gplugin_gtk_plugin_page_set_property
;
obj_class
->
dispose
=
gplugin_gtk_plugin_page_dispose
;
/* properties */
/**
* GPluginGtkPluginPage:plugin:
*
* The [iface@GPlugin.Plugin] whose info should be displayed.
*
* Since: 0.39.0
*/
properties
[
PROP_PLUGIN
]
=
g_param_spec_object
(
"plugin"
,
"plugin"
,
"The GPluginPlugin whose info should be displayed"
,
G_TYPE_OBJECT
,
G_PARAM_READWRITE
|
G_PARAM_CONSTRUCT
|
G_PARAM_STATIC_STRINGS
);
g_object_class_install_properties
(
obj_class
,
N_PROPERTIES
,
properties
);
/* signals */
/**
* GPluginGtkPluginPage::plugin-state-set:
* @page: The [class@GPluginGtk.PluginPage] instance.
* @enabled: Whether the plugin was requested to be enabled or disabled.
*
* Emitted when the plugin page enable switch is toggled.
*
* Since: 0.39.0
*/
signals
[
SIG_PLUGIN_STATE_SET
]
=
g_signal_new_class_handler
(
"plugin-state-set"
,
G_OBJECT_CLASS_TYPE
(
klass
),
G_SIGNAL_RUN_LAST
,
NULL
,
NULL
,
NULL
,
NULL
,
G_TYPE_NONE
,
1
,
G_TYPE_BOOLEAN
);
/* template stuff */
gtk_widget_class_set_template_from_resource
(
widget_class
,
"/org/imfreedom/keep/gplugin/gplugin-gtk/plugin-page.ui"
);
gtk_widget_class_bind_template_callback
(
widget_class
,
gplugin_gtk_lookup_plugin_name
);
gtk_widget_class_bind_template_callback
(
widget_class
,
gplugin_gtk_lookup_plugin_state
);
gtk_widget_class_bind_template_callback
(
widget_class
,
gplugin_gtk_lookup_plugin_state_sensitivity
);
gtk_widget_class_bind_template_callback
(
widget_class
,
gplugin_gtk_plugin_page_enable_state_set_cb
);
gtk_widget_class_bind_template_callback
(
widget_class
,
gplugin_gtk_plugin_page_newline_strjoinv_cb
);
gtk_widget_class_bind_template_callback
(
widget_class
,
gplugin_gtk_plugin_page_lookup_website_cb
);
gtk_widget_class_bind_template_callback
(
widget_class
,
gplugin_gtk_plugin_page_lookup_error_cb
);
gtk_widget_class_bind_template_callback
(
widget_class
,
gplugin_gtk_plugin_page_lookup_abi_version_cb
);
gtk_widget_class_bind_template_callback
(
widget_class
,
gplugin_gtk_plugin_page_lookup_loader_cb
);
}
/******************************************************************************
* Public API
*****************************************************************************/
/**
* gplugin_gtk_plugin_page_new:
*
* Create a new [class@GPluginGtk4.PluginPage] which can be used to display
* info about a [iface@GPlugin.Plugin].
*
* Returns: (transfer full): The new widget.
*
* Since: 0.39.0
*/
GtkWidget
*
gplugin_gtk_plugin_page_new
(
void
)
{
return
g_object_new
(
GPLUGIN_GTK_TYPE_PLUGIN_PAGE
,
NULL
);
}
/**
* gplugin_gtk_plugin_page_set_plugin:
* @page: The plugin page instance.
* @plugin: (nullable): The plugin instance.
*
* Sets the [iface@GPlugin.Plugin] that should be displayed.
*
* A @plugin value of %NULL will clear the widget.
*
* Since: 0.39.0
*/
void
gplugin_gtk_plugin_page_set_plugin
(
GPluginGtkPluginPage
*
page
,
GPluginPlugin
*
plugin
)
{
g_return_if_fail
(
GPLUGIN_GTK_IS_PLUGIN_PAGE
(
page
));
if
(
g_set_object
(
&
page
->
plugin
,
plugin
))
{
g_object_notify_by_pspec
(
G_OBJECT
(
page
),
properties
[
PROP_PLUGIN
]);
}
}
/**
* gplugin_gtk_plugin_page_get_plugin:
* @page: The plugin page instance.
*
* Gets the [iface@GPlugin.Plugin] that's being displayed.
*
* Returns: (transfer none) (nullable): The plugin that's being displayed, or
* %NULL if the page is empty.
*
* Since: 0.39.0
*/
GPluginPlugin
*
gplugin_gtk_plugin_page_get_plugin
(
GPluginGtkPluginPage
*
page
)
{
g_return_val_if_fail
(
GPLUGIN_GTK_IS_PLUGIN_PAGE
(
page
),
NULL
);
return
page
->
plugin
;
}