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
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>LCOV - lcov.info - ept/apt/apt.h</title>
<link rel="stylesheet" type="text/css" href="../../gcov.css">
</head>
<body>
<table width="100%" border=0 cellspacing=0 cellpadding=0>
<tr><td class="title">LTP GCOV extension - code coverage report</td></tr>
<tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
<tr>
<td width="100%">
<table cellpadding=1 border=0 width="100%">
<tr>
<td class="headerItem" width="20%">Current view:</td>
<td class="headerValue" width="80%" colspan=4><a href="../../index.html">directory</a> - <a href="index.html">ept/apt</a> - apt.h</td>
</tr>
<tr>
<td class="headerItem" width="20%">Test:</td>
<td class="headerValue" width="80%" colspan=4>lcov.info</td>
</tr>
<tr>
<td class="headerItem" width="20%">Date:</td>
<td class="headerValue" width="20%">2008-08-14</td>
<td width="20%"></td>
<td class="headerItem" width="20%">Instrumented lines:</td>
<td class="headerValue" width="20%">6</td>
</tr>
<tr>
<td class="headerItem" width="20%">Code covered:</td>
<td class="headerValue" width="20%">50.0 %</td>
<td width="20%"></td>
<td class="headerItem" width="20%">Executed lines:</td>
<td class="headerValue" width="20%">3</td>
</tr>
</table>
</td>
</tr>
<tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
</table>
<table cellpadding=0 cellspacing=0 border=0>
<tr>
<td><br></td>
</tr>
<tr>
<td><pre class="source">
<span class="lineNum"> 1 </span> : // -*- C++ -*-
<span class="lineNum"> 2 </span> : #ifndef EPT_APT_APT_H
<span class="lineNum"> 3 </span> : #define EPT_APT_APT_H
<span class="lineNum"> 4 </span> :
<span class="lineNum"> 5 </span> : /** \file
<span class="lineNum"> 6 </span> : * High-level front-end to libapt-pkg, as a data provider for the ept framework.
<span class="lineNum"> 7 </span> : */
<span class="lineNum"> 8 </span> :
<span class="lineNum"> 9 </span> : /*
<span class="lineNum"> 10 </span> : * Copyright (C) 2007,2008 Enrico Zini <enrico@enricozini.org>
<span class="lineNum"> 11 </span> : *
<span class="lineNum"> 12 </span> : * This library is free software; you can redistribute it and/or
<span class="lineNum"> 13 </span> : * modify it under the terms of the GNU Lesser General Public
<span class="lineNum"> 14 </span> : * License as published by the Free Software Foundation; either
<span class="lineNum"> 15 </span> : * version 2.1 of the License, or (at your option) any later version.
<span class="lineNum"> 16 </span> : *
<span class="lineNum"> 17 </span> : * This library is distributed in the hope that it will be useful,
<span class="lineNum"> 18 </span> : * but WITHOUT ANY WARRANTY; without even the implied warranty of
<span class="lineNum"> 19 </span> : * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
<span class="lineNum"> 20 </span> : * Lesser General Public License for more details.
<span class="lineNum"> 21 </span> : *
<span class="lineNum"> 22 </span> : * You should have received a copy of the GNU Lesser General Public
<span class="lineNum"> 23 </span> : * License along with this library; if not, write to the Free Software
<span class="lineNum"> 24 </span> : * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
<span class="lineNum"> 25 </span> : */
<span class="lineNum"> 26 </span> :
<span class="lineNum"> 27 </span> : #include <wibble/exception.h>
<span class="lineNum"> 28 </span> : #include <ept/apt/version.h>
<span class="lineNum"> 29 </span> : #include <ept/core/apt.h>
<span class="lineNum"> 30 </span> :
<span class="lineNum"> 31 </span> : #include <iterator>
<span class="lineNum"> 32 </span> :
<span class="lineNum"> 33 </span> : namespace ept {
<span class="lineNum"> 34 </span> : namespace apt {
<span class="lineNum"> 35 </span> :
<span class="lineNum"> 36 </span> : class Exception : public wibble::exception::Generic
<span class="lineNum"> 37 </span> : {
<span class="lineNum"> 38 </span> : protected:
<span class="lineNum"> 39 </span> : std::string m_message;
<span class="lineNum"> 40 </span> :
<span class="lineNum"> 41 </span> : public:
<span class="lineNum"> 42 </span> : Exception(const std::string& context) throw ();
<span class="lineNum"> 43 </span><span class="lineNoCov"> 0 : ~Exception() throw () {}</span>
<span class="lineNum"> 44 </span> :
<span class="lineNum"> 45 </span><span class="lineNoCov"> 0 : virtual const char* type() const throw () { return "Apt"; }</span>
<span class="lineNum"> 46 </span><span class="lineNoCov"> 0 : virtual std::string desc() const throw () { return m_message; }</span>
<span class="lineNum"> 47 </span> : };
<span class="lineNum"> 48 </span> :
<span class="lineNum"> 49 </span> : class Apt;
<span class="lineNum"> 50 </span> : class AptImplementation;
<span class="lineNum"> 51 </span> : class RecordIteratorImpl;
<span class="lineNum"> 52 </span> : using core::PackageState;
<span class="lineNum"> 53 </span> :
<span class="lineNum"> 54 </span> : /**
<span class="lineNum"> 55 </span> : * High-level access to the Apt cache, as a data provider for the ept
<span class="lineNum"> 56 </span> : * framework.
<span class="lineNum"> 57 </span> : *
<span class="lineNum"> 58 </span> : * This class wraps the Apt cache and allows to query it in various ways.
<span class="lineNum"> 59 </span> : */
<span class="lineNum"> 60 </span> : class Apt
<span class="lineNum"> 61 </span> : {
<span class="lineNum"> 62 </span> : protected:
<span class="lineNum"> 63 </span> : AptImplementation* impl;
<span class="lineNum"> 64 </span> :
<span class="lineNum"> 65 </span> : public:
<span class="lineNum"> 66 </span> : // Iterate Packages in the Apt cache
<span class="lineNum"> 67 </span> : class Iterator : public std::iterator<std::input_iterator_tag, std::string, void, void, void>
<span class="lineNum"> 68 </span> : {
<span class="lineNum"> 69 </span> : void* cur;
<span class="lineNum"> 70 </span> :
<span class="lineNum"> 71 </span> : protected:
<span class="lineNum"> 72 </span> : // Construct a valid iterator
<span class="lineNum"> 73 </span><span class="lineCov"> 4 : Iterator(void* cur) : cur(cur) {}</span>
<span class="lineNum"> 74 </span> :
<span class="lineNum"> 75 </span> : // Construct and end iterator
<span class="lineNum"> 76 </span><span class="lineCov"> 3581 : Iterator() : cur(0) {}</span>
<span class="lineNum"> 77 </span> :
<span class="lineNum"> 78 </span> : public:
<span class="lineNum"> 79 </span> : // Copy constructor
<span class="lineNum"> 80 </span> : Iterator(const Iterator&);
<span class="lineNum"> 81 </span> : ~Iterator();
<span class="lineNum"> 82 </span> : std::string operator*();
<span class="lineNum"> 83 </span> : Iterator& operator++();
<span class="lineNum"> 84 </span> : Iterator& operator=(const Iterator&);
<span class="lineNum"> 85 </span> : bool operator==(const Iterator&) const;
<span class="lineNum"> 86 </span> : bool operator!=(const Iterator&) const;
<span class="lineNum"> 87 </span> :
<span class="lineNum"> 88 </span> : // FIXME: Iterator operator++(int); cannot be easily implemented
<span class="lineNum"> 89 </span> : // because of how Apt's pkgIterator works
<span class="lineNum"> 90 </span> :
<span class="lineNum"> 91 </span> : friend class Apt;
<span class="lineNum"> 92 </span> : };
<span class="lineNum"> 93 </span> :
<span class="lineNum"> 94 </span> : // Iterate Package records in the Apt cache
<span class="lineNum"> 95 </span> : class RecordIterator : public std::iterator<std::input_iterator_tag, std::string, void, void, void>
<span class="lineNum"> 96 </span> : {
<span class="lineNum"> 97 </span> : RecordIteratorImpl* impl;
<span class="lineNum"> 98 </span> : size_t pos;
<span class="lineNum"> 99 </span> : std::string cur;
<span class="lineNum"> 100 </span> : size_t cur_pos;
<span class="lineNum"> 101 </span> :
<span class="lineNum"> 102 </span> : protected:
<span class="lineNum"> 103 </span> : // Construct a valid iterator
<span class="lineNum"> 104 </span> : RecordIterator(RecordIteratorImpl* cur, size_t pos = 0);
<span class="lineNum"> 105 </span> :
<span class="lineNum"> 106 </span> : // Construct and end iterator
<span class="lineNum"> 107 </span><span class="lineCov"> 3481 : RecordIterator() : impl(0), pos(0), cur_pos(0) {}</span>
<span class="lineNum"> 108 </span> :
<span class="lineNum"> 109 </span> : public:
<span class="lineNum"> 110 </span> : // Copy constructor
<span class="lineNum"> 111 </span> : RecordIterator(const RecordIterator& r);
<span class="lineNum"> 112 </span> :
<span class="lineNum"> 113 </span> : ~RecordIterator();
<span class="lineNum"> 114 </span> : std::string operator*();
<span class="lineNum"> 115 </span> : std::string* operator->();
<span class="lineNum"> 116 </span> : RecordIterator& operator++();
<span class="lineNum"> 117 </span> : RecordIterator& operator=(const RecordIterator& r);
<span class="lineNum"> 118 </span> : bool operator==(const RecordIterator&) const;
<span class="lineNum"> 119 </span> : bool operator!=(const RecordIterator&) const;
<span class="lineNum"> 120 </span> :
<span class="lineNum"> 121 </span> : // FIXME: Iterator operator++(int); cannot be easily implemented
<span class="lineNum"> 122 </span> : // because of how Apt's pkgIterator works
<span class="lineNum"> 123 </span> :
<span class="lineNum"> 124 </span> : friend class Apt;
<span class="lineNum"> 125 </span> : };
<span class="lineNum"> 126 </span> :
<span class="lineNum"> 127 </span> : typedef Iterator iterator;
<span class="lineNum"> 128 </span> : typedef RecordIterator record_iterator;
<span class="lineNum"> 129 </span> :
<span class="lineNum"> 130 </span> : /**
<span class="lineNum"> 131 </span> : * Create the Apt data provider
<span class="lineNum"> 132 </span> : */
<span class="lineNum"> 133 </span> : Apt();
<span class="lineNum"> 134 </span> : ~Apt();
<span class="lineNum"> 135 </span> :
<span class="lineNum"> 136 </span> : iterator begin() const;
<span class="lineNum"> 137 </span> : iterator end() const;
<span class="lineNum"> 138 </span> :
<span class="lineNum"> 139 </span> : record_iterator recordBegin() const;
<span class="lineNum"> 140 </span> : record_iterator recordEnd() const;
<span class="lineNum"> 141 </span> :
<span class="lineNum"> 142 </span> :
<span class="lineNum"> 143 </span> : /// Return the number of packages in the archive
<span class="lineNum"> 144 </span> : size_t size() const;
<span class="lineNum"> 145 </span> :
<span class="lineNum"> 146 </span> : /**
<span class="lineNum"> 147 </span> : * Validate a package name, returning trye if it exists in the APT database,
<span class="lineNum"> 148 </span> : * or false if it does not.
<span class="lineNum"> 149 </span> : */
<span class="lineNum"> 150 </span> : bool isValid(const std::string& pkg) const;
<span class="lineNum"> 151 </span> :
<span class="lineNum"> 152 </span> : /// Validate a package name, returning it if it exists in the APT database,
<span class="lineNum"> 153 </span> : /// or returning the empty string if it does not.
<span class="lineNum"> 154 </span> : std::string validate(const std::string& pkg) const
<span class="lineNum"> 155 </span> : {
<span class="lineNum"> 156 </span> : if (isValid(pkg))
<span class="lineNum"> 157 </span> : return pkg;
<span class="lineNum"> 158 </span> : return std::string();
<span class="lineNum"> 159 </span> : }
<span class="lineNum"> 160 </span> :
<span class="lineNum"> 161 </span> : /// Validate a Version, returning it if it exists in the APT database, or
<span class="lineNum"> 162 </span> : /// returning the invalid version if it does not.
<span class="lineNum"> 163 </span> : Version validate(const Version& ver) const;
<span class="lineNum"> 164 </span> :
<span class="lineNum"> 165 </span> : /// Return the installed version for a package
<span class="lineNum"> 166 </span> : Version installedVersion(const std::string& pkg) const;
<span class="lineNum"> 167 </span> :
<span class="lineNum"> 168 </span> : /// Return the candidate version for a package
<span class="lineNum"> 169 </span> : Version candidateVersion(const std::string& pkg) const;
<span class="lineNum"> 170 </span> :
<span class="lineNum"> 171 </span> : /**
<span class="lineNum"> 172 </span> : * Return the candidate version for a package, if available, or the
<span class="lineNum"> 173 </span> : * installed version otherwise
<span class="lineNum"> 174 </span> : */
<span class="lineNum"> 175 </span> : Version anyVersion(const std::string& pkg) const;
<span class="lineNum"> 176 </span> :
<span class="lineNum"> 177 </span> : /// Return state information on a package
<span class="lineNum"> 178 </span> : PackageState state(const std::string& pkg) const;
<span class="lineNum"> 179 </span> :
<span class="lineNum"> 180 </span> : /**
<span class="lineNum"> 181 </span> : * Perform a package search.
<span class="lineNum"> 182 </span> : *
<span class="lineNum"> 183 </span> : * All packages for which the functor filter returns true, are passed to
<span class="lineNum"> 184 </span> : * the functor out.
<span class="lineNum"> 185 </span> : */
<span class="lineNum"> 186 </span> : //template<typename FILTER, typename OUT>
<span class="lineNum"> 187 </span> : //void search(const FILTER& filter, OUT& out);
<span class="lineNum"> 188 </span> :
<span class="lineNum"> 189 </span> : /// Get the raw package record for the given Version
<span class="lineNum"> 190 </span> : std::string rawRecord(const std::string& pkg) const;
<span class="lineNum"> 191 </span> :
<span class="lineNum"> 192 </span> : /// Get the raw package record for the given Version
<span class="lineNum"> 193 </span> : std::string rawRecord(const Version& ver) const;
<span class="lineNum"> 194 </span> :
<span class="lineNum"> 195 </span> : /// Timestamp of when the apt index was last modified
<span class="lineNum"> 196 </span> : time_t timestamp();
<span class="lineNum"> 197 </span> :
<span class="lineNum"> 198 </span> : /**
<span class="lineNum"> 199 </span> : * Check if the cache has been changed by another process, and reopen it if
<span class="lineNum"> 200 </span> : * that is the case.
<span class="lineNum"> 201 </span> : *
<span class="lineNum"> 202 </span> : * Note that this method can invalidate all existing iterators.
<span class="lineNum"> 203 </span> : */
<span class="lineNum"> 204 </span> : void checkCacheUpdates();
<span class="lineNum"> 205 </span> :
<span class="lineNum"> 206 </span> : /**
<span class="lineNum"> 207 </span> : * Invalidate the cache timestamp used to track cache updates.
<span class="lineNum"> 208 </span> : *
<span class="lineNum"> 209 </span> : * @warning Do not use this method: it is here only to support the test
<span class="lineNum"> 210 </span> : * cases, and may disappear in any future version.
<span class="lineNum"> 211 </span> : */
<span class="lineNum"> 212 </span> : void invalidateTimestamp();
<span class="lineNum"> 213 </span> : };
<span class="lineNum"> 214 </span> :
<span class="lineNum"> 215 </span> : }
<span class="lineNum"> 216 </span> : }
<span class="lineNum"> 217 </span> :
<span class="lineNum"> 218 </span> : // vim:set ts=4 sw=4:
<span class="lineNum"> 219 </span> : #endif
</pre>
</td>
</tr>
</table>
<br>
<table width="100%" border=0 cellspacing=0 cellpadding=0>
<tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
<tr><td class="versionInfo">Generated by: <a href="http://ltp.sourceforge.net/coverage/lcov.php" target="_parent">LTP GCOV extension version 1.6</a></td></tr>
</table>
<br>
</body>
</html>
|
