mirror of
https://github.com/carbon-language/carbon-lang.git
synced 2026-09-24 22:02:23 +01:00
Chandler CarruthandGeoff Romer
1459332031
This adds support for most of the remaining LLVM command line tools using a generic, generated wrapper. The subcommand interface for these is (much) less interesting than our other subcommands, but it gives us a uniform and consistent layer. Note that I structured these as nested sub-sub-commands below an `llvm` subcommand because of an expectation that we will want to add more, and ones that don't use this generic layer. Some concrete future work: - Add the `opt` and `llc` tools as subcommands for easier debugging and experimentation with LLVM IR output from Carbon's toolchain. - Potentially sink `lld` below the `llvm` layer given that it has significantly less user visibility than commands like `clang`. Unfortunately, the current driver subcommand APIs make nested subcommands awkward. I've added a somewhat rough hack here to let the LLVM tools go in, but there are some TODOs that I want to address in a follow-up that works to adjust the structure of this code to be more conducive to nesting like this. Depends on #5048 -- only the last commit should be reviewed here. --------- Co-authored-by: Geoff Romer <gromer@google.com>
80 lines
2.7 KiB
C++
80 lines
2.7 KiB
C++
// Part of the Carbon Language project, under the Apache License v2.0 with LLVM
|
|
// Exceptions. See /LICENSE for license information.
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
|
|
#ifndef CARBON_TOOLCHAIN_DRIVER_DRIVER_SUBCOMMAND_H_
|
|
#define CARBON_TOOLCHAIN_DRIVER_DRIVER_SUBCOMMAND_H_
|
|
|
|
#include "common/command_line.h"
|
|
#include "common/ostream.h"
|
|
#include "llvm/Support/VirtualFileSystem.h"
|
|
#include "toolchain/driver/driver_env.h"
|
|
#include "toolchain/install/install_paths.h"
|
|
|
|
namespace Carbon {
|
|
|
|
// The result of a driver run.
|
|
struct DriverResult {
|
|
// Overall success result.
|
|
bool success;
|
|
|
|
// Per-file success results. May be empty if files aren't individually
|
|
// processed.
|
|
llvm::SmallVector<std::pair<std::string, bool>> per_file_success = {};
|
|
};
|
|
|
|
// A subcommand for the driver.
|
|
class DriverSubcommand {
|
|
public:
|
|
explicit DriverSubcommand(CommandLine::CommandInfo info) : info_(info) {}
|
|
|
|
// Adds the subcommand to the main command, assigning `selected_command` when
|
|
// the subcommand is in use.
|
|
auto AddTo(CommandLine::CommandBuilder& b,
|
|
DriverSubcommand** selected_subcommand) -> void {
|
|
b.AddSubcommand(
|
|
info_, [this, selected_subcommand](CommandLine::CommandBuilder& sub_b) {
|
|
BuildOptionsAndSetAction(sub_b, selected_subcommand);
|
|
});
|
|
}
|
|
|
|
// Adds command line options.
|
|
virtual auto BuildOptions(CommandLine::CommandBuilder& b) -> void = 0;
|
|
|
|
// Adds command line options and registers the `Run` method to be called.
|
|
//
|
|
// For more complex subcommands that need to control the action this method
|
|
// can be overridden and bypass the simple API above.
|
|
//
|
|
// TODO: This isn't the most elegant way to manage this. There is probably a
|
|
// better factoring / organization of the driver subcommand infrastructure
|
|
// that bakes in the needed flexibility here, but that was deferred for a
|
|
// future refactoring.
|
|
virtual auto BuildOptionsAndSetAction(CommandLine::CommandBuilder& b,
|
|
DriverSubcommand** selected_subcommand)
|
|
-> void {
|
|
BuildOptions(b);
|
|
b.Do([this, selected_subcommand] { *selected_subcommand = this; });
|
|
}
|
|
|
|
// Runs the command.
|
|
virtual auto Run(DriverEnv& driver_env) -> DriverResult = 0;
|
|
|
|
protected:
|
|
// Diagnoses and returns false if currently fuzzing.
|
|
//
|
|
// This should be used in subcommands to check and diagnose rather than
|
|
// entering them during fuzzing when they use external libraries that we can't
|
|
// keep fuzz-clean.
|
|
auto DisableFuzzingExternalLibraries(DriverEnv& driver_env,
|
|
llvm::StringRef name) -> bool;
|
|
|
|
private:
|
|
// Subcommand information.
|
|
CommandLine::CommandInfo info_;
|
|
};
|
|
|
|
} // namespace Carbon
|
|
|
|
#endif // CARBON_TOOLCHAIN_DRIVER_DRIVER_SUBCOMMAND_H_
|