blob: 7c166cc197b543f4aea1e6f684ca491f29a5f386 [file] [log] [blame]
Sam McCall9aad25f2017-12-05 07:20:26 +00001//===-- CodeCompleteTests.cpp -----------------------------------*- C++ -*-===//
2//
3// The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
Eric Liu6f648df2017-12-19 16:50:37 +00009
Sam McCall328cbdb2017-12-20 16:06:05 +000010#include "Annotations.h"
Sam McCall9aad25f2017-12-05 07:20:26 +000011#include "ClangdServer.h"
Sam McCall328cbdb2017-12-20 16:06:05 +000012#include "CodeComplete.h"
Sam McCall9aad25f2017-12-05 07:20:26 +000013#include "Compiler.h"
Ilya Biryukov940901e2017-12-13 12:51:22 +000014#include "Context.h"
Ilya Biryukov5a85b8e2017-12-13 12:53:16 +000015#include "Matchers.h"
Sam McCall9aad25f2017-12-05 07:20:26 +000016#include "Protocol.h"
Sam McCallb536a2a2017-12-19 12:23:48 +000017#include "SourceCode.h"
Sam McCall9aad25f2017-12-05 07:20:26 +000018#include "TestFS.h"
Eric Liu6f648df2017-12-19 16:50:37 +000019#include "index/MemIndex.h"
Sam McCallf6ae3232017-12-05 20:11:29 +000020#include "gmock/gmock.h"
Sam McCall9aad25f2017-12-05 07:20:26 +000021#include "gtest/gtest.h"
22
23namespace clang {
24namespace clangd {
Sam McCall800d4372017-12-19 10:29:27 +000025// Let GMock print completion items and signature help.
Sam McCallf6ae3232017-12-05 20:11:29 +000026void PrintTo(const CompletionItem &I, std::ostream *O) {
27 llvm::raw_os_ostream OS(*O);
Sam McCall44fdcec22017-12-08 15:00:59 +000028 OS << I.label << " - " << toJSON(I);
29}
30void PrintTo(const std::vector<CompletionItem> &V, std::ostream *O) {
31 *O << "{\n";
32 for (const auto &I : V) {
33 *O << "\t";
34 PrintTo(I, O);
35 *O << "\n";
36 }
37 *O << "}";
Sam McCallf6ae3232017-12-05 20:11:29 +000038}
Sam McCall800d4372017-12-19 10:29:27 +000039void PrintTo(const SignatureInformation &I, std::ostream *O) {
40 llvm::raw_os_ostream OS(*O);
41 OS << I.label << " - " << toJSON(I);
42}
43void PrintTo(const std::vector<SignatureInformation> &V, std::ostream *O) {
44 *O << "{\n";
45 for (const auto &I : V) {
46 *O << "\t";
47 PrintTo(I, O);
48 *O << "\n";
49 }
50 *O << "}";
51}
Sam McCallf6ae3232017-12-05 20:11:29 +000052
Sam McCall9aad25f2017-12-05 07:20:26 +000053namespace {
54using namespace llvm;
Sam McCallf6ae3232017-12-05 20:11:29 +000055using ::testing::AllOf;
56using ::testing::Contains;
Ilya Biryukov5a5e1ca2017-12-29 14:59:22 +000057using ::testing::Each;
Sam McCallf6ae3232017-12-05 20:11:29 +000058using ::testing::ElementsAre;
Sam McCallf6ae3232017-12-05 20:11:29 +000059using ::testing::Not;
Sam McCall3d139c52018-01-12 18:30:08 +000060using ::testing::UnorderedElementsAre;
Haojian Wu061c73e2018-01-23 11:37:26 +000061using ::testing::Field;
Sam McCall9aad25f2017-12-05 07:20:26 +000062
63class IgnoreDiagnostics : public DiagnosticsConsumer {
Ilya Biryukov95558392018-01-10 17:59:27 +000064 void
65 onDiagnosticsReady(const Context &Ctx, PathRef File,
66 Tagged<std::vector<DiagWithFixIts>> Diagnostics) override {
67 }
Sam McCall9aad25f2017-12-05 07:20:26 +000068};
69
Sam McCallf6ae3232017-12-05 20:11:29 +000070// GMock helpers for matching completion items.
71MATCHER_P(Named, Name, "") { return arg.insertText == Name; }
Sam McCall44fdcec22017-12-08 15:00:59 +000072MATCHER_P(Labeled, Label, "") { return arg.label == Label; }
73MATCHER_P(Kind, K, "") { return arg.kind == K; }
Eric Liu6f648df2017-12-19 16:50:37 +000074MATCHER_P(Filter, F, "") { return arg.filterText == F; }
Eric Liu76f6b442018-01-09 17:32:00 +000075MATCHER_P(Doc, D, "") { return arg.documentation == D; }
76MATCHER_P(Detail, D, "") { return arg.detail == D; }
Sam McCall44fdcec22017-12-08 15:00:59 +000077MATCHER_P(PlainText, Text, "") {
78 return arg.insertTextFormat == clangd::InsertTextFormat::PlainText &&
79 arg.insertText == Text;
80}
81MATCHER_P(Snippet, Text, "") {
82 return arg.insertTextFormat == clangd::InsertTextFormat::Snippet &&
83 arg.insertText == Text;
84}
Sam McCall545a20d2018-01-19 14:34:02 +000085MATCHER(NameContainsFilter, "") {
Ilya Biryukov5a5e1ca2017-12-29 14:59:22 +000086 if (arg.filterText.empty())
87 return true;
88 return llvm::StringRef(arg.insertText).contains(arg.filterText);
89}
Sam McCallf6ae3232017-12-05 20:11:29 +000090// Shorthand for Contains(Named(Name)).
91Matcher<const std::vector<CompletionItem> &> Has(std::string Name) {
92 return Contains(Named(std::move(Name)));
93}
Sam McCall44fdcec22017-12-08 15:00:59 +000094Matcher<const std::vector<CompletionItem> &> Has(std::string Name,
95 CompletionItemKind K) {
96 return Contains(AllOf(Named(std::move(Name)), Kind(K)));
Sam McCallf6ae3232017-12-05 20:11:29 +000097}
Sam McCall44fdcec22017-12-08 15:00:59 +000098MATCHER(IsDocumented, "") { return !arg.documentation.empty(); }
Sam McCall9aad25f2017-12-05 07:20:26 +000099
Sam McCalla15c2d62018-01-18 09:27:56 +0000100std::unique_ptr<SymbolIndex> memIndex(std::vector<Symbol> Symbols) {
101 SymbolSlab::Builder Slab;
102 for (const auto &Sym : Symbols)
103 Slab.insert(Sym);
104 return MemIndex::build(std::move(Slab).build());
105}
106
107// Builds a server and runs code completion.
108// If IndexSymbols is non-empty, an index will be built and passed to opts.
Sam McCallf6ae3232017-12-05 20:11:29 +0000109CompletionList completions(StringRef Text,
Sam McCalla15c2d62018-01-18 09:27:56 +0000110 std::vector<Symbol> IndexSymbols = {},
Sam McCallf6ae3232017-12-05 20:11:29 +0000111 clangd::CodeCompleteOptions Opts = {}) {
Sam McCalla15c2d62018-01-18 09:27:56 +0000112 std::unique_ptr<SymbolIndex> OverrideIndex;
113 if (!IndexSymbols.empty()) {
114 assert(!Opts.Index && "both Index and IndexSymbols given!");
115 OverrideIndex = memIndex(std::move(IndexSymbols));
116 Opts.Index = OverrideIndex.get();
117 }
118
Sam McCall9aad25f2017-12-05 07:20:26 +0000119 MockFSProvider FS;
Sam McCall93cd9912017-12-05 07:34:35 +0000120 MockCompilationDatabase CDB;
Sam McCallf6ae3232017-12-05 20:11:29 +0000121 IgnoreDiagnostics DiagConsumer;
Sam McCall9aad25f2017-12-05 07:20:26 +0000122 ClangdServer Server(CDB, DiagConsumer, FS, getDefaultAsyncThreadsCount(),
Ilya Biryukov940901e2017-12-13 12:51:22 +0000123 /*StorePreamblesInMemory=*/true);
Sam McCallf6ae3232017-12-05 20:11:29 +0000124 auto File = getVirtualTestFilePath("foo.cpp");
Sam McCall328cbdb2017-12-20 16:06:05 +0000125 Annotations Test(Text);
Sam McCall3d139c52018-01-12 18:30:08 +0000126 Server.addDocument(Context::empty(), File, Test.code()).wait();
Ilya Biryukov5a5e1ca2017-12-29 14:59:22 +0000127 auto CompletionList =
128 Server.codeComplete(Context::empty(), File, Test.point(), Opts)
129 .get()
130 .second.Value;
131 // Sanity-check that filterText is valid.
Sam McCall545a20d2018-01-19 14:34:02 +0000132 EXPECT_THAT(CompletionList.items, Each(NameContainsFilter()));
Ilya Biryukov5a5e1ca2017-12-29 14:59:22 +0000133 return CompletionList;
Sam McCall9aad25f2017-12-05 07:20:26 +0000134}
135
Sam McCall545a20d2018-01-19 14:34:02 +0000136std::string replace(StringRef Haystack, StringRef Needle, StringRef Repl) {
137 std::string Result;
138 raw_string_ostream OS(Result);
139 std::pair<StringRef, StringRef> Split;
140 for (Split = Haystack.split(Needle); !Split.second.empty();
141 Split = Split.first.split(Needle))
142 OS << Split.first << Repl;
143 Result += Split.first;
144 OS.flush();
145 return Result;
146}
147
Sam McCalla15c2d62018-01-18 09:27:56 +0000148// Helpers to produce fake index symbols for memIndex() or completions().
Sam McCall545a20d2018-01-19 14:34:02 +0000149// USRFormat is a regex replacement string for the unqualified part of the USR.
150Symbol sym(StringRef QName, index::SymbolKind Kind, StringRef USRFormat) {
Sam McCalla15c2d62018-01-18 09:27:56 +0000151 Symbol Sym;
Sam McCall545a20d2018-01-19 14:34:02 +0000152 std::string USR = "c:"; // We synthesize a few simple cases of USRs by hand!
Sam McCalla15c2d62018-01-18 09:27:56 +0000153 size_t Pos = QName.rfind("::");
154 if (Pos == llvm::StringRef::npos) {
155 Sym.Name = QName;
156 Sym.Scope = "";
157 } else {
158 Sym.Name = QName.substr(Pos + 2);
Sam McCall8b2faee2018-01-19 22:18:21 +0000159 Sym.Scope = QName.substr(0, Pos + 2);
160 USR += "@N@" + replace(QName.substr(0, Pos), "::", "@N@"); // ns:: -> @N@ns
Sam McCalla15c2d62018-01-18 09:27:56 +0000161 }
Sam McCall545a20d2018-01-19 14:34:02 +0000162 USR += Regex("^.*$").sub(USRFormat, Sym.Name); // e.g. func -> @F@func#
163 Sym.ID = SymbolID(USR);
Sam McCalla15c2d62018-01-18 09:27:56 +0000164 Sym.CompletionPlainInsertText = Sym.Name;
Sam McCall545a20d2018-01-19 14:34:02 +0000165 Sym.CompletionSnippetInsertText = Sym.Name;
Sam McCalla15c2d62018-01-18 09:27:56 +0000166 Sym.CompletionLabel = Sym.Name;
167 Sym.SymInfo.Kind = Kind;
168 return Sym;
169}
Sam McCall545a20d2018-01-19 14:34:02 +0000170Symbol func(StringRef Name) { // Assumes the function has no args.
171 return sym(Name, index::SymbolKind::Function, "@F@\\0#"); // no args
172}
173Symbol cls(StringRef Name) {
174 return sym(Name, index::SymbolKind::Class, "@S@\\0@S@\\0");
175}
176Symbol var(StringRef Name) {
177 return sym(Name, index::SymbolKind::Variable, "@\\0");
178}
Sam McCalla15c2d62018-01-18 09:27:56 +0000179
Sam McCallf6ae3232017-12-05 20:11:29 +0000180TEST(CompletionTest, Limit) {
181 clangd::CodeCompleteOptions Opts;
182 Opts.Limit = 2;
183 auto Results = completions(R"cpp(
Sam McCall9aad25f2017-12-05 07:20:26 +0000184struct ClassWithMembers {
185 int AAA();
186 int BBB();
187 int CCC();
188}
Sam McCallf6ae3232017-12-05 20:11:29 +0000189int main() { ClassWithMembers().^ }
Sam McCall9aad25f2017-12-05 07:20:26 +0000190 )cpp",
Sam McCalla15c2d62018-01-18 09:27:56 +0000191 /*IndexSymbols=*/{}, Opts);
Sam McCall9aad25f2017-12-05 07:20:26 +0000192
193 EXPECT_TRUE(Results.isIncomplete);
Sam McCallf6ae3232017-12-05 20:11:29 +0000194 EXPECT_THAT(Results.items, ElementsAre(Named("AAA"), Named("BBB")));
Sam McCall9aad25f2017-12-05 07:20:26 +0000195}
196
Sam McCallf6ae3232017-12-05 20:11:29 +0000197TEST(CompletionTest, Filter) {
198 std::string Body = R"cpp(
Sam McCall9aad25f2017-12-05 07:20:26 +0000199 int Abracadabra;
200 int Alakazam;
201 struct S {
202 int FooBar;
203 int FooBaz;
204 int Qux;
205 };
206 )cpp";
Sam McCallf6ae3232017-12-05 20:11:29 +0000207 EXPECT_THAT(completions(Body + "int main() { S().Foba^ }").items,
208 AllOf(Has("FooBar"), Has("FooBaz"), Not(Has("Qux"))));
Sam McCall9aad25f2017-12-05 07:20:26 +0000209
Sam McCallf6ae3232017-12-05 20:11:29 +0000210 EXPECT_THAT(completions(Body + "int main() { S().FR^ }").items,
211 AllOf(Has("FooBar"), Not(Has("FooBaz")), Not(Has("Qux"))));
Sam McCall9aad25f2017-12-05 07:20:26 +0000212
Sam McCallf6ae3232017-12-05 20:11:29 +0000213 EXPECT_THAT(completions(Body + "int main() { S().opr^ }").items,
214 Has("operator="));
Sam McCall9aad25f2017-12-05 07:20:26 +0000215
Sam McCallf6ae3232017-12-05 20:11:29 +0000216 EXPECT_THAT(completions(Body + "int main() { aaa^ }").items,
217 AllOf(Has("Abracadabra"), Has("Alakazam")));
Sam McCall9aad25f2017-12-05 07:20:26 +0000218
Sam McCallf6ae3232017-12-05 20:11:29 +0000219 EXPECT_THAT(completions(Body + "int main() { _a^ }").items,
220 AllOf(Has("static_cast"), Not(Has("Abracadabra"))));
Sam McCall9aad25f2017-12-05 07:20:26 +0000221}
222
Sam McCallf6ae3232017-12-05 20:11:29 +0000223void TestAfterDotCompletion(clangd::CodeCompleteOptions Opts) {
Sam McCall44fdcec22017-12-08 15:00:59 +0000224 auto Results = completions(
225 R"cpp(
226 #define MACRO X
Sam McCall9aad25f2017-12-05 07:20:26 +0000227
Sam McCall44fdcec22017-12-08 15:00:59 +0000228 int global_var;
Sam McCall9aad25f2017-12-05 07:20:26 +0000229
Sam McCall44fdcec22017-12-08 15:00:59 +0000230 int global_func();
Sam McCall9aad25f2017-12-05 07:20:26 +0000231
Sam McCall44fdcec22017-12-08 15:00:59 +0000232 struct GlobalClass {};
Sam McCall9aad25f2017-12-05 07:20:26 +0000233
Sam McCall44fdcec22017-12-08 15:00:59 +0000234 struct ClassWithMembers {
235 /// Doc for method.
236 int method();
Sam McCall9aad25f2017-12-05 07:20:26 +0000237
Sam McCall44fdcec22017-12-08 15:00:59 +0000238 int field;
239 private:
240 int private_field;
241 };
Sam McCall9aad25f2017-12-05 07:20:26 +0000242
Sam McCall44fdcec22017-12-08 15:00:59 +0000243 int test() {
244 struct LocalClass {};
Sam McCall9aad25f2017-12-05 07:20:26 +0000245
Sam McCall44fdcec22017-12-08 15:00:59 +0000246 /// Doc for local_var.
247 int local_var;
Sam McCall9aad25f2017-12-05 07:20:26 +0000248
Sam McCall44fdcec22017-12-08 15:00:59 +0000249 ClassWithMembers().^
250 }
251 )cpp",
Sam McCall545a20d2018-01-19 14:34:02 +0000252 {cls("IndexClass"), var("index_var"), func("index_func")}, Opts);
Sam McCall9aad25f2017-12-05 07:20:26 +0000253
Sam McCallf6ae3232017-12-05 20:11:29 +0000254 // Class members. The only items that must be present in after-dot
255 // completion.
Sam McCall44fdcec22017-12-08 15:00:59 +0000256 EXPECT_THAT(
257 Results.items,
258 AllOf(Has(Opts.EnableSnippets ? "method()" : "method"), Has("field")));
259 EXPECT_IFF(Opts.IncludeIneligibleResults, Results.items,
260 Has("private_field"));
Sam McCallf6ae3232017-12-05 20:11:29 +0000261 // Global items.
Sam McCall545a20d2018-01-19 14:34:02 +0000262 EXPECT_THAT(
263 Results.items,
264 Not(AnyOf(Has("global_var"), Has("index_var"), Has("global_func"),
265 Has("global_func()"), Has("index_func"), Has("GlobalClass"),
266 Has("IndexClass"), Has("MACRO"), Has("LocalClass"))));
Sam McCallf6ae3232017-12-05 20:11:29 +0000267 // There should be no code patterns (aka snippets) in after-dot
268 // completion. At least there aren't any we're aware of.
Sam McCall44fdcec22017-12-08 15:00:59 +0000269 EXPECT_THAT(Results.items, Not(Contains(Kind(CompletionItemKind::Snippet))));
Sam McCallf6ae3232017-12-05 20:11:29 +0000270 // Check documentation.
Sam McCall44fdcec22017-12-08 15:00:59 +0000271 EXPECT_IFF(Opts.IncludeBriefComments, Results.items,
272 Contains(IsDocumented()));
Sam McCallf6ae3232017-12-05 20:11:29 +0000273}
Sam McCall9aad25f2017-12-05 07:20:26 +0000274
Sam McCallf6ae3232017-12-05 20:11:29 +0000275void TestGlobalScopeCompletion(clangd::CodeCompleteOptions Opts) {
Sam McCall44fdcec22017-12-08 15:00:59 +0000276 auto Results = completions(
277 R"cpp(
278 #define MACRO X
Sam McCall9aad25f2017-12-05 07:20:26 +0000279
Sam McCall44fdcec22017-12-08 15:00:59 +0000280 int global_var;
281 int global_func();
Sam McCall9aad25f2017-12-05 07:20:26 +0000282
Sam McCall44fdcec22017-12-08 15:00:59 +0000283 struct GlobalClass {};
Sam McCall9aad25f2017-12-05 07:20:26 +0000284
Sam McCall44fdcec22017-12-08 15:00:59 +0000285 struct ClassWithMembers {
286 /// Doc for method.
287 int method();
288 };
Sam McCall9aad25f2017-12-05 07:20:26 +0000289
Sam McCall44fdcec22017-12-08 15:00:59 +0000290 int test() {
291 struct LocalClass {};
Sam McCall9aad25f2017-12-05 07:20:26 +0000292
Sam McCall44fdcec22017-12-08 15:00:59 +0000293 /// Doc for local_var.
294 int local_var;
Sam McCall9aad25f2017-12-05 07:20:26 +0000295
Sam McCall44fdcec22017-12-08 15:00:59 +0000296 ^
297 }
298 )cpp",
Sam McCall545a20d2018-01-19 14:34:02 +0000299 {cls("IndexClass"), var("index_var"), func("index_func")}, Opts);
Sam McCallf6ae3232017-12-05 20:11:29 +0000300
301 // Class members. Should never be present in global completions.
Sam McCall44fdcec22017-12-08 15:00:59 +0000302 EXPECT_THAT(Results.items,
Sam McCallf6ae3232017-12-05 20:11:29 +0000303 Not(AnyOf(Has("method"), Has("method()"), Has("field"))));
304 // Global items.
Sam McCalld8169a82018-01-18 15:31:30 +0000305 EXPECT_THAT(Results.items,
Sam McCall545a20d2018-01-19 14:34:02 +0000306 AllOf(Has("global_var"), Has("index_var"),
Sam McCalld8169a82018-01-18 15:31:30 +0000307 Has(Opts.EnableSnippets ? "global_func()" : "global_func"),
Sam McCall545a20d2018-01-19 14:34:02 +0000308 Has("index_func" /* our fake symbol doesn't include () */),
309 Has("GlobalClass"), Has("IndexClass")));
Sam McCallf6ae3232017-12-05 20:11:29 +0000310 // A macro.
Sam McCall44fdcec22017-12-08 15:00:59 +0000311 EXPECT_IFF(Opts.IncludeMacros, Results.items, Has("MACRO"));
Sam McCallf6ae3232017-12-05 20:11:29 +0000312 // Local items. Must be present always.
Ilya Biryukov9b5ffc22017-12-12 12:56:46 +0000313 EXPECT_THAT(Results.items,
314 AllOf(Has("local_var"), Has("LocalClass"),
315 Contains(Kind(CompletionItemKind::Snippet))));
Sam McCallf6ae3232017-12-05 20:11:29 +0000316 // Check documentation.
Sam McCall44fdcec22017-12-08 15:00:59 +0000317 EXPECT_IFF(Opts.IncludeBriefComments, Results.items,
318 Contains(IsDocumented()));
Sam McCallf6ae3232017-12-05 20:11:29 +0000319}
320
321TEST(CompletionTest, CompletionOptions) {
Sam McCall2c3849a2018-01-16 12:21:24 +0000322 auto Test = [&](const clangd::CodeCompleteOptions &Opts) {
323 TestAfterDotCompletion(Opts);
324 TestGlobalScopeCompletion(Opts);
325 };
326 // We used to test every combination of options, but that got too slow (2^N).
327 auto Flags = {
328 &clangd::CodeCompleteOptions::IncludeMacros,
Sam McCall2c3849a2018-01-16 12:21:24 +0000329 &clangd::CodeCompleteOptions::IncludeBriefComments,
330 &clangd::CodeCompleteOptions::EnableSnippets,
331 &clangd::CodeCompleteOptions::IncludeCodePatterns,
332 &clangd::CodeCompleteOptions::IncludeIneligibleResults,
333 };
334 // Test default options.
335 Test({});
336 // Test with one flag flipped.
337 for (auto &F : Flags) {
338 clangd::CodeCompleteOptions O;
339 O.*F ^= true;
340 Test(O);
Sam McCall9aad25f2017-12-05 07:20:26 +0000341 }
342}
343
Sam McCallf6ae3232017-12-05 20:11:29 +0000344// Check code completion works when the file contents are overridden.
345TEST(CompletionTest, CheckContentsOverride) {
346 MockFSProvider FS;
347 IgnoreDiagnostics DiagConsumer;
348 MockCompilationDatabase CDB;
349 ClangdServer Server(CDB, DiagConsumer, FS, getDefaultAsyncThreadsCount(),
Ilya Biryukov940901e2017-12-13 12:51:22 +0000350 /*StorePreamblesInMemory=*/true);
Sam McCallf6ae3232017-12-05 20:11:29 +0000351 auto File = getVirtualTestFilePath("foo.cpp");
Ilya Biryukov940901e2017-12-13 12:51:22 +0000352 Server.addDocument(Context::empty(), File, "ignored text!");
Sam McCallf6ae3232017-12-05 20:11:29 +0000353
Sam McCall328cbdb2017-12-20 16:06:05 +0000354 Annotations Example("int cbc; int b = ^;");
355 auto Results = Server
356 .codeComplete(Context::empty(), File, Example.point(),
357 clangd::CodeCompleteOptions(),
358 StringRef(Example.code()))
359 .get()
360 .second.Value;
Sam McCallf6ae3232017-12-05 20:11:29 +0000361 EXPECT_THAT(Results.items, Contains(Named("cbc")));
362}
363
Sam McCall44fdcec22017-12-08 15:00:59 +0000364TEST(CompletionTest, Priorities) {
365 auto Internal = completions(R"cpp(
366 class Foo {
367 public: void pub();
368 protected: void prot();
369 private: void priv();
370 };
371 void Foo::pub() { this->^ }
372 )cpp");
373 EXPECT_THAT(Internal.items,
374 HasSubsequence(Named("priv"), Named("prot"), Named("pub")));
375
376 auto External = completions(R"cpp(
377 class Foo {
378 public: void pub();
379 protected: void prot();
380 private: void priv();
381 };
382 void test() {
383 Foo F;
384 F.^
385 }
386 )cpp");
387 EXPECT_THAT(External.items,
388 AllOf(Has("pub"), Not(Has("prot")), Not(Has("priv"))));
389}
390
391TEST(CompletionTest, Qualifiers) {
392 auto Results = completions(R"cpp(
393 class Foo {
394 public: int foo() const;
395 int bar() const;
396 };
397 class Bar : public Foo {
398 int foo() const;
399 };
400 void test() { Bar().^ }
401 )cpp");
402 EXPECT_THAT(Results.items, HasSubsequence(Labeled("bar() const"),
403 Labeled("Foo::foo() const")));
404 EXPECT_THAT(Results.items, Not(Contains(Labeled("foo() const")))); // private
405}
406
407TEST(CompletionTest, Snippets) {
408 clangd::CodeCompleteOptions Opts;
409 Opts.EnableSnippets = true;
410 auto Results = completions(
411 R"cpp(
412 struct fake {
413 int a;
414 int f(int i, const float f) const;
415 };
416 int main() {
417 fake f;
418 f.^
419 }
420 )cpp",
Sam McCalla15c2d62018-01-18 09:27:56 +0000421 /*IndexSymbols=*/{}, Opts);
Sam McCall44fdcec22017-12-08 15:00:59 +0000422 EXPECT_THAT(Results.items,
Eric Liu63696e12017-12-20 17:24:31 +0000423 HasSubsequence(Snippet("a"),
Sam McCall44fdcec22017-12-08 15:00:59 +0000424 Snippet("f(${1:int i}, ${2:const float f})")));
425}
426
427TEST(CompletionTest, Kinds) {
Sam McCall545a20d2018-01-19 14:34:02 +0000428 auto Results = completions(
429 R"cpp(
430 #define MACRO X
431 int variable;
432 struct Struct {};
433 int function();
434 int X = ^
435 )cpp",
436 {func("indexFunction"), var("indexVariable"), cls("indexClass")});
437 EXPECT_THAT(Results.items,
438 AllOf(Has("function", CompletionItemKind::Function),
439 Has("variable", CompletionItemKind::Variable),
440 Has("int", CompletionItemKind::Keyword),
441 Has("Struct", CompletionItemKind::Class),
442 Has("MACRO", CompletionItemKind::Text),
443 Has("indexFunction", CompletionItemKind::Function),
444 Has("indexVariable", CompletionItemKind::Variable),
445 Has("indexClass", CompletionItemKind::Class)));
Sam McCall44fdcec22017-12-08 15:00:59 +0000446
Sam McCall44fdcec22017-12-08 15:00:59 +0000447 Results = completions("nam^");
448 EXPECT_THAT(Results.items, Has("namespace", CompletionItemKind::Snippet));
449}
450
Sam McCall84652cc2018-01-12 16:16:09 +0000451TEST(CompletionTest, NoDuplicates) {
Sam McCall545a20d2018-01-19 14:34:02 +0000452 auto Results = completions(
453 R"cpp(
454 class Adapter {
455 void method();
456 };
Sam McCall84652cc2018-01-12 16:16:09 +0000457
Sam McCall545a20d2018-01-19 14:34:02 +0000458 void Adapter::method() {
459 Adapter^
460 }
461 )cpp",
462 {cls("Adapter")});
Sam McCall84652cc2018-01-12 16:16:09 +0000463
464 // Make sure there are no duplicate entries of 'Adapter'.
Sam McCalld2a95922018-01-22 21:05:00 +0000465 EXPECT_THAT(Results.items, ElementsAre(Named("Adapter")));
Sam McCall84652cc2018-01-12 16:16:09 +0000466}
467
Sam McCall545a20d2018-01-19 14:34:02 +0000468TEST(CompletionTest, ScopedNoIndex) {
469 auto Results = completions(
470 R"cpp(
471 namespace fake { int BigBang, Babble, Ball; };
472 int main() { fake::bb^ }
473 ")cpp");
Sam McCall84652cc2018-01-12 16:16:09 +0000474 // BigBang is a better match than Babble. Ball doesn't match at all.
Sam McCall545a20d2018-01-19 14:34:02 +0000475 EXPECT_THAT(Results.items, ElementsAre(Named("BigBang"), Named("Babble")));
Sam McCall84652cc2018-01-12 16:16:09 +0000476}
477
Sam McCall545a20d2018-01-19 14:34:02 +0000478TEST(CompletionTest, Scoped) {
Sam McCalla15c2d62018-01-18 09:27:56 +0000479 auto Results = completions(
480 R"cpp(
Sam McCall545a20d2018-01-19 14:34:02 +0000481 namespace fake { int Babble, Ball; };
482 int main() { fake::bb^ }
483 ")cpp",
484 {var("fake::BigBang")});
485 EXPECT_THAT(Results.items, ElementsAre(Named("BigBang"), Named("Babble")));
Sam McCalla15c2d62018-01-18 09:27:56 +0000486}
487
Sam McCall545a20d2018-01-19 14:34:02 +0000488TEST(CompletionTest, ScopedWithFilter) {
Sam McCalla15c2d62018-01-18 09:27:56 +0000489 auto Results = completions(
490 R"cpp(
491 void f() { ns::x^ }
492 )cpp",
493 {cls("ns::XYZ"), func("ns::foo")});
494 EXPECT_THAT(Results.items,
495 UnorderedElementsAre(AllOf(Named("XYZ"), Filter("XYZ"))));
496}
497
Sam McCall545a20d2018-01-19 14:34:02 +0000498TEST(CompletionTest, GlobalQualified) {
Sam McCalla15c2d62018-01-18 09:27:56 +0000499 auto Results = completions(
500 R"cpp(
501 void f() { ::^ }
502 )cpp",
503 {cls("XYZ")});
504 EXPECT_THAT(Results.items, AllOf(Has("XYZ", CompletionItemKind::Class),
505 Has("f", CompletionItemKind::Function)));
506}
507
Sam McCall545a20d2018-01-19 14:34:02 +0000508TEST(CompletionTest, FullyQualified) {
Sam McCalla15c2d62018-01-18 09:27:56 +0000509 auto Results = completions(
510 R"cpp(
Sam McCall545a20d2018-01-19 14:34:02 +0000511 namespace ns { void bar(); }
Sam McCalla15c2d62018-01-18 09:27:56 +0000512 void f() { ::ns::^ }
513 )cpp",
514 {cls("ns::XYZ")});
Sam McCall545a20d2018-01-19 14:34:02 +0000515 EXPECT_THAT(Results.items, AllOf(Has("XYZ", CompletionItemKind::Class),
516 Has("bar", CompletionItemKind::Function)));
517}
518
519TEST(CompletionTest, SemaIndexMerge) {
520 auto Results = completions(
521 R"cpp(
522 namespace ns { int local; void both(); }
523 void f() { ::ns::^ }
524 )cpp",
525 {func("ns::both"), cls("ns::Index")});
526 // We get results from both index and sema, with no duplicates.
527 EXPECT_THAT(
528 Results.items,
529 UnorderedElementsAre(Named("local"), Named("Index"), Named("both")));
Sam McCalla15c2d62018-01-18 09:27:56 +0000530}
531
Haojian Wu48b48652018-01-25 09:20:09 +0000532TEST(CompletionTest, SemaIndexMergeWithLimit) {
533 clangd::CodeCompleteOptions Opts;
534 Opts.Limit = 1;
535 auto Results = completions(
536 R"cpp(
537 namespace ns { int local; void both(); }
538 void f() { ::ns::^ }
539 )cpp",
540 {func("ns::both"), cls("ns::Index")}, Opts);
541 EXPECT_EQ(Results.items.size(), Opts.Limit);
542 EXPECT_TRUE(Results.isIncomplete);
543}
544
Sam McCalla15c2d62018-01-18 09:27:56 +0000545TEST(CompletionTest, IndexSuppressesPreambleCompletions) {
546 MockFSProvider FS;
547 MockCompilationDatabase CDB;
548 IgnoreDiagnostics DiagConsumer;
549 ClangdServer Server(CDB, DiagConsumer, FS, getDefaultAsyncThreadsCount(),
550 /*StorePreamblesInMemory=*/true);
551
552 FS.Files[getVirtualTestFilePath("bar.h")] =
Sam McCalld5ea3e32018-01-24 17:53:32 +0000553 R"cpp(namespace ns { struct preamble { int member; }; })cpp";
Sam McCalla15c2d62018-01-18 09:27:56 +0000554 auto File = getVirtualTestFilePath("foo.cpp");
555 Annotations Test(R"cpp(
556 #include "bar.h"
557 namespace ns { int local; }
Sam McCalld5ea3e32018-01-24 17:53:32 +0000558 void f() { ns::^; }
559 void f() { ns::preamble().$2^; }
Sam McCalla15c2d62018-01-18 09:27:56 +0000560 )cpp");
561 Server.addDocument(Context::empty(), File, Test.code()).wait();
562 clangd::CodeCompleteOptions Opts = {};
563
564 auto WithoutIndex =
565 Server.codeComplete(Context::empty(), File, Test.point(), Opts)
566 .get()
567 .second.Value;
568 EXPECT_THAT(WithoutIndex.items,
569 UnorderedElementsAre(Named("local"), Named("preamble")));
570
571 auto I = memIndex({var("ns::index")});
572 Opts.Index = I.get();
573 auto WithIndex =
574 Server.codeComplete(Context::empty(), File, Test.point(), Opts)
575 .get()
576 .second.Value;
577 EXPECT_THAT(WithIndex.items,
578 UnorderedElementsAre(Named("local"), Named("index")));
Sam McCalld5ea3e32018-01-24 17:53:32 +0000579 auto ClassFromPreamble =
580 Server.codeComplete(Context::empty(), File, Test.point("2"), Opts)
581 .get()
582 .second.Value;
583 EXPECT_THAT(ClassFromPreamble.items, Contains(Named("member")));
Sam McCalla15c2d62018-01-18 09:27:56 +0000584}
585
586TEST(CompletionTest, DynamicIndexMultiFile) {
587 MockFSProvider FS;
588 MockCompilationDatabase CDB;
589 IgnoreDiagnostics DiagConsumer;
590 ClangdServer Server(CDB, DiagConsumer, FS, getDefaultAsyncThreadsCount(),
591 /*StorePreamblesInMemory=*/true,
592 /*BuildDynamicSymbolIndex=*/true);
593
594 Server
595 .addDocument(Context::empty(), getVirtualTestFilePath("foo.cpp"), R"cpp(
596 namespace ns { class XYZ {}; void foo(int x) {} }
597 )cpp")
598 .wait();
599
600 auto File = getVirtualTestFilePath("bar.cpp");
601 Annotations Test(R"cpp(
602 namespace ns {
603 class XXX {};
604 /// Doooc
605 void fooooo() {}
606 }
607 void f() { ns::^ }
608 )cpp");
609 Server.addDocument(Context::empty(), File, Test.code()).wait();
610
611 auto Results = Server.codeComplete(Context::empty(), File, Test.point(), {})
612 .get()
613 .second.Value;
614 // "XYZ" and "foo" are not included in the file being completed but are still
615 // visible through the index.
616 EXPECT_THAT(Results.items, Has("XYZ", CompletionItemKind::Class));
617 EXPECT_THAT(Results.items, Has("foo", CompletionItemKind::Function));
618 EXPECT_THAT(Results.items, Has("XXX", CompletionItemKind::Class));
619 EXPECT_THAT(Results.items, Contains(AllOf(Named("fooooo"), Filter("fooooo"),
620 Kind(CompletionItemKind::Function),
621 Doc("Doooc"), Detail("void"))));
622}
623
Sam McCall800d4372017-12-19 10:29:27 +0000624SignatureHelp signatures(StringRef Text) {
625 MockFSProvider FS;
626 MockCompilationDatabase CDB;
627 IgnoreDiagnostics DiagConsumer;
628 ClangdServer Server(CDB, DiagConsumer, FS, getDefaultAsyncThreadsCount(),
629 /*StorePreamblesInMemory=*/true);
630 auto File = getVirtualTestFilePath("foo.cpp");
Sam McCall328cbdb2017-12-20 16:06:05 +0000631 Annotations Test(Text);
632 Server.addDocument(Context::empty(), File, Test.code());
633 auto R = Server.signatureHelp(Context::empty(), File, Test.point());
Sam McCall800d4372017-12-19 10:29:27 +0000634 assert(R);
635 return R.get().Value;
636}
637
638MATCHER_P(ParamsAre, P, "") {
639 if (P.size() != arg.parameters.size())
640 return false;
641 for (unsigned I = 0; I < P.size(); ++I)
642 if (P[I] != arg.parameters[I].label)
643 return false;
644 return true;
645}
646
647Matcher<SignatureInformation> Sig(std::string Label,
648 std::vector<std::string> Params) {
649 return AllOf(Labeled(Label), ParamsAre(Params));
650}
651
652TEST(SignatureHelpTest, Overloads) {
653 auto Results = signatures(R"cpp(
654 void foo(int x, int y);
655 void foo(int x, float y);
656 void foo(float x, int y);
657 void foo(float x, float y);
658 void bar(int x, int y = 0);
659 int main() { foo(^); }
660 )cpp");
661 EXPECT_THAT(Results.signatures,
662 UnorderedElementsAre(
663 Sig("foo(float x, float y) -> void", {"float x", "float y"}),
664 Sig("foo(float x, int y) -> void", {"float x", "int y"}),
665 Sig("foo(int x, float y) -> void", {"int x", "float y"}),
666 Sig("foo(int x, int y) -> void", {"int x", "int y"})));
667 // We always prefer the first signature.
668 EXPECT_EQ(0, Results.activeSignature);
669 EXPECT_EQ(0, Results.activeParameter);
670}
671
672TEST(SignatureHelpTest, DefaultArgs) {
673 auto Results = signatures(R"cpp(
674 void bar(int x, int y = 0);
675 void bar(float x = 0, int y = 42);
676 int main() { bar(^
677 )cpp");
678 EXPECT_THAT(Results.signatures,
679 UnorderedElementsAre(
680 Sig("bar(int x, int y = 0) -> void", {"int x", "int y = 0"}),
681 Sig("bar(float x = 0, int y = 42) -> void",
682 {"float x = 0", "int y = 42"})));
683 EXPECT_EQ(0, Results.activeSignature);
684 EXPECT_EQ(0, Results.activeParameter);
685}
686
687TEST(SignatureHelpTest, ActiveArg) {
688 auto Results = signatures(R"cpp(
689 int baz(int a, int b, int c);
690 int main() { baz(baz(1,2,3), ^); }
691 )cpp");
692 EXPECT_THAT(Results.signatures,
693 ElementsAre(Sig("baz(int a, int b, int c) -> int",
694 {"int a", "int b", "int c"})));
695 EXPECT_EQ(0, Results.activeSignature);
696 EXPECT_EQ(1, Results.activeParameter);
697}
698
Haojian Wu061c73e2018-01-23 11:37:26 +0000699class IndexRequestCollector : public SymbolIndex {
700public:
701 bool
702 fuzzyFind(const Context &Ctx, const FuzzyFindRequest &Req,
703 llvm::function_ref<void(const Symbol &)> Callback) const override {
704 Requests.push_back(Req);
705 return false;
706 }
707
708 const std::vector<FuzzyFindRequest> allRequests() const { return Requests; }
709
710private:
711 mutable std::vector<FuzzyFindRequest> Requests;
712};
713
714std::vector<FuzzyFindRequest> captureIndexRequests(llvm::StringRef Code) {
715 clangd::CodeCompleteOptions Opts;
716 IndexRequestCollector Requests;
717 Opts.Index = &Requests;
718 completions(Code, {}, Opts);
719 return Requests.allRequests();
720}
721
722TEST(CompletionTest, UnqualifiedIdQuery) {
723 auto Requests = captureIndexRequests(R"cpp(
724 namespace std {}
725 using namespace std;
726 namespace ns {
727 void f() {
728 vec^
729 }
730 }
731 )cpp");
732
733 EXPECT_THAT(Requests,
734 ElementsAre(Field(&FuzzyFindRequest::Scopes,
735 UnorderedElementsAre("", "ns::", "std::"))));
736}
737
738TEST(CompletionTest, ResolvedQualifiedIdQuery) {
739 auto Requests = captureIndexRequests(R"cpp(
740 namespace ns1 {}
741 namespace ns2 {} // ignore
742 namespace ns3 { namespace nns3 {} }
743 namespace foo {
744 using namespace ns1;
745 using namespace ns3::nns3;
746 }
747 namespace ns {
748 void f() {
749 foo::^
750 }
751 }
752 )cpp");
753
754 EXPECT_THAT(Requests,
755 ElementsAre(Field(
756 &FuzzyFindRequest::Scopes,
757 UnorderedElementsAre("foo::", "ns1::", "ns3::nns3::"))));
758}
759
760TEST(CompletionTest, UnresolvedQualifierIdQuery) {
761 auto Requests = captureIndexRequests(R"cpp(
762 namespace a {}
763 using namespace a;
764 namespace ns {
765 void f() {
766 bar::^
767 }
768 } // namespace ns
769 )cpp");
770
771 EXPECT_THAT(Requests, ElementsAre(Field(&FuzzyFindRequest::Scopes,
772 UnorderedElementsAre("bar::"))));
773}
774
775TEST(CompletionTest, UnresolvedNestedQualifierIdQuery) {
776 auto Requests = captureIndexRequests(R"cpp(
777 namespace a {}
778 using namespace a;
779 namespace ns {
780 void f() {
781 ::a::bar::^
782 }
783 } // namespace ns
784 )cpp");
785
786 EXPECT_THAT(Requests, ElementsAre(Field(&FuzzyFindRequest::Scopes,
787 UnorderedElementsAre("a::bar::"))));
788}
789
790TEST(CompletionTest, EmptyQualifiedQuery) {
791 auto Requests = captureIndexRequests(R"cpp(
792 namespace ns {
793 void f() {
794 ^
795 }
796 } // namespace ns
797 )cpp");
798
799 EXPECT_THAT(Requests, ElementsAre(Field(&FuzzyFindRequest::Scopes,
800 UnorderedElementsAre("", "ns::"))));
801}
802
803TEST(CompletionTest, GlobalQualifiedQuery) {
804 auto Requests = captureIndexRequests(R"cpp(
805 namespace ns {
806 void f() {
807 ::^
808 }
809 } // namespace ns
810 )cpp");
811
812 EXPECT_THAT(Requests, ElementsAre(Field(&FuzzyFindRequest::Scopes,
813 UnorderedElementsAre(""))));
814}
815
Sam McCall9aad25f2017-12-05 07:20:26 +0000816} // namespace
817} // namespace clangd
818} // namespace clang