#include <list>
#include <string>
#include <msp/fs/path.h>
+#include "buildinfo.h"
+#include "virtualfilesystem.h"
+class Architecture;
class Builder;
+class BuildInfo;
class Component;
+class FileTarget;
class Target;
class Task;
class Tool
{
public:
- typedef std::list<Msp::FS::Path> SearchPath;
- typedef std::list<std::string> SuffixList;
+ enum ProcessingUnit
+ {
+ ONE_FILE,
+ DIRECTORY,
+ COMPONENT
+ };
protected:
Builder &builder;
+ const Architecture *architecture;
std::string tag;
- SuffixList input_suffixes;
- SuffixList aux_suffixes;
- SearchPath system_path;
+ std::string command;
+ FileTarget *executable;
+ std::list<std::string> input_suffixes;
+ std::list<std::string> aux_suffixes;
+ ProcessingUnit processing_unit;
+ VirtualFileSystem::SearchPath system_path;
+ BuildInfo build_info;
+ bool prepared;
+ std::list<std::string> problems;
Tool(Builder &, const std::string &);
+ Tool(Builder &, const Architecture &, const std::string &);
public:
virtual ~Tool() { }
const std::string &get_tag() const { return tag; }
- const SuffixList &get_input_suffixes() const { return input_suffixes; }
- const SuffixList &get_auxiliary_suffixes() const { return aux_suffixes; }
- bool accepts_suffix(const std::string &, bool = false) const;
- const SearchPath &get_system_path() const { return system_path; }
+ /** Returns the architecture this tool build for. May return null if the
+ tool is architecture-agnostic. */
+ const Architecture *get_architecture() const { return architecture; }
+
+ /** Overrides the command used by the tool. The new command should accept
+ the same command line arguments. Only works on tools that use an external
+ command. If cross is true and the architecture is not native, a cross
+ prefix is added to the command. May have no effect after prepare() has been
+ called. */
+ void set_command(const std::string &cmd, bool cross = false);
+
+ /** Returns a target for the tool's own executable. If the tool does not
+ use an external program, returns null. The tool must be prepared first. */
+ FileTarget *get_executable() const { return executable; }
+
+ /// Returns a list of suffixes that can be processed with this tool.
+ const std::list<std::string> &get_input_suffixes() const { return input_suffixes; }
+
+ /** Returns a list of suffixes that are associated with this tool, but can't
+ be processed directly. For example C and C++ headers. */
+ const std::list<std::string> &get_auxiliary_suffixes() const { return aux_suffixes; }
+
+ /** Indicates whether the tool can accept a suffix. If aux is true,
+ auxiliary suffixes are considered as well */
+ bool accepts_suffix(const std::string &, bool aux = false) const;
+
+ /** Returns the grouping unit this tool prefers to process. */
+ ProcessingUnit get_processing_unit() const { return processing_unit; }
+
+ /// Returns the systemwide search path for source files.
+ const VirtualFileSystem::SearchPath &get_system_path() const { return system_path; }
+
+ /** Returns tool-specific build info. This can be used by other tools down
+ the chain. */
+ const BuildInfo &get_build_info() const { return build_info; }
+
+ /// Creates a source file appropriate for this tool.
virtual Target *create_source(const Component &, const Msp::FS::Path &) const { return 0; }
+
+ /** Creates a package-less source file appropriate for this tool. This is
+ called during dependency discovery when no package has created a target for
+ the file. */
virtual Target *create_source(const Msp::FS::Path &) const { return 0; }
- Target *create_target(Target &, const std::string & = std::string()) const;
- virtual Target *create_target(const std::list<Target *> &, const std::string & = std::string()) const = 0;
+
+ /// Convenience function to create a target from a single source.
+ Target *create_target(Target &, const std::string & = std::string());
+
+ /** Creates a target from sources. The exact types of accepted sources
+ depends on the tool. The optional second argument can be used to select an
+ alternative target type for tools that can create multiple kinds of targets. */
+ virtual Target *create_target(const std::list<Target *> &, const std::string & = std::string()) = 0;
+
+ /** Creates an install target for a target created by this tool. Can return
+ null if the tool does not want to handle installing in a special way. */
+ virtual Target *create_install(Target &) const { return 0; }
+
+ virtual std::string create_build_signature(const BuildInfo &) const;
+
+ void prepare();
+
+protected:
+ virtual void do_prepare() { }
+
+public:
+ const std::list<std::string> &get_problems() const { return problems; }
+
+ /** Invokes the tool to build a target. This should not be called directly;
+ use Target::build() instead. */
virtual Task *run(const Target &) const = 0;
};
Tool &parent;
SubTool(Tool &);
+
+public:
+ Target *create_source(const Component &, const Msp::FS::Path &) const override;
+ Target *create_source(const Msp::FS::Path &) const override;
+ Target *create_target(const std::list<Target *> &, const std::string & = std::string()) override;
+ Target *create_install(Target &) const override;
+ std::string create_build_signature(const BuildInfo &) const override;
};
+
+void operator>>(const Msp::LexicalConverter &, Tool::ProcessingUnit &);
+
#endif