6024e5c395
clang 20.0.0 (based on r547379) from build 12806354. Bug: http://b/379133546 Test: N/A Change-Id: I2eb8938af55d809de674be63cb30cf27e801862b Upstream-Commit: ad834e67b1105d15ef907f6255d4c96e8e733f57
90 lines
3.4 KiB
C++
90 lines
3.4 KiB
C++
//===- ExtractAPI/FrontendActions.h -----------------------------*- C++ -*-===//
|
|
//
|
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
// See https://llvm.org/LICENSE.txt for license information.
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
///
|
|
/// \file
|
|
/// This file defines the ExtractAPIAction and WrappingExtractAPIAction frontend
|
|
/// actions.
|
|
///
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef LLVM_CLANG_EXTRACTAPI_FRONTEND_ACTIONS_H
|
|
#define LLVM_CLANG_EXTRACTAPI_FRONTEND_ACTIONS_H
|
|
|
|
#include "clang/ExtractAPI/ExtractAPIActionBase.h"
|
|
#include "clang/Frontend/FrontendAction.h"
|
|
|
|
namespace clang {
|
|
|
|
/// ExtractAPIAction sets up the output file and creates the ExtractAPIVisitor.
|
|
class ExtractAPIAction : public ASTFrontendAction,
|
|
private ExtractAPIActionBase {
|
|
protected:
|
|
std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
|
|
StringRef InFile) override;
|
|
|
|
private:
|
|
|
|
/// The input file originally provided on the command line.
|
|
///
|
|
/// This captures the spelling used to include the file and whether the
|
|
/// include is quoted or not.
|
|
SmallVector<std::pair<SmallString<32>, bool>> KnownInputFiles;
|
|
|
|
/// Prepare to execute the action on the given CompilerInstance.
|
|
///
|
|
/// This is called before executing the action on any inputs. This generates a
|
|
/// single header that includes all of CI's inputs and replaces CI's input
|
|
/// list with it before actually executing the action.
|
|
bool PrepareToExecuteAction(CompilerInstance &CI) override;
|
|
|
|
/// Called after executing the action on the synthesized input buffer.
|
|
///
|
|
/// Note: Now that we have gathered all the API definitions to surface we can
|
|
/// emit them in this callback.
|
|
void EndSourceFileAction() override;
|
|
|
|
static StringRef getInputBufferName() { return "<extract-api-includes>"; }
|
|
};
|
|
|
|
/// Wrap ExtractAPIAction on top of a pre-existing action
|
|
///
|
|
/// Used when the ExtractAPI action needs to be executed as a side effect of a
|
|
/// regular compilation job. Unlike ExtarctAPIAction, this is meant to be used
|
|
/// on regular source files ( .m , .c files) instead of header files
|
|
class WrappingExtractAPIAction : public WrapperFrontendAction,
|
|
private ExtractAPIActionBase {
|
|
public:
|
|
WrappingExtractAPIAction(std::unique_ptr<FrontendAction> WrappedAction)
|
|
: WrapperFrontendAction(std::move(WrappedAction)) {}
|
|
|
|
protected:
|
|
/// Create ExtractAPI consumer multiplexed on another consumer.
|
|
///
|
|
/// This allows us to execute ExtractAPI action while on top of
|
|
std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
|
|
StringRef InFile) override;
|
|
|
|
private:
|
|
/// Flag to check if the wrapper front end action's consumer is
|
|
/// craeted or not
|
|
bool CreatedASTConsumer = false;
|
|
|
|
void EndSourceFile() override { FrontendAction::EndSourceFile(); }
|
|
|
|
/// Called after executing the action on the synthesized input buffer.
|
|
///
|
|
/// Executes both Wrapper and ExtractAPIBase end source file
|
|
/// actions. This is the place where all the gathered symbol graph
|
|
/// information is emited.
|
|
void EndSourceFileAction() override;
|
|
};
|
|
|
|
} // namespace clang
|
|
|
|
#endif // LLVM_CLANG_EXTRACTAPI_FRONTEND_ACTIONS_H
|