Utility to run a FrontendAction in a single clang invocation. More...

#include "clang/Tooling/Tooling.h"

Public Member Functions
	ToolInvocation (std::vector< std::string > CommandLine, std::unique_ptr< FrontendAction > FAction, FileManager *Files, std::shared_ptr< PCHContainerOperations > PCHContainerOps=std::make_shared< PCHContainerOperations >())
	Create a tool invocation.

	ToolInvocation (std::vector< std::string > CommandLine, ToolAction Action, FileManager Files, std::shared_ptr< PCHContainerOperations > PCHContainerOps)
	Create a tool invocation.

	~ToolInvocation ()

void	setDiagnosticConsumer (DiagnosticConsumer *DiagConsumer)
	Set a `DiagnosticConsumer` to use during driver command-line parsing and the action invocation itself.

void	setDiagnosticOptions (DiagnosticOptions *DiagOpts)
	Set a `DiagnosticOptions` to use during driver command-line parsing.

bool	run ()
	Run the clang invocation.

Detailed Description

Utility to run a FrontendAction in a single clang invocation.

Definition at line 239 of file Tooling.h.

Constructor & Destructor Documentation

◆ ToolInvocation() [1/2]

ToolInvocation::ToolInvocation	(	std::vector< std::string >	CommandLine,
		std::unique_ptr< FrontendAction >	FAction,
		FileManager *	Files,
		std::shared_ptr< PCHContainerOperations >	PCHContainerOps = `std::make_shared<PCHContainerOperations>()`
	)

Create a tool invocation.

Parameters

CommandLine	The command line arguments to clang. Note that clang uses its binary name (CommandLine[0]) to locate its builtin headers. Callers have to ensure that they are installed in a compatible location (see clang driver implementation) or mapped in via mapVirtualFile.
FAction	The action to be executed.
Files	The FileManager used for the execution. Class does not take ownership.
PCHContainerOps	The PCHContainerOperations for loading and creating clang modules.

Definition at line 353 of file Tooling.cpp.

◆ ToolInvocation() [2/2]

ToolInvocation::ToolInvocation	(	std::vector< std::string >	CommandLine,
		ToolAction *	Action,
		FileManager *	Files,
		std::shared_ptr< PCHContainerOperations >	PCHContainerOps
	)

Create a tool invocation.

Parameters

CommandLine	The command line arguments to clang.
Action	The action to be executed.
Files	The FileManager used for the execution.
PCHContainerOps	The PCHContainerOperations for loading and creating clang modules.

Definition at line 347 of file Tooling.cpp.

◆ ~ToolInvocation()

ToolInvocation::~ToolInvocation ( )

Definition at line 362 of file Tooling.cpp.

Member Function Documentation

◆ run()

bool ToolInvocation::run ( )

Run the clang invocation.

Returns: True if there were no errors during execution.

Definition at line 367 of file Tooling.cpp.

References clang::CreateAndPopulateDiagOpts(), clang::CompilerInstance::createDiagnostics(), clang::tooling::getCC1Arguments(), clang::FileManager::getFileSystemOpts(), clang::FileManager::getVirtualFileSystem(), newDriver(), clang::tooling::newInvocation(), clang::tooling::ToolAction::runInvocation(), and clang::FileSystemOptions::WorkingDir.

Referenced by clang::tooling::buildASTFromCodeWithArgs(), clang::tooling::dependencies::DependencyScanningWorker::computeDependencies(), and clang::tooling::runToolOnCodeWithArgs().

◆ setDiagnosticConsumer()

void clang::tooling::ToolInvocation::setDiagnosticConsumer ( DiagnosticConsumer * DiagConsumer )

inline

Set a DiagnosticConsumer to use during driver command-line parsing and the action invocation itself.

Definition at line 272 of file Tooling.h.

Referenced by clang::tooling::buildASTFromCodeWithArgs(), and clang::tooling::dependencies::DependencyScanningWorker::computeDependencies().

◆ setDiagnosticOptions()

void clang::tooling::ToolInvocation::setDiagnosticOptions ( DiagnosticOptions * DiagOpts )

inline

Set a DiagnosticOptions to use during driver command-line parsing.

Definition at line 277 of file Tooling.h.

Referenced by clang::tooling::dependencies::DependencyScanningWorker::computeDependencies().

The documentation for this class was generated from the following files:

include/clang/Tooling/Tooling.h
lib/Tooling/Tooling.cpp

Public Member Functions