package_db.h

   1 /*
   2  * Copyright (c) 2001, Robert Collins.
   3  *
   4  *     This program is free software; you can redistribute it and/or modify
   5  *     it under the terms of the GNU General Public License as published by
   6  *     the Free Software Foundation; either version 2 of the License, or
   7  *     (at your option) any later version.
   8  *
   9  *     A copy of the GNU General Public License can be found at
  10  *     http://www.gnu.org/
  11  *
  12  * Written by Robert Collins  <rbtcollins@hotmail.com>
  13  *
  14  */
  15
  16 #ifndef SETUP_PACKAGE_DB_H
  17 #define SETUP_PACKAGE_DB_H
  18
  19 /* required to parse this file */
  20 #include <vector>
  21 #include <map>
  22 #include "String++.h"
  23 class packagemeta;
  24 class io_stream;
  25 class PackageSpecification;
  26
  27 typedef enum {
  28   PackageDB_Install,
  29   PackageDB_Download
  30 } PackageDBActions;
  31
  32 class packagedb;
  33 typedef std::vector <packagemeta *>::iterator PackageDBConnectedIterator;
  34
  35 /*TODO: add mutexs */
  36
  37 /*TODO: add sanity.   Beware, Here Be C++ Dragons:
  38
  39    This class is a hidden singleton.  It's a singleton, but you create
  40    and delete transient objects of the class, none of which have any
  41    member data, but solely serve as shortcuts to access one static set
  42    of shared data through an irrelevant this-pointer.
  43
  44    Not only that, but it's a hidden singleton that is constructed
  45    the first time you access it, and constructed differently
  46    based on implicit global state.
  47
  48    Not only that, but it has some static state of its own that also
  49    controls how it gets constructed, but that could then be changed
  50    afterward without invalidating the cached data, silently changing
  51    its semantic interpretation.
  52
  53    To use this class, you must first set the packagedb::task member
  54    and the cygfile:// (install dir) root path.  You must only then
  55    construct a packagedb, and must remember not to change the
  56    task or root path any later in the execution sequence.
  57
  58 */
  59
  60 #include <PackageTrust.h>
  61
  62 class packagedb
  63 {
  64 public:
  65   packagedb ();
  66   /* 0 on success */
  67   int flush ();
  68   packagemeta * findBinary (PackageSpecification const &) const;
  69   packagemeta * findSource (PackageSpecification const &) const;
  70   PackageDBConnectedIterator connectedBegin();
  71   PackageDBConnectedIterator connectedEnd();
  72   void fillMissingCategory();
  73   void defaultTrust (trusts trust);
  74   void markUnVisited();
  75   void setExistence();
  76   typedef std::map <std::string, packagemeta *> packagecollection;
  77   /* all seen binary packages */
  78   static packagecollection packages;
  79   /* all seen source packages */
  80   static packagecollection sourcePackages;
  81   /* all seen categories */
  82   typedef std::map <std::string, std::vector <packagemeta *>, casecompare_lt_op > categoriesType;
  83   static categoriesType categories;
  84   static PackageDBActions task;
  85 private:
  86   static int installeddbread;   /* do we have to reread this */
  87   friend class ConnectedLoopFinder;
  88   static std::vector <packagemeta *> dependencyOrderedPackages;
  89 };
  90
  91 #endif /* SETUP_PACKAGE_DB_H */