/* * Copyright © 2015 Red Hat, Inc * * This program 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 . * * Authors: * Alexander Larsson */ #include "config.h" #include "flatpak-utils.h" #include "flatpak-ref.h" #include "flatpak-enum-types.h" /** * SECTION:flatpak-ref * @Title: FlatpakRef * @Short_description: Application reference * * Currently flatpak manages two types of binary artifacts: applications, and * runtimes. Applications contain a program that desktop users can run, while * runtimes contain only libraries and data. An FlatpakRef object (or short: ref) * can refer to either of these. * * Both applications and runtimes are identified by a 4-tuple of strings: kind, * name, arch and branch, e.g. app/org.gnome.evince/x86_64/master. The functions * flatpak_ref_parse() and flatpak_ref_format_ref() can be used to convert * FlatpakRef objects into this string representation and back. * * To uniquely identify a particular version of an application or runtime, you * need a commit. * * The subclasses #FlatpakInstalledRef and #FlatpakRemoteRef provide more information * for artifacts that are locally installed or available from a remote repository. */ typedef struct _FlatpakRefPrivate FlatpakRefPrivate; struct _FlatpakRefPrivate { char *name; char *arch; char *branch; char *commit; FlatpakRefKind kind; }; G_DEFINE_TYPE_WITH_PRIVATE (FlatpakRef, flatpak_ref, G_TYPE_OBJECT) enum { PROP_0, PROP_NAME, PROP_ARCH, PROP_BRANCH, PROP_COMMIT, PROP_KIND }; static void flatpak_ref_finalize (GObject *object) { FlatpakRef *self = FLATPAK_REF (object); FlatpakRefPrivate *priv = flatpak_ref_get_instance_private (self); g_free (priv->name); g_free (priv->arch); g_free (priv->branch); g_free (priv->commit); G_OBJECT_CLASS (flatpak_ref_parent_class)->finalize (object); } static void flatpak_ref_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) { FlatpakRef *self = FLATPAK_REF (object); FlatpakRefPrivate *priv = flatpak_ref_get_instance_private (self); switch (prop_id) { case PROP_NAME: g_clear_pointer (&priv->name, g_free); priv->name = g_value_dup_string (value); break; case PROP_ARCH: g_clear_pointer (&priv->arch, g_free); priv->arch = g_value_dup_string (value); break; case PROP_BRANCH: g_clear_pointer (&priv->branch, g_free); priv->branch = g_value_dup_string (value); break; case PROP_COMMIT: g_clear_pointer (&priv->commit, g_free); priv->commit = g_value_dup_string (value); break; case PROP_KIND: priv->kind = g_value_get_enum (value); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void flatpak_ref_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) { FlatpakRef *self = FLATPAK_REF (object); FlatpakRefPrivate *priv = flatpak_ref_get_instance_private (self); switch (prop_id) { case PROP_NAME: g_value_set_string (value, priv->name); break; case PROP_ARCH: g_value_set_string (value, priv->arch); break; case PROP_BRANCH: g_value_set_string (value, priv->branch); break; case PROP_COMMIT: g_value_set_string (value, priv->commit); break; case PROP_KIND: g_value_set_enum (value, priv->kind); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void flatpak_ref_class_init (FlatpakRefClass *klass) { GObjectClass *object_class = G_OBJECT_CLASS (klass); object_class->get_property = flatpak_ref_get_property; object_class->set_property = flatpak_ref_set_property; object_class->finalize = flatpak_ref_finalize; g_object_class_install_property (object_class, PROP_NAME, g_param_spec_string ("name", "Name", "The name of the application or runtime", NULL, G_PARAM_READWRITE)); g_object_class_install_property (object_class, PROP_ARCH, g_param_spec_string ("arch", "Architecture", "The architecture of the application or runtime", NULL, G_PARAM_READWRITE)); g_object_class_install_property (object_class, PROP_BRANCH, g_param_spec_string ("branch", "Branch", "The branch of the application or runtime", NULL, G_PARAM_READWRITE)); g_object_class_install_property (object_class, PROP_COMMIT, g_param_spec_string ("commit", "Commit", "The commit", NULL, G_PARAM_READWRITE)); g_object_class_install_property (object_class, PROP_KIND, g_param_spec_enum ("kind", "Kind", "The kind of artifact", FLATPAK_TYPE_REF_KIND, FLATPAK_REF_KIND_APP, G_PARAM_READWRITE)); } static void flatpak_ref_init (FlatpakRef *self) { FlatpakRefPrivate *priv = flatpak_ref_get_instance_private (self); priv->kind = FLATPAK_REF_KIND_APP; } /** * flatpak_ref_get_name: * @self: a #FlatpakRef * * Gets the name of the ref. * * Returns: (transfer none): the name */ const char * flatpak_ref_get_name (FlatpakRef *self) { FlatpakRefPrivate *priv = flatpak_ref_get_instance_private (self); return priv->name; } /** * flatpak_ref_get_arch: * @self: a #FlatpakRef * * Gets the arch or the ref. * * Returns: (transfer none): the arch */ const char * flatpak_ref_get_arch (FlatpakRef *self) { FlatpakRefPrivate *priv = flatpak_ref_get_instance_private (self); return priv->arch; } /** * flatpak_ref_get_branch: * @self: a #FlatpakRef * * Gets the branch of the ref. * * Returns: (transfer none): the branch */ const char * flatpak_ref_get_branch (FlatpakRef *self) { FlatpakRefPrivate *priv = flatpak_ref_get_instance_private (self); return priv->branch; } /** * flatpak_ref_get_commit: * @self: a #FlatpakRef * * Gets the commit of the ref. * * Returns: (transfer none): the commit */ const char * flatpak_ref_get_commit (FlatpakRef *self) { FlatpakRefPrivate *priv = flatpak_ref_get_instance_private (self); return priv->commit; } /** * flatpak_ref_get_kind: * @self: a #FlatpakRef * * Gets the kind of artifact that this ref refers to. * * Returns: the kind of artifact */ FlatpakRefKind flatpak_ref_get_kind (FlatpakRef *self) { FlatpakRefPrivate *priv = flatpak_ref_get_instance_private (self); return priv->kind; } /** * flatpak_ref_format_ref: * @self: a #FlatpakRef * * Convert an FlatpakRef object into a string representation that * can be parsed by flatpak_ref_parse(). * * Returns: (transfer full): string representation */ char * flatpak_ref_format_ref (FlatpakRef *self) { FlatpakRefPrivate *priv = flatpak_ref_get_instance_private (self); if (priv->kind == FLATPAK_REF_KIND_APP) return flatpak_build_app_ref (priv->name, priv->branch, priv->arch); else return flatpak_build_runtime_ref (priv->name, priv->branch, priv->arch); } /** * flatpak_ref_parse: * @ref: A string ref name, such as "app/org.test.App/86_64/master" * @error: return location for a #GError * * Tries to parse a full ref name and return a #FlatpakRef (without a * commit set) or fail if the ref is invalid somehow. * * Returns: (transfer full): an #FlatpakRef, or %NULL */ FlatpakRef * flatpak_ref_parse (const char *ref, GError **error) { g_auto(GStrv) parts = NULL; parts = flatpak_decompose_ref (ref, error); if (parts == NULL) return NULL; FlatpakRefKind kind; if (g_strcmp0 (parts[0], "app") == 0) { kind = FLATPAK_REF_KIND_APP; } else if (g_strcmp0 (parts[0], "runtime") == 0) { kind = FLATPAK_REF_KIND_RUNTIME; } else { g_set_error (error, G_IO_ERROR, G_IO_ERROR_NOT_FOUND, "Invalid kind: %s", parts[0]); return NULL; } return FLATPAK_REF (g_object_new (FLATPAK_TYPE_REF, "kind", kind, "name", parts[1], "arch", parts[2], "branch", parts[3], NULL)); }