8 #include <msp/time/timestamp.h>
19 Targets make up the build graph. This class is a base for all target types and
20 handles many common tasks. See also FileTarget and VirtualTarget.
25 typedef std::list<Target *> Dependencies;
38 const Package *package;
39 const Component *component;
44 std::string rebuild_reason;
45 std::string install_location;
49 Target(Builder &, const std::string &);
53 virtual const char *get_type() const = 0;
54 const std::string &get_name() const { return name; }
55 const Package *get_package() const { return package; }
56 const Component *get_component() const { return component; }
59 Tries to locate a target that will help getting this target built. If all
60 dependencies are up-to-date, returns this target. If there are no targets
61 ready to be built (maybe because they are being built right now), returns 0.
63 virtual Target *get_buildable_target();
66 If this target is a proxy for another (such as Install or Symlink), return
67 that target. Otherwise, return the target itself.
69 Implementors should call the function recursively to find the final target.
71 virtual Target *get_real_target() { return this; }
73 void set_tool(const Tool &);
74 const Tool *get_tool() const { return tool; }
76 bool is_buildable() const { return tool!=0; }
77 bool needs_rebuild() const { return state>PREPARING && state<UPTODATE; }
78 const std::string &get_rebuild_reason() const { return rebuild_reason; }
79 bool is_installable() const { return !install_location.empty(); }
80 const std::string &get_install_location() const { return install_location; }
81 void add_depend(Target *);
82 const Dependencies &get_depends() const { return depends; }
84 /** Finds dependencies for the target. */
85 virtual void find_depends() { }
88 Prepares the target by recursively preparing dependencies, then checking
89 whether rebuilding is needed. A flag is used to prevent unnecessary
92 virtual void prepare();
95 Starts building the target. Returns the Action used for building.
99 void mark_rebuild(const std::string &);
102 Checks if the target needs to be rebuilt and why.
104 virtual void check_rebuild() = 0;
107 Handler for the build_finished signal of Task.
109 virtual void build_finished(bool);