source/buildgraph.h

   1 #ifndef BUILDGRAPH_H_
   2 #define BUILDGRAPH_H_
   3
   4 #include <map>
   5 #include <string>
   6
   7 class Builder;
   8 class Target;
   9
  10 /**
  11 Manages a graph of targets.
  12 */
  13 class BuildGraph
  14 {
  15 public:
  16         typedef std::map<std::string, Target *> TargetMap;
  17
  18 private:
  19         Builder &builder;
  20         TargetMap targets;
  21         Target *goals;
  22
  23 public:
  24         BuildGraph(Builder &);
  25         ~BuildGraph();
  26
  27         /** Looks up a target by name.  Returns 0 if no such target exists. */
  28         Target *get_target(const std::string &) const;
  29
  30         const TargetMap &get_targets() const { return targets; }
  31
  32         /** Adds a target.  It can later be retrieved by name.  Called from Target
  33         constructor. */
  34         void add_target(Target *);
  35
  36         /** Adds a target that is a primary build goal.  Such targets will be added
  37         as dependencies of the "world" virtual target.  If the target belongs to a
  38         default component of the main package, it's also added to the "default"
  39         virtual target. */
  40         void add_primary_target(Target &);
  41
  42         /** Adds a target that will be installed.  A new InstalledFile target is
  43         created and added as a dependency to the "install" virtual target. */
  44         void add_installed_target(Target &);
  45
  46         /** Adds a target as a toplevel goal.  These are stored as dependencies of
  47         the "goals" virtual target. */
  48         void add_goal(Target &);
  49
  50         Target &get_goals() const { return *goals; }
  51
  52         /** Prepares all toplevel goals for building.  If no goals are defined, the
  53         "default" target is added as a goal. */
  54         void prepare();
  55
  56         /** Marks all buildable targets to be rebuilt.  The graph must be prepared
  57         first. */
  58         void force_full_rebuild();
  59
  60         /** Returns the number of targets that are going to be rebuilt.  The graph
  61         must be prepared first. */
  62         unsigned count_rebuild_targets() const;
  63
  64         /** Returns a target that can be built and is needed for building the goal
  65         targets.  Null */
  66         Target *get_buildable_target() const;
  67 };
  68
  69 #endif