+++ /dev/null
-#ifndef TOOL_H_
-#define TOOL_H_
-
-#include <string>
-#include <vector>
-#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;
-
-/**
-Base class for tools. Tools are used to turn targets into other targets.
-Examples include compilers and linkers.
-*/
-class Tool
-{
-public:
- enum ProcessingUnit
- {
- ONE_FILE,
- DIRECTORY,
- COMPONENT
- };
-
-protected:
- Builder &builder;
- const Architecture *architecture = 0;
- std::string tag;
- std::string command;
- FileTarget *executable = 0;
- std::vector<std::string> input_suffixes;
- std::vector<std::string> aux_suffixes;
- ProcessingUnit processing_unit = ONE_FILE;
- VirtualFileSystem::SearchPath system_path;
- BuildInfo build_info;
- bool prepared = false;
- std::vector<std::string> problems;
-
- Tool(Builder &, const std::string &);
- Tool(Builder &, const Architecture &, const std::string &);
-private:
- Tool(Builder &, const Architecture *, const std::string &);
-public:
- virtual ~Tool() { }
-
- const std::string &get_tag() const { return tag; }
-
- /** Returns the architecture this tool builds 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::vector<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::vector<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; }
-
- /// 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::vector<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::vector<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;
-};
-
-/**
-Intermediate base class for tool facets. For example, a linker may need to
-use different commands depending on whether C++ source files are present or
-not, but their presence can't be directly determined from the object files.
-*/
-class SubTool: public Tool
-{
-protected:
- 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::vector<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
projects / builder.git / blobdiff