Debian Codegraph @

lib/packagekit-glib2/pk-package.c

raw
1 /* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*-
2 *
3 * Copyright (C) 2009 Richard Hughes <[email protected]>
4 *
5 * Licensed under the GNU Lesser General Public License Version 2.1
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 Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20 */
21
22 /**
23 * SECTION:pk-package
24 * @short_description: Package object
25 *
26 * This GObject represents a package from a transaction.
27 * These objects represent single items of data from the transaction, and are
28 * often present in lists (#PkResults) or just refcounted in client programs.
29 */
30
31 #include "config.h"
32
33 #include <glib-object.h>
34
35 #include <packagekit-glib2/pk-package.h>
36 #include <packagekit-glib2/pk-common.h>
37 #include <packagekit-glib2/pk-enum.h>
38 #include <packagekit-glib2/pk-enum-types.h>
39 #include <packagekit-glib2/pk-package-id.h>
40
41 static void pk_package_finalize (GObject *object);
42
43 /**
44 * PkPackagePrivate:
45 *
46 * Private #PkPackage data
47 **/
48 struct _PkPackagePrivate
49 {
50 PkInfoEnum info;
51 gchar *package_id;
52 gchar *package_id_data;
53 const gchar *package_id_split[4];
54 gchar *summary;
55 gchar *license;
56 PkGroupEnum group;
57 gchar *description;
58 gchar *url;
59 guint64 size;
60 gchar *update_updates;
61 gchar *update_obsoletes;
62 gchar **update_vendor_urls;
63 gchar **update_bugzilla_urls;
64 gchar **update_cve_urls;
65 PkRestartEnum update_restart;
66 gchar *update_text;
67 gchar *update_changelog;
68 PkUpdateStateEnum update_state;
69 gchar *update_issued;
70 gchar *update_updated;
71 PkInfoEnum update_severity;
72 };
73
74 enum {
75 SIGNAL_CHANGED,
76 SIGNAL_LAST
77 };
78
79 enum {
80 PROP_0,
81 PROP_INFO,
82 PROP_PACKAGE_ID,
83 PROP_SUMMARY,
84 PROP_LICENSE,
85 PROP_GROUP,
86 PROP_DESCRIPTION,
87 PROP_URL,
88 PROP_SIZE,
89 PROP_UPDATE_UPDATES,
90 PROP_UPDATE_OBSOLETES,
91 PROP_UPDATE_VENDOR_URLS,
92 PROP_UPDATE_BUGZILLA_URLS,
93 PROP_UPDATE_CVE_URLS,
94 PROP_UPDATE_RESTART,
95 PROP_UPDATE_UPDATE_TEXT,
96 PROP_UPDATE_CHANGELOG,
97 PROP_UPDATE_STATE,
98 PROP_UPDATE_ISSUED,
99 PROP_UPDATE_UPDATED,
100 PROP_UPDATE_SEVERITY,
101 PROP_LAST
102 };
103
104 static guint signals [SIGNAL_LAST] = { 0 };
105
106 static GParamSpec *obj_properties[PROP_LAST] = { NULL, };
107
108 G_DEFINE_TYPE_WITH_PRIVATE (PkPackage, pk_package, PK_TYPE_SOURCE)
109 #define GET_PRIVATE(o) (pk_package_get_instance_private (o))
110
111 /**
112 * pk_package_equal:
113 * @package1: a valid #PkPackage instance
114 * @package2: a valid #PkPackage instance
115 *
116 * Do the #PkPackage's have the same ID.
117 *
118 * Returns: %TRUE if the packages have the same package_id, info and summary.
119 *
120 * Since: 0.5.4
121 **/
122 gboolean
123 pk_package_equal (PkPackage *package1, PkPackage *package2)
124 {
125 PkPackagePrivate *priv1 = GET_PRIVATE(package1);
126 PkPackagePrivate *priv2 = GET_PRIVATE(package2);
127
128 g_return_val_if_fail (PK_IS_PACKAGE (package1), FALSE);
129 g_return_val_if_fail (PK_IS_PACKAGE (package2), FALSE);
130
131 return (g_strcmp0 (priv1->summary, priv2->summary) == 0 &&
132 g_strcmp0 (priv1->package_id, priv2->package_id) == 0 &&
133 priv1->info == priv2->info);
134 }
135
136 /**
137 * pk_package_equal_id:
138 * @package1: a valid #PkPackage instance
139 * @package2: a valid #PkPackage instance
140 *
141 * Do the #PkPackage's have the same ID.
142 *
143 * Returns: %TRUE if the packages have the same package_id.
144 *
145 * Since: 0.5.4
146 **/
147 gboolean
148 pk_package_equal_id (PkPackage *package1, PkPackage *package2)
149 {
150 PkPackagePrivate *priv1 = GET_PRIVATE(package1);
151 PkPackagePrivate *priv2 = GET_PRIVATE(package2);
152
153 g_return_val_if_fail (PK_IS_PACKAGE (package1), FALSE);
154 g_return_val_if_fail (PK_IS_PACKAGE (package2), FALSE);
155
156 return (g_strcmp0 (priv1->package_id, priv2->package_id) == 0);
157 }
158
159 /**
160 * pk_package_set_id:
161 * @package: a valid #PkPackage instance
162 * @package_id: the valid package_id
163 * @error: a #GError to put the error code and message in, or %NULL
164 *
165 * Sets the package object to have the given ID
166 *
167 * Returns: %TRUE if the package_id was set
168 *
169 * Since: 0.5.4
170 **/
171 gboolean
172 pk_package_set_id (PkPackage *package, const gchar *package_id, GError **error)
173 {
174 PkPackagePrivate *priv = GET_PRIVATE(package);
175 guint cnt = 0;
176 guint i;
177
178 g_return_val_if_fail (PK_IS_PACKAGE (package), FALSE);
179 g_return_val_if_fail (error == NULL || *error == NULL, FALSE);
180
181 if (g_strcmp0 (priv->package_id, package_id) == 0)
182 return TRUE;
183
184 /* free old data */
185 g_free (priv->package_id);
186 g_free (priv->package_id_data);
187
188 /* copy the package-id into package_id_data, change the ';' into '\0'
189 * and reference the pointers in the const gchar * array */
190 priv->package_id = g_strdup (package_id);
191 priv->package_id_data = g_strdup (package_id);
192 priv->package_id_split[PK_PACKAGE_ID_NAME] = priv->package_id_data;
193 for (i = 0; priv->package_id_data[i] != '\0'; i++) {
194 if (package_id[i] == ';') {
195 if (++cnt > 3)
196 continue;
197 priv->package_id_split[cnt] = &priv->package_id_data[i+1];
198 priv->package_id_data[i] = '\0';
199 }
200 }
201 if (cnt != 3) {
202 g_set_error (error, 1, 0, "invalid number of sections %i", cnt);
203 goto out;
204 }
205
206 /* name has to be valid */
207 if (priv->package_id_split[PK_PACKAGE_ID_NAME][0] == '\0') {
208 g_set_error_literal (error, 1, 0, "name invalid");
209 goto out;
210 }
211
212 g_object_notify_by_pspec (G_OBJECT(package), obj_properties[PROP_PACKAGE_ID]);
213 return TRUE;
214
215 out:
216 g_clear_pointer (&priv->package_id, g_free);
217 g_clear_pointer (&priv->package_id_data, g_free);
218 priv->package_id_split[PK_PACKAGE_ID_NAME] = NULL;
219 priv->package_id_split[PK_PACKAGE_ID_VERSION] = NULL;
220 priv->package_id_split[PK_PACKAGE_ID_ARCH] = NULL;
221 priv->package_id_split[PK_PACKAGE_ID_DATA] = NULL;
222 return FALSE;
223 }
224
225 /**
226 * pk_package_parse:
227 * @package: a valid #PkPackage instance
228 * @data: the data describing the package
229 * @error: a #GError to put the error code and message in, or %NULL
230 *
231 * Parses the data to populate the #PkPackage.
232 *
233 * Returns: %TRUE if the data was parsed correctly
234 *
235 * Since: 0.8.11
236 **/
237 gboolean
238 pk_package_parse (PkPackage *package, const gchar *data, GError **error)
239 {
240 g_auto(GStrv) sections = NULL;
241
242 g_return_val_if_fail (PK_IS_PACKAGE (package), FALSE);
243 g_return_val_if_fail (error == NULL || *error == NULL, FALSE);
244
245 /* split */
246 sections = g_strsplit (data, "\t", -1);
247 if (g_strv_length (sections) != 3) {
248 g_set_error_literal (error, 1, 0, "data invalid");
249 return FALSE;
250 }
251
252 /* parse object */
253 pk_package_set_info (package, pk_info_enum_from_string (sections[0]));
254 if (!pk_package_set_id (package, sections[1], error))
255 return FALSE;
256
257 pk_package_set_summary (package, sections[2]);
258 return TRUE;
259 }
260
261 /**
262 * pk_package_get_info:
263 * @package: a valid #PkPackage instance
264 *
265 * Gets the package object ID
266 *
267 * Returns: the #PkInfoEnum
268 *
269 * Since: 0.5.4
270 **/
271 PkInfoEnum
272 pk_package_get_info (PkPackage *package)
273 {
274 PkPackagePrivate *priv = GET_PRIVATE(package);
275
276 g_return_val_if_fail (PK_IS_PACKAGE (package), FALSE);
277
278 return priv->info;
279 }
280
281 /**
282 * pk_package_set_info:
283 * @package: a valid #PkPackage instance
284 * @info: the #PkInfoEnum
285 *
286 * Sets the package info enum.
287 *
288 * Since: 0.8.14
289 **/
290 void
291 pk_package_set_info (PkPackage *package, PkInfoEnum info)
292 {
293 PkPackagePrivate *priv = GET_PRIVATE(package);
294
295 g_return_if_fail (PK_IS_PACKAGE (package));
296
297 if (priv->info == info)
298 return;
299
300 priv->info = info;
301 g_object_notify_by_pspec (G_OBJECT(package), obj_properties[PROP_INFO]);
302 }
303
304 /**
305 * pk_package_set_summary:
306 * @package: a valid #PkPackage instance
307 * @summary: the package summary
308 *
309 * Sets the package summary.
310 *
311 * Since: 0.8.14
312 **/
313 void
314 pk_package_set_summary (PkPackage *package, const gchar *summary)
315 {
316 PkPackagePrivate *priv = GET_PRIVATE(package);
317
318 g_return_if_fail (PK_IS_PACKAGE (package));
319
320 if (g_strcmp0 (priv->summary, summary) == 0)
321 return;
322
323 g_free (priv->summary);
324 priv->summary = g_strdup (summary);
325 g_object_notify_by_pspec (G_OBJECT(package), obj_properties[PROP_SUMMARY]);
326 }
327
328 /**
329 * pk_package_get_id:
330 * @package: a valid #PkPackage instance
331 *
332 * Gets the package object ID
333 *
334 * Returns: (nullable): the ID, or %NULL if unset
335 *
336 * Since: 0.5.4
337 **/
338 const gchar *
339 pk_package_get_id (PkPackage *package)
340 {
341 PkPackagePrivate *priv = GET_PRIVATE(package);
342
343 g_return_val_if_fail (PK_IS_PACKAGE (package), NULL);
344
345 return priv->package_id;
346 }
347
348 /**
349 * pk_package_get_summary:
350 * @package: a valid #PkPackage instance
351 *
352 * Gets the package object ID
353 *
354 * Returns: (nullable): the summary, or %NULL if unset
355 *
356 * Since: 0.5.4
357 **/
358 const gchar *
359 pk_package_get_summary (PkPackage *package)
360 {
361 PkPackagePrivate *priv = GET_PRIVATE(package);
362
363 g_return_val_if_fail (PK_IS_PACKAGE (package), NULL);
364
365 return priv->summary;
366 }
367
368 /**
369 * pk_package_get_name:
370 * @package: a valid #PkPackage instance
371 *
372 * Gets the package name.
373 *
374 * Returns: (nullable): the name, or %NULL if unset
375 *
376 * Since: 0.6.4
377 **/
378 const gchar *
379 pk_package_get_name (PkPackage *package)
380 {
381 PkPackagePrivate *priv = GET_PRIVATE(package);
382
383 g_return_val_if_fail (PK_IS_PACKAGE (package), NULL);
384
385 return priv->package_id_split[PK_PACKAGE_ID_NAME];
386 }
387
388 /**
389 * pk_package_get_version:
390 * @package: a valid #PkPackage instance
391 *
392 * Gets the package version.
393 *
394 * Returns: (nullable): the version, or %NULL if unset
395 *
396 * Since: 0.6.4
397 **/
398 const gchar *
399 pk_package_get_version (PkPackage *package)
400 {
401 PkPackagePrivate *priv = GET_PRIVATE(package);
402
403 g_return_val_if_fail (PK_IS_PACKAGE (package), NULL);
404
405 return priv->package_id_split[PK_PACKAGE_ID_VERSION];
406 }
407
408 /**
409 * pk_package_get_arch:
410 * @package: a valid #PkPackage instance
411 *
412 * Gets the package arch.
413 *
414 * Returns: (nullable): the arch, or %NULL if unset
415 *
416 * Since: 0.6.4
417 **/
418 const gchar *
419 pk_package_get_arch (PkPackage *package)
420 {
421 PkPackagePrivate *priv = GET_PRIVATE(package);
422
423 g_return_val_if_fail (PK_IS_PACKAGE (package), NULL);
424
425 return priv->package_id_split[PK_PACKAGE_ID_ARCH];
426 }
427
428 /**
429 * pk_package_get_data:
430 * @package: a valid #PkPackage instance
431 *
432 * Gets the package data, which is usually the repository ID that contains the
433 * package. Special ID's include "installed" for installed packages, and "local"
434 * for local packages that exist on disk but not in a repository.
435 *
436 * Returns: (nullable): the data, or %NULL if unset
437 *
438 * Since: 0.6.4
439 **/
440 const gchar *
441 pk_package_get_data (PkPackage *package)
442 {
443 PkPackagePrivate *priv = GET_PRIVATE(package);
444
445 g_return_val_if_fail (PK_IS_PACKAGE (package), NULL);
446
447 return priv->package_id_split[PK_PACKAGE_ID_DATA];
448 }
449
450 /**
451 * pk_package_print:
452 * @package: a valid #PkPackage instance
453 *
454 * Prints details about the package to standard out.
455 *
456 * Since: 0.5.4
457 **/
458 void
459 pk_package_print (PkPackage *package)
460 {
461 PkPackagePrivate *priv = GET_PRIVATE(package);
462
463 g_return_if_fail (PK_IS_PACKAGE (package));
464
465 g_print ("%s-%s.%s\t%s\t%s\n",
466 priv->package_id_split[PK_PACKAGE_ID_NAME],
467 priv->package_id_split[PK_PACKAGE_ID_VERSION],
468 priv->package_id_split[PK_PACKAGE_ID_ARCH],
469 priv->package_id_split[PK_PACKAGE_ID_DATA],
470 priv->summary);
471 }
472
473 /*
474 * pk_package_get_property:
475 **/
476 static void
477 pk_package_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec)
478 {
479 PkPackage *package = PK_PACKAGE (object);
480 PkPackagePrivate *priv = GET_PRIVATE(package);
481
482 switch (prop_id) {
483 case PROP_PACKAGE_ID:
484 g_value_set_string (value, priv->package_id);
485 break;
486 case PROP_SUMMARY:
487 g_value_set_string (value, priv->summary);
488 break;
489 case PROP_INFO:
490 g_value_set_enum (value, priv->info);
491 break;
492 case PROP_LICENSE:
493 g_value_set_string (value, priv->license);
494 break;
495 case PROP_GROUP:
496 g_value_set_enum (value, priv->group);
497 break;
498 case PROP_DESCRIPTION:
499 g_value_set_string (value, priv->description);
500 break;
501 case PROP_URL:
502 g_value_set_string (value, priv->url);
503 break;
504 case PROP_SIZE:
505 g_value_set_uint64 (value, priv->size);
506 break;
507 case PROP_UPDATE_UPDATES:
508 g_value_set_string (value, priv->update_updates);
509 break;
510 case PROP_UPDATE_OBSOLETES:
511 g_value_set_string (value, priv->update_obsoletes);
512 break;
513 case PROP_UPDATE_VENDOR_URLS:
514 g_value_set_boxed (value, priv->update_vendor_urls);
515 break;
516 case PROP_UPDATE_BUGZILLA_URLS:
517 g_value_set_boxed (value, priv->update_bugzilla_urls);
518 break;
519 case PROP_UPDATE_CVE_URLS:
520 g_value_set_boxed (value, priv->update_cve_urls);
521 break;
522 case PROP_UPDATE_RESTART:
523 g_value_set_enum (value, priv->update_restart);
524 break;
525 case PROP_UPDATE_UPDATE_TEXT:
526 g_value_set_string (value, priv->update_text);
527 break;
528 case PROP_UPDATE_CHANGELOG:
529 g_value_set_string (value, priv->update_changelog);
530 break;
531 case PROP_UPDATE_STATE:
532 g_value_set_enum (value, priv->update_state);
533 break;
534 case PROP_UPDATE_ISSUED:
535 g_value_set_string (value, priv->update_issued);
536 break;
537 case PROP_UPDATE_UPDATED:
538 g_value_set_string (value, priv->update_updated);
539 break;
540 case PROP_UPDATE_SEVERITY:
541 g_value_set_enum (value, priv->update_severity);
542 break;
543 default:
544 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
545 break;
546 }
547 }
548
549 /*
550 * pk_package_set_property:
551 **/
552 static void
553 pk_package_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec)
554 {
555 PkPackage *package = PK_PACKAGE (object);
556 PkPackagePrivate *priv = GET_PRIVATE(package);
557
558 switch (prop_id) {
559 case PROP_INFO:
560 priv->info = g_value_get_enum (value);
561 break;
562 case PROP_SUMMARY:
563 g_free (priv->summary);
564 priv->summary = g_value_dup_string (value);
565 break;
566 case PROP_LICENSE:
567 g_free (priv->license);
568 priv->license = g_value_dup_string (value);
569 break;
570 case PROP_GROUP:
571 priv->group = g_value_get_enum (value);
572 break;
573 case PROP_DESCRIPTION:
574 g_free (priv->description);
575 priv->description = g_value_dup_string (value);
576 break;
577 case PROP_URL:
578 g_free (priv->url);
579 priv->url = g_value_dup_string (value);
580 break;
581 case PROP_SIZE:
582 priv->size = g_value_get_uint64 (value);
583 break;
584 case PROP_UPDATE_UPDATES:
585 g_free (priv->update_updates);
586 priv->update_updates = g_value_dup_string (value);
587 break;
588 case PROP_UPDATE_OBSOLETES:
589 g_free (priv->update_obsoletes);
590 priv->update_obsoletes = g_value_dup_string (value);
591 break;
592 case PROP_UPDATE_VENDOR_URLS:
593 g_strfreev (priv->update_vendor_urls);
594 priv->update_vendor_urls = g_strdupv (g_value_get_boxed (value));
595 break;
596 case PROP_UPDATE_BUGZILLA_URLS:
597 g_strfreev (priv->update_bugzilla_urls);
598 priv->update_bugzilla_urls = g_strdupv (g_value_get_boxed (value));
599 break;
600 case PROP_UPDATE_CVE_URLS:
601 g_strfreev (priv->update_cve_urls);
602 priv->update_cve_urls = g_strdupv (g_value_get_boxed (value));
603 break;
604 case PROP_UPDATE_RESTART:
605 priv->update_restart = g_value_get_enum (value);
606 break;
607 case PROP_UPDATE_UPDATE_TEXT:
608 g_free (priv->update_text);
609 priv->update_text = g_value_dup_string (value);
610 break;
611 case PROP_UPDATE_CHANGELOG:
612 g_free (priv->update_changelog);
613 priv->update_changelog = g_value_dup_string (value);
614 break;
615 case PROP_UPDATE_STATE:
616 priv->update_state = g_value_get_enum (value);
617 break;
618 case PROP_UPDATE_ISSUED:
619 g_free (priv->update_issued);
620 priv->update_issued = g_value_dup_string (value);
621 break;
622 case PROP_UPDATE_UPDATED:
623 g_free (priv->update_updated);
624 priv->update_updated = g_value_dup_string (value);
625 break;
626 case PROP_UPDATE_SEVERITY:
627 pk_package_set_update_severity (package, g_value_get_enum (value));
628 break;
629 default:
630 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
631 break;
632 }
633 }
634
635 /*
636 * pk_package_class_init:
637 **/
638 static void
639 pk_package_class_init (PkPackageClass *klass)
640 {
641 GObjectClass *object_class = G_OBJECT_CLASS (klass);
642 object_class->get_property = pk_package_get_property;
643 object_class->set_property = pk_package_set_property;
644 object_class->finalize = pk_package_finalize;
645
646 /**
647 * PkPackage:info:
648 *
649 * Since: 0.5.4
650 */
651 obj_properties[PROP_INFO] =
652 g_param_spec_enum ("info", NULL,
653 "The PkInfoEnum package type, e.g. PK_INFO_ENUM_NORMAL",
654 PK_TYPE_INFO_ENUM, PK_INFO_ENUM_UNKNOWN,
655 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
656
657 /**
658 * PkPackage:package-id:
659 *
660 * Since: 0.5.4
661 */
662 obj_properties[PROP_PACKAGE_ID] =
663 g_param_spec_string ("package-id", NULL,
664 "The full package_id, e.g. 'gnome-power-manager;0.1.2;i386;fedora'",
665 NULL,
666 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS);
667
668 /**
669 * PkPackage:summary:
670 *
671 * Since: 0.5.4
672 */
673 obj_properties[PROP_SUMMARY] =
674 g_param_spec_string ("summary", NULL,
675 "The package summary",
676 NULL,
677 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
678
679 /**
680 * PkPackage:license:
681 *
682 * Since: 0.5.4
683 */
684 obj_properties[PROP_LICENSE] =
685 g_param_spec_string ("license", NULL,
686 "The package license",
687 NULL,
688 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
689
690 /**
691 * PkPackage:group:
692 *
693 * Since: 0.5.4
694 */
695 obj_properties[PROP_GROUP] =
696 g_param_spec_enum ("group", NULL,
697 "The package group",
698 PK_TYPE_GROUP_ENUM, PK_GROUP_ENUM_UNKNOWN,
699 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
700
701 /**
702 * PkPackage:description:
703 *
704 * Since: 0.5.4
705 */
706 obj_properties[PROP_DESCRIPTION] =
707 g_param_spec_string ("description", NULL,
708 "The package description",
709 NULL,
710 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
711
712 /**
713 * PkPackage:url:
714 *
715 * Since: 0.5.4
716 */
717 obj_properties[PROP_URL] =
718 g_param_spec_string ("url", NULL,
719 "The package homepage URL",
720 NULL,
721 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
722
723 /**
724 * PkPackage:size:
725 *
726 * Since: 0.5.4
727 */
728 obj_properties[PROP_SIZE] =
729 g_param_spec_uint64 ("size", NULL,
730 "The package size",
731 0, G_MAXUINT64, 0,
732 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
733
734 /**
735 * PkPackage:update-updates:
736 *
737 * Since: 0.5.4
738 */
739 obj_properties[PROP_UPDATE_UPDATES] =
740 g_param_spec_string ("update-updates", NULL,
741 "The update packages",
742 NULL,
743 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
744
745 /**
746 * PkPackage:update-obsoletes:
747 *
748 * Since: 0.5.4
749 */
750 obj_properties[PROP_UPDATE_OBSOLETES] =
751 g_param_spec_string ("update-obsoletes", NULL,
752 "The update packages that are obsoleted",
753 NULL,
754 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
755
756 /**
757 * PkPackage:update-vendor-urls:
758 *
759 * Since: 0.8.1
760 */
761 obj_properties[PROP_UPDATE_VENDOR_URLS] =
762 g_param_spec_boxed ("update-vendor-urls", NULL,
763 "The update vendor URLs",
764 G_TYPE_STRV,
765 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
766
767 /**
768 * PkPackage:update-bugzilla-urls:
769 *
770 * Since: 0.8.1
771 */
772 obj_properties[PROP_UPDATE_BUGZILLA_URLS] =
773 g_param_spec_boxed ("update-bugzilla-urls", NULL,
774 "The update bugzilla URLs",
775 G_TYPE_STRV,
776 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
777
778 /**
779 * PkPackage:update-cve-urls:
780 *
781 * Since: 0.8.1
782 */
783 obj_properties[PROP_UPDATE_CVE_URLS] =
784 g_param_spec_boxed ("update-cve-urls", NULL,
785 "The update CVE URLs",
786 G_TYPE_STRV,
787 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
788
789 /**
790 * PkPackage:update-restart:
791 *
792 * Since: 0.5.4
793 */
794 obj_properties[PROP_UPDATE_RESTART] =
795 g_param_spec_enum ("update-restart", NULL,
796 "The update restart type",
797 PK_TYPE_RESTART_ENUM, PK_RESTART_ENUM_UNKNOWN,
798 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
799
800 /**
801 * PkPackage:update-text:
802 *
803 * Since: 0.5.4
804 */
805 obj_properties[PROP_UPDATE_UPDATE_TEXT] =
806 g_param_spec_string ("update-text", NULL,
807 "The update description",
808 NULL,
809 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
810
811 /**
812 * PkPackage:update-changelog:
813 *
814 * Since: 0.5.4
815 */
816 obj_properties[PROP_UPDATE_CHANGELOG] =
817 g_param_spec_string ("update-changelog", NULL,
818 "The update ChangeLog",
819 NULL,
820 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
821
822 /**
823 * PkPackage:update-state:
824 *
825 * Since: 0.5.4
826 */
827 obj_properties[PROP_UPDATE_STATE] =
828 g_param_spec_enum ("update-state", NULL,
829 "The update state",
830 PK_TYPE_UPDATE_STATE_ENUM, PK_UPDATE_STATE_ENUM_UNKNOWN,
831 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
832
833 /**
834 * PkPackage:update-issued:
835 *
836 * Since: 0.5.4
837 */
838 obj_properties[PROP_UPDATE_ISSUED] =
839 g_param_spec_string ("update-issued", NULL,
840 "When the update was issued",
841 NULL,
842 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
843
844 /**
845 * PkPackage:update-updated:
846 *
847 * Since: 0.5.4
848 */
849 obj_properties[PROP_UPDATE_UPDATED] =
850 g_param_spec_string ("update-updated", NULL,
851 "When the update was last updated",
852 NULL,
853 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
854
855 /**
856 * PkPackage:update-severity:
857 *
858 * Can be one of %PK_INFO_ENUM_UNKNOWN, %PK_INFO_ENUM_LOW,
859 * %PK_INFO_ENUM_ENHANCEMENT, %PK_INFO_ENUM_NORMAL,
860 * %PK_INFO_ENUM_BUGFIX, %PK_INFO_ENUM_IMPORTANT,
861 * %PK_INFO_ENUM_SECURITY or %PK_INFO_ENUM_CRITICAL.
862 *
863 * Since: 1.2.4
864 */
865 obj_properties[PROP_UPDATE_SEVERITY] =
866 g_param_spec_enum ("update-severity", NULL,
867 "Package update severity",
868 PK_TYPE_INFO_ENUM, PK_INFO_ENUM_UNKNOWN,
869 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_EXPLICIT_NOTIFY);
870
871 g_object_class_install_properties (object_class, PROP_LAST, obj_properties);
872
873 /**
874 * PkPackage::changed:
875 * @package: the #PkPackage instance that emitted the signal
876 *
877 * The ::changed signal is emitted when the package data may have changed.
878 **/
879 signals [SIGNAL_CHANGED] =
880 g_signal_new ("changed",
881 G_TYPE_FROM_CLASS (object_class), G_SIGNAL_RUN_LAST,
882 G_STRUCT_OFFSET (PkPackageClass, changed),
883 NULL, NULL, g_cclosure_marshal_VOID__VOID,
884 G_TYPE_NONE, 0);
885 }
886
887 /*
888 * pk_package_init:
889 * @package: This class instance
890 **/
891 static void
892 pk_package_init (PkPackage *package)
893 {
894 PkPackagePrivate *priv = GET_PRIVATE(package);
895 priv->package_id_split[PK_PACKAGE_ID_NAME] = NULL;
896 priv->package_id_split[PK_PACKAGE_ID_VERSION] = NULL;
897 priv->package_id_split[PK_PACKAGE_ID_ARCH] = NULL;
898 priv->package_id_split[PK_PACKAGE_ID_DATA] = NULL;
899 package->priv = priv;
900 }
901
902 /*
903 * pk_package_finalize:
904 * @object: The object to finalize
905 **/
906 static void
907 pk_package_finalize (GObject *object)
908 {
909 PkPackage *package = PK_PACKAGE (object);
910 PkPackagePrivate *priv = GET_PRIVATE(package);
911
912 g_clear_pointer (&priv->package_id, g_free);
913 g_clear_pointer (&priv->summary, g_free);
914 g_clear_pointer (&priv->license, g_free);
915 g_clear_pointer (&priv->description, g_free);
916 g_clear_pointer (&priv->url, g_free);
917 g_clear_pointer (&priv->update_updates, g_free);
918 g_clear_pointer (&priv->update_obsoletes, g_free);
919 g_clear_pointer (&priv->update_vendor_urls, g_strfreev);
920 g_clear_pointer (&priv->update_bugzilla_urls, g_strfreev);
921 g_clear_pointer (&priv->update_cve_urls, g_strfreev);
922 g_clear_pointer (&priv->update_text, g_free);
923 g_clear_pointer (&priv->update_changelog, g_free);
924 g_clear_pointer (&priv->update_issued, g_free);
925 g_clear_pointer (&priv->update_updated, g_free);
926 g_clear_pointer (&priv->package_id_data, g_free);
927
928 G_OBJECT_CLASS (pk_package_parent_class)->finalize (object);
929 }
930
931 /**
932 * pk_package_new:
933 *
934 * Returns: a new #PkPackage object.
935 *
936 * Since: 0.5.4
937 **/
938 PkPackage *
939 pk_package_new (void)
940 {
941 PkPackage *package;
942 package = g_object_new (PK_TYPE_PACKAGE, NULL);
943 return PK_PACKAGE (package);
944 }
945
946 /**
947 * pk_package_get_update_severity:
948 * @package: a #PkPackage
949 *
950 * Returns the @package update severity. Can be one of
951 * %PK_INFO_ENUM_UNKNOWN, %PK_INFO_ENUM_LOW,
952 * %PK_INFO_ENUM_ENHANCEMENT, %PK_INFO_ENUM_NORMAL,
953 * %PK_INFO_ENUM_BUGFIX, %PK_INFO_ENUM_IMPORTANT,
954 * %PK_INFO_ENUM_SECURITY or %PK_INFO_ENUM_CRITICAL.
955 *
956 * Returns: the @package update severity, if known.
957 *
958 * Since: 1.2.4
959 **/
960 PkInfoEnum
961 pk_package_get_update_severity (PkPackage *package)
962 {
963 PkPackagePrivate *priv = GET_PRIVATE(package);
964
965 g_return_val_if_fail (PK_IS_PACKAGE (package), PK_INFO_ENUM_UNKNOWN);
966
967 return priv->update_severity;
968 }
969
970 /**
971 * pk_package_set_update_severity:
972 * @package: a #PkPackage
973 * @update_severity: a #PkInfoEnum
974 *
975 * Set an update severity for the @package. The @update_severity can
976 * be one of %PK_INFO_ENUM_UNKNOWN, %PK_INFO_ENUM_LOW,
977 * %PK_INFO_ENUM_ENHANCEMENT, %PK_INFO_ENUM_NORMAL,
978 * %PK_INFO_ENUM_BUGFIX, %PK_INFO_ENUM_IMPORTANT,
979 * %PK_INFO_ENUM_SECURITY or %PK_INFO_ENUM_CRITICAL.
980 *
981 * Since: 1.2.4
982 **/
983 void
984 pk_package_set_update_severity (PkPackage *package,
985 PkInfoEnum update_severity)
986 {
987 PkPackagePrivate *priv = GET_PRIVATE(package);
988
989 g_return_if_fail (PK_IS_PACKAGE (package));
990 g_return_if_fail (update_severity == PK_INFO_ENUM_UNKNOWN ||
991 update_severity == PK_INFO_ENUM_LOW ||
992 update_severity == PK_INFO_ENUM_ENHANCEMENT ||
993 update_severity == PK_INFO_ENUM_NORMAL ||
994 update_severity == PK_INFO_ENUM_BUGFIX ||
995 update_severity == PK_INFO_ENUM_IMPORTANT ||
996 update_severity == PK_INFO_ENUM_SECURITY ||
997 update_severity == PK_INFO_ENUM_CRITICAL);
998
999 if (priv->update_severity == update_severity)
1000 return;
1001
1002 priv->update_severity = update_severity;
1003 g_object_notify_by_pspec (G_OBJECT(package), obj_properties[PROP_UPDATE_SEVERITY]);
1004 }