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
|
/** \file package_pool.h */ // -*-c++-*-
//
// Copyright (C) 2010 Piotr Galiszewski
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License as
// published by the Free Software Foundation; either version 2 of the
// License, or (at your option) any later version.
//
// This program 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
// General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; see the file COPYING. If not, write to
// the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
// Boston, MA 02111-1307, USA.
#ifndef APTITUDE_QT_PACKAGE_POOL_H
#define APTITUDE_QT_PACKAGE_POOL_H
// System includes
#include <boost/shared_ptr.hpp>
#include <sigc++/connection.h>
#include <sigc++/slot.h>
#include <vector>
namespace aptitude
{
namespace gui
{
namespace qt
{
class package;
typedef boost::shared_ptr<package> package_ptr;
/** \brief A global pool of package objects.
*
* The pool is filled when the object is created or when the
* cache is (re)loaded, and it is emptied when the cache is
* closed.
*
* This pool also interprets signals for the benefit of its
* client code.
*/
class package_pool
{
package_pool();
virtual ~package_pool();
class package_pool_impl;
friend class package_pool_impl;
public:
/** \brief Return the globally unique instance of package_pool. */
static package_pool *get_instance();
/** \brief Retrieve the number of packages in this pool.
*
* \return the number of package objects in this pool -- may
* not be equal to the PackageCount of the apt cache file,
* because some packages could be discarded in the pool.
*/
virtual int get_packages_count() = 0;
/** \brief Retrieve a pointer to the package at given index.
*
* \param index The zero-based index of the package. This is
* \e not equal to Pkg->ID.
*
* \return the package at index if index is between 0 and
* get_packages_count() - 1, and an invalid pointer otherwise.
*/
virtual package_ptr get_package_at_index(unsigned int index) = 0;
/** \brief Register a slot to be invoked when the apt cache is reloaded.
*
* The slot is guaranteed to be invoked after the pool has
* been initialized from the new apt cache.
*/
virtual sigc::connection connect_cache_reloaded(const sigc::slot<void> &slot) = 0;
/** \brief Register a slot to be invoked when the apt cache is closed.
*
* The signal is guaranteed to be invoked before the pool of
* packages is emptied.
*/
virtual sigc::connection connect_cache_closed(const sigc::slot<void> &slot) = 0;
/** \brief Register a slot to be invoked when the state of one
* or more packages changes.
*/
virtual sigc::connection connect_cache_state_changed(const sigc::slot<void, std::vector<package_ptr> > &slot) = 0;
};
}
}
}
#endif // APTITUDE_QT_PACKAGE_POOL_H
|
