clang  7.0.0svn
AllTUsExecution.h
Go to the documentation of this file.
1 //===--- AllTUsExecution.h - Execute actions on all TUs. -*- C++ --------*-===//
2 //
3 // The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 //
10 // This file defines a tool executor that runs given actions on all TUs in the
11 // compilation database. Tool results are deuplicated by the result key.
12 //
13 //===----------------------------------------------------------------------===//
14 
15 #ifndef LLVM_CLANG_TOOLING_ALLTUSEXECUTION_H
16 #define LLVM_CLANG_TOOLING_ALLTUSEXECUTION_H
17 
20 
21 namespace clang {
22 namespace tooling {
23 
24 /// Executes given frontend actions on all files/TUs in the compilation
25 /// database.
27 public:
28  static const char *ExecutorName;
29 
30  /// Init with \p CompilationDatabase.
31  /// This uses \p ThreadCount threads to exececute the actions on all files in
32  /// parallel. If \p ThreadCount is 0, this uses `llvm::hardware_concurrency`.
33  AllTUsToolExecutor(const CompilationDatabase &Compilations,
34  unsigned ThreadCount,
35  std::shared_ptr<PCHContainerOperations> PCHContainerOps =
36  std::make_shared<PCHContainerOperations>());
37 
38  /// Init with \p CommonOptionsParser. This is expected to be used by
39  /// `createExecutorFromCommandLineArgs` based on commandline options.
40  ///
41  /// The executor takes ownership of \p Options.
42  AllTUsToolExecutor(CommonOptionsParser Options, unsigned ThreadCount,
43  std::shared_ptr<PCHContainerOperations> PCHContainerOps =
44  std::make_shared<PCHContainerOperations>());
45 
46  StringRef getExecutorName() const override { return ExecutorName; }
47 
49 
52  std::pair<std::unique_ptr<FrontendActionFactory>, ArgumentsAdjuster>>
53  Actions) override;
54 
55  ExecutionContext *getExecutionContext() override { return &Context; };
56 
57  ToolResults *getToolResults() override { return Results.get(); }
58 
59  void mapVirtualFile(StringRef FilePath, StringRef Content) override {
60  OverlayFiles[FilePath] = Content;
61  }
62 
63 private:
64  // Used to store the parser when the executor is initialized with parser.
66  const CompilationDatabase &Compilations;
67  std::unique_ptr<ToolResults> Results;
68  ExecutionContext Context;
69  llvm::StringMap<std::string> OverlayFiles;
70  unsigned ThreadCount;
71 };
72 
73 } // end namespace tooling
74 } // end namespace clang
75 
76 #endif // LLVM_CLANG_TOOLING_ALLTUSEXECUTION_H
virtual llvm::Error execute(llvm::ArrayRef< std::pair< std::unique_ptr< FrontendActionFactory >, ArgumentsAdjuster >> Actions)=0
Executes each action with a corresponding arguments adjuster.
ExecutionContext * getExecutionContext() override
Returns a reference to the execution context.
void mapVirtualFile(StringRef FilePath, StringRef Content) override
Map a virtual file to be used while running the tool.
StringRef getExecutorName() const override
Returns the name of a specific executor.
The context of an execution, including the information about compilation and results.
Definition: Execution.h:77
Interface for executing clang frontend actions.
Definition: Execution.h:111
std::function< CommandLineArguments(const CommandLineArguments &, StringRef Filename)> ArgumentsAdjuster
A prototype of a command line adjuster.
llvm::Error execute(llvm::ArrayRef< std::pair< std::unique_ptr< FrontendActionFactory >, ArgumentsAdjuster >> Actions) override
Executes each action with a corresponding arguments adjuster.
Interface for compilation databases.
A parser for options common to all command-line Clang tools.
Executes given frontend actions on all files/TUs in the compilation database.
Dataflow Directional Tag Classes.
An abstraction for the result of a tool execution.
Definition: Execution.h:45
AllTUsToolExecutor(const CompilationDatabase &Compilations, unsigned ThreadCount, std::shared_ptr< PCHContainerOperations > PCHContainerOps=std::make_shared< PCHContainerOperations >())
Init with CompilationDatabase.
ToolResults * getToolResults() override
Returns a reference to the result container.