1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
|
/*
* This file is part of libmodulemd
* Copyright (C) 2018 Red Hat, Inc.
*
* Fedora-License-Identifier: MIT
* SPDX-2.0-License-Identifier: MIT
* SPDX-3.0-License-Identifier: MIT
*
* This program is free software.
* For more information on the license, see COPYING.
* For more information on free software, see <https://www.gnu.org/philosophy/free-sw.en.html>.
*/
#pragma once
#include <glib-object.h>
G_BEGIN_DECLS
/**
* SECTION: modulemd-rpm-map-entry
* @title: Modulemd.RpmMapEntry
* @stability: stable
* @short_description: Provides an exploded and unexploded view of the NEVRA of
* an RPM artifact.
*/
#define MODULEMD_TYPE_RPM_MAP_ENTRY (modulemd_rpm_map_entry_get_type ())
G_DECLARE_FINAL_TYPE (ModulemdRpmMapEntry,
modulemd_rpm_map_entry,
MODULEMD,
RPM_MAP_ENTRY,
GObject)
/**
* modulemd_rpm_map_entry_new:
* @name: The name of the package.
* @epoch: The epoch of the package.
* @version: The version of the package.
* @release: The release string of the package.
* @arch: The processor architecture of the package.
*
* Create a new rpm-map entry. This will contain the decomposed NEVRA of an
* RPM artifact.
*
* Returns: (transfer full): A newly-allocated #ModulemdRpmMapEntry object with
* the provided values.
*/
ModulemdRpmMapEntry *
modulemd_rpm_map_entry_new (const gchar *name,
guint64 epoch,
const gchar *version,
const gchar *release,
const gchar *arch);
/**
* modulemd_rpm_map_entry_copy:
* @self: This #ModulemdRpmMapEntry object.
*
* Returns: (transfer full): A deep copy of this #ModulemdRpmMapEntry object.
*
* Since: 2.2
*/
ModulemdRpmMapEntry *
modulemd_rpm_map_entry_copy (ModulemdRpmMapEntry *self);
/**
* modulemd_rpm_map_entry_equals:
* @self: A #ModulemdRpmMapEntry object.
* @other: Another #ModulemdRpmMapEntry object.
*
* Returns: TRUE if the two entries contain equivalent data. FALSE if they
* differ.
*
* Since: 2.2
*/
gboolean
modulemd_rpm_map_entry_equals (ModulemdRpmMapEntry *self,
ModulemdRpmMapEntry *other);
/**
* modulemd_rpm_map_entry_validate:
* @self: This #ModulemdRpmMapEntry object.
* @error: (out): A #GError containing the reason the object failed validation.
* NULL if the validation passed.
*
* Since: 2.2
*/
gboolean
modulemd_rpm_map_entry_validate (ModulemdRpmMapEntry *self, GError **error);
/**
* modulemd_rpm_map_entry_set_name:
* @self: This #ModulemdRpmMapEntry object.
* @name: The package name of this RPM.
*
* Since: 2.2
*/
void
modulemd_rpm_map_entry_set_name (ModulemdRpmMapEntry *self, const gchar *name);
/**
* modulemd_rpm_map_entry_get_name:
* @self: This #ModulemdRpmMapEntry object.
*
* Returns: (transfer none): The package name of this RPM.
*
* Since: 2.2
*/
const gchar *
modulemd_rpm_map_entry_get_name (ModulemdRpmMapEntry *self);
/**
* modulemd_rpm_map_entry_set_epoch:
* @self: This #ModulemdRpmMapEntry object.
* @epoch: The package epoch of this RPM.
*
* Since: 2.2
*/
void
modulemd_rpm_map_entry_set_epoch (ModulemdRpmMapEntry *self, guint64 epoch);
/**
* modulemd_rpm_map_entry_get_epoch:
* @self: This #ModulemdRpmMapEntry object.
*
* Returns: The package epoch of this RPM.
*
* Since: 2.2
*/
guint64
modulemd_rpm_map_entry_get_epoch (ModulemdRpmMapEntry *self);
/**
* modulemd_rpm_map_entry_set_version:
* @self: This #ModulemdRpmMapEntry object.
* @version: The package version of this RPM.
*
* Since: 2.2
*/
void
modulemd_rpm_map_entry_set_version (ModulemdRpmMapEntry *self,
const gchar *version);
/**
* modulemd_rpm_map_entry_get_version:
* @self: This #ModulemdRpmMapEntry object.
*
* Returns: (transfer none): The package version of this RPM.
*
* Since: 2.2
*/
const gchar *
modulemd_rpm_map_entry_get_version (ModulemdRpmMapEntry *self);
/**
* modulemd_rpm_map_entry_set_release:
* @self: This #ModulemdRpmMapEntry object.
* @release: The package release string of this RPM.
*
* Since: 2.2
*/
void
modulemd_rpm_map_entry_set_release (ModulemdRpmMapEntry *self,
const gchar *release);
/**
* modulemd_rpm_map_entry_get_release:
* @self: This #ModulemdRpmMapEntry object.
*
* Returns: (transfer none): The package release of this RPM.
*
* Since: 2.2
*/
const gchar *
modulemd_rpm_map_entry_get_release (ModulemdRpmMapEntry *self);
/**
* modulemd_rpm_map_entry_set_arch:
* @self: This #ModulemdRpmMapEntry object.
* @arch: The package architecture of this RPM.
*
* Since: 2.2
*/
void
modulemd_rpm_map_entry_set_arch (ModulemdRpmMapEntry *self, const gchar *arch);
/**
* modulemd_rpm_map_entry_get_arch:
* @self: This #ModulemdRpmMapEntry object.
*
* Returns: (transfer none): The package architecture of this RPM.
*
* Since: 2.2
*/
const gchar *
modulemd_rpm_map_entry_get_arch (ModulemdRpmMapEntry *self);
/**
* modulemd_rpm_map_entry_get_nevra_as_string: (rename-to modulemd_rpm_map_entry_get_nevra)
* @self: This #ModulemdRpmMapEntry object.
*
* Returns: (transfer full): A newly-allocated string containing the complete
* N-E:V-R.A constructed from the component parts. NULL if any field is
* missing.
*
* Since: 2.2
*/
gchar *
modulemd_rpm_map_entry_get_nevra_as_string (ModulemdRpmMapEntry *self);
G_END_DECLS
|
