Imported Upstream version 14.45.0
[platform/upstream/libzypp.git] / zypp / ResPoolProxy.h
index 6029185..6234bc5 100644 (file)
@@ -28,69 +28,114 @@ namespace zypp
   //
   //   CLASS NAME : ResPoolProxy
   //
-  /**
-   * \todo Make it a _Ref.
+  /** ResPool::instance().proxy();
+   * \todo integrate it into ResPool
   */
   class ResPoolProxy
   {
     friend std::ostream & operator<<( std::ostream & str, const ResPoolProxy & obj );
-
-    typedef std::set<ui::Selectable::Ptr>             SelectableIndex;
-    typedef std::map<ResObject::Kind,SelectableIndex> SelectablePool;
+    friend std::ostream & dumpOn( std::ostream & str, const ResPoolProxy & obj );
+    typedef std::multimap<ResKind,ui::Selectable::Ptr> SelectablePool;
 
   public:
     /** Implementation  */
     class Impl;
 
-    typedef SelectableIndex::iterator       iterator;
-    typedef SelectableIndex::const_iterator const_iterator;
-    typedef SelectableIndex::size_type      size_type;
+    typedef MapKVIteratorTraits<SelectablePool>::Value_const_iterator const_iterator;
+    typedef SelectablePool::size_type size_type;
+
+    typedef ResPool::repository_iterator    repository_iterator;
 
   public:
-    /** Default ctor: no pool */
+
+    /** Default ctor: no pool
+     * Nonempty proxies are provided by \ref ResPool.
+     * \see \ref ResPool::proxy
+     * \code
+     * ResPoolProxy p( ResPool::instance().proxy() );
+     * \endcode
+     */
     ResPoolProxy();
-    /** Ctor */
-    ResPoolProxy( ResPool_Ref pool_r );
+
     /** Dtor */
     ~ResPoolProxy();
 
   public:
+    /** \name Lookup individual Selectables. */
+    //@{
+    ui::Selectable::Ptr lookup( const pool::ByIdent & ident_r ) const;
+
+    ui::Selectable::Ptr lookup( IdString ident_r ) const
+    { return lookup( pool::ByIdent( ident_r ) ); }
+
+    ui::Selectable::Ptr lookup( ResKind kind_r, const std::string & name_r ) const
+    { return lookup( pool::ByIdent( kind_r, name_r ) ); }
+
+    ui::Selectable::Ptr lookup( const sat::Solvable & solv_r ) const
+    { return lookup( pool::ByIdent( solv_r ) ); }
 
+    ui::Selectable::Ptr lookup( const ResObject::constPtr & resolvable_r ) const
+    { return resolvable_r ? lookup( resolvable_r->satSolvable() ) : ui::Selectable::Ptr(); }
+
+    ui::Selectable::Ptr lookup( const PoolItem & pi_r ) const
+    { return lookup( pi_r.satSolvable() ); }
+    //@}
+
+  public:
+    /** \name Iterate through all Selectables of a all kind. */
+    //@{
+    bool empty() const;
+    size_type size() const;
+    const_iterator begin() const;
+    const_iterator end() const;
+    //@}
+
+    /** \name Iterate through all Selectables of a certain kind. */
+    //@{
     /** True if there are items of a certain kind. */
-    bool empty( const ResObject::Kind & kind_r ) const;
+    bool empty( const ResKind & kind_r ) const;
 
     template<class _Res>
       bool empty() const
       { return empty( ResTraits<_Res>::kind ); }
 
     /** Number of Items of a certain kind.  */
-    size_type size( const ResObject::Kind & kind_r ) const;
+    size_type size( const ResKind & kind_r ) const;
 
     template<class _Res>
       size_type size() const
       { return size( ResTraits<_Res>::kind ); }
 
-    /** \name Iterate through all Selectables of a certain kind. */
-    //@{
-    const_iterator byKindBegin( const ResObject::Kind & kind_r ) const;
+    const_iterator byKindBegin( const ResKind & kind_r ) const;
 
     template<class _Res>
       const_iterator byKindBegin() const
       { return byKindBegin( ResTraits<_Res>::kind ); }
 
 
-    const_iterator byKindEnd( const ResObject::Kind & kind_r ) const;
+    const_iterator byKindEnd( const ResKind & kind_r ) const;
 
     template<class _Res>
       const_iterator byKindEnd() const
       { return byKindEnd( ResTraits<_Res>::kind ); }
     //@}
 
+ public:
+   /** \name Iterate through all Repositories that contribute ResObjects.
+   */
+   //@{
+   size_type knownRepositoriesSize() const;
+
+   repository_iterator knownRepositoriesBegin() const;
+
+   repository_iterator knownRepositoriesEnd() const;
+   //@}
+
   public:
     /** Test whether there is at least one ui::Selectable with
      * an installed object.
     */
-    bool hasInstalledObj( const ResObject::Kind & kind_r ) const
+    bool hasInstalledObj( const ResKind & kind_r ) const
     {
       return(    make_begin<ui::selfilter::ByHasInstalledObj>( kind_r )
               != make_end<ui::selfilter::ByHasInstalledObj>( kind_r ) );
@@ -102,26 +147,42 @@ namespace zypp
 
   public:
     /** \name Save and restore state per kind of resolvable.
-     * Simple version, no savety net.
+     * Simple version, no savety net. So don't restore or diff,
+     * if you didn't save before.
+     *
+     * Diff returns true, if current stat differs from the saved
+     * state.
     */
     //@{
-    void saveState( const ResObject::Kind & kind_r ) const;
+    void saveState() const;
+
+    void saveState( const ResKind & kind_r ) const;
 
     template<class _Res>
       void saveState() const
       { return saveState( ResTraits<_Res>::kind ); }
 
-    void restoreState( const ResObject::Kind & kind_r ) const;
+    void restoreState() const;
+
+    void restoreState( const ResKind & kind_r ) const;
 
     template<class _Res>
       void restoreState() const
       { return restoreState( ResTraits<_Res>::kind ); }
+
+    bool diffState() const;
+
+    bool diffState( const ResKind & kind_r ) const;
+
+    template<class _Res>
+      bool diffState() const
+      { return diffState( ResTraits<_Res>::kind ); }
     //@}
 
   private:
     template<class _Filter>
       filter_iterator<_Filter,const_iterator>
-      make_begin( _Filter filter_r, const ResObject::Kind & kind_r ) const
+      make_begin( _Filter filter_r, const ResKind & kind_r ) const
       {
         return make_filter_iterator( filter_r,
                                      byKindBegin(kind_r),
@@ -129,7 +190,7 @@ namespace zypp
       }
     template<class _Filter>
       filter_iterator<_Filter,const_iterator>
-      make_begin( const ResObject::Kind & kind_r ) const
+      make_begin( const ResKind & kind_r ) const
       {
         return make_begin( _Filter(), kind_r );
       }
@@ -137,7 +198,7 @@ namespace zypp
 
     template<class _Filter>
       filter_iterator<_Filter,const_iterator>
-      make_end( _Filter filter_r, const ResObject::Kind & kind_r ) const
+      make_end( _Filter filter_r, const ResKind & kind_r ) const
       {
         return make_filter_iterator( filter_r,
                                      byKindEnd(kind_r),
@@ -145,12 +206,15 @@ namespace zypp
       }
     template<class _Filter>
       filter_iterator<_Filter,const_iterator>
-      make_end( const ResObject::Kind & kind_r ) const
+      make_end( const ResKind & kind_r ) const
       {
         return make_end( _Filter(), kind_r );
       }
 
-
+  private:
+    friend class pool::PoolImpl;
+    /** Ctor */
+    ResPoolProxy( ResPool pool_r, const pool::PoolImpl & poolImpl_r );
     /** Pointer to implementation */
     RW_pointer<Impl> _pimpl;
   };
@@ -159,6 +223,9 @@ namespace zypp
   /** \relates ResPoolProxy Stream output */
   std::ostream & operator<<( std::ostream & str, const ResPoolProxy & obj );
 
+  /** \relates ResPoolProxy Verbose stream output */
+  std::ostream & dumpOn( std::ostream & str, const ResPoolProxy & obj );
+
   /////////////////////////////////////////////////////////////////
 } // namespace zypp
 ///////////////////////////////////////////////////////////////////