28#include "clang/Sema/CodeCompleteConsumer.h"
29#include "clang/Tooling/CompilationDatabase.h"
30#include "llvm/ADT/StringRef.h"
31#include "llvm/Support/Error.h"
32#include "llvm/Support/Path.h"
33#include "llvm/Testing/Annotations/Annotations.h"
34#include "llvm/Testing/Support/Error.h"
35#include "llvm/Testing/Support/SupportHelpers.h"
36#include "gmock/gmock.h"
37#include "gtest/gtest.h"
38#include <condition_variable>
48using ::testing::AllOf;
49using ::testing::Contains;
50using ::testing::ElementsAre;
51using ::testing::Field;
52using ::testing::HasSubstr;
53using ::testing::IsEmpty;
55using ::testing::UnorderedElementsAre;
56using ContextKind = CodeCompletionContext::Kind;
59MATCHER_P(named, Name,
"") {
return arg.Name == Name; }
60MATCHER_P(mainFileRefs, Refs,
"") {
return arg.MainFileRefs == Refs; }
61MATCHER_P(scopeRefs, Refs,
"") {
return arg.ScopeRefsInFile == Refs; }
63 return llvm::StringRef(arg.Name).starts_with(Prefix);
65MATCHER_P(filterText, F,
"") {
return arg.FilterText == F; }
66MATCHER_P(scope, S,
"") {
return arg.Scope == S; }
67MATCHER_P(qualifier, Q,
"") {
return arg.RequiredQualifier == Q; }
69 return arg.RequiredQualifier + arg.Name + arg.Signature ==
Label;
72MATCHER_P(kind, K,
"") {
return arg.Kind == K; }
74 return arg.Documentation && arg.Documentation->asPlainText() ==
D;
76MATCHER_P(returnType, D,
"") {
return arg.ReturnType ==
D; }
78 return !arg.Includes.empty() && arg.Includes[0].Header == IncludeHeader;
80MATCHER_P(insertInclude, IncludeHeader,
"") {
81 return !arg.Includes.empty() && arg.Includes[0].Header == IncludeHeader &&
82 bool(arg.Includes[0].Insertion);
84MATCHER_P(insertIncludeText, InsertedText,
"") {
85 return !arg.Includes.empty() && arg.Includes[0].Insertion &&
86 arg.Includes[0].Insertion->newText == InsertedText;
89 return !arg.Includes.empty() && bool(arg.Includes[0].Insertion);
92MATCHER_P(origin, OriginSet,
"") {
return arg.Origin == OriginSet; }
93MATCHER_P(signature, S,
"") {
return arg.Signature == S; }
95 return arg.CompletionInsertRange ==
Range;
99Matcher<const std::vector<CodeCompletion> &> has(std::string Name) {
100 return Contains(named(std::move(Name)));
102Matcher<const std::vector<CodeCompletion> &> has(std::string Name,
104 return Contains(AllOf(named(std::move(Name)), kind(K)));
106MATCHER(isDocumented,
"") {
return arg.Documentation.has_value(); }
107MATCHER(deprecated,
"") {
return arg.Deprecated; }
109std::unique_ptr<SymbolIndex> memIndex(std::vector<Symbol>
Symbols) {
111 for (
const auto &Sym :
Symbols)
119 std::vector<Symbol> IndexSymbols = {},
120 clangd::CodeCompleteOptions Opts = {}) {
121 std::unique_ptr<SymbolIndex> OverrideIndex;
122 if (!IndexSymbols.empty()) {
123 assert(!Opts.Index &&
"both Index and IndexSymbols given!");
124 OverrideIndex = memIndex(std::move(IndexSymbols));
125 Opts.Index = OverrideIndex.get();
129 auto Inputs = TU.inputs(FS);
133 ADD_FAILURE() <<
"Couldn't build CompilerInvocation";
143CodeCompleteResult completions(llvm::StringRef
Text,
144 std::vector<Symbol> IndexSymbols = {},
145 clangd::CodeCompleteOptions Opts = {},
146 PathRef FilePath =
"foo.cpp") {
150 TU.Filename = FilePath.str();
151 return completions(TU, Test.point(), std::move(IndexSymbols),
156CodeCompleteResult completionsNoCompile(llvm::StringRef
Text,
157 std::vector<Symbol> IndexSymbols = {},
158 clangd::CodeCompleteOptions Opts = {},
159 PathRef FilePath =
"foo.cpp") {
160 std::unique_ptr<SymbolIndex> OverrideIndex;
161 if (!IndexSymbols.empty()) {
162 assert(!Opts.Index &&
"both Index and IndexSymbols given!");
163 OverrideIndex = memIndex(std::move(IndexSymbols));
164 Opts.Index = OverrideIndex.get();
169 ParseInputs ParseInput{tooling::CompileCommand(), &FS, Test.code().str()};
170 return codeComplete(FilePath, Test.point(),
nullptr, ParseInput,
179#if CLANGD_DECISION_FOREST
180TEST(DecisionForestRankingModel, NameMatchSanityTest) {
181 clangd::CodeCompleteOptions Opts;
182 Opts.RankingModel = CodeCompleteOptions::DecisionForest;
183 auto Results = completions(
187 int AlphaBetaGamma();
189int func() { MemberAccess().ABG^ }
192 EXPECT_THAT(Results.Completions,
193 ElementsAre(named(
"ABG"), named(
"AlphaBetaGamma")));
196TEST(DecisionForestRankingModel, ReferencesAffectRanking) {
197 clangd::CodeCompleteOptions Opts;
198 Opts.RankingModel = CodeCompleteOptions::DecisionForest;
199 constexpr int NumReferences = 100000;
201 completions(
"int main() { clang^ }",
202 {
ns(
"clangA"), withReferences(NumReferences,
func(
"clangD"))},
205 ElementsAre(named(
"clangD"), named(
"clangA")));
207 completions(
"int main() { clang^ }",
208 {withReferences(NumReferences,
ns(
"clangA")),
func(
"clangD")},
211 ElementsAre(named(
"clangA"), named(
"clangD")));
215TEST(DecisionForestRankingModel, DecisionForestScorerCallbackTest) {
216 clangd::CodeCompleteOptions Opts;
217 constexpr float MagicNumber = 1234.5678f;
218 Opts.RankingModel = CodeCompleteOptions::DecisionForest;
222 Scores.
Total = MagicNumber;
223 Scores.ExcludingName = MagicNumber;
226 llvm::StringRef Code =
"int func() { int xyz; xy^ }";
227 auto Results = completions(Code,
229 ASSERT_EQ(Results.Completions.size(), 1u);
230 EXPECT_EQ(Results.Completions[0].Score.Total, MagicNumber);
231 EXPECT_EQ(Results.Completions[0].Score.ExcludingName, MagicNumber);
234 Opts.RankingModel = CodeCompleteOptions::Heuristics;
235 Results = completions(Code,
237 ASSERT_EQ(Results.Completions.size(), 1u);
238 EXPECT_NE(Results.Completions[0].Score.Total, MagicNumber);
239 EXPECT_NE(Results.Completions[0].Score.ExcludingName, MagicNumber);
242TEST(CompletionTest, Limit) {
243 clangd::CodeCompleteOptions Opts;
245 auto Results = completions(R
"cpp(
246struct ClassWithMembers {
252int main() { ClassWithMembers().^ }
256 EXPECT_TRUE(Results.HasMore);
257 EXPECT_THAT(Results.Completions, ElementsAre(named(
"AAA"), named(
"BBB")));
260TEST(CompletionTest, Filter) {
261 std::string Body = R
"cpp(
272 EXPECT_THAT(completions(Body +
"int main() { S().Foba^ }").Completions,
273 AllOf(has(
"FooBar"), has(
"FooBaz"), Not(has(
"Qux"))));
277 Sym.SymInfo.Kind = index::SymbolKind::Macro;
279 completions(Body +
"int main() { C^ }", {Sym}).Completions,
280 AllOf(has(
"Car"), Not(has(
"MotorCar")), Not(has(
"MotorCarIndex"))));
281 EXPECT_THAT(completions(Body +
"int main() { M^ }", {Sym}).Completions,
282 AllOf(has(
"MotorCar"), has(
"MotorCarIndex")));
285void testAfterDotCompletion(clangd::CodeCompleteOptions Opts) {
286 auto Results = completions(
292 // Make sure this is not in preamble.
295 struct GlobalClass {};
297 struct ClassWithMembers {
307 struct LocalClass {};
315 {
cls(
"IndexClass"),
var(
"index_var"),
func(
"index_func")}, Opts);
317 EXPECT_TRUE(Results.RanParser);
320 EXPECT_THAT(Results.Completions,
321 AllOf(has(
"method"), has(
"field"), Not(has(
"ClassWithMembers")),
322 Not(has(
"operator=")), Not(has(
"~ClassWithMembers"))));
323 EXPECT_IFF(Opts.IncludeIneligibleResults, Results.Completions,
324 has(
"private_field"));
328 Not(AnyOf(has(
"global_var"), has(
"index_var"), has(
"global_func"),
329 has(
"global_func()"), has(
"index_func"), has(
"GlobalClass"),
330 has(
"IndexClass"), has(
"MACRO"), has(
"LocalClass"))));
333 EXPECT_THAT(Results.Completions,
336 EXPECT_THAT(Results.Completions, Contains(isDocumented()));
339void testGlobalScopeCompletion(clangd::CodeCompleteOptions Opts) {
340 auto Results = completions(
345 // Make sure this is not in preamble.
348 struct GlobalClass {};
350 struct ClassWithMembers {
356 struct LocalClass {};
364 {
cls(
"IndexClass"),
var(
"index_var"),
func(
"index_func")}, Opts);
366 EXPECT_TRUE(Results.RanParser);
368 EXPECT_THAT(Results.Completions,
369 Not(AnyOf(has(
"method"), has(
"method()"), has(
"field"))));
371 EXPECT_THAT(Results.Completions,
372 AllOf(has(
"global_var"), has(
"index_var"), has(
"global_func"),
374 has(
"GlobalClass"), has(
"IndexClass")));
376 EXPECT_THAT(Results.Completions, has(
"MACRO"));
378 EXPECT_THAT(Results.Completions,
379 AllOf(has(
"local_var"), has(
"LocalClass"),
382 EXPECT_THAT(Results.Completions, Contains(isDocumented()));
385TEST(CompletionTest, CompletionOptions) {
386 auto Test = [&](
const clangd::CodeCompleteOptions &Opts) {
387 testAfterDotCompletion(Opts);
388 testGlobalScopeCompletion(Opts);
392 &clangd::CodeCompleteOptions::IncludeIneligibleResults,
397 for (
auto &F : Flags) {
398 clangd::CodeCompleteOptions O;
404TEST(CompletionTest, Accessible) {
408 protected: void prot();
409 private: void priv();
411 void Foo::pub() { this->^ }
414 AllOf(has("priv"), has(
"prot"), has(
"pub")));
416 auto External = completions(R
"cpp(
419 protected: void prot();
420 private: void priv();
427 EXPECT_THAT(External.Completions,
428 AllOf(has("pub"), Not(has(
"prot")), Not(has(
"priv"))));
430 auto Results = completions(R
"cpp(
433 protected: void prot();
434 private: void priv();
436 struct Bar : public Foo {
437 private: using Foo::pub;
444 EXPECT_THAT(Results.Completions,
445 AllOf(Not(has("priv")), Not(has(
"prot")), Not(has(
"pub"))));
448TEST(CompletionTest, Qualifiers) {
449 auto Results = completions(R
"cpp(
451 public: int foo() const;
454 class Bar : public Foo {
457 void test() { Bar().^ }
459 EXPECT_THAT(Results.Completions,
460 Contains(AllOf(qualifier(""), named(
"bar"))));
462 EXPECT_THAT(Results.Completions,
463 Not(Contains(AllOf(qualifier(
"Foo::"), named(
"foo")))));
465 EXPECT_THAT(Results.Completions,
466 Not(Contains(AllOf(qualifier(
""), named(
"foo")))));
470TEST(CompletionTest, QualificationWithInlineNamespace) {
471 auto Results = completions(R
"cpp(
472 namespace a { inline namespace b {} }
473 using namespace a::b;
477 EXPECT_THAT(Results.Completions,
478 UnorderedElementsAre(AllOf(qualifier(
"a::"), named(
"Foo"))));
481TEST(CompletionTest, InjectedTypename) {
483 EXPECT_THAT(completions(
"struct X{}; void foo(){ X().^ }").Completions,
485 EXPECT_THAT(completions(
"struct X{ void foo(){ this->^ } };").Completions,
488 EXPECT_THAT(completions(
"struct X{ void foo(){ ^ } };").Completions,
491 completions(
"struct Y{}; struct X:Y{ void foo(){ ^ } };").Completions,
495 "template<class> struct Y{}; struct X:Y<int>{ void foo(){ ^ } };")
499 EXPECT_THAT(completions(
"struct X{}; void foo(){ X::^ }").Completions,
503TEST(CompletionTest, SkipInjectedWhenUnqualified) {
504 EXPECT_THAT(completions(
"struct X { void f() { X^ }};").Completions,
505 ElementsAre(named(
"X"), named(
"~X")));
508TEST(CompletionTest, Snippets) {
509 clangd::CodeCompleteOptions Opts;
510 auto Results = completions(
514 int f(int i, const float f) const;
525 snippetSuffix(
"(${1:int i}, ${2:const float f})")));
528TEST(CompletionTest, HeuristicsForMemberFunctionCompletion) {
529 clangd::CodeCompleteOptions Opts;
530 Opts.EnableSnippets =
true;
534 static int staticMethod(int name);
535 int method(int name) const;
536 template <typename T, typename U, typename V = int>
537 T generic(U nameU, V nameV);
538 template <typename T, int U>
539 static T staticGeneric();
541 this->$canBeCallNoStatic^
547 int Foo::$isDefinition^ {
551 int i = Foo::$canBeCallStaticOnly^
554 struct Derived : Foo {
566 f.$canBeCallNoStatic^
567 ; // Prevent parsing as 'f.f'
574 d.Derived::$canBeCall^
582 ; // Prevent parsing as 'f.f'
589 d.Derived::$canBeCall^
594 for (
const auto &P : Code.points(
"canNotBeCall")) {
595 auto Results = completions(TU, P, {}, Opts);
596 EXPECT_THAT(Results.Completions,
597 Contains(AllOf(named(
"method"), signature(
"(int name) const"),
598 snippetSuffix(
""))));
602 Contains(AllOf(named(
"generic"),
603 signature(
"<typename T, typename U>(U nameU, V nameV)"),
604 snippetSuffix(
"<${1:typename T}, ${2:typename U}>"))));
605 EXPECT_THAT(Results.Completions,
606 Contains(AllOf(named(
"staticMethod"), signature(
"(int name)"),
607 snippetSuffix(
""))));
608 EXPECT_THAT(Results.Completions,
610 named(
"staticGeneric"), signature(
"<typename T, int U>()"),
611 snippetSuffix(
"<${1:typename T}, ${2:int U}>"))));
614 for (
const auto &P : Code.points(
"canBeCall")) {
615 auto Results = completions(TU, P, {}, Opts);
616 EXPECT_THAT(Results.Completions,
617 Contains(AllOf(named(
"method"), signature(
"(int name) const"),
618 snippetSuffix(
"(${1:int name})"))));
622 named(
"generic"), signature(
"<typename T>(U nameU, V nameV)"),
623 snippetSuffix(
"<${1:typename T}>(${2:U nameU}, ${3:V nameV})"))));
624 EXPECT_THAT(Results.Completions,
625 Contains(AllOf(named(
"staticMethod"), signature(
"(int name)"),
626 snippetSuffix(
"(${1:int name})"))));
627 EXPECT_THAT(Results.Completions,
629 named(
"staticGeneric"), signature(
"<typename T, int U>()"),
630 snippetSuffix(
"<${1:typename T}, ${2:int U}>()"))));
633 for (
const auto &P : Code.points(
"canBeCallNoStatic")) {
634 auto Results = completions(TU, P, {}, Opts);
635 EXPECT_THAT(Results.Completions,
636 Contains(AllOf(named(
"method"), signature(
"(int name) const"),
637 snippetSuffix(
"(${1:int name})"))));
641 named(
"generic"), signature(
"<typename T>(U nameU, V nameV)"),
642 snippetSuffix(
"<${1:typename T}>(${2:U nameU}, ${3:V nameV})"))));
645 for (
const auto &P : Code.points(
"canBeCallStaticOnly")) {
646 auto Results = completions(TU, P, {}, Opts);
647 EXPECT_THAT(Results.Completions,
648 Contains(AllOf(named(
"method"), signature(
"(int name) const"),
649 snippetSuffix(
""))));
652 Contains(AllOf(named(
"generic"),
653 signature(
"<typename T, typename U>(U nameU, V nameV)"),
654 snippetSuffix(
"<${1:typename T}, ${2:typename U}>"))));
655 EXPECT_THAT(Results.Completions,
656 Contains(AllOf(named(
"staticMethod"), signature(
"(int name)"),
657 snippetSuffix(
"(${1:int name})"))));
658 EXPECT_THAT(Results.Completions,
660 named(
"staticGeneric"), signature(
"<typename T, int U>()"),
661 snippetSuffix(
"<${1:typename T}, ${2:int U}>()"))));
664 for (
const auto &P : Code.points(
"isDefinition")) {
665 auto Results = completions(TU, P, {}, Opts);
667 EXPECT_THAT(Results.Completions,
668 Contains(AllOf(named(
"method"), signature(
"(int name) const"),
669 snippetSuffix(
"(int name) const"))));
672 Contains(AllOf(named(
"generic"),
673 signature(
"<typename T, typename U>(U nameU, V nameV)"),
674 snippetSuffix(
"(U nameU, V nameV)"))));
675 EXPECT_THAT(Results.Completions,
676 Contains(AllOf(named(
"staticMethod"), signature(
"(int name)"),
677 snippetSuffix(
"(int name)"))));
678 EXPECT_THAT(Results.Completions,
679 Contains(AllOf(named(
"staticGeneric"),
680 signature(
"<typename T, int U>()"),
681 snippetSuffix(
"()"))));
685TEST(CompletionTest, PrivateMemberDefinition) {
686 clangd::CodeCompleteOptions Opts;
687 Opts.EnableSnippets =
true;
688 auto Results = completions(
691 int func(int a, int b);
696 EXPECT_THAT(Results.Completions,
697 Contains(AllOf(named(
"func"), signature(
"(int a, int b)"),
698 snippetSuffix(
"(int a, int b)"))));
701TEST(CompletionTest, DeclParamName) {
707 clangd::CodeCompleteOptions Opts;
708 Opts.EnableSnippets =
true;
709 auto FuncFromSource = completions(R
"cpp(
719 EXPECT_THAT(FuncFromSource.Completions, Contains(signature("(int day)")));
722TEST(CompletionTest, DefaultArgsWithValues) {
723 clangd::CodeCompleteOptions Opts;
724 Opts.EnableSnippets =
true;
725 auto Results = completions(
731 void foo(int x = 42, int y = 0, Arg arg = Arg(42, 0));
736 EXPECT_THAT(Results.Completions,
739 signature(
"(int x = 42, int y = 0, Arg arg = Arg(42, 0))"),
740 snippetSuffix(
"(int x, int y, Arg arg)"))));
743TEST(CompletionTest, NoSnippetsInUsings) {
744 clangd::CodeCompleteOptions Opts;
745 Opts.EnableSnippets =
true;
746 auto Results = completions(
749 int func(int a, int b);
755 EXPECT_THAT(Results.Completions,
756 ElementsAre(AllOf(named(
"func"), labeled(
"func(int a, int b)"),
757 snippetSuffix(
""))));
760 auto Func =
func(
"ns::func");
761 Func.CompletionSnippetSuffix =
"(${1:int a}, ${2: int b})";
762 Func.Signature =
"(int a, int b)";
763 Func.ReturnType =
"void";
765 Results = completions(R
"cpp(
770 EXPECT_THAT(Results.Completions,
771 ElementsAre(AllOf(named(
"func"), labeled(
"func(int a, int b)"),
772 snippetSuffix(
""))));
775 Opts.AllScopes =
true;
776 Results = completions(R
"cpp(
780 EXPECT_THAT(Results.Completions,
781 Contains(AllOf(named(
"func"), labeled(
"ns::func(int a, int b)"),
782 snippetSuffix(
""))));
785TEST(CompletionTest, Kinds) {
786 auto Results = completions(
791 // make sure MACRO is not included in preamble.
795 {func("indexFunction"),
var(
"indexVariable"),
cls(
"indexClass"),
796 macro(
"indexObjMacro"),
macro(
"indexFuncMacro",
"(x, y)")});
797 EXPECT_THAT(Results.Completions,
809 Results = completions(
"nam^");
810 EXPECT_THAT(Results.Completions,
814 Results = completions(
828 Results = completions(
830 template <class T> struct complete_class {};
831 template <class T> void complete_function();
832 template <class T> using complete_type_alias = int;
833 template <class T> int complete_variable = 10;
836 template <class T> static int complete_static_member = 10;
838 static auto x = complete_^
843 UnorderedElementsAre(
846 AllOf(named(
"complete_type_alias"),
849 AllOf(named(
"complete_static_member"),
852 Results = completions(
864TEST(CompletionTest, NoDuplicates) {
865 auto Results = completions(
877 EXPECT_THAT(Results.Completions, ElementsAre(named(
"Adapter")));
880TEST(CompletionTest, ScopedNoIndex) {
881 auto Results = completions(
883 namespace fake { int BigBang, Babble, Box; };
884 int main() { fake::ba^ }
887 EXPECT_THAT(Results.Completions,
888 ElementsAre(named(
"Babble"), named(
"BigBang")));
891TEST(CompletionTest, Scoped) {
892 auto Results = completions(
894 namespace fake { int Babble, Box; };
895 int main() { fake::ba^ }
897 {var("fake::BigBang")});
898 EXPECT_THAT(Results.Completions,
899 ElementsAre(named(
"Babble"), named(
"BigBang")));
902TEST(CompletionTest, ScopedWithFilter) {
903 auto Results = completions(
907 {cls("ns::XYZ"),
func(
"ns::foo")});
908 EXPECT_THAT(Results.Completions, UnorderedElementsAre(named(
"XYZ")));
911TEST(CompletionTest, ReferencesAffectRanking) {
912 EXPECT_THAT(completions(
"int main() { abs^ }", {
func(
"absA"),
func(
"absB")})
915 EXPECT_THAT(completions(
"int main() { abs^ }",
916 {
func(
"absA"), withReferences(1000,
func(
"absB"))})
921TEST(CompletionTest, ContextWords) {
922 auto Results = completions(R
"cpp(
923 enum class Color { RED, YELLOW, BLUE };
925 // (blank lines so the definition above isn't "context")
927 // "It was a yellow car," he said. "Big yellow car, new."
928 auto Finish = Color::^
932 ASSERT_THAT(Results.Completions,
936TEST(CompletionTest, GlobalQualified) {
937 auto Results = completions(
942 EXPECT_THAT(Results.Completions,
947TEST(CompletionTest, FullyQualified) {
948 auto Results = completions(
950 namespace ns { void bar(); }
954 EXPECT_THAT(Results.Completions,
959TEST(CompletionTest, SemaIndexMerge) {
960 auto Results = completions(
962 namespace ns { int local; void both(); }
965 {func("ns::both"),
cls(
"ns::Index")});
967 EXPECT_THAT(Results.Completions,
968 UnorderedElementsAre(
975TEST(CompletionTest, SemaIndexMergeWithLimit) {
976 clangd::CodeCompleteOptions Opts;
978 auto Results = completions(
980 namespace ns { int local; void both(); }
983 {func("ns::both"),
cls(
"ns::Index")}, Opts);
984 EXPECT_EQ(Results.Completions.size(), Opts.Limit);
985 EXPECT_TRUE(Results.HasMore);
988TEST(CompletionTest, IncludeInsertionPreprocessorIntegrationTests) {
991 TU.AdditionalFiles[
"sub/bar.h"] =
"";
995 Sym.CanonicalDeclaration.FileURI = BarURI.c_str();
999 TU.Code = Test.code().str();
1000 auto Results = completions(TU, Test.point(), {Sym});
1001 EXPECT_THAT(Results.Completions,
1002 ElementsAre(AllOf(named(
"X"), insertInclude(
"\"bar.h\""))));
1006 Results = completions(TU, Test.point(), {Sym}, NoInsertion);
1007 EXPECT_THAT(Results.Completions,
1008 ElementsAre(AllOf(named(
"X"), Not(insertInclude()))));
1011 #include "sub/bar.h" // not shortest, so should only match resolved.
1012 int main() { ns::^ }
1014 TU.Code = Test.code().str();
1015 Results = completions(TU, Test.point(), {Sym});
1016 EXPECT_THAT(Results.Completions, ElementsAre(AllOf(named("X"), labeled(
"X"),
1017 Not(insertInclude()))));
1020TEST(CompletionTest, NoIncludeInsertionWhenDeclFoundInFile) {
1023 std::string BarHeader =
testPath(
"bar.h");
1025 SymX.CanonicalDeclaration.FileURI = BarURI.c_str();
1026 SymY.CanonicalDeclaration.FileURI = BarURI.c_str();
1030 auto Results = completions(R
"cpp(
1035 int main() { ns::^ }
1038 EXPECT_THAT(Results.Completions,
1039 ElementsAre(AllOf(named("X"), Not(insertInclude())),
1040 AllOf(named(
"Y"), Not(insertInclude()))));
1043TEST(CompletionTest, IncludeInsertionRespectsQuotedAngledConfig) {
1046 TU.AdditionalFiles[
"sub/bar.h"] =
"";
1050 Sym.CanonicalDeclaration.FileURI = BarURI.c_str();
1053 TU.Code = Test.code().str();
1054 auto Results = completions(TU, Test.point(), {Sym});
1056 EXPECT_THAT(Results.Completions,
1057 ElementsAre(AllOf(named(
"X"), insertInclude(
"\"bar.h\""))));
1060 C.Style.AngledHeaders.push_back(
1061 [](
auto header) {
return header.contains(
"bar.h"); });
1063 Results = completions(TU, Test.point(), {Sym});
1064 EXPECT_THAT(Results.Completions,
1065 ElementsAre(AllOf(named(
"X"), insertInclude(
"<bar.h>"))));
1069 C.Style.QuotedHeaders.push_back(
1070 [](
auto header) {
return header.contains(
"bar.h"); });
1072 Results = completions(TU, Test.point(), {Sym});
1073 EXPECT_THAT(Results.Completions,
1074 ElementsAre(AllOf(named(
"X"), insertInclude(
"\"bar.h\""))));
1078TEST(CompletionTest, IndexSuppressesPreambleCompletions) {
1081 namespace ns { int local; }
1083 void f2() { ns::preamble().$2^; }
1086 TU.AdditionalFiles[
"bar.h"] =
1087 R
"cpp(namespace ns { struct preamble { int member; }; })cpp";
1089 clangd::CodeCompleteOptions Opts = {};
1090 auto I = memIndex({
var(
"ns::index")});
1091 Opts.Index = I.get();
1092 auto WithIndex = completions(TU, Test.point(), {}, Opts);
1093 EXPECT_THAT(WithIndex.Completions,
1094 UnorderedElementsAre(named(
"local"), named(
"index")));
1095 auto ClassFromPreamble = completions(TU, Test.point(
"2"), {}, Opts);
1096 EXPECT_THAT(ClassFromPreamble.Completions, Contains(named(
"member")));
1098 Opts.Index =
nullptr;
1099 auto WithoutIndex = completions(TU, Test.point(), {}, Opts);
1100 EXPECT_THAT(WithoutIndex.Completions,
1101 UnorderedElementsAre(named(
"local"), named(
"preamble")));
1108TEST(CompletionTest, CompletionInPreamble) {
1109 auto Results = completions(R
"cpp(
1117 EXPECT_THAT(Results, ElementsAre(named("ifndef")));
1120TEST(CompletionTest, CompletionRecoveryASTType) {
1121 auto Results = completions(R
"cpp(
1122 struct S { int member; };
1125 // No overload matches, but we have recovery-expr with the correct type.
1129 EXPECT_THAT(Results, ElementsAre(named("member")));
1132TEST(CompletionTest, DynamicIndexIncludeInsertion) {
1136 Opts.BuildDynamicSymbolIndex =
true;
1139 FS.Files[
testPath(
"foo_header.h")] = R
"cpp(
1146 const std::string FileContent(R
"cpp(
1147 #include "foo_header.h"
1152 Server.addDocument(testPath("foo_impl.cpp"), FileContent);
1154 ASSERT_TRUE(Server.blockUntilIdleForTest());
1163 ElementsAre(AllOf(named(
"Foo"), hasInclude(
"\"foo_header.h\""),
1167TEST(CompletionTest, DynamicIndexMultiFile) {
1171 Opts.BuildDynamicSymbolIndex =
true;
1174 FS.Files[
testPath(
"foo.h")] = R
"cpp(
1175 namespace ns { class XYZ {}; void foo(int x) {} }
1198 EXPECT_THAT(Results.Completions,
1200 doc(
"Doooc"), returnType(
"void"))));
1203TEST(CompletionTest, Documentation) {
1204 auto Results = completions(
1206 // Non-doxygen comment.
1207 __attribute__((annotate("custom_annotation"))) int foo();
1219 Results.Completions,
1222 doc(
"Annotation: custom_annotation\n\nNon-doxygen comment."))));
1224 Results.Completions,
1225 Contains(AllOf(named(
"bar"), doc(
"Doxygen comment.\n\\param int a"))));
1226 EXPECT_THAT(Results.Completions,
1227 Contains(AllOf(named(
"baz"), doc(
"Multi-line block comment"))));
1230TEST(CompletionTest, CommentsFromSystemHeaders) {
1235 Opts.BuildDynamicSymbolIndex =
true;
1239 FS.Files[
testPath(
"foo.h")] = R
"cpp(
1240 #pragma GCC system_header
1242 // This comment should be retained!
1257 Contains(AllOf(named(
"foo"), doc(
"This comment should be retained!"))));
1260TEST(CompletionTest, CommentsOnMembersFromHeader) {
1265 Opts.BuildDynamicSymbolIndex =
true;
1269 FS.Files[
testPath(
"foo.h")] = R
"cpp(
1278 template <typename T>
1301 Contains(AllOf(named(
"gamma"), doc(
"This is a member field."))));
1304 Contains(AllOf(named(
"delta"), doc(
"This is a member function."))));
1310 Contains(AllOf(named(
"omega")
1314 Contains(AllOf(named(
"epsilon"),
1315 doc(
"This is a member function inside a template."))));
1318TEST(CompletionTest, CommentsOnMembersFromHeaderOverloadBundling) {
1319 using testing::AnyOf;
1324 Opts.BuildDynamicSymbolIndex =
true;
1328 FS.Files[
testPath(
"foo.h")] = R
"cpp(
1336 void epsilon(long l);
1339 void epsilon(int i);
1350 clangd::CodeCompleteOptions CCOpts;
1351 CCOpts.BundleOverloads = true;
1357 Contains(AllOf(named(
"epsilon"), doc(
"This one has a comment."))));
1359 Contains(AllOf(named(
"delta"), AnyOf(doc(
"bool overload."),
1360 doc(
"int overload.")))));
1363TEST(CompletionTest, GlobalCompletionFiltering) {
1372 auto Results = completions(R
"(// void f() {
1376 EXPECT_THAT(Results.Completions, IsEmpty());
1379TEST(CodeCompleteTest, DisableTypoCorrection) {
1380 auto Results = completions(R
"cpp(
1381 namespace clang { int v; }
1382 void f() { clangd::^
1384 EXPECT_TRUE(Results.Completions.empty());
1387TEST(CodeCompleteTest, NoColonColonAtTheEnd) {
1388 auto Results = completions(R
"cpp(
1395 EXPECT_THAT(Results.Completions, Contains(labeled("clang")));
1396 EXPECT_THAT(Results.Completions, Not(Contains(labeled(
"clang::"))));
1399TEST(CompletionTests, EmptySnippetDoesNotCrash) {
1401 auto Results = completions(R
"cpp(
1403 auto w = [&](auto &&f) { return f(f); };
1404 auto f = w([&](auto &&f) {
1405 return [&](auto &&n) {
1409 return n * ^(f)(n - 1);
1416TEST(CompletionTest, Issue1427Crash) {
1422 Opts.MainFileSignals = &MainFileSignals;
1431TEST(CompletionTest, BacktrackCrashes) {
1433 auto Results = completions(R
"cpp(
1435 struct FooBarBaz {};
1441 EXPECT_THAT(Results.Completions, ElementsAre(labeled("FooBarBaz")));
1445 struct FooBarBaz {};
1447 if (FooBarBaz * x^) {}
1452TEST(CompletionTest, CompleteInMacroWithStringification) {
1453 auto Results = completions(R
"cpp(
1454void f(const char *, int x);
1455#define F(x) f(#x, x)
1462int f(int input_num) {
1467 EXPECT_THAT(Results.Completions,
1468 UnorderedElementsAre(named("X"), named(
"Y")));
1471TEST(CompletionTest, CompleteInMacroAndNamespaceWithStringification) {
1472 auto Results = completions(R
"cpp(
1473void f(const char *, int x);
1474#define F(x) f(#x, x)
1479int f(int input_num) {
1485 EXPECT_THAT(Results.Completions, Contains(named("X")));
1488TEST(CompletionTest, IgnoreCompleteInExcludedPPBranchWithRecoveryContext) {
1489 auto Results = completions(R
"cpp(
1490 int bar(int param_in_bar) {
1493 int foo(int param_in_foo) {
1495 // In recovery mode, "param_in_foo" will also be suggested among many other
1496 // unrelated symbols; however, this is really a special case where this works.
1497 // If the #if block is outside of the function, "param_in_foo" is still
1498 // suggested, but "bar" and "foo" are missing. So the recovery mode doesn't
1499 // really provide useful results in excluded branches.
1505 EXPECT_TRUE(Results.Completions.empty());
1508TEST(CompletionTest, DefaultArgs) {
1509 clangd::CodeCompleteOptions Opts;
1512 int Y(int A, int B = 0);
1513 int Z(int A, int B = 0, int C = 0, int D = 0);
1515 EXPECT_THAT(completions(Context + "int y = X^", {}, Opts).Completions,
1516 UnorderedElementsAre(labeled(
"X(int A = 0)")));
1517 EXPECT_THAT(completions(
Context +
"int y = Y^", {}, Opts).Completions,
1518 UnorderedElementsAre(AllOf(labeled(
"Y(int A, int B = 0)"),
1519 snippetSuffix(
"(${1:int A})"))));
1520 EXPECT_THAT(completions(
Context +
"int y = Z^", {}, Opts).Completions,
1521 UnorderedElementsAre(
1522 AllOf(labeled(
"Z(int A, int B = 0, int C = 0, int D = 0)"),
1523 snippetSuffix(
"(${1:int A})"))));
1526TEST(CompletionTest, NoCrashWithTemplateParamsAndPreferredTypes) {
1527 auto Completions = completions(R
"cpp(
1528template <template <class> class TT> int foo() {
1533 EXPECT_THAT(Completions, Contains(named("TT")));
1536TEST(CompletionTest, NestedTemplateHeuristics) {
1537 auto Completions = completions(R
"cpp(
1538struct Plain { int xxx; };
1539template <typename T> class Templ { Plain ppp; };
1540template <typename T> void foo(Templ<T> &t) {
1541 // Formally ppp has DependentTy, because Templ may be specialized.
1542 // However we sholud be able to see into it using the primary template.
1547 EXPECT_THAT(Completions, Contains(named("xxx")));
1550TEST(CompletionTest, RecordCCResultCallback) {
1551 std::vector<CodeCompletion> RecordedCompletions;
1553 Opts.RecordCCResult = [&RecordedCompletions](
const CodeCompletion &CC,
1557 RecordedCompletions.push_back(CC);
1560 completions(
"int xy1, xy2; int a = xy^", {}, Opts);
1561 EXPECT_THAT(RecordedCompletions,
1562 UnorderedElementsAre(named(
"xy1"), named(
"xy2")));
1568 unsigned MainFileRefs;
1569 unsigned ScopeRefsInFile;
1572 std::vector<Completion> RecordedCompletions;
1573 Opts.RecordCCResult = [&RecordedCompletions](
const CodeCompletion &CC,
1577 RecordedCompletions.push_back({CC.Name, R.MainFileRefs, R.ScopeRefsInFile});
1581 MainFileSignals.ReferencedSymbols[
var(
"xy2").
ID] = 1;
1582 MainFileSignals.ReferencedSymbols[
var(
"xyindex").
ID] = 10;
1583 MainFileSignals.RelatedNamespaces[
"tar::"] = 5;
1584 MainFileSignals.RelatedNamespaces[
"bar::"] = 3;
1585 Opts.MainFileSignals = &MainFileSignals;
1586 Opts.AllScopes =
true;
1596 {
var(
"xyindex"),
var(
"tar::xytar"),
var(
"bar::xybar")},
1598 EXPECT_THAT(RecordedCompletions,
1599 UnorderedElementsAre(
1600 AllOf(named(
"xy1"), mainFileRefs(3u), scopeRefs(0u)),
1601 AllOf(named(
"xy2"), mainFileRefs(1u), scopeRefs(0u)),
1602 AllOf(named(
"xyindex"), mainFileRefs(10u), scopeRefs(0u)),
1603 AllOf(named(
"xytar"), mainFileRefs(0u), scopeRefs(5u)),
1604 AllOf( named(
"xybar"),
1605 mainFileRefs(0u), scopeRefs(3u))));
1610 std::vector<Symbol> IndexSymbols = {},
1612 std::unique_ptr<SymbolIndex> Index;
1613 if (!IndexSymbols.empty())
1614 Index = memIndex(IndexSymbols);
1618 auto Inputs = TU.inputs(FS);
1619 Inputs.Index = Index.get();
1623 ADD_FAILURE() <<
"Couldn't build CompilerInvocation";
1629 ADD_FAILURE() <<
"Couldn't build Preamble";
1633 DocumentationFormat);
1637signatures(llvm::StringRef
Text, std::vector<Symbol> IndexSymbols = {},
1640 return signatures(Test.code(), Test.point(), std::move(IndexSymbols),
1641 DocumentationFormat);
1644struct ExpectedParameter {
1646 std::pair<unsigned, unsigned> Offsets;
1648llvm::raw_ostream &
operator<<(llvm::raw_ostream &OS,
1649 const ExpectedParameter &P) {
1650 return OS <<
P.Text;
1653 if (
P.size() != arg.parameters.size())
1655 for (
unsigned I = 0; I <
P.size(); ++I) {
1656 if (P[I].
Text != arg.parameters[I].labelString ||
1657 P[I].Offsets != arg.parameters[I].labelOffsets)
1662MATCHER_P(sigDoc, doc,
"") {
return arg.documentation.value == doc; }
1666Matcher<SignatureInformation> sig(llvm::StringRef AnnotatedLabel) {
1667 llvm::Annotations
A(AnnotatedLabel);
1668 std::string
Label = std::string(
A.code());
1669 std::vector<ExpectedParameter> Parameters;
1670 for (
auto Range :
A.ranges()) {
1671 Parameters.emplace_back();
1673 ExpectedParameter &
P = Parameters.back();
1678 return AllOf(sigHelpLabeled(
Label), paramsAre(Parameters));
1681TEST(SignatureHelpTest, Overloads) {
1682 auto Results = signatures(R
"cpp(
1683 void foo(int x, int y);
1684 void foo(int x, float y);
1685 void foo(float x, int y);
1686 void foo(float x, float y);
1687 void bar(int x, int y = 0);
1688 int main() { foo(^); }
1690 EXPECT_THAT(Results.signatures,
1691 UnorderedElementsAre(sig("foo([[float x]], [[float y]]) -> void"),
1692 sig(
"foo([[float x]], [[int y]]) -> void"),
1693 sig(
"foo([[int x]], [[float y]]) -> void"),
1694 sig(
"foo([[int x]], [[int y]]) -> void")));
1696 EXPECT_EQ(0, Results.activeSignature);
1697 EXPECT_EQ(0, Results.activeParameter);
1700TEST(SignatureHelpTest, DeclParamName) {
1706 auto FuncFromSource = signatures(R
"cpp(
1708 void sun(int night);
1715 EXPECT_THAT(FuncFromSource.signatures,
1716 UnorderedElementsAre(sig("sun([[int day]]) -> void")));
1719TEST(SignatureHelpTest, FunctionPointers) {
1720 llvm::StringLiteral Tests[] = {
1723 void (*foo)(int x, int y);
1724 int main() { foo(^); }
1728 void (__stdcall *foo)(int x, int y);
1729 int main() { foo(^); }
1733 void (__attribute__(stdcall) *foo)(int x, int y);
1734 int main() { foo(^); },
1738 typedef void (*fn)(int x, int y);
1740 int main() { foo(^); }
1744 typedef void (__stdcall *fn)(int x, int y);
1746 int main() { foo(^); }
1751 void (*foo)(int x, int y);
1754 int main() { s.foo(^); }
1758 typedef void (*fn)(int x, int y);
1763 int main() { s.foo(^); }
1765 for (
auto Test : Tests)
1766 EXPECT_THAT(signatures(Test).signatures,
1767 UnorderedElementsAre(sig(
"([[int x]], [[int y]]) -> void")));
1770TEST(SignatureHelpTest, Constructors) {
1771 std::string Top = R
"cpp(
1774 S(const S &) = delete;
1778 auto CheckParenInit = [&](std::string Init) {
1779 EXPECT_THAT(signatures(Top + Init).signatures,
1780 UnorderedElementsAre(sig(
"S([[int]])")))
1783 CheckParenInit(
"S s(^);");
1784 CheckParenInit(
"auto s = S(^);");
1785 CheckParenInit(
"auto s = new S(^);");
1787 auto CheckBracedInit = [&](std::string Init) {
1788 EXPECT_THAT(signatures(Top + Init).signatures,
1789 UnorderedElementsAre(sig(
"S{[[int]]}")))
1792 CheckBracedInit(
"S s{^};");
1793 CheckBracedInit(
"S s = {^};");
1794 CheckBracedInit(
"auto s = S{^};");
1797 CheckBracedInit(
"int x(S); int i = x({^});");
1800TEST(SignatureHelpTest, Aggregates) {
1801 std::string Top = R
"cpp(
1806 auto AggregateSig = sig(
"S{[[int a]], [[int b]], [[int c]], [[int d]]}");
1807 EXPECT_THAT(signatures(Top +
"S s{^}").signatures,
1808 UnorderedElementsAre(AggregateSig, sig(
"S{}"),
1809 sig(
"S{[[const S &]]}"),
1810 sig(
"S{[[S &&]]}")));
1811 EXPECT_THAT(signatures(Top +
"S s{1,^}").signatures,
1812 ElementsAre(AggregateSig));
1813 EXPECT_EQ(signatures(Top +
"S s{1,^}").activeParameter, 1);
1814 EXPECT_THAT(signatures(Top +
"S s{.c=3,^}").signatures,
1815 ElementsAre(AggregateSig));
1816 EXPECT_EQ(signatures(Top +
"S s{.c=3,^}").activeParameter, 3);
1819TEST(SignatureHelpTest, OverloadInitListRegression) {
1820 auto Results = signatures(R
"cpp(
1829 EXPECT_THAT(Results.signatures, UnorderedElementsAre(sig("f() -> void")));
1832TEST(SignatureHelpTest, DefaultArgs) {
1833 auto Results = signatures(R
"cpp(
1834 void bar(int x, int y = 0);
1835 void bar(float x = 0, int y = 42);
1838 EXPECT_THAT(Results.signatures,
1839 UnorderedElementsAre(
1840 sig("bar([[int x]], [[int y = 0]]) -> void"),
1841 sig(
"bar([[float x = 0]], [[int y = 42]]) -> void")));
1842 EXPECT_EQ(0, Results.activeSignature);
1843 EXPECT_EQ(0, Results.activeParameter);
1846TEST(SignatureHelpTest, ActiveArg) {
1847 auto Results = signatures(R
"cpp(
1848 int baz(int a, int b, int c);
1849 int main() { baz(baz(1,2,3), ^); }
1851 EXPECT_THAT(Results.signatures,
1852 ElementsAre(sig("baz([[int a]], [[int b]], [[int c]]) -> int")));
1853 EXPECT_EQ(0, Results.activeSignature);
1854 EXPECT_EQ(1, Results.activeParameter);
1857TEST(SignatureHelpTest, OpeningParen) {
1858 llvm::StringLiteral Tests[] = {
1861 int foo(int a, int b, int c);
1863 foo(foo $p^( foo(10, 10, 10), ^ )));
1868 Foo(int a, int b, int c);
1876 Foo(int a, int b, int c);
1879 new Foo $p^( 10, ^ );
1883 int foo(int a, int b, int c);
1887 // Macro expansions.
1892 int foo(int a, int b, int c);
1895 // FIXME: figure out why ID(foo (foo(10), )) doesn't work when preserving
1896 // the recovery expression.
1897 ID(foo $p^( 10, ^ ))
1901 int foo(int a, int b);
1902 template <typename T> void bar(T t) {
1907 template <typename T>
1909 template <typename T> void bar(T t) {
1914 struct Foo { int foo(int, int); };
1915 template <typename T> void bar(T t) {
1921 struct Foo { template <typename T> int foo(T, T); };
1922 template <typename T> void bar(T t) {
1928 for (
auto Test : Tests) {
1930 EXPECT_EQ(signatures(Code.code(), Code.point()).argListStart,
1932 <<
"Test source:" << Test;
1936TEST(SignatureHelpTest, StalePreamble) {
1941 auto Inputs = TU.inputs(FS);
1946 ASSERT_TRUE(EmptyPreamble);
1948 TU.AdditionalFiles[
"a.h"] =
"int foo(int x);";
1951 void bar() { foo(^2); })cpp");
1952 TU.Code = Test.code().str();
1956 EXPECT_THAT(Results.signatures, ElementsAre(sig(
"foo([[int x]]) -> int")));
1957 EXPECT_EQ(0, Results.activeSignature);
1958 EXPECT_EQ(0, Results.activeParameter);
1961TEST(SignatureHelpTest, EOFInSkippedFunctionBody) {
1964void frameSizeBlocksWarning() {
1974 auto Results = signatures(Test.code(), Test.point());
1975 EXPECT_THAT(Results.signatures, IsEmpty());
1980 IndexRequestCollector(std::vector<Symbol> Syms = {}) : Symbols(Syms) {}
1983 fuzzyFind(
const FuzzyFindRequest &Req,
1984 llvm::function_ref<
void(
const Symbol &)>
Callback)
const override {
1985 std::unique_lock<std::mutex> Lock(Mut);
1986 Requests.push_back(Req);
1987 ReceivedRequestCV.notify_one();
1988 for (
const auto &Sym : Symbols)
1993 void lookup(
const LookupRequest &,
1994 llvm::function_ref<
void(
const Symbol &)>)
const override {}
1996 bool refs(
const RefsRequest &,
1997 llvm::function_ref<
void(
const Ref &)>)
const override {
2002 const ContainedRefsRequest &,
2003 llvm::function_ref<
void(
const ContainedRefsResult &)>)
const override {
2007 void relations(
const RelationsRequest &,
2008 llvm::function_ref<
void(
const SymbolID &,
const Symbol &)>)
2012 reverseRelations(
const RelationsRequest &,
2013 llvm::function_ref<
void(
const SymbolID &,
const Symbol &)>)
2017 indexedFiles()
const override {
2023 size_t estimateMemoryUsage()
const override {
return 0; }
2025 const std::vector<FuzzyFindRequest> consumeRequests(
size_t Num)
const {
2026 std::unique_lock<std::mutex> Lock(Mut);
2028 [
this, Num] {
return Requests.size() == Num; }));
2029 auto Reqs = std::move(Requests);
2035 std::vector<Symbol> Symbols;
2037 mutable std::condition_variable ReceivedRequestCV;
2038 mutable std::mutex Mut;
2039 mutable std::vector<FuzzyFindRequest> Requests;
2043std::vector<FuzzyFindRequest> captureIndexRequests(llvm::StringRef Code,
2045 clangd::CodeCompleteOptions Opts;
2046 IndexRequestCollector Requests;
2047 Opts.Index = &Requests;
2048 completions(Code, {}, Opts);
2049 const auto Reqs = Requests.consumeRequests(Num);
2050 EXPECT_EQ(Reqs.size(), Num);
2054TEST(CompletionTest, UnqualifiedIdQuery) {
2055 auto Requests = captureIndexRequests(R
"cpp(
2057 using namespace std;
2065 EXPECT_THAT(Requests,
2067 UnorderedElementsAre("",
"ns::",
"std::"))));
2070TEST(CompletionTest, EnclosingScopeComesFirst) {
2071 auto Requests = captureIndexRequests(R
"cpp(
2073 using namespace std;
2085 EXPECT_THAT(Requests,
2088 UnorderedElementsAre("",
"std::",
"nx::ns::",
"nx::"))));
2089 EXPECT_EQ(Requests[0].Scopes[0],
"nx::ns::");
2092TEST(CompletionTest, ResolvedQualifiedIdQuery) {
2093 auto Requests = captureIndexRequests(R
"cpp(
2095 namespace ns2 {} // ignore
2096 namespace ns3 { namespace nns3 {} }
2098 using namespace ns1;
2099 using namespace ns3::nns3;
2108 EXPECT_THAT(Requests,
2111 UnorderedElementsAre("foo::",
"ns1::",
"ns3::nns3::"))));
2114TEST(CompletionTest, UnresolvedQualifierIdQuery) {
2115 auto Requests = captureIndexRequests(R
"cpp(
2125 EXPECT_THAT(Requests,
2128 UnorderedElementsAre("a::bar::",
"ns::bar::",
"bar::"))));
2131TEST(CompletionTest, UnresolvedNestedQualifierIdQuery) {
2132 auto Requests = captureIndexRequests(R
"cpp(
2143 UnorderedElementsAre("a::bar::"))));
2146TEST(CompletionTest, EmptyQualifiedQuery) {
2147 auto Requests = captureIndexRequests(R
"cpp(
2156 UnorderedElementsAre("",
"ns::"))));
2159TEST(CompletionTest, GlobalQualifiedQuery) {
2160 auto Requests = captureIndexRequests(R
"cpp(
2169 UnorderedElementsAre(""))));
2172TEST(CompletionTest, NoDuplicatedQueryScopes) {
2173 auto Requests = captureIndexRequests(R
"cpp(
2184 EXPECT_THAT(Requests,
2186 UnorderedElementsAre("na::",
"na::nb::",
""))));
2189TEST(CompletionTest, NoIndexCompletionsInsideClasses) {
2190 auto Completions = completions(
2193 int SomeNameOfField;
2194 typedef int SomeNameOfTypedefField;
2198 {func("::SomeNameInTheIndex"),
func(
"::Foo::SomeNameInTheIndex")});
2200 EXPECT_THAT(Completions.Completions,
2201 AllOf(Contains(labeled(
"SomeNameOfField")),
2202 Contains(labeled(
"SomeNameOfTypedefField")),
2203 Not(Contains(labeled(
"SomeNameInTheIndex")))));
2206TEST(CompletionTest, NoIndexCompletionsInsideDependentCode) {
2208 auto Completions = completions(
2215 {func("::SomeNameInTheIndex")});
2217 EXPECT_THAT(Completions.Completions,
2218 Not(Contains(labeled(
"SomeNameInTheIndex"))));
2222 auto Completions = completions(
2226 T::template Y<int>::^
2229 {func("::SomeNameInTheIndex")});
2231 EXPECT_THAT(Completions.Completions,
2232 Not(Contains(labeled(
"SomeNameInTheIndex"))));
2236 auto Completions = completions(
2243 {func("::SomeNameInTheIndex")});
2245 EXPECT_THAT(Completions.Completions,
2246 Not(Contains(labeled(
"SomeNameInTheIndex"))));
2250TEST(CompletionTest, OverloadBundling) {
2251 clangd::CodeCompleteOptions Opts;
2252 Opts.BundleOverloads =
true;
2256 // Overload with int
2257 int a(int) __attribute__((deprecated("", "")));
2258 // Overload with bool
2270 EXPECT_THAT(completions(
Context +
"int y = X().^", {}, Opts).Completions,
2271 UnorderedElementsAre(labeled(
"a(…)"), labeled(
"b(float)")));
2274 EXPECT_THAT(completions(
Context +
"X z = X^", {}, Opts).Completions,
2275 UnorderedElementsAre(labeled(
"X"), labeled(
"X(…)")));
2280 completions(
Context +
"int y = GFunc^", {NoArgsGFunc}, Opts).Completions,
2281 UnorderedElementsAre(labeled(
"GFuncC(…)"), labeled(
"GFuncD(int)")));
2285 NoArgsGFunc.CanonicalDeclaration.FileURI = DeclFile.c_str();
2288 completions(
Context +
"int y = GFunc^", {NoArgsGFunc}, Opts).Completions,
2289 UnorderedElementsAre(AllOf(named(
"GFuncC"), insertInclude(
"<foo>")),
2290 labeled(
"GFuncC(int)"), labeled(
"GFuncD(int)")));
2294 completions(
Context +
"int y = X().a^", {}, Opts).Completions.front();
2295 EXPECT_EQ(
A.Name,
"a");
2296 EXPECT_EQ(
A.Signature,
"(…)");
2297 EXPECT_EQ(
A.BundleSize, 2u);
2299 EXPECT_EQ(
A.ReturnType,
"int");
2301 ASSERT_TRUE(
A.Documentation);
2302 ASSERT_FALSE(
A.Deprecated);
2304 A.Documentation->asPlainText(),
2305 AnyOf(HasSubstr(
"Overload with int"), HasSubstr(
"Overload with bool")));
2306 EXPECT_EQ(
A.SnippetSuffix,
"($0)");
2309TEST(CompletionTest, OverloadBundlingSameFileDifferentURI) {
2310 clangd::CodeCompleteOptions Opts;
2311 Opts.BundleOverloads =
true;
2313 Symbol SymX =
sym(
"ns::X", index::SymbolKind::Function,
"@F@\\0#");
2314 Symbol SymY =
sym(
"ns::X", index::SymbolKind::Function,
"@F@\\0#I#");
2315 std::string BarHeader =
testPath(
"bar.h");
2317 SymX.CanonicalDeclaration.FileURI = BarURI.c_str();
2318 SymY.CanonicalDeclaration.FileURI = BarURI.c_str();
2323 auto Results = completions(
"void f() { ::ns::^ }", {SymX, SymY}, Opts);
2326 ASSERT_EQ(1u, Results.Completions.size());
2327 const auto &R = Results.Completions.front();
2328 EXPECT_EQ(
"X", R.Name);
2329 EXPECT_EQ(2u, R.BundleSize);
2332TEST(CompletionTest, DocumentationFromChangedFileCrash) {
2336 FS.Files[FooH] = R
"cpp(
2337 // this is my documentation comment.
2340 FS.Files[FooCpp] = "";
2348 // This makes sure we have func from header in the AST.
2354 ASSERT_TRUE(Server.blockUntilIdleForTest());
2357 FS.Files[FooH] = R
"cpp(
2361 clangd::CodeCompleteOptions Opts;
2362 CodeCompleteResult Completions =
2366 EXPECT_THAT(Completions.Completions,
2367 Contains(AllOf(Not(isDocumented()), named(
"func"))));
2370TEST(CompletionTest, NonDocComments) {
2371 const char *
Text = R
"cpp(
2372 // We ignore namespace comments, for rationale see CodeCompletionStrings.h.
2373 namespace comments_ns {
2376 // ------------------
2379 // A comment and a decl are separated by newlines.
2380 // Therefore, the comment shouldn't show up as doc comment.
2384 // this comment should be in the results.
2391 int comments_quux();
2395 // This comment should not be there.
2398 int Struct<T>::comments_qux() {
2401 // This comment **should** be in results.
2403 int Struct<T>::comments_quux() {
2410 completions(
Text).Completions,
2411 UnorderedElementsAre(AllOf(Not(isDocumented()), named(
"comments_foo")),
2412 AllOf(isDocumented(), named(
"comments_baz")),
2413 AllOf(isDocumented(), named(
"comments_quux")),
2414 AllOf(Not(isDocumented()), named(
"comments_ns")),
2419 AllOf(isDocumented(), named(
"comments_bar")),
2420 AllOf(isDocumented(), named(
"comments_qux"))));
2423TEST(CompletionTest, CompleteOnInvalidLine) {
2428 FS.
Files[FooCpp] =
"// empty file";
2435 EXPECT_THAT_EXPECTED(
2440TEST(CompletionTest, QualifiedNames) {
2441 auto Results = completions(
2443 namespace ns { int local; void both(); }
2444 void f() { ::ns::^ }
2446 {func("ns::both"),
cls(
"ns::Index")});
2449 Results.Completions,
2450 UnorderedElementsAre(scope(
"ns::"), scope(
"ns::"), scope(
"ns::")));
2453TEST(CompletionTest, Render) {
2457 C.Signature =
"(bool) const";
2458 C.SnippetSuffix =
"(${0:bool})";
2459 C.ReturnType =
"int";
2460 C.RequiredQualifier =
"Foo::";
2461 C.Scope =
"ns::Foo::";
2462 C.Documentation.emplace();
2463 C.Documentation->addParagraph().appendText(
"This is ").appendCode(
"x()");
2464 C.Includes.emplace_back();
2465 auto &Include =
C.Includes.back();
2466 Include.Header =
"\"foo.h\"";
2468 C.Score.Total = 1.0;
2469 C.Score.ExcludingName = .5;
2473 Opts.IncludeIndicator.Insert =
"^";
2474 Opts.IncludeIndicator.NoInsert =
"";
2475 Opts.EnableSnippets =
false;
2477 auto R =
C.render(Opts);
2478 EXPECT_EQ(R.label,
"Foo::x");
2479 EXPECT_EQ(R.labelDetails->detail,
"(bool) const");
2480 EXPECT_EQ(R.insertText,
"Foo::x");
2482 EXPECT_EQ(R.filterText,
"x");
2483 EXPECT_EQ(R.detail,
"int");
2484 EXPECT_EQ(R.documentation->value,
"From \"foo.h\"\n\nThis is x()");
2485 EXPECT_THAT(R.additionalTextEdits, IsEmpty());
2486 EXPECT_EQ(R.sortText,
sortText(1.0,
"x"));
2487 EXPECT_FALSE(R.deprecated);
2488 EXPECT_EQ(R.score, .5f);
2490 C.FilterText =
"xtra";
2492 EXPECT_EQ(R.filterText,
"xtra");
2493 EXPECT_EQ(R.sortText,
sortText(1.0,
"xtra"));
2495 Opts.EnableSnippets =
true;
2497 EXPECT_EQ(R.insertText,
"Foo::x(${0:bool})");
2500 C.SnippetSuffix =
"";
2502 EXPECT_EQ(R.insertText,
"Foo::x");
2505 Include.Insertion.emplace();
2507 EXPECT_EQ(R.label,
"^Foo::x");
2508 EXPECT_EQ(R.labelDetails->detail,
"(bool) const");
2509 EXPECT_THAT(R.additionalTextEdits, Not(IsEmpty()));
2511 Opts.ShowOrigins =
true;
2513 EXPECT_EQ(R.label,
"^[AS]Foo::x");
2514 EXPECT_EQ(R.labelDetails->detail,
"(bool) const");
2518 EXPECT_EQ(R.detail,
"[2 overloads]");
2519 EXPECT_EQ(R.documentation->value,
"From \"foo.h\"\n\nThis is x()");
2521 C.Deprecated =
true;
2523 EXPECT_TRUE(R.deprecated);
2527 EXPECT_EQ(R.documentation->value,
"From `\"foo.h\"`\n\nThis is `x()`");
2530TEST(CompletionTest, IgnoreRecoveryResults) {
2531 auto Results = completions(
2533 namespace ns { int NotRecovered() { return 0; } }
2535 // Sema enters recovery mode first and then normal mode.
2536 if (auto x = ns::NotRecover^)
2539 EXPECT_THAT(Results.Completions, UnorderedElementsAre(named("NotRecovered")));
2542TEST(CompletionTest, ScopeOfClassFieldInConstructorInitializer) {
2543 auto Results = completions(
2546 class X { public: X(); int x_; };
2550 EXPECT_THAT(Results.Completions,
2551 UnorderedElementsAre(AllOf(scope("ns::X::"), named(
"x_"))));
2558TEST(CompletionTest, ConstructorInitListIncomplete) {
2559 auto Results = completions(
2568 EXPECT_THAT(Results.Completions, ElementsAre(named("xyz_")));
2570 Results = completions(
2581 EXPECT_THAT(Results.Completions, ElementsAre(named("foo")));
2584TEST(CompletionTest, CodeCompletionContext) {
2585 auto Results = completions(
2588 class X { public: X(); int x_; };
2596 EXPECT_THAT(Results.Context, CodeCompletionContext::CCC_DotMemberAccess);
2599TEST(CompletionTest, OffsetOfDesignator) {
2600 auto Results = completions(R
"cpp(
2601 struct S { int field; int other; void fieldFn(); };
2602 int x = __builtin_offsetof(S, fiel^d);
2605 Results.Completions,
2607 EXPECT_THAT(Results.Context, CodeCompletionContext::CCC_DotMemberAccess);
2609 Results = completions(R
"cpp(
2610 struct Inner { int field; void fieldFn(); };
2611 struct Outer { Inner inner; };
2612 int x = __builtin_offsetof(Outer, inner.fiel^d);
2615 Results.Completions,
2618 Results = completions(R
"cpp(
2619 struct Inner { int field; void fieldFn(); };
2620 struct Outer { Inner inner[2]; };
2622 int x = __builtin_offsetof(Outer, inner[i].fiel^d);
2625 Results.Completions,
2628 Results = completions(R
"cpp(
2629 struct Base { int field; void fieldFn(); };
2630 struct Derived : Base {};
2631 int x = __builtin_offsetof(Derived, fiel^d);
2634 Results.Completions,
2638TEST(CompletionTest, FixItForArrowToDot) {
2643 Opts.IncludeFixIts =
true;
2650 class ClassWithPtr {
2652 void MemberFunction();
2653 Auxilary* operator->() const;
2661 auto Results = completions(Code, {}, Opts);
2662 EXPECT_EQ(Results.Completions.size(), 3u);
2666 ReplacementEdit.newText =
".";
2667 for (
const auto &C : Results.Completions) {
2668 EXPECT_TRUE(
C.FixIts.size() == 1u ||
C.Name ==
"AuxFunction");
2669 if (!
C.FixIts.empty()) {
2670 EXPECT_THAT(
C.FixIts, ElementsAre(ReplacementEdit));
2675TEST(CompletionTest, FixItForDotToArrow) {
2677 Opts.IncludeFixIts =
true;
2684 class ClassWithPtr {
2686 void MemberFunction();
2687 Auxilary* operator->() const;
2695 auto Results = completions(Code, {}, Opts);
2696 EXPECT_EQ(Results.Completions.size(), 3u);
2700 ReplacementEdit.newText =
"->";
2701 for (
const auto &C : Results.Completions) {
2702 EXPECT_TRUE(
C.FixIts.empty() ||
C.Name ==
"AuxFunction");
2703 if (!
C.FixIts.empty()) {
2704 EXPECT_THAT(
C.FixIts, ElementsAre(ReplacementEdit));
2709TEST(CompletionTest, RenderWithFixItMerged) {
2712 FixIt.newText =
"->";
2716 C.RequiredQualifier =
"Foo::";
2718 C.CompletionInsertRange.start.character = 5;
2721 Opts.IncludeFixIts =
true;
2723 auto R =
C.render(Opts);
2724 EXPECT_TRUE(R.textEdit);
2725 EXPECT_EQ(std::get<TextEdit>(*R.textEdit).newText,
"->Foo::x");
2726 EXPECT_TRUE(R.additionalTextEdits.empty());
2729TEST(CompletionTest, RenderWithFixItNonMerged) {
2732 FixIt.newText =
"->";
2736 C.RequiredQualifier =
"Foo::";
2738 C.CompletionInsertRange.start.character = 5;
2741 Opts.IncludeFixIts =
true;
2743 auto R =
C.render(Opts);
2744 EXPECT_TRUE(R.textEdit);
2745 EXPECT_EQ(std::get<TextEdit>(*R.textEdit).newText,
"Foo::x");
2746 EXPECT_THAT(R.additionalTextEdits, UnorderedElementsAre(FixIt));
2749TEST(CompletionTest, CompletionInsertRange) {
2755 constexpr const char *TestCodes[] = {
2777 #include "foo/[[a^/]]foo.h"
2780 #include "foo/abc/[[fo^o.h"]]
2783 for (
const auto &
Text : TestCodes) {
2785 TU.Code = TestCode.code().str();
2786 auto Results = completions(TU, TestCode.point());
2787 if (Results.Completions.size() != 1) {
2788 ADD_FAILURE() <<
"Results.Completions.size() != 1" <<
Text;
2791 EXPECT_THAT(Results.Completions.front().CompletionInsertRange,
2796TEST(SignatureHelpTest, OverloadsOrdering) {
2797 const auto Results = signatures(R
"cpp(
2799 void foo(int x, float y);
2800 void foo(float x, int y);
2801 void foo(float x, float y);
2802 void foo(int x, int y = 0);
2803 int main() { foo(^); }
2805 EXPECT_THAT(Results.signatures,
2806 ElementsAre(sig("foo([[int x]]) -> void"),
2807 sig(
"foo([[int x]], [[int y = 0]]) -> void"),
2808 sig(
"foo([[float x]], [[int y]]) -> void"),
2809 sig(
"foo([[int x]], [[float y]]) -> void"),
2810 sig(
"foo([[float x]], [[float y]]) -> void")));
2812 EXPECT_EQ(0, Results.activeSignature);
2813 EXPECT_EQ(0, Results.activeParameter);
2816TEST(SignatureHelpTest, InstantiatedSignatures) {
2817 StringRef Sig0 = R
"cpp(
2826 EXPECT_THAT(signatures(Sig0).signatures,
2827 ElementsAre(sig("foo([[T]], [[T]], [[T]]) -> void")));
2829 StringRef Sig1 = R
"cpp(
2837 EXPECT_THAT(signatures(Sig1).signatures,
2838 ElementsAre(sig("foo([[T]], [[T]], [[T]]) -> void")));
2840 StringRef Sig2 = R
"cpp(
2841 template <class ...T>
2849 EXPECT_THAT(signatures(Sig2).signatures,
2850 ElementsAre(sig("foo([[T...]]) -> void")));
2857 StringRef Sig3 = R
"cpp(
2865 X<int>().foo<double>(^)
2869 EXPECT_THAT(signatures(Sig3).signatures,
2870 ElementsAre(sig("foo([[T]], [[U]]) -> void")));
2873TEST(SignatureHelpTest, IndexDocumentation) {
2874 Symbol Foo0 =
sym(
"foo", index::SymbolKind::Function,
"@F@\\0#");
2875 Foo0.Documentation =
"doc from the index";
2876 Symbol Foo1 =
sym(
"foo", index::SymbolKind::Function,
"@F@\\0#I#");
2877 Foo1.Documentation =
"doc from the index";
2878 Symbol Foo2 =
sym(
"foo", index::SymbolKind::Function,
"@F@\\0#I#I#");
2880 StringRef Sig0 = R
"cpp(
2890 signatures(Sig0, {Foo0}).signatures,
2891 ElementsAre(AllOf(sig("foo() -> int"), sigDoc(
"doc from the index")),
2892 AllOf(sig(
"foo([[double]]) -> int"), sigDoc(
""))));
2894 StringRef Sig1 = R
"cpp(
2896 // Overriden doc from sema
2907 signatures(Sig1, {Foo0, Foo1, Foo2}).signatures,
2909 AllOf(sig("foo() -> int"), sigDoc(
"doc from the index")),
2910 AllOf(sig(
"foo([[int]]) -> int"), sigDoc(
"Overriden doc from sema")),
2911 AllOf(sig(
"foo([[int]], [[int]]) -> int"), sigDoc(
"doc from sema"))));
2914TEST(SignatureHelpTest, DynamicIndexDocumentation) {
2918 Opts.BuildDynamicSymbolIndex =
true;
2921 FS.Files[
testPath(
"foo.h")] = R
"cpp(
2935 Server.addDocument(
File, FileContent.code());
2937 ASSERT_TRUE(Server.blockUntilIdleForTest());
2941 ElementsAre(AllOf(sig(
"foo() -> int"), sigDoc(
"Member doc"))));
2944TEST(CompletionTest, ArgumentListsPolicy) {
2946 Opts.EnableSnippets =
true;
2950 auto Results = completions(
2953 void xfoo(int x, int y);
2954 void f() { xfo^ })cpp",
2957 Results.Completions,
2958 UnorderedElementsAre(AllOf(named("xfoo"), snippetSuffix(
"()")),
2959 AllOf(named(
"xfoo"), snippetSuffix(
"($0)"))));
2962 auto Results = completions(
2965 void f() { xba^ })cpp",
2967 EXPECT_THAT(Results.Completions, UnorderedElementsAre(AllOf(
2968 named("xbar"), snippetSuffix(
"()"))));
2971 Opts.BundleOverloads =
true;
2972 auto Results = completions(
2975 void xfoo(int x, int y);
2976 void f() { xfo^ })cpp",
2979 Results.Completions,
2980 UnorderedElementsAre(AllOf(named("xfoo"), snippetSuffix(
"($0)"))));
2983 auto Results = completions(
2985 template <class T, class U>
2986 void xfoo(int a, U b);
2987 void f() { xfo^ })cpp",
2990 Results.Completions,
2991 UnorderedElementsAre(AllOf(named("xfoo"), snippetSuffix(
"<$1>($0)"))));
2994 auto Results = completions(
2999 using foo_alias = T**;
3002 void f() { foo_^ })cpp",
3005 Results.Completions,
3006 UnorderedElementsAre(AllOf(named("foo_class"), snippetSuffix(
"<$0>")),
3007 AllOf(named(
"foo_alias"), snippetSuffix(
"<$0>")),
3008 AllOf(named(
"foo_var"), snippetSuffix(
"<$0>"))));
3011 auto Results = completions(
3013 #define FOO(x, y) x##f
3016 EXPECT_THAT(Results.Completions, UnorderedElementsAre(AllOf(
3017 named("FOO"), snippetSuffix(
"($0)"))));
3020 auto Results = completions(
3023 auto Lambda = [](int a, const double &b) {return 1.f;};
3028 Results.Completions,
3029 UnorderedElementsAre(AllOf(named("Lambda"), snippetSuffix(
"($0)"))));
3033 auto Results = completions(
3035 void xfoo(int x, int y);
3036 void f() { xfo^ })cpp",
3038 EXPECT_THAT(Results.Completions,
3039 UnorderedElementsAre(AllOf(named("xfoo"), snippetSuffix(
""))));
3043 auto Results = completions(
3045 void xfoo(int x, int y);
3046 void f() { xfo^ })cpp",
3048 EXPECT_THAT(Results.Completions,
3049 UnorderedElementsAre(AllOf(named("xfoo"), snippetSuffix(
"("))));
3053TEST(CompletionTest, SuggestOverrides) {
3054 constexpr const char *
const Text(R
"cpp(
3057 virtual void vfunc(bool param);
3058 virtual void vfunc(bool param, int p);
3059 void func(bool param);
3061 class B : public A {
3062 virtual void ttt(bool param) const;
3063 void vfunc(bool param, int p) override;
3065 class C : public B {
3067 void vfunc(bool param) override;
3071 const auto Results = completions(
Text);
3073 Results.Completions,
3074 AllOf(Contains(AllOf(labeled(
"void vfunc(bool param, int p) override"),
3075 nameStartsWith(
"vfunc"))),
3076 Contains(AllOf(labeled(
"void ttt(bool param) const override"),
3077 nameStartsWith(
"ttt"))),
3078 Not(Contains(labeled(
"void vfunc(bool param) override")))));
3081TEST(CompletionTest, OverridesNonIdentName) {
3085 virtual ~Base() = 0;
3086 virtual operator int() = 0;
3087 virtual Base& operator+(Base&) = 0;
3090 struct Derived : Base {
3096TEST(CompletionTest, NoCrashOnMissingNewLineAtEOF) {
3102 FS.Files[FooCpp] = F.code().str();
3107 clangd::CodeCompleteOptions()))
3116TEST(GuessCompletionPrefix, Filters) {
3117 for (llvm::StringRef Case : {
3118 "[[scope::]][[ident]]^",
3127 "some text [[scope::more::]][[identif]]^ier",
3128 "some text [[scope::]][[mor]]^e::identifier",
3129 "weird case foo::[[::bar::]][[baz]]^",
3134 auto ToStringRef = [&](
Range R) {
3138 auto WantQualifier = ToStringRef(F.ranges()[0]),
3139 WantName = ToStringRef(F.ranges()[1]);
3143 EXPECT_EQ(WantQualifier, Prefix.Qualifier) << Case;
3144 EXPECT_EQ(WantQualifier.begin(), Prefix.Qualifier.begin()) << Case;
3145 EXPECT_EQ(WantName, Prefix.Name) << Case;
3146 EXPECT_EQ(WantName.begin(), Prefix.Name.begin()) << Case;
3150TEST(CompletionTest, EnableSpeculativeIndexRequest) {
3157 namespace ns1 { int abc; }
3158 namespace ns2 { int abc; }
3159 void f() { ns1::ab$1^; ns1::ab$2^; }
3160 void f2() { ns2::ab$3^; }
3163 clangd::CodeCompleteOptions Opts = {};
3165 IndexRequestCollector Requests;
3166 Opts.Index = &Requests;
3168 auto CompleteAtPoint = [&](StringRef
P) {
3170 EXPECT_TRUE(CCR.HasMore);
3173 CompleteAtPoint(
"1");
3174 auto Reqs1 = Requests.consumeRequests(1);
3175 ASSERT_EQ(Reqs1.size(), 1u);
3176 EXPECT_THAT(Reqs1[0].Scopes, UnorderedElementsAre(
"ns1::"));
3178 CompleteAtPoint(
"2");
3179 auto Reqs2 = Requests.consumeRequests(1);
3181 ASSERT_EQ(Reqs2.size(), 1u);
3182 EXPECT_EQ(Reqs2[0], Reqs1[0]);
3184 CompleteAtPoint(
"3");
3187 auto Reqs3 = Requests.consumeRequests(2);
3188 ASSERT_EQ(Reqs3.size(), 2u);
3191TEST(CompletionTest, InsertTheMostPopularHeader) {
3194 Sym.CanonicalDeclaration.FileURI = DeclFile.c_str();
3198 auto Results = completions(
"Fun^", {Sym}).Completions;
3199 assert(!Results.empty());
3200 EXPECT_THAT(Results[0], AllOf(named(
"Func"), insertInclude(
"\"bar.h\"")));
3201 EXPECT_EQ(Results[0].Includes.size(), 2u);
3204TEST(CompletionTest, InsertIncludeOrImport) {
3207 Sym.CanonicalDeclaration.FileURI = DeclFile.c_str();
3208 Sym.IncludeHeaders.emplace_back(
"\"bar.h\"", 1000,
3212 Opts.ImportInsertions =
true;
3213 auto Results = completions(
"Fun^", {Sym}, Opts).Completions;
3214 assert(!Results.empty());
3215 EXPECT_THAT(Results[0],
3216 AllOf(named(
"Func"), insertIncludeText(
"#include \"bar.h\"\n")));
3220 Opts.MainFileSignals = &Signals;
3221 Results = completions(
"Fun^", {Sym}, Opts,
"Foo.m").Completions;
3222 assert(!Results.empty());
3223 EXPECT_THAT(Results[0],
3224 AllOf(named(
"Func"), insertIncludeText(
"#import \"bar.h\"\n")));
3227 Results = completions(
"Fun^", {Sym}).Completions;
3228 assert(!Results.empty());
3229 EXPECT_THAT(Results[0], AllOf(named(
"Func"), Not(insertInclude())));
3232TEST(CompletionTest, NoInsertIncludeIfOnePresent) {
3238 TU.AdditionalFiles[
"foo.h"] =
"";
3242 Sym.CanonicalDeclaration.FileURI = DeclFile.c_str();
3246 EXPECT_THAT(completions(TU, Test.point(), {Sym}).Completions,
3247 UnorderedElementsAre(AllOf(named(
"Func"), hasInclude(
"\"foo.h\""),
3248 Not(insertInclude()))));
3251TEST(CompletionTest, MergeMacrosFromIndexAndSema) {
3253 Sym.Name =
"Clangd_Macro_Test";
3254 Sym.ID =
SymbolID(
"c:foo.cpp@8@macro@Clangd_Macro_Test");
3255 Sym.SymInfo.Kind = index::SymbolKind::Macro;
3257 EXPECT_THAT(completions(
"#define Clangd_Macro_Test\nClangd_Macro_T^", {Sym})
3259 UnorderedElementsAre(named(
"Clangd_Macro_Test")));
3262TEST(CompletionTest, MacroFromPreamble) {
3263 Annotations Test(R
"cpp(#define CLANGD_PREAMBLE_MAIN x
3266 #define CLANGD_MAIN x
3267 void f() { CLANGD_^ }
3270 TU.HeaderCode =
"#define CLANGD_PREAMBLE_HEADER x";
3271 auto Results = completions(TU, Test.point(), {func(
"CLANGD_INDEX")});
3274 EXPECT_THAT(Results.Completions,
3275 UnorderedElementsAre(named(
"CLANGD_PREAMBLE_MAIN"),
3276 named(
"CLANGD_MAIN"),
3277 named(
"CLANGD_INDEX")));
3280TEST(CompletionTest, DeprecatedResults) {
3281 std::string Body = R
"cpp(
3283 void TestClangc() __attribute__((deprecated("", "")));
3287 completions(Body + "int main() { TestClang^ }").Completions,
3288 UnorderedElementsAre(AllOf(named(
"TestClangd"), Not(deprecated())),
3289 AllOf(named(
"TestClangc"), deprecated())));
3292TEST(SignatureHelpTest, PartialSpec) {
3293 const auto Results = signatures(R
"cpp(
3294 template <typename T> struct Foo {};
3295 template <typename T> struct Foo<T*> { Foo(T); };
3296 Foo<int*> F(^);)cpp");
3297 EXPECT_THAT(Results.signatures, Contains(sig("Foo([[T]])")));
3298 EXPECT_EQ(0, Results.activeParameter);
3301TEST(SignatureHelpTest, InsideArgument) {
3303 const auto Results = signatures(R
"cpp(
3305 void foo(int x, int y);
3306 int main() { foo(1+^); }
3308 EXPECT_THAT(Results.signatures,
3309 ElementsAre(sig("foo([[int x]]) -> void"),
3310 sig(
"foo([[int x]], [[int y]]) -> void")));
3311 EXPECT_EQ(0, Results.activeParameter);
3314 const auto Results = signatures(R
"cpp(
3316 void foo(int x, int y);
3317 int main() { foo(1^); }
3319 EXPECT_THAT(Results.signatures,
3320 ElementsAre(sig("foo([[int x]]) -> void"),
3321 sig(
"foo([[int x]], [[int y]]) -> void")));
3322 EXPECT_EQ(0, Results.activeParameter);
3325 const auto Results = signatures(R
"cpp(
3327 void foo(int x, int y);
3328 int main() { foo(1^0); }
3330 EXPECT_THAT(Results.signatures,
3331 ElementsAre(sig("foo([[int x]]) -> void"),
3332 sig(
"foo([[int x]], [[int y]]) -> void")));
3333 EXPECT_EQ(0, Results.activeParameter);
3336 const auto Results = signatures(R
"cpp(
3338 void foo(int x, int y);
3339 int bar(int x, int y);
3340 int main() { bar(foo(2, 3^)); }
3342 EXPECT_THAT(Results.signatures,
3343 ElementsAre(sig("foo([[int x]], [[int y]]) -> void")));
3344 EXPECT_EQ(1, Results.activeParameter);
3348TEST(SignatureHelpTest, ConstructorInitializeFields) {
3350 const auto Results = signatures(R
"cpp(
3351 struct A { A(int); };
3357 EXPECT_THAT(Results.signatures,
3358 UnorderedElementsAre(sig("A([[int]])"), sig(
"A([[A &&]])"),
3359 sig(
"A([[const A &]])")));
3362 const auto Results = signatures(R
"cpp(
3363 struct A { A(int); };
3371 EXPECT_THAT(Results.signatures, IsEmpty());
3374 const auto Results = signatures(R
"cpp(
3375 struct A { A(int); };
3382 EXPECT_THAT(Results.signatures,
3383 UnorderedElementsAre(sig("A([[int]])"), sig(
"A([[A &&]])"),
3384 sig(
"A([[const A &]])")));
3387 const auto Results = signatures(R
"cpp(
3396 B() : c_elem(A(1^)) {}
3400 EXPECT_THAT(Results.signatures,
3401 UnorderedElementsAre(sig("A([[int]])"), sig(
"A([[A &&]])"),
3402 sig(
"A([[const A &]])")));
3406TEST(SignatureHelpTest, Variadic) {
3407 const std::string Header = R
"cpp(
3408 void fun(int x, ...) {}
3410 const std::string ExpectedSig =
"fun([[int x]], [[...]]) -> void";
3413 const auto Result = signatures(Header +
"fun(^);}");
3414 EXPECT_EQ(0, Result.activeParameter);
3415 EXPECT_THAT(Result.signatures, UnorderedElementsAre(sig(ExpectedSig)));
3418 const auto Result = signatures(Header +
"fun(1, ^);}");
3419 EXPECT_EQ(1, Result.activeParameter);
3420 EXPECT_THAT(Result.signatures, UnorderedElementsAre(sig(ExpectedSig)));
3423 const auto Result = signatures(Header +
"fun(1, 2, ^);}");
3424 EXPECT_EQ(1, Result.activeParameter);
3425 EXPECT_THAT(Result.signatures, UnorderedElementsAre(sig(ExpectedSig)));
3429TEST(SignatureHelpTest, VariadicTemplate) {
3430 const std::string Header = R
"cpp(
3431 template<typename T, typename ...Args>
3432 void fun(T t, Args ...args) {}
3434 const std::string ExpectedSig =
"fun([[T t]], [[Args args...]]) -> void";
3437 const auto Result = signatures(Header +
"fun(^);}");
3438 EXPECT_EQ(0, Result.activeParameter);
3439 EXPECT_THAT(Result.signatures, UnorderedElementsAre(sig(ExpectedSig)));
3442 const auto Result = signatures(Header +
"fun(1, ^);}");
3443 EXPECT_EQ(1, Result.activeParameter);
3444 EXPECT_THAT(Result.signatures, UnorderedElementsAre(sig(ExpectedSig)));
3447 const auto Result = signatures(Header +
"fun(1, 2, ^);}");
3448 EXPECT_EQ(1, Result.activeParameter);
3449 EXPECT_THAT(Result.signatures, UnorderedElementsAre(sig(ExpectedSig)));
3453TEST(SignatureHelpTest, VariadicMethod) {
3454 const std::string Header = R
"cpp(
3456 template<typename T, typename ...Args>
3457 void fun(T t, Args ...args) {}
3459 void test() {C c; )cpp";
3460 const std::string ExpectedSig =
"fun([[T t]], [[Args args...]]) -> void";
3463 const auto Result = signatures(Header +
"c.fun(^);}");
3464 EXPECT_EQ(0, Result.activeParameter);
3465 EXPECT_THAT(Result.signatures, UnorderedElementsAre(sig(ExpectedSig)));
3468 const auto Result = signatures(Header +
"c.fun(1, ^);}");
3469 EXPECT_EQ(1, Result.activeParameter);
3470 EXPECT_THAT(Result.signatures, UnorderedElementsAre(sig(ExpectedSig)));
3473 const auto Result = signatures(Header +
"c.fun(1, 2, ^);}");
3474 EXPECT_EQ(1, Result.activeParameter);
3475 EXPECT_THAT(Result.signatures, UnorderedElementsAre(sig(ExpectedSig)));
3479TEST(SignatureHelpTest, VariadicType) {
3480 const std::string Header = R
"cpp(
3481 void fun(int x, ...) {}
3482 auto get_fun() { return fun; }
3485 const std::string ExpectedSig =
"([[int]], [[...]]) -> void";
3488 const auto Result = signatures(Header +
"get_fun()(^);}");
3489 EXPECT_EQ(0, Result.activeParameter);
3490 EXPECT_THAT(Result.signatures, UnorderedElementsAre(sig(ExpectedSig)));
3493 const auto Result = signatures(Header +
"get_fun()(1, ^);}");
3494 EXPECT_EQ(1, Result.activeParameter);
3495 EXPECT_THAT(Result.signatures, UnorderedElementsAre(sig(ExpectedSig)));
3498 const auto Result = signatures(Header +
"get_fun()(1, 2, ^);}");
3499 EXPECT_EQ(1, Result.activeParameter);
3500 EXPECT_THAT(Result.signatures, UnorderedElementsAre(sig(ExpectedSig)));
3504TEST(SignatureHelpTest, SkipExplicitObjectParameter) {
3507 void foo(this auto&& self, int arg);
3508 void bar(this A self, int arg);
3519 TU.ExtraArgs = {
"-std=c++23"};
3522 auto Inputs = TU.inputs(FS);
3531 EXPECT_EQ(1U, Result.signatures.size());
3533 EXPECT_THAT(Result.signatures[0], AllOf(sig(
"foo([[int arg]]) -> void")));
3539 EXPECT_EQ(1U, Result.signatures.size());
3541 EXPECT_THAT(Result.signatures[0], AllOf(sig(
"([[A]], [[int]]) -> void")));
3548 EXPECT_EQ(0U, Result.signatures.size());
3554TEST(CompletionTest, IncludedCompletionKinds) {
3557 TU.AdditionalFiles[
"sub/bar.h"] =
"";
3558 TU.ExtraArgs.push_back(
"-I" +
testPath(
"sub"));
3560 auto Results = completions(TU, Test.point());
3561 EXPECT_THAT(Results.Completions,
3566TEST(CompletionTest, NoCrashAtNonAlphaIncludeHeader) {
3573TEST(CompletionTest, NoAllScopesCompletionWhenQualified) {
3574 clangd::CodeCompleteOptions Opts = {};
3575 Opts.AllScopes = true;
3577 auto Results = completions(
3579 void f() { na::Clangd^ }
3581 {cls("na::ClangdA"),
cls(
"nx::ClangdX"),
cls(
"Clangd3")}, Opts);
3582 EXPECT_THAT(Results.Completions,
3583 UnorderedElementsAre(
3584 AllOf(qualifier(
""), scope(
"na::"), named(
"ClangdA"))));
3587TEST(CompletionTest, AllScopesCompletion) {
3588 clangd::CodeCompleteOptions Opts = {};
3589 Opts.AllScopes =
true;
3591 auto Results = completions(
3594 void f() { Clangd^ }
3597 {cls("nx::Clangd1"),
cls(
"ny::Clangd2"),
cls(
"Clangd3"),
3601 Results.Completions,
3602 UnorderedElementsAre(AllOf(qualifier(
"nx::"), named(
"Clangd1"),
3604 AllOf(qualifier(
"ny::"), named(
"Clangd2"),
3606 AllOf(qualifier(
""), scope(
""), named(
"Clangd3"),
3608 AllOf(qualifier(
"nb::"), named(
"Clangd4"),
3610 AllOf(qualifier(
"C::"), named(
"Clangd5"),
3614TEST(CompletionTest, NoCodePatternsIfDisabled) {
3615 clangd::CodeCompleteOptions Opts = {};
3616 Opts.EnableSnippets =
true;
3619 auto Results = completions(R
"cpp(
3628 EXPECT_THAT(Results.Completions,
3632TEST(CompletionTest, CompleteIncludeIfCodePatternsNone) {
3633 clangd::CodeCompleteOptions Opts = {};
3634 Opts.EnableSnippets =
true;
3639 TU.AdditionalFiles[
"foo/bar.h"] =
"";
3640 TU.ExtraArgs.push_back(
"-I" +
testPath(
"foo"));
3642 auto Results = completions(TU, Test.point(), {}, Opts);
3643 EXPECT_THAT(Results.Completions,
3648TEST(CompletionTest, NoQualifierIfShadowed) {
3649 clangd::CodeCompleteOptions Opts = {};
3650 Opts.AllScopes =
true;
3652 auto Results = completions(R
"cpp(
3653 namespace nx { class Clangd1 {}; }
3655 void f() { Clangd^ }
3657 {cls("nx::Clangd1"),
cls(
"nx::Clangd2")}, Opts);
3660 EXPECT_THAT(Results.Completions,
3661 UnorderedElementsAre(AllOf(qualifier(
""), named(
"Clangd1")),
3662 AllOf(qualifier(
"nx::"), named(
"Clangd2"))));
3665TEST(CompletionTest, NoCompletionsForNewNames) {
3666 clangd::CodeCompleteOptions Opts;
3667 Opts.AllScopes =
true;
3668 auto Results = completions(R
"cpp(
3671 {cls("naber"),
cls(
"nx::naber")}, Opts);
3672 EXPECT_THAT(Results.Completions, UnorderedElementsAre());
3675TEST(CompletionTest, Lambda) {
3676 clangd::CodeCompleteOptions Opts = {};
3678 auto Results = completions(R
"cpp(
3680 auto Lambda = [](int a, const double &b) {return 1.f;};
3686 ASSERT_EQ(Results.Completions.size(), 1u);
3687 const auto &
A = Results.Completions.front();
3688 EXPECT_EQ(
A.Name,
"Lambda");
3689 EXPECT_EQ(
A.Signature,
"(int a, const double &b) const");
3691 EXPECT_EQ(
A.ReturnType,
"float");
3692 EXPECT_EQ(
A.SnippetSuffix,
"(${1:int a}, ${2:const double &b})");
3695TEST(CompletionTest, StructuredBinding) {
3696 clangd::CodeCompleteOptions Opts = {};
3698 auto Results = completions(R
"cpp(
3700 using Float = float;
3705 const auto &[xxx, yyy] = S{};
3711 ASSERT_EQ(Results.Completions.size(), 1u);
3712 const auto &
A = Results.Completions.front();
3713 EXPECT_EQ(
A.Name,
"yyy");
3715 EXPECT_EQ(
A.ReturnType,
"const Float");
3718TEST(CompletionTest, ObjectiveCMethodNoArguments) {
3719 auto Results = completions(R
"objc(
3721 @property(nonatomic, setter=setXToIgnoreComplete:) int value;
3723 Foo *foo = [Foo new]; int y = [foo v^]
3728 auto C = Results.Completions;
3729 EXPECT_THAT(C, ElementsAre(named(
"value")));
3731 EXPECT_THAT(C, ElementsAre(returnType(
"int")));
3732 EXPECT_THAT(C, ElementsAre(signature(
"")));
3733 EXPECT_THAT(C, ElementsAre(snippetSuffix(
"")));
3736TEST(CompletionTest, ObjectiveCMethodOneArgument) {
3737 auto Results = completions(R
"objc(
3739 - (int)valueForCharacter:(char)c;
3741 Foo *foo = [Foo new]; int y = [foo v^]
3746 auto C = Results.Completions;
3747 EXPECT_THAT(C, ElementsAre(named(
"valueForCharacter:")));
3749 EXPECT_THAT(C, ElementsAre(returnType(
"int")));
3750 EXPECT_THAT(C, ElementsAre(signature(
"(char)")));
3751 EXPECT_THAT(C, ElementsAre(snippetSuffix(
"${1:(char)}")));
3754TEST(CompletionTest, ObjectiveCMethodTwoArgumentsFromBeginning) {
3755 auto Results = completions(R
"objc(
3757 + (id)fooWithValue:(int)value fooey:(unsigned int)fooey;
3764 auto C = Results.Completions;
3765 EXPECT_THAT(C, ElementsAre(named(
"fooWithValue:")));
3767 EXPECT_THAT(C, ElementsAre(returnType(
"id")));
3768 EXPECT_THAT(C, ElementsAre(signature(
"(int) fooey:(unsigned int)")));
3770 C, ElementsAre(snippetSuffix(
"${1:(int)} fooey:${2:(unsigned int)}")));
3773TEST(CompletionTest, ObjectiveCMethodTwoArgumentsFromMiddle) {
3774 auto Results = completions(R
"objc(
3776 + (id)fooWithValue:(int)value fooey:(unsigned int)fooey;
3778 id val = [Foo fooWithValue:10 f^]
3783 auto C = Results.Completions;
3784 EXPECT_THAT(C, ElementsAre(named(
"fooey:")));
3786 EXPECT_THAT(C, ElementsAre(returnType(
"id")));
3787 EXPECT_THAT(C, ElementsAre(signature(
"(unsigned int)")));
3788 EXPECT_THAT(C, ElementsAre(snippetSuffix(
"${1:(unsigned int)}")));
3791TEST(CompletionTest, ObjectiveCMethodFilterOnEntireSelector) {
3792 auto Results = completions(R
"objc(
3794 + (id)player:(id)player willRun:(id)run;
3801 auto C = Results.Completions;
3802 EXPECT_THAT(C, ElementsAre(named(
"player:")));
3803 EXPECT_THAT(C, ElementsAre(filterText(
"player:willRun:")));
3805 EXPECT_THAT(C, ElementsAre(returnType(
"id")));
3806 EXPECT_THAT(C, ElementsAre(signature(
"(id) willRun:(id)")));
3807 EXPECT_THAT(C, ElementsAre(snippetSuffix(
"${1:(id)} willRun:${2:(id)}")));
3810TEST(CompletionTest, ObjectiveCSimpleMethodDeclaration) {
3811 auto Results = completions(R
"objc(
3822 auto C = Results.Completions;
3823 EXPECT_THAT(C, ElementsAre(named(
"foo")));
3825 EXPECT_THAT(C, ElementsAre(qualifier(
"- (void)")));
3828TEST(CompletionTest, ObjectiveCMethodDeclaration) {
3829 auto Results = completions(R
"objc(
3831 - (int)valueForCharacter:(char)c secondArgument:(id)object;
3840 auto C = Results.Completions;
3841 EXPECT_THAT(C, ElementsAre(named(
"valueForCharacter:")));
3843 EXPECT_THAT(C, ElementsAre(qualifier(
"- (int)")));
3844 EXPECT_THAT(C, ElementsAre(signature(
"(char)c secondArgument:(id)object")));
3847TEST(CompletionTest, ObjectiveCMethodDeclarationFilterOnEntireSelector) {
3848 auto Results = completions(R
"objc(
3850 - (int)valueForCharacter:(char)c secondArgument:(id)object;
3859 auto C = Results.Completions;
3860 EXPECT_THAT(C, ElementsAre(named(
"valueForCharacter:")));
3861 EXPECT_THAT(C, ElementsAre(filterText(
"valueForCharacter:secondArgument:")));
3863 EXPECT_THAT(C, ElementsAre(qualifier(
"- (int)")));
3864 EXPECT_THAT(C, ElementsAre(signature(
"(char)c secondArgument:(id)object")));
3867TEST(CompletionTest, ObjectiveCMethodDeclarationPrefixTyped) {
3868 auto Results = completions(R
"objc(
3870 - (int)valueForCharacter:(char)c;
3879 auto C = Results.Completions;
3880 EXPECT_THAT(C, ElementsAre(named(
"valueForCharacter:")));
3882 EXPECT_THAT(C, ElementsAre(signature(
"(char)c")));
3885TEST(CompletionTest, ObjectiveCMethodDeclarationFromMiddle) {
3886 auto Results = completions(R
"objc(
3888 - (int)valueForCharacter:(char)c secondArgument:(id)object;
3891 - (int)valueForCharacter:(char)c second^
3897 auto C = Results.Completions;
3898 EXPECT_THAT(C, ElementsAre(named(
"secondArgument:")));
3900 EXPECT_THAT(C, ElementsAre(signature(
"(id)object")));
3903TEST(CompletionTest, ObjectiveCProtocolFromIndex) {
3907 auto Results = completions(
"id<Foo^>", {SymFood, FoodClass, SymFooey},
3911 EXPECT_THAT(Results.Completions,
3912 UnorderedElementsAre(
3916 Results = completions(
"Fo^", {SymFood, FoodClass, SymFooey},
3920 Results.Completions,
3924TEST(CompletionTest, ObjectiveCProtocolFromIndexSpeculation) {
3937 clangd::CodeCompleteOptions Opts = {};
3940 IndexRequestCollector Requests({FoodClass});
3941 Opts.Index = &Requests;
3943 auto CompleteAtPoint = [&](StringRef
P) {
3948 auto C = CompleteAtPoint(
"1");
3949 auto Reqs1 = Requests.consumeRequests(1);
3950 ASSERT_EQ(Reqs1.size(), 1u);
3951 EXPECT_THAT(C, ElementsAre(AllOf(named(
"Food"),
3954 C = CompleteAtPoint(
"2");
3955 auto Reqs2 = Requests.consumeRequests(1);
3958 ASSERT_EQ(Reqs2.size(), 1u);
3959 EXPECT_EQ(Reqs2[0], Reqs1[0]);
3960 EXPECT_THAT(C, ElementsAre(AllOf(named(
"FoodClass"),
3964TEST(CompletionTest, ObjectiveCCategoryFromIndexIgnored) {
3966 auto Results = completions(R
"objc(
3974 EXPECT_THAT(Results.Completions, IsEmpty());
3977TEST(CompletionTest, ObjectiveCForwardDeclFromIndex) {
3979 FoodClass.IncludeHeaders.emplace_back(
"\"Foo.h\"", 2,
Symbol::Import);
3981 auto Results = completions(
"@class Foo^", {SymFood, FoodClass},
3985 EXPECT_THAT(Results.Completions,
3986 UnorderedElementsAre(AllOf(named(
"FoodClass"),
3988 Not(insertInclude()))));
3991TEST(CompletionTest, CursorInSnippets) {
3992 clangd::CodeCompleteOptions Options;
3993 Options.EnableSnippets =
true;
3994 auto Results = completions(
3996 void while_foo(int a, int b);
4003 EXPECT_THAT(Results.Completions,
4004 Contains(AllOf(named(
"while"),
4005 snippetSuffix(
" (${1:condition}) {\n$0\n}"))));
4007 EXPECT_THAT(Results.Completions,
4008 Contains(AllOf(named(
"while_foo"),
4009 snippetSuffix(
"(${1:int a}, ${2:int b})"))));
4011 Results = completions(R
"cpp(
4013 Base(int a, int b) {}
4016 struct Derived : Base {
4023 EXPECT_THAT(Results.Completions,
4024 Contains(AllOf(named(
"Base"),
4025 snippetSuffix(
"(${1:int a}, ${2:int b})"))));
4028TEST(CompletionTest, WorksWithNullType) {
4029 auto R = completions(R
"cpp(
4031 for (auto [loopVar] : y ) { // y has to be unresolved.
4036 EXPECT_THAT(R.Completions, ElementsAre(named("loopVar")));
4039TEST(CompletionTest, UsingDecl) {
4040 const char *Header(R
"cpp(
4045 const char *Source(R
"cpp(
4050 clangd::CodeCompleteOptions Opts;
4051 Opts.Index = Index.get();
4052 Opts.AllScopes =
true;
4053 auto R = completions(Source, {}, Opts);
4054 EXPECT_THAT(R.Completions,
4055 ElementsAre(AllOf(scope(
"std::"), named(
"foo"),
4059TEST(CompletionTest, Enums) {
4060 const char *Header(R
"cpp(
4062 enum Unscoped { Clangd1 };
4064 enum Unscoped { Clangd2 };
4066 enum class Scoped { Clangd3 };
4068 const char *Source(R
"cpp(
4073 clangd::CodeCompleteOptions Opts;
4074 Opts.Index = Index.get();
4075 Opts.AllScopes =
true;
4076 auto R = completions(Source, {}, Opts);
4077 EXPECT_THAT(R.Completions, UnorderedElementsAre(
4078 AllOf(scope(
"ns::"), named(
"Clangd1"),
4080 AllOf(scope(
"ns::C::"), named(
"Clangd2"),
4082 AllOf(scope(
"ns::Scoped::"), named(
"Clangd3"),
4086TEST(CompletionTest, ScopeIsUnresolved) {
4087 clangd::CodeCompleteOptions Opts = {};
4088 Opts.AllScopes =
true;
4090 auto Results = completions(R
"cpp(
4095 {cls("a::b::XYZ")}, Opts);
4096 EXPECT_THAT(Results.Completions,
4097 UnorderedElementsAre(AllOf(qualifier(
""), named(
"XYZ"))));
4100TEST(CompletionTest, NestedScopeIsUnresolved) {
4101 clangd::CodeCompleteOptions Opts = {};
4102 Opts.AllScopes =
true;
4104 auto Results = completions(R
"cpp(
4107 void f() { b::c::X^ }
4110 {cls("a::b::c::XYZ")}, Opts);
4111 EXPECT_THAT(Results.Completions,
4112 UnorderedElementsAre(AllOf(qualifier(
""), named(
"XYZ"))));
4117TEST(CompletionTest, NamespaceDoubleInsertion) {
4118 clangd::CodeCompleteOptions Opts = {};
4120 auto Results = completions(R
"cpp(
4127 {cls("foo::ns::ABCDE")}, Opts);
4128 EXPECT_THAT(Results.Completions,
4129 UnorderedElementsAre(AllOf(qualifier(
""), named(
"ABCDE"))));
4132TEST(CompletionTest, DerivedMethodsAreAlwaysVisible) {
4135 auto Completions = completions(R
"cpp(
4138 double size() const;
4140 struct deque : deque_base {
4147 EXPECT_THAT(Completions,
4148 ElementsAre(AllOf(returnType("int"), named(
"size"))));
4151TEST(CompletionTest, NoCrashWithIncompleteLambda) {
4152 auto Completions = completions(
"auto&& x = []{^").Completions;
4156 EXPECT_THAT(Completions, Contains(named(
"x")));
4158 auto Signatures = signatures(
"auto x() { x(^").signatures;
4159 EXPECT_THAT(Signatures, Contains(sig(
"x() -> auto")));
4162TEST(CompletionTest, DelayedTemplateParsing) {
4165 template <typename T> int foo() { return xx^; }
4170 TU.ExtraArgs.push_back(
"-fdelayed-template-parsing");
4172 EXPECT_THAT(completions(TU, Test.point()).Completions,
4173 Contains(named(
"xxx")));
4176TEST(CompletionTest, CompletionRange) {
4177 const char *WithRange =
"auto x = [[abc]]^";
4178 auto Completions = completions(WithRange);
4179 EXPECT_EQ(Completions.InsertRange,
Annotations(WithRange).range());
4180 Completions = completionsNoCompile(WithRange);
4181 EXPECT_EQ(Completions.InsertRange,
Annotations(WithRange).range());
4183 const char *EmptyRange =
"auto x = [[]]^";
4184 Completions = completions(EmptyRange);
4185 EXPECT_EQ(Completions.InsertRange,
Annotations(EmptyRange).range());
4186 Completions = completionsNoCompile(EmptyRange);
4187 EXPECT_EQ(Completions.InsertRange,
Annotations(EmptyRange).range());
4191 const char *NoCompletion =
"/* foo [[]]^ */";
4192 Completions = completions(NoCompletion);
4193 EXPECT_EQ(Completions.InsertRange, std::nullopt);
4194 Completions = completionsNoCompile(NoCompletion);
4195 EXPECT_EQ(Completions.InsertRange,
Annotations(NoCompletion).range());
4198TEST(CompletionTest, ReplaceRange) {
4199 clangd::CodeCompleteOptions Opts;
4200 Opts.EnableInsertReplace =
true;
4203 const char *EndOfToken =
4204 "struct S { int abc; }; void f() { S s; s.[[abc]]^; }";
4205 CodeCompleteResult Completions =
4206 completions(EndOfToken, {}, Opts);
4208 EXPECT_EQ(Completions.InsertRange,
A.range());
4209 EXPECT_EQ(Completions.ReplaceRange,
A.range());
4212 const char *MidWord =
"struct S { int abcd; }; void f() { S s; "
4213 "s.$replace[[$insert[[ab^]]cd]]; }";
4214 Completions = completions(MidWord, {}, Opts);
4216 EXPECT_EQ(Completions.InsertRange,
A.range(
"insert"));
4217 EXPECT_EQ(Completions.ReplaceRange,
A.range(
"replace"));
4220 const char *EmptyPrefix =
"struct S { int abcd; }; void f() { S s; "
4221 "s.$replace[[$insert[[^]]abcd]]; }";
4222 Completions = completions(EmptyPrefix, {}, Opts);
4224 EXPECT_EQ(Completions.InsertRange,
A.range(
"insert"));
4225 EXPECT_EQ(Completions.ReplaceRange,
A.range(
"replace"));
4228 const char *MidWordUTF8 =
"struct S { int naïve; }; void f() { S s; "
4229 "s.$replace[[$insert[[na^]]ïve]]; }";
4230 Completions = completions(MidWordUTF8, {}, Opts);
4232 EXPECT_EQ(Completions.InsertRange,
A.range(
"insert"));
4233 EXPECT_EQ(Completions.ReplaceRange,
A.range(
"replace"));
4236 const char *BeforeParen =
"struct S { int abcd(); }; void f() { S s; "
4237 "s.$replace[[$insert[[ab^]]cd]](123); }";
4238 Completions = completions(BeforeParen, {}, Opts);
4240 EXPECT_EQ(Completions.InsertRange,
A.range(
"insert"));
4241 EXPECT_EQ(Completions.ReplaceRange,
A.range(
"replace"));
4244 const char *BeforeAngle =
4245 "struct S { template <typename T> int abcd(); }; void f() { S s; "
4246 "s.$replace[[$insert[[ab^]]cd]]<int>(); }";
4247 Completions = completions(BeforeAngle, {}, Opts);
4249 EXPECT_EQ(Completions.InsertRange,
A.range(
"insert"));
4250 EXPECT_EQ(Completions.ReplaceRange,
A.range(
"replace"));
4253 const char *BeforeEquals =
4254 "void f() { int $replace[[$insert[[ab^]]cd]] = 1; }";
4255 Completions = completions(BeforeEquals, {}, Opts);
4257 EXPECT_EQ(Completions.InsertRange,
A.range(
"insert"));
4258 EXPECT_EQ(Completions.ReplaceRange,
A.range(
"replace"));
4261 Opts.EnableInsertReplace =
false;
4262 const char *NoReplace =
"auto x = [[abc]]^";
4263 Completions = completions(NoReplace, {}, Opts);
4264 EXPECT_EQ(Completions.InsertRange,
Annotations(NoReplace).range());
4265 EXPECT_EQ(Completions.ReplaceRange, std::nullopt);
4268TEST(CompletionTest, ReplaceRangeNoCompile) {
4269 clangd::CodeCompleteOptions Opts;
4270 Opts.EnableInsertReplace =
true;
4273 const char *EndOfToken =
"auto x = [[abc]]^";
4275 CodeCompleteResult Results =
4276 completionsNoCompile(EndOfToken, {}, Opts);
4277 EXPECT_EQ(Results.InsertRange,
A.range());
4278 EXPECT_EQ(Results.ReplaceRange,
A.range());
4281 const char *MidWord =
"auto x = $replace[[$insert[[ab^]]cd]]";
4282 Results = completionsNoCompile(MidWord, {}, Opts);
4284 EXPECT_EQ(Results.InsertRange,
A.range(
"insert"));
4285 EXPECT_EQ(Results.ReplaceRange,
A.range(
"replace"));
4288 const char *EmptyPrefix =
"auto x = $replace[[$insert[[^]]abcd]]";
4289 Results = completionsNoCompile(EmptyPrefix, {}, Opts);
4291 EXPECT_EQ(Results.InsertRange,
A.range(
"insert"));
4292 EXPECT_EQ(Results.ReplaceRange,
A.range(
"replace"));
4295 const char *MidWordUTF8 =
"auto x = $replace[[$insert[[na^]]]]ïve";
4296 Results = completionsNoCompile(MidWordUTF8, {}, Opts);
4298 EXPECT_EQ(Results.InsertRange,
A.range(
"insert"));
4299 EXPECT_EQ(Results.ReplaceRange,
A.range(
"replace"));
4302 const char *BeforeParen =
"auto x = $replace[[$insert[[ab^]]cd]](123);";
4303 Results = completionsNoCompile(BeforeParen, {}, Opts);
4305 EXPECT_EQ(Results.InsertRange,
A.range(
"insert"));
4306 EXPECT_EQ(Results.ReplaceRange,
A.range(
"replace"));
4309 const char *BeforeAngle =
"auto x = $replace[[$insert[[ab^]]cd]]<int>();";
4310 Results = completionsNoCompile(BeforeAngle, {}, Opts);
4312 EXPECT_EQ(Results.InsertRange,
A.range(
"insert"));
4313 EXPECT_EQ(Results.ReplaceRange,
A.range(
"replace"));
4316 const char *BeforeEquals =
"auto $replace[[$insert[[ab^]]cd]] = 1;";
4317 Results = completionsNoCompile(BeforeEquals, {}, Opts);
4319 EXPECT_EQ(Results.InsertRange,
A.range(
"insert"));
4320 EXPECT_EQ(Results.ReplaceRange,
A.range(
"replace"));
4323 Opts.EnableInsertReplace =
false;
4324 const char *NoReplace =
"auto x = [[abc]]^";
4325 Results = completionsNoCompile(NoReplace, {}, Opts);
4326 EXPECT_EQ(Results.InsertRange,
Annotations(NoReplace).range());
4327 EXPECT_EQ(Results.ReplaceRange, std::nullopt);
4330TEST(NoCompileCompletionTest, Basic) {
4331 auto Results = completionsNoCompile(R
"cpp(
4338 EXPECT_FALSE(Results.RanParser);
4339 EXPECT_THAT(Results.Completions,
4340 UnorderedElementsAre(named("void"), named(
"func"), named(
"int"),
4341 named(
"xyz"), named(
"abc")));
4344TEST(NoCompileCompletionTest, WithFilter) {
4345 auto Results = completionsNoCompile(R
"cpp(
4354 EXPECT_THAT(Results.Completions,
4355 UnorderedElementsAre(named("sym1"), named(
"sym2")));
4358TEST(NoCompileCompletionTest, WithIndex) {
4359 std::vector<Symbol> Syms = {
func(
"xxx"),
func(
"a::xxx"),
func(
"ns::b::xxx"),
4360 func(
"c::xxx"),
func(
"ns::d::xxx")};
4361 auto Results = completionsNoCompile(
4363 // Current-scopes, unqualified completion.
4373 EXPECT_THAT(Results.Completions,
4374 UnorderedElementsAre(AllOf(qualifier(""), scope(
"")),
4375 AllOf(qualifier(
""), scope(
"a::")),
4376 AllOf(qualifier(
""), scope(
"ns::b::"))));
4378 Opts.AllScopes =
true;
4379 Results = completionsNoCompile(
4381 // All-scopes unqualified completion.
4391 EXPECT_THAT(Results.Completions,
4392 UnorderedElementsAre(AllOf(qualifier(""), scope(
"")),
4393 AllOf(qualifier(
""), scope(
"a::")),
4394 AllOf(qualifier(
""), scope(
"ns::b::")),
4395 AllOf(qualifier(
"c::"), scope(
"c::")),
4396 AllOf(qualifier(
"d::"), scope(
"ns::d::"))));
4397 Results = completionsNoCompile(
4399 // Qualified completion.
4409 EXPECT_THAT(Results.Completions,
4410 ElementsAre(AllOf(qualifier(""), scope(
"ns::b::"))));
4411 Results = completionsNoCompile(
4413 // Absolutely qualified completion.
4423 EXPECT_THAT(Results.Completions,
4424 ElementsAre(AllOf(qualifier(""), scope(
"a::"))));
4427TEST(AllowImplicitCompletion,
All) {
4428 const char *
Yes[] = {
4432 " # include <^foo.h>",
4433 "#import <foo/^bar.h>",
4434 "#include_next \"^",
4436 const char *
No[] = {
4440 "#include <foo.h> //^",
4441 "#include \"foo.h\"^",
4445 for (
const char *Test :
Yes) {
4446 llvm::Annotations
A(Test);
4449 for (
const char *Test :
No) {
4450 llvm::Annotations
A(Test);
4455TEST(CompletionTest, FunctionArgsExist) {
4456 clangd::CodeCompleteOptions Opts;
4457 Opts.EnableSnippets =
true;
4465 template <typename T>
4467 Container(int Size) {}
4470 EXPECT_THAT(completions(Context + "int y = fo^", {}, Opts).Completions,
4471 UnorderedElementsAre(
4472 AllOf(labeled(
"foo(int A)"), snippetSuffix(
"(${1:int A})"))));
4474 completions(
Context +
"int y = fo^(42)", {}, Opts).Completions,
4475 UnorderedElementsAre(AllOf(labeled(
"foo(int A)"), snippetSuffix(
""))));
4477 completions(
Context +
"int y = fo^o(42)", {}, Opts).Completions,
4478 UnorderedElementsAre(AllOf(labeled(
"foo(int A)"), snippetSuffix(
""))));
4480 completions(
Context +
"int y = ba^", {}, Opts).Completions,
4481 UnorderedElementsAre(AllOf(labeled(
"bar()"), snippetSuffix(
"()"))));
4482 EXPECT_THAT(completions(
Context +
"int y = ba^()", {}, Opts).Completions,
4483 UnorderedElementsAre(AllOf(labeled(
"bar()"), snippetSuffix(
""))));
4484 EXPECT_THAT(completions(
Context +
"int y = ba^r()", {}, Opts).Completions,
4485 UnorderedElementsAre(AllOf(labeled(
"bar()"), snippetSuffix(
""))));
4487 completions(
Context +
"Object o = Obj^", {}, Opts).Completions,
4488 Contains(AllOf(labeled(
"Object(int B)"), snippetSuffix(
"(${1:int B})"),
4490 EXPECT_THAT(completions(
Context +
"Object o = Obj^()", {}, Opts).Completions,
4491 Contains(AllOf(labeled(
"Object(int B)"), snippetSuffix(
""),
4494 completions(
Context +
"Container c = Cont^", {}, Opts).Completions,
4495 Contains(AllOf(labeled(
"Container<typename T>(int Size)"),
4496 snippetSuffix(
"<${1:typename T}>(${2:int Size})"),
4499 completions(
Context +
"Container c = Cont^()", {}, Opts).Completions,
4500 Contains(AllOf(labeled(
"Container<typename T>(int Size)"),
4501 snippetSuffix(
"<${1:typename T}>"),
4504 completions(
Context +
"Container c = Cont^<int>()", {}, Opts).Completions,
4505 Contains(AllOf(labeled(
"Container<typename T>(int Size)"),
4509 completions(
Context +
"Container c = Cont^ainer()", {}, Opts).Completions,
4510 Contains(AllOf(labeled(
"Container<typename T>(int Size)"),
4511 snippetSuffix(
"<${1:typename T}>"),
4513 EXPECT_THAT(completions(
Context +
"MAC^(2)", {}, Opts).Completions,
4514 Contains(AllOf(labeled(
"MACRO(x)"), snippetSuffix(
""),
4516 EXPECT_THAT(completions(
Context +
"MAC^RO(2)", {}, Opts).Completions,
4517 Contains(AllOf(labeled(
"MACRO(x)"), snippetSuffix(
""),
4521TEST(CompletionTest, FunctionArgsExist_Issue1785) {
4525 clangd::CodeCompleteOptions Opts;
4526 Opts.EnableSnippets =
true;
4528 std::string Code = R
"cpp(
4540 completions(Code, {}, Opts).Completions,
4541 Contains(AllOf(labeled("waldo(int)"), snippetSuffix(
"(${1:int})"))));
4544TEST(CompletionTest, NoCrashDueToMacroOrdering) {
4545 EXPECT_THAT(completions(R
"cpp(
4547 #define ECHO2(X) ECHO(X)
4548 int finish_preamble = EC^HO(2);)cpp")
4550 UnorderedElementsAre(labeled("ECHO(X)"), labeled(
"ECHO2(X)")));
4553TEST(CompletionTest, ObjCCategoryDecls) {
4555 TU.
ExtraArgs.push_back(
"-xobjective-c");
4556 TU.HeaderCode = R
"objc(
4560 @interface Foo (FooExt1)
4563 @interface Foo (FooExt2)
4569 @interface Bar (BarExt)
4574 @implementation Foo (^)
4577 TU.Code = Test.code().str();
4578 auto Results = completions(TU, Test.point());
4579 EXPECT_THAT(Results.Completions,
4580 UnorderedElementsAre(labeled(
"FooExt1"), labeled(
"FooExt2")));
4587 TU.Code = Test.code().str();
4588 auto Results = completions(TU, Test.point());
4589 EXPECT_THAT(Results.Completions, UnorderedElementsAre(labeled(
"BarExt")));
4593TEST(CompletionTest, PreambleCodeComplete) {
4594 llvm::StringLiteral Baseline =
"\n#define MACRO 12\nint num = MACRO;";
4595 llvm::StringLiteral ModifiedCC =
4596 "#include \"header.h\"\n#define MACRO 12\nint num = MACRO; int num2 = M^";
4603 auto Inputs = ModifiedTU.inputs(FS);
4605 BaselineTU.preamble().get(), Inputs, {});
4606 EXPECT_THAT(Result.Completions, Not(testing::IsEmpty()));
4609TEST(CompletionTest, CommentParamName) {
4610 const std::string Code = R
"cpp(
4611 void fun(int foo, int bar);
4612 void overloaded(int param_int);
4613 void overloaded(int param_int, int param_other);
4614 void overloaded(char param_char);
4618 EXPECT_THAT(completions(Code + "fun(/*^").Completions,
4619 UnorderedElementsAre(labeled(
"foo=*/")));
4620 EXPECT_THAT(completions(Code +
"fun(1, /*^").Completions,
4621 UnorderedElementsAre(labeled(
"bar=*/")));
4622 EXPECT_THAT(completions(Code +
"/*^").Completions, IsEmpty());
4625 completions(Code +
"overloaded(/*^").Completions,
4626 UnorderedElementsAre(labeled(
"param_int=*/"), labeled(
"param_char=*/")));
4628 EXPECT_THAT(completions(Code +
"fun(/* ^").Completions,
4629 UnorderedElementsAre(labeled(
"foo=*/")));
4630 EXPECT_THAT(completions(Code +
"fun(/* f^").Completions,
4631 UnorderedElementsAre(labeled(
"foo=*/")));
4632 EXPECT_THAT(completions(Code +
"fun(/* x^").Completions, IsEmpty());
4633 EXPECT_THAT(completions(Code +
"fun(/* f ^").Completions, IsEmpty());
4637 std::string CompletionRangeTest(Code +
"fun(/*[[^]]");
4638 auto Results = completions(CompletionRangeTest);
4639 EXPECT_THAT(Results.InsertRange,
4640 llvm::ValueIs(
Annotations(CompletionRangeTest).range()));
4642 Results.Completions,
4644 AllOf(replacesRange(
Annotations(CompletionRangeTest).range()),
4648 std::string CompletionRangeTest(Code +
"fun(/*[[fo^]]");
4649 auto Results = completions(CompletionRangeTest);
4650 EXPECT_THAT(Results.InsertRange,
4651 llvm::ValueIs(
Annotations(CompletionRangeTest).range()));
4653 Results.Completions,
4655 AllOf(replacesRange(
Annotations(CompletionRangeTest).range()),
4660 clangd::CodeCompleteOptions ReplaceOpts;
4661 ReplaceOpts.EnableInsertReplace =
true;
4664 const std::string NoEquals(Code +
"fun(/*$replace[[$insert[[fo^]]o*/]])");
4665 const CodeCompleteResult Results = completions(NoEquals, {}, ReplaceOpts);
4667 EXPECT_EQ(Results.InsertRange,
A.range(
"insert"));
4668 EXPECT_EQ(Results.ReplaceRange,
A.range(
"replace"));
4672 const std::string WithEquals(Code +
4673 "fun(/*$replace[[$insert[[fo^]]o=*/]])");
4674 const CodeCompleteResult Results = completions(WithEquals, {}, ReplaceOpts);
4676 EXPECT_EQ(Results.InsertRange,
A.range(
"insert"));
4677 EXPECT_EQ(Results.ReplaceRange,
A.range(
"replace"));
4681 const std::string NoClose(Code +
"fun(/*[[fo^]]");
4682 const CodeCompleteResult Results = completions(NoClose, {}, ReplaceOpts);
4684 EXPECT_EQ(Results.InsertRange,
A.range());
4685 EXPECT_EQ(Results.ReplaceRange,
A.range());
4689 const std::string WithUTF8(Code +
"fun(/*$replace[[$insert[[ca^]]fé=*/]])");
4690 const CodeCompleteResult Results = completions(WithUTF8, {}, ReplaceOpts);
4692 EXPECT_EQ(Results.InsertRange,
A.range(
"insert"));
4693 EXPECT_EQ(Results.ReplaceRange,
A.range(
"replace"));
4697TEST(CompletionTest, Concepts) {
4700 concept A = sizeof(T) <= 8;
4702 template<$tparam^A U>
4705 template<typename T>
4706 int bar(T t) requires $expr^A<int>;
4709 concept b = $expr^A && $expr^sizeof(T) % 2 == 0 || $expr^A && sizeof(T) == 1;
4711 $toplevel^A auto i = 19;
4713 template<$toplevel^A auto i> void constrainedNTTP();
4715 // FIXME: The first parameter should be dropped in this case.
4716 void abbreviated($expr^A auto x) {}
4719 TU.Code = Code.code().str();
4720 TU.ExtraArgs = {"-std=c++20"};
4723 Sym.Signature =
"<typename Tp, typename Up>";
4724 Sym.CompletionSnippetSuffix =
"<${1:typename Tp}, ${2:typename Up}>";
4725 std::vector<Symbol> Syms = {Sym};
4726 for (
auto P : Code.points(
"tparam")) {
4728 completions(TU, P, Syms).Completions,
4729 AllOf(Contains(AllOf(named(
"A"), signature(
""), snippetSuffix(
""))),
4730 Contains(AllOf(named(
"same_as"), signature(
"<typename Up>"),
4731 snippetSuffix(
"<${2:typename Up}>"))),
4732 Contains(named(
"class")), Contains(named(
"typename"))))
4733 <<
"Completing template parameter at position " <<
P;
4736 for (
auto P : Code.points(
"toplevel")) {
4738 completions(TU, P, Syms).Completions,
4739 AllOf(Contains(AllOf(named(
"A"), signature(
""), snippetSuffix(
""))),
4740 Contains(AllOf(named(
"same_as"), signature(
"<typename Up>"),
4741 snippetSuffix(
"<${2:typename Up}>")))))
4742 <<
"Completing 'requires' expression at position " <<
P;
4745 for (
auto P : Code.points(
"expr")) {
4747 completions(TU, P, Syms).Completions,
4748 AllOf(Contains(AllOf(named(
"A"), signature(
"<class T>"),
4749 snippetSuffix(
"<${1:class T}>"))),
4751 named(
"same_as"), signature(
"<typename Tp, typename Up>"),
4752 snippetSuffix(
"<${1:typename Tp}, ${2:typename Up}>")))))
4753 <<
"Completing 'requires' expression at position " <<
P;
4759 // Comment `with` markup.
4761 void bar() { foo(^); }
4763 for (
auto DocumentationFormat :
4765 auto Sigs = signatures(Code.code(), Code.point(), {},
4766 DocumentationFormat);
4767 ASSERT_EQ(Sigs.signatures.size(), 1U);
4768 EXPECT_EQ(Sigs.signatures[0].documentation.kind, DocumentationFormat);
4773 std::string Top = R
"cpp(
4774 template <typename T, int> bool foo(char);
4775 template <int I, int> bool foo(float);
4778 auto First = signatures(Top +
"bool x = foo<^");
4781 UnorderedElementsAre(sig(
"foo<[[typename T]], [[int]]>() -> bool"),
4782 sig(
"foo<[[int I]], [[int]]>() -> bool")));
4783 EXPECT_EQ(First.activeParameter, 0);
4785 auto Second = signatures(Top +
"bool x = foo<1, ^");
4786 EXPECT_THAT(Second.signatures,
4787 ElementsAre(sig(
"foo<[[int I]], [[int]]>() -> bool")));
4788 EXPECT_EQ(Second.activeParameter, 1);
4791TEST(CompletionTest, DoNotCrash) {
4792 llvm::StringLiteral Cases[] = {
4794 template <typename = int> struct Foo {};
4795 auto a = [x(3)](Foo<^>){};
4798 for (
auto Case : Cases) {
4800 auto Completions = completions(Case);
4803TEST(CompletionTest, PreambleFromDifferentTarget) {
4804 constexpr std::string_view PreambleTarget =
"x86_64";
4805 constexpr std::string_view Contents =
4806 "int foo(int); int num; int num2 = foo(n^";
4810 TU.ExtraArgs.emplace_back(
"-target");
4811 TU.ExtraArgs.emplace_back(PreambleTarget);
4815 TU.ExtraArgs.pop_back();
4816 TU.ExtraArgs.emplace_back(
"wasm32");
4819 auto Inputs = TU.inputs(FS);
4826 EXPECT_THAT(Result.Completions, Not(testing::IsEmpty()));
4827 EXPECT_THAT(Signatures.signatures, Not(testing::IsEmpty()));
4830TEST(CompletionTest, SkipExplicitObjectParameter) {
4833 void foo(this auto&& self, int arg);
4834 void bar(this A self, int arg);
4853 TU.ExtraArgs = {
"-std=c++23"};
4861 auto Inputs = TU.inputs(FS);
4866 EXPECT_THAT(Result.Completions,
4867 UnorderedElementsAre(AllOf(named(
"foo"), signature(
"(int arg)"),
4868 snippetSuffix(
"(${1:int arg})")),
4869 AllOf(named(
"bar"), signature(
"(int arg)"),
4870 snippetSuffix(
"(${1:int arg})"))));
4877 ElementsAre(AllOf(named(
"foo"), signature(
"<class self:auto>(int arg)"),
4878 snippetSuffix(
"<${1:class self:auto}>"))));
4883 EXPECT_THAT(Result.Completions,
4884 ElementsAre(AllOf(named(
"bar"), signature(
"(int arg)"),
4885 snippetSuffix(
""))));
4889TEST(CompletionTest, MemberAccessInExplicitObjMemfn) {
4893 int memberFnA(int a);
4894 int memberFnA(this A&, float a);
4896 void foo(this A& self) {
4897 // Should not offer any members here, since
4898 // it needs to be referenced through `self`.
4900 // should offer all results
4904 // should not offer any results
4912 TU.ExtraArgs = {
"-std=c++23"};
4920 auto Inputs = TU.inputs(FS);
4926 EXPECT_THAT(Result.Completions, ElementsAre());
4934 UnorderedElementsAre(named(
"member"),
4935 AllOf(named(
"memberFnA"), signature(
"(int a)"),
4936 snippetSuffix(
"(${1:int a})")),
4937 AllOf(named(
"memberFnA"), signature(
"(float a)"),
4938 snippetSuffix(
"(${1:float a})"))));
4944 EXPECT_THAT(Result.Completions, ElementsAre());
4948TEST(CompletionTest, ListExplicitObjectOverloads) {
4952 void foo2(int a) const;
4953 void foo2(this const S& self, float a);
4954 void foo3(this const S& self, int a);
4955 void foo4(this S& self, int a);
4958 void S::foo1(int a) {
4962 void S::foo2(int a) const {
4966 void S::foo3(this const S& self, int a) {
4970 void S::foo4(this S& self, int a) {
4978 void test2(const S s) {
4984 TU.ExtraArgs = {
"-std=c++23"};
4992 auto Inputs = TU.inputs(FS);
4999 UnorderedElementsAre(AllOf(named(
"foo1"), signature(
"(int a)"),
5000 snippetSuffix(
"(${1:int a})")),
5001 AllOf(named(
"foo2"), signature(
"(int a) const"),
5002 snippetSuffix(
"(${1:int a})")),
5003 AllOf(named(
"foo2"), signature(
"(float a) const"),
5004 snippetSuffix(
"(${1:float a})")),
5005 AllOf(named(
"foo3"), signature(
"(int a) const"),
5006 snippetSuffix(
"(${1:int a})")),
5007 AllOf(named(
"foo4"), signature(
"(int a)"),
5008 snippetSuffix(
"(${1:int a})"))));
5015 UnorderedElementsAre(AllOf(named(
"foo2"), signature(
"(int a) const"),
5016 snippetSuffix(
"(${1:int a})")),
5017 AllOf(named(
"foo2"), signature(
"(float a) const"),
5018 snippetSuffix(
"(${1:float a})")),
5019 AllOf(named(
"foo3"), signature(
"(int a) const"),
5020 snippetSuffix(
"(${1:int a})"))));
5027 UnorderedElementsAre(AllOf(named(
"foo2"), signature(
"(int a) const"),
5028 snippetSuffix(
"(${1:int a})")),
5029 AllOf(named(
"foo2"), signature(
"(float a) const"),
5030 snippetSuffix(
"(${1:float a})")),
5031 AllOf(named(
"foo3"), signature(
"(int a) const"),
5032 snippetSuffix(
"(${1:int a})"))));
5039 UnorderedElementsAre(AllOf(named(
"foo1"), signature(
"(int a)"),
5040 snippetSuffix(
"(${1:int a})")),
5041 AllOf(named(
"foo2"), signature(
"(int a) const"),
5042 snippetSuffix(
"(${1:int a})")),
5043 AllOf(named(
"foo2"), signature(
"(float a) const"),
5044 snippetSuffix(
"(${1:float a})")),
5045 AllOf(named(
"foo3"), signature(
"(int a) const"),
5046 snippetSuffix(
"(${1:int a})")),
5047 AllOf(named(
"foo4"), signature(
"(int a)"),
5048 snippetSuffix(
"(${1:int a})"))));
5055 UnorderedElementsAre(AllOf(named(
"foo1"), signature(
"(int a)"),
5056 snippetSuffix(
"(${1:int a})")),
5057 AllOf(named(
"foo2"), signature(
"(int a) const"),
5058 snippetSuffix(
"(${1:int a})")),
5059 AllOf(named(
"foo2"), signature(
"(float a) const"),
5060 snippetSuffix(
"(${1:float a})")),
5061 AllOf(named(
"foo3"), signature(
"(int a) const"),
5062 snippetSuffix(
"(${1:int a})")),
5063 AllOf(named(
"foo4"), signature(
"(int a)"),
5064 snippetSuffix(
"(${1:int a})"))));
5071 UnorderedElementsAre(AllOf(named(
"foo2"), signature(
"(int a) const"),
5072 snippetSuffix(
"(${1:int a})")),
5073 AllOf(named(
"foo2"), signature(
"(float a) const"),
5074 snippetSuffix(
"(${1:float a})")),
5075 AllOf(named(
"foo3"), signature(
"(int a) const"),
5076 snippetSuffix(
"(${1:int a})"))));
5080TEST(CompletionTest, FuzzyMatchMacro) {
5083 #define _gl_foo() 42
5103 auto Results = completions(TU, Code.point(
"c1"), {}, Opts);
5105 Results.Completions,
5106 ElementsAre(named(
"gl_frob"), named(
"_gl_frob"), named(
"glfbar")));
5110 auto Results = completions(TU, Code.point(
"c2"), {}, Opts);
5111 EXPECT_THAT(Results.Completions,
5112 ElementsAre(named(
"_gl_frob"), named(
"_gl_foo")));
5123 auto Results = completions(TU, Code.point(
"c1"), {}, Opts);
5124 EXPECT_THAT(Results.Completions,
5125 ElementsAre(named(
"gl_frob"), named(
"_gl_frob"),
5126 named(
"glfbar"), named(
"gl_foo")));
5131 auto Results = completions(TU, Code.point(
"c2"), {}, Opts);
5132 EXPECT_THAT(Results.Completions,
5133 ElementsAre(named(
"_gl_frob"), named(
"_gl_foo")));
#define EXPECT_IFF(condition, value, matcher)
Same as llvm::Annotations, but adjusts functions to LSP-specific types for positions and ranges.
clangd::Range range(llvm::StringRef Name="") const
Manages a collection of source files and derived data (ASTs, indexes), and provides language-aware fe...
static Options optsForTest()
A context is an immutable container for per-request data that must be propagated through layers that ...
static std::unique_ptr< SymbolIndex > build(SymbolSlab Symbols, RefSlab Refs, RelationSlab Relations)
Builds an index from slabs. The index takes ownership of the data.
llvm::StringMap< std::string > Files
An efficient structure of storing large set of symbol references in memory.
Interface for symbol indexes that can be used for searching or matching symbols among a set of symbol...
SymbolSlab::Builder is a mutable container that can 'freeze' to SymbolSlab.
void insert(const Symbol &S)
Adds a symbol, overwriting any existing one with the same ID.
static llvm::Expected< URI > create(llvm::StringRef AbsolutePath, llvm::StringRef Scheme)
Creates a URI for a file in the given scheme.
WithContextValue extends Context::current() with a single value.
FIXME: Skip testing on windows temporarily due to the different escaping code mode.
Symbol objcProtocol(llvm::StringRef Name)
Symbol objcClass(llvm::StringRef Name)
Symbol func(llvm::StringRef Name)
Symbol cls(llvm::StringRef Name)
Symbol objcCategory(llvm::StringRef Name, llvm::StringRef CategoryName)
std::string sortText(float Score, llvm::StringRef Name)
Returns a string that sorts in the same order as (-Score, Tiebreak), for LSP.
Symbol conceptSym(llvm::StringRef Name)
IndexContents
Describes what data is covered by an index.
size_t lspLength(llvm::StringRef Code)
CompletionPrefix guessCompletionPrefix(llvm::StringRef Content, unsigned Offset)
std::unique_ptr< CompilerInvocation > buildCompilerInvocation(const ParseInputs &Inputs, clang::DiagnosticConsumer &D, std::vector< std::string > *CC1Args)
Builds compiler invocation that could be used to build AST or preamble.
Symbol sym(llvm::StringRef QName, index::SymbolKind Kind, llvm::StringRef USRFormat, llvm::StringRef Signature)
CompletionItemKind
The kind of a completion entry.
Symbol ns(llvm::StringRef Name)
bool allowImplicitCompletion(llvm::StringRef Content, unsigned Offset)
llvm::unique_function< void(llvm::Expected< T >)> Callback
A Callback<T> is a void function that accepts Expected<T>.
llvm::raw_ostream & operator<<(llvm::raw_ostream &OS, const CodeCompletion &C)
llvm::Expected< CodeCompleteResult > runCodeComplete(ClangdServer &Server, PathRef File, Position Pos, clangd::CodeCompleteOptions Opts)
llvm::Expected< SignatureHelp > runSignatureHelp(ClangdServer &Server, PathRef File, Position Pos, MarkupKind DocumentationFormat)
std::string testPath(PathRef File, llvm::sys::path::Style Style)
std::shared_ptr< const PreambleData > buildPreamble(PathRef FileName, CompilerInvocation CI, const ParseInputs &Inputs, bool StoreInMemory, PreambleParsedCallback PreambleCallback, PreambleBuildStats *Stats)
Build a preamble for the new inputs unless an old one can be reused.
TEST(BackgroundQueueTest, Priority)
void wait(std::unique_lock< std::mutex > &Lock, std::condition_variable &CV, Deadline D)
Wait once on CV for the specified duration.
llvm::Expected< size_t > positionToOffset(llvm::StringRef Code, Position P, bool AllowColumnsBeyondLineLength)
Turn a [line, column] pair into an offset in Code.
void runAddDocument(ClangdServer &Server, PathRef File, llvm::StringRef Contents, llvm::StringRef Version, WantDiagnostics WantDiags, bool ForceRebuild)
Symbol macro(llvm::StringRef Name, llvm::StringRef ArgList)
llvm::StringRef PathRef
A typedef to represent a ref to file path.
@ No
Diagnostics must be generated for this snapshot.
std::vector< std::string > lookup(const SymbolIndex &I, llvm::ArrayRef< SymbolID > IDs)
Symbol enmConstant(llvm::StringRef Name)
Deadline timeoutSeconds(std::optional< double > Seconds)
Makes a deadline from a timeout in seconds. std::nullopt means wait forever.
CodeCompleteResult codeComplete(PathRef FileName, Position Pos, const PreambleData *Preamble, const ParseInputs &ParseInput, CodeCompleteOptions Opts, SpeculativeFuzzyFind *SpecFuzzyFind)
Gets code completions at a specified Pos in FileName.
@ PlainText
The primary text to be inserted is treated as a plain string.
@ Snippet
The primary text to be inserted is treated as a snippet.
SignatureHelp signatureHelp(PathRef FileName, Position Pos, const PreambleData &Preamble, const ParseInputs &ParseInput, MarkupKind DocumentationFormat)
Get signature help at a specified Pos in FileName.
PolySubsequenceMatcher< Args... > HasSubsequence(Args &&... M)
Symbol var(llvm::StringRef Name)
cppcoreguidelines::ProBoundsAvoidUncheckedContainerAccessCheck P
===– Representation.cpp - ClangDoc Representation --------—*- C++ -*-===//
Signals derived from a valid AST of a file.
llvm::DenseMap< SymbolID, unsigned > ReferencedSymbols
Number of occurrences of each symbol present in the file.
Symbol::IncludeDirective InsertionDirective
Preferred preprocessor directive to use for inclusions by the file.
Represents a collection of completion items to be presented in the editor.
Settings that express user/project preferences and control clangd behavior.
static clangd::Key< Config > Key
Context key which can be used to set the current Config.
@ None
nothing, no argument list and also NO Delimiters "()" or "<>".
@ Delimiters
empty pair of delimiters "()" or "<>".
@ OpenDelimiter
open, only opening delimiter "(" or "<".
Same semantics as CodeComplete::Score.
std::vector< std::string > Scopes
If this is non-empty, symbols must be in at least one of the scopes (e.g.
int line
Line position in a document (zero-based).
int character
Character offset on a line in a document (zero-based).
Position end
The range's end position.
Represents the signature of a callable.
Attributes of a symbol that affect how much we like it.
Attributes of a symbol-query pair that affect how much we like it.
The class presents a C++ symbol, e.g.
@ IndexedForCodeCompletion
Whether or not this symbol is meant to be used for the code completion.
@ Include
#include "header.h"
@ Import
#import "header.h"
SymbolID ID
The ID of the symbol.
std::vector< std::string > ExtraArgs
static TestTU withHeaderCode(llvm::StringRef HeaderCode)
static TestTU withCode(llvm::StringRef Code)
llvm::StringMap< std::string > AdditionalFiles
std::unique_ptr< SymbolIndex > index() const
Range range
The range of the text document to be manipulated.