Debian Codegraph @

lib/packagekit-glib2/pk-update-detail.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-update-detail
24 * @short_description: UpdateDetail object
25 *
26 * This GObject represents a update_detail 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-update-detail.h>
36 #include <packagekit-glib2/pk-enum-types.h>
37
38 static void pk_update_detail_finalize (GObject *object);
39
40 /**
41 * PkUpdateDetailPrivate:
42 *
43 * Private #PkUpdateDetail data
44 **/
45 struct _PkUpdateDetailPrivate
46 {
47 gchar *package_id;
48 gchar **updates;
49 gchar **obsoletes;
50 gchar **vendor_urls;
51 gchar **bugzilla_urls;
52 gchar **cve_urls;
53 PkRestartEnum restart;
54 gchar *update_text;
55 gchar *changelog;
56 PkUpdateStateEnum state;
57 gchar *issued;
58 gchar *updated;
59 };
60
61 enum {
62 PROP_0,
63 PROP_PACKAGE_ID,
64 PROP_UPDATES,
65 PROP_OBSOLETES,
66 PROP_VENDOR_URLS,
67 PROP_BUGZILLA_URLS,
68 PROP_CVE_URLS,
69 PROP_RESTART,
70 PROP_UPDATE_TEXT,
71 PROP_CHANGELOG,
72 PROP_STATE,
73 PROP_ISSUED,
74 PROP_UPDATED,
75 PROP_LAST
76 };
77
78 G_DEFINE_TYPE_WITH_PRIVATE (PkUpdateDetail, pk_update_detail, PK_TYPE_SOURCE)
79 #define GET_PRIVATE(o) (pk_update_detail_get_instance_private (o))
80
81 /**
82 * pk_update_detail_get_package_id:
83 * @update_detail: a #PkUpdateDetail instance
84 *
85 * Gets the update detail package ID.
86 *
87 * Return value: string values
88 *
89 * Since:0.8.8
90 **/
91 const gchar *
92 pk_update_detail_get_package_id (PkUpdateDetail *update_detail)
93 {
94 PkUpdateDetailPrivate *priv = GET_PRIVATE(update_detail);
95
96 g_return_val_if_fail (update_detail != NULL, NULL);
97
98 return priv->package_id;
99 }
100
101 /**
102 * pk_update_detail_get_updates:
103 * @update_detail: a #PkUpdateDetail instance
104 *
105 * Gets the update detail updates IDs.
106 *
107 * Return value: (transfer none): string values
108 *
109 * Since:0.8.8
110 **/
111 gchar **
112 pk_update_detail_get_updates (PkUpdateDetail *update_detail)
113 {
114 PkUpdateDetailPrivate *priv = GET_PRIVATE(update_detail);
115
116 g_return_val_if_fail (update_detail != NULL, NULL);
117
118 return priv->updates;
119 }
120
121 /**
122 * pk_update_detail_get_obsoletes:
123 * @update_detail: a #PkUpdateDetail instance
124 *
125 * Gets the update detail obsoletes IDs.
126 *
127 * Return value: (transfer none): string values
128 *
129 * Since:0.8.8
130 **/
131 gchar **
132 pk_update_detail_get_obsoletes (PkUpdateDetail *update_detail)
133 {
134 PkUpdateDetailPrivate *priv = GET_PRIVATE(update_detail);
135
136 g_return_val_if_fail (update_detail != NULL, NULL);
137
138 return priv->obsoletes;
139 }
140
141 /**
142 * pk_update_detail_get_vendor_urls:
143 * @update_detail: a #PkUpdateDetail instance
144 *
145 * Gets the update detail vendor URLs.
146 *
147 * Return value: (transfer none): string values
148 *
149 * Since:0.8.8
150 **/
151 gchar **
152 pk_update_detail_get_vendor_urls (PkUpdateDetail *update_detail)
153 {
154 PkUpdateDetailPrivate *priv = GET_PRIVATE(update_detail);
155
156 g_return_val_if_fail (update_detail != NULL, NULL);
157
158 return priv->vendor_urls;
159 }
160
161 /**
162 * pk_update_detail_get_bugzilla_urls:
163 * @update_detail: a #PkUpdateDetail instance
164 *
165 * Gets the update detail bugzilla URLs.
166 *
167 * Return value: (transfer none): string values
168 *
169 * Since:0.8.8
170 **/
171 gchar **
172 pk_update_detail_get_bugzilla_urls (PkUpdateDetail *update_detail)
173 {
174 PkUpdateDetailPrivate *priv = GET_PRIVATE(update_detail);
175
176 g_return_val_if_fail (update_detail != NULL, NULL);
177
178 return priv->bugzilla_urls;
179 }
180
181 /**
182 * pk_update_detail_get_cve_urls:
183 * @update_detail: a #PkUpdateDetail instance
184 *
185 * Gets the update detail CVE URLs.
186 *
187 * Return value: (transfer none): string values
188 *
189 * Since:0.8.8
190 **/
191 gchar **
192 pk_update_detail_get_cve_urls (PkUpdateDetail *update_detail)
193 {
194 PkUpdateDetailPrivate *priv = GET_PRIVATE(update_detail);
195
196 g_return_val_if_fail (update_detail != NULL, NULL);
197
198 return priv->cve_urls;
199 }
200
201 /**
202 * pk_update_detail_get_restart:
203 * @update_detail: a #PkUpdateDetail instance
204 *
205 * Gets the update detail restart kind.
206 *
207 * Return value: enum values
208 *
209 * Since:0.8.8
210 **/
211 PkRestartEnum
212 pk_update_detail_get_restart (PkUpdateDetail *update_detail)
213 {
214 PkUpdateDetailPrivate *priv = GET_PRIVATE(update_detail);
215
216 g_return_val_if_fail (update_detail != NULL, PK_RESTART_ENUM_UNKNOWN);
217
218 return priv->restart;
219 }
220
221 /**
222 * pk_update_detail_get_update_text:
223 * @update_detail: a #PkUpdateDetail instance
224 *
225 * Gets the update detail update text.
226 *
227 * Return value: string values
228 *
229 * Since:0.8.8
230 **/
231 const gchar *
232 pk_update_detail_get_update_text (PkUpdateDetail *update_detail)
233 {
234 PkUpdateDetailPrivate *priv = GET_PRIVATE(update_detail);
235
236 g_return_val_if_fail (update_detail != NULL, NULL);
237
238 return priv->update_text;
239 }
240
241 /**
242 * pk_update_detail_get_changelog:
243 * @update_detail: a #PkUpdateDetail instance
244 *
245 * Gets the update detail changelog.
246 *
247 * Return value: string values
248 *
249 * Since:0.8.8
250 **/
251 const gchar *
252 pk_update_detail_get_changelog (PkUpdateDetail *update_detail)
253 {
254 PkUpdateDetailPrivate *priv = GET_PRIVATE(update_detail);
255
256 g_return_val_if_fail (update_detail != NULL, NULL);
257
258 return priv->changelog;
259 }
260
261 /**
262 * pk_update_detail_get_state:
263 * @update_detail: a #PkUpdateDetail instance
264 *
265 * Gets the update detail state.
266 *
267 * Return value: enum value
268 *
269 * Since:0.8.8
270 **/
271 PkUpdateStateEnum
272 pk_update_detail_get_state (PkUpdateDetail *update_detail)
273 {
274 PkUpdateDetailPrivate *priv = GET_PRIVATE(update_detail);
275
276 g_return_val_if_fail (update_detail != NULL, PK_UPDATE_STATE_ENUM_UNKNOWN);
277
278 return priv->state;
279 }
280
281 /**
282 * pk_update_detail_get_issued:
283 * @update_detail: a #PkUpdateDetail instance
284 *
285 * Gets the update detail issued string.
286 *
287 * Return value: string values
288 *
289 * Since:0.8.8
290 **/
291 const gchar *
292 pk_update_detail_get_issued (PkUpdateDetail *update_detail)
293 {
294 PkUpdateDetailPrivate *priv = GET_PRIVATE(update_detail);
295
296 g_return_val_if_fail (update_detail != NULL, NULL);
297
298 return priv->issued;
299 }
300
301 /**
302 * pk_update_detail_get_updated:
303 * @update_detail: a #PkUpdateDetail instance
304 *
305 * Gets the update detail updated string.
306 *
307 * Return value: string values
308 *
309 * Since:0.8.8
310 **/
311 const gchar *
312 pk_update_detail_get_updated (PkUpdateDetail *update_detail)
313 {
314 PkUpdateDetailPrivate *priv = GET_PRIVATE(update_detail);
315
316 g_return_val_if_fail (update_detail != NULL, NULL);
317
318 return priv->updated;
319 }
320
321 /*
322 * pk_update_detail_get_property:
323 **/
324 static void
325 pk_update_detail_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec)
326 {
327 PkUpdateDetail *update_detail = PK_UPDATE_DETAIL (object);
328 PkUpdateDetailPrivate *priv = GET_PRIVATE(update_detail);
329
330 switch (prop_id) {
331 case PROP_PACKAGE_ID:
332 g_value_set_string (value, priv->package_id);
333 break;
334 case PROP_UPDATES:
335 g_value_set_boxed (value, priv->updates);
336 break;
337 case PROP_OBSOLETES:
338 g_value_set_boxed (value, priv->obsoletes);
339 break;
340 case PROP_VENDOR_URLS:
341 g_value_set_boxed (value, priv->vendor_urls);
342 break;
343 case PROP_BUGZILLA_URLS:
344 g_value_set_boxed (value, priv->bugzilla_urls);
345 break;
346 case PROP_CVE_URLS:
347 g_value_set_boxed (value, priv->cve_urls);
348 break;
349 case PROP_RESTART:
350 g_value_set_enum (value, priv->restart);
351 break;
352 case PROP_UPDATE_TEXT:
353 g_value_set_string (value, priv->update_text);
354 break;
355 case PROP_CHANGELOG:
356 g_value_set_string (value, priv->changelog);
357 break;
358 case PROP_STATE:
359 g_value_set_enum (value, priv->state);
360 break;
361 case PROP_ISSUED:
362 g_value_set_string (value, priv->issued);
363 break;
364 case PROP_UPDATED:
365 g_value_set_string (value, priv->updated);
366 break;
367 default:
368 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
369 break;
370 }
371 }
372
373 /*
374 * pk_update_detail_set_property:
375 **/
376 static void
377 pk_update_detail_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec)
378 {
379 PkUpdateDetail *update_detail = PK_UPDATE_DETAIL (object);
380 PkUpdateDetailPrivate *priv = GET_PRIVATE(update_detail);
381
382 switch (prop_id) {
383 case PROP_PACKAGE_ID:
384 g_free (priv->package_id);
385 priv->package_id = g_value_dup_string (value);
386 break;
387 case PROP_UPDATES:
388 g_strfreev (priv->updates);
389 priv->updates = g_value_dup_boxed (value);
390 break;
391 case PROP_OBSOLETES:
392 g_strfreev (priv->obsoletes);
393 priv->obsoletes = g_value_dup_boxed (value);
394 break;
395 case PROP_VENDOR_URLS:
396 g_strfreev (priv->vendor_urls);
397 priv->vendor_urls = g_value_dup_boxed (value);
398 break;
399 case PROP_BUGZILLA_URLS:
400 g_strfreev (priv->bugzilla_urls);
401 priv->bugzilla_urls = g_value_dup_boxed (value);
402 break;
403 case PROP_CVE_URLS:
404 g_strfreev (priv->cve_urls);
405 priv->cve_urls = g_value_dup_boxed (value);
406 break;
407 case PROP_RESTART:
408 priv->restart = g_value_get_enum (value);
409 break;
410 case PROP_UPDATE_TEXT:
411 g_free (priv->update_text);
412 priv->update_text = g_value_dup_string (value);
413 break;
414 case PROP_CHANGELOG:
415 g_free (priv->changelog);
416 priv->changelog = g_value_dup_string (value);
417 break;
418 case PROP_STATE:
419 priv->state = g_value_get_enum (value);
420 break;
421 case PROP_ISSUED:
422 g_free (priv->issued);
423 priv->issued = g_value_dup_string (value);
424 break;
425 case PROP_UPDATED:
426 g_free (priv->updated);
427 priv->updated = g_value_dup_string (value);
428 break;
429 default:
430 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
431 break;
432 }
433 }
434
435 /*
436 * pk_update_detail_class_init:
437 **/
438 static void
439 pk_update_detail_class_init (PkUpdateDetailClass *klass)
440 {
441 GParamSpec *pspec;
442 GObjectClass *object_class = G_OBJECT_CLASS (klass);
443 object_class->finalize = pk_update_detail_finalize;
444 object_class->get_property = pk_update_detail_get_property;
445 object_class->set_property = pk_update_detail_set_property;
446
447 /**
448 * PkUpdateDetail:package-id:
449 *
450 * Since: 0.5.4
451 */
452 pspec = g_param_spec_string ("package-id", NULL, NULL,
453 NULL,
454 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
455 g_object_class_install_property (object_class, PROP_PACKAGE_ID, pspec);
456
457 /**
458 * PkUpdateDetail:updates:
459 *
460 * Since: 0.8.1
461 */
462 pspec = g_param_spec_boxed ("updates", NULL, NULL,
463 G_TYPE_STRV,
464 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
465 g_object_class_install_property (object_class, PROP_UPDATES, pspec);
466
467 /**
468 * PkUpdateDetail:obsoletes:
469 *
470 * Since: 0.8.1
471 */
472 pspec = g_param_spec_boxed ("obsoletes", NULL, NULL,
473 G_TYPE_STRV,
474 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
475 g_object_class_install_property (object_class, PROP_OBSOLETES, pspec);
476
477 /**
478 * PkUpdateDetail:vendor-urls:
479 *
480 * Since: 0.8.1
481 */
482 pspec = g_param_spec_boxed ("vendor-urls", NULL, NULL,
483 G_TYPE_STRV,
484 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
485 g_object_class_install_property (object_class, PROP_VENDOR_URLS, pspec);
486
487 /**
488 * PkUpdateDetail:bugzilla-urls:
489 *
490 * Since: 0.8.1
491 */
492 pspec = g_param_spec_boxed ("bugzilla-urls", NULL, NULL,
493 G_TYPE_STRV,
494 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
495 g_object_class_install_property (object_class, PROP_BUGZILLA_URLS, pspec);
496
497 /**
498 * PkUpdateDetail:cve-urls:
499 *
500 * Since: 0.8.1
501 */
502 pspec = g_param_spec_boxed ("cve-urls", NULL, NULL,
503 G_TYPE_STRV,
504 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
505 g_object_class_install_property (object_class, PROP_CVE_URLS, pspec);
506
507 /**
508 * PkUpdateDetail:restart:
509 *
510 * Since: 0.5.4
511 */
512 pspec = g_param_spec_enum ("restart", NULL, NULL,
513 PK_TYPE_RESTART_ENUM, PK_RESTART_ENUM_UNKNOWN,
514 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
515 g_object_class_install_property (object_class, PROP_RESTART, pspec);
516
517 /**
518 * PkUpdateDetail:update-text:
519 *
520 * Since: 0.5.4
521 */
522 pspec = g_param_spec_string ("update-text", NULL, NULL,
523 NULL,
524 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
525 g_object_class_install_property (object_class, PROP_UPDATE_TEXT, pspec);
526
527 /**
528 * PkUpdateDetail:changelog:
529 *
530 * Since: 0.5.4
531 */
532 pspec = g_param_spec_string ("changelog", NULL, NULL,
533 NULL,
534 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
535 g_object_class_install_property (object_class, PROP_CHANGELOG, pspec);
536
537 /**
538 * PkUpdateDetail:state:
539 *
540 * Since: 0.5.4
541 */
542 pspec = g_param_spec_enum ("state", NULL, NULL,
543 PK_TYPE_UPDATE_STATE_ENUM, PK_UPDATE_STATE_ENUM_UNKNOWN,
544 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
545 g_object_class_install_property (object_class, PROP_STATE, pspec);
546
547 /**
548 * PkUpdateDetail:issued:
549 *
550 * Since: 0.5.4
551 */
552 pspec = g_param_spec_string ("issued", NULL, NULL,
553 NULL,
554 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
555 g_object_class_install_property (object_class, PROP_ISSUED, pspec);
556
557 /**
558 * PkUpdateDetail:updated:
559 *
560 * Since: 0.5.4
561 */
562 pspec = g_param_spec_string ("updated", NULL, NULL,
563 NULL,
564 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
565 g_object_class_install_property (object_class, PROP_UPDATED, pspec);
566 }
567
568 /*
569 * pk_update_detail_init:
570 **/
571 static void
572 pk_update_detail_init (PkUpdateDetail *update_detail)
573 {
574 update_detail->priv = GET_PRIVATE(update_detail);
575 }
576
577 /*
578 * pk_update_detail_finalize:
579 **/
580 static void
581 pk_update_detail_finalize (GObject *object)
582 {
583 PkUpdateDetail *update_detail = PK_UPDATE_DETAIL (object);
584 PkUpdateDetailPrivate *priv = GET_PRIVATE(update_detail);
585
586 g_clear_pointer (&priv->package_id, g_free);
587 g_clear_pointer (&priv->updates, g_strfreev);
588 g_clear_pointer (&priv->obsoletes, g_strfreev);
589 g_clear_pointer (&priv->vendor_urls, g_strfreev);
590 g_clear_pointer (&priv->bugzilla_urls, g_strfreev);
591 g_clear_pointer (&priv->cve_urls, g_free);
592 g_clear_pointer (&priv->update_text, g_free);
593 g_clear_pointer (&priv->changelog, g_free);
594 g_clear_pointer (&priv->issued, g_free);
595 g_clear_pointer (&priv->updated, g_free);
596
597 G_OBJECT_CLASS (pk_update_detail_parent_class)->finalize (object);
598 }
599
600 /**
601 * pk_update_detail_new:
602 *
603 * Return value: a new #PkUpdateDetail object.
604 *
605 * Since: 0.5.4
606 **/
607 PkUpdateDetail *
608 pk_update_detail_new (void)
609 {
610 PkUpdateDetail *update_detail;
611 update_detail = g_object_new (PK_TYPE_UPDATE_DETAIL, NULL);
612 return PK_UPDATE_DETAIL (update_detail);
613 }