Top |
Functions
Description
These functions provide useful functionality that makes it easy to add new plugin functions.
Functions
gs_utils_get_content_type ()
gchar * gs_utils_get_content_type (GFile *file
,GCancellable *cancellable
,GError **error
);
Gets the standard content type for a file.
gs_utils_symlink ()
gboolean gs_utils_symlink (const gchar *target
,const gchar *linkpath
,GError **error
);
Creates a symlink that can cross filesystem boundaries. Any parent directories needed for target to exist are also created.
gs_utils_unlink ()
gboolean gs_utils_unlink (const gchar *filename
,GError **error
);
Deletes a file from disk.
gs_mkdir_parent ()
gboolean gs_mkdir_parent (const gchar *path
,GError **error
);
Creates any required directories, including any parent directories.
gs_utils_get_cache_filename ()
gchar * gs_utils_get_cache_filename (const gchar *kind
,const gchar *basename
,GsUtilsCacheFlags flags
,GError **error
);
Returns a filename that points into the cache.
This may be per-system or per-user, the latter being more likely
when GS_UTILS_CACHE_FLAG_WRITEABLE
is specified in flags
.
If there is more than one match, the file that has been modified last is returned.
Parameters
kind |
A cache kind, e.g. "firmware" or "screenshots/123x456" |
|
basename |
A filename basename, e.g. "system.bin" |
|
flags |
Some GsUtilsCacheFlags, e.g. |
|
error |
gs_utils_get_user_hash ()
gchar *
gs_utils_get_user_hash (GError **error
);
This SHA1 hash is composed of the contents of machine-id and your usename and is also salted with a hardcoded value.
This provides an identifier that can be used to identify a specific user on a machine, allowing them to cast only one vote or perform one review on each application.
There is no known way to calculate the machine ID or username from the machine hash and there should be no privacy issue.
gs_utils_get_permission ()
GPermission *
gs_utils_get_permission (const gchar *id
);
Gets a permission object for an ID.
gs_utils_strv_fnmatch ()
gboolean gs_utils_strv_fnmatch (gchar **strv
,const gchar *str
);
Matches a string against a list of globs.
gs_utils_get_desktop_app_info ()
GDesktopAppInfo *
gs_utils_get_desktop_app_info (const gchar *id
);
Gets a a GDesktopAppInfo taking into account the kde4- prefix.
gs_utils_rmtree ()
gboolean gs_utils_rmtree (const gchar *directory
,GError **error
);
Deletes a directory from disk and all its contents.
gs_utils_get_wilson_rating ()
gint gs_utils_get_wilson_rating (guint64 star1
,guint64 star2
,guint64 star3
,guint64 star4
,guint64 star5
);
Returns the lower bound of Wilson score confidence interval for a Bernoulli parameter. This ensures small numbers of ratings don't give overly high scores. See https://en.wikipedia.org/wiki/Binomial_proportion_confidence_interval for details.
gs_utils_error_add_unique_id ()
void gs_utils_error_add_unique_id (GError **error
,GsApp *app
);
Adds a unique ID prefix to the error.
Since: 3.22
gs_utils_error_strip_unique_id ()
void
gs_utils_error_strip_unique_id (GError *error
);
Removes a possible unique ID prefix from the error.
Since: 3.22
gs_utils_error_convert_gio ()
gboolean
gs_utils_error_convert_gio (GError **perror
);
Converts the GIOError to an error with a GsPluginError domain.
gs_utils_error_convert_gresolver ()
gboolean
gs_utils_error_convert_gresolver (GError **perror
);
Converts the GResolverError to an error with a GsPluginError domain.
gs_utils_error_convert_gdbus ()
gboolean
gs_utils_error_convert_gdbus (GError **perror
);
Converts the GDBusError to an error with a GsPluginError domain.
gs_utils_error_convert_gdk_pixbuf ()
gboolean
gs_utils_error_convert_gdk_pixbuf (GError **perror
);
Converts the GdkPixbufError to an error with a GsPluginError domain.
gs_utils_error_convert_json_glib ()
gboolean
gs_utils_error_convert_json_glib (GError **perror
);
Converts the JsonParserError to an error with a GsPluginError domain.
gs_utils_error_convert_appstream ()
gboolean
gs_utils_error_convert_appstream (GError **perror
);
Converts the various AppStream error types to an error with a GsPluginError domain.
gs_utils_get_url_scheme ()
gchar *
gs_utils_get_url_scheme (const gchar *url
);
Gets the scheme from the URL string.
gs_utils_get_url_path ()
gchar *
gs_utils_get_url_path (const gchar *url
);
Gets the path from the URL string, removing any leading slashes.
gs_user_agent ()
const gchar *
gs_user_agent (void
);
Gets the user agent to use for remote requests.