apt-pkg/sourcelist.h

   1 // -*- mode: cpp; mode: fold -*-
   2 // Description                                                          /*{{{*/
   3 // $Id: sourcelist.h,v 1.12.2.1 2003/12/24 23:09:17 mdz Exp $
   4 /* ######################################################################
   5
   6    SourceList - Manage a list of sources
   7
   8    The Source List class provides access to a list of sources. It
   9    can read them from a file and generate a list of all the distinct
  10    sources.
  11
  12    All sources have a type associated with them that defines the layout
  13    of the archive. The exact format of the file is documented in
  14    files.sgml.
  15
  16    The types are mapped through a list of type definitions which handle
  17    the actual construction of the back end type. After loading a source
  18    list all you have is a list of package index files that have the ability
  19    to be Acquired.
  20
  21    The vendor machanism is similar, except the vendor types are hard
  22    wired. Before loading the source list the vendor list is loaded.
  23    This doesn't load key data, just the checks to perform.
  24
  25    ##################################################################### */
  26                                                                         /*}}}*/
  27 #ifndef PKGLIB_SOURCELIST_H
  28 #define PKGLIB_SOURCELIST_H
  29
  30 #include <string>
  31 #include <vector>
  32 #include <map>
  33 #include <apt-pkg/pkgcache.h>
  34
  35 using std::string;
  36 using std::vector;
  37
  38
  39 class pkgAcquire;
  40 class pkgIndexFile;
  41 class metaIndex;
  42
  43 class pkgSourceList
  44 {
  45    public:
  46
  47    // List of supported source list types
  48    class Type
  49    {
  50       public:
  51
  52       // Global list of Items supported
  53       static Type **GlobalList;
  54       static unsigned long GlobalListLen;
  55       static Type *GetType(const char *Type);
  56
  57       const char *Name;
  58       const char *Label;
  59
  60       bool FixupURI(string &URI) const;
  61       virtual bool ParseLine(vector<metaIndex *> &List,
  62                              const char *Buffer,
  63                              unsigned long const &CurLine,string const &File) const;
  64       virtual bool CreateItem(vector<metaIndex *> &List,string const &URI,
  65                               string const &Dist,string const &Section,
  66                               std::map<string, string> const &Options) const = 0;
  67       Type();
  68       virtual ~Type() {};
  69    };
  70
  71    typedef vector<metaIndex *>::const_iterator const_iterator;
  72
  73    protected:
  74
  75    vector<metaIndex *> SrcList;
  76
  77    public:
  78
  79    bool ReadMainList();
  80    bool Read(string File);
  81
  82    // CNC:2003-03-03
  83    void Reset();
  84    bool ReadAppend(string File);
  85    bool ReadSourceDir(string Dir);
  86
  87    // List accessors
  88    inline const_iterator begin() const {return SrcList.begin();};
  89    inline const_iterator end() const {return SrcList.end();};
  90    inline unsigned int size() const {return SrcList.size();};
  91    inline bool empty() const {return SrcList.empty();};
  92
  93    bool FindIndex(pkgCache::PkgFileIterator File,
  94                   pkgIndexFile *&Found) const;
  95    bool GetIndexes(pkgAcquire *Owner, bool GetAll=false) const;
  96
  97    // query last-modified time
  98    time_t GetLastModifiedTime();
  99
 100    pkgSourceList();
 101    pkgSourceList(string File);
 102    ~pkgSourceList();
 103 };
 104
 105 #endif