apt-pkg/srcrecords.h

   1 // -*- mode: cpp; mode: fold -*-
   2 // Description                                                          /*{{{*/
   3 // $Id: srcrecords.h,v 1.8.2.1 2003/12/26 16:27:34 mdz Exp $
   4 /* ######################################################################
   5
   6    Source Package Records - Allows access to source package records
   7
   8    Parses and allows access to the list of source records and searching by
   9    source name on that list.
  10
  11    ##################################################################### */
  12                                                                         /*}}}*/
  13 #ifndef PKGLIB_SRCRECORDS_H
  14 #define PKGLIB_SRCRECORDS_H
  15
  16 #include <apt-pkg/macros.h>
  17
  18 #include <string>
  19 #include <vector>
  20
  21 #ifndef APT_8_CLEANER_HEADERS
  22 using std::string;
  23 using std::vector;
  24 #endif
  25
  26 class pkgSourceList;
  27 class pkgIndexFile;
  28 class pkgSrcRecords
  29 {
  30    public:
  31
  32    // Describes a single file
  33    struct File
  34    {
  35       std::string MD5Hash;
  36       std::string Hash;
  37       unsigned long Size;
  38       std::string Path;
  39       std::string Type;
  40    };
  41
  42    // Abstract parser for each source record
  43    class Parser
  44    {
  45       protected:
  46
  47       const pkgIndexFile *iIndex;
  48
  49       public:
  50
  51       enum BuildDep {BuildDepend=0x0,BuildDependIndep=0x1,
  52                      BuildConflict=0x2,BuildConflictIndep=0x3};
  53
  54       struct BuildDepRec
  55       {
  56          std::string Package;
  57          std::string Version;
  58          unsigned int Op;
  59          unsigned char Type;
  60       };
  61
  62       inline const pkgIndexFile &Index() const {return *iIndex;};
  63
  64       virtual bool Restart() = 0;
  65       virtual bool Step() = 0;
  66       virtual bool Jump(unsigned long const &Off) = 0;
  67       virtual unsigned long Offset() = 0;
  68       virtual std::string AsStr() = 0;
  69
  70       virtual std::string Package() const = 0;
  71       virtual std::string Version() const = 0;
  72       virtual std::string Maintainer() const = 0;
  73       virtual std::string Section() const = 0;
  74       virtual const char **Binaries() = 0;   // Ownership does not transfer
  75
  76       //FIXME: Add a parameter to specify which architecture to use for [wildcard] matching
  77       virtual bool BuildDepends(std::vector<BuildDepRec> &BuildDeps, bool const &ArchOnly, bool const &StripMultiArch = true) = 0;
  78       static const char *BuildDepType(unsigned char const &Type) APT_PURE;
  79
  80       virtual bool Files(std::vector<pkgSrcRecords::File> &F) = 0;
  81
  82       Parser(const pkgIndexFile *Index) : iIndex(Index) {};
  83       virtual ~Parser() {};
  84    };
  85
  86    private:
  87    /** \brief dpointer placeholder (for later in case we need it) */
  88    void *d;
  89
  90    // The list of files and the current parser pointer
  91    std::vector<Parser*> Files;
  92    std::vector<Parser *>::iterator Current;
  93
  94    public:
  95
  96    // Reset the search
  97    bool Restart();
  98
  99    // Locate a package by name
 100    Parser *Find(const char *Package,bool const &SrcOnly = false);
 101
 102    pkgSrcRecords(pkgSourceList &List);
 103    virtual ~pkgSrcRecords();
 104 };
 105
 106 #endif