librpmDb.h

Go to the documentation of this file.

/*---------------------------------------------------------------------\
|                          ____ _   __ __ ___                          |
|                         |__  / \ / / . \ . \                         |
|                           / / \ V /|  _/  _/                         |
|                          / /__ | | | | | |                           |
|                         /_____||_| |_| |_|                           |
|                                                                      |
\---------------------------------------------------------------------*/
#ifndef librpmDb_h
#define librpmDb_h
 
#include <iosfwd>
 
#include <zypp/base/ReferenceCounted.h>
#include <zypp/base/NonCopyable.h>
#include <zypp/base/PtrTypes.h>
#include <zypp/PathInfo.h>
#include <zypp/target/rpm/RpmHeader.h>
#include <zypp/target/rpm/RpmException.h>
 
namespace zypp
{
namespace target
{
namespace rpm
{
  struct _dumpPath {
    _dumpPath( const Pathname & root_r, const Pathname & sub_r )
    : _root {root_r }
    , _sub { sub_r }
    {}
    const Pathname & _root;
    const Pathname & _sub;
  };
  inline std::ostream & operator<<( std::ostream & str, const _dumpPath & obj )
  { return str << "'(" << obj._root << ")" << obj._sub << "'"; }

  inline _dumpPath dumpPath( const Pathname & root_r, const Pathname & sub_r )
  { return _dumpPath( root_r, sub_r ); }

//
//      CLASS NAME : librpmDb
class librpmDb : public base::ReferenceCounted, private base::NonCopyable
{
public:
  using Ptr = intrusive_ptr<librpmDb>;
  using constPtr = intrusive_ptr<const librpmDb>;
 
private:
  static void dbAccess( librpmDb::Ptr & ptr_r );
 
public:
  //
  //    static interface
  //

  static bool globalInit();

  static std::string expand( const std::string & macro_r );

  static Pathname suggestedDbPath( const Pathname & root_r );

  static bool dbExists( const Pathname & root_r, const Pathname & dbPath_r = Pathname() );

  static librpmDb::constPtr dbOpenIf( const Pathname & root_r, const Pathname & dbPath_r = Pathname() );

  static librpmDb::constPtr dbOpenCreate( const Pathname & root_r, const Pathname & dbPath_r = Pathname() );

  class db_const_iterator;
 
private:

  static librpmDb::constPtr dbAccess( const Pathname & root_r, const Pathname & dbPath_r, bool create_r = false );
 
private:
  //
  //    internal database handle interface (nonstatic)
  //

  class D;
  D & _d;

  librpmDb( const Pathname & root_r, const Pathname & dbPath_r, bool readonly_r = true );

  void unref_to( unsigned refCount_r ) const override;
 
public:

  ~librpmDb() override;

  const Pathname & root() const;

  const Pathname & dbPath() const;
 
public:

  std::ostream & dumpOn( std::ostream & str ) const override;
};

class ZYPP_API librpmDb::db_const_iterator
{
  db_const_iterator & operator=( const db_const_iterator & ); // NO ASSIGNMENT!
  db_const_iterator ( const db_const_iterator & );            // NO COPY!
  friend std::ostream & operator<<( std::ostream & str, const db_const_iterator & obj );
  friend class librpmDb;
 
private:

  class D;
  D & _d;
 
#if LEGACY(1735)
public:
  db_const_iterator( librpmDb::constPtr dbptr_r ) ZYPP_DEPRECATED;
#endif
 
public:
  db_const_iterator() ZYPP_DEPRECATED;

  explicit db_const_iterator( const Pathname & root_r );

  db_const_iterator( const Pathname & root_r, const Pathname & dbPath_r );

  db_const_iterator( std::nullptr_t );

  ~db_const_iterator();

  bool hasDB() const;

  void operator++();

  unsigned dbHdrNum() const;

  const RpmHeader::constPtr & operator*() const;

  const RpmHeader::constPtr & operator->() const
  {
    return operator*();
  }
 
public:

  bool findAll();

  bool findByFile( const std::string & file_r );

  bool findByProvides( const std::string & tag_r );

  bool findByRequiredBy( const std::string & tag_r );

  bool findByConflicts( const std::string & tag_r );

  bool findByName( const std::string & name_r );
 
public:

  bool findPackage( const std::string & name_r );

  bool findPackage( const std::string & name_r, const Edition & ed_r );

  bool findPackage( const Package::constPtr & which_r );
};

std::ostream & operator<<( std::ostream & str, const librpmDb::db_const_iterator & obj ) ZYPP_API;

} //namespace rpm
} //namespace target
} // namespace zypp
 
#endif // librpmDb_h