blob: bc1d7cd247c4ec861dcb84435d93ababff563a91 [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 Biryukov5a85b8e2017-12-13 12:53:16 +000014#include "Matchers.h"
Sam McCall9aad25f2017-12-05 07:20:26 +000015#include "Protocol.h"
Sam McCallb536a2a2017-12-19 12:23:48 +000016#include "SourceCode.h"
Ilya Biryukovcd5eb002018-02-12 11:37:28 +000017#include "SyncAPI.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 McCallf6ae3232017-12-05 20:11:29 +000025
Sam McCall9aad25f2017-12-05 07:20:26 +000026namespace {
27using namespace llvm;
Sam McCallf6ae3232017-12-05 20:11:29 +000028using ::testing::AllOf;
29using ::testing::Contains;
Ilya Biryukov5a5e1ca2017-12-29 14:59:22 +000030using ::testing::Each;
Sam McCallf6ae3232017-12-05 20:11:29 +000031using ::testing::ElementsAre;
Ilya Biryukov71028b82018-03-12 15:28:22 +000032using ::testing::Field;
Sam McCallf6ae3232017-12-05 20:11:29 +000033using ::testing::Not;
Sam McCall3d139c52018-01-12 18:30:08 +000034using ::testing::UnorderedElementsAre;
Sam McCall9aad25f2017-12-05 07:20:26 +000035
36class IgnoreDiagnostics : public DiagnosticsConsumer {
Ilya Biryukov71028b82018-03-12 15:28:22 +000037 void onDiagnosticsReady(PathRef File,
Sam McCalla7bb0cc2018-03-12 23:22:35 +000038 std::vector<Diag> Diagnostics) override {}
Sam McCall9aad25f2017-12-05 07:20:26 +000039};
40
Sam McCallf6ae3232017-12-05 20:11:29 +000041// GMock helpers for matching completion items.
42MATCHER_P(Named, Name, "") { return arg.insertText == Name; }
Sam McCall44fdcec22017-12-08 15:00:59 +000043MATCHER_P(Labeled, Label, "") { return arg.label == Label; }
44MATCHER_P(Kind, K, "") { return arg.kind == K; }
Eric Liu6f648df2017-12-19 16:50:37 +000045MATCHER_P(Filter, F, "") { return arg.filterText == F; }
Eric Liu76f6b442018-01-09 17:32:00 +000046MATCHER_P(Doc, D, "") { return arg.documentation == D; }
47MATCHER_P(Detail, D, "") { return arg.detail == D; }
Sam McCall44fdcec22017-12-08 15:00:59 +000048MATCHER_P(PlainText, Text, "") {
49 return arg.insertTextFormat == clangd::InsertTextFormat::PlainText &&
50 arg.insertText == Text;
51}
52MATCHER_P(Snippet, Text, "") {
53 return arg.insertTextFormat == clangd::InsertTextFormat::Snippet &&
54 arg.insertText == Text;
55}
Sam McCall545a20d2018-01-19 14:34:02 +000056MATCHER(NameContainsFilter, "") {
Ilya Biryukov5a5e1ca2017-12-29 14:59:22 +000057 if (arg.filterText.empty())
58 return true;
59 return llvm::StringRef(arg.insertText).contains(arg.filterText);
60}
Sam McCallf6ae3232017-12-05 20:11:29 +000061// Shorthand for Contains(Named(Name)).
62Matcher<const std::vector<CompletionItem> &> Has(std::string Name) {
63 return Contains(Named(std::move(Name)));
64}
Sam McCall44fdcec22017-12-08 15:00:59 +000065Matcher<const std::vector<CompletionItem> &> Has(std::string Name,
66 CompletionItemKind K) {
67 return Contains(AllOf(Named(std::move(Name)), Kind(K)));
Sam McCallf6ae3232017-12-05 20:11:29 +000068}
Sam McCall44fdcec22017-12-08 15:00:59 +000069MATCHER(IsDocumented, "") { return !arg.documentation.empty(); }
Sam McCall9aad25f2017-12-05 07:20:26 +000070
Sam McCalla15c2d62018-01-18 09:27:56 +000071std::unique_ptr<SymbolIndex> memIndex(std::vector<Symbol> Symbols) {
72 SymbolSlab::Builder Slab;
73 for (const auto &Sym : Symbols)
74 Slab.insert(Sym);
75 return MemIndex::build(std::move(Slab).build());
76}
77
78// Builds a server and runs code completion.
79// If IndexSymbols is non-empty, an index will be built and passed to opts.
Sam McCallf6ae3232017-12-05 20:11:29 +000080CompletionList completions(StringRef Text,
Sam McCalla15c2d62018-01-18 09:27:56 +000081 std::vector<Symbol> IndexSymbols = {},
Sam McCallf6ae3232017-12-05 20:11:29 +000082 clangd::CodeCompleteOptions Opts = {}) {
Sam McCalla15c2d62018-01-18 09:27:56 +000083 std::unique_ptr<SymbolIndex> OverrideIndex;
84 if (!IndexSymbols.empty()) {
85 assert(!Opts.Index && "both Index and IndexSymbols given!");
86 OverrideIndex = memIndex(std::move(IndexSymbols));
87 Opts.Index = OverrideIndex.get();
88 }
89
Sam McCall9aad25f2017-12-05 07:20:26 +000090 MockFSProvider FS;
Sam McCall93cd9912017-12-05 07:34:35 +000091 MockCompilationDatabase CDB;
Sam McCallf6ae3232017-12-05 20:11:29 +000092 IgnoreDiagnostics DiagConsumer;
Sam McCall7363a2f2018-03-05 17:28:54 +000093 ClangdServer Server(CDB, FS, DiagConsumer, ClangdServer::optsForTest());
Sam McCallc1568062018-02-16 09:41:43 +000094 auto File = testPath("foo.cpp");
Sam McCall328cbdb2017-12-20 16:06:05 +000095 Annotations Test(Text);
Sam McCall7363a2f2018-03-05 17:28:54 +000096 runAddDocument(Server, File, Test.code());
Sam McCalla7bb0cc2018-03-12 23:22:35 +000097 auto CompletionList =
98 cantFail(runCodeComplete(Server, File, Test.point(), Opts));
Ilya Biryukov5a5e1ca2017-12-29 14:59:22 +000099 // Sanity-check that filterText is valid.
Sam McCall545a20d2018-01-19 14:34:02 +0000100 EXPECT_THAT(CompletionList.items, Each(NameContainsFilter()));
Ilya Biryukov5a5e1ca2017-12-29 14:59:22 +0000101 return CompletionList;
Sam McCall9aad25f2017-12-05 07:20:26 +0000102}
103
Sam McCall545a20d2018-01-19 14:34:02 +0000104std::string replace(StringRef Haystack, StringRef Needle, StringRef Repl) {
105 std::string Result;
106 raw_string_ostream OS(Result);
107 std::pair<StringRef, StringRef> Split;
108 for (Split = Haystack.split(Needle); !Split.second.empty();
109 Split = Split.first.split(Needle))
110 OS << Split.first << Repl;
111 Result += Split.first;
112 OS.flush();
113 return Result;
114}
115
Sam McCalla15c2d62018-01-18 09:27:56 +0000116// Helpers to produce fake index symbols for memIndex() or completions().
Sam McCall545a20d2018-01-19 14:34:02 +0000117// USRFormat is a regex replacement string for the unqualified part of the USR.
118Symbol sym(StringRef QName, index::SymbolKind Kind, StringRef USRFormat) {
Sam McCalla15c2d62018-01-18 09:27:56 +0000119 Symbol Sym;
Sam McCall545a20d2018-01-19 14:34:02 +0000120 std::string USR = "c:"; // We synthesize a few simple cases of USRs by hand!
Sam McCalla15c2d62018-01-18 09:27:56 +0000121 size_t Pos = QName.rfind("::");
122 if (Pos == llvm::StringRef::npos) {
123 Sym.Name = QName;
124 Sym.Scope = "";
125 } else {
126 Sym.Name = QName.substr(Pos + 2);
Sam McCall8b2faee2018-01-19 22:18:21 +0000127 Sym.Scope = QName.substr(0, Pos + 2);
128 USR += "@N@" + replace(QName.substr(0, Pos), "::", "@N@"); // ns:: -> @N@ns
Sam McCalla15c2d62018-01-18 09:27:56 +0000129 }
Sam McCall545a20d2018-01-19 14:34:02 +0000130 USR += Regex("^.*$").sub(USRFormat, Sym.Name); // e.g. func -> @F@func#
131 Sym.ID = SymbolID(USR);
Sam McCalla15c2d62018-01-18 09:27:56 +0000132 Sym.CompletionPlainInsertText = Sym.Name;
Sam McCall545a20d2018-01-19 14:34:02 +0000133 Sym.CompletionSnippetInsertText = Sym.Name;
Sam McCalla15c2d62018-01-18 09:27:56 +0000134 Sym.CompletionLabel = Sym.Name;
135 Sym.SymInfo.Kind = Kind;
136 return Sym;
137}
Sam McCall545a20d2018-01-19 14:34:02 +0000138Symbol func(StringRef Name) { // Assumes the function has no args.
139 return sym(Name, index::SymbolKind::Function, "@F@\\0#"); // no args
140}
141Symbol cls(StringRef Name) {
142 return sym(Name, index::SymbolKind::Class, "@S@\\0@S@\\0");
143}
144Symbol var(StringRef Name) {
145 return sym(Name, index::SymbolKind::Variable, "@\\0");
146}
Sam McCalldc8abc42018-05-03 14:53:02 +0000147Symbol ns(StringRef Name) {
148 return sym(Name, index::SymbolKind::Namespace, "@N@\\0");
149}
150Symbol withReferences(int N, Symbol S) {
151 S.References = N;
152 return S;
153}
Sam McCalla15c2d62018-01-18 09:27:56 +0000154
Sam McCallf6ae3232017-12-05 20:11:29 +0000155TEST(CompletionTest, Limit) {
156 clangd::CodeCompleteOptions Opts;
157 Opts.Limit = 2;
158 auto Results = completions(R"cpp(
Sam McCall9aad25f2017-12-05 07:20:26 +0000159struct ClassWithMembers {
160 int AAA();
161 int BBB();
162 int CCC();
163}
Sam McCallf6ae3232017-12-05 20:11:29 +0000164int main() { ClassWithMembers().^ }
Sam McCall9aad25f2017-12-05 07:20:26 +0000165 )cpp",
Sam McCalla15c2d62018-01-18 09:27:56 +0000166 /*IndexSymbols=*/{}, Opts);
Sam McCall9aad25f2017-12-05 07:20:26 +0000167
168 EXPECT_TRUE(Results.isIncomplete);
Sam McCallf6ae3232017-12-05 20:11:29 +0000169 EXPECT_THAT(Results.items, ElementsAre(Named("AAA"), Named("BBB")));
Sam McCall9aad25f2017-12-05 07:20:26 +0000170}
171
Sam McCallf6ae3232017-12-05 20:11:29 +0000172TEST(CompletionTest, Filter) {
173 std::string Body = R"cpp(
Sam McCall9aad25f2017-12-05 07:20:26 +0000174 int Abracadabra;
175 int Alakazam;
176 struct S {
177 int FooBar;
178 int FooBaz;
179 int Qux;
180 };
181 )cpp";
Sam McCallf6ae3232017-12-05 20:11:29 +0000182 EXPECT_THAT(completions(Body + "int main() { S().Foba^ }").items,
183 AllOf(Has("FooBar"), Has("FooBaz"), Not(Has("Qux"))));
Sam McCall9aad25f2017-12-05 07:20:26 +0000184
Sam McCallf6ae3232017-12-05 20:11:29 +0000185 EXPECT_THAT(completions(Body + "int main() { S().FR^ }").items,
186 AllOf(Has("FooBar"), Not(Has("FooBaz")), Not(Has("Qux"))));
Sam McCall9aad25f2017-12-05 07:20:26 +0000187
Sam McCallf6ae3232017-12-05 20:11:29 +0000188 EXPECT_THAT(completions(Body + "int main() { S().opr^ }").items,
189 Has("operator="));
Sam McCall9aad25f2017-12-05 07:20:26 +0000190
Sam McCallf6ae3232017-12-05 20:11:29 +0000191 EXPECT_THAT(completions(Body + "int main() { aaa^ }").items,
192 AllOf(Has("Abracadabra"), Has("Alakazam")));
Sam McCall9aad25f2017-12-05 07:20:26 +0000193
Sam McCallf6ae3232017-12-05 20:11:29 +0000194 EXPECT_THAT(completions(Body + "int main() { _a^ }").items,
195 AllOf(Has("static_cast"), Not(Has("Abracadabra"))));
Sam McCall9aad25f2017-12-05 07:20:26 +0000196}
197
Sam McCallf6ae3232017-12-05 20:11:29 +0000198void TestAfterDotCompletion(clangd::CodeCompleteOptions Opts) {
Sam McCall44fdcec22017-12-08 15:00:59 +0000199 auto Results = completions(
200 R"cpp(
201 #define MACRO X
Sam McCall9aad25f2017-12-05 07:20:26 +0000202
Sam McCall44fdcec22017-12-08 15:00:59 +0000203 int global_var;
Sam McCall9aad25f2017-12-05 07:20:26 +0000204
Sam McCall44fdcec22017-12-08 15:00:59 +0000205 int global_func();
Sam McCall9aad25f2017-12-05 07:20:26 +0000206
Sam McCall44fdcec22017-12-08 15:00:59 +0000207 struct GlobalClass {};
Sam McCall9aad25f2017-12-05 07:20:26 +0000208
Sam McCall44fdcec22017-12-08 15:00:59 +0000209 struct ClassWithMembers {
210 /// Doc for method.
211 int method();
Sam McCall9aad25f2017-12-05 07:20:26 +0000212
Sam McCall44fdcec22017-12-08 15:00:59 +0000213 int field;
214 private:
215 int private_field;
216 };
Sam McCall9aad25f2017-12-05 07:20:26 +0000217
Sam McCall44fdcec22017-12-08 15:00:59 +0000218 int test() {
219 struct LocalClass {};
Sam McCall9aad25f2017-12-05 07:20:26 +0000220
Sam McCall44fdcec22017-12-08 15:00:59 +0000221 /// Doc for local_var.
222 int local_var;
Sam McCall9aad25f2017-12-05 07:20:26 +0000223
Sam McCall44fdcec22017-12-08 15:00:59 +0000224 ClassWithMembers().^
225 }
226 )cpp",
Sam McCall545a20d2018-01-19 14:34:02 +0000227 {cls("IndexClass"), var("index_var"), func("index_func")}, Opts);
Sam McCall9aad25f2017-12-05 07:20:26 +0000228
Sam McCallf6ae3232017-12-05 20:11:29 +0000229 // Class members. The only items that must be present in after-dot
230 // completion.
Sam McCall44fdcec22017-12-08 15:00:59 +0000231 EXPECT_THAT(
232 Results.items,
233 AllOf(Has(Opts.EnableSnippets ? "method()" : "method"), Has("field")));
234 EXPECT_IFF(Opts.IncludeIneligibleResults, Results.items,
235 Has("private_field"));
Sam McCallf6ae3232017-12-05 20:11:29 +0000236 // Global items.
Sam McCall545a20d2018-01-19 14:34:02 +0000237 EXPECT_THAT(
238 Results.items,
239 Not(AnyOf(Has("global_var"), Has("index_var"), Has("global_func"),
240 Has("global_func()"), Has("index_func"), Has("GlobalClass"),
241 Has("IndexClass"), Has("MACRO"), Has("LocalClass"))));
Sam McCallf6ae3232017-12-05 20:11:29 +0000242 // There should be no code patterns (aka snippets) in after-dot
243 // completion. At least there aren't any we're aware of.
Sam McCall44fdcec22017-12-08 15:00:59 +0000244 EXPECT_THAT(Results.items, Not(Contains(Kind(CompletionItemKind::Snippet))));
Sam McCallf6ae3232017-12-05 20:11:29 +0000245 // Check documentation.
Sam McCall44fdcec22017-12-08 15:00:59 +0000246 EXPECT_IFF(Opts.IncludeBriefComments, Results.items,
247 Contains(IsDocumented()));
Sam McCallf6ae3232017-12-05 20:11:29 +0000248}
Sam McCall9aad25f2017-12-05 07:20:26 +0000249
Sam McCallf6ae3232017-12-05 20:11:29 +0000250void TestGlobalScopeCompletion(clangd::CodeCompleteOptions Opts) {
Sam McCall44fdcec22017-12-08 15:00:59 +0000251 auto Results = completions(
252 R"cpp(
253 #define MACRO X
Sam McCall9aad25f2017-12-05 07:20:26 +0000254
Sam McCall44fdcec22017-12-08 15:00:59 +0000255 int global_var;
256 int global_func();
Sam McCall9aad25f2017-12-05 07:20:26 +0000257
Sam McCall44fdcec22017-12-08 15:00:59 +0000258 struct GlobalClass {};
Sam McCall9aad25f2017-12-05 07:20:26 +0000259
Sam McCall44fdcec22017-12-08 15:00:59 +0000260 struct ClassWithMembers {
261 /// Doc for method.
262 int method();
263 };
Sam McCall9aad25f2017-12-05 07:20:26 +0000264
Sam McCall44fdcec22017-12-08 15:00:59 +0000265 int test() {
266 struct LocalClass {};
Sam McCall9aad25f2017-12-05 07:20:26 +0000267
Sam McCall44fdcec22017-12-08 15:00:59 +0000268 /// Doc for local_var.
269 int local_var;
Sam McCall9aad25f2017-12-05 07:20:26 +0000270
Sam McCall44fdcec22017-12-08 15:00:59 +0000271 ^
272 }
273 )cpp",
Sam McCall545a20d2018-01-19 14:34:02 +0000274 {cls("IndexClass"), var("index_var"), func("index_func")}, Opts);
Sam McCallf6ae3232017-12-05 20:11:29 +0000275
276 // Class members. Should never be present in global completions.
Sam McCall44fdcec22017-12-08 15:00:59 +0000277 EXPECT_THAT(Results.items,
Sam McCallf6ae3232017-12-05 20:11:29 +0000278 Not(AnyOf(Has("method"), Has("method()"), Has("field"))));
279 // Global items.
Sam McCalld8169a82018-01-18 15:31:30 +0000280 EXPECT_THAT(Results.items,
Sam McCall545a20d2018-01-19 14:34:02 +0000281 AllOf(Has("global_var"), Has("index_var"),
Sam McCalld8169a82018-01-18 15:31:30 +0000282 Has(Opts.EnableSnippets ? "global_func()" : "global_func"),
Sam McCall545a20d2018-01-19 14:34:02 +0000283 Has("index_func" /* our fake symbol doesn't include () */),
284 Has("GlobalClass"), Has("IndexClass")));
Sam McCallf6ae3232017-12-05 20:11:29 +0000285 // A macro.
Sam McCall44fdcec22017-12-08 15:00:59 +0000286 EXPECT_IFF(Opts.IncludeMacros, Results.items, Has("MACRO"));
Sam McCallf6ae3232017-12-05 20:11:29 +0000287 // Local items. Must be present always.
Ilya Biryukov9b5ffc22017-12-12 12:56:46 +0000288 EXPECT_THAT(Results.items,
289 AllOf(Has("local_var"), Has("LocalClass"),
290 Contains(Kind(CompletionItemKind::Snippet))));
Sam McCallf6ae3232017-12-05 20:11:29 +0000291 // Check documentation.
Sam McCall44fdcec22017-12-08 15:00:59 +0000292 EXPECT_IFF(Opts.IncludeBriefComments, Results.items,
293 Contains(IsDocumented()));
Sam McCallf6ae3232017-12-05 20:11:29 +0000294}
295
296TEST(CompletionTest, CompletionOptions) {
Sam McCall2c3849a2018-01-16 12:21:24 +0000297 auto Test = [&](const clangd::CodeCompleteOptions &Opts) {
298 TestAfterDotCompletion(Opts);
299 TestGlobalScopeCompletion(Opts);
300 };
301 // We used to test every combination of options, but that got too slow (2^N).
302 auto Flags = {
Ilya Biryukov71028b82018-03-12 15:28:22 +0000303 &clangd::CodeCompleteOptions::IncludeMacros,
304 &clangd::CodeCompleteOptions::IncludeBriefComments,
305 &clangd::CodeCompleteOptions::EnableSnippets,
306 &clangd::CodeCompleteOptions::IncludeCodePatterns,
307 &clangd::CodeCompleteOptions::IncludeIneligibleResults,
Sam McCall2c3849a2018-01-16 12:21:24 +0000308 };
309 // Test default options.
310 Test({});
311 // Test with one flag flipped.
312 for (auto &F : Flags) {
313 clangd::CodeCompleteOptions O;
314 O.*F ^= true;
315 Test(O);
Sam McCall9aad25f2017-12-05 07:20:26 +0000316 }
317}
318
Sam McCall44fdcec22017-12-08 15:00:59 +0000319TEST(CompletionTest, Priorities) {
320 auto Internal = completions(R"cpp(
321 class Foo {
322 public: void pub();
323 protected: void prot();
324 private: void priv();
325 };
326 void Foo::pub() { this->^ }
327 )cpp");
328 EXPECT_THAT(Internal.items,
329 HasSubsequence(Named("priv"), Named("prot"), Named("pub")));
330
331 auto External = completions(R"cpp(
332 class Foo {
333 public: void pub();
334 protected: void prot();
335 private: void priv();
336 };
337 void test() {
338 Foo F;
339 F.^
340 }
341 )cpp");
342 EXPECT_THAT(External.items,
343 AllOf(Has("pub"), Not(Has("prot")), Not(Has("priv"))));
344}
345
346TEST(CompletionTest, Qualifiers) {
347 auto Results = completions(R"cpp(
348 class Foo {
349 public: int foo() const;
350 int bar() const;
351 };
352 class Bar : public Foo {
353 int foo() const;
354 };
355 void test() { Bar().^ }
356 )cpp");
357 EXPECT_THAT(Results.items, HasSubsequence(Labeled("bar() const"),
358 Labeled("Foo::foo() const")));
359 EXPECT_THAT(Results.items, Not(Contains(Labeled("foo() const")))); // private
360}
361
362TEST(CompletionTest, Snippets) {
363 clangd::CodeCompleteOptions Opts;
364 Opts.EnableSnippets = true;
365 auto Results = completions(
366 R"cpp(
367 struct fake {
368 int a;
369 int f(int i, const float f) const;
370 };
371 int main() {
372 fake f;
373 f.^
374 }
375 )cpp",
Sam McCalla15c2d62018-01-18 09:27:56 +0000376 /*IndexSymbols=*/{}, Opts);
Sam McCall44fdcec22017-12-08 15:00:59 +0000377 EXPECT_THAT(Results.items,
Eric Liu63696e12017-12-20 17:24:31 +0000378 HasSubsequence(Snippet("a"),
Sam McCall44fdcec22017-12-08 15:00:59 +0000379 Snippet("f(${1:int i}, ${2:const float f})")));
380}
381
382TEST(CompletionTest, Kinds) {
Sam McCall545a20d2018-01-19 14:34:02 +0000383 auto Results = completions(
384 R"cpp(
385 #define MACRO X
386 int variable;
387 struct Struct {};
388 int function();
389 int X = ^
390 )cpp",
391 {func("indexFunction"), var("indexVariable"), cls("indexClass")});
392 EXPECT_THAT(Results.items,
393 AllOf(Has("function", CompletionItemKind::Function),
394 Has("variable", CompletionItemKind::Variable),
395 Has("int", CompletionItemKind::Keyword),
396 Has("Struct", CompletionItemKind::Class),
397 Has("MACRO", CompletionItemKind::Text),
398 Has("indexFunction", CompletionItemKind::Function),
399 Has("indexVariable", CompletionItemKind::Variable),
400 Has("indexClass", CompletionItemKind::Class)));
Sam McCall44fdcec22017-12-08 15:00:59 +0000401
Sam McCall44fdcec22017-12-08 15:00:59 +0000402 Results = completions("nam^");
403 EXPECT_THAT(Results.items, Has("namespace", CompletionItemKind::Snippet));
404}
405
Sam McCall84652cc2018-01-12 16:16:09 +0000406TEST(CompletionTest, NoDuplicates) {
Sam McCall545a20d2018-01-19 14:34:02 +0000407 auto Results = completions(
408 R"cpp(
409 class Adapter {
410 void method();
411 };
Sam McCall84652cc2018-01-12 16:16:09 +0000412
Sam McCall545a20d2018-01-19 14:34:02 +0000413 void Adapter::method() {
414 Adapter^
415 }
416 )cpp",
417 {cls("Adapter")});
Sam McCall84652cc2018-01-12 16:16:09 +0000418
419 // Make sure there are no duplicate entries of 'Adapter'.
Sam McCalld2a95922018-01-22 21:05:00 +0000420 EXPECT_THAT(Results.items, ElementsAre(Named("Adapter")));
Sam McCall84652cc2018-01-12 16:16:09 +0000421}
422
Sam McCall545a20d2018-01-19 14:34:02 +0000423TEST(CompletionTest, ScopedNoIndex) {
424 auto Results = completions(
425 R"cpp(
426 namespace fake { int BigBang, Babble, Ball; };
427 int main() { fake::bb^ }
428 ")cpp");
Sam McCall84652cc2018-01-12 16:16:09 +0000429 // BigBang is a better match than Babble. Ball doesn't match at all.
Sam McCall545a20d2018-01-19 14:34:02 +0000430 EXPECT_THAT(Results.items, ElementsAre(Named("BigBang"), Named("Babble")));
Sam McCall84652cc2018-01-12 16:16:09 +0000431}
432
Sam McCall545a20d2018-01-19 14:34:02 +0000433TEST(CompletionTest, Scoped) {
Sam McCalla15c2d62018-01-18 09:27:56 +0000434 auto Results = completions(
435 R"cpp(
Sam McCall545a20d2018-01-19 14:34:02 +0000436 namespace fake { int Babble, Ball; };
437 int main() { fake::bb^ }
438 ")cpp",
439 {var("fake::BigBang")});
440 EXPECT_THAT(Results.items, ElementsAre(Named("BigBang"), Named("Babble")));
Sam McCalla15c2d62018-01-18 09:27:56 +0000441}
442
Sam McCall545a20d2018-01-19 14:34:02 +0000443TEST(CompletionTest, ScopedWithFilter) {
Sam McCalla15c2d62018-01-18 09:27:56 +0000444 auto Results = completions(
445 R"cpp(
446 void f() { ns::x^ }
447 )cpp",
448 {cls("ns::XYZ"), func("ns::foo")});
449 EXPECT_THAT(Results.items,
450 UnorderedElementsAre(AllOf(Named("XYZ"), Filter("XYZ"))));
451}
452
Sam McCalldc8abc42018-05-03 14:53:02 +0000453TEST(CompletionTest, ReferencesAffectRanking) {
454 auto Results = completions("int main() { abs^ }", {ns("absl"), func("abs")});
455 EXPECT_THAT(Results.items, HasSubsequence(Named("abs"), Named("absl")));
456 Results = completions("int main() { abs^ }",
457 {withReferences(10000, ns("absl")), func("abs")});
458 EXPECT_THAT(Results.items, HasSubsequence(Named("absl"), Named("abs")));
459}
460
Sam McCall545a20d2018-01-19 14:34:02 +0000461TEST(CompletionTest, GlobalQualified) {
Sam McCalla15c2d62018-01-18 09:27:56 +0000462 auto Results = completions(
463 R"cpp(
464 void f() { ::^ }
465 )cpp",
466 {cls("XYZ")});
467 EXPECT_THAT(Results.items, AllOf(Has("XYZ", CompletionItemKind::Class),
468 Has("f", CompletionItemKind::Function)));
469}
470
Sam McCall545a20d2018-01-19 14:34:02 +0000471TEST(CompletionTest, FullyQualified) {
Sam McCalla15c2d62018-01-18 09:27:56 +0000472 auto Results = completions(
473 R"cpp(
Sam McCall545a20d2018-01-19 14:34:02 +0000474 namespace ns { void bar(); }
Sam McCalla15c2d62018-01-18 09:27:56 +0000475 void f() { ::ns::^ }
476 )cpp",
477 {cls("ns::XYZ")});
Sam McCall545a20d2018-01-19 14:34:02 +0000478 EXPECT_THAT(Results.items, AllOf(Has("XYZ", CompletionItemKind::Class),
479 Has("bar", CompletionItemKind::Function)));
480}
481
482TEST(CompletionTest, SemaIndexMerge) {
483 auto Results = completions(
484 R"cpp(
485 namespace ns { int local; void both(); }
486 void f() { ::ns::^ }
487 )cpp",
488 {func("ns::both"), cls("ns::Index")});
489 // We get results from both index and sema, with no duplicates.
490 EXPECT_THAT(
491 Results.items,
492 UnorderedElementsAre(Named("local"), Named("Index"), Named("both")));
Sam McCalla15c2d62018-01-18 09:27:56 +0000493}
494
Haojian Wu48b48652018-01-25 09:20:09 +0000495TEST(CompletionTest, SemaIndexMergeWithLimit) {
496 clangd::CodeCompleteOptions Opts;
497 Opts.Limit = 1;
498 auto Results = completions(
499 R"cpp(
500 namespace ns { int local; void both(); }
501 void f() { ::ns::^ }
502 )cpp",
503 {func("ns::both"), cls("ns::Index")}, Opts);
504 EXPECT_EQ(Results.items.size(), Opts.Limit);
505 EXPECT_TRUE(Results.isIncomplete);
506}
507
Sam McCalla15c2d62018-01-18 09:27:56 +0000508TEST(CompletionTest, IndexSuppressesPreambleCompletions) {
509 MockFSProvider FS;
510 MockCompilationDatabase CDB;
511 IgnoreDiagnostics DiagConsumer;
Sam McCall7363a2f2018-03-05 17:28:54 +0000512 ClangdServer Server(CDB, FS, DiagConsumer, ClangdServer::optsForTest());
Sam McCalla15c2d62018-01-18 09:27:56 +0000513
Sam McCallc1568062018-02-16 09:41:43 +0000514 FS.Files[testPath("bar.h")] =
Sam McCalld5ea3e32018-01-24 17:53:32 +0000515 R"cpp(namespace ns { struct preamble { int member; }; })cpp";
Sam McCallc1568062018-02-16 09:41:43 +0000516 auto File = testPath("foo.cpp");
Sam McCalla15c2d62018-01-18 09:27:56 +0000517 Annotations Test(R"cpp(
518 #include "bar.h"
519 namespace ns { int local; }
Sam McCalld5ea3e32018-01-24 17:53:32 +0000520 void f() { ns::^; }
521 void f() { ns::preamble().$2^; }
Sam McCalla15c2d62018-01-18 09:27:56 +0000522 )cpp");
Sam McCall7363a2f2018-03-05 17:28:54 +0000523 runAddDocument(Server, File, Test.code());
Sam McCalla15c2d62018-01-18 09:27:56 +0000524 clangd::CodeCompleteOptions Opts = {};
525
Sam McCalla15c2d62018-01-18 09:27:56 +0000526 auto I = memIndex({var("ns::index")});
527 Opts.Index = I.get();
Sam McCalla7bb0cc2018-03-12 23:22:35 +0000528 auto WithIndex = cantFail(runCodeComplete(Server, File, Test.point(), Opts));
Sam McCalla15c2d62018-01-18 09:27:56 +0000529 EXPECT_THAT(WithIndex.items,
530 UnorderedElementsAre(Named("local"), Named("index")));
Sam McCalld5ea3e32018-01-24 17:53:32 +0000531 auto ClassFromPreamble =
Sam McCalla7bb0cc2018-03-12 23:22:35 +0000532 cantFail(runCodeComplete(Server, File, Test.point("2"), Opts));
Sam McCalld5ea3e32018-01-24 17:53:32 +0000533 EXPECT_THAT(ClassFromPreamble.items, Contains(Named("member")));
Sam McCall0bb24cd2018-02-13 08:59:23 +0000534
535 Opts.Index = nullptr;
Sam McCalla7bb0cc2018-03-12 23:22:35 +0000536 auto WithoutIndex =
537 cantFail(runCodeComplete(Server, File, Test.point(), Opts));
Sam McCall0bb24cd2018-02-13 08:59:23 +0000538 EXPECT_THAT(WithoutIndex.items,
539 UnorderedElementsAre(Named("local"), Named("preamble")));
Sam McCalla15c2d62018-01-18 09:27:56 +0000540}
541
542TEST(CompletionTest, DynamicIndexMultiFile) {
543 MockFSProvider FS;
544 MockCompilationDatabase CDB;
545 IgnoreDiagnostics DiagConsumer;
Sam McCall7363a2f2018-03-05 17:28:54 +0000546 auto Opts = ClangdServer::optsForTest();
547 Opts.BuildDynamicSymbolIndex = true;
548 ClangdServer Server(CDB, FS, DiagConsumer, Opts);
Sam McCalla15c2d62018-01-18 09:27:56 +0000549
Eric Liu709bde82018-02-19 18:48:44 +0000550 FS.Files[testPath("foo.h")] = R"cpp(
Sam McCalla15c2d62018-01-18 09:27:56 +0000551 namespace ns { class XYZ {}; void foo(int x) {} }
Eric Liu709bde82018-02-19 18:48:44 +0000552 )cpp";
Sam McCall7363a2f2018-03-05 17:28:54 +0000553 runAddDocument(Server, testPath("foo.cpp"), R"cpp(
Eric Liu709bde82018-02-19 18:48:44 +0000554 #include "foo.h"
Sam McCall0bb24cd2018-02-13 08:59:23 +0000555 )cpp");
Sam McCalla15c2d62018-01-18 09:27:56 +0000556
Sam McCallc1568062018-02-16 09:41:43 +0000557 auto File = testPath("bar.cpp");
Sam McCalla15c2d62018-01-18 09:27:56 +0000558 Annotations Test(R"cpp(
559 namespace ns {
560 class XXX {};
561 /// Doooc
562 void fooooo() {}
563 }
564 void f() { ns::^ }
565 )cpp");
Sam McCall7363a2f2018-03-05 17:28:54 +0000566 runAddDocument(Server, File, Test.code());
Sam McCalla15c2d62018-01-18 09:27:56 +0000567
Sam McCalla7bb0cc2018-03-12 23:22:35 +0000568 auto Results = cantFail(runCodeComplete(Server, File, Test.point(), {}));
Sam McCalla15c2d62018-01-18 09:27:56 +0000569 // "XYZ" and "foo" are not included in the file being completed but are still
570 // visible through the index.
571 EXPECT_THAT(Results.items, Has("XYZ", CompletionItemKind::Class));
572 EXPECT_THAT(Results.items, Has("foo", CompletionItemKind::Function));
573 EXPECT_THAT(Results.items, Has("XXX", CompletionItemKind::Class));
574 EXPECT_THAT(Results.items, Contains(AllOf(Named("fooooo"), Filter("fooooo"),
575 Kind(CompletionItemKind::Function),
576 Doc("Doooc"), Detail("void"))));
577}
578
Haojian Wu58d208d2018-01-25 09:44:06 +0000579TEST(CodeCompleteTest, DisableTypoCorrection) {
580 auto Results = completions(R"cpp(
581 namespace clang { int v; }
582 void f() { clangd::^
583 )cpp");
584 EXPECT_TRUE(Results.items.empty());
585}
586
Ilya Biryukov53d6d932018-03-06 16:45:21 +0000587TEST(CodeCompleteTest, NoColonColonAtTheEnd) {
588 auto Results = completions(R"cpp(
589 namespace clang { }
590 void f() {
591 clan^
592 }
593 )cpp");
594
595 EXPECT_THAT(Results.items, Contains(Labeled("clang")));
596 EXPECT_THAT(Results.items, Not(Contains(Labeled("clang::"))));
597}
598
Ilya Biryukov94da7bd2018-03-16 15:23:44 +0000599TEST(CompletionTest, BacktrackCrashes) {
600 // Sema calls code completion callbacks twice in these cases.
601 auto Results = completions(R"cpp(
602 namespace ns {
603 struct FooBarBaz {};
604 } // namespace ns
605
606 int foo(ns::FooBar^
607 )cpp");
608
609 EXPECT_THAT(Results.items, ElementsAre(Labeled("FooBarBaz")));
610
611 // Check we don't crash in that case too.
612 completions(R"cpp(
613 struct FooBarBaz {};
614 void test() {
615 if (FooBarBaz * x^) {}
616 }
617)cpp");
618}
619
620TEST(CompletionTest, CompleteInExcludedPPBranch) {
621 auto Results = completions(R"cpp(
622 int bar(int param_in_bar) {
623 }
624
625 int foo(int param_in_foo) {
626#if 0
627 par^
628#endif
629 }
630)cpp");
631
632 EXPECT_THAT(Results.items, Contains(Labeled("param_in_foo")));
633 EXPECT_THAT(Results.items, Not(Contains(Labeled("param_in_bar"))));
634}
635
Sam McCall800d4372017-12-19 10:29:27 +0000636SignatureHelp signatures(StringRef Text) {
637 MockFSProvider FS;
638 MockCompilationDatabase CDB;
639 IgnoreDiagnostics DiagConsumer;
Sam McCall7363a2f2018-03-05 17:28:54 +0000640 ClangdServer Server(CDB, FS, DiagConsumer, ClangdServer::optsForTest());
Sam McCallc1568062018-02-16 09:41:43 +0000641 auto File = testPath("foo.cpp");
Sam McCall328cbdb2017-12-20 16:06:05 +0000642 Annotations Test(Text);
Sam McCall7363a2f2018-03-05 17:28:54 +0000643 runAddDocument(Server, File, Test.code());
Sam McCalla7bb0cc2018-03-12 23:22:35 +0000644 return cantFail(runSignatureHelp(Server, File, Test.point()));
Sam McCall800d4372017-12-19 10:29:27 +0000645}
646
647MATCHER_P(ParamsAre, P, "") {
648 if (P.size() != arg.parameters.size())
649 return false;
650 for (unsigned I = 0; I < P.size(); ++I)
651 if (P[I] != arg.parameters[I].label)
652 return false;
653 return true;
654}
655
656Matcher<SignatureInformation> Sig(std::string Label,
657 std::vector<std::string> Params) {
658 return AllOf(Labeled(Label), ParamsAre(Params));
659}
660
661TEST(SignatureHelpTest, Overloads) {
662 auto Results = signatures(R"cpp(
663 void foo(int x, int y);
664 void foo(int x, float y);
665 void foo(float x, int y);
666 void foo(float x, float y);
667 void bar(int x, int y = 0);
668 int main() { foo(^); }
669 )cpp");
670 EXPECT_THAT(Results.signatures,
671 UnorderedElementsAre(
672 Sig("foo(float x, float y) -> void", {"float x", "float y"}),
673 Sig("foo(float x, int y) -> void", {"float x", "int y"}),
674 Sig("foo(int x, float y) -> void", {"int x", "float y"}),
675 Sig("foo(int x, int y) -> void", {"int x", "int y"})));
676 // We always prefer the first signature.
677 EXPECT_EQ(0, Results.activeSignature);
678 EXPECT_EQ(0, Results.activeParameter);
679}
680
681TEST(SignatureHelpTest, DefaultArgs) {
682 auto Results = signatures(R"cpp(
683 void bar(int x, int y = 0);
684 void bar(float x = 0, int y = 42);
685 int main() { bar(^
686 )cpp");
687 EXPECT_THAT(Results.signatures,
688 UnorderedElementsAre(
689 Sig("bar(int x, int y = 0) -> void", {"int x", "int y = 0"}),
690 Sig("bar(float x = 0, int y = 42) -> void",
691 {"float x = 0", "int y = 42"})));
692 EXPECT_EQ(0, Results.activeSignature);
693 EXPECT_EQ(0, Results.activeParameter);
694}
695
696TEST(SignatureHelpTest, ActiveArg) {
697 auto Results = signatures(R"cpp(
698 int baz(int a, int b, int c);
699 int main() { baz(baz(1,2,3), ^); }
700 )cpp");
701 EXPECT_THAT(Results.signatures,
702 ElementsAre(Sig("baz(int a, int b, int c) -> int",
703 {"int a", "int b", "int c"})));
704 EXPECT_EQ(0, Results.activeSignature);
705 EXPECT_EQ(1, Results.activeParameter);
706}
707
Haojian Wu061c73e2018-01-23 11:37:26 +0000708class IndexRequestCollector : public SymbolIndex {
709public:
710 bool
Sam McCalld1a7a372018-01-31 13:40:48 +0000711 fuzzyFind(const FuzzyFindRequest &Req,
Haojian Wu061c73e2018-01-23 11:37:26 +0000712 llvm::function_ref<void(const Symbol &)> Callback) const override {
713 Requests.push_back(Req);
Sam McCallab8e3932018-02-19 13:04:41 +0000714 return true;
Haojian Wu061c73e2018-01-23 11:37:26 +0000715 }
716
Eric Liu9ec459f2018-03-14 09:48:05 +0000717 void lookup(const LookupRequest &,
718 llvm::function_ref<void(const Symbol &)>) const override {}
719
Haojian Wu061c73e2018-01-23 11:37:26 +0000720 const std::vector<FuzzyFindRequest> allRequests() const { return Requests; }
721
722private:
723 mutable std::vector<FuzzyFindRequest> Requests;
724};
725
726std::vector<FuzzyFindRequest> captureIndexRequests(llvm::StringRef Code) {
727 clangd::CodeCompleteOptions Opts;
728 IndexRequestCollector Requests;
729 Opts.Index = &Requests;
730 completions(Code, {}, Opts);
731 return Requests.allRequests();
732}
733
734TEST(CompletionTest, UnqualifiedIdQuery) {
735 auto Requests = captureIndexRequests(R"cpp(
736 namespace std {}
737 using namespace std;
738 namespace ns {
739 void f() {
740 vec^
741 }
742 }
743 )cpp");
744
745 EXPECT_THAT(Requests,
746 ElementsAre(Field(&FuzzyFindRequest::Scopes,
747 UnorderedElementsAre("", "ns::", "std::"))));
748}
749
750TEST(CompletionTest, ResolvedQualifiedIdQuery) {
751 auto Requests = captureIndexRequests(R"cpp(
752 namespace ns1 {}
753 namespace ns2 {} // ignore
754 namespace ns3 { namespace nns3 {} }
755 namespace foo {
756 using namespace ns1;
757 using namespace ns3::nns3;
758 }
759 namespace ns {
760 void f() {
761 foo::^
762 }
763 }
764 )cpp");
765
766 EXPECT_THAT(Requests,
767 ElementsAre(Field(
768 &FuzzyFindRequest::Scopes,
769 UnorderedElementsAre("foo::", "ns1::", "ns3::nns3::"))));
770}
771
772TEST(CompletionTest, UnresolvedQualifierIdQuery) {
773 auto Requests = captureIndexRequests(R"cpp(
774 namespace a {}
775 using namespace a;
776 namespace ns {
777 void f() {
778 bar::^
779 }
780 } // namespace ns
781 )cpp");
782
783 EXPECT_THAT(Requests, ElementsAre(Field(&FuzzyFindRequest::Scopes,
784 UnorderedElementsAre("bar::"))));
785}
786
787TEST(CompletionTest, UnresolvedNestedQualifierIdQuery) {
788 auto Requests = captureIndexRequests(R"cpp(
789 namespace a {}
790 using namespace a;
791 namespace ns {
792 void f() {
793 ::a::bar::^
794 }
795 } // namespace ns
796 )cpp");
797
798 EXPECT_THAT(Requests, ElementsAre(Field(&FuzzyFindRequest::Scopes,
799 UnorderedElementsAre("a::bar::"))));
800}
801
802TEST(CompletionTest, EmptyQualifiedQuery) {
803 auto Requests = captureIndexRequests(R"cpp(
804 namespace ns {
805 void f() {
806 ^
807 }
808 } // namespace ns
809 )cpp");
810
811 EXPECT_THAT(Requests, ElementsAre(Field(&FuzzyFindRequest::Scopes,
812 UnorderedElementsAre("", "ns::"))));
813}
814
815TEST(CompletionTest, GlobalQualifiedQuery) {
816 auto Requests = captureIndexRequests(R"cpp(
817 namespace ns {
818 void f() {
819 ::^
820 }
821 } // namespace ns
822 )cpp");
823
824 EXPECT_THAT(Requests, ElementsAre(Field(&FuzzyFindRequest::Scopes,
825 UnorderedElementsAre(""))));
826}
827
Ilya Biryukova907ba42018-05-14 10:50:04 +0000828TEST(CompletionTest, NoIndexCompletionsInsideClasses) {
829 auto Completions = completions(
830 R"cpp(
831 struct Foo {
832 int SomeNameOfField;
833 typedef int SomeNameOfTypedefField;
834 };
835
836 Foo::^)cpp",
837 {func("::SomeNameInTheIndex"), func("::Foo::SomeNameInTheIndex")});
838
839 EXPECT_THAT(Completions.items,
840 AllOf(Contains(Labeled("SomeNameOfField")),
841 Contains(Labeled("SomeNameOfTypedefField")),
842 Not(Contains(Labeled("SomeNameInTheIndex")))));
843}
844
845TEST(CompletionTest, NoIndexCompletionsInsideDependentCode) {
846 {
847 auto Completions = completions(
848 R"cpp(
849 template <class T>
850 void foo() {
851 T::^
852 }
853 )cpp",
854 {func("::SomeNameInTheIndex")});
855
856 EXPECT_THAT(Completions.items,
857 Not(Contains(Labeled("SomeNameInTheIndex"))));
858 }
859
860 {
861 auto Completions = completions(
862 R"cpp(
863 template <class T>
864 void foo() {
865 T::template Y<int>::^
866 }
867 )cpp",
868 {func("::SomeNameInTheIndex")});
869
870 EXPECT_THAT(Completions.items,
871 Not(Contains(Labeled("SomeNameInTheIndex"))));
872 }
873
874 {
875 auto Completions = completions(
876 R"cpp(
877 template <class T>
878 void foo() {
879 T::foo::^
880 }
881 )cpp",
882 {func("::SomeNameInTheIndex")});
883
884 EXPECT_THAT(Completions.items,
885 Not(Contains(Labeled("SomeNameInTheIndex"))));
886 }
887}
888
Sam McCall9aad25f2017-12-05 07:20:26 +0000889} // namespace
890} // namespace clangd
891} // namespace clang