]> git.tdb.fi Git - builder.git/blob - source/buildgraph.h
Add and improve build signatures for some tools
[builder.git] / 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