//===--- IndexTests.cpp - Test indexing actions -----------------*- 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 // //===----------------------------------------------------------------------===// #include "clang/AST/ASTConsumer.h" #include "clang/AST/ASTContext.h" #include "clang/AST/Decl.h" #include "clang/Basic/SourceLocation.h" #include "clang/Basic/SourceManager.h" #include "clang/Frontend/CompilerInstance.h" #include "clang/Frontend/FrontendAction.h" #include "clang/Index/IndexDataConsumer.h" #include "clang/Index/IndexSymbol.h" #include "clang/Index/IndexingAction.h" #include "clang/Lex/Preprocessor.h" #include "clang/Tooling/Tooling.h" #include "llvm/ADT/StringRef.h" #include "llvm/Support/VirtualFileSystem.h" #include "gmock/gmock.h" #include "gtest/gtest.h" #include namespace clang { namespace index { namespace { struct Position { size_t Line = 0; size_t Column = 0; Position(size_t Line = 0, size_t Column = 0) : Line(Line), Column(Column) {} static Position fromSourceLocation(SourceLocation Loc, const SourceManager &SM) { FileID FID; unsigned Offset; std::tie(FID, Offset) = SM.getDecomposedSpellingLoc(Loc); Position P; P.Line = SM.getLineNumber(FID, Offset); P.Column = SM.getColumnNumber(FID, Offset); return P; } }; bool operator==(const Position &LHS, const Position &RHS) { return std::tie(LHS.Line, LHS.Column) == std::tie(RHS.Line, RHS.Column); } llvm::raw_ostream &operator<<(llvm::raw_ostream &OS, const Position &Pos) { return OS << Pos.Line << ':' << Pos.Column; } struct TestSymbol { std::string QName; Position WrittenPos; Position DeclPos; SymbolInfo SymInfo; SymbolRoleSet Roles; // FIXME: add more information. }; llvm::raw_ostream &operator<<(llvm::raw_ostream &OS, const TestSymbol &S) { return OS << S.QName << '[' << S.WrittenPos << ']' << '@' << S.DeclPos << '(' << static_cast(S.SymInfo.Kind) << ')'; } class Indexer : public IndexDataConsumer { public: void initialize(ASTContext &Ctx) override { AST = &Ctx; IndexDataConsumer::initialize(Ctx); } bool handleDeclOccurrence(const Decl *D, SymbolRoleSet Roles, ArrayRef, SourceLocation Loc, ASTNodeInfo) override { const auto *ND = llvm::dyn_cast(D); if (!ND) return true; TestSymbol S; S.SymInfo = getSymbolInfo(D); S.QName = ND->getQualifiedNameAsString(); S.WrittenPos = Position::fromSourceLocation(Loc, AST->getSourceManager()); S.DeclPos = Position::fromSourceLocation(D->getLocation(), AST->getSourceManager()); S.Roles = Roles; Symbols.push_back(std::move(S)); return true; } bool handleMacroOccurrence(const IdentifierInfo *Name, const MacroInfo *MI, SymbolRoleSet Roles, SourceLocation Loc) override { TestSymbol S; S.SymInfo = getSymbolInfoForMacro(*MI); S.QName = std::string(Name->getName()); S.WrittenPos = Position::fromSourceLocation(Loc, AST->getSourceManager()); S.DeclPos = Position::fromSourceLocation(MI->getDefinitionLoc(), AST->getSourceManager()); S.Roles = Roles; Symbols.push_back(std::move(S)); return true; } std::vector Symbols; const ASTContext *AST = nullptr; }; class IndexAction : public ASTFrontendAction { public: IndexAction(std::shared_ptr Index, IndexingOptions Opts = IndexingOptions()) : Index(std::move(Index)), Opts(Opts) {} protected: std::unique_ptr CreateASTConsumer(CompilerInstance &CI, StringRef InFile) override { class Consumer : public ASTConsumer { std::shared_ptr Index; std::shared_ptr PP; IndexingOptions Opts; public: Consumer(std::shared_ptr Index, std::shared_ptr PP, IndexingOptions Opts) : Index(std::move(Index)), PP(std::move(PP)), Opts(Opts) {} void HandleTranslationUnit(ASTContext &Ctx) override { std::vector DeclsToIndex( Ctx.getTranslationUnitDecl()->decls().begin(), Ctx.getTranslationUnitDecl()->decls().end()); indexTopLevelDecls(Ctx, *PP, DeclsToIndex, *Index, Opts); } }; return std::make_unique(Index, CI.getPreprocessorPtr(), Opts); } private: std::shared_ptr Index; IndexingOptions Opts; }; using testing::AllOf; using testing::Contains; using testing::Not; using testing::UnorderedElementsAre; MATCHER_P(QName, Name, "") { return arg.QName == Name; } MATCHER_P(WrittenAt, Pos, "") { return arg.WrittenPos == Pos; } MATCHER_P(DeclAt, Pos, "") { return arg.DeclPos == Pos; } MATCHER_P(Kind, SymKind, "") { return arg.SymInfo.Kind == SymKind; } MATCHER_P(HasRole, Role, "") { return arg.Roles & static_cast(Role); } TEST(IndexTest, Simple) { auto Index = std::make_shared(); tooling::runToolOnCode(std::make_unique(Index), "class X {}; void f() {}"); EXPECT_THAT(Index->Symbols, UnorderedElementsAre(QName("X"), QName("f"))); } TEST(IndexTest, IndexPreprocessorMacros) { std::string Code = "#define INDEX_MAC 1"; auto Index = std::make_shared(); IndexingOptions Opts; Opts.IndexMacrosInPreprocessor = true; tooling::runToolOnCode(std::make_unique(Index, Opts), Code); EXPECT_THAT(Index->Symbols, Contains(QName("INDEX_MAC"))); Opts.IndexMacrosInPreprocessor = false; Index->Symbols.clear(); tooling::runToolOnCode(std::make_unique(Index, Opts), Code); EXPECT_THAT(Index->Symbols, UnorderedElementsAre()); } TEST(IndexTest, IndexParametersInDecls) { std::string Code = "void foo(int bar);"; auto Index = std::make_shared(); IndexingOptions Opts; Opts.IndexFunctionLocals = true; Opts.IndexParametersInDeclarations = true; tooling::runToolOnCode(std::make_unique(Index, Opts), Code); EXPECT_THAT(Index->Symbols, Contains(QName("bar"))); Opts.IndexParametersInDeclarations = false; Index->Symbols.clear(); tooling::runToolOnCode(std::make_unique(Index, Opts), Code); EXPECT_THAT(Index->Symbols, Not(Contains(QName("bar")))); } TEST(IndexTest, IndexExplicitTemplateInstantiation) { std::string Code = R"cpp( template struct Foo { void bar() {} }; template <> struct Foo { void bar() {} }; void foo() { Foo abc; Foo b; } )cpp"; auto Index = std::make_shared(); IndexingOptions Opts; tooling::runToolOnCode(std::make_unique(Index, Opts), Code); EXPECT_THAT(Index->Symbols, AllOf(Contains(AllOf(QName("Foo"), WrittenAt(Position(8, 7)), DeclAt(Position(5, 12)))), Contains(AllOf(QName("Foo"), WrittenAt(Position(7, 7)), DeclAt(Position(3, 12)))))); } TEST(IndexTest, IndexTemplateInstantiationPartial) { std::string Code = R"cpp( template struct Foo { void bar() {} }; template struct Foo { void bar() {} }; void foo() { Foo abc; Foo b; } )cpp"; auto Index = std::make_shared(); IndexingOptions Opts; tooling::runToolOnCode(std::make_unique(Index, Opts), Code); EXPECT_THAT(Index->Symbols, Contains(AllOf(QName("Foo"), WrittenAt(Position(8, 7)), DeclAt(Position(5, 12))))); } TEST(IndexTest, IndexTypeParmDecls) { std::string Code = R"cpp( template class C, typename NoRef> struct Foo { T t = I; C x; }; )cpp"; auto Index = std::make_shared(); IndexingOptions Opts; tooling::runToolOnCode(std::make_unique(Index, Opts), Code); EXPECT_THAT(Index->Symbols, AllOf(Not(Contains(QName("Foo::T"))), Not(Contains(QName("Foo::I"))), Not(Contains(QName("Foo::C"))), Not(Contains(QName("Foo::NoRef"))))); Opts.IndexTemplateParameters = true; Index->Symbols.clear(); tooling::runToolOnCode(std::make_unique(Index, Opts), Code); EXPECT_THAT(Index->Symbols, AllOf(Contains(AllOf(QName("Foo::T"), Kind(SymbolKind::TemplateTypeParm))), Contains(AllOf(QName("Foo::I"), Kind(SymbolKind::NonTypeTemplateParm))), Contains(AllOf(QName("Foo::C"), Kind(SymbolKind::TemplateTemplateParm))), Contains(QName("Foo::NoRef")))); } TEST(IndexTest, UsingDecls) { std::string Code = R"cpp( void foo(int bar); namespace std { using ::foo; } )cpp"; auto Index = std::make_shared(); IndexingOptions Opts; tooling::runToolOnCode(std::make_unique(Index, Opts), Code); EXPECT_THAT(Index->Symbols, Contains(AllOf(QName("std::foo"), Kind(SymbolKind::Using)))); } TEST(IndexTest, Constructors) { std::string Code = R"cpp( struct Foo { Foo(int); ~Foo(); }; )cpp"; auto Index = std::make_shared(); IndexingOptions Opts; tooling::runToolOnCode(std::make_unique(Index, Opts), Code); EXPECT_THAT( Index->Symbols, UnorderedElementsAre( AllOf(QName("Foo"), Kind(SymbolKind::Struct), WrittenAt(Position(2, 12))), AllOf(QName("Foo::Foo"), Kind(SymbolKind::Constructor), WrittenAt(Position(3, 7))), AllOf(QName("Foo"), Kind(SymbolKind::Struct), HasRole(SymbolRole::NameReference), WrittenAt(Position(3, 7))), AllOf(QName("Foo::~Foo"), Kind(SymbolKind::Destructor), WrittenAt(Position(4, 7))), AllOf(QName("Foo"), Kind(SymbolKind::Struct), HasRole(SymbolRole::NameReference), WrittenAt(Position(4, 8))))); } TEST(IndexTest, InjecatedNameClass) { std::string Code = R"cpp( template class Foo { void f(Foo x); }; )cpp"; auto Index = std::make_shared(); IndexingOptions Opts; tooling::runToolOnCode(std::make_unique(Index, Opts), Code); EXPECT_THAT(Index->Symbols, UnorderedElementsAre(AllOf(QName("Foo"), Kind(SymbolKind::Class), WrittenAt(Position(3, 11))), AllOf(QName("Foo::f"), Kind(SymbolKind::InstanceMethod), WrittenAt(Position(4, 12))), AllOf(QName("Foo"), Kind(SymbolKind::Class), HasRole(SymbolRole::Reference), WrittenAt(Position(4, 14))))); } TEST(IndexTest, VisitDefaultArgs) { std::string Code = R"cpp( int var = 0; void f(int s = var) {} )cpp"; auto Index = std::make_shared(); IndexingOptions Opts; Opts.IndexFunctionLocals = true; Opts.IndexParametersInDeclarations = true; tooling::runToolOnCode(std::make_unique(Index, Opts), Code); EXPECT_THAT(Index->Symbols, Contains(AllOf(QName("var"), HasRole(SymbolRole::Reference), WrittenAt(Position(3, 20))))); } TEST(IndexTest, RelationBaseOf) { std::string Code = R"cpp( class A {}; template class B {}; class C : B {}; )cpp"; auto Index = std::make_shared(); tooling::runToolOnCode(std::make_unique(Index), Code); // A should not be the base of anything. EXPECT_THAT(Index->Symbols, Contains(AllOf(QName("A"), HasRole(SymbolRole::Reference), Not(HasRole(SymbolRole::RelationBaseOf))))); } } // namespace } // namespace index } // namespace clang