1 /*---------------------------------------------------------------------\
3 | |__ / \ / / . \ . \ |
8 \---------------------------------------------------------------------*/
9 /** \file zypp/ResObject.h
12 #ifndef ZYPP_RESOBJECT_H
13 #define ZYPP_RESOBJECT_H
15 #include "zypp/base/Deprecated.h"
17 #include "zypp/Resolvable.h"
18 #include "zypp/Date.h"
19 #include "zypp/Locale.h"
20 #include "zypp/Vendor.h"
21 #include "zypp/ByteCount.h"
22 #include "zypp/DiskUsage.h"
23 #include "zypp/OnMediaLocation.h"
24 #include "zypp/Repository.h"
26 #include "zypp/sat/LookupAttr.h"
27 #include "zypp/sat/SolvableSet.h"
29 ///////////////////////////////////////////////////////////////////
31 { /////////////////////////////////////////////////////////////////
33 ///////////////////////////////////////////////////////////////////
35 // CLASS NAME : ResObject
38 * Interface base for resolvable objects (common data).
39 * That is, all data not needed for solving, but common
40 * across all Resolvable kinds.
42 * \see \ref makeResObject for how to construct ResObjects.
44 class ResObject : public Resolvable
47 typedef ResObject Self;
48 typedef ResTraits<Self> TraitsType;
49 typedef TraitsType::PtrType Ptr;
50 typedef TraitsType::constPtrType constPtr;
54 /** Convert \c this into a Ptr of a certain Kind.
55 * This is a convenience to access type specific
57 * \return \c NULL if \c this is not of the specified kind.
60 * Package::constPtr pkg = pi->asKind<Package>();
62 * if ( pi->isKind<Package>() )
63 * DBG << pi->asKind<Package>()->keywords() << endl;
67 inline typename ResTraits<_Res>::constPtrType asKind() const;
70 inline typename ResTraits<_Res>::PtrType asKind();
73 /** \name Locale support.
74 * \see \ref sat::Solvable
77 /** \see \ref sat::Solvable::supportsLocales */
78 bool supportsLocales() const
79 { return sat::Solvable::supportsLocales(); }
81 /** \see \ref sat::Solvable::supportsLocale */
82 bool supportsLocale( const Locale & locale_r ) const
83 { return sat::Solvable::supportsLocale( locale_r ); }
85 bool supportsLocale( const LocaleSet & locales_r ) const
86 { return sat::Solvable::supportsLocale( locales_r ); }
88 /** \see \ref sat::Solvable::supportsRequestedLocales */
89 bool supportsRequestedLocales() const
90 { return sat::Solvable::supportsRequestedLocales(); }
92 /** \see \ref sat::Solvable::getSupportedLocales */
93 LocaleSet getSupportedLocales() const
94 { return sat::Solvable::getSupportedLocales(); }
99 * \short Short text describing the resolvable.
100 * This attribute is usually displayed in columns.
102 std::string summary( const Locale & lang_r = Locale() ) const;
105 * \short Long text describing the resolvable.
107 std::string description( const Locale & lang_r = Locale() ) const;
110 * \short Installation Notification
112 * This text can be used to tell the user some notes
113 * When he selects the resovable for installation.
115 std::string insnotify( const Locale & lang_r = Locale() ) const;
118 * \short De-Installation Notification
120 * This text can be used to tell the user some notes
121 * When he selects the resovable for deinstall.
123 std::string delnotify( const Locale & lang_r = Locale() ) const;
126 * \short License or agreement to accept
128 * Agreement, warning or license the user should
129 * accept before installing the resolvable.
131 std::string licenseToConfirm( const Locale & lang_r = Locale() ) const;
136 * For example "Novell Inc."
138 Vendor vendor() const
139 { return Resolvable::vendor().asString(); }
141 /** The distribution string.
144 std::string distribution() const;
147 * The Common Platform Enumeration name
150 * See http://cpe.mitre.org
152 std::string cpeId() const;
154 /** Installed size. */
155 ByteCount installSize() const;
157 /** Size of the rpm package. */
158 ByteCount downloadSize() const;
160 /** \see \ref sat::Solvable::repository */
161 Repository repository() const
162 { return sat::Solvable::repository(); }
164 /** \ref RepoInfo associated with the repository
165 * providing this resolvable.
167 RepoInfo repoInfo() const
168 { return repository().info(); }
171 * Media number where the resolvable is located
172 * 0 if no media access is required.
174 unsigned mediaNr() const;
177 * \short build time of the resolvable
179 Date buildtime() const;
182 * \short Installation time
183 * 0 if the resolvable is not installed.
185 Date installtime() const;
188 * \short Disk usage per directory
189 * A common attribute, although mostly packages require
190 * noticeable disk space. An e.g product could try to reserve
191 * a certain ammount of diskspace by providing DiskUsage data.
193 const DiskUsage & diskusage() const;
196 friend ResObject::Ptr makeResObject( const sat::Solvable & solvable_r );
198 ResObject( const sat::Solvable & solvable_r );
200 virtual ~ResObject();
201 /** Helper for stream output */
202 virtual std::ostream & dumpOn( std::ostream & str ) const;
204 ///////////////////////////////////////////////////////////////////
206 /** Create \ref ResObject from \ref sat::Solvable.
208 * This function creates the apropriate kind of ResObject
209 * depending on the sat::Solvables kind, and returns a smart
212 * If the sat::Solvables kind is not convertible, a NULL
213 * pointer is returned.
217 * ResObject::Ptr p( makeResObject( s ) );
218 * ResObject::Ptr q( make<ResObject>( s ) );
219 * Package::Ptr pkg( make<Package>( s ) );
222 ResObject::Ptr makeResObject( const sat::Solvable & solvable_r );
224 /** Directly create a certain kind of ResObject from \ref sat::Solvable.
226 * If the sat::Solvables kind is not appropriate, a NULL
227 * pointer is returned.
230 * ResObject::Ptr p( makeResObject( s ) );
231 * ResObject::Ptr q( make<ResObject>( s ) );
232 * Package::Ptr pkg( make<Package>( s ) );
236 inline typename ResTraits<_Res>::PtrType make( const sat::Solvable & solvable_r )
237 { return( isKind<_Res>( solvable_r ) ? new _Res( solvable_r ) : 0 ); }
238 /** \overload Specialisation for ResObject autodetecting the kind of resolvable. */
240 inline ResObject::Ptr make<ResObject>( const sat::Solvable & solvable_r )
241 { return makeResObject( solvable_r ); }
243 /** Convert ResObject::Ptr into Ptr of a certain Kind.
244 * \return \c NULL iff \a p is \c NULL or points to a Resolvable
245 * not of the specified Kind.
248 * asKind<Package>(resPtr);
252 inline typename ResTraits<_Res>::PtrType asKind( const ResObject::Ptr & p )
253 { return dynamic_pointer_cast<_Res>(p); }
256 inline typename ResTraits<_Res>::constPtrType asKind( const ResObject::constPtr & p )
257 { return dynamic_pointer_cast<const _Res>(p); }
260 inline typename ResTraits<_Res>::constPtrType ResObject::asKind() const
261 { return make<_Res>( *this ); }
264 inline typename ResTraits<_Res>::PtrType ResObject::asKind()
265 { return make<_Res>( *this ); }
267 /////////////////////////////////////////////////////////////////
269 ///////////////////////////////////////////////////////////////////
270 #endif // ZYPP_RESOBJECT_H